Help: annotate

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

aliases: blame

show changeset information by line for each file

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.

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 ([+] can be repeated):

-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)
-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

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)

Mercurial > repos > iuc > king

Help: annotate