ccollab addversions (for ClearCase)

Top  Previous  Next

Usage: ccollab [global-options] addversions [--upload-comment <value>] <review> [<version-spec> [<version-spec> ...]]

 

addversions - Attaches any 2 given versions to a review

 

Command Options

Option

Required?

Description

--upload-comment <value>

N

Comment used to upload files (default is "Local changes")

<review>

Y

Must be either an integer review-id, 'new', 'ask', or 'last'

<version-spec> [<version-spec> ...]

N

Versions to be reviewed are given by <path> <version> [<previous version>], where <path> is the filename or server path of the file, <version> is the version to be reviewed, and <previous version> is an optional version that <version> should be diff'ed against. If <previous version> is not specified, the predecessor version of <version> will be used. If no <version-spec> is given on the command line, then one or more version specs will be read from stdin, one <version-spec> per line as described above. Note that arguments containing spaces must be quoted to be parsed correctly

 

Uploads differences between arbitrary versions of specific files. If the

path and versions are not specified, the client will expect to read them

from stdin.

 

Some examples of reading versions from stdin:

 

       ccollab addversions 86753

       ccollab addversions last < versionlist.txt

       cat versionlist.txt | ccollab addversions new

 

An example of specifying versions on the command line:

 

       ccollab addversions review hello.c \main\ga_1.0\6 \main\8

 

To compare the local version of the ClearCase file to a previous version,

use 'local' as the initial version name. If the file is checked out as

'/main/CHECKEDOUT', then 'local' is equivalent to using '/main/CHECKEDOUT'

as the initial version. Otherwise 'local' would refer to the latest

version of the file. For example, if the local file hello.c is checked out

from '/main/9' and has predecessor '/main/8' then all of the following

would be equivalent:

 

       ccollab addversions new hello.c /main/9

       ccollab addversions new hello.c local

       ccollab addversions new hello.c /main/9 /main/8

       ccollab addversions new hello.c local /main/8

 

You can also reference the LATEST version in a view, e.g.:

 

       ccollab addversions review hello.c \main\ga_1.0\6 \main\LATEST

 

To upload a version without a predecessor version, use '\main\0':

 

       ccollab addversions review hello.c \main\ga_1.0\6 \main\0