Help: bookmarks

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

aliases: bookmark

create a new bookmark or list existing bookmarks

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

global options ([+] can be repeated):

-R	--repository REPO	repository root directory or name of overlay bundle file
	--cwd DIR	change working directory
-y	--noninteractive	do not prompt, automatically pick the first choice for all prompts
-q	--quiet	suppress output
-v	--verbose	enable additional output
	--color TYPE	when to colorize (boolean, always, auto, never, or debug)
	--config CONFIG [+]	set/override config option (use 'section.name=value')
	--debug	enable debugging output
	--debugger	start debugger
	--encoding ENCODE	set the charset encoding (default: "UTF-8")
	--encodingmode MODE	set the charset encoding mode (default: strict)
	--traceback	always print a traceback on exception
	--time	time how long the command takes
	--profile	print command execution profile
	--version	output version information and exit
-h	--help	display help and exit
	--hidden	consider hidden changesets
	--pager TYPE	when to paginate (boolean, always, auto, or never) (default: auto)