|
Usage: ccollab [global-options] addversions [--upload-comment <value>] <review> [<version-spec> [<version-spec> ...]]
addversions - Attaches any 2 given versions to a review
Option
|
Required?
|
Description
|
--upload-comment <value>
|
N
|
Comment used to upload files (default is "Local changes")
|
|
|
Y
|
Must be either an integer review-id, 'new', 'ask', or 'last'
|
<version-spec> [<version-spec> ...] |
N
|
Versions to be reviewed can be specified in several ways: 'FILENAME VER [PREV]' attaches any 2 given versions to a review. 'PNAME [PREV]' (ClearCase only) the PNAME argument should be of the form FILENAME[@@VER]. PREV is an optional version for comparison. If not given, PREV defaults to the predecessor of VER. If this option is omitted on the command-line, then lines are read from stdin where each line is of the form 'FILENAME VER [PREV]' or 'PNAME [PREV]' as described above
|
Upload differences between arbitrary versions of specific files. If the filename and versions are not specified, the client will expect to read them from stdin.
One form of the addversions command is available specifically for ClearCase:
ccollab addversions review pname [prev]
Here pname is a valid ClearCase pname (i.e., filename and version) and prev is an optional predecessor version to be uploaded. This can be used to compare arbitrary ClearCase versions:
ccollab addversions review hello.c@@\main\ga_1.0\6 \main\8
If the optional ver1 is not specified, the predecessor of the pname version is uploaded. The following example will upload the \main\8 version of hello.c and its predecessor version:
ccollab addversions review hello.c@@\main\8
You can also use a pname without a version number, which refers either to the local revision (either CHECKEDOUT if checked out, or the version mapped by the current config spec). In the following example, if hello.c maps to \main\9, then the following 2 commands would be equivalent:
ccollab addversions review hello.c \main\8
ccollab addversions review hello.c@@\main\9 \main\8
You can also reference the LATEST version in a view:
ccollab addversions review hello.c@@\main\ga_1.0\6 \main\LATEST
Some examples of reading versions from stdin:
ccollab addversions review
ccollab addversions review < versionlist.txt
cat versionlist.txt | ccollab addversions review
The lines read from stdin can use any of the filename and version formats previously described.
|