ccollab addhgdiffs

Applies to Collaborator 14.5, last modified on May 06, 2024


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




--upload-comment <value>


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



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


Command-line arguments to pass directly to the diff command


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.


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