#pragma section-numbers 2
= BugLink =

Make the link between changesets and issue IDs.

<<TableOfContents>>

== Status ==
'''This extension is not distributed with Mercurial.'''

''Author:'' BenoitAllard

Repository: https://bitbucket.org/benallard/buglink

Documentation: http://buglink.readthedocs.org/

== Overview ==
This extension is split in three components:

 * Client-side extension
 * Server-side extension
 * Web interface

Both the server-side extension and the web interface are not mandatory, The client-side extension will then keep locally all the ''links'' and share them with your peers upon push/pull.

''Links'' are similar to Bookmarks except the fact that links and changeset have a many-to-many relationship.

== Configuration ==
Configure your .hgrc to enable the extension by adding following lines:

{{{
[extensions]
buglink = /path/to/buglink/client/
}}}

== Usage ==

The following commands are added, their action are strongly based on the behavior of bookmarks.

 * {{{link}}} to add or remove ({{{--remove}}}) a link to a set of changesets.
 * {{{unlink}}} to unlink a set of issues
 * {{{links}}} to display the current links

The {{{--issueid}}} option is added to {{{hg push}}} and {{{hg commit}}} and link the affected changesets.

== See also ==

 * bugmap.py from GregWard (bundle present in mercurial list archive)

----
CategoryExtensionsByOthers CategoryBugtrackingExtensions