Help: grep

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

search for a pattern in specified files

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

-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

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: US-ASCII)
--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)