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)
PK{RT3'* hyphy_absrel-5a2b7f3d05e8/.hg_archival.txtUT;`PK{R`t* hyphy_absrel-5a2b7f3d05e8/hyphy_absrel.xmlUT;`PK{RH &$ Hhyphy_absrel-5a2b7f3d05e8/macros.xmlUT;`PK{Rb c| . hyphy_absrel-5a2b7f3d05e8/scripts/annotator.bfUT;`PK{RbWL=m2 dhyphy_absrel-5a2b7f3d05e8/scripts/hyphy_summary.pyUT;`PK{R;G 2 Thyphy_absrel-5a2b7f3d05e8/scripts/strike-ambigs.bfUT;`PK{Rv561 Yhyphy_absrel-5a2b7f3d05e8/test-data/absrel-in1.faUT;`PK{Rm-72 :_hyphy_absrel-5a2b7f3d05e8/test-data/absrel-in1.nhxUT;`PK{RA+da?4 ;`hyphy_absrel-5a2b7f3d05e8/test-data/absrel-out1.jsonUT;`PK{Ruxs6 qhyphy_absrel-5a2b7f3d05e8/test-data/annotate-in1.fa.gzUT;`PK{R)M"I4 yhyphy_absrel-5a2b7f3d05e8/test-data/annotate-in1.nhxUT;`PK{R };; U{hyphy_absrel-5a2b7f3d05e8/test-data/annotate-out1-clade.nhxUT;`PK{RvJ9: }hyphy_absrel-5a2b7f3d05e8/test-data/annotate-out1-full.nhxUT;`PK{R*D99 ~hyphy_absrel-5a2b7f3d05e8/test-data/annotate-out1-int.nhxUT;`PK{R(6 Uhyphy_absrel-5a2b7f3d05e8/test-data/annotate-out1.jsonUT;`PK{R7̜x. hyphy_absrel-5a2b7f3d05e8/test-data/bgm-in1.faUT;`PK{R[,N/ hyphy_absrel-5a2b7f3d05e8/test-data/bgm-in1.nhxUT;`PK{R[g 1 hyphy_absrel-5a2b7f3d05e8/test-data/bgm-out1.jsonUT;`PK{R|t5+2 hyphy_absrel-5a2b7f3d05e8/test-data/busted-in2.nexUT;`PK{RXH4 (hyphy_absrel-5a2b7f3d05e8/test-data/busted-out1.jsonUT;`PK{R+7IF6 ghyphy_absrel-5a2b7f3d05e8/test-data/busted-out2-1.jsonUT;`PK{RH02q6 U'hyphy_absrel-5a2b7f3d05e8/test-data/busted-out2-2.jsonUT;`PK{R%Y^.q2 eXhyphy_absrel-5a2b7f3d05e8/test-data/cfel-out1.jsonUT;`PK{R{Qz/ hyphy_absrel-5a2b7f3d05e8/test-data/conv-in1.faUT;`PK{Rhti*+1 thyphy_absrel-5a2b7f3d05e8/test-data/conv-out1.nexUT;`PK{R 5/ hyphy_absrel-5a2b7f3d05e8/test-data/fade-in1.faUT;`PK{RSG70 hyphy_absrel-5a2b7f3d05e8/test-data/fade-in1.nhxUT;`PK{RЧ[;2 hyphy_absrel-5a2b7f3d05e8/test-data/fade-out1.jsonUT;`PK{RO4u1 |hyphy_absrel-5a2b7f3d05e8/test-data/fel-out1.jsonUT;`PK{R=A.03 ;hyphy_absrel-5a2b7f3d05e8/test-data/fubar-in1.fa.gzUT;`PK{R^V 1 hyphy_absrel-5a2b7f3d05e8/test-data/fubar-in1.nhxUT;`PK $