ccollab addhgdiffs

Applies to Collaborator 14.5, last modified on March 26, 2024

Description

The ccollab addhgdiffs command uploads differences between arbitrary versions of files in Mercurial. The differences are generated using the native hg diff command of Mercurial.

Command Line Syntax

ccollab [global-options] addhgdiffs [--upload-comment <value>] <review> [<user-diff-arg> [<user-diff-arg> ...]]

Command Options

Option

Required?

Description

--upload-comment <value>

No

Comment used to upload files (defaults to command-line arguments)

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

<user-diff-arg> [<user-diff-arg> ...]

No

Command-line arguments to pass directly to the diff command

Remarks

Do not use diff arguments that affect the diff output such as -U unified. The Collaborator command-line client will automatically select an output format that ensures you will get all the data you need on the server.

Mercurial treats Microsoft Office documents (.doc, .docx, .xls, .xlsx) and PDF files as binary files. Thus, the native hg diff command is not able to generate meaningful difference for these types of files. Because of this the ccollab addhgdiffs command is also unable to upload differences between Microsoft Office documents (.doc, .docx, .xls, .xlsx) and PDF files.

Examples

To upload all changes between revisions 4 and 8:

ccollab addhgdiffs new -r 4 -r 8

To upload all changes in your local working directory:

ccollab addhgdiffs new .

See Also

Mercurial Integration
ccollab addchanges (for Mercurial)

Highlight search results