comparison doc/hg.1.txt @ 1254:e6560042b7b8

Switch cat command to use walk code. The old syntax of "hg cat FILE REV" is now obsolete. Use "hg cat -r REV FILE" instead, as for all other commands.
author Bryan O'Sullivan <bos@serpentine.com>
date Wed, 14 Sep 2005 21:57:41 -0700
parents a45e717c61a8
children 8054fdb0b145
comparison
equal deleted inserted replaced
1253:a45e717c61a8 1254:e6560042b7b8
119 extension is ".hg". 119 extension is ".hg".
120 120
121 Unlike import/export, this exactly preserves all changeset 121 Unlike import/export, this exactly preserves all changeset
122 contents including permissions, rename data, and revision history. 122 contents including permissions, rename data, and revision history.
123 123
124 cat <file> [revision]:: 124 cat [options] <file ...>::
125 Output to stdout the given revision for the specified file. 125 Print the specified files as they were at the given revision.
126
127 If no revision is given then the tip is used. 126 If no revision is given then the tip is used.
127
128 Output may be to a file, in which case the name of the file is
129 given using a format string. The formatting rules are the same as
130 for the export command, with the following additions:
131
132 %s basename of file being printed
133 %d dirname of file being printed, or '.' if in repo root
134 %p root-relative path name of file being printed
135
136 options:
137 -I, --include <pat> include names matching the given patterns
138 -X, --exclude <pat> exclude names matching the given patterns
139 -o, --output <filespec> print output to file with formatted name
140 -r, --rev <rev> print the given revision
128 141
129 clone [-U] <source> [dest]:: 142 clone [-U] <source> [dest]::
130 Create a copy of an existing repository in a new directory. 143 Create a copy of an existing repository in a new directory.
131 144
132 If no destination directory name is specified, it defaults to the 145 If no destination directory name is specified, it defaults to the
174 operation is recorded, but no copying is performed. 187 operation is recorded, but no copying is performed.
175 188
176 This command takes effect in the next commit. 189 This command takes effect in the next commit.
177 190
178 Options: 191 Options:
179 -A, --after record a copy that has already occurred 192 -A, --after record a copy that has already occurred
180 -f, --force forcibly copy over an existing managed file 193 -I, --include <pat> include names matching the given patterns
181 -p, --parents append source path to dest 194 -X, --exclude <pat> exclude names matching the given patterns
195 -f, --force forcibly copy over an existing managed file
196 -p, --parents append source path to dest
182 197
183 aliases: cp 198 aliases: cp
184 199
185 diff [-a] [-r revision] [-r revision] [files ...]:: 200 diff [-a] [-r revision] [-r revision] [files ...]::
186 Show differences between revisions for the specified files. 201 Show differences between revisions for the specified files.
224 it detects as binary. With -a, export will generate a diff anyway, 239 it detects as binary. With -a, export will generate a diff anyway,
225 probably with undesirable results. 240 probably with undesirable results.
226 241
227 options: 242 options:
228 -a, --text treat all files as text 243 -a, --text treat all files as text
229 -o, --output <filespec> print output to file with formatted named 244 -o, --output <filespec> print output to file with formatted name
230 245
231 forget [options] [files]:: 246 forget [options] [files]::
232 Undo an 'hg add' scheduled for the next commit. 247 Undo an 'hg add' scheduled for the next commit.
233 248
234 options: 249 options: