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)CrS~- umi_tools_count-a535cf1e5da4/.hg_archival.txtUT aPK)CrS&aCs' umi_tools_count-a535cf1e5da4/macros.xmlUT aPK)CrSvw#w: umi_tools_count-a535cf1e5da4/test-data/chr19_gene_tags.bamUT aPK)CrS,)Z|: "umi_tools_count-a535cf1e5da4/test-data/chr19_gene_tags.samUT aPK)CrS W*wF #umi_tools_count-a535cf1e5da4/test-data/count_single_cells_gene_tag.tsvUT aPK)CrS->K $umi_tools_count-a535cf1e5da4/test-data/count_single_cells_gene_tag_wide.tsvUT aPK)CrSq`{}@ %umi_tools_count-a535cf1e5da4/test-data/count_single_gene_tag.tsvUT aPK)CrS12)$5 &umi_tools_count-a535cf1e5da4/test-data/dedup_out1.bamUT aPK)CrS ]umi_tools_count-a535cf1e5da4/test-data/out_wl_paired.tresh.tabUT aPK)CrSMSR8 umi_tools_count-a535cf1e5da4/test-data/out_wl_paired.txtUT aPK)CrSX{9 umi_tools_count-a535cf1e5da4/test-data/out_wl_single.htmlUT aPK)CrS)[ #> umi_tools_count-a535cf1e5da4/test-data/out_wl_single.tresh.tabUT aPK)CrS!3\8 Aumi_tools_count-a535cf1e5da4/test-data/out_wl_single.txtUT aPK)CrSX{> umi_tools_count-a535cf1e5da4/test-data/out_wl_user.single.htmlUT aPK)CrS1TC umi_tools_count-a535cf1e5da4/test-data/out_wl_user.single.tresh.tabUT aPK)CrSD4{4`= ~umi_tools_count-a535cf1e5da4/test-data/out_wl_user.single.txtUT aPK)CrSaf5 Rumi_tools_count-a535cf1e5da4/test-data/read_R1.200.gzUT aPK)CrS`>4/E umi_tools_count-a535cf1e5da4/test-data/read_R1.200_extracted.fastq.gzUT aPK)CrS"  5 <umi_tools_count-a535cf1e5da4/test-data/read_R2.200.gzUT aPK)CrS|Ej e E umi_tools_count-a535cf1e5da4/test-data/read_R2.200_extracted.fastq.gzUT aPK)CrS#< umi_tools_count-a535cf1e5da4/test-data/scrb_extract.fastq.gzUT aPK)CrSfһ 8 Fumi_tools_count-a535cf1e5da4/test-data/scrb_seq_barcodesUT aPK)CrS߶8]: Aumi_tools_count-a535cf1e5da4/test-data/scrb_seq_fastq.1.gzUT aPK)CrS}Mkw: Qumi_tools_count-a535cf1e5da4/test-data/scrb_seq_fastq.2.gzUT aPK)CrSS BcF ß umi_tools_count-a535cf1e5da4/test-data/stats_outputs_edit_distance.tsvUT aPK)CrSo:*@ umi_tools_count-a535cf1e5da4/test-data/stats_outputs_per_umi.tsvUT aPK)CrS[ҏ/:M umi_tools_count-a535cf1e5da4/test-data/stats_outputs_per_umi_per_position.tsvUT aPK)CrSxDsd1 Y umi_tools_count-a535cf1e5da4/test-data/t_R1.fastqUT aPK)CrSecF׊4 4 umi_tools_count-a535cf1e5da4/test-data/t_R1.fastq.gzUT aPK)CrSu7Ad1 ) umi_tools_count-a535cf1e5da4/test-data/t_R2.fastqUT aPK)CrS4R4 ` umi_tools_count-a535cf1e5da4/test-data/t_R2.fastq.gzUT aPK??!