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)