Table of Contents
wmerge - merge parallel changes into workspace file
wmerge
[-ABEKMnOpqRTvVWX] [-jpatternList] [-kkv|-kk|-kv|-ko] [-o/Path] [-P/merge-program]
[-tLockComment] [-NWorkspaceName] [-hHost -SSnapshot [-DDir]] [[[-r LeftRev]
-r BaseRev] -r RightRev] name ...
wmerge merges content changes
from a snapshot file into a workspace file. The merge requires three revisions
of a file: two revisions with changes and a common ancestor revision. In
many circumstances, wmerge knows all three revisions so no revisions need
to be specified.
If no revisions are specified, wmerge operates on locked
files whose lock is out-of-date because of a concurrent change. On success,
concurrent changes are incorporated into the workspace file and the lock
is updated to the current revision to reflect the merge.
If one revision
is specified, changes unique to that revision are merged into the workspace
file.
If two revisions are specified, changes made from the first (BaseRev)
revision to the second (RightRev) revision are merged into the workspace
file. Note: Changes are directional. Thus a change can be "undone" by reversing
the order of the revisions.
If name is a directory, wmerge operates on
all appropriate files in that directory.
Mapping is
consistent across all workspace commands. See wco(1)
for details.
Default options can be set on most workspace commands. See wco(1)
for details.
The workspace mapping is automatically looked
up in the user's workspace mapping table for the given files. Override this
by specifying an explicit workspace:
- -NworkspaceName
- Use the named workspace
mapping.
Or override with a temporary workspace mapping with these three
options:
- -hHost
- Use the SnapshotCM server on Host for a workspace mapping.
- -SSnapshotPath
- Use SnapshotPath for a workspace mapping.
- -DWorkspaceDirectory
- The local destination directory for a workspace mapping. This can be a relative
or absolute path. If this option is not provided with the other two, the
local destination directory defaults to the current directory where the
command is executed.
For more information on workspace mappings, see wmap(1)
.
- -A
- Include overlap text for all 3 revisions in merged file.
- -B
- Check
out all files using 'binary' I/O mode.
- -E
- Include overlap text for left and
right revisions in the merged file.
- -jpatternList
- List only files whose name
(or path) matches patternList. PatternList consists of one or more patterns
separated by a '|' (pipe/or) symbol. Each pattern can contain shell wild cards
as follows:
* - match 0 or more characters
? - match any one character
[set] - match any character in set
[!set] - match any character not in set
A pattern not ending in a slash ('/') matches only files. A pattern ending
in a slash matches only directories. A pattern containing a slash other
than at the end is matched against the full workspace path. Otherwise pattern
is matched against the last component of the path. If patternList begins
with an '!' (exclamation/bang) character, the normal selection is negated.
- -kkv, -kk, -kv, -ko
- Override the default keyword expansion mode for all check
outs. See wco(1)
for more information.
- -K
- Ignore keyword value differences.
Use this option to avoid merge conflicts caused only by differing keyword
values.
- -M
- Print workspace mapping before normal output.
- -n
- No execute mode.
Show the operations that would happen, but do not really execute them.
- -o/Path
- Map /Path in the selected snapshot to the specified (-D) local directory,
creating a temporary, partial workspace mapping for the command. Normally,
the root directory of a snapshot is what is mapped.
- -p
- Write merged file
contents to 'stdout'.
- -PProgram
- Set the merge program. Program may be 'merge'
or 'tkdiff'.
- -q
- Quiet, do not display normal output messages.
- -rRev
- Specify revisions
to merge. Up to three revisions can be given.
- -R
- Operate recursively on all
files and directories in the hierarchy.
- -tLockCmt
- Set Lock Comment to this
string.
- -T
- Check out all files using 'text" I/O mode.
- -v
- Display file revision
information during check out.
- -V
- Print internal version and exit.
- -W
- Mark the
local file writable after check out.
- -X
- Display 'full archive path' names.
Exit status is 0 if all specified files were successfully merged,
1 if a file could not be merged, and >1 if there was a bad option or a network
error.
wci(1)
, wco(1)
, wdiff(1)
, whist(1)
, wls(1)
, wmap(1)
, wremove(1)
,
wrename(1)
, wset(1)
, wupdate(1)
.
Table of Contents