Mercurial > HIS > BLT-XML
Help: cat
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 template string. See 'hg help templates'. In addition to the common template keywords, the following formatting rules are supported:
- "%%"
- 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
- "\"
- literal "\" character
Template:
The following keywords are supported in addition to the common template keywords and functions. See also 'hg help templates'.
- data
- String. File content.
- path
- String. Repository-absolute path of the file.
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 |
| -T | --template TEMPLATE | display with template |
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) |
