Transmit Changes of Mercurial to Manuscript in Source Control

Overview
This KB article provides information on how to setup Mercurial-Manuscript integration in source control. It also provides details on how Mercurial can provide hyperlinks to Manuscript.

Audience
All Agents, End-User

Step-by-Step Guide 

1. On a browser, go to the URL of your Manuscript account [subdomain.manuscript.com)
2. Enter your username and password.
3. Go to the avatar menu and choose Source Control.
4. Click Add New Repository, then choose Mercurial.
5. Click Next.
6. Download the script and place it where it’s visible to the Mercurial server process.

  Note: It should NOT be in your hgtext directory.

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

     8. Create the Manuscript extension so it would know where to locate your Manuscript

          install. Add the following lines, edited appropriately, into your .hg/hgrc file.

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

    9. Finally, set your baseurl to make sure that the appropriate repository location is passed along to Manuscript.

Note: Baseurl is the web URL to where the “hg server” web server is running for the provided repository.

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

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