Mercurial > hg > afontology
Help: files
hg files [OPTION]... [PATTERN]...
list tracked files
Print files under Mercurial control in the working directory or specified revision whose names match the given patterns (excluding removed files).
If no patterns are given to match, this command prints the names of all files under Mercurial control in the working directory.
Examples:
- list all files under the current directory:
hg files .
- shows sizes and flags for current revision:
hg files -vr .
- list all files named README:
hg files -I "**/README"
- list all binary files:
hg files "set:binary()"
- find files containing a regular expression:
hg files "set:grep('bob')"
- search tracked file contents with xargs and grep:
hg files -0 | xargs -0 grep foo
See 'hg help patterns' and 'hg help filesets' for more information on specifying file patterns.
Returns 0 if a match is found, 1 otherwise.
options ([+] can be repeated):
-r | --rev REV | search the repository as it is in REV |
-0 | --print0 | end filenames with NUL, for use with xargs |
-I | --include PATTERN [+] | include names matching the given patterns |
-X | --exclude PATTERN [+] | exclude names matching the given patterns |
-T | --template TEMPLATE | display with template (EXPERIMENTAL) |
-S | --subrepos | recurse into subrepositories |
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 |
--config CONFIG [+] | set/override config option (use 'section.name=value') | |
--debug | enable debugging output | |
--debugger | start debugger | |
--encoding ENCODE | set the charset encoding (default: UTF-8) | |
--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 |