NAME¶

hg annotate - show changeset information by line for each file

SYNOPSIS¶

hg annotate [-r REV] [-f] [-a] [-u] [-d] [-n] [-c] [-l] FILE...

DESCRIPTION¶

List changes in files, showing the revision id responsible for each line.

This command is useful for discovering when a change was made and by whom.

If you include --file, --user, or --date, the revision number is suppressed unless you also include --number.

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.

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.

Template:

The following keywords are supported in addition to the common template keywords and functions. See also hg help templates.

lines

List of lines with annotation data.

path

String. Repository-absolute path of the specified file.

And each entry of {lines} provides the following sub-keywords in addition to {date}, {node}, {rev}, {user}, etc.

line

String. Line content.

lineno

Integer. Line number at that revision.

path

String. Repository-absolute path of the file at that revision.

See hg help templates.operators for the list expansion syntax.

Returns 0 on success.

OPTIONS¶

-r,--rev <REV>

annotate the specified revision

--follow

follow copies/renames and list the filename (DEPRECATED)

--no-follow

don't follow copies and renames

-a, --text

treat all files as text

-u, --user

list the author (long with -v)

-f, --file

list the filename

-d, --date

list the date (short with -q)

-n, --number

list the revision number (default)

-c, --changeset

list the changeset

-l, --line-number

show line number at the first appearance

--skip <REV[+]>

revset to not display (EXPERIMENTAL)

-L,--line-range <FILE,RANGE[+]>

follow line range of specified file (EXPERIMENTAL)

-w, --ignore-all-space

ignore white space when comparing lines

-b, --ignore-space-change

ignore changes in the amount of white space

-B, --ignore-blank-lines

ignore changes whose lines are all blank

-Z, --ignore-space-at-eol

ignore changes in whitespace at EOL

-I,--include <PATTERN[+]>

include names matching the given patterns

-X,--exclude <PATTERN[+]>

exclude names matching the given patterns

-T,--template <TEMPLATE>

display with template

[+] marked option can be specified multiple times

ALIASES¶

blame