Version Control Integrations > IBM Rational ClearCase Integration > Command-Line Client

Top |Previous |Next

ccollab addchanges (for ClearCase)

Description

The ccollab addchanges command uploads locally modified files controlled by ClearCase to a review on the Collaborator server.

Command Line Syntax:

ccollab [global-options] addchanges [--diffbranch <value>] [--upload-comment <value>] <review> <file-spec> [<file-spec> ...]

Command Options

Option

Required?

Description

global-options

No

A number of global or SCM-specific global options. See Command-line Global Options Reference.

--diffbranch <value>

No

(ClearCase only) Specify either branch-name or "pre" to determine the earlier version for upload. See Remarks.

--upload-comment <value>

No

A comment to be used for the uploaded files. Default is Local changes.

<review>

Yes

Identifier of the desired review (an integer number), or a new, ask, or last keyword. Where keywords define the following behaviour:

new - the command will create a new review,
ask - the command will pause execution and prompt for the identifier of the desired review,
last - the command will use the last review that was created on the current machine via Command-Line Client (that is, it does not know about reviews created elsewhere).

<file-spec> [<file-spec> ...]

Yes

Files to be added and/or folders to scan for modified files.

Separate multiple file and folder names with spaces. If a file or folder name contains spaces, enclose this name is quotes.

ccollab scans folders recursively. The resulting list includes the name of modified files. "Modifications" include include edits, additions, deletions, branches, integrations, moves, copies, and so on.

After the scan is complete, a file list is presented in a graphical editor so you can review the files to be uploaded and make correct the list, if needed.

Remarks:

The '--diffbranch' option allows local changes to be uploaded with a predecessor version in another branch as the previous version.

For example, to create a new review and add all changes in the current directory and below, and compare them to the predecessor versions in the \main branch, you would use:

ccollab addchanges --diffbranch main new .

You can also use the special branch name 'pre' to refer to the predecessor branch. For example, to add the local changes to hello.c compared to the most recent predecessor version in the previous branch to review 45, you would use:

ccollab addchanges --diffbranch pre 45 hello.c

Examples:

To create a new review and add all changes in the current directory and below, plus the file foo.txt, you would use:

ccollab addchanges new . foo.txt

To upload modified files from the current working directory and all subdirectories to review 123:

ccollab addchanges 123 .

To upload file foo.txt and modified files from c:\dev\project into a brand new review:

ccollab addchanges new foo.txt c:\dev\project


© 2003-2025 SmartBear Software. All rights reserved.