|
Usage: ccollab [global-options] addversions [--upload-comment <value> --version-spec <value> [<value> ...]] <review> [<file-path>] [<version>] [<predecessor-version>]
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")
|
--version-spec <value> [<value> ...] |
N
|
A version to be reviewed can be specified by a version-spec. A version-spec is 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. Each argument must be quoted if any embedded spaces exist in an argument. Typically a version-spec is not used on the commandline. Instead, specify the parts using the <file-path>, <version> and optionally the <predecessor-version> arguments
|
|
|
Y
|
Must be either an integer review-id, 'new', 'ask', or 'last'
|
|
|
N
|
Path of the file whose versions are to be added to the review. Requires a value for <version>
|
|
|
N
|
Version of the file to be added to the review. Required if <file-path> is given
|
|
|
N
|
Predecessor version to be added to the review
|
Uploads specific versions of a file or files to a review. A version-spec is given by a file path followed by a version, and optionally, a predecessor
version:
file-path version [predecessor-version]
If no predecessor version is explicity given, diffs will be generated using
the predecessor version as determined from the SCM system.
Adding versions for a single file can be done with command line arguments
given after the review number. To upload versions for multiple files, the
file and versions may be submitted on lines read from standard input. If
the path and versions are not given on the command line, the client will
expect to read them from stdin. Each line read should be in the format shown
for the version-spec option. Some example command lines for reading versions
from stdin:
ccollab addversions 86753
ccollab addversions last < versionlist.txt
cat versionlist.txt | ccollab addversions new
When supplying the version list on the command line or in an input file, the
keyword 'local' can be used to denote the version corresponding to the local
version of the file. The 'local' keyword can only be used for the first
version argument, not the predecessor version.
|