#pragma section-numbers 2 = Light Tags = This extension makes local tags behave like lightweight tags. <> == 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 == 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 `) 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 `. To make a local tag remain local ensure that it refers to a secret changeset, or consider using an inactive [[Bookmarks|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. == Configuration == Configure your .hgrc to enable the extension by adding following lines: {{{ [extensions] lighttags = /path/to/lighttags.py }}} == See also == ---- CategoryExtensionsByOthers