Contents
hg bookmarks [OPTIONS]... [NAME]...
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 .
| -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 | |
bookmark