HG(BOOKMARKS)                                                    HG(BOOKMARKS)

NAME
       hg bookmarks - create a new bookmark or list existing bookmarks

SYNOPSIS
       hg bookmarks [OPTIONS]... [NAME]...

DESCRIPTION
       Bookmarks are labels on changesets to help track lines of development.
       Bookmarks are unversioned and can be moved, renamed and deleted.
       Deleting or moving a bookmark has no effect on the associated
       changesets.

       Creating or updating to a bookmark causes it to be marked as 'active'.
       The active bookmark is indicated with a '*'.  When a commit is made,
       the active bookmark will advance to the new commit.  A plain hg update
        will also advance an active bookmark, if possible.  Updating away from
       a bookmark will cause it to be deactivated.

       Bookmarks can be pushed and pulled between repositories (see hg help
       push and hg help pull). If a shared bookmark has diverged, a new
       'divergent bookmark' of the form 'name@path' will be created. Using hg
       merge will resolve the divergence.

       Specifying bookmark as '.' to -m/-d/-l options is equivalent to
       specifying the active bookmark's name.

       A bookmark named '@' has the special property that hg clone will check
       it out by default if it exists.

       Template:

       The following keywords are supported in addition to the common template
       keywords and functions such as {bookmark}. See also hg help templates.

       active Boolean. True if the bookmark is active.

              Examples:

       o create an active bookmark for a new line of development:

         hg book new-feature

       o create an inactive bookmark as a place marker:

         hg book -i reviewed

       o create an inactive bookmark on another changeset:

         hg book -r .^ tested

       o rename bookmark turkey to dinner:

         hg book -m turkey dinner

       o move the '@' bookmark from another branch:

         hg book -f @

       o print only the active bookmark name:

         hg book -ql .

OPTIONS
       -f, --force
              force

       -r,--rev <REV>
              revision for bookmark action

       -d, --delete
              delete a given bookmark

       -m,--rename <OLD>
              rename a given bookmark

       -i, --inactive
              mark a bookmark inactive

       -l, --list
              list existing bookmarks

       -T,--template <TEMPLATE>
              display with template

ALIASES
       bookmark

                                                                 HG(BOOKMARKS)