ccollab addchanges (for ClearCase)

Applies to Collaborator 14.5, last modified on April 18, 2024

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 be scanned 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 names of modified files. Modifications 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 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 foo.txt file, 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 the foo.txt file and modified files from c:\dev\project into a brand new review:

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

See Also

ClearCase Integration
ccollab addchanges
ccollab addactivity
ccollab addchangelist (for ClearCase)
ccollab addversions (for ClearCase)
ccollab commit (for ClearCase)

Highlight search results