Mercurial > hg > pub > prymula > com
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) |