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
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
.TH HG ANNOTATE "" "" ""
.SH NAME
hg annotate \- show changeset information by line for each file
.\" Man page generated from reStructuredText.
.
.SH SYNOPSIS
.sp
.nf
.ft C
hg annotate [\-r REV] [\-f] [\-a] [\-u] [\-d] [\-n] [\-c] [\-l] FILE...
.ft P
.fi
.SH DESCRIPTION
.sp
List changes in files, showing the revision id responsible for
each line.
.sp
This command is useful for discovering when a change was made and
by whom.
.sp
If you include \-\-file, \-\-user, or \-\-date, the revision number is
suppressed unless you also include \-\-number.
.sp
Without the \-a/\-\-text option, annotate will avoid processing files
it detects as binary. With \-a, annotate will annotate the file
anyway, although the results will probably be neither useful
nor desirable.
.sp
Use \-L/\-\-line\-range FILE,M:N options to filter the output to the lines
from M to N in FILE. This option is incompatible with \-\-no\-follow and
cannot be combined with file pattern arguments. When combined with \-\-rev
the line ranges refer to the state of the file at the requested revision.
.sp
Template:
.sp
The following keywords are supported in addition to the common template
keywords and functions. See also \%\fBhg help templates\fP\:.
.INDENT 0.0
.TP
.B lines
.
List of lines with annotation data.
.TP
.B path
.
String. Repository\-absolute path of the specified file.
.UNINDENT
.sp
And each entry of \fB{lines}\fP provides the following sub\-keywords in
addition to \fB{date}\fP, \fB{node}\fP, \fB{rev}\fP, \fB{user}\fP, etc.
.INDENT 0.0
.TP
.B line
.
String. Line content.
.TP
.B lineno
.
Integer. Line number at that revision.
.TP
.B path
.
String. Repository\-absolute path of the file at that revision.
.UNINDENT
.sp
See \%\fBhg help templates.operators\fP\: for the list expansion syntax.
.sp
Returns 0 on success.
.SH OPTIONS
.INDENT 0.0
.TP
.BI \-r, \-\-rev \ <REV>
.
annotate the specified revision
.TP
.B \-\-follow
.
follow copies/renames and list the filename (DEPRECATED)
.TP
.B \-\-no\-follow
.
don\(aqt follow copies and renames
.TP
.B \-a, \-\-text
.
treat all files as text
.TP
.B \-u, \-\-user
.
list the author (long with \-v)
.TP
.B \-f, \-\-file
.
list the filename
.TP
.B \-d, \-\-date
.
list the date (short with \-q)
.TP
.B \-n, \-\-number
.
list the revision number (default)
.TP
.B \-c, \-\-changeset
.
list the changeset
.TP
.B \-l, \-\-line\-number
.
show line number at the first appearance
.TP
.BI \-\-skip \ <REV[+]>
.
revset to not display (EXPERIMENTAL)
.TP
.BI \-L, \-\-line\-range \ <FILE,RANGE[+]>
.
follow line range of specified file (EXPERIMENTAL)
.TP
.B \-w, \-\-ignore\-all\-space
.
ignore white space when comparing lines
.TP
.B \-b, \-\-ignore\-space\-change
.
ignore changes in the amount of white space
.TP
.B \-B, \-\-ignore\-blank\-lines
.
ignore changes whose lines are all blank
.TP
.B \-Z, \-\-ignore\-space\-at\-eol
.
ignore changes in whitespace at EOL
.TP
.BI \-I, \-\-include \ <PATTERN[+]>
.
include names matching the given patterns
.TP
.BI \-X, \-\-exclude \ <PATTERN[+]>
.
exclude names matching the given patterns
.TP
.BI \-T, \-\-template \ <TEMPLATE>
.
display with template
.UNINDENT
.sp
[+] marked option can be specified multiple times
.SH ALIASES
.sp
.nf
.ft C
blame
.ft P
.fi
.\" Generated by docutils manpage writer.
.\"
.
|
