hg bookmarks - create a new bookmark or list existing bookmarks
Contents
Aliases
bookmark
HG(BOOKMARKS)
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 hgupdate 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 hghelppush and hghelppull). If a shared
bookmark has diverged, a new 'divergent bookmark' of the form 'name@path' will be created. Using hgmerge
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 hgclone 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 hghelptemplates.
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 .
Name
hg bookmarks - create a new bookmark or list existing bookmarks
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
Synopsis
hg bookmarks [OPTIONS]... [NAME]...
