Dumps a directory or subtree and its contents into an interim file
and then merges the contents of that file into an existing subtree.
This command is useful when all clearinghouses are available for
every directory in both subtrees and when no duplicate names exist
in source and target directories.
SYNOPSIS
MERGE SUBTREE old-tree-name[...] INTO SUBTREE
new-tree-name [EXCLUDE entry-type]
Arguments
old-tree-name
The name of the topmost directory in the subtree that is being
changed. When used without the optional recursion notation (...),
only the specified directory and its contents are merged. The
recursion notation additionally causes all child directories (and
their contents) to merge into the target subtree.
new-tree-name
The name of the topmost directory in the target subtree.
entry-type
One or more of the following types of entries to exclude from the
change: objects, links, or directories. Multiple directories can be
excluded in a single command. Use any combination of the following
entry-type specifiers, separating multiple arguments with commas:
objects
links
directory directory name
Description
This command dumps a subtree into an interim file and then merges
the contents of that file into an existing subtree. Use the
recursion flag (...) to merge an entire subtree and its contents.
If you do not use the recursion flag, only the specified directory
and its contents are dumped and merged into the target subtree.
This command is useful when all clearinghouses are available for
every directory in both subtrees and when no duplicate names exist
in source and target directories. If a duplicate name is detected,
or if any affected clearinghouse cannot be reached while the merge
subtree command is in progress, the command completes what it can.
In this situation, a named interim file or failures file with a
randomly generated name is created in the current directory. The
directory new-tree-name must already exist. If it does not, the
command returns an error and you must use the create directory or
recreate directory command to create it.
ACCESS RIGHTS
You must have control and write access to the directory you specify
as well as the contents of the directory. If you use the command
recursively, you also need control and write access to all child
directories (and their contents) of the directory you specify.
Additional Information:
explode
extract