NAME

       hg grep - search for a pattern in specified files

SYNOPSIS

       hg grep [--diff] [OPTION]... PATTERN [FILE]...

DESCRIPTION

       Search the working directory or revision history for a regular expression in the specified
       files for the entire repository.

       By default, grep searches the repository files in the working  directory  and  prints  the
       files  where  it  finds  a  match.  To specify historical revisions instead of the working
       directory, use the --rev flag.

       To search instead historical revision differences that contains a change in  match  status
       ("-"  for  a match that becomes a non-match, or "+" for a non-match that becomes a match),
       use the --diff flag.

       PATTERN can be any Python (roughly Perl-compatible) regular expression.

       If no FILEs are specified and the --rev flag isn't supplied,  all  files  in  the  working
       directory  are  searched. When using the --rev flag and specifying FILEs, use the --follow
       argument to also follow the specified FILEs across renames and copies.

       Template:

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

       change String.  Character  denoting  insertion  +  or  removal  -.  Available if --diff is
              specified.

       lineno Integer. Line number of the match.

       path   String. Repository-absolute path of the file.

       texts  List of text chunks.

              And each entry of {texts} provides the following sub-keywords.

       matched
              Boolean. True if the chunk matches the specified pattern.

       text   String. Chunk content.

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

              Returns 0 if a match is found, 1 otherwise.

OPTIONS

       -0, --print0
              end fields with NUL

       --all  an alias to --diff (DEPRECATED)

       --diff search revision differences for when the pattern was added or removed

       -a, --text
              treat all files as text

       -f, --follow
              follow changeset history, or file history across copies and renames

       -i, --ignore-case
              ignore case when matching

       -l, --files-with-matches
              print only filenames and revisions that match

       -n, --line-number
              print matching line numbers

       -r,--rev <REV[+]>
              search files changed within revision range

       --all-files
              include all files in the changeset while grepping (DEPRECATED)

       -u, --user
              list the author (long with -v)

       -d, --date
              list the date (short with -q)

       -T,--template <TEMPLATE>
              display with template

       -I,--include <PATTERN[+]>
              include names matching the given patterns

       -X,--exclude <PATTERN[+]>
              exclude names matching the given patterns

              [+] marked option can be specified multiple times

                                                                                         HG(GREP)