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

                                                                                                    HG(ANNOTATE)