1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
.TH HG BOOKMARKS "" "" ""
.SH NAME
hg bookmarks \- create a new bookmark or list existing bookmarks
.\" Man page generated from reStructuredText.
.
.SH SYNOPSIS
.sp
.nf
.ft C
hg bookmarks [OPTIONS]... [NAME]...
.ft P
.fi
.SH DESCRIPTION
.sp
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.
.sp
Creating or updating to a bookmark causes it to be marked as \(aqactive\(aq.
The active bookmark is indicated with a \(aq*\(aq.
When a commit is made, the active bookmark will advance to the new commit.
A plain \%\fBhg update\fP\: will also advance an active bookmark, if possible.
Updating away from a bookmark will cause it to be deactivated.
.sp
Bookmarks can be pushed and pulled between repositories (see
\%\fBhg help push\fP\: and \%\fBhg help pull\fP\:). If a shared bookmark has
diverged, a new \(aqdivergent bookmark\(aq of the form \%\(aqname@path\:\(aq will
be created. Using \%\fBhg merge\fP\: will resolve the divergence.
.sp
Specifying bookmark as \(aq.\(aq to \-m/\-d/\-l options is equivalent to specifying
the active bookmark\(aqs name.
.sp
A bookmark named \(aq@\(aq has the special property that \%\fBhg clone\fP\: will
check it out by default if it exists.
.sp
Template:
.sp
The following keywords are supported in addition to the common template
keywords and functions such as \fB{bookmark}\fP. See also
\%\fBhg help templates\fP\:.
.INDENT 0.0
.TP
.B active
.
Boolean. True if the bookmark is active.
.UNINDENT
.sp
Examples:
.INDENT 0.0
.IP \(bu 2
.
create an active bookmark for a new line of development:
.sp
.nf
.ft C
hg book new\-feature
.ft P
.fi
.IP \(bu 2
.
create an inactive bookmark as a place marker:
.sp
.nf
.ft C
hg book \-i reviewed
.ft P
.fi
.IP \(bu 2
.
create an inactive bookmark on another changeset:
.sp
.nf
.ft C
hg book \-r .^ tested
.ft P
.fi
.IP \(bu 2
.
rename bookmark turkey to dinner:
.sp
.nf
.ft C
hg book \-m turkey dinner
.ft P
.fi
.IP \(bu 2
.
move the \(aq@\(aq bookmark from another branch:
.sp
.nf
.ft C
hg book \-f @
.ft P
.fi
.IP \(bu 2
.
print only the active bookmark name:
.sp
.nf
.ft C
hg book \-ql .
.ft P
.fi
.UNINDENT
.SH OPTIONS
.INDENT 0.0
.TP
.B \-f, \-\-force
.
force
.TP
.BI \-r, \-\-rev \ <REV>
.
revision for bookmark action
.TP
.B \-d, \-\-delete
.
delete a given bookmark
.TP
.BI \-m, \-\-rename \ <OLD>
.
rename a given bookmark
.TP
.B \-i, \-\-inactive
.
mark a bookmark inactive
.TP
.B \-l, \-\-list
.
list existing bookmarks
.TP
.BI \-T, \-\-template \ <TEMPLATE>
.
display with template
.UNINDENT
.SH ALIASES
.sp
.nf
.ft C
bookmark
.ft P
.fi
.\" Generated by docutils manpage writer.
.\"
.
|
