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