ccollab addchangelist (for Team Foundation Server)

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

Description

The ccollab addchangelist command attaches all files from Team Foundation Server shelvesets or changesets to a review on the Collaborator server.

Command Line Syntax

ccollab [global-options] addchangelist <review> <changelist> [<changelist> ...] --exclude <file-mask list> --include <file-mask list>

Command Options

Option

Required?

Description

[global-options]

No

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

<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).

<changelist> [<changelist> ...]

Yes

Identifier(s) of the desired changeset(s) or shelveset(s) in your source control.

--exclude <file-mask list>

No

Exclude files from changelist(s), that match specified mask(s), will be ignored (changelist command uploads to review only files that don’t match the masks).

When no files in changelist are matches to the mask(s) then whole changelist is uploaded ('exclude' option is ignored)

--include <file-mask list>

No

Includes only files that match specified mask(s) will be uploaded to review.

When no files in changelist are matches to the mask(s) then nothing is uploaded.

--skip-if-exists

No

Set whether to skip changelist if it already exists in review.

-ignore-empty-changelists

No

Set whether empty changelist errors will be ignored when multiple changelists are uploaded. If all changelists are empty the command will throw an exception anyways.

The first argument is the review specifier, subsequent arguments are the IDs of the Shelvesets or Changesets to upload.

Note that the changesets are searched first - if a changeset is found, it will be added to the review. To avoid any naming conflicts, always use at least one non-numeric character in your shelveset names.

Examples

To upload Shelvesets MyShelveset and todays_work to a new review:

ccollab addchangelist new MyShelveset todays_work

To upload Changesets C3 and C12654 to review 111:

ccollab addchangelist 111 3 12654

To upload Changesets MyShelveset with all .java and .txt files except that started with 'test' to a new review

ccollab addchangelist new MyShelveset --include '*.java, *.txt' --exclude 'test*.*'

See Also

Team Foundation Server Integration
ccollab addchangelist
ccollab addchanges (for Team Foundation Server)
ccollab commit (for Team Foundation Server)

Highlight search results