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:

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

         hg book new-feature

       • create an inactive bookmark as a place marker:

         hg book -i reviewed

       • create an inactive bookmark on another changeset:

         hg book -r .^ tested

       • rename bookmark turkey to dinner:

         hg book -m turkey dinner

       • move the '@' bookmark from another branch:

         hg book -f @

       • 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)