1 --- mercurial-1.3.1/doc/hg.1 Thu Jul 23 10:58:26 2009 |
1 --- mercurial-1.8.2/doc/hg.1 Fri Apr 1 10:42:06 2011 |
2 +++ /usr/share/man/man1/hg.1 Tue Feb 19 05:28:30 2002 |
2 +++ mercurial-1.8.2/doc/hg.1 Fri Apr 1 11:18:00 2011 |
3 @@ -757,7 +762,7 @@ |
3 @@ -1,35 +1,9 @@ |
4 .RS 4 |
4 +'\" t |
5 .\} |
5 .\" Man page generated from reStructeredText. |
6 .nf |
6 . |
|
7 .TH HG 1 "" "" "Mercurial Manual" |
|
8 .SH NAME |
|
9 hg \- Mercurial source code management system |
|
10 -. |
|
11 -.nr rst2man-indent-level 0 |
|
12 -. |
|
13 -.de1 rstReportMargin |
|
14 -\\$1 \\n[an-margin] |
|
15 -level \\n[rst2man-indent-level] |
|
16 -level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] |
|
17 -- |
|
18 -\\n[rst2man-indent0] |
|
19 -\\n[rst2man-indent1] |
|
20 -\\n[rst2man-indent2] |
|
21 -.. |
|
22 -.de1 INDENT |
|
23 -.\" .rstReportMargin pre: |
|
24 -. RS \\$1 |
|
25 -. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] |
|
26 -. nr rst2man-indent-level +1 |
|
27 -.\" .rstReportMargin post: |
|
28 -.. |
|
29 -.de UNINDENT |
|
30 -. RE |
|
31 -.\" indent \\n[an-margin] |
|
32 -.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] |
|
33 -.nr rst2man-indent-level -1 |
|
34 -.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] |
|
35 -.in \\n[rst2man-indent\\n[rst2man-indent-level]]u |
|
36 -.. |
|
37 .SH SYNOPSIS |
|
38 .sp |
|
39 \fBhg\fP \fIcommand\fP [\fIoption\fP]... [\fIargument\fP]... |
|
40 @@ -43,7 +17,7 @@ |
|
41 .B files... |
|
42 . |
|
43 indicates one or more filename or relative path filenames; see |
|
44 -\%File Name Patterns\: for information on pattern matching |
|
45 +File Name Patterns for information on pattern matching |
|
46 .TP |
|
47 .B path |
|
48 . |
|
49 @@ -73,7 +47,7 @@ |
|
50 .TP |
|
51 .B \-y, \-\-noninteractive |
|
52 . |
|
53 -do not prompt, assume \(aqyes\(aq for any required answers |
|
54 +do not prompt, assume 'yes' for any required answers |
|
55 .TP |
|
56 .B \-q, \-\-quiet |
|
57 . |
|
58 @@ -85,7 +59,7 @@ |
|
59 .TP |
|
60 .B \-\-config |
|
61 . |
|
62 -set/override config option (use \(aqsection.name=value\(aq) |
|
63 +set/override config option (use 'section.name=value') |
|
64 .TP |
|
65 .B \-\-debug |
|
66 . |
|
67 @@ -127,9 +101,9 @@ |
|
68 .SS add |
|
69 .sp |
|
70 .nf |
|
71 -.ft C |
|
72 +.ft |
|
73 hg add [OPTION]... [FILE]... |
|
74 -.ft P |
|
75 +.ft |
|
76 .fi |
|
77 .sp |
|
78 Schedule files to be version controlled and added to the |
|
79 @@ -136,15 +110,15 @@ |
|
80 repository. |
|
81 .sp |
|
82 The files will be added to the repository at the next commit. To |
|
83 -undo an add before that, see \%\fBhg forget\fP\:. |
|
84 +undo an add before that, see \fBhg forget\fP. |
|
85 .sp |
|
86 If no names are given, add all files to the repository. |
|
87 .sp |
|
88 An example showing how new (unknown) files are added |
|
89 -automatically by \%\fBhg add\fP\:: |
|
90 +automatically by \fBhg add\fP: |
|
91 .sp |
|
92 .nf |
|
93 -.ft C |
|
94 +.ft |
|
95 $ ls |
|
96 foo.c |
|
97 $ hg status |
|
98 @@ -153,7 +127,7 @@ |
|
99 adding foo.c |
|
100 $ hg status |
|
101 A foo.c |
|
102 -.ft P |
|
103 +.ft |
|
104 .fi |
|
105 .sp |
|
106 Returns 0 if all files are successfully added. |
|
107 @@ -180,9 +154,9 @@ |
|
108 .SS addremove |
|
109 .sp |
|
110 .nf |
|
111 -.ft C |
|
112 +.ft |
|
113 hg addremove [OPTION]... [FILE]... |
|
114 -.ft P |
|
115 +.ft |
|
116 .fi |
|
117 .sp |
|
118 Add all new files and remove all missing files from the |
|
119 @@ -197,7 +171,7 @@ |
|
120 every added file and records those similar enough as renames. This |
|
121 option takes a percentage between 0 (disabled) and 100 (files must |
|
122 be identical) as its parameter. Detecting renamed files this way |
|
123 -can be expensive. After using this option, \%\fBhg status \-C\fP\: can be |
|
124 +can be expensive. After using this option, \fBhg status \-C\fP can be |
|
125 used to check which files were identified as moved or renamed. |
|
126 .sp |
|
127 Returns 0 if all files are successfully added. |
|
128 @@ -224,9 +198,9 @@ |
|
129 .SS annotate |
|
130 .sp |
|
131 .nf |
|
132 -.ft C |
|
133 +.ft |
|
134 hg annotate [\-r REV] [\-f] [\-a] [\-u] [\-d] [\-n] [\-c] [\-l] FILE... |
|
135 -.ft P |
|
136 +.ft |
|
137 .fi |
|
138 .sp |
|
139 List changes in files, showing the revision id responsible for |
|
140 @@ -255,7 +229,7 @@ |
|
141 .TP |
|
142 .B \-\-no\-follow |
|
143 . |
|
144 -don\(aqt follow copies and renames |
|
145 +don't follow copies and renames |
|
146 .TP |
|
147 .B \-a, \-\-text |
|
148 . |
|
149 @@ -298,9 +272,9 @@ |
|
150 .SS archive |
|
151 .sp |
|
152 .nf |
|
153 -.ft C |
|
154 +.ft |
|
155 hg archive [OPTION]... DEST |
|
156 -.ft P |
|
157 +.ft |
|
158 .fi |
|
159 .sp |
|
160 By default, the revision used is the parent of the working |
|
161 @@ -338,7 +312,7 @@ |
|
162 .UNINDENT |
|
163 .sp |
|
164 The exact name of the destination archive or directory is given |
|
165 -using a format string; see \%\fBhg help export\fP\: for details. |
|
166 +using a format string; see \fBhg help export\fP for details. |
|
167 .sp |
|
168 Each member added to an archive file has a directory prefix |
|
169 prepended. Use \-p/\-\-prefix to specify a format string for the |
|
170 @@ -381,9 +355,9 @@ |
|
171 .SS backout |
|
172 .sp |
|
173 .nf |
|
174 -.ft C |
|
175 +.ft |
|
176 hg backout [OPTION]... [\-r] REV |
|
177 -.ft P |
|
178 +.ft |
|
179 .fi |
|
180 .sp |
|
181 Prepare a new changeset with the effect of REV undone in the |
|
182 @@ -399,11 +373,11 @@ |
|
183 directory and a new child of REV that simply undoes REV. |
|
184 .sp |
|
185 Before version 1.7, the behavior without \-\-merge was equivalent to |
|
186 -specifying \-\-merge followed by \%\fBhg update \-\-clean .\fP\: to cancel |
|
187 +specifying \-\-merge followed by \fBhg update \-\-clean .\fP to cancel |
|
188 the merge and leave the child of REV as a head to be merged |
|
189 separately. |
|
190 .sp |
|
191 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date. |
|
192 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date. |
|
193 .sp |
|
194 Returns 0 on success. |
|
195 .sp |
|
196 @@ -453,9 +427,9 @@ |
|
197 .SS bisect |
|
198 .sp |
|
199 .nf |
|
200 -.ft C |
|
201 +.ft |
|
202 hg bisect [\-gbsr] [\-U] [\-c CMD] [REV] |
|
203 -.ft P |
|
204 +.ft |
|
205 .fi |
|
206 .sp |
|
207 This command helps to find changesets which introduce problems. To |
|
208 @@ -508,23 +482,23 @@ |
|
209 .SS bookmarks |
|
210 .sp |
|
211 .nf |
|
212 -.ft C |
|
213 +.ft |
|
214 hg bookmarks [\-f] [\-d] [\-m NAME] [\-r REV] [NAME] |
|
215 -.ft P |
|
216 +.ft |
|
217 .fi |
|
218 .sp |
|
219 Bookmarks are pointers to certain commits that move when |
|
220 committing. Bookmarks are local. They can be renamed, copied and |
|
221 -deleted. It is possible to use bookmark names in \%\fBhg merge\fP\: and |
|
222 -\%\fBhg update\fP\: to merge and update respectively to a given bookmark. |
|
223 +deleted. It is possible to use bookmark names in \fBhg merge\fP and |
|
224 +\fBhg update\fP to merge and update respectively to a given bookmark. |
|
225 .sp |
|
226 -You can use \%\fBhg bookmark NAME\fP\: to set a bookmark on the working |
|
227 -directory\(aqs parent revision with the given name. If you specify |
|
228 +You can use \fBhg bookmark NAME\fP to set a bookmark on the working |
|
229 +directory's parent revision with the given name. If you specify |
|
230 a revision using \-r REV (where REV may be an existing bookmark), |
|
231 the bookmark is assigned to that revision. |
|
232 .sp |
|
233 -Bookmarks can be pushed and pulled between repositories (see \%\fBhg help |
|
234 -push\fP\: and \%\fBhg help pull\fP\:). This requires both the local and remote |
|
235 +Bookmarks can be pushed and pulled between repositories (see \fBhg help |
|
236 +push\fP and \fBhg help pull\fP). This requires both the local and remote |
|
237 repositories to support bookmarks. For versions prior to 1.8, this means |
|
238 the bookmarks extension must be enabled. |
|
239 .sp |
|
240 @@ -550,26 +524,26 @@ |
|
241 .SS branch |
|
242 .sp |
|
243 .nf |
|
244 -.ft C |
|
245 +.ft |
|
246 hg branch [\-fC] [NAME] |
|
247 -.ft P |
|
248 +.ft |
|
249 .fi |
|
250 .sp |
|
251 With no argument, show the current branch name. With one argument, |
|
252 set the working directory branch name (the branch will not exist |
|
253 in the repository until the next commit). Standard practice |
|
254 -recommends that primary development take place on the \(aqdefault\(aq |
|
255 +recommends that primary development take place on the 'default' |
|
256 branch. |
|
257 .sp |
|
258 Unless \-f/\-\-force is specified, branch will not let you set a |
|
259 -branch name that already exists, even if it\(aqs inactive. |
|
260 +branch name that already exists, even if it's inactive. |
|
261 .sp |
|
262 Use \-C/\-\-clean to reset the working directory branch to that of |
|
263 the parent of the working directory, negating a previous branch |
|
264 change. |
|
265 .sp |
|
266 -Use the command \%\fBhg update\fP\: to switch to an existing branch. Use |
|
267 -\%\fBhg commit \-\-close\-branch\fP\: to mark this branch as closed. |
|
268 +Use the command \fBhg update\fP to switch to an existing branch. Use |
|
269 +\fBhg commit \-\-close\-branch\fP to mark this branch as closed. |
|
270 .sp |
|
271 Returns 0 on success. |
|
272 .sp |
|
273 @@ -587,19 +561,19 @@ |
|
274 .SS branches |
|
275 .sp |
|
276 .nf |
|
277 -.ft C |
|
278 +.ft |
|
279 hg branches [\-ac] |
|
280 -.ft P |
|
281 +.ft |
|
282 .fi |
|
283 .sp |
|
284 -List the repository\(aqs named branches, indicating which ones are |
|
285 +List the repository's named branches, indicating which ones are |
|
286 inactive. If \-c/\-\-closed is specified, also list branches which have |
|
287 -been marked closed (see \%\fBhg commit \-\-close\-branch\fP\:). |
|
288 +been marked closed (see \fBhg commit \-\-close\-branch\fP). |
|
289 .sp |
|
290 If \-a/\-\-active is specified, only show active branches. A branch |
|
291 is considered active if it contains repository heads. |
|
292 .sp |
|
293 -Use the command \%\fBhg update\fP\: to switch to an existing branch. |
|
294 +Use the command \fBhg update\fP to switch to an existing branch. |
|
295 .sp |
|
296 Returns 0. |
|
297 .sp |
|
298 @@ -617,9 +591,9 @@ |
|
299 .SS bundle |
|
300 .sp |
|
301 .nf |
|
302 -.ft C |
|
303 +.ft |
|
304 hg bundle [\-f] [\-t TYPE] [\-a] [\-r REV]... [\-\-base REV]... FILE [DEST] |
|
305 -.ft P |
|
306 +.ft |
|
307 .fi |
|
308 .sp |
|
309 Generate a compressed changegroup file collecting changesets not |
|
310 @@ -686,9 +660,9 @@ |
|
311 .SS cat |
|
312 .sp |
|
313 .nf |
|
314 -.ft C |
|
315 +.ft |
|
316 hg cat [OPTION]... FILE... |
|
317 -.ft P |
|
318 +.ft |
|
319 .fi |
|
320 .sp |
|
321 Print the specified files as they were at the given revision. If |
|
322 @@ -706,7 +680,7 @@ |
|
323 .TP |
|
324 .B \fB%d\fP |
|
325 .sp |
|
326 -dirname of file being printed, or \(aq.\(aq if in repository root |
|
327 +dirname of file being printed, or '.' if in repository root |
|
328 .TP |
|
329 .B \fB%p\fP |
|
330 .sp |
|
331 @@ -741,9 +715,9 @@ |
|
332 .SS clone |
|
333 .sp |
|
334 .nf |
|
335 -.ft C |
|
336 +.ft |
|
337 hg clone [OPTION]... SOURCE [DEST] |
|
338 -.ft P |
|
339 +.ft |
|
340 .fi |
|
341 .sp |
|
342 Create a copy of an existing repository in a new directory. |
|
343 @@ -751,14 +725,14 @@ |
|
344 If no destination directory name is specified, it defaults to the |
|
345 basename of the source. |
|
346 .sp |
|
347 -The location of the source is added to the new repository\(aqs |
|
348 +The location of the source is added to the new repository's |
|
349 \fB.hg/hgrc\fP file, as the default to be used for future pulls. |
|
350 .sp |
|
351 -See \%\fBhg help urls\fP\: for valid source format details. |
|
352 +See \fBhg help urls\fP for valid source format details. |
|
353 .sp |
|
354 It is possible to specify an \fBssh://\fP URL as the destination, but no |
|
355 \fB.hg/hgrc\fP and working directory will be created on the remote side. |
|
356 -Please see \%\fBhg help urls\fP\: for important details about \fBssh://\fP URLs. |
|
357 +Please see \fBhg help urls\fP for important details about \fBssh://\fP URLs. |
|
358 .sp |
|
359 A set of changesets (tags, or branch names) to pull may be specified |
|
360 by listing each changeset (tag, or branch name) with \-r/\-\-rev. |
|
361 @@ -769,7 +743,7 @@ |
|
362 No subsequent changesets (including subsequent tags) will be present |
|
363 in the destination. |
|
364 .sp |
|
365 -Using \-r/\-\-rev (or \(aqclone src#rev dest\(aq) implies \-\-pull, even for |
|
366 +Using \-r/\-\-rev (or 'clone src#rev dest') implies \-\-pull, even for |
|
367 local source repositories. |
|
368 .sp |
|
369 For efficiency, hardlinks are used for cloning whenever the source |
|
370 @@ -783,9 +757,9 @@ |
|
371 using full hardlinks with |
|
372 .sp |
|
373 .nf |
|
374 -.ft C |
7 -$ cp \-al REPO REPOCLONE |
375 -$ cp \-al REPO REPOCLONE |
|
376 -.ft P |
|
377 +.ft |
8 +$ /usr/gnu/bin/cp \-al REPO REPOCLONE |
378 +$ /usr/gnu/bin/cp \-al REPO REPOCLONE |
9 .fi |
379 +.ft |
10 .if n \{\ |
380 .fi |
|
381 .sp |
|
382 This is the fastest way to clone, but it is not always safe. The |
|
383 @@ -804,7 +778,7 @@ |
|
384 .IP b. 3 |
|
385 . |
|
386 if \-u . and the source repository is local, the first parent of |
|
387 -the source repository\(aqs working directory |
|
388 +the source repository's working directory |
|
389 .IP c. 3 |
|
390 . |
|
391 the changeset specified with \-u (if a branch name, this means the |
|
392 @@ -870,16 +844,16 @@ |
|
393 .SS commit |
|
394 .sp |
|
395 .nf |
|
396 -.ft C |
|
397 +.ft |
|
398 hg commit [OPTION]... [FILE]... |
|
399 -.ft P |
|
400 +.ft |
|
401 .fi |
|
402 .sp |
|
403 Commit changes to the given files into the repository. Unlike a |
|
404 centralized SCM, this operation is a local operation. See |
|
405 -\%\fBhg push\fP\: for a way to actively distribute your changes. |
|
406 +\fBhg push\fP for a way to actively distribute your changes. |
|
407 .sp |
|
408 -If a list of files is omitted, all changes reported by \%\fBhg status\fP\: |
|
409 +If a list of files is omitted, all changes reported by \fBhg status\fP |
|
410 will be committed. |
|
411 .sp |
|
412 If you are committing the result of a merge, do not provide any |
|
413 @@ -890,7 +864,7 @@ |
|
414 commit fails, you will find a backup of your message in |
|
415 \fB.hg/last\-message.txt\fP. |
|
416 .sp |
|
417 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date. |
|
418 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date. |
|
419 .sp |
|
420 Returns 0 on success, 1 if nothing changed. |
|
421 .sp |
|
422 @@ -934,9 +908,9 @@ |
|
423 .SS copy |
|
424 .sp |
|
425 .nf |
|
426 -.ft C |
|
427 +.ft |
|
428 hg copy [OPTION]... [SOURCE]... DEST |
|
429 -.ft P |
|
430 +.ft |
|
431 .fi |
|
432 .sp |
|
433 Mark dest as having copies of source files. If dest is a |
|
434 @@ -948,7 +922,7 @@ |
|
435 operation is recorded, but no copying is performed. |
|
436 .sp |
|
437 This command takes effect with the next commit. To undo a copy |
|
438 -before that, see \%\fBhg revert\fP\:. |
|
439 +before that, see \fBhg revert\fP. |
|
440 .sp |
|
441 Returns 0 on success, 1 if errors are encountered. |
|
442 .sp |
|
443 @@ -980,9 +954,9 @@ |
|
444 .SS diff |
|
445 .sp |
|
446 .nf |
|
447 -.ft C |
|
448 +.ft |
|
449 hg diff [OPTION]... ([\-c REV] | [\-r REV1 [\-r REV2]]) [FILE]... |
|
450 -.ft P |
|
451 +.ft |
|
452 .fi |
|
453 .sp |
|
454 Show differences between revisions for the specified files. |
|
455 @@ -991,7 +965,7 @@ |
|
456 .IP Note |
|
457 . |
|
458 diff may generate unexpected results for merges, as it will |
|
459 -default to comparing against the working directory\(aqs first |
|
460 +default to comparing against the working directory's first |
|
461 parent changeset if no revisions are specified. |
11 .RE |
462 .RE |
12 @@ -4331,6 +4336,12 @@ |
463 .sp |
|
464 @@ -1009,7 +983,7 @@ |
|
465 anyway, probably with undesirable results. |
|
466 .sp |
|
467 Use the \-g/\-\-git option to generate diffs in the git extended diff |
|
468 -format. For more information, read \%\fBhg help diffs\fP\:. |
|
469 +format. For more information, read \fBhg help diffs\fP. |
|
470 .sp |
|
471 Returns 0 on success. |
|
472 .sp |
|
473 @@ -1079,9 +1053,9 @@ |
|
474 .SS export |
|
475 .sp |
|
476 .nf |
|
477 -.ft C |
|
478 +.ft |
|
479 hg export [OPTION]... [\-o OUTFILESPEC] REV... |
|
480 -.ft P |
|
481 +.ft |
|
482 .fi |
|
483 .sp |
|
484 Print the changeset header and diffs for one or more revisions. |
|
485 @@ -1138,7 +1112,7 @@ |
|
486 diff anyway, probably with undesirable results. |
|
487 .sp |
|
488 Use the \-g/\-\-git option to generate diffs in the git extended diff |
|
489 -format. See \%\fBhg help diffs\fP\: for more information. |
|
490 +format. See \fBhg help diffs\fP for more information. |
|
491 .sp |
|
492 With the \-\-switch\-parent option, the diff will be against the |
|
493 second parent. It can be useful to review a merge. |
|
494 @@ -1175,9 +1149,9 @@ |
|
495 .SS forget |
|
496 .sp |
|
497 .nf |
|
498 -.ft C |
|
499 +.ft |
|
500 hg forget [OPTION]... FILE... |
|
501 -.ft P |
|
502 +.ft |
|
503 .fi |
|
504 .sp |
|
505 Mark the specified files so they will no longer be tracked |
|
506 @@ -1187,7 +1161,7 @@ |
|
507 entire project history, and it does not delete them from the |
|
508 working directory. |
|
509 .sp |
|
510 -To undo a forget before the next commit, see \%\fBhg add\fP\:. |
|
511 +To undo a forget before the next commit, see \fBhg add\fP. |
|
512 .sp |
|
513 Returns 0 on success. |
|
514 .sp |
|
515 @@ -1205,9 +1179,9 @@ |
|
516 .SS grep |
|
517 .sp |
|
518 .nf |
|
519 -.ft C |
|
520 +.ft |
|
521 hg grep [OPTION]... PATTERN [FILE]... |
|
522 -.ft P |
|
523 +.ft |
|
524 .fi |
|
525 .sp |
|
526 Search revisions of files for a regular expression. |
|
527 @@ -1275,9 +1249,9 @@ |
|
528 .SS heads |
|
529 .sp |
|
530 .nf |
|
531 -.ft C |
|
532 +.ft |
|
533 hg heads [\-ac] [\-r STARTREV] [REV]... |
|
534 -.ft P |
|
535 +.ft |
|
536 .fi |
|
537 .sp |
|
538 With no arguments, show all repository branch heads. |
|
539 @@ -1291,7 +1265,7 @@ |
|
540 associated with the specified changesets are shown. |
|
541 .sp |
|
542 If \-c/\-\-closed is specified, also show branch heads marked closed |
|
543 -(see \%\fBhg commit \-\-close\-branch\fP\:). |
|
544 +(see \fBhg commit \-\-close\-branch\fP). |
|
545 .sp |
|
546 If STARTREV is specified, only those heads that are descendants of |
|
547 STARTREV will be displayed. |
|
548 @@ -1331,9 +1305,9 @@ |
|
549 .SS help |
|
550 .sp |
|
551 .nf |
|
552 -.ft C |
|
553 +.ft |
|
554 hg help [TOPIC] |
|
555 -.ft P |
|
556 +.ft |
|
557 .fi |
|
558 .sp |
|
559 With no arguments, print a list of commands with short help messages. |
|
560 @@ -1345,9 +1319,9 @@ |
|
561 .SS identify |
|
562 .sp |
|
563 .nf |
|
564 -.ft C |
|
565 +.ft |
|
566 hg identify [\-nibtB] [\-r REV] [SOURCE] |
|
567 -.ft P |
|
568 +.ft |
|
569 .fi |
|
570 .sp |
|
571 With no revision, print a summary of the current state of the |
|
572 @@ -1395,9 +1369,9 @@ |
|
573 .SS import |
|
574 .sp |
|
575 .nf |
|
576 -.ft C |
|
577 +.ft |
|
578 hg import [OPTION]... PATCH... |
|
579 -.ft P |
|
580 +.ft |
|
581 .fi |
|
582 .sp |
|
583 Import a list of patches and commit them individually (unless |
|
584 @@ -1413,7 +1387,7 @@ |
|
585 text/plain body parts before first diff are added to commit |
|
586 message. |
|
587 .sp |
|
588 -If the imported patch was generated by \%\fBhg export\fP\:, user and |
|
589 +If the imported patch was generated by \fBhg export\fP, user and |
|
590 description from patch override values from message headers and |
|
591 body. Values given on command line with \-m/\-\-message and \-u/\-\-user |
|
592 override these. |
|
593 @@ -1425,11 +1399,11 @@ |
|
594 deficiencies in the text patch format. |
|
595 .sp |
|
596 With \-s/\-\-similarity, hg will attempt to discover renames and |
|
597 -copies in the patch in the same way as \(aqaddremove\(aq. |
|
598 +copies in the patch in the same way as 'addremove'. |
|
599 .sp |
|
600 To read a patch from standard input, use "\-" as the patch name. If |
|
601 a URL is specified, the patch will be downloaded from it. |
|
602 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date. |
|
603 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date. |
|
604 .sp |
|
605 Returns 0 on success. |
|
606 .sp |
|
607 @@ -1450,7 +1424,7 @@ |
|
608 .TP |
|
609 .B \-\-no\-commit |
|
610 . |
|
611 -don\(aqt commit, just update the working directory |
|
612 +don't commit, just update the working directory |
|
613 .TP |
|
614 .B \-\-exact |
|
615 . |
|
616 @@ -1485,9 +1459,9 @@ |
|
617 .SS incoming |
|
618 .sp |
|
619 .nf |
|
620 -.ft C |
|
621 +.ft |
|
622 hg incoming [\-p] [\-n] [\-M] [\-f] [\-r REV]... [\-\-bundle FILENAME] [SOURCE] |
|
623 -.ft P |
|
624 +.ft |
|
625 .fi |
|
626 .sp |
|
627 Show new changesets found in the specified path/URL or the default |
|
628 @@ -1577,9 +1551,9 @@ |
|
629 .SS init |
|
630 .sp |
|
631 .nf |
|
632 -.ft C |
|
633 +.ft |
|
634 hg init [\-e CMD] [\-\-remotecmd CMD] [DEST] |
|
635 -.ft P |
|
636 +.ft |
|
637 .fi |
|
638 .sp |
|
639 Initialize a new repository in the given directory. If the given |
|
640 @@ -1588,7 +1562,7 @@ |
|
641 If no directory is given, the current directory is used. |
|
642 .sp |
|
643 It is possible to specify an \fBssh://\fP URL as the destination. |
|
644 -See \%\fBhg help urls\fP\: for more information. |
|
645 +See \fBhg help urls\fP for more information. |
|
646 .sp |
|
647 Returns 0 on success. |
|
648 .sp |
|
649 @@ -1610,9 +1584,9 @@ |
|
650 .SS locate |
|
651 .sp |
|
652 .nf |
|
653 -.ft C |
|
654 +.ft |
|
655 hg locate [OPTION]... [PATTERN]... |
|
656 -.ft P |
|
657 +.ft |
|
658 .fi |
|
659 .sp |
|
660 Print files under Mercurial control in the working directory whose |
|
661 @@ -1658,9 +1632,9 @@ |
|
662 .SS log |
|
663 .sp |
|
664 .nf |
|
665 -.ft C |
|
666 +.ft |
|
667 hg log [OPTION]... [FILE] |
|
668 -.ft P |
|
669 +.ft |
|
670 .fi |
|
671 .sp |
|
672 Print the revision history of the specified files or the entire |
|
673 @@ -1675,9 +1649,9 @@ |
|
674 If no revision range is specified, the default is \fBtip:0\fP unless |
|
675 \-\-follow is set, in which case the working directory parent is |
|
676 used as the starting revision. You can specify a revision set for |
|
677 -log, see \%\fBhg help revsets\fP\: for more information. |
|
678 +log, see \fBhg help revsets\fP for more information. |
|
679 .sp |
|
680 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date. |
|
681 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date. |
|
682 .sp |
|
683 By default this command prints revision number and changeset id, |
|
684 tags, non\-trivial parents, user, date and time, and a summary for |
|
685 @@ -1785,9 +1759,9 @@ |
|
686 .SS manifest |
|
687 .sp |
|
688 .nf |
|
689 -.ft C |
|
690 +.ft |
|
691 hg manifest [\-r REV] |
|
692 -.ft P |
|
693 +.ft |
|
694 .fi |
|
695 .sp |
|
696 Print a list of version controlled files for the given revision. |
|
697 @@ -1809,9 +1783,9 @@ |
|
698 .SS merge |
|
699 .sp |
|
700 .nf |
|
701 -.ft C |
|
702 +.ft |
|
703 hg merge [\-P] [\-f] [[\-r] REV] |
|
704 -.ft P |
|
705 +.ft |
|
706 .fi |
|
707 .sp |
|
708 The current working directory is updated with all changes made in |
|
709 @@ -1826,14 +1800,14 @@ |
|
710 merges. It overrides the HGMERGE environment variable and your |
|
711 configuration files. |
|
712 .sp |
|
713 -If no revision is specified, the working directory\(aqs parent is a |
|
714 +If no revision is specified, the working directory's parent is a |
|
715 head revision, and the current branch contains exactly one other |
|
716 head, the other head is merged with by default. Otherwise, an |
|
717 explicit revision with which to merge with must be provided. |
|
718 .sp |
|
719 -\%\fBhg resolve\fP\: must be used to resolve unresolved files. |
|
720 +\fBhg resolve\fP must be used to resolve unresolved files. |
|
721 .sp |
|
722 -To undo an uncommitted merge, use \%\fBhg update \-\-clean .\fP\: which |
|
723 +To undo an uncommitted merge, use \fBhg update \-\-clean .\fP which |
|
724 will check out a clean copy of the original merge parent, losing |
|
725 all changes. |
|
726 .sp |
|
727 @@ -1861,9 +1835,9 @@ |
|
728 .SS outgoing |
|
729 .sp |
|
730 .nf |
|
731 -.ft C |
|
732 +.ft |
|
733 hg outgoing [\-M] [\-p] [\-n] [\-f] [\-r REV]... [DEST] |
|
734 -.ft P |
|
735 +.ft |
|
736 .fi |
|
737 .sp |
|
738 Show changesets not found in the specified destination repository |
|
739 @@ -1946,12 +1920,12 @@ |
|
740 .SS parents |
|
741 .sp |
|
742 .nf |
|
743 -.ft C |
|
744 +.ft |
|
745 hg parents [\-r REV] [FILE] |
|
746 -.ft P |
|
747 +.ft |
|
748 .fi |
|
749 .sp |
|
750 -Print the working directory\(aqs parent revisions. If a revision is |
|
751 +Print the working directory's parent revisions. If a revision is |
|
752 given via \-r/\-\-rev, the parent of that revision will be printed. |
|
753 If a file argument is given, the revision in which the file was |
|
754 last changed (before the working directory revision or the |
|
755 @@ -1977,9 +1951,9 @@ |
|
756 .SS paths |
|
757 .sp |
|
758 .nf |
|
759 -.ft C |
|
760 +.ft |
|
761 hg paths [NAME] |
|
762 -.ft P |
|
763 +.ft |
|
764 .fi |
|
765 .sp |
|
766 Show definition of symbolic path name NAME. If no name is given, |
|
767 @@ -1997,18 +1971,18 @@ |
|
768 as the fallback for both. When cloning a repository, the clone |
|
769 source is written as \fBdefault\fP in \fB.hg/hgrc\fP. Note that |
|
770 \fBdefault\fP and \fBdefault\-push\fP apply to all inbound (e.g. |
|
771 -\%\fBhg incoming\fP\:) and outbound (e.g. \%\fBhg outgoing\fP\:, \%\fBhg email\fP\: and |
|
772 -\%\fBhg bundle\fP\:) operations. |
|
773 +\fBhg incoming\fP) and outbound (e.g. \fBhg outgoing\fP, \fBhg email\fP and |
|
774 +\fBhg bundle\fP) operations. |
|
775 .sp |
|
776 -See \%\fBhg help urls\fP\: for more information. |
|
777 +See \fBhg help urls\fP for more information. |
|
778 .sp |
|
779 Returns 0 on success. |
|
780 .SS pull |
|
781 .sp |
|
782 .nf |
|
783 -.ft C |
|
784 +.ft |
|
785 hg pull [\-u] [\-f] [\-r REV]... [\-e CMD] [\-\-remotecmd CMD] [SOURCE] |
|
786 -.ft P |
|
787 +.ft |
|
788 .fi |
|
789 .sp |
|
790 Pull changes from a remote repository to a local one. |
|
791 @@ -2018,13 +1992,13 @@ |
|
792 \-R is specified). By default, this does not update the copy of the |
|
793 project in the working directory. |
|
794 .sp |
|
795 -Use \%\fBhg incoming\fP\: if you want to see what would have been added |
|
796 +Use \fBhg incoming\fP if you want to see what would have been added |
|
797 by a pull at the time you issued this command. If you then decide |
|
798 -to add those changes to the repository, you should use \%\fBhg pull |
|
799 -\-r X\fP\: where \fBX\fP is the last changeset listed by \%\fBhg incoming\fP\:. |
|
800 +to add those changes to the repository, you should use \fBhg pull |
|
801 +\-r X\fP where \fBX\fP is the last changeset listed by \fBhg incoming\fP. |
|
802 .sp |
|
803 -If SOURCE is omitted, the \(aqdefault\(aq path will be used. |
|
804 -See \%\fBhg help urls\fP\: for more information. |
|
805 +If SOURCE is omitted, the 'default' path will be used. |
|
806 +See \fBhg help urls\fP for more information. |
|
807 .sp |
|
808 Returns 0 on success, 1 if an update had unresolved files. |
|
809 .sp |
|
810 @@ -2066,9 +2040,9 @@ |
|
811 .SS push |
|
812 .sp |
|
813 .nf |
|
814 -.ft C |
|
815 +.ft |
|
816 hg push [\-f] [\-r REV]... [\-e CMD] [\-\-remotecmd CMD] [DEST] |
|
817 -.ft P |
|
818 +.ft |
|
819 .fi |
|
820 .sp |
|
821 Push changesets from the local repository to the specified |
|
822 @@ -2092,7 +2066,7 @@ |
|
823 If \-r/\-\-rev is used, the specified revision and all its ancestors |
|
824 will be pushed to the remote repository. |
|
825 .sp |
|
826 -Please see \%\fBhg help urls\fP\: for important details about \fBssh://\fP |
|
827 +Please see \fBhg help urls\fP for important details about \fBssh://\fP |
|
828 URLs. If DESTINATION is omitted, a default path will be used. |
|
829 .sp |
|
830 Returns 0 if push was successful, 1 if nothing to push. |
|
831 @@ -2135,9 +2109,9 @@ |
|
832 .SS recover |
|
833 .sp |
|
834 .nf |
|
835 -.ft C |
|
836 +.ft |
|
837 hg recover |
|
838 -.ft P |
|
839 +.ft |
|
840 .fi |
|
841 .sp |
|
842 Recover from an interrupted commit or pull. |
|
843 @@ -2150,9 +2124,9 @@ |
|
844 .SS remove |
|
845 .sp |
|
846 .nf |
|
847 -.ft C |
|
848 +.ft |
|
849 hg remove [OPTION]... FILE... |
|
850 -.ft P |
|
851 +.ft |
|
852 .fi |
|
853 .sp |
|
854 Schedule the indicated files for removal from the repository. |
|
855 @@ -2166,21 +2140,21 @@ |
|
856 The following table details the behavior of remove for different |
|
857 file states (columns) and option combinations (rows). The file |
|
858 states are Added [A], Clean [C], Modified [M] and Missing [!] (as |
|
859 -reported by \%\fBhg status\fP\:). The actions are Warn, Remove (from |
|
860 +reported by \fBhg status\fP). The actions are Warn, Remove (from |
|
861 branch) and Delete (from disk): |
|
862 .sp |
|
863 .nf |
|
864 -.ft C |
|
865 +.ft |
|
866 A C M ! |
|
867 none W RD W R |
|
868 \-f R RD RD R |
|
869 \-A W W W R |
|
870 \-Af R R R R |
|
871 -.ft P |
|
872 +.ft |
|
873 .fi |
|
874 .sp |
|
875 This command schedules the files to be removed at the next commit. |
|
876 -To undo a remove before that, see \%\fBhg revert\fP\:. |
|
877 +To undo a remove before that, see \fBhg revert\fP. |
|
878 .sp |
|
879 Returns 0 on success, 1 if any warnings encountered. |
|
880 .sp |
|
881 @@ -2208,9 +2182,9 @@ |
|
882 .SS rename |
|
883 .sp |
|
884 .nf |
|
885 -.ft C |
|
886 +.ft |
|
887 hg rename [OPTION]... SOURCE... DEST |
|
888 -.ft P |
|
889 +.ft |
|
890 .fi |
|
891 .sp |
|
892 Mark dest as copies of sources; mark sources for deletion. If dest |
|
893 @@ -2222,7 +2196,7 @@ |
|
894 operation is recorded, but no copying is performed. |
|
895 .sp |
|
896 This command takes effect at the next commit. To undo a rename |
|
897 -before that, see \%\fBhg revert\fP\:. |
|
898 +before that, see \fBhg revert\fP. |
|
899 .sp |
|
900 Returns 0 on success, 1 if errors are encountered. |
|
901 .sp |
|
902 @@ -2254,9 +2228,9 @@ |
|
903 .SS resolve |
|
904 .sp |
|
905 .nf |
|
906 -.ft C |
|
907 +.ft |
|
908 hg resolve [OPTION]... [FILE]... |
|
909 -.ft P |
|
910 +.ft |
|
911 .fi |
|
912 .sp |
|
913 Merges with unresolved conflicts are often the result of |
|
914 @@ -2263,7 +2237,7 @@ |
|
915 non\-interactive merging using the \fBinternal:merge\fP configuration |
|
916 setting, or a command\-line merge tool like \fBdiff3\fP. The resolve |
|
917 command is used to manage the files involved in a merge, after |
|
918 -\%\fBhg merge\fP\: has been run, and before \%\fBhg commit\fP\: is run (i.e. the |
|
919 +\fBhg merge\fP has been run, and before \fBhg commit\fP is run (i.e. the |
|
920 working directory must have two parents). |
|
921 .sp |
|
922 The resolve command can be used in the following ways: |
|
923 @@ -2270,7 +2244,7 @@ |
|
924 .INDENT 0.0 |
|
925 .IP \(bu 2 |
|
926 . |
|
927 -\%\fBhg resolve [\-\-tool TOOL] FILE...\fP\:: attempt to re\-merge the specified |
|
928 +\fBhg resolve [\-\-tool TOOL] FILE...\fP: attempt to re\-merge the specified |
|
929 files, discarding any previous merge attempts. Re\-merging is not |
|
930 performed for files already marked as resolved. Use \fB\-\-all/\-a\fP |
|
931 to selects all unresolved files. \fB\-\-tool\fP can be used to specify |
|
932 @@ -2278,21 +2252,21 @@ |
|
933 environment variable and your configuration files. |
|
934 .IP \(bu 2 |
|
935 . |
|
936 -\%\fBhg resolve \-m [FILE]\fP\:: mark a file as having been resolved |
|
937 +\fBhg resolve \-m [FILE]\fP: mark a file as having been resolved |
|
938 (e.g. after having manually fixed\-up the files). The default is |
|
939 to mark all unresolved files. |
|
940 .IP \(bu 2 |
|
941 . |
|
942 -\%\fBhg resolve \-u [FILE]...\fP\:: mark a file as unresolved. The |
|
943 +\fBhg resolve \-u [FILE]...\fP: mark a file as unresolved. The |
|
944 default is to mark all resolved files. |
|
945 .IP \(bu 2 |
|
946 . |
|
947 -\%\fBhg resolve \-l\fP\:: list files which had or still have conflicts. |
|
948 +\fBhg resolve \-l\fP: list files which had or still have conflicts. |
|
949 In the printed list, \fBU\fP = unresolved and \fBR\fP = resolved. |
|
950 .UNINDENT |
|
951 .sp |
|
952 Note that Mercurial will not let you commit files with unresolved |
|
953 -merge conflicts. You must use \%\fBhg resolve \-m ...\fP\: before you can |
|
954 +merge conflicts. You must use \fBhg resolve \-m ...\fP before you can |
|
955 commit after a conflicting merge. |
|
956 .sp |
|
957 Returns 0 on success, 1 if any files fail a resolve attempt. |
|
958 @@ -2335,9 +2309,9 @@ |
|
959 .SS revert |
|
960 .sp |
|
961 .nf |
|
962 -.ft C |
|
963 +.ft |
|
964 hg revert [OPTION]... [\-r REV] [NAME]... |
|
965 -.ft P |
|
966 +.ft |
|
967 .fi |
|
968 .IP Note |
|
969 . |
|
970 @@ -2344,8 +2318,8 @@ |
|
971 This command is most likely not what you are looking for. |
|
972 Revert will partially overwrite content in the working |
|
973 directory without changing the working directory parents. Use |
|
974 -\%\fBhg update \-r rev\fP\: to check out earlier revisions, or |
|
975 -\%\fBhg update \-\-clean .\fP\: to undo a merge which has added another |
|
976 +\fBhg update \-r rev\fP to check out earlier revisions, or |
|
977 +\fBhg update \-\-clean .\fP to undo a merge which has added another |
|
978 parent. |
13 .RE |
979 .RE |
14 .sp |
980 .sp |
15 Some commands (e\&.g\&. revert) produce backup files ending in \&.orig, if the \&.orig file already exists and is not tracked by Mercurial, it will be overwritten\&. |
981 @@ -2358,8 +2332,8 @@ |
|
982 .sp |
|
983 Using the \-r/\-\-rev option, revert the given files or directories |
|
984 to their contents as of a specific revision. This can be helpful |
|
985 -to "roll back" some or all of an earlier change. See \%\fBhg help |
|
986 -dates\fP\: for a list of formats valid for \-d/\-\-date. |
|
987 +to "roll back" some or all of an earlier change. See \fBhg help |
|
988 +dates\fP for a list of formats valid for \-d/\-\-date. |
|
989 .sp |
|
990 Revert modifies the working directory. It does not commit any |
|
991 changes, or change the parent of the working directory. If you |
|
992 @@ -2412,9 +2386,9 @@ |
|
993 .SS rollback |
|
994 .sp |
|
995 .nf |
|
996 -.ft C |
|
997 +.ft |
|
998 hg rollback |
|
999 -.ft P |
|
1000 +.ft |
|
1001 .fi |
|
1002 .sp |
|
1003 This command should be used with care. There is only one level of |
|
1004 @@ -2464,9 +2438,9 @@ |
|
1005 .SS root |
|
1006 .sp |
|
1007 .nf |
|
1008 -.ft C |
|
1009 +.ft |
|
1010 hg root |
|
1011 -.ft P |
|
1012 +.ft |
|
1013 .fi |
|
1014 .sp |
|
1015 Print the root directory of the current repository. |
|
1016 @@ -2475,9 +2449,9 @@ |
|
1017 .SS serve |
|
1018 .sp |
|
1019 .nf |
|
1020 -.ft C |
|
1021 +.ft |
|
1022 hg serve [OPTION]... |
|
1023 -.ft P |
|
1024 +.ft |
|
1025 .fi |
|
1026 .sp |
|
1027 Start a local HTTP repository browser and pull server. You can use |
|
1028 @@ -2571,9 +2545,9 @@ |
|
1029 .SS showconfig |
|
1030 .sp |
|
1031 .nf |
|
1032 -.ft C |
|
1033 +.ft |
|
1034 hg showconfig [\-u] [NAME]... |
|
1035 -.ft P |
|
1036 +.ft |
|
1037 .fi |
|
1038 .sp |
|
1039 With no arguments, print names and values of all config items. |
|
1040 @@ -2601,9 +2575,9 @@ |
|
1041 .SS status |
|
1042 .sp |
|
1043 .nf |
|
1044 -.ft C |
|
1045 +.ft |
|
1046 hg status [OPTION]... [FILE]... |
|
1047 -.ft P |
|
1048 +.ft |
|
1049 .fi |
|
1050 .sp |
|
1051 Show status of files in the repository. If names are given, only |
|
1052 @@ -2631,7 +2605,7 @@ |
|
1053 The codes used to show the status of files are: |
|
1054 .sp |
|
1055 .nf |
|
1056 -.ft C |
|
1057 +.ft |
|
1058 M = modified |
|
1059 A = added |
|
1060 R = removed |
|
1061 @@ -2640,7 +2614,7 @@ |
|
1062 ? = not tracked |
|
1063 I = ignored |
|
1064 = origin of the previous file listed as A (added) |
|
1065 -.ft P |
|
1066 +.ft |
|
1067 .fi |
|
1068 .sp |
|
1069 Returns 0 on success. |
|
1070 @@ -2717,9 +2691,9 @@ |
|
1071 .SS summary |
|
1072 .sp |
|
1073 .nf |
|
1074 -.ft C |
|
1075 +.ft |
|
1076 hg summary [\-\-remote] |
|
1077 -.ft P |
|
1078 +.ft |
|
1079 .fi |
|
1080 .sp |
|
1081 This generates a brief summary of the working directory state, |
|
1082 @@ -2742,9 +2716,9 @@ |
|
1083 .SS tag |
|
1084 .sp |
|
1085 .nf |
|
1086 -.ft C |
|
1087 +.ft |
|
1088 hg tag [\-f] [\-l] [\-m TEXT] [\-d DATE] [\-u USER] [\-r REV] NAME... |
|
1089 -.ft P |
|
1090 +.ft |
|
1091 .fi |
|
1092 .sp |
|
1093 Name a particular revision using <name>. |
|
1094 @@ -2765,11 +2739,11 @@ |
|
1095 repositories). |
|
1096 .sp |
|
1097 Tag commits are usually made at the head of a branch. If the parent |
|
1098 -of the working directory is not a branch head, \%\fBhg tag\fP\: aborts; use |
|
1099 +of the working directory is not a branch head, \fBhg tag\fP aborts; use |
|
1100 \-f/\-\-force to force the tag commit to be based on a non\-head |
|
1101 changeset. |
|
1102 .sp |
|
1103 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date. |
|
1104 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date. |
|
1105 .sp |
|
1106 Since tag names have priority over branch names during revision |
|
1107 lookup, using an existing branch name as a tag name is discouraged. |
|
1108 @@ -2814,9 +2788,9 @@ |
|
1109 .SS tags |
|
1110 .sp |
|
1111 .nf |
|
1112 -.ft C |
|
1113 +.ft |
|
1114 hg tags |
|
1115 -.ft P |
|
1116 +.ft |
|
1117 .fi |
|
1118 .sp |
|
1119 This lists both regular and local tags. When the \-v/\-\-verbose |
|
1120 @@ -2826,9 +2800,9 @@ |
|
1121 .SS tip |
|
1122 .sp |
|
1123 .nf |
|
1124 -.ft C |
|
1125 +.ft |
|
1126 hg tip [\-p] [\-g] |
|
1127 -.ft P |
|
1128 +.ft |
|
1129 .fi |
|
1130 .sp |
|
1131 The tip revision (usually just called the tip) is the changeset |
|
1132 @@ -2864,9 +2838,9 @@ |
|
1133 .SS unbundle |
|
1134 .sp |
|
1135 .nf |
|
1136 -.ft C |
|
1137 +.ft |
|
1138 hg unbundle [\-u] FILE... |
|
1139 -.ft P |
|
1140 +.ft |
|
1141 .fi |
|
1142 .sp |
|
1143 Apply one or more compressed changegroup files generated by the |
|
1144 @@ -2884,16 +2858,16 @@ |
|
1145 .SS update |
|
1146 .sp |
|
1147 .nf |
|
1148 -.ft C |
|
1149 +.ft |
|
1150 hg update [\-c] [\-C] [\-d DATE] [[\-r] REV] |
|
1151 -.ft P |
|
1152 +.ft |
|
1153 .fi |
|
1154 .sp |
|
1155 -Update the repository\(aqs working directory to the specified |
|
1156 +Update the repository's working directory to the specified |
|
1157 changeset. If no changeset is specified, update to the tip of the |
|
1158 current named branch. |
|
1159 .sp |
|
1160 -If the changeset is not a descendant of the working directory\(aqs |
|
1161 +If the changeset is not a descendant of the working directory's |
|
1162 parent, the update is aborted. With the \-c/\-\-check option, the |
|
1163 working directory is checked for uncommitted changes; if none are |
|
1164 found, the working directory is updated to the specified |
|
1165 @@ -2906,7 +2880,7 @@ |
|
1166 . |
|
1167 If neither \-c/\-\-check nor \-C/\-\-clean is specified, and if |
|
1168 the requested changeset is an ancestor or descendant of |
|
1169 -the working directory\(aqs parent, the uncommitted changes |
|
1170 +the working directory's parent, the uncommitted changes |
|
1171 are merged into the requested changeset and the merged |
|
1172 result is left uncommitted. If the requested changeset is |
|
1173 not an ancestor or descendant (that is, it is on another |
|
1174 @@ -2923,12 +2897,12 @@ |
|
1175 .UNINDENT |
|
1176 .sp |
|
1177 Use null as the changeset to remove the working directory (like |
|
1178 -\%\fBhg clone \-U\fP\:). |
|
1179 +\fBhg clone \-U\fP). |
|
1180 .sp |
|
1181 If you want to update just one file to an older changeset, use |
|
1182 -\%\fBhg revert\fP\:. |
|
1183 +\fBhg revert\fP. |
|
1184 .sp |
|
1185 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date. |
|
1186 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date. |
|
1187 .sp |
|
1188 Returns 0 on success, 1 if there are unresolved files. |
|
1189 .sp |
|
1190 @@ -2956,14 +2930,14 @@ |
|
1191 .SS verify |
|
1192 .sp |
|
1193 .nf |
|
1194 -.ft C |
|
1195 +.ft |
|
1196 hg verify |
|
1197 -.ft P |
|
1198 +.ft |
|
1199 .fi |
|
1200 .sp |
|
1201 Verify the integrity of the current repository. |
|
1202 .sp |
|
1203 -This will perform an extensive check of the repository\(aqs |
|
1204 +This will perform an extensive check of the repository's |
|
1205 integrity, validating the hashes and checksums of each entry in |
|
1206 the changelog, manifest, and tracked files, as well as the |
|
1207 integrity of their crosslinks and indices. |
|
1208 @@ -2972,9 +2946,9 @@ |
|
1209 .SS version |
|
1210 .sp |
|
1211 .nf |
|
1212 -.ft C |
|
1213 +.ft |
|
1214 hg version |
|
1215 -.ft P |
|
1216 +.ft |
|
1217 .fi |
|
1218 .sp |
|
1219 output version and copyright information |
|
1220 @@ -3040,9 +3014,9 @@ |
|
1221 the active user, Mercurial will warn you that the file is skipped: |
|
1222 .sp |
|
1223 .nf |
|
1224 -.ft C |
|
1225 +.ft |
|
1226 not trusting file <repo>/.hg/hgrc from untrusted user USER, group GROUP |
|
1227 -.ft P |
|
1228 +.ft |
|
1229 .fi |
|
1230 .sp |
|
1231 If this bothers you, the warning can be silenced (the file would still |
|
1232 @@ -3065,11 +3039,11 @@ |
|
1233 and followed by \fBname = value\fP entries: |
|
1234 .sp |
|
1235 .nf |
|
1236 -.ft C |
|
1237 +.ft |
|
1238 [ui] |
|
1239 username = Firstname Lastname <[email protected]> |
|
1240 verbose = True |
|
1241 -.ft P |
|
1242 +.ft |
|
1243 .fi |
|
1244 .sp |
|
1245 The above entries will be referred to as \fBui.username\fP and |
|
1246 @@ -3081,7 +3055,7 @@ |
|
1247 on Unix\-like systems: \fBman hgrc\fP |
|
1248 .IP \(bu 2 |
|
1249 . |
|
1250 -online: \%http://www.selenic.com/mercurial/hgrc.5.html\: |
|
1251 +online: http://www.selenic.com/mercurial/hgrc.5.html |
|
1252 .UNINDENT |
|
1253 .SH DATE FORMATS |
|
1254 .sp |
|
1255 @@ -3138,7 +3112,7 @@ |
|
1256 \fB12/6/6\fP (Dec 6 2006) |
|
1257 .UNINDENT |
|
1258 .sp |
|
1259 -Lastly, there is Mercurial\(aqs internal format: |
|
1260 +Lastly, there is Mercurial's internal format: |
|
1261 .INDENT 0.0 |
|
1262 .IP \(bu 2 |
|
1263 . |
|
1264 @@ -3197,17 +3171,17 @@ |
|
1265 Plain examples: |
|
1266 .sp |
|
1267 .nf |
|
1268 -.ft C |
|
1269 +.ft |
|
1270 path:foo/bar a name bar in a directory named foo in the root |
|
1271 of the repository |
|
1272 path:path:name a file or directory named "path:name" |
|
1273 -.ft P |
|
1274 +.ft |
|
1275 .fi |
|
1276 .sp |
|
1277 Glob examples: |
|
1278 .sp |
|
1279 .nf |
|
1280 -.ft C |
|
1281 +.ft |
|
1282 glob:*.c any name ending in ".c" in the current directory |
|
1283 *.c any name ending in ".c" in the current directory |
|
1284 **.c any name ending in ".c" in any subdirectory of the |
|
1285 @@ -3215,24 +3189,24 @@ |
|
1286 foo/*.c any name ending in ".c" in the directory foo |
|
1287 foo/**.c any name ending in ".c" in any subdirectory of foo |
|
1288 including itself. |
|
1289 -.ft P |
|
1290 +.ft |
|
1291 .fi |
|
1292 .sp |
|
1293 Regexp examples: |
|
1294 .sp |
|
1295 .nf |
|
1296 -.ft C |
|
1297 +.ft |
|
1298 re:.*\e.c$ any name ending in ".c", anywhere in the repository |
|
1299 -.ft P |
|
1300 +.ft |
|
1301 .fi |
|
1302 .sp |
|
1303 File examples: |
|
1304 .sp |
|
1305 .nf |
|
1306 -.ft C |
|
1307 +.ft |
|
1308 listfile:list.txt read list from list.txt with one file pattern per line |
|
1309 listfile0:list.txt read list from list.txt with null byte delimiters |
|
1310 -.ft P |
|
1311 +.ft |
|
1312 .fi |
|
1313 .SH ENVIRONMENT VARIABLES |
|
1314 .INDENT 0.0 |
|
1315 @@ -3239,10 +3213,10 @@ |
|
1316 .TP |
|
1317 .B HG |
|
1318 . |
|
1319 -Path to the \(aqhg\(aq executable, automatically passed when running |
|
1320 +Path to the 'hg' executable, automatically passed when running |
|
1321 hooks, extensions or external tools. If unset or empty, this is |
|
1322 -the hg executable\(aqs name if it\(aqs frozen, or an executable named |
|
1323 -\(aqhg\(aq (with %PATHEXT% [defaulting to COM/EXE/BAT/CMD] extensions on |
|
1324 +the hg executable's name if it's frozen, or an executable named |
|
1325 +\'hg' (with %PATHEXT% [defaulting to COM/EXE/BAT/CMD] extensions on |
|
1326 Windows) is searched. |
|
1327 .TP |
|
1328 .B HGEDITOR |
|
1329 @@ -3260,9 +3234,9 @@ |
|
1330 .TP |
|
1331 .B HGENCODINGMODE |
|
1332 . |
|
1333 -This sets Mercurial\(aqs behavior for handling unknown characters |
|
1334 +This sets Mercurial's behavior for handling unknown characters |
|
1335 while transcoding user input. The default is "strict", which |
|
1336 -causes Mercurial to abort if it can\(aqt map a character. Other |
|
1337 +causes Mercurial to abort if it can't map a character. Other |
|
1338 settings include "replace", which replaces unknown characters, and |
|
1339 "ignore", which drops them. This setting can be overridden with |
|
1340 the \-\-encodingmode command\-line option. |
|
1341 @@ -3269,7 +3243,7 @@ |
|
1342 .TP |
|
1343 .B HGENCODINGAMBIGUOUS |
|
1344 . |
|
1345 -This sets Mercurial\(aqs behavior for handling characters with |
|
1346 +This sets Mercurial's behavior for handling characters with |
|
1347 "ambiguous" widths like accented Latin characters with East Asian |
|
1348 fonts. By default, Mercurial assumes ambiguous characters are |
|
1349 narrow, set this variable to "wide" if such characters cause |
|
1350 @@ -3294,7 +3268,7 @@ |
|
1351 .INDENT 7.0 |
|
1352 .IP \(bu 2 |
|
1353 . |
|
1354 -if it\(aqs a directory, all files ending with .rc are added |
|
1355 +if it's a directory, all files ending with .rc are added |
|
1356 .IP \(bu 2 |
|
1357 . |
|
1358 otherwise, the file itself will be added |
|
1359 @@ -3303,7 +3277,7 @@ |
|
1360 .B HGPLAIN |
|
1361 . |
|
1362 When set, this disables any configuration settings that might |
|
1363 -change Mercurial\(aqs default output. This includes encoding, |
|
1364 +change Mercurial's default output. This includes encoding, |
|
1365 defaults, verbose mode, debug mode, quiet mode, tracebacks, and |
|
1366 localization. This can be useful when scripting against Mercurial |
|
1367 in the face of existing user configuration. |
|
1368 @@ -3354,7 +3328,7 @@ |
|
1369 editor it uses is determined by looking at the environment |
|
1370 variables HGEDITOR, VISUAL and EDITOR, in that order. The first |
|
1371 non\-empty one is chosen. If all of them are empty, the editor |
|
1372 -defaults to \(aqvi\(aq. |
|
1373 +defaults to 'vi'. |
|
1374 .TP |
|
1375 .B PYTHONPATH |
|
1376 . |
|
1377 @@ -3422,7 +3396,7 @@ |
|
1378 .sp |
|
1379 Special characters can be used in quoted identifiers by escaping them, |
|
1380 e.g., \fB\en\fP is interpreted as a newline. To prevent them from being |
|
1381 -interpreted, strings can be prefixed with \fBr\fP, e.g. \fBr\(aq...\(aq\fP. |
|
1382 +interpreted, strings can be prefixed with \fBr\fP, e.g. \fBr'...'\fP. |
|
1383 .sp |
|
1384 There is a single prefix operator: |
|
1385 .INDENT 0.0 |
|
1386 @@ -3468,10 +3442,10 @@ |
|
1387 .\" predicatesmarker |
|
1388 . |
|
1389 .sp |
|
1390 -Command line equivalents for \%\fBhg log\fP\:: |
|
1391 +Command line equivalents for \fBhg log\fP: |
|
1392 .sp |
|
1393 .nf |
|
1394 -.ft C |
|
1395 +.ft |
|
1396 \-f \-> ::. |
|
1397 \-d x \-> date(x) |
|
1398 \-k x \-> keyword(x) |
|
1399 @@ -3480,7 +3454,7 @@ |
|
1400 \-b x \-> branch(x) |
|
1401 \-P x \-> !::x |
|
1402 \-l x \-> limit(expr, x) |
|
1403 -.ft P |
|
1404 +.ft |
|
1405 .fi |
|
1406 .sp |
|
1407 Some sample queries: |
|
1408 @@ -3490,9 +3464,9 @@ |
|
1409 Changesets on the default branch: |
|
1410 .sp |
|
1411 .nf |
|
1412 -.ft C |
|
1413 +.ft |
|
1414 hg log \-r "branch(default)" |
|
1415 -.ft P |
|
1416 +.ft |
|
1417 .fi |
|
1418 .IP \(bu 2 |
|
1419 . |
|
1420 @@ -3499,9 +3473,9 @@ |
|
1421 Changesets on the default branch since tag 1.5 (excluding merges): |
|
1422 .sp |
|
1423 .nf |
|
1424 -.ft C |
|
1425 +.ft |
|
1426 hg log \-r "branch(default) and 1.5:: and not merge()" |
|
1427 -.ft P |
|
1428 +.ft |
|
1429 .fi |
|
1430 .IP \(bu 2 |
|
1431 . |
|
1432 @@ -3508,9 +3482,9 @@ |
|
1433 Open branch heads: |
|
1434 .sp |
|
1435 .nf |
|
1436 -.ft C |
|
1437 +.ft |
|
1438 hg log \-r "head() and not closed()" |
|
1439 -.ft P |
|
1440 +.ft |
|
1441 .fi |
|
1442 .IP \(bu 2 |
|
1443 . |
|
1444 @@ -3518,9 +3492,9 @@ |
|
1445 \fBhgext/*\fP: |
|
1446 .sp |
|
1447 .nf |
|
1448 -.ft C |
|
1449 -hg log \-r "1.3::1.5 and keyword(bug) and file(\(aqhgext/*\(aq)" |
|
1450 -.ft P |
|
1451 +.ft |
|
1452 +hg log \-r "1.3::1.5 and keyword(bug) and file('hgext/*')" |
|
1453 +.ft |
|
1454 .fi |
|
1455 .IP \(bu 2 |
|
1456 . |
|
1457 @@ -3527,9 +3501,9 @@ |
|
1458 Changesets in committed May 2008, sorted by user: |
|
1459 .sp |
|
1460 .nf |
|
1461 -.ft C |
|
1462 -hg log \-r "sort(date(\(aqMay 2008\(aq), user)" |
|
1463 -.ft P |
|
1464 +.ft |
|
1465 +hg log \-r "sort(date('May 2008'), user)" |
|
1466 +.ft |
|
1467 .fi |
|
1468 .IP \(bu 2 |
|
1469 . |
|
1470 @@ -3537,14 +3511,14 @@ |
|
1471 release: |
|
1472 .sp |
|
1473 .nf |
|
1474 -.ft C |
|
1475 +.ft |
|
1476 hg log \-r "(keyword(bug) or keyword(issue)) and not ancestors(tagged())" |
|
1477 -.ft P |
|
1478 +.ft |
|
1479 .fi |
|
1480 .UNINDENT |
|
1481 .SH DIFF FORMATS |
|
1482 .sp |
|
1483 -Mercurial\(aqs default format for showing changes between two versions of |
|
1484 +Mercurial's default format for showing changes between two versions of |
|
1485 a file is compatible with the unified format of GNU diff, which can be |
|
1486 used by GNU patch and many other standard tools. |
|
1487 .sp |
|
1488 @@ -3571,15 +3545,15 @@ |
|
1489 format. |
|
1490 .sp |
|
1491 This means that when generating diffs from a Mercurial repository |
|
1492 -(e.g. with \%\fBhg export\fP\:), you should be careful about things like file |
|
1493 +(e.g. with \fBhg export\fP), you should be careful about things like file |
|
1494 copies and renames or other things mentioned above, because when |
|
1495 applying a standard diff to a different repository, this extra |
|
1496 -information is lost. Mercurial\(aqs internal operations (like push and |
|
1497 +information is lost. Mercurial's internal operations (like push and |
|
1498 pull) are not affected by this, because they use an internal binary |
|
1499 format for communicating changes. |
|
1500 .sp |
|
1501 To make Mercurial produce the git extended diff format, use the \-\-git |
|
1502 -option available for many commands, or set \(aqgit = True\(aq in the [diff] |
|
1503 +option available for many commands, or set 'git = True' in the [diff] |
|
1504 section of your configuration file. You do not need to set this option |
|
1505 when importing diffs in this format or using them in the mq extension. |
|
1506 .SH MERGE TOOLS |
|
1507 @@ -3591,8 +3565,8 @@ |
|
1508 ancestor of the two file versions, so they can determine the changes |
|
1509 made on both branches. |
|
1510 .sp |
|
1511 -Merge tools are used both for \%\fBhg resolve\fP\:, \%\fBhg merge\fP\:, \%\fBhg update\fP\:, |
|
1512 -\%\fBhg backout\fP\: and in several extensions. |
|
1513 +Merge tools are used both for \fBhg resolve\fP, \fBhg merge\fP, \fBhg update\fP, |
|
1514 +\fBhg backout\fP and in several extensions. |
|
1515 .sp |
|
1516 Usually, the merge tool tries to automatically reconcile the files by |
|
1517 combining all non\-overlapping changes that occurred separately in |
|
1518 @@ -3700,7 +3674,7 @@ |
|
1519 .IP Note |
|
1520 . |
|
1521 After selecting a merge program, Mercurial will by default attempt |
|
1522 -to merge the files using a simple merge algorithm first. Only if it doesn\(aqt |
|
1523 +to merge the files using a simple merge algorithm first. Only if it doesn't |
|
1524 succeed because of conflicting changes Mercurial will actually execute the |
|
1525 merge program. Whether to use the simple merge algorithm first can be |
|
1526 controlled by the premerge setting of the merge tool. Premerge is enabled by |
|
1527 @@ -3725,9 +3699,9 @@ |
|
1528 Usage: |
|
1529 .sp |
|
1530 .nf |
|
1531 -.ft C |
|
1532 +.ft |
|
1533 $ hg log \-r1 \-\-style changelog |
|
1534 -.ft P |
|
1535 +.ft |
|
1536 .fi |
|
1537 .sp |
|
1538 A template is a piece of text, with markup to invoke variable |
|
1539 @@ -3734,10 +3708,10 @@ |
|
1540 expansion: |
|
1541 .sp |
|
1542 .nf |
|
1543 -.ft C |
|
1544 +.ft |
|
1545 $ hg log \-r1 \-\-template "{node}\en" |
|
1546 b56ce7b07c52de7d5fd79fb89701ea538af65746 |
|
1547 -.ft P |
|
1548 +.ft |
|
1549 .fi |
|
1550 .sp |
|
1551 Strings in curly braces are called keywords. The availability of |
|
1552 @@ -3834,15 +3808,15 @@ |
|
1553 The "date" keyword does not produce human\-readable output. If you |
|
1554 want to use a date in your output, you can use a filter to process |
|
1555 it. Filters are functions which return a string based on the input |
|
1556 -variable. Be sure to use the stringify filter first when you\(aqre |
|
1557 +variable. Be sure to use the stringify filter first when you're |
|
1558 applying a string\-input filter to a list\-like input variable. |
|
1559 You can also use a chain of filters to get the desired output: |
|
1560 .sp |
|
1561 .nf |
|
1562 -.ft C |
|
1563 +.ft |
|
1564 $ hg tip \-\-template "{date|isodate}\en" |
|
1565 2008\-08\-21 18:22 +0000 |
|
1566 -.ft P |
|
1567 +.ft |
|
1568 .fi |
|
1569 .sp |
|
1570 List of filters: |
|
1571 @@ -3911,7 +3885,7 @@ |
|
1572 .TP |
|
1573 .B nonempty |
|
1574 . |
|
1575 -Any text. Returns \(aq(none)\(aq if the string is empty. |
|
1576 +Any text. Returns '(none)' if the string is empty. |
|
1577 .TP |
|
1578 .B hgdate |
|
1579 . |
|
1580 @@ -3989,24 +3963,24 @@ |
|
1581 Valid URLs are of the form: |
|
1582 .sp |
|
1583 .nf |
|
1584 -.ft C |
|
1585 +.ft |
|
1586 local/filesystem/path[#revision] |
|
1587 file://local/filesystem/path[#revision] |
|
1588 http://[user[:pass]@]host[:port]/[path][#revision] |
|
1589 https://[user[:pass]@]host[:port]/[path][#revision] |
|
1590 ssh://[user@]host[:port]/[path][#revision] |
|
1591 -.ft P |
|
1592 +.ft |
|
1593 .fi |
|
1594 .sp |
|
1595 Paths in the local filesystem can either point to Mercurial |
|
1596 -repositories or to bundle files (as created by \%\fBhg bundle\fP\: or :hg:\(ga |
|
1597 -incoming \-\-bundle\(ga). See also \%\fBhg help paths\fP\:. |
|
1598 +repositories or to bundle files (as created by \fBhg bundle\fP or :hg:\(ga |
|
1599 +incoming \-\-bundle\(ga). See also \fBhg help paths\fP. |
|
1600 .sp |
|
1601 An optional identifier after # indicates a particular branch, tag, or |
|
1602 -changeset to use from the remote repository. See also \%\fBhg help |
|
1603 -revisions\fP\:. |
|
1604 +changeset to use from the remote repository. See also \fBhg help |
|
1605 +revisions\fP. |
|
1606 .sp |
|
1607 -Some features, such as pushing to \%http://\: and \%https://\: URLs are only |
|
1608 +Some features, such as pushing to http:// and https:// URLs are only |
|
1609 possible if the feature is explicitly enabled on the remote Mercurial |
|
1610 server. |
|
1611 .sp |
|
1612 @@ -4021,26 +3995,26 @@ |
|
1613 and a copy of hg in the remote path or specified with as remotecmd. |
|
1614 .IP \(bu 2 |
|
1615 . |
|
1616 -path is relative to the remote user\(aqs home directory by default. Use |
|
1617 +path is relative to the remote user's home directory by default. Use |
|
1618 an extra slash at the start of a path to specify an absolute path: |
|
1619 .sp |
|
1620 .nf |
|
1621 -.ft C |
|
1622 +.ft |
|
1623 ssh://example.com//tmp/repository |
|
1624 -.ft P |
|
1625 +.ft |
|
1626 .fi |
|
1627 .IP \(bu 2 |
|
1628 . |
|
1629 -Mercurial doesn\(aqt use its own compression via SSH; the right thing |
|
1630 +Mercurial doesn't use its own compression via SSH; the right thing |
|
1631 to do is to configure it in your ~/.ssh/config, e.g.: |
|
1632 .sp |
|
1633 .nf |
|
1634 -.ft C |
|
1635 +.ft |
|
1636 Host *.mylocalnetwork.example.com |
|
1637 Compression no |
|
1638 Host * |
|
1639 Compression yes |
|
1640 -.ft P |
|
1641 +.ft |
|
1642 .fi |
|
1643 .sp |
|
1644 Alternatively specify "ssh \-C" as your ssh command in your |
|
1645 @@ -4051,16 +4025,16 @@ |
|
1646 aliases under the [paths] section like so: |
|
1647 .sp |
|
1648 .nf |
|
1649 -.ft C |
|
1650 +.ft |
|
1651 [paths] |
|
1652 alias1 = URL1 |
|
1653 alias2 = URL2 |
|
1654 \&... |
|
1655 -.ft P |
|
1656 +.ft |
|
1657 .fi |
|
1658 .sp |
|
1659 You can then use the alias for any command that uses a URL (for |
|
1660 -example \%\fBhg pull alias1\fP\: will be treated as \%\fBhg pull URL1\fP\:). |
|
1661 +example \fBhg pull alias1\fP will be treated as \fBhg pull URL1\fP). |
|
1662 .sp |
|
1663 Two path aliases are special because they are used as defaults when |
|
1664 you do not provide the URL to a command: |
|
1665 @@ -4069,14 +4043,14 @@ |
|
1666 .B default: |
|
1667 . |
|
1668 When you create a repository with hg clone, the clone command saves |
|
1669 -the location of the source repository as the new repository\(aqs |
|
1670 -\(aqdefault\(aq path. This is then used when you omit path from push\- and |
|
1671 +the location of the source repository as the new repository's |
|
1672 +\'default' path. This is then used when you omit path from push\- and |
|
1673 pull\-like commands (including incoming and outgoing). |
|
1674 .TP |
|
1675 .B default\-push: |
|
1676 . |
|
1677 -The push command will look for a path named \(aqdefault\-push\(aq, and |
|
1678 -prefer it over \(aqdefault\(aq if both are defined. |
|
1679 +The push command will look for a path named 'default\-push', and |
|
1680 +prefer it over 'default' if both are defined. |
|
1681 .UNINDENT |
|
1682 .SH USING ADDITIONAL FEATURES |
|
1683 .sp |
|
1684 @@ -4098,19 +4072,19 @@ |
|
1685 like this: |
|
1686 .sp |
|
1687 .nf |
|
1688 -.ft C |
|
1689 +.ft |
|
1690 [extensions] |
|
1691 foo = |
|
1692 -.ft P |
|
1693 +.ft |
|
1694 .fi |
|
1695 .sp |
|
1696 You may also specify the full path to an extension: |
|
1697 .sp |
|
1698 .nf |
|
1699 -.ft C |
|
1700 +.ft |
|
1701 [extensions] |
|
1702 myfeature = ~/.hgext/myfeature.py |
|
1703 -.ft P |
|
1704 +.ft |
|
1705 .fi |
|
1706 .sp |
|
1707 To explicitly disable an extension enabled in a configuration file of |
|
1708 @@ -4117,13 +4091,13 @@ |
|
1709 broader scope, prepend its path with !: |
|
1710 .sp |
|
1711 .nf |
|
1712 -.ft C |
|
1713 +.ft |
|
1714 [extensions] |
|
1715 # disabling extension bar residing in /path/to/extension/bar.py |
|
1716 bar = !/path/to/extension/bar.py |
|
1717 # ditto, but no path was supplied for extension baz |
|
1718 baz = ! |
|
1719 -.ft P |
|
1720 +.ft |
|
1721 .fi |
|
1722 .sp |
|
1723 disabled extensions: |
|
1724 @@ -4189,7 +4163,7 @@ |
|
1725 .TP |
|
1726 .B inotify |
|
1727 . |
|
1728 -accelerate status report using Linux\(aqs inotify service |
|
1729 +accelerate status report using Linux's inotify service |
|
1730 .TP |
|
1731 .B interhg |
|
1732 . |
|
1733 @@ -4287,7 +4261,7 @@ |
|
1734 .INDENT 3.0 |
|
1735 .INDENT 3.5 |
|
1736 .sp |
|
1737 -path/to/nested = \%https://example.com/nested/repo/path\: |
|
1738 +path/to/nested = https://example.com/nested/repo/path |
|
1739 .UNINDENT |
|
1740 .UNINDENT |
|
1741 .sp |
|
1742 @@ -4362,7 +4336,7 @@ |
|
1743 their state and finally committing it in the parent |
|
1744 repository. Mercurial can be made to abort if any subrepository |
|
1745 content is modified by setting "ui.commitsubrepos=no" in a |
|
1746 -configuration file (see \%\fBhg help config\fP\:). |
|
1747 +configuration file (see \fBhg help config\fP). |
|
1748 .TP |
|
1749 .B diff |
|
1750 . |
|
1751 @@ -4386,7 +4360,7 @@ |
|
1752 .B pull |
|
1753 . |
|
1754 pull is not recursive since it is not clear what to pull prior |
|
1755 -to running \%\fBhg update\fP\:. Listing and retrieving all |
|
1756 +to running \fBhg update\fP. Listing and retrieving all |
|
1757 subrepositories changes referenced by the parent repository pulled |
|
1758 changesets is expensive at best, impossible in the Subversion |
|
1759 case. |
|
1760 @@ -4423,7 +4397,7 @@ |
|
1761 hgrc(5) for more details. |
|
1762 .SH CONFIGURING HGWEB |
|
1763 .sp |
|
1764 -Mercurial\(aqs internal web server, hgweb, can serve either a single |
|
1765 +Mercurial's internal web server, hgweb, can serve either a single |
|
1766 repository, or a collection of them. In the latter case, a special |
|
1767 configuration file can be used to specify the repository paths to use |
|
1768 and global web configuration options. |
|
1769 @@ -4447,7 +4421,7 @@ |
|
1770 .UNINDENT |
|
1771 .sp |
|
1772 The \fBweb\fP section can specify all the settings described in the web |
|
1773 -section of the hgrc(5) documentation. See \%\fBhg help config\fP\: for |
|
1774 +section of the hgrc(5) documentation. See \fBhg help config\fP\: for |
|
1775 information on where to find the manual page. |
|
1776 .sp |
|
1777 The \fBpaths\fP section provides mappings of physical repository |
|
1778 @@ -4454,7 +4428,7 @@ |
|
1779 paths to virtual ones. For instance: |
|
1780 .sp |
|
1781 .nf |
|
1782 -.ft C |
|
1783 +.ft |
|
1784 [paths] |
|
1785 projects/a = /foo/bar |
|
1786 projects/b = /baz/quux |
|
1787 @@ -4461,7 +4435,7 @@ |
|
1788 web/root = /real/root/* |
|
1789 / = /real/root2/* |
|
1790 virtual/root2 = /real/root2/** |
|
1791 -.ft P |
|
1792 +.ft |
|
1793 .fi |
|
1794 .INDENT 0.0 |
|
1795 .IP \(bu 2 |
|
1796 @@ -4470,14 +4444,14 @@ |
|
1797 appear under the same directory in the web interface |
|
1798 .IP \(bu 2 |
|
1799 . |
|
1800 -The third entry maps every Mercurial repository found in \(aq/real/root\(aq |
|
1801 -into \(aqweb/root\(aq. This format is preferred over the [collections] one, |
|
1802 +The third entry maps every Mercurial repository found in '/real/root' |
|
1803 +into 'web/root'. This format is preferred over the [collections] one, |
|
1804 since using absolute paths as configuration keys is not supported on every |
|
1805 platform (especially on Windows). |
|
1806 .IP \(bu 2 |
|
1807 . |
|
1808 The fourth entry is a special case mapping all repositories in |
|
1809 -\(aq/real/root2\(aq in the root of the virtual directory. |
|
1810 +\'/real/root2' in the root of the virtual directory. |
|
1811 .IP \(bu 2 |
|
1812 . |
|
1813 The fifth entry recursively finds all repositories under the real |
|
1814 @@ -4489,10 +4463,10 @@ |
|
1815 preferred. For instance: |
|
1816 .sp |
|
1817 .nf |
|
1818 -.ft C |
|
1819 +.ft |
|
1820 [collections] |
|
1821 /foo = /foo |
|
1822 -.ft P |
|
1823 +.ft |
|
1824 .fi |
|
1825 .sp |
|
1826 Here, the left side will be stripped off all repositories found in the |
|
1827 @@ -4507,15 +4481,15 @@ |
|
1828 changesets from a given changeset. More precisely, the ancestors |
|
1829 of a changeset can be defined by two properties: a parent of a |
|
1830 changeset is an ancestor, and a parent of an ancestor is an |
|
1831 -ancestor. See also: \(aqDescendant\(aq. |
|
1832 +ancestor. See also: 'Descendant'. |
|
1833 .TP |
|
1834 .B Branch |
|
1835 . |
|
1836 (Noun) A child changeset that has been created from a parent that |
|
1837 is not a head. These are known as topological branches, see |
|
1838 -\(aqBranch, topological\(aq. If a topological branch is named, it becomes |
|
1839 +\'Branch, topological'. If a topological branch is named, it becomes |
|
1840 a named branch. If a topological branch is not named, it becomes |
|
1841 -an anonymous branch. See \(aqBranch, anonymous\(aq and \(aqBranch, named\(aq. |
|
1842 +an anonymous branch. See 'Branch, anonymous' and 'Branch, named'. |
|
1843 .sp |
|
1844 Branches may be created when changes are pulled from or pushed to |
|
1845 a remote repository, since new heads may be created by these |
|
1846 @@ -4530,7 +4504,7 @@ |
|
1847 (Verb) The action of creating a child changeset which results in |
|
1848 its parent having more than one child. |
|
1849 .sp |
|
1850 -Example: "I\(aqm going to branch at X". |
|
1851 +Example: "I'm going to branch at X". |
|
1852 .TP |
|
1853 .B Branch, anonymous |
|
1854 . |
|
1855 @@ -4549,19 +4523,19 @@ |
|
1856 .TP |
|
1857 .B Branch head |
|
1858 . |
|
1859 -See \(aqHead, branch\(aq. |
|
1860 +See 'Head, branch'. |
|
1861 .TP |
|
1862 .B Branch, inactive |
|
1863 . |
|
1864 If a named branch has no topological heads, it is considered to be |
|
1865 inactive. As an example, a feature branch becomes inactive when it |
|
1866 -is merged into the default branch. The \%\fBhg branches\fP\: command |
|
1867 +is merged into the default branch. The \fBhg branches\fP command |
|
1868 shows inactive branches by default, though they can be hidden with |
|
1869 -\%\fBhg branches \-\-active\fP\:. |
|
1870 +\fBhg branches \-\-active\fP. |
|
1871 .sp |
|
1872 NOTE: this concept is deprecated because it is too implicit. |
|
1873 -Branches should now be explicitly closed using \%\fBhg commit |
|
1874 -\-\-close\-branch\fP\: when they are no longer needed. |
|
1875 +Branches should now be explicitly closed using \fBhg commit |
|
1876 +\-\-close\-branch\fP when they are no longer needed. |
|
1877 .TP |
|
1878 .B Branch, named |
|
1879 . |
|
1880 @@ -4568,8 +4542,8 @@ |
|
1881 A collection of changesets which have the same branch name. By |
|
1882 default, children of a changeset in a named branch belong to the |
|
1883 same named branch. A child can be explicitly assigned to a |
|
1884 -different branch. See \%\fBhg help branch\fP\:, \%\fBhg help branches\fP\: and |
|
1885 -\%\fBhg commit \-\-close\-branch\fP\: for more information on managing |
|
1886 +different branch. See \fBhg help branch\fP, \fBhg help branches\fP and |
|
1887 +\fBhg commit \-\-close\-branch\fP for more information on managing |
|
1888 branches. |
|
1889 .sp |
|
1890 Named branches can be thought of as a kind of namespace, dividing |
|
1891 @@ -4582,7 +4556,7 @@ |
|
1892 .TP |
|
1893 .B Branch tip |
|
1894 . |
|
1895 -See \(aqTip, branch\(aq. |
|
1896 +See 'Tip, branch'. |
|
1897 .TP |
|
1898 .B Branch, topological |
|
1899 . |
|
1900 @@ -4632,24 +4606,24 @@ |
|
1901 revision. This use should probably be avoided where possible, as |
|
1902 changeset is much more appropriate than checkout in this context. |
|
1903 .sp |
|
1904 -Example: "I\(aqm using checkout X." |
|
1905 +Example: "I'm using checkout X." |
|
1906 .sp |
|
1907 (Verb) Updating the working directory to a specific changeset. See |
|
1908 -\%\fBhg help update\fP\:. |
|
1909 +\fBhg help update\fP. |
|
1910 .sp |
|
1911 -Example: "I\(aqm going to check out changeset X." |
|
1912 +Example: "I'm going to check out changeset X." |
|
1913 .TP |
|
1914 .B Child changeset |
|
1915 . |
|
1916 -See \(aqChangeset, child\(aq. |
|
1917 +See 'Changeset, child'. |
|
1918 .TP |
|
1919 .B Close changeset |
|
1920 . |
|
1921 -See \(aqChangeset, close\(aq. |
|
1922 +See 'Changeset, close'. |
|
1923 .TP |
|
1924 .B Closed branch |
|
1925 . |
|
1926 -See \(aqBranch, closed\(aq. |
|
1927 +See 'Branch, closed'. |
|
1928 .TP |
|
1929 .B Clone |
|
1930 . |
|
1931 @@ -4658,13 +4632,13 @@ |
|
1932 .sp |
|
1933 Example: "Is your clone up to date?". |
|
1934 .sp |
|
1935 -(Verb) The process of creating a clone, using \%\fBhg clone\fP\:. |
|
1936 +(Verb) The process of creating a clone, using \fBhg clone\fP. |
|
1937 .sp |
|
1938 -Example: "I\(aqm going to clone the repository". |
|
1939 +Example: "I'm going to clone the repository". |
|
1940 .TP |
|
1941 .B Closed branch head |
|
1942 . |
|
1943 -See \(aqHead, closed branch\(aq. |
|
1944 +See 'Head, closed branch'. |
|
1945 .TP |
|
1946 .B Commit |
|
1947 . |
|
1948 @@ -4689,13 +4663,13 @@ |
|
1949 system (DVCS) can be described as a directed acyclic graph (DAG), |
|
1950 consisting of nodes and edges, where nodes correspond to |
|
1951 changesets and edges imply a parent \-> child relation. This graph |
|
1952 -can be visualized by graphical tools such as \%\fBhg glog\fP\: |
|
1953 +can be visualized by graphical tools such as \fBhg glog\fP |
|
1954 (graphlog). In Mercurial, the DAG is limited by the requirement |
|
1955 for children to have at most two parents. |
|
1956 .TP |
|
1957 .B Default branch |
|
1958 . |
|
1959 -See \(aqBranch, default\(aq. |
|
1960 +See 'Branch, default'. |
|
1961 .TP |
|
1962 .B Descendant |
|
1963 . |
|
1964 @@ -4703,7 +4677,7 @@ |
|
1965 from a given changeset. More precisely, the descendants of a |
|
1966 changeset can be defined by two properties: the child of a |
|
1967 changeset is a descendant, and the child of a descendant is a |
|
1968 -descendant. See also: \(aqAncestor\(aq. |
|
1969 +descendant. See also: 'Ancestor'. |
|
1970 .TP |
|
1971 .B Diff |
|
1972 . |
|
1973 @@ -4728,19 +4702,19 @@ |
|
1974 Mercurial, that will be recorded in the next commit. The working |
|
1975 directory initially corresponds to the snapshot at an existing |
|
1976 changeset, known as the parent of the working directory. See |
|
1977 -\(aqParent, working directory\(aq. The state may be modified by changes |
|
1978 +\'Parent, working directory'. The state may be modified by changes |
|
1979 to the files introduced manually or by a merge. The repository |
|
1980 metadata exists in the .hg directory inside the working directory. |
|
1981 .TP |
|
1982 .B Graph |
|
1983 . |
|
1984 -See DAG and \%\fBhg help graphlog\fP\:. |
|
1985 +See DAG and \fBhg help graphlog\fP. |
|
1986 .TP |
|
1987 .B Head |
|
1988 . |
|
1989 -The term \(aqhead\(aq may be used to refer to both a branch head or a |
|
1990 -repository head, depending on the context. See \(aqHead, branch\(aq and |
|
1991 -\(aqHead, repository\(aq for specific definitions. |
|
1992 +The term 'head' may be used to refer to both a branch head or a |
|
1993 +repository head, depending on the context. See 'Head, branch' and |
|
1994 +\'Head, repository' for specific definitions. |
|
1995 .sp |
|
1996 Heads are where development generally takes place and are the |
|
1997 usual targets for update and merge operations. |
|
1998 @@ -4752,9 +4726,9 @@ |
|
1999 .B Head, closed branch |
|
2000 . |
|
2001 A changeset that marks a head as no longer interesting. The closed |
|
2002 -head is no longer listed by \%\fBhg heads\fP\:. A branch is considered |
|
2003 +head is no longer listed by \fBhg heads\fP. A branch is considered |
|
2004 closed when all its heads are closed and consequently is not |
|
2005 -listed by \%\fBhg branches\fP\:. |
|
2006 +listed by \fBhg branches\fP. |
|
2007 .TP |
|
2008 .B Head, repository |
|
2009 . |
|
2010 @@ -4780,11 +4754,11 @@ |
|
2011 .TP |
|
2012 .B Immutable history |
|
2013 . |
|
2014 -See \(aqHistory, immutable\(aq. |
|
2015 +See 'History, immutable'. |
|
2016 .TP |
|
2017 .B Merge changeset |
|
2018 . |
|
2019 -See \(aqChangeset, merge\(aq. |
|
2020 +See 'Changeset, merge'. |
|
2021 .TP |
|
2022 .B Manifest |
|
2023 . |
|
2024 @@ -4801,7 +4775,7 @@ |
|
2025 .TP |
|
2026 .B Named branch |
|
2027 . |
|
2028 -See \(aqBranch, named\(aq. |
|
2029 +See 'Branch, named'. |
|
2030 .TP |
|
2031 .B Null changeset |
|
2032 . |
|
2033 @@ -4808,30 +4782,30 @@ |
|
2034 The empty changeset. It is the parent state of newly\-initialized |
|
2035 repositories and repositories with no checked out revision. It is |
|
2036 thus the parent of root changesets and the effective ancestor when |
|
2037 -merging unrelated changesets. Can be specified by the alias \(aqnull\(aq |
|
2038 -or by the changeset ID \(aq000000000000\(aq. |
|
2039 +merging unrelated changesets. Can be specified by the alias 'null' |
|
2040 +or by the changeset ID '000000000000'. |
|
2041 .TP |
|
2042 .B Parent |
|
2043 . |
|
2044 -See \(aqChangeset, parent\(aq. |
|
2045 +See 'Changeset, parent'. |
|
2046 .TP |
|
2047 .B Parent changeset |
|
2048 . |
|
2049 -See \(aqChangeset, parent\(aq. |
|
2050 +See 'Changeset, parent'. |
|
2051 .TP |
|
2052 .B Parent, working directory |
|
2053 . |
|
2054 The working directory parent reflects a virtual revision which is |
|
2055 the child of the changeset (or two changesets with an uncommitted |
|
2056 -merge) shown by \%\fBhg parents\fP\:. This is changed with |
|
2057 -\%\fBhg update\fP\:. Other commands to see the working directory parent |
|
2058 -are \%\fBhg summary\fP\: and \%\fBhg id\fP\:. Can be specified by the alias ".". |
|
2059 +merge) shown by \fBhg parents\fP. This is changed with |
|
2060 +\fBhg update\fP. Other commands to see the working directory parent |
|
2061 +are \fBhg summary\fP and \fBhg id\fP. Can be specified by the alias ".". |
|
2062 .TP |
|
2063 .B Patch |
|
2064 . |
|
2065 (Noun) The product of a diff operation. |
|
2066 .sp |
|
2067 -Example: "I\(aqve sent you my patch." |
|
2068 +Example: "I've sent you my patch." |
|
2069 .sp |
|
2070 (Verb) The process of using a patch file to transform one |
|
2071 changeset into another. |
|
2072 @@ -4844,7 +4818,7 @@ |
|
2073 not in the local repository are brought into the local |
|
2074 repository. Note that this operation without special arguments |
|
2075 only updates the repository, it does not update the files in the |
|
2076 -working directory. See \%\fBhg help pull\fP\:. |
|
2077 +working directory. See \fBhg help pull\fP. |
|
2078 .TP |
|
2079 .B Push |
|
2080 . |
|
2081 @@ -4852,7 +4826,7 @@ |
|
2082 not in a remote repository are sent to the remote repository. Note |
|
2083 that this operation only adds changesets which have been committed |
|
2084 locally to the remote repository. Uncommitted changes are not |
|
2085 -sent. See \%\fBhg help push\fP\:. |
|
2086 +sent. See \fBhg help push\fP. |
|
2087 .TP |
|
2088 .B Repository |
|
2089 . |
|
2090 @@ -4865,13 +4839,13 @@ |
|
2091 .TP |
|
2092 .B Repository head |
|
2093 . |
|
2094 -See \(aqHead, repository\(aq. |
|
2095 +See 'Head, repository'. |
|
2096 .TP |
|
2097 .B Revision |
|
2098 . |
|
2099 A state of the repository at some point in time. Earlier revisions |
|
2100 -can be updated to by using \%\fBhg update\fP\:. See also \(aqRevision |
|
2101 -number\(aq; See also \(aqChangeset\(aq. |
|
2102 +can be updated to by using \fBhg update\fP. See also 'Revision |
|
2103 +number'; See also 'Changeset'. |
|
2104 .TP |
|
2105 .B Revision number |
|
2106 . |
|
2107 @@ -4880,7 +4854,7 @@ |
|
2108 to a repository, starting with revision number 0. Note that the |
|
2109 revision number may be different in each clone of a repository. To |
|
2110 identify changesets uniquely between different clones, see |
|
2111 -\(aqChangeset id\(aq. |
|
2112 +\'Changeset id'. |
|
2113 .TP |
|
2114 .B Revlog |
|
2115 . |
|
2116 @@ -4891,7 +4865,7 @@ |
|
2117 .TP |
|
2118 .B Rewriting history |
|
2119 . |
|
2120 -See \(aqHistory, rewriting\(aq. |
|
2121 +See 'History, rewriting'. |
|
2122 .TP |
|
2123 .B Root |
|
2124 . |
|
2125 @@ -4907,7 +4881,7 @@ |
|
2126 . |
|
2127 The head of a given branch with the highest revision number. When |
|
2128 a branch name is used as a revision identifier, it refers to the |
|
2129 -branch tip. See also \(aqBranch, head\(aq. Note that because revision |
|
2130 +branch tip. See also 'Branch, head'. Note that because revision |
|
2131 numbers may be different in different repository clones, the |
|
2132 branch tip may be different in different cloned repositories. |
|
2133 .TP |
|
2134 @@ -4915,21 +4889,21 @@ |
|
2135 . |
|
2136 (Noun) Another synonym of changeset. |
|
2137 .sp |
|
2138 -Example: "I\(aqve pushed an update". |
|
2139 +Example: "I've pushed an update". |
|
2140 .sp |
|
2141 (Verb) This term is usually used to describe updating the state of |
|
2142 the working directory to that of a specific changeset. See |
|
2143 -\%\fBhg help update\fP\:. |
|
2144 +\fBhg help update\fP. |
|
2145 .sp |
|
2146 Example: "You should update". |
|
2147 .TP |
|
2148 .B Working directory |
|
2149 . |
|
2150 -See \(aqDirectory, working\(aq. |
|
2151 +See 'Directory, working'. |
|
2152 .TP |
|
2153 .B Working directory parent |
|
2154 . |
|
2155 -See \(aqParent, working directory\(aq. |
|
2156 +See 'Parent, working directory'. |
|
2157 .UNINDENT |
|
2158 .SH EXTENSIONS |
|
2159 .sp |
|
2160 @@ -5011,7 +4985,7 @@ |
|
2161 .SS Example Configuration |
|
2162 .sp |
|
2163 .nf |
|
2164 -.ft C |
|
2165 +.ft |
|
2166 [hooks] |
|
2167 |
|
2168 # Use this if you want to check access restrictions at commit time |
|
2169 @@ -5087,7 +5061,7 @@ |
|
2170 src/main/resources/** = * |
|
2171 |
|
2172 \&.hgtags = release_engineer |
|
2173 -.ft P |
|
2174 +.ft |
|
2175 .fi |
|
2176 .SS bugzilla |
|
2177 .sp |
|
2178 @@ -5102,8 +5076,8 @@ |
|
2179 .sp |
|
2180 The hook relies on a Bugzilla script to send bug change notification |
|
2181 emails. That script changes between Bugzilla versions; the |
|
2182 -\(aqprocessmail\(aq script used prior to 2.18 is replaced in 2.18 and |
|
2183 -subsequent versions by \(aqconfig/sendbugmail.pl\(aq. Note that these will |
|
2184 +\'processmail' script used prior to 2.18 is replaced in 2.18 and |
|
2185 +subsequent versions by 'config/sendbugmail.pl'. Note that these will |
|
2186 be run by Mercurial as the user pushing the change; you will need to |
|
2187 ensure the Bugzilla install file permissions are set appropriately. |
|
2188 .sp |
|
2189 @@ -5117,11 +5091,11 @@ |
|
2190 .TP |
|
2191 .B db |
|
2192 . |
|
2193 -Name of the Bugzilla database in MySQL. Default \(aqbugs\(aq. |
|
2194 +Name of the Bugzilla database in MySQL. Default 'bugs'. |
|
2195 .TP |
|
2196 .B user |
|
2197 . |
|
2198 -Username to use to access MySQL server. Default \(aqbugs\(aq. |
|
2199 +Username to use to access MySQL server. Default 'bugs'. |
|
2200 .TP |
|
2201 .B password |
|
2202 . |
|
2203 @@ -5133,8 +5107,8 @@ |
|
2204 .TP |
|
2205 .B version |
|
2206 . |
|
2207 -Bugzilla version. Specify \(aq3.0\(aq for Bugzilla versions 3.0 and later, |
|
2208 -\(aq2.18\(aq for Bugzilla versions from 2.18 and \(aq2.16\(aq for versions prior |
|
2209 +Bugzilla version. Specify '3.0' for Bugzilla versions 3.0 and later, |
|
2210 +\'2.18' for Bugzilla versions from 2.18 and '2.16' for versions prior |
|
2211 to 2.18. |
|
2212 .TP |
|
2213 .B bzuser |
|
2214 @@ -5145,13 +5119,13 @@ |
|
2215 .B bzdir |
|
2216 . |
|
2217 Bugzilla install directory. Used by default notify. Default |
|
2218 -\(aq/var/www/html/bugzilla\(aq. |
|
2219 +\'/var/www/html/bugzilla'. |
|
2220 .TP |
|
2221 .B notify |
|
2222 . |
|
2223 The command to run to get Bugzilla to send bug change notification |
|
2224 -emails. Substitutes from a map with 3 keys, \(aqbzdir\(aq, \(aqid\(aq (bug id) |
|
2225 -and \(aquser\(aq (committer bugzilla email). Default depends on version; |
|
2226 +emails. Substitutes from a map with 3 keys, 'bzdir', 'id' (bug id) |
|
2227 +and 'user' (committer bugzilla email). Default depends on version; |
|
2228 from 2.18 it is "cd %(bzdir)s && perl \-T contrib/sendbugmail.pl |
|
2229 %(id)s %(user)s". |
|
2230 .TP |
|
2231 @@ -5158,9 +5132,9 @@ |
|
2232 .B regexp |
|
2233 . |
|
2234 Regular expression to match bug IDs in changeset commit message. |
|
2235 -Must contain one "()" group. The default expression matches \(aqBug |
|
2236 -1234\(aq, \(aqBug no. 1234\(aq, \(aqBug number 1234\(aq, \(aqBugs 1234,5678\(aq, \(aqBug |
|
2237 -1234 and 5678\(aq and variations thereof. Matching is case insensitive. |
|
2238 +Must contain one "()" group. The default expression matches 'Bug |
|
2239 +1234', 'Bug no. 1234', 'Bug number 1234', 'Bugs 1234,5678', 'Bug |
|
2240 +1234 and 5678' and variations thereof. Matching is case insensitive. |
|
2241 .TP |
|
2242 .B style |
|
2243 . |
|
2244 @@ -5173,18 +5147,18 @@ |
|
2245 extension specifies: |
|
2246 .sp |
|
2247 .nf |
|
2248 -.ft C |
|
2249 +.ft |
|
2250 {bug} The Bugzilla bug ID. |
|
2251 {root} The full pathname of the Mercurial repository. |
|
2252 {webroot} Stripped pathname of the Mercurial repository. |
|
2253 {hgweb} Base URL for browsing Mercurial repositories. |
|
2254 -.ft P |
|
2255 +.ft |
|
2256 .fi |
|
2257 .INDENT 7.0 |
|
2258 .TP |
|
2259 -.B Default \(aqchangeset {node|short} in repo {root} refers \(aq |
|
2260 +.B Default 'changeset {node|short} in repo {root} refers ' |
|
2261 . |
|
2262 -\(aqto bug {bug}.ndetails:nt{desc|tabindent}\(aq |
|
2263 +\'to bug {bug}.ndetails:nt{desc|tabindent}' |
|
2264 .UNINDENT |
|
2265 .TP |
|
2266 .B strip |
|
2267 @@ -5215,7 +5189,7 @@ |
|
2268 Activating the extension: |
|
2269 .sp |
|
2270 .nf |
|
2271 -.ft C |
|
2272 +.ft |
|
2273 [extensions] |
|
2274 bugzilla = |
|
2275 |
|
2276 @@ -5222,7 +5196,7 @@ |
|
2277 [hooks] |
|
2278 # run bugzilla hook on every change pulled or pushed in here |
|
2279 incoming.bugzilla = python:hgext.bugzilla.hook |
|
2280 -.ft P |
|
2281 +.ft |
|
2282 .fi |
|
2283 .sp |
|
2284 Example configuration: |
|
2285 @@ -5232,7 +5206,7 @@ |
|
2286 installation in /opt/bugzilla\-3.2. |
|
2287 .sp |
|
2288 .nf |
|
2289 -.ft C |
|
2290 +.ft |
|
2291 [bugzilla] |
|
2292 host=localhost |
|
2293 password=XYZZY |
|
2294 @@ -5249,18 +5223,18 @@ |
|
2295 |
|
2296 [usermap] |
|
2297 [email protected][email protected] |
|
2298 -.ft P |
|
2299 +.ft |
|
2300 .fi |
|
2301 .sp |
|
2302 Commits add a comment to the Bugzilla bug record of the form: |
|
2303 .sp |
|
2304 .nf |
|
2305 -.ft C |
|
2306 +.ft |
|
2307 Changeset 3b16791d6642 in repository\-name. |
|
2308 http://dev.domain.com/hg/repository\-name/rev/3b16791d6642 |
|
2309 |
|
2310 Changeset commit comment. Bug 1234. |
|
2311 -.ft P |
|
2312 +.ft |
|
2313 .fi |
|
2314 .SS children |
|
2315 .sp |
|
2316 @@ -5269,12 +5243,12 @@ |
|
2317 .SS children |
|
2318 .sp |
|
2319 .nf |
|
2320 -.ft C |
|
2321 +.ft |
|
2322 hg children [\-r REV] [FILE] |
|
2323 -.ft P |
|
2324 +.ft |
|
2325 .fi |
|
2326 .sp |
|
2327 -Print the children of the working directory\(aqs revisions. If a |
|
2328 +Print the children of the working directory's revisions. If a |
|
2329 revision is given via \-r/\-\-rev, the children of that revision will |
|
2330 be printed. If a file argument is given, revision in which the |
|
2331 file was last changed (after the working directory revision or the |
|
2332 @@ -5302,9 +5276,9 @@ |
|
2333 .SS churn |
|
2334 .sp |
|
2335 .nf |
|
2336 -.ft C |
|
2337 +.ft |
|
2338 hg churn [\-d DATE] [\-r REV] [\-\-aliases FILE] [FILE] |
|
2339 -.ft P |
|
2340 +.ft |
|
2341 .fi |
|
2342 .sp |
|
2343 This command will display a histogram representing the number |
|
2344 @@ -5320,19 +5294,19 @@ |
|
2345 Examples: |
|
2346 .sp |
|
2347 .nf |
|
2348 -.ft C |
|
2349 +.ft |
|
2350 # display count of changed lines for every committer |
|
2351 -hg churn \-t \(aq{author|email}\(aq |
|
2352 +hg churn \-t '{author|email}' |
|
2353 |
|
2354 # display daily activity graph |
|
2355 -hg churn \-f \(aq%H\(aq \-s \-c |
|
2356 +hg churn \-f '%H' \-s \-c |
|
2357 |
|
2358 # display activity of developers by month |
|
2359 -hg churn \-f \(aq%Y\-%m\(aq \-s \-c |
|
2360 +hg churn \-f '%Y\-%m' \-s \-c |
|
2361 |
|
2362 # display count of lines changed in every year |
|
2363 -hg churn \-f \(aq%Y\(aq \-s |
|
2364 -.ft P |
|
2365 +hg churn \-f '%Y' \-s |
|
2366 +.ft |
|
2367 .fi |
|
2368 .sp |
|
2369 It is possible to map alternate email addresses to a main address |
|
2370 @@ -5339,9 +5313,9 @@ |
|
2371 by providing a file using the following format: |
|
2372 .sp |
|
2373 .nf |
|
2374 -.ft C |
|
2375 +.ft |
|
2376 <alias email> = <actual email> |
|
2377 -.ft P |
|
2378 +.ft |
|
2379 .fi |
|
2380 .sp |
|
2381 Such a file may be specified with the \-\-aliases option, otherwise |
|
2382 @@ -5407,7 +5381,7 @@ |
|
2383 Default effects may be overridden from your configuration file: |
|
2384 .sp |
|
2385 .nf |
|
2386 -.ft C |
|
2387 +.ft |
|
2388 [color] |
|
2389 status.modified = blue bold underline red_background |
|
2390 status.added = green bold |
|
2391 @@ -5416,7 +5390,7 @@ |
|
2392 status.unknown = magenta bold underline |
|
2393 status.ignored = black bold |
|
2394 |
|
2395 -# \(aqnone\(aq turns off all effects |
|
2396 +# 'none' turns off all effects |
|
2397 status.clean = none |
|
2398 status.copied = none |
|
2399 |
|
2400 @@ -5443,7 +5417,7 @@ |
|
2401 branches.closed = black bold |
|
2402 branches.current = green |
|
2403 branches.inactive = none |
|
2404 -.ft P |
|
2405 +.ft |
|
2406 .fi |
|
2407 .sp |
|
2408 The color extension will try to detect whether to use ANSI codes or |
|
2409 @@ -5450,13 +5424,13 @@ |
|
2410 Win32 console APIs, unless it is made explicit: |
|
2411 .sp |
|
2412 .nf |
|
2413 -.ft C |
|
2414 +.ft |
|
2415 [color] |
|
2416 mode = ansi |
|
2417 -.ft P |
|
2418 +.ft |
|
2419 .fi |
|
2420 .sp |
|
2421 -Any value other than \(aqansi\(aq, \(aqwin32\(aq, or \(aqauto\(aq will disable color. |
|
2422 +Any value other than 'ansi', 'win32', or 'auto' will disable color. |
|
2423 .SS convert |
|
2424 .sp |
|
2425 import revisions from foreign VCS repositories into Mercurial |
|
2426 @@ -5464,9 +5438,9 @@ |
|
2427 .SS convert |
|
2428 .sp |
|
2429 .nf |
|
2430 -.ft C |
|
2431 +.ft |
|
2432 hg convert [OPTION]... SOURCE [DEST [REVMAP]] |
|
2433 -.ft P |
|
2434 +.ft |
|
2435 .fi |
|
2436 .sp |
|
2437 Accepted source formats [identifiers]: |
|
2438 @@ -5516,7 +5490,7 @@ |
|
2439 .sp |
|
2440 If no destination directory name is specified, it defaults to the |
|
2441 basename of the source with \fB\-hg\fP appended. If the destination |
|
2442 -repository doesn\(aqt exist, it will be created. |
|
2443 +repository doesn't exist, it will be created. |
|
2444 .sp |
|
2445 By default, all sources except Mercurial will use \-\-branchsort. |
|
2446 Mercurial uses \-\-sourcesort to preserve original revision numbers |
|
2447 @@ -5542,19 +5516,19 @@ |
|
2448 supported by Mercurial sources. |
|
2449 .UNINDENT |
|
2450 .sp |
|
2451 -If \fBREVMAP\fP isn\(aqt given, it will be put in a default location |
|
2452 +If \fBREVMAP\fP isn't given, it will be put in a default location |
|
2453 (\fB<dest>/.hg/shamap\fP by default). The \fBREVMAP\fP is a simple |
|
2454 text file that maps each source commit ID to the destination ID |
|
2455 for that revision, like so: |
|
2456 .sp |
|
2457 .nf |
|
2458 -.ft C |
|
2459 +.ft |
|
2460 <source ID> <destination ID> |
|
2461 -.ft P |
|
2462 +.ft |
|
2463 .fi |
|
2464 .sp |
|
2465 -If the file doesn\(aqt exist, it\(aqs automatically created. It\(aqs |
|
2466 -updated on each commit copied, so \%\fBhg convert\fP\: can be interrupted |
|
2467 +If the file doesn't exist, it's automatically created. It's |
|
2468 +updated on each commit copied, so \fBhg convert\fP can be interrupted |
|
2469 and can be run repeatedly to copy new commits. |
|
2470 .sp |
|
2471 The authormap is a simple text file that maps each source commit |
|
2472 @@ -5563,9 +5537,9 @@ |
|
2473 author mapping and the line format is: |
|
2474 .sp |
|
2475 .nf |
|
2476 -.ft C |
|
2477 +.ft |
|
2478 source author = destination author |
|
2479 -.ft P |
|
2480 +.ft |
|
2481 .fi |
|
2482 .sp |
|
2483 Empty lines and lines starting with a \fB#\fP are ignored. |
|
2484 @@ -5575,13 +5549,13 @@ |
|
2485 directives: |
|
2486 .sp |
|
2487 .nf |
|
2488 -.ft C |
|
2489 +.ft |
|
2490 include path/to/file\-or\-dir |
|
2491 |
|
2492 exclude path/to/file\-or\-dir |
|
2493 |
|
2494 rename path/to/source path/to/destination |
|
2495 -.ft P |
|
2496 +.ft |
|
2497 .fi |
|
2498 .sp |
|
2499 Comment lines start with \fB#\fP. A specified path matches if it |
|
2500 @@ -5605,9 +5579,9 @@ |
|
2501 comma\-separated values: |
|
2502 .sp |
|
2503 .nf |
|
2504 -.ft C |
|
2505 +.ft |
|
2506 key parent1, parent2 |
|
2507 -.ft P |
|
2508 +.ft |
|
2509 .fi |
|
2510 .sp |
|
2511 The key is the revision ID in the source |
|
2512 @@ -5627,9 +5601,9 @@ |
|
2513 lines of the form: |
|
2514 .sp |
|
2515 .nf |
|
2516 -.ft C |
|
2517 +.ft |
|
2518 original_branch_name new_branch_name |
|
2519 -.ft P |
|
2520 +.ft |
|
2521 .fi |
|
2522 .sp |
|
2523 where "original_branch_name" is the name of the branch in the |
|
2524 @@ -5876,9 +5850,9 @@ |
|
2525 Files with the declared format of \fBCRLF\fP or \fBLF\fP are always |
|
2526 checked out and stored in the repository in that format and files |
|
2527 declared to be binary (\fBBIN\fP) are left unchanged. Additionally, |
|
2528 -\fBnative\fP is an alias for checking out in the platform\(aqs default line |
|
2529 +\fBnative\fP is an alias for checking out in the platform's default line |
|
2530 ending: \fBLF\fP on Unix (including Mac OS X) and \fBCRLF\fP on |
|
2531 -Windows. Note that \fBBIN\fP (do nothing to line endings) is Mercurial\(aqs |
|
2532 +Windows. Note that \fBBIN\fP (do nothing to line endings) is Mercurial's |
|
2533 default behaviour; it is only needed if you need to override a later, |
|
2534 more general pattern. |
|
2535 .sp |
|
2536 @@ -5895,7 +5869,7 @@ |
|
2537 Example versioned \fB.hgeol\fP file: |
|
2538 .sp |
|
2539 .nf |
|
2540 -.ft C |
|
2541 +.ft |
|
2542 [patterns] |
|
2543 **.py = native |
|
2544 **.vcproj = CRLF |
|
2545 @@ -5905,7 +5879,7 @@ |
|
2546 |
|
2547 [repository] |
|
2548 native = LF |
|
2549 -.ft P |
|
2550 +.ft |
|
2551 .fi |
|
2552 .IP Note |
|
2553 . |
|
2554 @@ -5921,7 +5895,7 @@ |
|
2555 . |
|
2556 \fBeol.native\fP (default \fBos.linesep\fP) can be set to \fBLF\fP or |
|
2557 \fBCRLF\fP to override the default interpretation of \fBnative\fP for |
|
2558 -checkout. This can be used with \%\fBhg archive\fP\: on Unix, say, to |
|
2559 +checkout. This can be used with \fBhg archive\fP on Unix, say, to |
|
2560 generate an archive where files have line endings for Windows. |
|
2561 .IP \(bu 2 |
|
2562 . |
|
2563 @@ -5944,7 +5918,7 @@ |
|
2564 Remember to enable the eol extension in the repository where you |
|
2565 install the hook. |
|
2566 .sp |
|
2567 -See \%\fBhg help patterns\fP\: for more information about the glob patterns |
|
2568 +See \fBhg help patterns\fP for more information about the glob patterns |
|
2569 used. |
|
2570 .SS extdiff |
|
2571 .sp |
|
2572 @@ -5957,12 +5931,12 @@ |
|
2573 files to compare. |
|
2574 .sp |
|
2575 The extdiff extension also allows to configure new diff commands, so |
|
2576 -you do not need to type \%\fBhg extdiff \-p kdiff3\fP\: always. |
|
2577 +you do not need to type \fBhg extdiff \-p kdiff3\fP always. |
|
2578 .sp |
|
2579 .nf |
|
2580 -.ft C |
|
2581 +.ft |
|
2582 [extdiff] |
|
2583 -# add new command that runs GNU diff(1) in \(aqcontext diff\(aq mode |
|
2584 +# add new command that runs GNU diff(1) in 'context diff' mode |
|
2585 cdiff = gdiff \-Nprc5 |
|
2586 ## or the old way: |
|
2587 #cmd.cdiff = gdiff |
|
2588 @@ -5978,19 +5952,19 @@ |
|
2589 # (see http://www.vim.org/scripts/script.php?script_id=102) Non |
|
2590 # English user, be sure to put "let g:DirDiffDynamicDiffText = 1" in |
|
2591 # your .vimrc |
|
2592 -vimdiff = gvim \-f \(aq+next\(aq \(aq+execute "DirDiff" argv(0) argv(1)\(aq |
|
2593 -.ft P |
|
2594 +vimdiff = gvim \-f '+next' '+execute "DirDiff" argv(0) argv(1)' |
|
2595 +.ft |
|
2596 .fi |
|
2597 .sp |
|
2598 Tool arguments can include variables that are expanded at runtime: |
|
2599 .sp |
|
2600 .nf |
|
2601 -.ft C |
|
2602 +.ft |
|
2603 $parent1, $plabel1 \- filename, descriptive label of first parent |
|
2604 $child, $clabel \- filename, descriptive label of child revision |
|
2605 $parent2, $plabel2 \- filename, descriptive label of second parent |
|
2606 $parent is an alias for $parent1. |
|
2607 -.ft P |
|
2608 +.ft |
|
2609 .fi |
|
2610 .sp |
|
2611 The extdiff extension will look in your [diff\-tools] and [merge\-tools] |
|
2612 @@ -5997,17 +5971,17 @@ |
|
2613 sections for diff tool arguments, when none are specified in [extdiff]. |
|
2614 .sp |
|
2615 .nf |
|
2616 -.ft C |
|
2617 +.ft |
|
2618 [extdiff] |
|
2619 kdiff3 = |
|
2620 |
|
2621 [diff\-tools] |
|
2622 -kdiff3.diffargs=\-\-L1 \(aq$plabel1\(aq \-\-L2 \(aq$clabel\(aq $parent $child |
|
2623 -.ft P |
|
2624 +kdiff3.diffargs=\-\-L1 '$plabel1' \-\-L2 '$clabel' $parent $child |
|
2625 +.ft |
|
2626 .fi |
|
2627 .sp |
|
2628 You can use \-I/\-X and list of file or directory names like normal |
|
2629 -\%\fBhg diff\fP\: command. The extdiff extension makes snapshots of only |
|
2630 +\fBhg diff\fP command. The extdiff extension makes snapshots of only |
|
2631 needed files, so running the external diff program will actually be |
|
2632 pretty fast (at least faster than having to compare the entire tree). |
|
2633 .SS Commands |
|
2634 @@ -6014,9 +5988,9 @@ |
|
2635 .SS extdiff |
|
2636 .sp |
|
2637 .nf |
|
2638 -.ft C |
|
2639 +.ft |
|
2640 hg extdiff [OPT]... [FILE]... |
|
2641 -.ft P |
|
2642 +.ft |
|
2643 .fi |
|
2644 .sp |
|
2645 Show differences between revisions for the specified files, using |
|
2646 @@ -6068,9 +6042,9 @@ |
|
2647 .SS fetch |
|
2648 .sp |
|
2649 .nf |
|
2650 -.ft C |
|
2651 +.ft |
|
2652 hg fetch [SOURCE] |
|
2653 -.ft P |
|
2654 +.ft |
|
2655 .fi |
|
2656 .sp |
|
2657 This finds all changes from the repository at the specified path |
|
2658 @@ -6086,7 +6060,7 @@ |
|
2659 parent, with local changes as the second. To switch the merge |
|
2660 order, use \-\-switch\-parent. |
|
2661 .sp |
|
2662 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date. |
|
2663 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date. |
|
2664 .sp |
|
2665 Returns 0 on success. |
|
2666 .sp |
|
2667 @@ -6144,9 +6118,9 @@ |
|
2668 .SS sigcheck |
|
2669 .sp |
|
2670 .nf |
|
2671 -.ft C |
|
2672 +.ft |
|
2673 hg sigcheck REVISION |
|
2674 -.ft P |
|
2675 +.ft |
|
2676 .fi |
|
2677 .sp |
|
2678 verify all the signatures there may be for a particular revision |
|
2679 @@ -6153,15 +6127,15 @@ |
|
2680 .SS sign |
|
2681 .sp |
|
2682 .nf |
|
2683 -.ft C |
|
2684 +.ft |
|
2685 hg sign [OPTION]... [REVISION]... |
|
2686 -.ft P |
|
2687 +.ft |
|
2688 .fi |
|
2689 .sp |
|
2690 If no revision is given, the parent of the working directory is used, |
|
2691 or tip if no revision is checked out. |
|
2692 .sp |
|
2693 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date. |
|
2694 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date. |
|
2695 .sp |
|
2696 Options: |
|
2697 .INDENT 0.0 |
|
2698 @@ -6197,9 +6171,9 @@ |
|
2699 .SS sigs |
|
2700 .sp |
|
2701 .nf |
|
2702 -.ft C |
|
2703 +.ft |
|
2704 hg sigs |
|
2705 -.ft P |
|
2706 +.ft |
|
2707 .fi |
|
2708 .sp |
|
2709 list signed changesets |
|
2710 @@ -6214,9 +6188,9 @@ |
|
2711 .SS glog |
|
2712 .sp |
|
2713 .nf |
|
2714 -.ft C |
|
2715 +.ft |
|
2716 hg glog [OPTION]... [FILE] |
|
2717 -.ft P |
|
2718 +.ft |
|
2719 .fi |
|
2720 .sp |
|
2721 Print a revision history alongside a revision graph drawn with |
|
2722 @@ -6256,7 +6230,7 @@ |
|
2723 configure it, set the following options in your hgrc: |
|
2724 .sp |
|
2725 .nf |
|
2726 -.ft C |
|
2727 +.ft |
|
2728 [cia] |
|
2729 # your registered CIA user name |
|
2730 user = foo |
|
2731 @@ -6286,7 +6260,7 @@ |
|
2732 [web] |
|
2733 # If you want hyperlinks (optional) |
|
2734 baseurl = http://server/path/to/repo |
|
2735 -.ft P |
|
2736 +.ft |
|
2737 .fi |
|
2738 .SS hgk |
|
2739 .sp |
|
2740 @@ -6302,15 +6276,15 @@ |
|
2741 the contrib directory, and the extension is shipped in the hgext |
|
2742 repository, and needs to be enabled. |
|
2743 .sp |
|
2744 -The \%\fBhg view\fP\: command will launch the hgk Tcl script. For this command |
|
2745 +The \fBhg view\fP command will launch the hgk Tcl script. For this command |
|
2746 to work, hgk must be in your search path. Alternately, you can specify |
|
2747 the path to hgk in your configuration file: |
|
2748 .sp |
|
2749 .nf |
|
2750 -.ft C |
|
2751 +.ft |
|
2752 [hgk] |
|
2753 path=/location/of/hgk |
|
2754 -.ft P |
|
2755 +.ft |
|
2756 .fi |
|
2757 .sp |
|
2758 hgk can make use of the extdiff extension to visualize revisions. |
|
2759 @@ -6317,10 +6291,10 @@ |
|
2760 Assuming you had already configured extdiff vdiff command, just add: |
|
2761 .sp |
|
2762 .nf |
|
2763 -.ft C |
|
2764 +.ft |
|
2765 [hgk] |
|
2766 vdiff=vdiff |
|
2767 -.ft P |
|
2768 +.ft |
|
2769 .fi |
|
2770 .sp |
|
2771 Revisions context menu will now display additional entries to fire |
|
2772 @@ -6329,9 +6303,9 @@ |
|
2773 .SS view |
|
2774 .sp |
|
2775 .nf |
|
2776 -.ft C |
|
2777 +.ft |
|
2778 hg view [\-l LIMIT] [REVRANGE] |
|
2779 -.ft P |
|
2780 +.ft |
|
2781 .fi |
|
2782 .sp |
|
2783 start interactive history viewer |
|
2784 @@ -6348,28 +6322,28 @@ |
|
2785 syntax highlighting for hgweb (requires Pygments) |
|
2786 .sp |
|
2787 It depends on the Pygments syntax highlighting library: |
|
2788 -\%http://pygments.org/\: |
|
2789 +http://pygments.org/ |
|
2790 .sp |
|
2791 There is a single configuration option: |
|
2792 .sp |
|
2793 .nf |
|
2794 -.ft C |
|
2795 +.ft |
|
2796 [web] |
|
2797 pygments_style = <style> |
|
2798 -.ft P |
|
2799 +.ft |
|
2800 .fi |
|
2801 .sp |
|
2802 -The default is \(aqcolorful\(aq. |
|
2803 +The default is 'colorful'. |
|
2804 .SS inotify |
|
2805 .sp |
|
2806 -accelerate status report using Linux\(aqs inotify service |
|
2807 +accelerate status report using Linux's inotify service |
|
2808 .SS Commands |
|
2809 .SS inserve |
|
2810 .sp |
|
2811 .nf |
|
2812 -.ft C |
|
2813 +.ft |
|
2814 hg inserve [OPTION]... |
|
2815 -.ft P |
|
2816 +.ft |
|
2817 .fi |
|
2818 .sp |
|
2819 start an inotify server for this repository |
|
2820 @@ -6405,12 +6379,12 @@ |
|
2821 in your hgrc: |
|
2822 .sp |
|
2823 .nf |
|
2824 -.ft C |
|
2825 +.ft |
|
2826 [interhg] |
|
2827 issues = s!issue(\ed+)!<a href="http://bts/issue\e1">issue\e1</a>! |
|
2828 bugzilla = s!((?:bug|b=|(?=#?\ed{4,}))(?:\es*#?)(\ed+))!<a..=\e2">\e1</a>!i |
|
2829 boldify = s!(^|\es)#(\ed+)\eb! <b>#\e2</b>! |
|
2830 -.ft P |
|
2831 +.ft |
|
2832 .fi |
|
2833 .SS keyword |
|
2834 .sp |
|
2835 @@ -6432,7 +6406,7 @@ |
|
2836 Example: |
|
2837 .sp |
|
2838 .nf |
|
2839 -.ft C |
|
2840 +.ft |
|
2841 [keyword] |
|
2842 # expand keywords in every python file except those matching "x*" |
|
2843 **.py = |
|
2844 @@ -6441,7 +6415,7 @@ |
|
2845 [keywordset] |
|
2846 # prefer svn\- over cvs\-like default keywordmaps |
|
2847 svn = True |
|
2848 -.ft P |
|
2849 +.ft |
|
2850 .fi |
|
2851 .IP Note |
|
2852 . |
|
2853 @@ -6450,39 +6424,39 @@ |
|
2854 .RE |
|
2855 .sp |
|
2856 For [keywordmaps] template mapping and expansion demonstration and |
|
2857 -control run \%\fBhg kwdemo\fP\:. See \%\fBhg help templates\fP\: for a list of |
|
2858 +control run \fBhg kwdemo\fP. See \fBhg help templates\fP for a list of |
|
2859 available templates and filters. |
|
2860 .sp |
|
2861 Three additional date template filters are provided: |
|
2862 .sp |
|
2863 .nf |
|
2864 -.ft C |
|
2865 +.ft |
|
2866 utcdate "2006/09/18 15:13:13" |
|
2867 svnutcdate "2006\-09\-18 15:13:13Z" |
|
2868 svnisodate "2006\-09\-18 08:13:13 \-700 (Mon, 18 Sep 2006)" |
|
2869 -.ft P |
|
2870 +.ft |
|
2871 .fi |
|
2872 .sp |
|
2873 -The default template mappings (view with \%\fBhg kwdemo \-d\fP\:) can be |
|
2874 +The default template mappings (view with \fBhg kwdemo \-d\fP) can be |
|
2875 replaced with customized keywords and templates. Again, run |
|
2876 -\%\fBhg kwdemo\fP\: to control the results of your configuration changes. |
|
2877 +\fBhg kwdemo\fP to control the results of your configuration changes. |
|
2878 .sp |
|
2879 -Before changing/disabling active keywords, you must run \%\fBhg kwshrink\fP\: |
|
2880 +Before changing/disabling active keywords, you must run \fBhg kwshrink\fP |
|
2881 to avoid storing expanded keywords in the change history. |
|
2882 .sp |
|
2883 To force expansion after enabling it, or a configuration change, run |
|
2884 -\%\fBhg kwexpand\fP\:. |
|
2885 +\fBhg kwexpand\fP. |
|
2886 .sp |
|
2887 Expansions spanning more than one line and incremental expansions, |
|
2888 -like CVS\(aq $Log$, are not supported. A keyword template map "Log = |
|
2889 +like CVS' $Log$, are not supported. A keyword template map "Log = |
|
2890 {desc}" expands to the first line of the changeset description. |
|
2891 .SS Commands |
|
2892 .SS kwdemo |
|
2893 .sp |
|
2894 .nf |
|
2895 -.ft C |
|
2896 +.ft |
|
2897 hg kwdemo [\-d] [\-f RCFILE] [TEMPLATEMAP]... |
|
2898 -.ft P |
|
2899 +.ft |
|
2900 .fi |
|
2901 .sp |
|
2902 Show current, custom, or default keyword template maps and their |
|
2903 @@ -6493,7 +6467,7 @@ |
|
2904 .sp |
|
2905 Use \-d/\-\-default to disable current configuration. |
|
2906 .sp |
|
2907 -See \%\fBhg help templates\fP\: for information on templates and filters. |
|
2908 +See \fBhg help templates\fP for information on templates and filters. |
|
2909 .sp |
|
2910 Options: |
|
2911 .INDENT 0.0 |
|
2912 @@ -6509,9 +6483,9 @@ |
|
2913 .SS kwexpand |
|
2914 .sp |
|
2915 .nf |
|
2916 -.ft C |
|
2917 +.ft |
|
2918 hg kwexpand [OPTION]... [FILE]... |
|
2919 -.ft P |
|
2920 +.ft |
|
2921 .fi |
|
2922 .sp |
|
2923 Run after (re)enabling keyword expansion. |
|
2924 @@ -6532,9 +6506,9 @@ |
|
2925 .SS kwfiles |
|
2926 .sp |
|
2927 .nf |
|
2928 -.ft C |
|
2929 +.ft |
|
2930 hg kwfiles [OPTION]... [FILE]... |
|
2931 -.ft P |
|
2932 +.ft |
|
2933 .fi |
|
2934 .sp |
|
2935 List which files in the working directory are matched by the |
|
2936 @@ -6544,7 +6518,7 @@ |
|
2937 execution by including only files that are actual candidates for |
|
2938 expansion. |
|
2939 .sp |
|
2940 -See \%\fBhg help keyword\fP\: on how to construct patterns both for |
|
2941 +See \fBhg help keyword\fP on how to construct patterns both for |
|
2942 inclusion and exclusion of files. |
|
2943 .sp |
|
2944 With \-A/\-\-all and \-v/\-\-verbose the codes used to show the status |
|
2945 @@ -6551,12 +6525,12 @@ |
|
2946 of files are: |
|
2947 .sp |
|
2948 .nf |
|
2949 -.ft C |
|
2950 +.ft |
|
2951 K = keyword expansion candidate |
|
2952 k = keyword expansion candidate (not tracked) |
|
2953 I = ignored |
|
2954 i = ignored (not tracked) |
|
2955 -.ft P |
|
2956 +.ft |
|
2957 .fi |
|
2958 .sp |
|
2959 Options: |
|
2960 @@ -6585,9 +6559,9 @@ |
|
2961 .SS kwshrink |
|
2962 .sp |
|
2963 .nf |
|
2964 -.ft C |
|
2965 +.ft |
|
2966 hg kwshrink [OPTION]... [FILE]... |
|
2967 -.ft P |
|
2968 +.ft |
|
2969 .fi |
|
2970 .sp |
|
2971 Must be run before changing/disabling active keywords. |
|
2972 @@ -6616,10 +6590,10 @@ |
|
2973 Known patches are represented as patch files in the .hg/patches |
|
2974 directory. Applied patches are both patch files and changesets. |
|
2975 .sp |
|
2976 -Common tasks (use \%\fBhg help command\fP\: for more details): |
|
2977 +Common tasks (use \fBhg help command\fP for more details): |
|
2978 .sp |
|
2979 .nf |
|
2980 -.ft C |
|
2981 +.ft |
|
2982 create new patch qnew |
|
2983 import existing patch qimport |
|
2984 |
|
2985 @@ -6629,7 +6603,7 @@ |
|
2986 add known patch to applied stack qpush |
|
2987 remove patch from applied stack qpop |
|
2988 refresh contents of top applied patch qrefresh |
|
2989 -.ft P |
|
2990 +.ft |
|
2991 .fi |
|
2992 .sp |
|
2993 By default, mq will automatically use git patches when required to |
|
2994 @@ -6637,26 +6611,26 @@ |
|
2995 files creations or deletions. This behaviour can be configured with: |
|
2996 .sp |
|
2997 .nf |
|
2998 -.ft C |
|
2999 +.ft |
|
3000 [mq] |
|
3001 git = auto/keep/yes/no |
|
3002 -.ft P |
|
3003 +.ft |
|
3004 .fi |
|
3005 .sp |
|
3006 -If set to \(aqkeep\(aq, mq will obey the [diff] section configuration while |
|
3007 -preserving existing git patches upon qrefresh. If set to \(aqyes\(aq or |
|
3008 -\(aqno\(aq, mq will override the [diff] section and always generate git or |
|
3009 +If set to 'keep', mq will obey the [diff] section configuration while |
|
3010 +preserving existing git patches upon qrefresh. If set to 'yes' or |
|
3011 +\'no', mq will override the [diff] section and always generate git or |
|
3012 regular patches, possibly losing data in the second case. |
|
3013 .sp |
|
3014 You will by default be managing a patch queue named "patches". You can |
|
3015 -create other, independent patch queues with the \%\fBhg qqueue\fP\: command. |
|
3016 +create other, independent patch queues with the \fBhg qqueue\fP command. |
|
3017 .SS Commands |
|
3018 .SS qapplied |
|
3019 .sp |
|
3020 .nf |
|
3021 -.ft C |
|
3022 +.ft |
|
3023 hg qapplied [\-1] [\-s] [PATCH] |
|
3024 -.ft P |
|
3025 +.ft |
|
3026 .fi |
|
3027 .sp |
|
3028 Returns 0 on success. |
|
3029 @@ -6675,9 +6649,9 @@ |
|
3030 .SS qclone |
|
3031 .sp |
|
3032 .nf |
|
3033 -.ft C |
|
3034 +.ft |
|
3035 hg qclone [OPTION]... SOURCE [DEST] |
|
3036 -.ft P |
|
3037 +.ft |
|
3038 .fi |
|
3039 .sp |
|
3040 If source is local, destination will have no patches applied. If |
|
3041 @@ -6690,7 +6664,7 @@ |
|
3042 default. Use \-p <url> to change. |
|
3043 .sp |
|
3044 The patch directory must be a nested Mercurial repository, as |
|
3045 -would be created by \%\fBhg init \-\-mq\fP\:. |
|
3046 +would be created by \fBhg init \-\-mq\fP. |
|
3047 .sp |
|
3048 Return 0 on success. |
|
3049 .sp |
|
3050 @@ -6728,12 +6702,12 @@ |
|
3051 .SS qcommit |
|
3052 .sp |
|
3053 .nf |
|
3054 -.ft C |
|
3055 +.ft |
|
3056 hg qcommit [OPTION]... [FILE]... |
|
3057 -.ft P |
|
3058 +.ft |
|
3059 .fi |
|
3060 .sp |
|
3061 -This command is deprecated; use \%\fBhg commit \-\-mq\fP\: instead. |
|
3062 +This command is deprecated; use \fBhg commit \-\-mq\fP instead. |
|
3063 .sp |
|
3064 Options: |
|
3065 .INDENT 0.0 |
|
3066 @@ -6775,9 +6749,9 @@ |
|
3067 .SS qdelete |
|
3068 .sp |
|
3069 .nf |
|
3070 -.ft C |
|
3071 +.ft |
|
3072 hg qdelete [\-k] [PATCH]... |
|
3073 -.ft P |
|
3074 +.ft |
|
3075 .fi |
|
3076 .sp |
|
3077 The patches must not be applied, and at least one patch is required. With |
|
3078 @@ -6784,7 +6758,7 @@ |
|
3079 \-k/\-\-keep, the patch files are preserved in the patch directory. |
|
3080 .sp |
|
3081 To stop managing a patch and move it into permanent history, |
|
3082 -use the \%\fBhg qfinish\fP\: command. |
|
3083 +use the \fBhg qfinish\fP command. |
|
3084 .sp |
|
3085 Options: |
|
3086 .INDENT 0.0 |
|
3087 @@ -6802,9 +6776,9 @@ |
|
3088 .SS qdiff |
|
3089 .sp |
|
3090 .nf |
|
3091 -.ft C |
|
3092 +.ft |
|
3093 hg qdiff [OPTION]... [FILE]... |
|
3094 -.ft P |
|
3095 +.ft |
|
3096 .fi |
|
3097 .sp |
|
3098 Shows a diff which includes the current patch as well as any |
|
3099 @@ -6812,8 +6786,8 @@ |
|
3100 last refresh (thus showing what the current patch would become |
|
3101 after a qrefresh). |
|
3102 .sp |
|
3103 -Use \%\fBhg diff\fP\: if you only want to see the changes made since the |
|
3104 -last qrefresh, or \%\fBhg export qtip\fP\: if you want to see changes |
|
3105 +Use \fBhg diff\fP if you only want to see the changes made since the |
|
3106 +last qrefresh, or \fBhg export qtip\fP if you want to see changes |
|
3107 made by the current patch without including changes made since the |
|
3108 qrefresh. |
|
3109 .sp |
|
3110 @@ -6873,9 +6847,9 @@ |
|
3111 .SS qfinish |
|
3112 .sp |
|
3113 .nf |
|
3114 -.ft C |
|
3115 +.ft |
|
3116 hg qfinish [\-a] [REV]... |
|
3117 -.ft P |
|
3118 +.ft |
|
3119 .fi |
|
3120 .sp |
|
3121 Finishes the specified revisions (corresponding to applied |
|
3122 @@ -6903,9 +6877,9 @@ |
|
3123 .SS qfold |
|
3124 .sp |
|
3125 .nf |
|
3126 -.ft C |
|
3127 +.ft |
|
3128 hg qfold [\-e] [\-k] [\-m TEXT] [\-l FILE] PATCH... |
|
3129 -.ft P |
|
3130 +.ft |
|
3131 .fi |
|
3132 .sp |
|
3133 Patches must not yet be applied. Each patch will be successively |
|
3134 @@ -6942,9 +6916,9 @@ |
|
3135 .SS qgoto |
|
3136 .sp |
|
3137 .nf |
|
3138 -.ft C |
|
3139 +.ft |
|
3140 hg qgoto [OPTION]... PATCH |
|
3141 -.ft P |
|
3142 +.ft |
|
3143 .fi |
|
3144 .sp |
|
3145 Returns 0 on success. |
|
3146 @@ -6959,15 +6933,15 @@ |
|
3147 .SS qguard |
|
3148 .sp |
|
3149 .nf |
|
3150 -.ft C |
|
3151 +.ft |
|
3152 hg qguard [\-l] [\-n] [PATCH] [\-\- [+GUARD]... [\-GUARD]...] |
|
3153 -.ft P |
|
3154 +.ft |
|
3155 .fi |
|
3156 .sp |
|
3157 Guards control whether a patch can be pushed. A patch with no |
|
3158 guards is always pushed. A patch with a positive guard ("+foo") is |
|
3159 -pushed only if the \%\fBhg qselect\fP\: command has activated it. A patch with |
|
3160 -a negative guard ("\-foo") is never pushed if the \%\fBhg qselect\fP\: command |
|
3161 +pushed only if the \fBhg qselect\fP command has activated it. A patch with |
|
3162 +a negative guard ("\-foo") is never pushed if the \fBhg qselect\fP command |
|
3163 has activated it. |
|
3164 .sp |
|
3165 With no arguments, print the currently active guards. |
|
3166 @@ -6974,15 +6948,15 @@ |
|
3167 With arguments, set guards for the named patch. |
|
3168 .IP Note |
|
3169 . |
|
3170 -Specifying negative guards now requires \(aq\-\-\(aq. |
|
3171 +Specifying negative guards now requires '\-\-'. |
|
3172 .RE |
|
3173 .sp |
|
3174 To set guards on another patch: |
|
3175 .sp |
|
3176 .nf |
|
3177 -.ft C |
|
3178 +.ft |
|
3179 hg qguard other.patch \-\- +2.6.17 \-stable |
|
3180 -.ft P |
|
3181 +.ft |
|
3182 .fi |
|
3183 .sp |
|
3184 Returns 0 on success. |
|
3185 @@ -7001,9 +6975,9 @@ |
|
3186 .SS qheader |
|
3187 .sp |
|
3188 .nf |
|
3189 -.ft C |
|
3190 +.ft |
|
3191 hg qheader [PATCH] |
|
3192 -.ft P |
|
3193 +.ft |
|
3194 .fi |
|
3195 .sp |
|
3196 Returns 0 on success. |
|
3197 @@ -7010,9 +6984,9 @@ |
|
3198 .SS qimport |
|
3199 .sp |
|
3200 .nf |
|
3201 -.ft C |
|
3202 +.ft |
|
3203 hg qimport [\-e] [\-n NAME] [\-f] [\-g] [\-P] [\-r REV]... FILE... |
|
3204 -.ft P |
|
3205 +.ft |
|
3206 .fi |
|
3207 .sp |
|
3208 The patch is inserted into the series after the last applied |
|
3209 @@ -7042,9 +7016,9 @@ |
|
3210 To import an existing patch while renaming it: |
|
3211 .sp |
|
3212 .nf |
|
3213 -.ft C |
|
3214 +.ft |
|
3215 hg qimport \-e existing\-patch \-n new\-name |
|
3216 -.ft P |
|
3217 +.ft |
|
3218 .fi |
|
3219 .sp |
|
3220 Returns 0 if import succeeded. |
|
3221 @@ -7079,9 +7053,9 @@ |
|
3222 .SS qinit |
|
3223 .sp |
|
3224 .nf |
|
3225 -.ft C |
|
3226 +.ft |
|
3227 hg qinit [\-c] |
|
3228 -.ft P |
|
3229 +.ft |
|
3230 .fi |
|
3231 .sp |
|
3232 The queue repository is unversioned by default. If |
|
3233 @@ -7090,8 +7064,8 @@ |
|
3234 an unversioned patch repository into a versioned one). You can use |
|
3235 qcommit to commit changes to this queue repository. |
|
3236 .sp |
|
3237 -This command is deprecated. Without \-c, it\(aqs implied by other relevant |
|
3238 -commands. With \-c, use \%\fBhg init \-\-mq\fP\: instead. |
|
3239 +This command is deprecated. Without \-c, it's implied by other relevant |
|
3240 +commands. With \-c, use \fBhg init \-\-mq\fP instead. |
|
3241 .sp |
|
3242 Options: |
|
3243 .INDENT 0.0 |
|
3244 @@ -7103,9 +7077,9 @@ |
|
3245 .SS qnew |
|
3246 .sp |
|
3247 .nf |
|
3248 -.ft C |
|
3249 +.ft |
|
3250 hg qnew [\-e] [\-m TEXT] [\-l FILE] PATCH [FILE]... |
|
3251 -.ft P |
|
3252 +.ft |
|
3253 .fi |
|
3254 .sp |
|
3255 qnew creates a new patch on top of the currently\-applied patch (if |
|
3256 @@ -7121,7 +7095,7 @@ |
|
3257 .sp |
|
3258 \-e/\-\-edit, \-m/\-\-message or \-l/\-\-logfile set the patch header as |
|
3259 well as the commit message. If none is specified, the header is |
|
3260 -empty and the commit message is \(aq[mq]: PATCH\(aq. |
|
3261 +empty and the commit message is '[mq]: PATCH'. |
|
3262 .sp |
|
3263 Use the \-g/\-\-git option to keep the patch in the git extended diff |
|
3264 format. Read the diffs help topic for more information on why this |
|
3265 @@ -7180,9 +7154,9 @@ |
|
3266 .SS qnext |
|
3267 .sp |
|
3268 .nf |
|
3269 -.ft C |
|
3270 +.ft |
|
3271 hg qnext [\-s] |
|
3272 -.ft P |
|
3273 +.ft |
|
3274 .fi |
|
3275 .sp |
|
3276 Returns 0 on success. |
|
3277 @@ -7197,9 +7171,9 @@ |
|
3278 .SS qpop |
|
3279 .sp |
|
3280 .nf |
|
3281 -.ft C |
|
3282 +.ft |
|
3283 hg qpop [\-a] [\-f] [PATCH | INDEX] |
|
3284 -.ft P |
|
3285 +.ft |
|
3286 .fi |
|
3287 .sp |
|
3288 By default, pops off the top of the patch stack. If given a patch |
|
3289 @@ -7226,9 +7200,9 @@ |
|
3290 .SS qprev |
|
3291 .sp |
|
3292 .nf |
|
3293 -.ft C |
|
3294 +.ft |
|
3295 hg qprev [\-s] |
|
3296 -.ft P |
|
3297 +.ft |
|
3298 .fi |
|
3299 .sp |
|
3300 Returns 0 on success. |
|
3301 @@ -7243,9 +7217,9 @@ |
|
3302 .SS qpush |
|
3303 .sp |
|
3304 .nf |
|
3305 -.ft C |
|
3306 +.ft |
|
3307 hg qpush [\-f] [\-l] [\-a] [\-\-move] [PATCH | INDEX] |
|
3308 -.ft P |
|
3309 +.ft |
|
3310 .fi |
|
3311 .sp |
|
3312 When \-f/\-\-force is applied, all local changes in patched files |
|
3313 @@ -7287,9 +7261,9 @@ |
|
3314 .SS qqueue |
|
3315 .sp |
|
3316 .nf |
|
3317 -.ft C |
|
3318 +.ft |
|
3319 hg qqueue [OPTION] [QUEUE] |
|
3320 -.ft P |
|
3321 +.ft |
|
3322 .fi |
|
3323 .sp |
|
3324 Supports switching between different patch queues, as well as creating |
|
3325 @@ -7335,9 +7309,9 @@ |
|
3326 .SS qrefresh |
|
3327 .sp |
|
3328 .nf |
|
3329 -.ft C |
|
3330 +.ft |
|
3331 hg qrefresh [\-I] [\-X] [\-e] [\-m TEXT] [\-l FILE] [\-s] [FILE]... |
|
3332 -.ft P |
|
3333 +.ft |
|
3334 .fi |
|
3335 .sp |
|
3336 If any file patterns are provided, the refreshed patch will |
|
3337 @@ -7408,9 +7382,9 @@ |
|
3338 .SS qrename |
|
3339 .sp |
|
3340 .nf |
|
3341 -.ft C |
|
3342 +.ft |
|
3343 hg qrename PATCH1 [PATCH2] |
|
3344 -.ft P |
|
3345 +.ft |
|
3346 .fi |
|
3347 .sp |
|
3348 With one argument, renames the current patch to PATCH1. |
|
3349 @@ -7426,12 +7400,12 @@ |
|
3350 .SS qrestore |
|
3351 .sp |
|
3352 .nf |
|
3353 -.ft C |
|
3354 +.ft |
|
3355 hg qrestore [\-d] [\-u] REV |
|
3356 -.ft P |
|
3357 +.ft |
|
3358 .fi |
|
3359 .sp |
|
3360 -This command is deprecated, use \%\fBhg rebase\fP\: instead. |
|
3361 +This command is deprecated, use \fBhg rebase\fP instead. |
|
3362 .sp |
|
3363 Options: |
|
3364 .INDENT 0.0 |
|
3365 @@ -7447,12 +7421,12 @@ |
|
3366 .SS qsave |
|
3367 .sp |
|
3368 .nf |
|
3369 -.ft C |
|
3370 +.ft |
|
3371 hg qsave [\-m TEXT] [\-l FILE] [\-c] [\-n NAME] [\-e] [\-f] |
|
3372 -.ft P |
|
3373 +.ft |
|
3374 .fi |
|
3375 .sp |
|
3376 -This command is deprecated, use \%\fBhg rebase\fP\: instead. |
|
3377 +This command is deprecated, use \fBhg rebase\fP instead. |
|
3378 .sp |
|
3379 Options: |
|
3380 .INDENT 0.0 |
|
3381 @@ -7484,12 +7458,12 @@ |
|
3382 .SS qselect |
|
3383 .sp |
|
3384 .nf |
|
3385 -.ft C |
|
3386 +.ft |
|
3387 hg qselect [OPTION]... [GUARD]... |
|
3388 -.ft P |
|
3389 +.ft |
|
3390 .fi |
|
3391 .sp |
|
3392 -Use the \%\fBhg qguard\fP\: command to set or print guards on patch, then use |
|
3393 +Use the \fBhg qguard\fP command to set or print guards on patch, then use |
|
3394 qselect to tell mq which guards to use. A patch will be pushed if |
|
3395 it has no guards or any positive guards match the currently |
|
3396 selected guard, but will not be pushed if any negative guards |
|
3397 @@ -7496,11 +7470,11 @@ |
|
3398 match the current guard. For example: |
|
3399 .sp |
|
3400 .nf |
|
3401 -.ft C |
|
3402 +.ft |
|
3403 qguard foo.patch \-\- \-stable (negative guard) |
|
3404 qguard bar.patch +stable (positive guard) |
|
3405 qselect stable |
|
3406 -.ft P |
|
3407 +.ft |
|
3408 .fi |
|
3409 .sp |
|
3410 This activates the "stable" guard. mq will skip foo.patch (because |
|
3411 @@ -7547,9 +7521,9 @@ |
|
3412 .SS qseries |
|
3413 .sp |
|
3414 .nf |
|
3415 -.ft C |
|
3416 +.ft |
|
3417 hg qseries [\-ms] |
|
3418 -.ft P |
|
3419 +.ft |
|
3420 .fi |
|
3421 .sp |
|
3422 Returns 0 on success. |
|
3423 @@ -7568,9 +7542,9 @@ |
|
3424 .SS qtop |
|
3425 .sp |
|
3426 .nf |
|
3427 -.ft C |
|
3428 +.ft |
|
3429 hg qtop [\-s] |
|
3430 -.ft P |
|
3431 +.ft |
|
3432 .fi |
|
3433 .sp |
|
3434 Returns 0 on success. |
|
3435 @@ -7585,9 +7559,9 @@ |
|
3436 .SS qunapplied |
|
3437 .sp |
|
3438 .nf |
|
3439 -.ft C |
|
3440 +.ft |
|
3441 hg qunapplied [\-1] [\-s] [PATCH] |
|
3442 -.ft P |
|
3443 +.ft |
|
3444 .fi |
|
3445 .sp |
|
3446 Returns 0 on success. |
|
3447 @@ -7606,9 +7580,9 @@ |
|
3448 .SS strip |
|
3449 .sp |
|
3450 .nf |
|
3451 -.ft C |
|
3452 +.ft |
|
3453 hg strip [\-k] [\-f] [\-n] REV... |
|
3454 -.ft P |
|
3455 +.ft |
|
3456 .fi |
|
3457 .sp |
|
3458 The strip command removes the specified changesets and all their |
|
3459 @@ -7621,8 +7595,8 @@ |
|
3460 completes. |
|
3461 .sp |
|
3462 Any stripped changesets are stored in \fB.hg/strip\-backup\fP as a |
|
3463 -bundle (see \%\fBhg help bundle\fP\: and \%\fBhg help unbundle\fP\:). They can |
|
3464 -be restored by running \%\fBhg unbundle .hg/strip\-backup/BUNDLE\fP\:, |
|
3465 +bundle (see \fBhg help bundle\fP and \fBhg help unbundle\fP). They can |
|
3466 +be restored by running \fBhg unbundle .hg/strip\-backup/BUNDLE\fP, |
|
3467 where BUNDLE is the bundle file created by the strip. Note that |
|
3468 the local revision numbers will in general be different after the |
|
3469 restore. |
|
3470 @@ -7666,7 +7640,7 @@ |
|
3471 this: |
|
3472 .sp |
|
3473 .nf |
|
3474 -.ft C |
|
3475 +.ft |
|
3476 [extensions] |
|
3477 notify = |
|
3478 |
|
3479 @@ -7678,21 +7652,21 @@ |
|
3480 |
|
3481 [notify] |
|
3482 # config items go here |
|
3483 -.ft P |
|
3484 +.ft |
|
3485 .fi |
|
3486 .sp |
|
3487 Required configuration items: |
|
3488 .sp |
|
3489 .nf |
|
3490 -.ft C |
|
3491 +.ft |
|
3492 config = /path/to/file # file containing subscriptions |
|
3493 -.ft P |
|
3494 +.ft |
|
3495 .fi |
|
3496 .sp |
|
3497 Optional configuration items: |
|
3498 .sp |
|
3499 .nf |
|
3500 -.ft C |
|
3501 +.ft |
|
3502 test = True # print messages to stdout for testing |
|
3503 strip = 3 # number of slashes to strip for url paths |
|
3504 domain = example.com # domain to use if committer missing domain |
|
3505 @@ -7710,7 +7684,7 @@ |
|
3506 from = [email protected] # email address to send as if none given |
|
3507 [web] |
|
3508 baseurl = http://hgserver/... # root of hg web site for browsing commits |
|
3509 -.ft P |
|
3510 +.ft |
|
3511 .fi |
|
3512 .sp |
|
3513 The notify config file has same format as a regular hgrc file. It has |
|
3514 @@ -7718,7 +7692,7 @@ |
|
3515 handier for you. |
|
3516 .sp |
|
3517 .nf |
|
3518 -.ft C |
|
3519 +.ft |
|
3520 [usersubs] |
|
3521 # key is subscriber email, value is ","\-separated list of glob patterns |
|
3522 user@host = pattern |
|
3523 @@ -7726,7 +7700,7 @@ |
|
3524 [reposubs] |
|
3525 # key is glob pattern, value is ","\-separated list of subscriber emails |
|
3526 pattern = user@host |
|
3527 -.ft P |
|
3528 +.ft |
|
3529 .fi |
|
3530 .sp |
|
3531 Glob patterns are matched against path to repository root. |
|
3532 @@ -7740,10 +7714,10 @@ |
|
3533 To set the pager that should be used, set the application variable: |
|
3534 .sp |
|
3535 .nf |
|
3536 -.ft C |
|
3537 +.ft |
|
3538 [pager] |
|
3539 pager = less \-FRSX |
|
3540 -.ft P |
|
3541 +.ft |
|
3542 .fi |
|
3543 .sp |
|
3544 If no pager is set, the pager extensions uses the environment variable |
|
3545 @@ -7753,10 +7727,10 @@ |
|
3546 setting: |
|
3547 .sp |
|
3548 .nf |
|
3549 -.ft C |
|
3550 +.ft |
|
3551 [pager] |
|
3552 quiet = True |
|
3553 -.ft P |
|
3554 +.ft |
|
3555 .fi |
|
3556 .sp |
|
3557 You can disable the pager for certain commands by adding them to the |
|
3558 @@ -7763,10 +7737,10 @@ |
|
3559 pager.ignore list: |
|
3560 .sp |
|
3561 .nf |
|
3562 -.ft C |
|
3563 +.ft |
|
3564 [pager] |
|
3565 ignore = version, help, update |
|
3566 -.ft P |
|
3567 +.ft |
|
3568 .fi |
|
3569 .sp |
|
3570 You can also enable the pager only for certain commands using |
|
3571 @@ -7773,10 +7747,10 @@ |
|
3572 pager.attend. Below is the default list of commands to be paged: |
|
3573 .sp |
|
3574 .nf |
|
3575 -.ft C |
|
3576 +.ft |
|
3577 [pager] |
|
3578 attend = annotate, cat, diff, export, glog, log, qdiff |
|
3579 -.ft P |
|
3580 +.ft |
|
3581 .fi |
|
3582 .sp |
|
3583 Setting pager.attend to an empty value will cause all commands to be |
|
3584 @@ -7784,7 +7758,7 @@ |
|
3585 .sp |
|
3586 If pager.attend is present, pager.ignore will be ignored. |
|
3587 .sp |
|
3588 -To ignore global commands like \%\fBhg version\fP\: or \%\fBhg help\fP\:, you have |
|
3589 +To ignore global commands like \fBhg version\fP or \fBhg help\fP, you have |
|
3590 to specify them in your user configuration file. |
|
3591 .sp |
|
3592 The \-\-pager=... option can also be used to control when the pager is |
|
3593 @@ -7800,7 +7774,7 @@ |
|
3594 For example, if you can refer to a revision as "foo", then: |
|
3595 .sp |
|
3596 .nf |
|
3597 -.ft C |
|
3598 +.ft |
|
3599 foo^N = Nth parent of foo |
|
3600 foo^0 = foo |
|
3601 foo^1 = first parent of foo |
|
3602 @@ -7811,7 +7785,7 @@ |
|
3603 foo~0 = foo |
|
3604 foo~1 = foo^1 = foo^ = first parent of foo |
|
3605 foo~2 = foo^1^1 = foo^^ = first parent of first parent of foo |
|
3606 -.ft P |
|
3607 +.ft |
|
3608 .fi |
|
3609 .SS patchbomb |
|
3610 .sp |
|
3611 @@ -7832,7 +7806,7 @@ |
|
3612 [Optional] The result of running diffstat on the patch. |
|
3613 .IP \(bu 2 |
|
3614 . |
|
3615 -The patch itself, as generated by \%\fBhg export\fP\:. |
|
3616 +The patch itself, as generated by \fBhg export\fP. |
|
3617 .UNINDENT |
|
3618 .sp |
|
3619 Each message refers to the first in the series using the In\-Reply\-To |
|
3620 @@ -7843,7 +7817,7 @@ |
|
3621 configuration file: |
|
3622 .sp |
|
3623 .nf |
|
3624 -.ft C |
|
3625 +.ft |
|
3626 [email] |
|
3627 from = My Name <my@email> |
|
3628 to = recipient1, recipient2, ... |
|
3629 @@ -7850,13 +7824,13 @@ |
|
3630 cc = cc1, cc2, ... |
|
3631 bcc = bcc1, bcc2, ... |
|
3632 reply\-to = address1, address2, ... |
|
3633 -.ft P |
|
3634 +.ft |
|
3635 .fi |
|
3636 .sp |
|
3637 Use \fB[patchbomb]\fP as configuration section name if you need to |
|
3638 override global \fB[email]\fP address settings. |
|
3639 .sp |
|
3640 -Then you can use the \%\fBhg email\fP\: command to mail a series of |
|
3641 +Then you can use the \fBhg email\fP command to mail a series of |
|
3642 changesets as a patchbomb. |
|
3643 .sp |
|
3644 You can also either configure the method option in the email section |
|
3645 @@ -7868,13 +7842,13 @@ |
|
3646 .SS email |
|
3647 .sp |
|
3648 .nf |
|
3649 -.ft C |
|
3650 +.ft |
|
3651 hg email [OPTION]... [DEST]... |
|
3652 -.ft P |
|
3653 +.ft |
|
3654 .fi |
|
3655 .sp |
|
3656 By default, diffs are sent in the format generated by |
|
3657 -\%\fBhg export\fP\:, one per message. The series starts with a "[PATCH 0 |
|
3658 +\fBhg export\fP, one per message. The series starts with a "[PATCH 0 |
|
3659 of N]" introduction, which describes the series as a whole. |
|
3660 .sp |
|
3661 Each patch email has a Subject line of "[PATCH M of N] ...", using |
|
3662 @@ -7885,7 +7859,7 @@ |
|
3663 With the \-d/\-\-diffstat option, if the diffstat program is |
|
3664 installed, the result of running diffstat on the patch is inserted. |
|
3665 .sp |
|
3666 -Finally, the patch itself, as generated by \%\fBhg export\fP\:. |
|
3667 +Finally, the patch itself, as generated by \fBhg export\fP. |
|
3668 .sp |
|
3669 With the \-d/\-\-diffstat or \-c/\-\-confirm options, you will be presented |
|
3670 with a final summary of all messages and asked for confirmation before |
|
3671 @@ -7923,7 +7897,7 @@ |
|
3672 Examples: |
|
3673 .sp |
|
3674 .nf |
|
3675 -.ft C |
|
3676 +.ft |
|
3677 hg email \-r 3000 # send patch 3000 only |
|
3678 hg email \-r 3000 \-r 3001 # send patches 3000 and 3001 |
|
3679 hg email \-r 3000:3005 # send patches 3000 through 3005 |
|
3680 @@ -7944,7 +7918,7 @@ |
|
3681 hg email \-o \-m mbox && # generate an mbox file ... |
|
3682 formail \-s sendmail \e # ... and use formail to send from the mbox |
|
3683 \-bm \-t < mbox # ... using sendmail |
|
3684 -.ft P |
|
3685 +.ft |
|
3686 .fi |
|
3687 .sp |
|
3688 Before using this command, you will need to enable email in your |
|
3689 @@ -8077,7 +8051,7 @@ |
|
3690 The following settings are available: |
|
3691 .sp |
|
3692 .nf |
|
3693 -.ft C |
|
3694 +.ft |
|
3695 [progress] |
|
3696 delay = 3 # number of seconds (float) before showing the progress bar |
|
3697 refresh = 0.1 # time in seconds between refreshes of the progress bar |
|
3698 @@ -8084,11 +8058,11 @@ |
|
3699 format = topic bar number estimate # format of the progress bar |
|
3700 width = <none> # if set, the maximum width of the progress information |
|
3701 # (that is, min(width, term width) will be used) |
|
3702 -clear\-complete = True # clear the progress bar after it\(aqs done |
|
3703 -disable = False # if true, don\(aqt show a progress bar |
|
3704 +clear\-complete = True # clear the progress bar after it's done |
|
3705 +disable = False # if true, don't show a progress bar |
|
3706 assume\-tty = False # if true, ALWAYS show a progress bar, unless |
|
3707 # disable is given |
|
3708 -.ft P |
|
3709 +.ft |
|
3710 .fi |
|
3711 .sp |
|
3712 Valid entries for the format field are topic, bar, number, unit, |
|
3713 @@ -8103,9 +8077,9 @@ |
|
3714 .SS purge |
|
3715 .sp |
|
3716 .nf |
|
3717 -.ft C |
|
3718 +.ft |
|
3719 hg purge [OPTION]... [DIR]... |
|
3720 -.ft P |
|
3721 +.ft |
|
3722 .fi |
|
3723 .sp |
|
3724 Delete files not known to Mercurial. This is useful to test local |
|
3725 @@ -8115,7 +8089,7 @@ |
|
3726 .INDENT 0.0 |
|
3727 .IP \(bu 2 |
|
3728 . |
|
3729 -Unknown files: files marked with "?" by \%\fBhg status\fP\: |
|
3730 +Unknown files: files marked with "?" by \fBhg status\fP |
|
3731 .IP \(bu 2 |
|
3732 . |
|
3733 Empty directories: in fact Mercurial ignores directories unless |
|
3734 @@ -8132,7 +8106,7 @@ |
|
3735 Ignored files (unless \-\-all is specified) |
|
3736 .IP \(bu 2 |
|
3737 . |
|
3738 -New files added to the repository (with \%\fBhg add\fP\:) |
|
3739 +New files added to the repository (with \fBhg add\fP) |
|
3740 .UNINDENT |
|
3741 .sp |
|
3742 If directories are given on the command line, only files in these |
|
3743 @@ -8180,15 +8154,15 @@ |
|
3744 repository. |
|
3745 .sp |
|
3746 For more information: |
|
3747 -\%http://mercurial.selenic.com/wiki/RebaseExtension\: |
|
3748 +http://mercurial.selenic.com/wiki/RebaseExtension |
|
3749 .SS Commands |
|
3750 .SS rebase |
|
3751 .sp |
|
3752 .nf |
|
3753 -.ft C |
|
3754 +.ft |
|
3755 hg rebase [\-s REV | \-b REV] [\-d REV] [options] |
|
3756 hg rebase {\-a|\-c} |
|
3757 -.ft P |
|
3758 +.ft |
|
3759 .fi |
|
3760 .sp |
|
3761 Rebase uses repeated merging to graft changesets from one part of |
|
3762 @@ -8201,7 +8175,7 @@ |
|
3763 same rebase or they will end up with duplicated changesets after |
|
3764 pulling in your rebased changesets. |
|
3765 .sp |
|
3766 -If you don\(aqt specify a destination changeset (\fB\-d/\-\-dest\fP), |
|
3767 +If you don't specify a destination changeset (\fB\-d/\-\-dest\fP), |
|
3768 rebase uses the tipmost head of the current named branch as the |
|
3769 destination. (The destination changeset is not modified by |
|
3770 rebasing, but new changesets are added as its descendants.) |
|
3771 @@ -8228,7 +8202,7 @@ |
|
3772 and source branch is that, unlike \fBmerge\fP, rebase will do |
|
3773 nothing if you are at the latest (tipmost) head of a named branch |
|
3774 with two heads. You need to explicitly specify source and/or |
|
3775 -destination (or \fBupdate\fP to the other head, if it\(aqs the head of |
|
3776 +destination (or \fBupdate\fP to the other head, if it's the head of |
|
3777 the intended source branch). |
|
3778 .sp |
|
3779 If a rebase is interrupted to manually resolve a merge, it can be |
|
3780 @@ -8290,15 +8264,15 @@ |
|
3781 .SS record |
|
3782 .sp |
|
3783 .nf |
|
3784 -.ft C |
|
3785 +.ft |
|
3786 hg record [OPTION]... [FILE]... |
|
3787 -.ft P |
|
3788 +.ft |
|
3789 .fi |
|
3790 .sp |
|
3791 -If a list of files is omitted, all changes reported by \%\fBhg status\fP\: |
|
3792 +If a list of files is omitted, all changes reported by \fBhg status\fP |
|
3793 will be candidates for recording. |
|
3794 .sp |
|
3795 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date. |
|
3796 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date. |
|
3797 .sp |
|
3798 You will be prompted for whether to record changes to each |
|
3799 modified file, and for files with multiple changes, for each |
|
3800 @@ -8306,7 +8280,7 @@ |
|
3801 possible: |
|
3802 .sp |
|
3803 .nf |
|
3804 -.ft C |
|
3805 +.ft |
|
3806 y \- record this change |
|
3807 n \- skip this change |
|
3808 |
|
3809 @@ -8318,7 +8292,7 @@ |
|
3810 q \- quit, recording no changes |
|
3811 |
|
3812 ? \- display help |
|
3813 -.ft P |
|
3814 +.ft |
|
3815 .fi |
|
3816 .sp |
|
3817 This command is not available when committing a merge. |
|
3818 @@ -8365,9 +8339,9 @@ |
|
3819 .SS relink |
|
3820 .sp |
|
3821 .nf |
|
3822 -.ft C |
|
3823 +.ft |
|
3824 hg relink [ORIGIN] |
|
3825 -.ft P |
|
3826 +.ft |
|
3827 .fi |
|
3828 .sp |
|
3829 When repositories are cloned locally, their data files will be |
|
3830 @@ -8399,18 +8373,18 @@ |
|
3831 lot of repositories to act like a scheme, for example: |
|
3832 .sp |
|
3833 .nf |
|
3834 -.ft C |
|
3835 +.ft |
|
3836 [schemes] |
|
3837 py = http://code.python.org/hg/ |
|
3838 -.ft P |
|
3839 +.ft |
|
3840 .fi |
|
3841 .sp |
|
3842 After that you can use it like: |
|
3843 .sp |
|
3844 .nf |
|
3845 -.ft C |
|
3846 +.ft |
|
3847 hg clone py://trunk/ |
|
3848 -.ft P |
|
3849 +.ft |
|
3850 .fi |
|
3851 .sp |
|
3852 Additionally there is support for some more complex schemas, for |
|
3853 @@ -8417,10 +8391,10 @@ |
|
3854 example used by Google Code: |
|
3855 .sp |
|
3856 .nf |
|
3857 -.ft C |
|
3858 +.ft |
|
3859 [schemes] |
|
3860 gcode = http://{1}.googlecode.com/hg/ |
|
3861 -.ft P |
|
3862 +.ft |
|
3863 .fi |
|
3864 .sp |
|
3865 The syntax is taken from Mercurial templates, and you have unlimited |
|
3866 @@ -8432,7 +8406,7 @@ |
|
3867 For convenience, the extension adds these schemes by default: |
|
3868 .sp |
|
3869 .nf |
|
3870 -.ft C |
|
3871 +.ft |
|
3872 [schemes] |
|
3873 py = http://hg.python.org/ |
|
3874 bb = https://bitbucket.org/ |
|
3875 @@ -8439,7 +8413,7 @@ |
|
3876 bb+ssh = ssh://[email protected]/ |
|
3877 gcode = https://{1}.googlecode.com/hg/ |
|
3878 kiln = https://{1}.kilnhg.com/Repo/ |
|
3879 -.ft P |
|
3880 +.ft |
|
3881 .fi |
|
3882 .sp |
|
3883 You can override a predefined scheme by defining a new scheme with the |
|
3884 @@ -8451,9 +8425,9 @@ |
|
3885 .SS share |
|
3886 .sp |
|
3887 .nf |
|
3888 -.ft C |
|
3889 +.ft |
|
3890 hg share [\-U] SOURCE [DEST] |
|
3891 -.ft P |
|
3892 +.ft |
|
3893 .fi |
|
3894 .sp |
|
3895 Initialize a new repository and working directory that shares its |
|
3896 @@ -8490,9 +8464,9 @@ |
|
3897 .SS transplant |
|
3898 .sp |
|
3899 .nf |
|
3900 -.ft C |
|
3901 +.ft |
|
3902 hg transplant [\-s REPO] [\-b BRANCH [\-a]] [\-p REV] [\-m REV] [REV]... |
|
3903 -.ft P |
|
3904 +.ft |
|
3905 .fi |
|
3906 .sp |
|
3907 Selected changesets will be applied on top of the current working |
|
3908 @@ -8505,9 +8479,9 @@ |
|
3909 of the form: |
|
3910 .sp |
|
3911 .nf |
|
3912 -.ft C |
|
3913 +.ft |
|
3914 (transplanted from CHANGESETHASH) |
|
3915 -.ft P |
|
3916 +.ft |
|
3917 .fi |
|
3918 .sp |
|
3919 You can rewrite the changelog message with the \-\-filter option. |
|
3920 @@ -8521,7 +8495,7 @@ |
|
3921 transplanted, otherwise you will be prompted to select the |
|
3922 changesets you want. |
|
3923 .sp |
|
3924 -\%\fBhg transplant \-\-branch REVISION \-\-all\fP\: will transplant the |
|
3925 +\fBhg transplant \-\-branch REVISION \-\-all\fP\: will transplant the |
|
3926 selected branch (up to the named revision) onto your current |
|
3927 working directory. |
|
3928 .sp |
|
3929 @@ -8530,12 +8504,12 @@ |
|
3930 of a merged transplant, and you can merge descendants of them |
|
3931 normally instead of transplanting them. |
|
3932 .sp |
|
3933 -If no merges or revisions are provided, \%\fBhg transplant\fP\: will |
|
3934 +If no merges or revisions are provided, \fBhg transplant\fP will |
|
3935 start an interactive changeset browser. |
|
3936 .sp |
|
3937 If a changeset application fails, you can fix the merge by hand |
|
3938 -and then resume where you left off by calling \%\fBhg transplant |
|
3939 -\-\-continue/\-c\fP\:. |
|
3940 +and then resume where you left off by calling \fBhg transplant |
|
3941 +\-\-continue/\-c\fP. |
|
3942 .sp |
|
3943 Options: |
|
3944 .INDENT 0.0 |
|
3945 @@ -8624,10 +8598,10 @@ |
|
3946 You can specify the encoding by config option: |
|
3947 .sp |
|
3948 .nf |
|
3949 -.ft C |
|
3950 +.ft |
|
3951 [win32mbcs] |
|
3952 encoding = sjis |
|
3953 -.ft P |
|
3954 +.ft |
|
3955 .fi |
|
3956 .sp |
|
3957 It is useful for the users who want to commit with UTF\-8 log message. |
|
3958 @@ -8650,7 +8624,7 @@ |
|
3959 To perform automatic newline conversion, use: |
|
3960 .sp |
|
3961 .nf |
|
3962 -.ft C |
|
3963 +.ft |
|
3964 [extensions] |
|
3965 win32text = |
|
3966 [encode] |
|
3967 @@ -8660,17 +8634,17 @@ |
|
3968 [decode] |
|
3969 ** = cleverdecode: |
|
3970 # or ** = macdecode: |
|
3971 -.ft P |
|
3972 +.ft |
|
3973 .fi |
|
3974 .sp |
|
3975 If not doing conversion, to make sure you do not commit CRLF/CR by accident: |
|
3976 .sp |
|
3977 .nf |
|
3978 -.ft C |
|
3979 +.ft |
|
3980 [hooks] |
|
3981 pretxncommit.crlf = python:hgext.win32text.forbidcrlf |
|
3982 # or pretxncommit.cr = python:hgext.win32text.forbidcr |
|
3983 -.ft P |
|
3984 +.ft |
|
3985 .fi |
|
3986 .sp |
|
3987 To do the same check on a server to prevent CRLF/CR from being |
|
3988 @@ -8677,11 +8651,11 @@ |
|
3989 pushed or pulled: |
|
3990 .sp |
|
3991 .nf |
|
3992 -.ft C |
|
3993 +.ft |
|
3994 [hooks] |
|
3995 pretxnchangegroup.crlf = python:hgext.win32text.forbidcrlf |
|
3996 # or pretxnchangegroup.cr = python:hgext.win32text.forbidcr |
|
3997 -.ft P |
|
3998 +.ft |
|
3999 .fi |
|
4000 .SS zeroconf |
|
4001 .sp |
|
4002 @@ -8692,23 +8666,23 @@ |
|
4003 without knowing their actual IP address. |
|
4004 .sp |
|
4005 To allow other people to discover your repository using run |
|
4006 -\%\fBhg serve\fP\: in your repository: |
|
4007 +\fBhg serve\fP in your repository: |
|
4008 .sp |
|
4009 .nf |
|
4010 -.ft C |
|
4011 +.ft |
|
4012 $ cd test |
|
4013 $ hg serve |
|
4014 -.ft P |
|
4015 +.ft |
|
4016 .fi |
|
4017 .sp |
|
4018 You can discover Zeroconf\-enabled repositories by running |
|
4019 -\%\fBhg paths\fP\:: |
|
4020 +\fBhg paths\fP: |
|
4021 .sp |
|
4022 .nf |
|
4023 -.ft C |
|
4024 +.ft |
|
4025 $ hg paths |
|
4026 zc\-test = http://example.com:8000/test |
|
4027 -.ft P |
|
4028 +.ft |
|
4029 .fi |
|
4030 .SH FILES |
|
4031 .INDENT 0.0 |
|
4032 @@ -8717,7 +8691,7 @@ |
|
4033 .sp |
|
4034 This file contains regular expressions (one per line) that |
|
4035 describe file names that should be ignored by \fBhg\fP. For details, |
|
4036 -see \%\fBhgignore\fP(5)\:. |
|
4037 +see \fBhgignore\fP(5). |
|
4038 .TP |
|
4039 .B \fB.hgtags\fP |
|
4040 .sp |
|
4041 @@ -8730,7 +8704,7 @@ |
|
4042 This file contains defaults and configuration. Values in |
|
4043 \fB.hg/hgrc\fP override those in \fB$HOME/.hgrc\fP, and these override |
|
4044 settings made in the global \fB/etc/mercurial/hgrc\fP configuration. |
|
4045 -See \%\fBhgrc\fP(5)\: for details of the contents and format of these |
|
4046 +See \fBhgrc\fP(5) for details of the contents and format of these |
|
4047 files. |
|
4048 .UNINDENT |
|
4049 .sp |
|
4050 @@ -8737,23 +8711,28 @@ |
|
4051 Some commands (e.g. revert) produce backup files ending in \fB.orig\fP, |
|
4052 if the \fB.orig\fP file already exists and is not tracked by Mercurial, |
|
4053 it will be overwritten. |
16 +.TP |
4054 +.TP |
17 +/usr/demo/mercurial |
4055 +.B /usr/demo/mercurial |
18 +This directory contains assorted files which are part of the Mercurial |
4056 +This directory contains assorted files which are part of the Mercurial |
19 +distribution, but not core to its functionality&. They will generally |
4057 +distribution, but not core to its functionality. They will generally |
20 +need to be copied elsewhere to be of use. |
4058 +need to be copied elsewhere to be of use. |
21 + |
4059 .SH BUGS |
22 .SH "BUGS" |
4060 .sp |
23 .sp |
4061 -Probably lots, please post them to the mailing list (see \%Resources\: |
24 Probably lots, please post them to the mailing list (See Resources below) when you find them\&. |
4062 +Probably lots, please post them to the mailing list (see Resources |
25 --- mercurial-1.3.1/doc/hgrc.5 Thu Jul 23 10:58:38 2009 |
4063 below) when you find them. |
26 +++ /usr/share/man/man5/hgrc.5 Tue Feb 19 05:28:30 2002 |
4064 .SH SEE ALSO |
27 @@ -27,7 +32,7 @@ |
4065 .sp |
28 .sp |
4066 -\%\fBhgignore\fP(5)\:, \%\fBhgrc\fP(5)\: |
29 Mercurial reads configuration data from several files, if they exist\&. The names of these files depend on the system on which Mercurial is installed\&. *\&.rc files from a single directory are read in alphabetical order, later ones overriding earlier ones\&. Where multiple paths are given below, settings from later paths override earlier ones\&. |
4067 +\fBhgignore\fP(5), \fBhgrc\fP(5) |
30 .PP |
4068 .SH AUTHOR |
31 -(Unix) <install\-root>/etc/mercurial/hgrc\&.d/*\&.rc, (Unix) <install\-root>/etc/mercurial/hgrc |
4069 .sp |
32 +<install\-root>/etc/mercurial/hgrc\&.d/*\&.rc, <install\-root>/etc/mercurial/hgrc |
4070 -Written by Matt Mackall <\%[email protected]\:> |
33 .RS 4 |
4071 +Written by Matt Mackall <[email protected]> |
34 Per\-installation configuration files, searched for in the directory where Mercurial is installed\&. |
4072 .SH RESOURCES |
35 <install\-root> |
4073 .sp |
36 @@ -36,12 +41,12 @@ |
4074 -Main Web Site: \%http://mercurial.selenic.com/\: |
37 /shared/tools/etc/mercurial/hgrc\&. Options in these files apply to all Mercurial commands executed by any user in any directory\&. |
4075 +Main Web Site: http://mercurial.selenic.com/ |
|
4076 .sp |
|
4077 -Source code repository: \%http://selenic.com/hg\: |
|
4078 +Source code repository: http://selenic.com/hg |
|
4079 .sp |
|
4080 -Mailing list: \%http://selenic.com/mailman/listinfo/mercurial\: |
|
4081 +Mailing list: http://selenic.com/mailman/listinfo/mercurial |
|
4082 .SH COPYING |
|
4083 .sp |
|
4084 Copyright (C) 2005\-2010 Matt Mackall. |
|
4085 --- mercurial-1.8/doc/hgignore.5 Tue Mar 1 14:01:42 2011 |
|
4086 +++ mercurial-1.8/doc/hgignore.5 Mon Mar 7 21:16:24 2011 |
|
4087 @@ -1,35 +1,9 @@ |
|
4088 +'\" t |
|
4089 .\" Man page generated from reStructeredText. |
|
4090 . |
|
4091 .TH HGIGNORE 5 "" "" "Mercurial Manual" |
|
4092 .SH NAME |
|
4093 hgignore \- syntax for Mercurial ignore files |
|
4094 -. |
|
4095 -.nr rst2man-indent-level 0 |
|
4096 -. |
|
4097 -.de1 rstReportMargin |
|
4098 -\\$1 \\n[an-margin] |
|
4099 -level \\n[rst2man-indent-level] |
|
4100 -level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] |
|
4101 -- |
|
4102 -\\n[rst2man-indent0] |
|
4103 -\\n[rst2man-indent1] |
|
4104 -\\n[rst2man-indent2] |
|
4105 -.. |
|
4106 -.de1 INDENT |
|
4107 -.\" .rstReportMargin pre: |
|
4108 -. RS \\$1 |
|
4109 -. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] |
|
4110 -. nr rst2man-indent-level +1 |
|
4111 -.\" .rstReportMargin post: |
|
4112 -.. |
|
4113 -.de UNINDENT |
|
4114 -. RE |
|
4115 -.\" indent \\n[an-margin] |
|
4116 -.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] |
|
4117 -.nr rst2man-indent-level -1 |
|
4118 -.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] |
|
4119 -.in \\n[rst2man-indent\\n[rst2man-indent-level]]u |
|
4120 -.. |
|
4121 .SH SYNOPSIS |
|
4122 .sp |
|
4123 The Mercurial system uses a file called \fB.hgignore\fP in the root |
|
4124 @@ -54,12 +28,12 @@ |
|
4125 if any pattern in \fB.hgignore\fP matches \fBa/b/file.c\fP, \fBa/b\fP or \fBa\fP. |
|
4126 .sp |
|
4127 In addition, a Mercurial configuration file can reference a set of |
|
4128 -per\-user or global ignore files. See the \%\fBhgrc\fP(5)\: man page for details |
|
4129 +per\-user or global ignore files. See the \fBhgrc\fP(5) man page for details |
|
4130 of how to configure these files. Look for the "ignore" entry in the |
|
4131 "ui" section. |
|
4132 .sp |
|
4133 -To control Mercurial\(aqs handling of files that it manages, see the |
|
4134 -\%\fBhg\fP(1)\: man page. Look for the \fB\-I\fP and \fB\-X\fP options. |
|
4135 +To control Mercurial's handling of files that it manages, see the |
|
4136 +\fBhg\fP(1) man page. Look for the \fB\-I\fP and \fB\-X\fP options. |
|
4137 .SH SYNTAX |
|
4138 .sp |
|
4139 An ignore file is a plain text file consisting of a list of patterns, |
|
4140 @@ -73,9 +47,9 @@ |
|
4141 To change the syntax used, use a line of the following form: |
|
4142 .sp |
|
4143 .nf |
|
4144 -.ft C |
|
4145 +.ft |
|
4146 syntax: NAME |
|
4147 -.ft P |
|
4148 +.ft |
|
4149 .fi |
|
4150 .sp |
|
4151 where \fBNAME\fP is one of the following: |
|
4152 @@ -102,7 +76,7 @@ |
|
4153 Here is an example ignore file. |
|
4154 .sp |
|
4155 .nf |
|
4156 -.ft C |
|
4157 +.ft |
|
4158 # use glob syntax. |
|
4159 syntax: glob |
|
4160 |
|
4161 @@ -113,16 +87,16 @@ |
|
4162 # switch to regexp syntax. |
|
4163 syntax: regexp |
|
4164 ^\e.pc/ |
|
4165 -.ft P |
|
4166 +.ft |
|
4167 .fi |
|
4168 .SH AUTHOR |
|
4169 .sp |
|
4170 -Vadim Gelfer <\%[email protected]\:> |
|
4171 +Vadim Gelfer <[email protected]> |
|
4172 .sp |
|
4173 -Mercurial was written by Matt Mackall <\%[email protected]\:>. |
|
4174 +Mercurial was written by Matt Mackall <[email protected]>. |
|
4175 .SH SEE ALSO |
|
4176 .sp |
|
4177 -\%\fBhg\fP(1)\:, \%\fBhgrc\fP(5)\: |
|
4178 +\fBhg\fP(1), \fBhgrc\fP(5) |
|
4179 .SH COPYING |
|
4180 .sp |
|
4181 This manual page is copyright 2006 Vadim Gelfer. |
|
4182 --- mercurial-1.8.1/doc/hgrc.5 Thu Mar 10 09:30:43 2011 |
|
4183 +++ mercurial-1.8.1/doc/hgrc.5 Mon Mar 7 21:24:26 2011 |
|
4184 @@ -1,35 +1,9 @@ |
|
4185 +'\" t |
|
4186 .\" Man page generated from reStructeredText. |
|
4187 . |
|
4188 .TH HGRC 5 "" "" "Mercurial Manual" |
|
4189 .SH NAME |
|
4190 hgrc \- configuration files for Mercurial |
|
4191 -. |
|
4192 -.nr rst2man-indent-level 0 |
|
4193 -. |
|
4194 -.de1 rstReportMargin |
|
4195 -\\$1 \\n[an-margin] |
|
4196 -level \\n[rst2man-indent-level] |
|
4197 -level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] |
|
4198 -- |
|
4199 -\\n[rst2man-indent0] |
|
4200 -\\n[rst2man-indent1] |
|
4201 -\\n[rst2man-indent2] |
|
4202 -.. |
|
4203 -.de1 INDENT |
|
4204 -.\" .rstReportMargin pre: |
|
4205 -. RS \\$1 |
|
4206 -. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] |
|
4207 -. nr rst2man-indent-level +1 |
|
4208 -.\" .rstReportMargin post: |
|
4209 -.. |
|
4210 -.de UNINDENT |
|
4211 -. RE |
|
4212 -.\" indent \\n[an-margin] |
|
4213 -.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] |
|
4214 -.nr rst2man-indent-level -1 |
|
4215 -.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] |
|
4216 -.in \\n[rst2man-indent\\n[rst2man-indent-level]]u |
|
4217 -.. |
|
4218 .SH SYNOPSIS |
|
4219 .sp |
|
4220 The Mercurial system uses a set of configuration files to control |
|
4221 @@ -44,7 +18,7 @@ |
|
4222 ones. |
|
4223 .sp |
|
4224 .nf |
|
4225 -(Unix, Windows) \fB<repo>/.hg/hgrc\fP |
|
4226 +\fB<repo>/.hg/hgrc\fP |
|
4227 .fi |
|
4228 .sp |
|
4229 .INDENT 0.0 |
|
4230 @@ -53,35 +27,30 @@ |
|
4231 Per\-repository configuration options that only apply in a |
|
4232 particular repository. This file is not version\-controlled, and |
|
4233 will not get transferred during a "clone" operation. Options in |
|
4234 -this file override options in all other configuration files. On |
|
4235 -Unix, most of this file will be ignored if it doesn\(aqt belong to a |
|
4236 +this file override options in all other configuration files. |
|
4237 +Most of this file will be ignored if it doesn't belong to a |
|
4238 trusted user or to a trusted group. See the documentation for the |
|
4239 -\%trusted\: section below for more details. |
|
4240 +trusted section below for more details. |
|
4241 .UNINDENT |
|
4242 .UNINDENT |
|
4243 .sp |
|
4244 .nf |
|
4245 -(Unix) \fB$HOME/.hgrc\fP |
|
4246 -(Windows) \fB%USERPROFILE%\e.hgrc\fP |
|
4247 -(Windows) \fB%USERPROFILE%\eMercurial.ini\fP |
|
4248 -(Windows) \fB%HOME%\e.hgrc\fP |
|
4249 -(Windows) \fB%HOME%\eMercurial.ini\fP |
|
4250 +\fB$HOME/.hgrc\fP |
|
4251 .fi |
|
4252 .sp |
|
4253 .INDENT 0.0 |
|
4254 .INDENT 3.5 |
|
4255 .sp |
|
4256 -Per\-user configuration file(s), for the user running Mercurial. On |
|
4257 -Windows 9x, \fB%HOME%\fP is replaced by \fB%APPDATA%\fP. Options in these |
|
4258 -files apply to all Mercurial commands executed by this user in any |
|
4259 -directory. Options in these files override per\-system and per\-installation |
|
4260 -options. |
|
4261 +Per\-user configuration file(s), for the user running Mercurial. |
|
4262 +Options in this file apply to all Mercurial commands executed by this |
|
4263 +user in any directory. Options in this file override per\-system and |
|
4264 +per\-installation options. |
|
4265 .UNINDENT |
|
4266 .UNINDENT |
|
4267 .sp |
|
4268 .nf |
|
4269 -(Unix) \fB/etc/mercurial/hgrc\fP |
|
4270 -(Unix) \fB/etc/mercurial/hgrc.d/*.rc\fP |
|
4271 +\fB/etc/mercurial/hgrc\fP |
|
4272 +\fB/etc/mercurial/hgrc.d/*.rc\fP |
|
4273 .fi |
|
4274 .sp |
|
4275 .INDENT 0.0 |
|
4276 @@ -93,44 +62,6 @@ |
|
4277 override per\-installation options. |
|
4278 .UNINDENT |
|
4279 .UNINDENT |
|
4280 -.sp |
|
4281 -.nf |
|
4282 -(Unix) \fB<install\-root>/etc/mercurial/hgrc\fP |
|
4283 -(Unix) \fB<install\-root>/etc/mercurial/hgrc.d/*.rc\fP |
|
4284 -.fi |
|
4285 -.sp |
|
4286 -.INDENT 0.0 |
|
4287 -.INDENT 3.5 |
|
4288 -.sp |
|
4289 -Per\-installation configuration files, searched for in the |
|
4290 -directory where Mercurial is installed. \fB<install\-root>\fP is the |
|
4291 -parent directory of the \fBhg\fP executable (or symlink) being run. For |
|
4292 -example, if installed in \fB/shared/tools/bin/hg\fP, Mercurial will look |
|
4293 -in \fB/shared/tools/etc/mercurial/hgrc\fP. Options in these files apply |
|
4294 -to all Mercurial commands executed by any user in any directory. |
|
4295 -.UNINDENT |
|
4296 -.UNINDENT |
|
4297 -.sp |
|
4298 -.nf |
|
4299 -(Windows) \fB<install\-dir>\eMercurial.ini\fP |
|
4300 -(Windows) \fB<install\-dir>\ehgrc.d\e*.rc\fP |
|
4301 -(Windows) \fBHKEY_LOCAL_MACHINE\eSOFTWARE\eMercurial\fP |
|
4302 -.fi |
|
4303 -.sp |
|
4304 -.INDENT 0.0 |
|
4305 -.INDENT 3.5 |
|
4306 -.sp |
|
4307 -Per\-installation/system configuration files, for the system on |
|
4308 -which Mercurial is running. Options in these files apply to all |
|
4309 -Mercurial commands executed by any user in any directory. Registry |
|
4310 -keys contain PATH\-like strings, every part of which must reference |
|
4311 -a \fBMercurial.ini\fP file or be a directory where \fB*.rc\fP files will |
|
4312 -be read. Mercurial checks each of these locations in the specified |
|
4313 -order until one or more configuration files are detected. If the |
|
4314 -pywin32 extensions are not installed, Mercurial will only look for |
|
4315 -site\-wide configuration in \fBC:\eMercurial\eMercurial.ini\fP. |
|
4316 -.UNINDENT |
|
4317 -.UNINDENT |
|
4318 .SH SYNTAX |
|
4319 .sp |
|
4320 A configuration file consists of sections, led by a \fB[section]\fP header |
|
4321 @@ -138,12 +69,12 @@ |
|
4322 \fBconfiguration keys\fP): |
|
4323 .sp |
|
4324 .nf |
|
4325 -.ft C |
|
4326 +.ft |
|
4327 [spam] |
|
4328 eggs=ham |
|
4329 green= |
|
4330 eggs |
|
4331 -.ft P |
|
4332 +.ft |
|
4333 .fi |
|
4334 .sp |
|
4335 Each line contains one entry. If the lines that follow are indented, |
|
4336 @@ -155,12 +86,12 @@ |
|
4337 will use the value that was configured last. As an example: |
|
4338 .sp |
|
4339 .nf |
|
4340 -.ft C |
|
4341 +.ft |
|
4342 [spam] |
|
4343 eggs=large |
|
4344 ham=serrano |
|
4345 eggs=small |
|
4346 -.ft P |
|
4347 +.ft |
|
4348 .fi |
|
4349 .sp |
|
4350 This would set the configuration key named \fBeggs\fP to \fBsmall\fP. |
|
4351 @@ -169,7 +100,7 @@ |
|
4352 be redefined on the same and/or on different hgrc files. For example: |
|
4353 .sp |
|
4354 .nf |
|
4355 -.ft C |
|
4356 +.ft |
|
4357 [foo] |
|
4358 eggs=large |
|
4359 ham=serrano |
|
4360 @@ -184,7 +115,7 @@ |
|
4361 ham=prosciutto |
|
4362 eggs=medium |
|
4363 bread=toasted |
|
4364 -.ft P |
|
4365 +.ft |
|
4366 .fi |
|
4367 .sp |
|
4368 This would set the \fBeggs\fP, \fBham\fP, and \fBbread\fP configuration keys |
|
4369 @@ -206,9 +137,9 @@ |
|
4370 \fBfile\fP. This lets you do something like: |
|
4371 .sp |
|
4372 .nf |
|
4373 -.ft C |
|
4374 +.ft |
|
4375 %include ~/.hgrc.d/$HOST.rc |
|
4376 -.ft P |
|
4377 +.ft |
|
4378 .fi |
|
4379 .sp |
|
4380 to include a different configuration file on each computer you use. |
|
4381 @@ -225,9 +156,9 @@ |
|
4382 placed in double quotation marks: |
|
4383 .sp |
|
4384 .nf |
|
4385 -.ft C |
|
4386 +.ft |
|
4387 allow_read = "John Doe, PhD", brian, betty |
|
4388 -.ft P |
|
4389 +.ft |
|
4390 .fi |
|
4391 .sp |
|
4392 Quotation marks can be escaped by prefixing them with a backslash. Only |
|
4393 @@ -247,17 +178,17 @@ |
|
4394 Alias definitions consist of lines of the form: |
|
4395 .sp |
|
4396 .nf |
|
4397 -.ft C |
|
4398 +.ft |
|
4399 <alias> = <command> [<argument]... |
|
4400 -.ft P |
|
4401 +.ft |
|
4402 .fi |
|
4403 .sp |
|
4404 For example, this definition: |
|
4405 .sp |
|
4406 .nf |
|
4407 -.ft C |
|
4408 +.ft |
|
4409 latest = log \-\-limit 5 |
|
4410 -.ft P |
|
4411 +.ft |
|
4412 .fi |
|
4413 .sp |
|
4414 creates a new command \fBlatest\fP that shows only the five most recent |
|
4415 @@ -264,9 +195,9 @@ |
|
4416 changesets. You can define subsequent aliases using earlier ones: |
|
4417 .sp |
|
4418 .nf |
|
4419 -.ft C |
|
4420 +.ft |
|
4421 stable5 = latest \-b stable |
|
4422 -.ft P |
|
4423 +.ft |
|
4424 .fi |
|
4425 .IP Note |
|
4426 . |
|
4427 @@ -278,15 +209,15 @@ |
|
4428 .sp |
|
4429 Authentication credentials for HTTP authentication. This section |
|
4430 allows you to store usernames and passwords for use when logging |
|
4431 -\fIinto\fP HTTP servers. See the \%web\: configuration section if you want to |
|
4432 +\fIinto\fP HTTP servers. See the web configuration section if you want to |
|
4433 configure \fIwho\fP can login to your HTTP server. |
|
4434 .sp |
|
4435 Each line has the following format: |
|
4436 .sp |
|
4437 .nf |
|
4438 -.ft C |
|
4439 +.ft |
|
4440 <name>.<argument> = <value> |
|
4441 -.ft P |
|
4442 +.ft |
|
4443 .fi |
|
4444 .sp |
|
4445 where \fB<name>\fP is used to group arguments into authentication |
|
4446 @@ -293,7 +224,7 @@ |
|
4447 entries. Example: |
|
4448 .sp |
|
4449 .nf |
|
4450 -.ft C |
|
4451 +.ft |
|
4452 foo.prefix = hg.intevation.org/mercurial |
|
4453 foo.username = foo |
|
4454 foo.password = bar |
|
4455 @@ -303,7 +234,7 @@ |
|
4456 bar.key = path/to/file.key |
|
4457 bar.cert = path/to/file.cert |
|
4458 bar.schemes = https |
|
4459 -.ft P |
|
4460 +.ft |
|
4461 .fi |
|
4462 .sp |
|
4463 Supported arguments: |
|
4464 @@ -314,7 +245,7 @@ |
|
4465 Either \fB*\fP or a URI prefix with or without the scheme part. |
|
4466 The authentication entry with the longest matching prefix is used |
|
4467 (where \fB*\fP matches everything and counts as a match of length |
|
4468 -1). If the prefix doesn\(aqt include a scheme, the match is performed |
|
4469 +1). If the prefix doesn't include a scheme, the match is performed |
|
4470 against the URI with its scheme stripped as well, and the schemes |
|
4471 argument, q.v., is then subsequently consulted. |
|
4472 .TP |
|
4473 @@ -344,7 +275,7 @@ |
|
4474 .B \fBschemes\fP |
|
4475 .sp |
|
4476 Optional. Space separated list of URI schemes to use this |
|
4477 -authentication entry with. Only used if the prefix doesn\(aqt include |
|
4478 +authentication entry with. Only used if the prefix doesn't include |
|
4479 a scheme. Supported schemes are http and https. They will match |
|
4480 static\-http and static\-https respectively, as well. |
|
4481 Default: https. |
|
4482 @@ -374,7 +305,7 @@ |
|
4483 Pipe example: |
|
4484 .sp |
|
4485 .nf |
|
4486 -.ft C |
|
4487 +.ft |
|
4488 [encode] |
|
4489 # uncompress gzip files on checkin to improve delta compression |
|
4490 # note: not necessarily a good idea, just an example |
|
4491 @@ -382,9 +313,9 @@ |
|
4492 |
|
4493 [decode] |
|
4494 # recompress gzip files when writing them to the working dir (we |
|
4495 -# can safely omit "pipe:", because it\(aqs the default) |
|
4496 +# can safely omit "pipe:", because it's the default) |
|
4497 *.gz = gzip |
|
4498 -.ft P |
|
4499 +.ft |
|
4500 .fi |
|
4501 .sp |
|
4502 A \fBtempfile:\fP command is a template. The string \fBINFILE\fP is replaced |
|
4503 @@ -392,12 +323,6 @@ |
|
4504 filtered by the command. The string \fBOUTFILE\fP is replaced with the name |
|
4505 of an empty temporary file, where the filtered data must be written by |
|
4506 the command. |
|
4507 -.IP Note |
|
4508 -. |
|
4509 -The tempfile mechanism is recommended for Windows systems, |
|
4510 -where the standard shell I/O redirection operators often have |
|
4511 -strange effects and may corrupt the contents of your files. |
|
4512 -.RE |
|
4513 .sp |
|
4514 This filter mechanism is used internally by the \fBeol\fP extension to |
|
4515 translate line ending characters between Windows (CRLF) and Unix (LF) |
|
4516 @@ -404,20 +329,20 @@ |
|
4517 format. We suggest you use the \fBeol\fP extension for convenience. |
|
4518 .SS \fBdefaults\fP |
|
4519 .sp |
|
4520 -(defaults are deprecated. Don\(aqt use them. Use aliases instead) |
|
4521 +(defaults are deprecated. Don't use them. Use aliases instead) |
|
4522 .sp |
|
4523 Use the \fB[defaults]\fP section to define command defaults, i.e. the |
|
4524 default options/arguments to pass to the specified commands. |
|
4525 .sp |
|
4526 -The following example makes \%\fBhg log\fP\: run in verbose mode, and |
|
4527 -\%\fBhg status\fP\: show only the modified files, by default: |
|
4528 +The following example makes \fBhg log\fP run in verbose mode, and |
|
4529 +\fBhg status\fP show only the modified files, by default: |
|
4530 .sp |
|
4531 .nf |
|
4532 -.ft C |
|
4533 +.ft |
|
4534 [defaults] |
|
4535 log = \-v |
|
4536 status = \-m |
|
4537 -.ft P |
|
4538 +.ft |
|
4539 .fi |
|
4540 .sp |
|
4541 The actual commands, instead of their aliases, must be used when |
|
4542 @@ -435,7 +360,7 @@ |
|
4543 .TP |
|
4544 .B \fBnodates\fP |
|
4545 .sp |
|
4546 -Don\(aqt include dates in diff headers. |
|
4547 +Don't include dates in diff headers. |
|
4548 .TP |
|
4549 .B \fBshowfunc\fP |
|
4550 .sp |
|
4551 @@ -469,22 +394,22 @@ |
|
4552 .TP |
|
4553 .B \fBto\fP |
|
4554 .sp |
|
4555 -Optional. Comma\-separated list of recipients\(aq email addresses. |
|
4556 +Optional. Comma\-separated list of recipients' email addresses. |
|
4557 .TP |
|
4558 .B \fBcc\fP |
|
4559 .sp |
|
4560 -Optional. Comma\-separated list of carbon copy recipients\(aq |
|
4561 +Optional. Comma\-separated list of carbon copy recipients' |
|
4562 email addresses. |
|
4563 .TP |
|
4564 .B \fBbcc\fP |
|
4565 .sp |
|
4566 -Optional. Comma\-separated list of blind carbon copy recipients\(aq |
|
4567 +Optional. Comma\-separated list of blind carbon copy recipients' |
|
4568 email addresses. |
|
4569 .TP |
|
4570 .B \fBmethod\fP |
|
4571 .sp |
|
4572 Optional. Method to use to send email messages. If value is \fBsmtp\fP |
|
4573 -(default), use SMTP (see the \%SMTP\: section for configuration). |
|
4574 +(default), use SMTP (see the SMTP section for configuration). |
|
4575 Otherwise, use as name of program to run that acts like sendmail |
|
4576 (takes \fB\-f\fP option for sender, list of recipients on command line, |
|
4577 message on stdin). Normally, setting this to \fBsendmail\fP or |
|
4578 @@ -523,7 +448,7 @@ |
|
4579 Email example: |
|
4580 .sp |
|
4581 .nf |
|
4582 -.ft C |
|
4583 +.ft |
|
4584 [email] |
|
4585 from = Joseph User <[email protected]> |
|
4586 method = /usr/sbin/sendmail |
|
4587 @@ -530,7 +455,7 @@ |
|
4588 # charsets for western Europeans |
|
4589 # us\-ascii, utf\-8 omitted, as they are tried first and last |
|
4590 charsets = iso\-8859\-1, iso\-8859\-15, windows\-1252 |
|
4591 -.ft P |
|
4592 +.ft |
|
4593 .fi |
|
4594 .SS \fBextensions\fP |
|
4595 .sp |
|
4596 @@ -537,7 +462,7 @@ |
|
4597 Mercurial has an extension mechanism for adding new features. To |
|
4598 enable an extension, create an entry for it in this section. |
|
4599 .sp |
|
4600 -If you know that the extension is already in Python\(aqs search path, |
|
4601 +If you know that the extension is already in Python's search path, |
|
4602 you can give the name of the module, followed by \fB=\fP, with nothing |
|
4603 after the \fB=\fP. |
|
4604 .sp |
|
4605 @@ -553,13 +478,13 @@ |
|
4606 Example for \fB~/.hgrc\fP: |
|
4607 .sp |
|
4608 .nf |
|
4609 -.ft C |
|
4610 +.ft |
|
4611 [extensions] |
|
4612 -# (the mq extension will get loaded from Mercurial\(aqs path) |
|
4613 +# (the mq extension will get loaded from Mercurial's path) |
|
4614 hgext.mq = |
|
4615 # (this extension will get loaded from the file specified) |
|
4616 myfeature = ~/.hgext/myfeature.py |
|
4617 -.ft P |
|
4618 +.ft |
|
4619 .fi |
|
4620 .SS \fBhostfingerprints\fP |
|
4621 .sp |
|
4622 @@ -573,10 +498,10 @@ |
|
4623 For example: |
|
4624 .sp |
|
4625 .nf |
|
4626 -.ft C |
|
4627 +.ft |
|
4628 [hostfingerprints] |
|
4629 hg.intevation.org = 38:76:52:7c:87:26:9a:8f:4a:f8:d3:de:08:45:3b:ea:d6:4b:ee:cc |
|
4630 -.ft P |
|
4631 +.ft |
|
4632 .fi |
|
4633 .sp |
|
4634 This feature is only supported when using Python 2.6 or later. |
|
4635 @@ -620,11 +545,11 @@ |
|
4636 Example: |
|
4637 .sp |
|
4638 .nf |
|
4639 -.ft C |
|
4640 +.ft |
|
4641 [merge\-patterns] |
|
4642 **.c = kdiff3 |
|
4643 **.jpg = myimgmerge |
|
4644 -.ft P |
|
4645 +.ft |
|
4646 .fi |
|
4647 .SS \fBmerge\-tools\fP |
|
4648 .sp |
|
4649 @@ -634,7 +559,7 @@ |
|
4650 Example \fB~/.hgrc\fP: |
|
4651 .sp |
|
4652 .nf |
|
4653 -.ft C |
|
4654 +.ft |
|
4655 [merge\-tools] |
|
4656 # Override stock tool location |
|
4657 kdiff3.executable = ~/bin/kdiff3 |
|
4658 @@ -647,7 +572,7 @@ |
|
4659 myHtmlTool.args = \-m $local $other $base $output |
|
4660 myHtmlTool.regkey = Software\eFooSoftware\eHtmlMerge |
|
4661 myHtmlTool.priority = 1 |
|
4662 -.ft P |
|
4663 +.ft |
|
4664 .fi |
|
4665 .sp |
|
4666 Supported arguments: |
|
4667 @@ -660,8 +585,7 @@ |
|
4668 .TP |
|
4669 .B \fBexecutable\fP |
|
4670 .sp |
|
4671 -Either just the name of the executable or its pathname. On Windows, |
|
4672 -the path can use environment variables with ${ProgramFiles} syntax. |
|
4673 +Either just the name of the executable or its pathname. |
|
4674 Default: the tool name. |
|
4675 .TP |
|
4676 .B \fBargs\fP |
|
4677 @@ -724,32 +648,6 @@ |
|
4678 .B \fBgui\fP |
|
4679 .sp |
|
4680 This tool requires a graphical interface to run. Default: False |
|
4681 -.TP |
|
4682 -.B \fBregkey\fP |
|
4683 -.sp |
|
4684 -Windows registry key which describes install location of this |
|
4685 -tool. Mercurial will search for this key first under |
|
4686 -\fBHKEY_CURRENT_USER\fP and then under \fBHKEY_LOCAL_MACHINE\fP. |
|
4687 -Default: None |
|
4688 -.TP |
|
4689 -.B \fBregkeyalt\fP |
|
4690 -.sp |
|
4691 -An alternate Windows registry key to try if the first key is not |
|
4692 -found. The alternate key uses the same \fBregname\fP and \fBregappend\fP |
|
4693 -semantics of the primary key. The most common use for this key |
|
4694 -is to search for 32bit applications on 64bit operating systems. |
|
4695 -Default: None |
|
4696 -.TP |
|
4697 -.B \fBregname\fP |
|
4698 -.sp |
|
4699 -Name of value to read from specified registry key. Defaults to the |
|
4700 -unnamed (default) value. |
|
4701 -.TP |
|
4702 -.B \fBregappend\fP |
|
4703 -.sp |
|
4704 -String to append to the value read from the registry, typically |
|
4705 -the executable name of the tool. |
|
4706 -Default: None |
|
4707 .UNINDENT |
|
4708 .SS \fBhooks\fP |
|
4709 .sp |
|
4710 @@ -762,7 +660,7 @@ |
|
4711 Example \fB.hg/hgrc\fP: |
|
4712 .sp |
|
4713 .nf |
|
4714 -.ft C |
|
4715 +.ft |
|
4716 [hooks] |
|
4717 # update working directory after adding changesets |
|
4718 changegroup.update = hg update |
|
4719 @@ -770,7 +668,7 @@ |
|
4720 incoming = |
|
4721 incoming.email = /my/email/hook |
|
4722 incoming.autobuild = /my/build/hook |
|
4723 -.ft P |
|
4724 +.ft |
|
4725 .fi |
|
4726 .sp |
|
4727 Most hooks are run with environment variables set that give useful |
|
4728 @@ -820,7 +718,7 @@ |
|
4729 representations of the data internally passed to <command>. \fB$HG_OPTS\fP |
|
4730 is a dictionary of options (with unspecified options set to their |
|
4731 defaults). \fB$HG_PATS\fP is a list of arguments. If the hook returns |
|
4732 -failure, the command doesn\(aqt execute and Mercurial returns the failure |
|
4733 +failure, the command doesn't execute and Mercurial returns the failure |
|
4734 code. |
|
4735 .TP |
|
4736 .B \fBprechangegroup\fP |
|
4737 @@ -902,21 +800,14 @@ |
|
4738 Also, hooks like "commit" will be called in all contexts that |
|
4739 generate a commit (e.g. tag) and not just the commit command. |
38 .RE |
4740 .RE |
39 .PP |
4741 -.IP Note |
40 -(Unix) /etc/mercurial/hgrc\&.d/*\&.rc, (Unix) /etc/mercurial/hgrc |
4742 -. |
41 +/etc/mercurial/hgrc\&.d/*\&.rc, /etc/mercurial/hgrc |
4743 -Environment variables with empty values may not be passed to |
42 .RS 4 |
4744 -hooks on platforms such as Windows. As an example, \fB$HG_PARENT2\fP |
43 Per\-system configuration files, for the system on which Mercurial is running\&. Options in these files apply to all Mercurial commands executed by any user in any directory\&. Options in these files override per\-installation options\&. |
4745 -will have an empty value under Unix\-like platforms for non\-merge |
44 .RE |
4746 -changesets, while it will not be available at all under Windows. |
45 .PP |
4747 -.RE |
46 -(Windows) <install\-dir>\eMercurial\&.ini, or else, (Windows) HKEY_LOCAL_MACHINE\eSOFTWARE\eMercurial, or else, (Windows) C:\eMercurial\eMercurial\&.ini |
4748 .sp |
47 +(Windows) <install\-dir>\eMercurial\&.ini, or else |
4749 The syntax for Python hooks is as follows: |
48 .RS 4 |
4750 .sp |
49 Per\-installation/system configuration files, for the system on which Mercurial is running\&. Options in these files apply to all Mercurial commands executed by any user in any directory\&. Registry keys contain PATH\-like strings, every part of which must reference a |
4751 .nf |
50 Mercurial\&.ini |
4752 -.ft C |
51 @@ -50,7 +55,7 @@ |
4753 +.ft |
52 files will be read\&. |
4754 hookname = python:modulename.submodule.callable |
53 .RE |
4755 hookname = python:/path/to/python/module.py:callable |
54 .PP |
4756 -.ft P |
55 -(Unix) $HOME/\&.hgrc, (Windows) %HOME%\eMercurial\&.ini, (Windows) %HOME%\e\&.hgrc, (Windows) %USERPROFILE%\eMercurial\&.ini, (Windows) %USERPROFILE%\e\&.hgrc |
4757 +.ft |
56 +$HOME/\&.hgrc |
4758 .fi |
57 .RS 4 |
4759 .sp |
58 Per\-user configuration file(s), for the user running Mercurial\&. On Windows 9x, |
4760 Python hooks are run within the Mercurial process. Each hook is |
59 %HOME% |
4761 @@ -988,18 +879,18 @@ |
60 @@ -58,7 +63,7 @@ |
4762 .TP |
61 %APPDATA%\&. Options in these files apply to all Mercurial commands executed by this user in any directory\&. Options in these files override per\-installation and per\-system options\&. |
4763 .B \fBlocal_hostname\fP |
62 .RE |
4764 .sp |
63 .PP |
4765 -Optional. It\(aqs the hostname that the sender can use to identify |
64 -(Unix, Windows) <repo>/\&.hg/hgrc |
4766 +Optional. It's the hostname that the sender can use to identify |
65 +<repo>/\&.hg/hgrc |
4767 itself to the MTA. |
66 .RS 4 |
4768 .UNINDENT |
67 Per\-repository configuration options that only apply in a particular repository\&. This file is not version\-controlled, and will not get transferred during a "clone" operation\&. Options in this file override options in all other configuration files\&. On Unix, most of this file will be ignored if it doesn\(cqt belong to a trusted user or to a trusted group\&. See the documentation for the trusted section below for more details\&. |
4769 .SS \fBpatch\fP |
68 .RE |
4770 .sp |
69 @@ -874,7 +879,7 @@ |
4771 -Settings used when applying patches, for instance through the \(aqimport\(aq |
70 patch content and patched files end of lines are preserved\&. When set to |
4772 +Settings used when applying patches, for instance through the 'import' |
71 \fIlf\fR |
4773 command or with Mercurial Queues extension. |
72 or |
4774 .INDENT 0.0 |
73 -\fIcrlf\fR, both files end of lines are ignored when patching and the result line endings are normalized to either LF (Unix) or CRLF (Windows)\&. Default: strict\&. |
4775 .TP |
74 +\fIcrlf\fR, both files end of lines are ignored when patching and the result line endings are normalized to either LF or CRLF (Windows)\&. Default: strict\&. |
4776 .B \fBeol\fP |
75 .RE |
4777 .sp |
76 .RE |
4778 -When set to \(aqstrict\(aq patch content and patched files end of lines |
77 .PP |
4779 +When set to 'strict' patch content and patched files end of lines |
|
4780 are preserved. When set to \fBlf\fP or \fBcrlf\fP, both files end of |
|
4781 lines are ignored when patching and the result line endings are |
|
4782 normalized to either LF (Unix) or CRLF (Windows). When set to |
|
4783 @@ -1031,8 +922,8 @@ |
|
4784 .SS \fBprofiling\fP |
|
4785 .sp |
|
4786 Specifies profiling format and file output. In this section |
|
4787 -description, \(aqprofiling data\(aq stands for the raw data collected |
|
4788 -during profiling, while \(aqprofiling report\(aq stands for a statistical |
|
4789 +description, 'profiling data' stands for the raw data collected |
|
4790 +during profiling, while 'profiling report' stands for a statistical |
|
4791 text report generated from the profiling data. The profiling is done |
|
4792 using lsprof. |
|
4793 .INDENT 0.0 |
|
4794 @@ -1091,9 +982,9 @@ |
|
4795 Defines subrepositories source locations rewriting rules of the form: |
|
4796 .sp |
|
4797 .nf |
|
4798 -.ft C |
|
4799 +.ft |
|
4800 <pattern> = <replacement> |
|
4801 -.ft P |
|
4802 +.ft |
|
4803 .fi |
|
4804 .sp |
|
4805 Where \fBpattern\fP is a regular expression matching the source and |
|
4806 @@ -1102,9 +993,9 @@ |
|
4807 instance: |
|
4808 .sp |
|
4809 .nf |
|
4810 -.ft C |
|
4811 +.ft |
|
4812 http://server/(.*)\-hg/ = http://hg.server/\e1/ |
|
4813 -.ft P |
|
4814 +.ft |
|
4815 .fi |
|
4816 .sp |
|
4817 rewrites \fBhttp://server/foo\-hg/\fP into \fBhttp://hg.server/foo/\fP. |
|
4818 @@ -1112,8 +1003,8 @@ |
|
4819 All patterns are applied in definition order. |
|
4820 .SS \fBtrusted\fP |
|
4821 .sp |
|
4822 -Mercurial will not use the settings in the |
|
4823 -\fB.hg/hgrc\fP file from a repository if it doesn\(aqt belong to a trusted |
|
4824 +Mercurial will not use the settings in the \fB.hg/hgrc\fP file from a |
|
4825 +repository if it doesn't belong to a trusted |
|
4826 user or to a trusted group, as various hgrc features allow arbitrary |
|
4827 commands to be run. This issue is often encountered when configuring |
|
4828 hooks or extensions for shared repositories or servers. However, |
|
4829 @@ -1144,7 +1035,7 @@ |
|
4830 .sp |
|
4831 Whether to include the .hg_archival.txt file containing meta data |
|
4832 (hashes for the repository base and for tip) in archives created |
|
4833 -by the \%\fBhg archive\fP\: command or downloaded via hgweb. |
|
4834 +by the \fBhg archive\fP command or downloaded via hgweb. |
|
4835 Default is True. |
|
4836 .TP |
|
4837 .B \fBaskusername\fP |
|
4838 @@ -1172,7 +1063,7 @@ |
|
4839 .TP |
|
4840 .B \fBfallbackencoding\fP |
|
4841 .sp |
|
4842 -Encoding to try if it\(aqs not possible to decode the changelog using |
|
4843 +Encoding to try if it's not possible to decode the changelog using |
|
4844 UTF\-8. Default is ISO\-8859\-1. |
|
4845 .TP |
|
4846 .B \fBignore\fP |
|
4847 @@ -1182,7 +1073,7 @@ |
|
4848 option supports hook syntax, so if you want to specify multiple |
|
4849 ignore files, you can do so by setting something like |
|
4850 \fBignore.other = ~/.hgignore2\fP. For details of the ignore file |
|
4851 -format, see the \%\fBhgignore\fP(5)\: man page. |
|
4852 +format, see the \fBhgignore\fP(5) man page. |
|
4853 .TP |
|
4854 .B \fBinteractive\fP |
|
4855 .sp |
|
4856 @@ -1195,8 +1086,8 @@ |
|
4857 .B \fBmerge\fP |
|
4858 .sp |
|
4859 The conflict resolution program to use during a manual merge. |
|
4860 -For more information on merge tools see \%\fBhg help merge\-tools\fP\:. |
|
4861 -For configuring merge tools see the \%merge\-tools\: section. |
|
4862 +For more information on merge tools see \fBhg help merge\-tools\fP. |
|
4863 +For configuring merge tools see the merge\-tools section. |
|
4864 .TP |
|
4865 .B \fBpatch\fP |
|
4866 .sp |
|
4867 @@ -1252,7 +1143,7 @@ |
|
4868 .B \fBusername\fP |
|
4869 .sp |
|
4870 The committer of a changeset created when running "commit". |
|
4871 -Typically a person\(aqs name and email address, e.g. \fBFred Widget |
|
4872 +Typically a person's name and email address, e.g. \fBFred Widget |
|
4873 <[email protected]>\fP. Default is \fB$EMAIL\fP or \fBusername@hostname\fP. If |
|
4874 the username in hgrc is empty, it has to be specified manually or |
|
4875 in a different hgrc file (e.g. \fB$HOME/.hgrc\fP, if the admin set |
|
4876 @@ -1266,7 +1157,7 @@ |
|
4877 .SS \fBweb\fP |
|
4878 .sp |
|
4879 Web interface configuration. The settings in this section apply to |
|
4880 -both the builtin webserver (started by \%\fBhg serve\fP\:) and the script you |
|
4881 +both the builtin webserver (started by \fBhg serve\fP) and the script you |
|
4882 run through a webserver (\fBhgweb.cgi\fP and the derivatives for FastCGI |
|
4883 and WSGI). |
|
4884 .sp |
|
4885 @@ -1282,9 +1173,9 @@ |
|
4886 command line: |
|
4887 .sp |
|
4888 .nf |
|
4889 -.ft C |
|
4890 +.ft |
|
4891 $ hg \-\-config web.allow_push=* \-\-config web.push_ssl=False serve |
|
4892 -.ft P |
|
4893 +.ft |
|
4894 .fi |
|
4895 .sp |
|
4896 Note that this will allow anybody to push anything to the server and |
|
4897 @@ -1363,7 +1254,7 @@ |
|
4898 with these certificates. The form must be as follows: |
|
4899 .sp |
|
4900 .nf |
|
4901 -.ft C |
|
4902 +.ft |
|
4903 \-\-\-\-\-BEGIN CERTIFICATE\-\-\-\-\- |
|
4904 \&... (certificate in base64 PEM encoding) ... |
|
4905 \-\-\-\-\-END CERTIFICATE\-\-\-\-\- |
|
4906 @@ -1370,7 +1261,7 @@ |
|
4907 \-\-\-\-\-BEGIN CERTIFICATE\-\-\-\-\- |
|
4908 \&... (certificate in base64 PEM encoding) ... |
|
4909 \-\-\-\-\-END CERTIFICATE\-\-\-\-\- |
|
4910 -.ft P |
|
4911 +.ft |
|
4912 .fi |
|
4913 .sp |
|
4914 This feature is only supported when using Python 2.6 or later. If you wish |
|
4915 @@ -1378,7 +1269,7 @@ |
|
4916 version of the ssl library that is available from |
|
4917 \fBhttp://pypi.python.org\fP. |
|
4918 .sp |
|
4919 -You can use OpenSSL\(aqs CA certificate file if your platform has one. |
|
4920 +You can use OpenSSL's CA certificate file if your platform has one. |
|
4921 On most Linux systems this will be \fB/etc/ssl/certs/ca\-certificates.crt\fP. |
|
4922 Otherwise you will have to generate this file manually. |
|
4923 .sp |
|
4924 @@ -1422,7 +1313,7 @@ |
|
4925 .TP |
|
4926 .B \fBdescription\fP |
|
4927 .sp |
|
4928 -Textual description of the repository\(aqs purpose or contents. |
|
4929 +Textual description of the repository's purpose or contents. |
|
4930 Default is "unknown". |
|
4931 .TP |
|
4932 .B \fBencoding\fP |
|
4933 @@ -1462,7 +1353,7 @@ |
|
4934 .TP |
|
4935 .B \fBprefix\fP |
|
4936 .sp |
|
4937 -Prefix path to serve from. Default is \(aq\(aq (server root). |
|
4938 +Prefix path to serve from. Default is '' (server root). |
|
4939 .TP |
|
4940 .B \fBpush_ssl\fP |
|
4941 .sp |
|
4942 @@ -1491,15 +1382,15 @@ |
|
4943 .UNINDENT |
|
4944 .SH AUTHOR |
|
4945 .sp |
|
4946 -Bryan O\(aqSullivan <\%[email protected]\:>. |
|
4947 +Bryan O'Sullivan <[email protected]>. |
|
4948 .sp |
|
4949 -Mercurial was written by Matt Mackall <\%[email protected]\:>. |
|
4950 +Mercurial was written by Matt Mackall <[email protected]>. |
|
4951 .SH SEE ALSO |
|
4952 .sp |
|
4953 -\%\fBhg\fP(1)\:, \%\fBhgignore\fP(5)\: |
|
4954 +\fBhg\fP(1), \fBhgignore\fP(5) |
|
4955 .SH COPYING |
|
4956 .sp |
|
4957 -This manual page is copyright 2005 Bryan O\(aqSullivan. |
|
4958 +This manual page is copyright 2005 Bryan O'Sullivan. |
|
4959 Mercurial is copyright 2005\-2010 Matt Mackall. |
|
4960 Free use of this software is granted under the terms of the GNU General |
|
4961 Public License version 2 or any later version. |