hg cat

output the current or given revision of files



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


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


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.


-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

[+] marked option can be specified multiple times