Help: files

hg files [OPTION]... [FILE]...

list tracked files

Print files under Mercurial control in the working directory or specified revision for given files (excluding removed files). Files can be specified as filenames or filesets.

If no files are given to match, this command prints the names of all files under Mercurial control.

Template:

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

flags: String. Character denoting file's symlink and executable bits.
path: String. Repository-absolute path of the file.
size: Integer. Size of the file in bytes.

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
-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
	--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: 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
	--pager TYPE	when to paginate (boolean, always, auto, or never) (default: auto)

Mercurial > HIS > BLT-XML

Help: files