Getting Mercurial to transmit changes to Manuscript

To setup Mercurial-Manuscript integration, start by logging into Manuscript as an administrator and going to Avatar Menu > Source Control. Click Create New Repository. In the resulting dialog, select Mercurial as the type and click Next.

In the resulting dialog, download the Python script and place it on your Mercurial server. It can go anywhere that’s visible to the Mercurial server process, but do not put it in your hgext directory.

To enable the script, edit the .hg/hgrc file in your repository by adding the following lines (you may need to create this file):

[hooks]
changegroup = python:/path/to/manuscript.py:hook

You will then need to configure the Manuscript extension so that it knows where to locate your Manuscript install. Simply add the following lines, edited appropriately, into your .hg/hgrc file:

[manuscript]
host=http://full/path/to/manuscript

Finally, you should set your baseurl to make sure that the appropriate repository location is passed along to Manuscript. Baseurl is the web URL to where the “hg serve” web server is running for the provided repository.

[web]
baseurl=http://url/of/your/repo

Getting Mercurial to Provide Hyperlinks to Mercurial

Assuming you supplied the right value for baseurl in your hgrc file, Manuscript will automatically link to logs and diffs in Mercurial. If you do not have hg serve running, then although Manuscript will record changesets, the links back from Manuscript will not point anywhere meaningful.

Entering Case Numbers in Mercurial Commits

When you commit a change using Mercurial, include a single line of the form BugzID: 1234 in the log after the other comments (where 1234 is the case number you want to link).