Light Tags
This extension makes local tags behave like lightweight tags.
Contents
1. Status
This extension is not distributed with Mercurial.
Author: StephenLee
Repository: http://bitbucket.org/sphen_lee/hg-lighttags
Web page: http://bitbucket.org/sphen_lee/hg-lighttags/overview
Issue Tracker: https://bitbucket.org/sphen_lee/hg-lighttags/issues
2. Overview
This extension allows local tags to be cloned and pulled across the network, making them behave like lightweight tags. These tags are lightweight in the sense that they do not create new commits and cannot carry a description, or other metadata (creator, date etc.) For this reason they are useful in situations where regular tags are not:
- marking build numbers on a continuous integration server
- work flows that create large numbers of tags (eg. a weekly release cycle)
avoiding confusion caused by regular tags (such as the extra commit appearing, merging of .hgtags, clone -r <tag>)
They are less useful in other situations where regular tags are better:
- auditing tag history
- distributed creation of tags
Tags are only propagated on clone and pull, and only if they refer to a public changeset (see Phases). Local tags are created using hg tag -l <name>. To make a local tag remain local ensure that it refers to a secret changeset, or consider using an inactive bookmark.
If a tag present on the server conflicts with a tag present locally the local tag is NOT replaced and a warning is issued. This can be fixed by either deleting the tag from the local repository or deleting the tag from the server.
3. Configuration
Configure your .hgrc to enable the extension by adding following lines:
[extensions] lighttags = /path/to/lighttags.py