Mercurial > public > dvcs_intro_brownbag

Help: cat

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.

hg cat [OPTION]... FILE...

output the current or given revision of files

Print the specified files as they were at the given revision. If no revision is given, the parent of the working directory is used.

Output may be to a file, in which case the name of the file is given using a format string. The formatting rules as follows:

"%%"
literal "%" character
"%s"
basename of file being printed
"%d"
dirname of file being printed, or '.' if in repository root
"%p"
root-relative path name of file being printed
"%H"
changeset hash (40 hexadecimal digits)
"%R"
changeset revision number
"%h"
short-form changeset hash (12 hexadecimal digits)
"%r"
zero-padded changeset revision number
"%b"
basename of the exporting repository

Returns 0 on success.

options ([+] can be repeated):

-o --output FORMAT print output to file with formatted name
-r --rev REV print the given revision
--decode apply any matching decode filter
-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
--config CONFIG [+] set/override config option (use 'section.name=value')
--debug enable debugging output
--debugger start debugger
--encoding ENCODE set the charset encoding (default: 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