tag
===

:Purpose: Create, remove or modify a tag naming a revision.
:Usage:   bzr tag [TAG_NAME]

:Options:
  --force               Replace existing tags.
  -v, --verbose         Display more information.
  -h, --help            Show help message.
  -q, --quiet           Only display errors and warnings.
  -d ARG, --directory=ARG
                        Branch in which to place the tag.
  --usage               Show usage message and options.
  -r ARG, --revision=ARG
                        See "help revisionspec" for details.
  --delete              Delete this tag rather than placing it.

:Description:
  Tags give human-meaningful names to revisions.  Commands that take a -r
  (--revision) option can be given -rtag:X, where X is any previously
  created tag.
  
  Tags are stored in the branch.  Tags are copied from one branch to another
  along when you branch, push, pull or merge.
  
  It is an error to give a tag name that already exists unless you pass
  --force, in which case the tag is moved to point to the new revision.
  
  To rename a tag (change the name but keep it on the same revsion), run ``bzr
  tag new-name -r tag:old-name`` and then ``bzr tag --delete oldname``.
  
  If no tag name is specified it will be determined through the 
  'automatic_tag_name' hook. This can e.g. be used to automatically tag
  upstream releases by reading configure.ac. See ``bzr help hooks`` for
  details.

:See also: :doc:`commit <commit-help>`, :doc:`tags <tags-help>`