mercurial: update to 4.4
[unleashed-userland.git] / components / developer / mercurial / patches / manpages.patch
blob4fcb3d7f249964cd794015eceae20939932b9552
1 --- mercurial-4.4/doc/hg.1.orig Thu Nov 2 00:54:44 2017
2 +++ mercurial-4.4/doc/hg.1 Thu Nov 2 09:06:18 2017
3 @@ -3,33 +3,6 @@
4 .TH HG 1 "" "" "Mercurial Manual"
5 .SH NAME
6 hg \- Mercurial source code management system
7 -.
8 -.nr rst2man-indent-level 0
9 -.
10 -.de1 rstReportMargin
11 -\\$1 \\n[an-margin]
12 -level \\n[rst2man-indent-level]
13 -level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
15 -\\n[rst2man-indent0]
16 -\\n[rst2man-indent1]
17 -\\n[rst2man-indent2]
18 -..
19 -.de1 INDENT
20 -.\" .rstReportMargin pre:
21 -. RS \\$1
22 -. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
23 -. nr rst2man-indent-level +1
24 -.\" .rstReportMargin post:
25 -..
26 -.de UNINDENT
27 -. RE
28 -.\" indent \\n[an-margin]
29 -.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
30 -.nr rst2man-indent-level -1
31 -.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
32 -.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
33 -..
34 .SH SYNOPSIS
35 .sp
36 \fBhg\fP \fIcommand\fP [\fIoption\fP]... [\fIargument\fP]...
37 @@ -38,12 +11,12 @@
38 The \fBhg\fP command provides a command line interface to the Mercurial
39 system.
40 .SH COMMAND ELEMENTS
41 -.INDENT 0.0
42 +.RS 0
43 .TP
44 .B files...
46 indicates one or more filename or relative path filenames; see
47 -\%File Name Patterns\: for information on pattern matching
48 +File Name Patterns for information on pattern matching
49 .TP
50 .B path
52 @@ -59,9 +32,9 @@
54 either the pathname of a local repository or the URI of a remote
55 repository.
56 -.UNINDENT
57 +.RE
58 .SH OPTIONS
59 -.INDENT 0.0
60 +.RS 0
61 .TP
62 .BI \-R, \-\-repository \ <REPO>
64 @@ -89,7 +62,7 @@
65 .TP
66 .BI \-\-config \ <CONFIG[+]>
68 -set/override config option (use \(aqsection.name=value\(aq)
69 +set/override config option (use 'section.name=value')
70 .TP
71 .B \-\-debug
73 @@ -134,7 +107,7 @@
74 .BI \-\-pager \ <TYPE>
76 when to paginate (boolean, always, auto, or never) (default: auto)
77 -.UNINDENT
78 +.RE
79 .sp
80 [+] marked option can be specified multiple times
81 .SH COMMANDS
82 @@ -143,9 +116,9 @@
83 add the specified files on the next commit:
84 .sp
85 .nf
86 -.ft C
87 +.ft
88 hg add [OPTION]... [FILE]...
89 -.ft P
90 +.ft
91 .fi
92 .sp
93 Schedule files to be version controlled and added to the
94 @@ -152,22 +125,22 @@
95 repository.
96 .sp
97 The files will be added to the repository at the next commit. To
98 -undo an add before that, see \%\fBhg forget\fP\:.
99 +undo an add before that, see \fBhg forget\fP.
101 If no names are given, add all files to the repository (except
102 files matching \fB.hgignore\fP).
104 Examples:
105 -.INDENT 0.0
106 -.INDENT 3.5
107 -.INDENT 0.0
108 +.RS 0
109 +.RS 3
110 +.RS 0
111 .IP \(bu 2
113 New (unknown) files are added
114 -automatically by \%\fBhg add\fP\::
115 +automatically by \fBhg add\fP:
118 -.ft C
119 +.ft
120 $ ls
121 foo.c
122 $ hg status
123 @@ -176,7 +149,7 @@
124 adding foo.c
125 $ hg status
126 A foo.c
127 -.ft P
128 +.ft
130 .IP \(bu 2
132 @@ -183,7 +156,7 @@
133 Specific files to be added can be specified:
136 -.ft C
137 +.ft
138 $ ls
139 bar.c foo.c
140 $ hg status
141 @@ -193,16 +166,16 @@
142 $ hg status
143 A bar.c
144 ? foo.c
145 -.ft P
146 +.ft
148 -.UNINDENT
149 -.UNINDENT
150 -.UNINDENT
151 +.RE
152 +.RE
153 +.RE
155 Returns 0 if all files are successfully added.
157 Options:
158 -.INDENT 0.0
159 +.RS 0
161 .BI \-I, \-\-include \ <PATTERN[+]>
163 @@ -219,7 +192,7 @@
164 .B \-n, \-\-dry\-run
166 do not perform actions, just print output
167 -.UNINDENT
168 +.RE
170 [+] marked option can be specified multiple times
171 .SS addremove
172 @@ -227,9 +200,9 @@
173 add all new files, delete all missing files:
176 -.ft C
177 +.ft
178 hg addremove [OPTION]... [FILE]...
179 -.ft P
180 +.ft
183 Add all new files and remove all missing files from the
184 @@ -244,23 +217,23 @@
185 be identical) as its parameter. With a parameter greater than 0,
186 this compares every removed file with every added file and records
187 those similar enough as renames. Detecting renamed files this way
188 -can be expensive. After using this option, \%\fBhg status \-C\fP\: can be
189 +can be expensive. After using this option, \fBhg status \-C\fP can be
190 used to check which files were identified as moved or renamed. If
191 not specified, \-s/\-\-similarity defaults to 100 and only renames of
192 identical files are detected.
194 Examples:
195 -.INDENT 0.0
196 -.INDENT 3.5
197 -.INDENT 0.0
198 +.RS 0
199 +.RS 3
200 +.RS 0
201 .IP \(bu 2
203 A number of files (bar.c and foo.c) are new,
204 -while foobar.c has been removed (without using \%\fBhg remove\fP\:)
205 +while foobar.c has been removed (without using \fBhg remove\fP)
206 from the repository:
209 -.ft C
210 +.ft
211 $ ls
212 bar.c foo.c
213 $ hg status
214 @@ -275,15 +248,15 @@
215 A bar.c
216 A foo.c
217 R foobar.c
218 -.ft P
219 +.ft
221 .IP \(bu 2
223 -A file foobar.c was moved to foo.c without using \%\fBhg rename\fP\:.
224 +A file foobar.c was moved to foo.c without using \fBhg rename\fP.
225 Afterwards, it was edited slightly:
228 -.ft C
229 +.ft
230 $ ls
231 foo.c
232 $ hg status
233 @@ -297,16 +270,16 @@
234 A foo.c
235 foobar.c
236 R foobar.c
237 -.ft P
238 +.ft
240 -.UNINDENT
241 -.UNINDENT
242 -.UNINDENT
243 +.RE
244 +.RE
245 +.RE
247 Returns 0 if all files are successfully added.
249 Options:
250 -.INDENT 0.0
251 +.RS 0
253 .BI \-s, \-\-similarity \ <SIMILARITY>
255 @@ -327,7 +300,7 @@
256 .B \-n, \-\-dry\-run
258 do not perform actions, just print output
259 -.UNINDENT
260 +.RE
262 [+] marked option can be specified multiple times
263 .SS annotate
264 @@ -335,9 +308,9 @@
265 show changeset information by line for each file:
268 -.ft C
269 +.ft
270 hg annotate [\-r REV] [\-f] [\-a] [\-u] [\-d] [\-n] [\-c] [\-l] FILE...
271 -.ft P
272 +.ft
275 List changes in files, showing the revision id responsible for
276 @@ -357,7 +330,7 @@
277 Returns 0 on success.
279 Options:
280 -.INDENT 0.0
281 +.RS 0
283 .BI \-r, \-\-rev \ <REV>
285 @@ -369,7 +342,7 @@
287 .B \-\-no\-follow
289 -don\(aqt follow copies and renames
290 +don't follow copies and renames
292 .B \-a, \-\-text
294 @@ -430,23 +403,23 @@
295 .BI \-T, \-\-template \ <TEMPLATE>
297 display with template (EXPERIMENTAL)
298 -.UNINDENT
299 +.RE
301 [+] marked option can be specified multiple times
302 -.INDENT 0.0
303 -.INDENT 3.5
304 +.RS 0
305 +.RS 3
307 aliases: blame
308 -.UNINDENT
309 -.UNINDENT
310 +.RE
311 +.RE
312 .SS archive
314 create an unversioned archive of a repository revision:
317 -.ft C
318 +.ft
319 hg archive [OPTION]... DEST
320 -.ft P
321 +.ft
324 By default, the revision used is the parent of the working
325 @@ -456,15 +429,15 @@
326 extension (to override, use \-t/\-\-type).
328 Examples:
329 -.INDENT 0.0
330 +.RS 0
331 .IP \(bu 2
333 create a zip file containing the 1.0 release:
336 -.ft C
337 +.ft
338 hg archive \-r 1.0 project\-1.0.zip
339 -.ft P
340 +.ft
342 .IP \(bu 2
344 @@ -471,14 +444,14 @@
345 create a tarball excluding .hg files:
348 -.ft C
349 +.ft
350 hg archive project.tar.gz \-X ".hg*"
351 -.ft P
352 +.ft
354 -.UNINDENT
355 +.RE
357 Valid types are:
358 -.INDENT 0.0
359 +.RS 0
361 .B \fBfiles\fP
363 @@ -503,10 +476,10 @@
364 .B \fBzip\fP
366 zip archive, compressed using deflate
367 -.UNINDENT
368 +.RE
370 The exact name of the destination archive or directory is given
371 -using a format string; see \%\fBhg help export\fP\: for details.
372 +using a format string; see \fBhg help export\fP for details.
374 Each member added to an archive file has a directory prefix
375 prepended. Use \-p/\-\-prefix to specify a format string for the
376 @@ -516,7 +489,7 @@
377 Returns 0 on success.
379 Options:
380 -.INDENT 0.0
381 +.RS 0
383 .B \-\-no\-decode
385 @@ -545,7 +518,7 @@
386 .BI \-X, \-\-exclude \ <PATTERN[+]>
388 exclude names matching the given patterns
389 -.UNINDENT
390 +.RE
392 [+] marked option can be specified multiple times
393 .SS backout
394 @@ -553,9 +526,9 @@
395 reverse effect of earlier changeset:
398 -.ft C
399 +.ft
400 hg backout [OPTION]... [\-r] REV
401 -.ft P
402 +.ft
405 Prepare a new changeset with the effect of REV undone in the
406 @@ -566,12 +539,12 @@
407 is committed automatically (unless \-\-no\-commit is specified).
408 .IP Note
410 -\%\fBhg backout\fP\: cannot be used to fix either an unwanted or
411 +\fBhg backout\fP cannot be used to fix either an unwanted or
412 incorrect merge.
415 Examples:
416 -.INDENT 0.0
417 +.RS 0
418 .IP \(bu 2
420 Reverse the effect of the parent of the working directory.
421 @@ -578,9 +551,9 @@
422 This backout will be committed immediately:
425 -.ft C
426 +.ft
427 hg backout \-r .
428 -.ft P
429 +.ft
431 .IP \(bu 2
433 @@ -587,9 +560,9 @@
434 Reverse the effect of previous bad revision 23:
437 -.ft C
438 +.ft
439 hg backout \-r 23
440 -.ft P
441 +.ft
443 .IP \(bu 2
445 @@ -597,12 +570,12 @@
446 leave changes uncommitted:
449 -.ft C
450 +.ft
451 hg backout \-r 23 \-\-no\-commit
452 hg commit \-m "Backout revision 23"
453 -.ft P
454 +.ft
456 -.UNINDENT
457 +.RE
459 By default, the pending changeset will have one parent,
460 maintaining a linear history. With \-\-merge, the pending
461 @@ -610,13 +583,13 @@
462 working directory and a new child of REV that simply undoes REV.
464 Before version 1.7, the behavior without \-\-merge was equivalent
465 -to specifying \-\-merge followed by \%\fBhg update \-\-clean .\fP\: to
466 +to specifying \-\-merge followed by \fBhg update \-\-clean .\fP to
467 cancel the merge and leave the child of REV as a head to be
468 merged separately.
470 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date.
471 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date.
473 -See \%\fBhg help revert\fP\: for a way to restore files to the state
474 +See \fBhg help revert\fP for a way to restore files to the state
475 of another revision.
477 Returns 0 on success, 1 if nothing to backout or there are unresolved
478 @@ -623,7 +596,7 @@
479 files.
481 Options:
482 -.INDENT 0.0
483 +.RS 0
485 .B \-\-merge
487 @@ -676,7 +649,7 @@
488 .BI \-u, \-\-user \ <USER>
490 record the specified user as committer
491 -.UNINDENT
492 +.RE
494 [+] marked option can be specified multiple times
495 .SS bisect
496 @@ -684,9 +657,9 @@
497 subdivision search of changesets:
500 -.ft C
501 +.ft
502 hg bisect [\-gbsr] [\-U] [\-c CMD] [REV]
503 -.ft P
504 +.ft
507 This command helps to find changesets which introduce problems. To
508 @@ -710,16 +683,16 @@
509 is bad.
511 Some examples:
512 -.INDENT 0.0
513 +.RS 0
514 .IP \(bu 2
516 start a bisection with known bad revision 34, and good revision 12:
519 -.ft C
520 +.ft
521 hg bisect \-\-bad 34
522 hg bisect \-\-good 12
523 -.ft P
524 +.ft
526 .IP \(bu 2
528 @@ -727,10 +700,10 @@
529 bad:
532 -.ft C
533 +.ft
534 hg bisect \-\-good
535 hg bisect \-\-bad
536 -.ft P
537 +.ft
539 .IP \(bu 2
541 @@ -738,10 +711,10 @@
542 that revision is not usable because of another issue):
545 -.ft C
546 +.ft
547 hg bisect \-\-skip
548 hg bisect \-\-skip 23
549 -.ft P
550 +.ft
552 .IP \(bu 2
554 @@ -748,9 +721,9 @@
555 skip all revisions that do not touch directories \fBfoo\fP or \fBbar\fP:
558 -.ft C
559 -hg bisect \-\-skip "!( file(\(aqpath:foo\(aq) & file(\(aqpath:bar\(aq) )"
560 -.ft P
561 +.ft
562 +hg bisect \-\-skip "!( file('path:foo') & file('path:bar') )"
563 +.ft
565 .IP \(bu 2
567 @@ -757,22 +730,22 @@
568 forget the current bisection:
571 -.ft C
572 +.ft
573 hg bisect \-\-reset
574 -.ft P
575 +.ft
577 .IP \(bu 2
579 -use \(aqmake && make tests\(aq to automatically find the first broken
580 +use 'make && make tests' to automatically find the first broken
581 revision:
584 -.ft C
585 +.ft
586 hg bisect \-\-reset
587 hg bisect \-\-bad 34
588 hg bisect \-\-good 12
589 hg bisect \-\-command "make && make tests"
590 -.ft P
591 +.ft
593 .IP \(bu 2
595 @@ -780,9 +753,9 @@
596 bisection:
599 -.ft C
600 +.ft
601 hg log \-r "bisect(pruned)"
602 -.ft P
603 +.ft
605 .IP \(bu 2
607 @@ -790,9 +763,9 @@
608 if running with \-U/\-\-noupdate):
611 -.ft C
612 +.ft
613 hg log \-r "bisect(current)"
614 -.ft P
615 +.ft
617 .IP \(bu 2
619 @@ -799,9 +772,9 @@
620 see all changesets that took part in the current bisection:
623 -.ft C
624 +.ft
625 hg log \-r "bisect(range)"
626 -.ft P
627 +.ft
629 .IP \(bu 2
631 @@ -808,18 +781,18 @@
632 you can even get a nice graph:
635 -.ft C
636 +.ft
637 hg log \-\-graph \-r "bisect(range)"
638 -.ft P
639 +.ft
641 -.UNINDENT
642 +.RE
644 -See \%\fBhg help revisions.bisect\fP\: for more about the \fIbisect()\fP predicate.
645 +See \fBhg help revisions.bisect\fP for more about the \fIbisect()\fP predicate.
647 Returns 0 on success.
649 Options:
650 -.INDENT 0.0
651 +.RS 0
653 .B \-r, \-\-reset
655 @@ -848,15 +821,15 @@
656 .B \-U, \-\-noupdate
658 do not update to target
659 -.UNINDENT
660 +.RE
661 .SS bookmarks
663 create a new bookmark or list existing bookmarks:
666 -.ft C
667 +.ft
668 hg bookmarks [OPTIONS]... [NAME]...
669 -.ft P
670 +.ft
673 Bookmarks are labels on changesets to help track lines of development.
674 @@ -863,33 +836,33 @@
675 Bookmarks are unversioned and can be moved, renamed and deleted.
676 Deleting or moving a bookmark has no effect on the associated changesets.
678 -Creating or updating to a bookmark causes it to be marked as \(aqactive\(aq.
679 -The active bookmark is indicated with a \(aq*\(aq.
680 +Creating or updating to a bookmark causes it to be marked as 'active'.
681 +The active bookmark is indicated with a '*'.
682 When a commit is made, the active bookmark will advance to the new commit.
683 -A plain \%\fBhg update\fP\: will also advance an active bookmark, if possible.
684 +A plain \fBhg update\fP will also advance an active bookmark, if possible.
685 Updating away from a bookmark will cause it to be deactivated.
687 Bookmarks can be pushed and pulled between repositories (see
688 -\%\fBhg help push\fP\: and \%\fBhg help pull\fP\:). If a shared bookmark has
689 -diverged, a new \(aqdivergent bookmark\(aq of the form \%\(aqname@path\:\(aq will
690 -be created. Using \%\fBhg merge\fP\: will resolve the divergence.
691 +\fBhg help push\fP and \fBhg help pull\fP). If a shared bookmark has
692 +diverged, a new 'divergent bookmark' of the form \&'name@path\&' will
693 +be created. Using \fBhg merge\fP will resolve the divergence.
695 -Specifying bookmark as \(aq.\(aq to \-m or \-d options is equivalent to specifying
696 -the active bookmark\(aqs name.
697 +Specifying bookmark as '.' to \-m or \-d options is equivalent to specifying
698 +the active bookmark's name.
700 -A bookmark named \(aq@\(aq has the special property that \%\fBhg clone\fP\: will
701 +A bookmark named '@' has the special property that \fBhg clone\fP will
702 check it out by default if it exists.
704 Examples:
705 -.INDENT 0.0
706 +.RS 0
707 .IP \(bu 2
709 create an active bookmark for a new line of development:
712 -.ft C
713 +.ft
714 hg book new\-feature
715 -.ft P
716 +.ft
718 .IP \(bu 2
720 @@ -896,9 +869,9 @@
721 create an inactive bookmark as a place marker:
724 -.ft C
725 +.ft
726 hg book \-i reviewed
727 -.ft P
728 +.ft
730 .IP \(bu 2
732 @@ -905,9 +878,9 @@
733 create an inactive bookmark on another changeset:
736 -.ft C
737 +.ft
738 hg book \-r .^ tested
739 -.ft P
740 +.ft
742 .IP \(bu 2
744 @@ -914,23 +887,23 @@
745 rename bookmark turkey to dinner:
748 -.ft C
749 +.ft
750 hg book \-m turkey dinner
751 -.ft P
752 +.ft
754 .IP \(bu 2
756 -move the \(aq@\(aq bookmark from another branch:
757 +move the '@' bookmark from another branch:
760 -.ft C
761 +.ft
762 hg book \-f @
763 -.ft P
764 +.ft
766 -.UNINDENT
767 +.RE
769 Options:
770 -.INDENT 0.0
771 +.RS 0
773 .B \-f, \-\-force
775 @@ -957,20 +930,20 @@
776 display with template (EXPERIMENTAL)
778 aliases: bookmark
779 -.UNINDENT
780 +.RE
781 .SS branch
783 set or show the current branch name:
786 -.ft C
787 +.ft
788 hg branch [\-fC] [NAME]
789 -.ft P
790 +.ft
792 .IP Note
794 -Branch names are permanent and global. Use \%\fBhg bookmark\fP\: to create a
795 -light\-weight bookmark instead. See \%\fBhg help glossary\fP\: for more
796 +Branch names are permanent and global. Use \fBhg bookmark\fP to create a
797 +light\-weight bookmark instead. See \fBhg help glossary\fP for more
798 information about named branches and bookmarks.
801 @@ -977,7 +950,7 @@
802 With no argument, show the current branch name. With one argument,
803 set the working directory branch name (the branch will not exist
804 in the repository until the next commit). Standard practice
805 -recommends that primary development take place on the \(aqdefault\(aq
806 +recommends that primary development take place on the 'default'
807 branch.
809 Unless \-f/\-\-force is specified, branch will not let you set a
810 @@ -987,8 +960,8 @@
811 the parent of the working directory, negating a previous branch
812 change.
814 -Use the command \%\fBhg update\fP\: to switch to an existing branch. Use
815 -\%\fBhg commit \-\-close\-branch\fP\: to mark this branch head as closed.
816 +Use the command \fBhg update\fP to switch to an existing branch. Use
817 +\fBhg commit \-\-close\-branch\fP to mark this branch head as closed.
818 When all heads of a branch are closed, the branch will be
819 considered closed.
821 @@ -995,7 +968,7 @@
822 Returns 0 on success.
824 Options:
825 -.INDENT 0.0
826 +.RS 0
828 .B \-f, \-\-force
830 @@ -1004,27 +977,27 @@
831 .B \-C, \-\-clean
833 reset branch name to parent branch name
834 -.UNINDENT
835 +.RE
836 .SS branches
838 list repository named branches:
841 -.ft C
842 +.ft
843 hg branches [\-c]
844 -.ft P
845 +.ft
848 -List the repository\(aqs named branches, indicating which ones are
849 +List the repository's named branches, indicating which ones are
850 inactive. If \-c/\-\-closed is specified, also list branches which have
851 -been marked closed (see \%\fBhg commit \-\-close\-branch\fP\:).
852 +been marked closed (see \fBhg commit \-\-close\-branch\fP).
854 -Use the command \%\fBhg update\fP\: to switch to an existing branch.
855 +Use the command \fBhg update\fP to switch to an existing branch.
857 Returns 0.
859 Options:
860 -.INDENT 0.0
861 +.RS 0
863 .B \-a, \-\-active
865 @@ -1037,15 +1010,15 @@
866 .BI \-T, \-\-template \ <TEMPLATE>
868 display with template (EXPERIMENTAL)
869 -.UNINDENT
870 +.RE
871 .SS bundle
873 create a bundle file:
876 -.ft C
877 +.ft
878 hg bundle [\-f] [\-t BUNDLESPEC] [\-a] [\-r REV]... [\-\-base REV]... FILE [DEST]
879 -.ft P
880 +.ft
883 Generate a bundle file containing data to be added to a repository.
884 @@ -1057,7 +1030,7 @@
885 default\-push/default if no destination is specified.
887 You can change bundle format with the \-t/\-\-type option. See
888 -\%\fBhg help bundlespec\fP\: for documentation on this format. By default,
889 +\fBhg help bundlespec\fP for documentation on this format. By default,
890 the most appropriate format is used and compression defaults to
891 bzip2.
893 @@ -1072,7 +1045,7 @@
894 Returns 0 on success, 1 if no changes found.
896 Options:
897 -.INDENT 0.0
898 +.RS 0
900 .B \-f, \-\-force
902 @@ -1109,7 +1082,7 @@
903 .B \-\-insecure
905 do not verify server certificate (ignoring web.cacerts config)
906 -.UNINDENT
907 +.RE
909 [+] marked option can be specified multiple times
910 .SS cat
911 @@ -1117,9 +1090,9 @@
912 output the current or given revision of files:
915 -.ft C
916 +.ft
917 hg cat [OPTION]... FILE...
918 -.ft P
919 +.ft
922 Print the specified files as they were at the given revision. If
923 @@ -1127,7 +1100,7 @@
925 Output may be to a file, in which case the name of the file is
926 given using a format string. The formatting rules as follows:
927 -.INDENT 0.0
928 +.RS 0
930 .B \fB%%\fP
932 @@ -1139,7 +1112,7 @@
934 .B \fB%d\fP
936 -dirname of file being printed, or \(aq.\(aq if in repository root
937 +dirname of file being printed, or '.' if in repository root
939 .B \fB%p\fP
941 @@ -1164,12 +1137,12 @@
942 .B \fB%b\fP
944 basename of the exporting repository
945 -.UNINDENT
946 +.RE
948 Returns 0 on success.
950 Options:
951 -.INDENT 0.0
952 +.RS 0
954 .BI \-o, \-\-output \ <FORMAT>
956 @@ -1194,7 +1167,7 @@
957 .BI \-T, \-\-template \ <TEMPLATE>
959 display with template (EXPERIMENTAL)
960 -.UNINDENT
961 +.RE
963 [+] marked option can be specified multiple times
964 .SS clone
965 @@ -1202,9 +1175,9 @@
966 make a copy of an existing repository:
969 -.ft C
970 +.ft
971 hg clone [OPTION]... SOURCE [DEST]
972 -.ft P
973 +.ft
976 Create a copy of an existing repository in a new directory.
977 @@ -1212,14 +1185,14 @@
978 If no destination directory name is specified, it defaults to the
979 basename of the source.
981 -The location of the source is added to the new repository\(aqs
982 -\fB.hg/hgrc\fP file, as the default to be used for future pulls.
983 +The location of the source is added to the new repository's
984 +\fB\&.hg/hgrc\fP file, as the default to be used for future pulls.
986 Only local paths and \fBssh://\fP URLs are supported as
987 destinations. For \fBssh://\fP destinations, no working directory or
988 -\fB.hg/hgrc\fP will be created on the remote side.
989 +\fB\&.hg/hgrc\fP will be created on the remote side.
991 -If the source repository has a bookmark called \(aq@\(aq set, that
992 +If the source repository has a bookmark called '@' set, that
993 revision will be checked out in the new repository by default.
995 To check out a particular version, use \-u/\-\-update, or
996 @@ -1228,7 +1201,7 @@
997 To pull only a subset of changesets, specify one or more revisions
998 identifiers with \-r/\-\-rev or branches with \-b/\-\-branch. The
999 resulting clone will contain only the specified changesets and
1000 -their ancestors. These options (or \(aqclone src#rev dest\(aq) imply
1001 +their ancestors. These options (or 'clone src#rev dest') imply
1002 \-\-pull, even for local source repositories.
1004 In normal clone mode, the remote normalizes repository data into a common
1005 @@ -1258,7 +1231,7 @@
1007 Mercurial will update the working directory to the first applicable
1008 revision from this list:
1009 -.INDENT 0.0
1010 +.RS 0
1011 .IP a. 3
1013 null if \-U or the source repository has no changesets
1014 @@ -1265,7 +1238,7 @@
1015 .IP b. 3
1017 if \-u . and the source repository is local, the first parent of
1018 -the source repository\(aqs working directory
1019 +the source repository's working directory
1020 .IP c. 3
1022 the changeset specified with \-u (if a branch name, this means the
1023 @@ -1281,7 +1254,7 @@
1024 the tipmost head specified with the url#branch source syntax
1025 .IP g. 3
1027 -the revision marked with the \(aq@\(aq bookmark, if present
1028 +the revision marked with the '@' bookmark, if present
1029 .IP h. 3
1031 the tipmost head of the default branch
1032 @@ -1288,7 +1261,7 @@
1033 .IP i. 3
1036 -.UNINDENT
1037 +.RE
1039 When cloning from servers that support it, Mercurial may fetch
1040 pre\-generated data from a server\-advertised URL. When this is done,
1041 @@ -1296,18 +1269,18 @@
1042 once for the bundle fetched from the URL and another for any additional
1043 data not fetched from this URL. In addition, if an error occurs, the
1044 repository may be rolled back to a partial clone. This behavior may
1045 -change in future releases. See \%\fBhg help \-e clonebundles\fP\: for more.
1046 +change in future releases. See \fBhg help \-e clonebundles\fP for more.
1048 Examples:
1049 -.INDENT 0.0
1050 +.RS 0
1051 .IP \(bu 2
1053 clone a remote repository to a new directory named hg/:
1056 -.ft C
1057 +.ft
1058 hg clone https://www.mercurial\-scm.org/repo/hg/
1059 -.ft P
1060 +.ft
1062 .IP \(bu 2
1064 @@ -1314,9 +1287,9 @@
1065 create a lightweight local clone:
1068 -.ft C
1069 +.ft
1070 hg clone project/ project\-feature/
1071 -.ft P
1072 +.ft
1074 .IP \(bu 2
1076 @@ -1323,9 +1296,9 @@
1077 clone from an absolute path on an ssh server (note double\-slash):
1080 -.ft C
1081 +.ft
1082 hg clone ssh://user@server//home/projects/alpha/
1083 -.ft P
1084 +.ft
1086 .IP \(bu 2
1088 @@ -1332,9 +1305,9 @@
1089 do a streaming clone while checking out a specified version:
1092 -.ft C
1093 +.ft
1094 hg clone \-\-stream http://server/repo \-u 1.5
1095 -.ft P
1096 +.ft
1098 .IP \(bu 2
1100 @@ -1341,9 +1314,9 @@
1101 create a repository without changesets after a particular revision:
1104 -.ft C
1105 +.ft
1106 hg clone \-r 04e544 experimental/ good/
1107 -.ft P
1108 +.ft
1110 .IP \(bu 2
1112 @@ -1350,18 +1323,18 @@
1113 clone (and track) a particular named branch:
1116 -.ft C
1117 +.ft
1118 hg clone https://www.mercurial\-scm.org/repo/hg/#stable
1119 -.ft P
1120 +.ft
1122 -.UNINDENT
1123 +.RE
1125 -See \%\fBhg help urls\fP\: for details on specifying URLs.
1126 +See \fBhg help urls\fP for details on specifying URLs.
1128 Returns 0 on success.
1130 Options:
1131 -.INDENT 0.0
1132 +.RS 0
1134 .B \-U, \-\-noupdate
1136 @@ -1402,7 +1375,7 @@
1137 .B \-\-insecure
1139 do not verify server certificate (ignoring web.cacerts config)
1140 -.UNINDENT
1141 +.RE
1143 [+] marked option can be specified multiple times
1144 .SS commit
1145 @@ -1410,16 +1383,16 @@
1146 commit the specified files or all outstanding changes:
1149 -.ft C
1150 +.ft
1151 hg commit [OPTION]... [FILE]...
1152 -.ft P
1153 +.ft
1156 Commit changes to the given files into the repository. Unlike a
1157 centralized SCM, this operation is a local operation. See
1158 -\%\fBhg push\fP\: for a way to actively distribute your changes.
1159 +\fBhg push\fP for a way to actively distribute your changes.
1161 -If a list of files is omitted, all changes reported by \%\fBhg status\fP\:
1162 +If a list of files is omitted, all changes reported by \fBhg status\fP
1163 will be committed.
1165 If you are committing the result of a merge, do not provide any
1166 @@ -1428,7 +1401,7 @@
1167 If no commit message is specified, Mercurial starts your
1168 configured editor where you can enter a message. In case your
1169 commit fails, you will find a backup of your message in
1170 -\fB.hg/last\-message.txt\fP.
1171 +\fB\&.hg/last\-message.txt\fP.
1173 The \-\-close\-branch flag can be used to mark the current branch
1174 head closed. When all heads of a branch are closed, the branch
1175 @@ -1436,32 +1409,32 @@
1177 The \-\-amend flag can be used to amend the parent of the
1178 working directory with a new commit that contains the changes
1179 -in the parent in addition to those currently reported by \%\fBhg status\fP\:,
1180 +in the parent in addition to those currently reported by \fBhg status\fP,
1181 if there are any. The old commit is stored in a backup bundle in
1182 -\fB.hg/strip\-backup\fP (see \%\fBhg help bundle\fP\: and \%\fBhg help unbundle\fP\:
1183 +\fB\&.hg/strip\-backup\fP (see \fBhg help bundle\fP and \fBhg help unbundle\fP
1184 on how to restore it).
1186 Message, user and date are taken from the amended commit unless
1187 -specified. When a message isn\(aqt specified on the command line,
1188 +specified. When a message isn't specified on the command line,
1189 the editor will open with the message of the amended commit.
1191 -It is not possible to amend public changesets (see \%\fBhg help phases\fP\:)
1192 +It is not possible to amend public changesets (see \fBhg help phases\fP)
1193 or changesets that have children.
1195 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date.
1196 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date.
1198 Returns 0 on success, 1 if nothing changed.
1200 Examples:
1201 -.INDENT 0.0
1202 +.RS 0
1203 .IP \(bu 2
1205 commit all files ending in .py:
1208 -.ft C
1209 +.ft
1210 hg commit \-\-include "set:**.py"
1211 -.ft P
1212 +.ft
1214 .IP \(bu 2
1216 @@ -1468,9 +1441,9 @@
1217 commit all non\-binary files:
1220 -.ft C
1221 +.ft
1222 hg commit \-\-exclude "set:binary()"
1223 -.ft P
1224 +.ft
1226 .IP \(bu 2
1228 @@ -1477,14 +1450,14 @@
1229 amend the current commit and set the date to now:
1232 -.ft C
1233 +.ft
1234 hg commit \-\-amend \-\-date now
1235 -.ft P
1236 +.ft
1238 -.UNINDENT
1239 +.RE
1241 Options:
1242 -.INDENT 0.0
1243 +.RS 0
1245 .B \-A, \-\-addremove
1247 @@ -1537,23 +1510,23 @@
1248 .B \-S, \-\-subrepos
1250 recurse into subrepositories
1251 -.UNINDENT
1252 +.RE
1254 [+] marked option can be specified multiple times
1255 -.INDENT 0.0
1256 -.INDENT 3.5
1257 +.RS 0
1258 +.RS 3
1260 aliases: ci
1261 -.UNINDENT
1262 -.UNINDENT
1263 +.RE
1264 +.RE
1265 .SS config
1267 show combined config settings from all hgrc files:
1270 -.ft C
1271 +.ft
1272 hg config [\-u] [NAME]...
1273 -.ft P
1274 +.ft
1277 With no arguments, print names and values of all config items.
1278 @@ -1571,12 +1544,12 @@
1279 With \-\-debug, the source (filename and line number) is printed
1280 for each config item.
1282 -See \%\fBhg help config\fP\: for more information about config files.
1283 +See \fBhg help config\fP for more information about config files.
1285 Returns 0 on success, 1 if NAME does not exist.
1287 Options:
1288 -.INDENT 0.0
1289 +.RS 0
1291 .B \-u, \-\-untrusted
1293 @@ -1599,15 +1572,15 @@
1294 display with template (EXPERIMENTAL)
1296 aliases: showconfig debugconfig
1297 -.UNINDENT
1298 +.RE
1299 .SS copy
1301 mark files as copied for the next commit:
1304 -.ft C
1305 +.ft
1306 hg copy [OPTION]... [SOURCE]... DEST
1307 -.ft P
1308 +.ft
1311 Mark dest as having copies of source files. If dest is a
1312 @@ -1619,12 +1592,12 @@
1313 operation is recorded, but no copying is performed.
1315 This command takes effect with the next commit. To undo a copy
1316 -before that, see \%\fBhg revert\fP\:.
1317 +before that, see \fBhg revert\fP.
1319 Returns 0 on success, 1 if errors are encountered.
1321 Options:
1322 -.INDENT 0.0
1323 +.RS 0
1325 .B \-A, \-\-after
1327 @@ -1645,23 +1618,23 @@
1328 .B \-n, \-\-dry\-run
1330 do not perform actions, just print output
1331 -.UNINDENT
1332 +.RE
1334 [+] marked option can be specified multiple times
1335 -.INDENT 0.0
1336 -.INDENT 3.5
1337 +.RS 0
1338 +.RS 3
1340 aliases: cp
1341 -.UNINDENT
1342 -.UNINDENT
1343 +.RE
1344 +.RE
1345 .SS diff
1347 diff repository (or selected files):
1350 -.ft C
1351 +.ft
1352 hg diff [OPTION]... ([\-c REV] | [\-r REV1 [\-r REV2]]) [FILE]...
1353 -.ft P
1354 +.ft
1357 Show differences between revisions for the specified files.
1358 @@ -1669,8 +1642,8 @@
1359 Differences between files are shown using the unified diff format.
1360 .IP Note
1362 -\%\fBhg diff\fP\: may generate unexpected results for merges, as it will
1363 -default to comparing against the working directory\(aqs first
1364 +\fBhg diff\fP may generate unexpected results for merges, as it will
1365 +default to comparing against the working directory's first
1366 parent changeset if no revisions are specified.
1369 @@ -1688,18 +1661,18 @@
1370 anyway, probably with undesirable results.
1372 Use the \-g/\-\-git option to generate diffs in the git extended diff
1373 -format. For more information, read \%\fBhg help diffs\fP\:.
1374 +format. For more information, read \fBhg help diffs\fP.
1376 Examples:
1377 -.INDENT 0.0
1378 +.RS 0
1379 .IP \(bu 2
1381 compare a file in the current working directory to its parent:
1384 -.ft C
1385 +.ft
1386 hg diff foo.c
1387 -.ft P
1388 +.ft
1390 .IP \(bu 2
1392 @@ -1706,9 +1679,9 @@
1393 compare two historical versions of a directory, with rename info:
1396 -.ft C
1397 +.ft
1398 hg diff \-\-git \-r 1.0:1.2 lib/
1399 -.ft P
1400 +.ft
1402 .IP \(bu 2
1404 @@ -1715,9 +1688,9 @@
1405 get change stats relative to the last change on some date:
1408 -.ft C
1409 -hg diff \-\-stat \-r "date(\(aqmay 2\(aq)"
1410 -.ft P
1411 +.ft
1412 +hg diff \-\-stat \-r "date('may 2')"
1413 +.ft
1415 .IP \(bu 2
1417 @@ -1724,9 +1697,9 @@
1418 diff all newly\-added files that contain a keyword:
1421 -.ft C
1422 +.ft
1423 hg diff "set:added() and grep(GNU)"
1424 -.ft P
1425 +.ft
1427 .IP \(bu 2
1429 @@ -1733,18 +1706,18 @@
1430 compare a revision and its parents:
1433 -.ft C
1434 +.ft
1435 hg diff \-c 9353 # compare against first parent
1436 hg diff \-r 9353^:9353 # same using revset syntax
1437 hg diff \-r 9353^2:9353 # compare against the second parent
1438 -.ft P
1439 +.ft
1441 -.UNINDENT
1442 +.RE
1444 Returns 0 on success.
1446 Options:
1447 -.INDENT 0.0
1448 +.RS 0
1450 .BI \-r, \-\-rev \ <REV[+]>
1452 @@ -1821,7 +1794,7 @@
1453 .B \-S, \-\-subrepos
1455 recurse into subrepositories
1456 -.UNINDENT
1457 +.RE
1459 [+] marked option can be specified multiple times
1460 .SS export
1461 @@ -1829,9 +1802,9 @@
1462 dump the header and diffs for one or more changesets:
1465 -.ft C
1466 +.ft
1467 hg export [OPTION]... [\-o OUTFILESPEC] [\-r] [REV]...
1468 -.ft P
1469 +.ft
1472 Print the changeset header and diffs for one or more revisions.
1473 @@ -1842,7 +1815,7 @@
1474 comment.
1475 .IP Note
1477 -\%\fBhg export\fP\: may generate unexpected diff output for merge
1478 +\fBhg export\fP may generate unexpected diff output for merge
1479 changesets, as it will compare the merge changeset against its
1480 first parent only.
1482 @@ -1849,7 +1822,7 @@
1484 Output may be to a file, in which case the name of the file is
1485 given using a format string. The formatting rules are as follows:
1486 -.INDENT 0.0
1487 +.RS 0
1489 .B \fB%%\fP
1491 @@ -1886,7 +1859,7 @@
1492 .B \fB%r\fP
1494 zero\-padded changeset revision number
1495 -.UNINDENT
1496 +.RE
1498 Without the \-a/\-\-text option, export will avoid generating diffs
1499 of files it detects as binary. With \-a, export will generate a
1500 @@ -1893,13 +1866,13 @@
1501 diff anyway, probably with undesirable results.
1503 Use the \-g/\-\-git option to generate diffs in the git extended diff
1504 -format. See \%\fBhg help diffs\fP\: for more information.
1505 +format. See \fBhg help diffs\fP for more information.
1507 With the \-\-switch\-parent option, the diff will be against the
1508 second parent. It can be useful to review a merge.
1510 Examples:
1511 -.INDENT 0.0
1512 +.RS 0
1513 .IP \(bu 2
1515 use export and import to transplant a bugfix to the current
1516 @@ -1906,9 +1879,9 @@
1517 branch:
1520 -.ft C
1521 +.ft
1522 hg export \-r 9353 | hg import \-
1523 -.ft P
1524 +.ft
1526 .IP \(bu 2
1528 @@ -1916,9 +1889,9 @@
1529 rename information:
1532 -.ft C
1533 +.ft
1534 hg export \-\-git \-r 123:150 > changes.txt
1535 -.ft P
1536 +.ft
1538 .IP \(bu 2
1540 @@ -1926,16 +1899,16 @@
1541 descriptive names:
1544 -.ft C
1545 +.ft
1546 hg export \-r "outgoing()" \-o "%n\-%m.patch"
1547 -.ft P
1548 +.ft
1550 -.UNINDENT
1551 +.RE
1553 Returns 0 on success.
1555 Options:
1556 -.INDENT 0.0
1557 +.RS 0
1559 .BI \-o, \-\-output \ <FORMAT>
1561 @@ -1964,7 +1937,7 @@
1562 .B \-\-nodates
1564 omit dates from diff headers
1565 -.UNINDENT
1566 +.RE
1568 [+] marked option can be specified multiple times
1569 .SS files
1570 @@ -1972,9 +1945,9 @@
1571 list tracked files:
1574 -.ft C
1575 +.ft
1576 hg files [OPTION]... [FILE]...
1577 -.ft P
1578 +.ft
1581 Print files under Mercurial control in the working directory or
1582 @@ -1985,15 +1958,15 @@
1583 of all files under Mercurial control.
1585 Examples:
1586 -.INDENT 0.0
1587 +.RS 0
1588 .IP \(bu 2
1590 list all files under the current directory:
1593 -.ft C
1594 +.ft
1595 hg files .
1596 -.ft P
1597 +.ft
1599 .IP \(bu 2
1601 @@ -2000,9 +1973,9 @@
1602 shows sizes and flags for current revision:
1605 -.ft C
1606 +.ft
1607 hg files \-vr .
1608 -.ft P
1609 +.ft
1611 .IP \(bu 2
1613 @@ -2009,9 +1982,9 @@
1614 list all files named README:
1617 -.ft C
1618 +.ft
1619 hg files \-I "**/README"
1620 -.ft P
1621 +.ft
1623 .IP \(bu 2
1625 @@ -2018,9 +1991,9 @@
1626 list all binary files:
1629 -.ft C
1630 +.ft
1631 hg files "set:binary()"
1632 -.ft P
1633 +.ft
1635 .IP \(bu 2
1637 @@ -2027,9 +2000,9 @@
1638 find files containing a regular expression:
1641 -.ft C
1642 -hg files "set:grep(\(aqbob\(aq)"
1643 -.ft P
1644 +.ft
1645 +hg files "set:grep('bob')"
1646 +.ft
1648 .IP \(bu 2
1650 @@ -2036,19 +2009,19 @@
1651 search tracked file contents with xargs and grep:
1654 -.ft C
1655 +.ft
1656 hg files \-0 | xargs \-0 grep foo
1657 -.ft P
1658 +.ft
1660 -.UNINDENT
1661 +.RE
1663 -See \%\fBhg help patterns\fP\: and \%\fBhg help filesets\fP\: for more information
1664 +See \fBhg help patterns\fP and \fBhg help filesets\fP for more information
1665 on specifying file patterns.
1667 Returns 0 if a match is found, 1 otherwise.
1669 Options:
1670 -.INDENT 0.0
1671 +.RS 0
1673 .BI \-r, \-\-rev \ <REV>
1675 @@ -2073,7 +2046,7 @@
1676 .B \-S, \-\-subrepos
1678 recurse into subrepositories
1679 -.UNINDENT
1680 +.RE
1682 [+] marked option can be specified multiple times
1683 .SS forget
1684 @@ -2081,9 +2054,9 @@
1685 forget the specified files on the next commit:
1688 -.ft C
1689 +.ft
1690 hg forget [OPTION]... FILE...
1691 -.ft P
1692 +.ft
1695 Mark the specified files so they will no longer be tracked
1696 @@ -2093,20 +2066,20 @@
1697 entire project history, and it does not delete them from the
1698 working directory.
1700 -To delete the file from the working directory, see \%\fBhg remove\fP\:.
1701 +To delete the file from the working directory, see \fBhg remove\fP.
1703 -To undo a forget before the next commit, see \%\fBhg add\fP\:.
1704 +To undo a forget before the next commit, see \fBhg add\fP.
1706 Examples:
1707 -.INDENT 0.0
1708 +.RS 0
1709 .IP \(bu 2
1711 forget newly\-added binary files:
1714 -.ft C
1715 +.ft
1716 hg forget "set:added() and binary()"
1717 -.ft P
1718 +.ft
1720 .IP \(bu 2
1722 @@ -2113,16 +2086,16 @@
1723 forget files that would be excluded by .hgignore:
1726 -.ft C
1727 +.ft
1728 hg forget "set:hgignore()"
1729 -.ft P
1730 +.ft
1732 -.UNINDENT
1733 +.RE
1735 Returns 0 on success.
1737 Options:
1738 -.INDENT 0.0
1739 +.RS 0
1741 .BI \-I, \-\-include \ <PATTERN[+]>
1743 @@ -2131,7 +2104,7 @@
1744 .BI \-X, \-\-exclude \ <PATTERN[+]>
1746 exclude names matching the given patterns
1747 -.UNINDENT
1748 +.RE
1750 [+] marked option can be specified multiple times
1751 .SS graft
1752 @@ -2139,15 +2112,15 @@
1753 copy changes from other branches onto the current branch:
1756 -.ft C
1757 +.ft
1758 hg graft [OPTION]... [\-r REV]... REV...
1759 -.ft P
1760 +.ft
1763 -This command uses Mercurial\(aqs merge logic to copy individual
1764 +This command uses Mercurial's merge logic to copy individual
1765 changes from other branches without merging branches in the
1766 -history graph. This is sometimes known as \(aqbackporting\(aq or
1767 -\(aqcherry\-picking\(aq. By default, graft will copy user, date, and
1768 +history graph. This is sometimes known as 'backporting' or
1769 +\&'cherry\-picking'. By default, graft will copy user, date, and
1770 description from the source changesets.
1772 Changesets that are ancestors of the current revision, that have
1773 @@ -2157,9 +2130,9 @@
1774 of the form:
1777 -.ft C
1778 +.ft
1779 (grafted from CHANGESETHASH)
1780 -.ft P
1781 +.ft
1784 If \-\-force is specified, revisions will be grafted even if they
1785 @@ -2177,16 +2150,16 @@
1788 Examples:
1789 -.INDENT 0.0
1790 +.RS 0
1791 .IP \(bu 2
1793 copy a single change to the stable branch and edit its description:
1796 -.ft C
1797 +.ft
1798 hg update stable
1799 hg graft \-\-edit 9393
1800 -.ft P
1801 +.ft
1803 .IP \(bu 2
1805 @@ -2193,9 +2166,9 @@
1806 graft a range of changesets with one exception, updating dates:
1809 -.ft C
1810 +.ft
1811 hg graft \-D "2085::2093 and not 2091"
1812 -.ft P
1813 +.ft
1815 .IP \(bu 2
1817 @@ -2202,9 +2175,9 @@
1818 continue a graft after resolving conflicts:
1821 -.ft C
1822 +.ft
1823 hg graft \-c
1824 -.ft P
1825 +.ft
1827 .IP \(bu 2
1829 @@ -2211,9 +2184,9 @@
1830 show the source of a grafted changeset:
1833 -.ft C
1834 +.ft
1835 hg log \-\-debug \-r .
1836 -.ft P
1837 +.ft
1839 .IP \(bu 2
1841 @@ -2220,18 +2193,18 @@
1842 show revisions sorted by date:
1845 -.ft C
1846 +.ft
1847 hg log \-r "sort(all(), date)"
1848 -.ft P
1849 +.ft
1851 -.UNINDENT
1852 +.RE
1854 -See \%\fBhg help revisions\fP\: for more about specifying revisions.
1855 +See \fBhg help revisions\fP for more about specifying revisions.
1857 Returns 0 on successful completion.
1859 Options:
1860 -.INDENT 0.0
1861 +.RS 0
1863 .BI \-r, \-\-rev \ <REV[+]>
1865 @@ -2276,7 +2249,7 @@
1866 .B \-n, \-\-dry\-run
1868 do not perform actions, just print output
1869 -.UNINDENT
1870 +.RE
1872 [+] marked option can be specified multiple times
1873 .SS grep
1874 @@ -2284,9 +2257,9 @@
1875 search revision history for a pattern in specified files:
1878 -.ft C
1879 +.ft
1880 hg grep [OPTION]... PATTERN [FILE]...
1881 -.ft P
1882 +.ft
1885 Search revision history for a regular expression in the specified
1886 @@ -2301,14 +2274,14 @@
1887 PATTERN can be any Python (roughly Perl\-compatible) regular
1888 expression.
1890 -If no FILEs are specified (and \-f/\-\-follow isn\(aqt set), all files in
1891 -the repository are searched, including those that don\(aqt exist in the
1892 +If no FILEs are specified (and \-f/\-\-follow isn't set), all files in
1893 +the repository are searched, including those that don't exist in the
1894 current branch or have been deleted in a prior changeset.
1896 Returns 0 if a match is found, 1 otherwise.
1898 Options:
1899 -.INDENT 0.0
1900 +.RS 0
1902 .B \-0, \-\-print0
1904 @@ -2361,7 +2334,7 @@
1905 .BI \-X, \-\-exclude \ <PATTERN[+]>
1907 exclude names matching the given patterns
1908 -.UNINDENT
1909 +.RE
1911 [+] marked option can be specified multiple times
1912 .SS heads
1913 @@ -2369,9 +2342,9 @@
1914 show branch heads:
1917 -.ft C
1918 +.ft
1919 hg heads [\-ct] [\-r STARTREV] [REV]...
1920 -.ft P
1921 +.ft
1924 With no arguments, show all open branch heads in the repository.
1925 @@ -2381,11 +2354,11 @@
1927 If one or more REVs are given, only open branch heads on the
1928 branches associated with the specified changesets are shown. This
1929 -means that you can use \%\fBhg heads .\fP\: to see the heads on the
1930 +means that you can use \fBhg heads .\fP to see the heads on the
1931 currently checked\-out branch.
1933 If \-c/\-\-closed is specified, also show branch heads marked closed
1934 -(see \%\fBhg commit \-\-close\-branch\fP\:).
1935 +(see \fBhg commit \-\-close\-branch\fP).
1937 If STARTREV is specified, only those heads that are descendants of
1938 STARTREV will be displayed.
1939 @@ -2396,7 +2369,7 @@
1940 Returns 0 if matching heads are found, 1 if not.
1942 Options:
1943 -.INDENT 0.0
1944 +.RS 0
1946 .BI \-r, \-\-rev \ <STARTREV>
1948 @@ -2421,15 +2394,15 @@
1949 .BI \-T, \-\-template \ <TEMPLATE>
1951 display with template
1952 -.UNINDENT
1953 +.RE
1954 .SS help
1956 show help for a given topic or a help overview:
1959 -.ft C
1960 +.ft
1961 hg help [\-ecks] [TOPIC]
1962 -.ft P
1963 +.ft
1966 With no arguments, print a list of commands with short help messages.
1967 @@ -2440,7 +2413,7 @@
1968 Returns 0 if successful.
1970 Options:
1971 -.INDENT 0.0
1972 +.RS 0
1974 .B \-e, \-\-extension
1976 @@ -2457,7 +2430,7 @@
1977 .BI \-s, \-\-system \ <VALUE[+]>
1979 show help for specific platform(s)
1980 -.UNINDENT
1981 +.RE
1983 [+] marked option can be specified multiple times
1984 .SS identify
1985 @@ -2465,9 +2438,9 @@
1986 identify the working directory or specified revision:
1989 -.ft C
1990 +.ft
1991 hg identify [\-nibtB] [\-r REV] [SOURCE]
1992 -.ft P
1993 +.ft
1996 Print a summary identifying the repository state at REV using one or
1997 @@ -2482,15 +2455,15 @@
1998 cause lookup to operate on that repository/bundle.
2000 Examples:
2001 -.INDENT 0.0
2002 +.RS 0
2003 .IP \(bu 2
2005 generate a build identifier for the working directory:
2008 -.ft C
2009 +.ft
2010 hg id \-\-id > build\-id.dat
2011 -.ft P
2012 +.ft
2014 .IP \(bu 2
2016 @@ -2497,9 +2470,9 @@
2017 find the revision corresponding to a tag:
2020 -.ft C
2021 +.ft
2022 hg id \-n \-r 1.3
2023 -.ft P
2024 +.ft
2026 .IP \(bu 2
2028 @@ -2506,19 +2479,19 @@
2029 check the most recent revision of a remote repository:
2032 -.ft C
2033 +.ft
2034 hg id \-r tip https://www.mercurial\-scm.org/repo/hg/
2035 -.ft P
2036 +.ft
2038 -.UNINDENT
2039 +.RE
2041 -See \%\fBhg log\fP\: for generating more information about specific revisions,
2042 +See \fBhg log\fP for generating more information about specific revisions,
2043 including full hash identifiers.
2045 Returns 0 if successful.
2047 Options:
2048 -.INDENT 0.0
2049 +.RS 0
2051 .BI \-r, \-\-rev \ <REV>
2053 @@ -2561,15 +2534,15 @@
2054 display with template (EXPERIMENTAL)
2056 aliases: id
2057 -.UNINDENT
2058 +.RE
2059 .SS import
2061 import an ordered set of patches:
2064 -.ft C
2065 +.ft
2066 hg import [OPTION]... PATCH...
2067 -.ft P
2068 +.ft
2071 Import a list of patches and commit them individually (unless
2072 @@ -2595,7 +2568,7 @@
2073 text/plain body parts before first diff are added to the commit
2074 message.
2076 -If the imported patch was generated by \%\fBhg export\fP\:, user and
2077 +If the imported patch was generated by \fBhg export\fP, user and
2078 description from patch override values from message headers and
2079 body. Values given on command line with \-m/\-\-message and \-u/\-\-user
2080 override these.
2081 @@ -2605,42 +2578,42 @@
2082 resulting changeset has a different ID than the one recorded in
2083 the patch. This will guard against various ways that portable
2084 patch formats and mail systems might fail to transfer Mercurial
2085 -data or metadata. See \%\fBhg bundle\fP\: for lossless transmission.
2086 +data or metadata. See \fBhg bundle\fP for lossless transmission.
2088 Use \-\-partial to ensure a changeset will be created from the patch
2089 even if some hunks fail to apply. Hunks that fail to apply will be
2090 written to a <target\-file>.rej file. Conflicts can then be resolved
2091 -by hand before \%\fBhg commit \-\-amend\fP\: is run to update the created
2092 +by hand before \fBhg commit \-\-amend\fP is run to update the created
2093 changeset. This flag exists to let people import patches that
2094 partially apply without losing the associated metadata (author,
2095 date, description, ...).
2096 .IP Note
2098 -When no hunks apply cleanly, \%\fBhg import \-\-partial\fP\: will create
2099 +When no hunks apply cleanly, \fBhg import \-\-partial\fP will create
2100 an empty changeset, importing only the patch metadata.
2103 With \-s/\-\-similarity, hg will attempt to discover renames and
2104 -copies in the patch in the same way as \%\fBhg addremove\fP\:.
2105 +copies in the patch in the same way as \fBhg addremove\fP.
2107 It is possible to use external patch programs to perform the patch
2108 by setting the \fBui.patch\fP configuration option. For the default
2109 internal tool, the fuzz can also be configured via \fBpatch.fuzz\fP.
2110 -See \%\fBhg help config\fP\: for more information about configuration
2111 +See \fBhg help config\fP for more information about configuration
2112 files and how to use these options.
2114 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date.
2115 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date.
2117 Examples:
2118 -.INDENT 0.0
2119 +.RS 0
2120 .IP \(bu 2
2122 import a traditional patch from a website and detect renames:
2125 -.ft C
2126 +.ft
2127 hg import \-s 80 http://example.com/bugfix.patch
2128 -.ft P
2129 +.ft
2131 .IP \(bu 2
2133 @@ -2647,9 +2620,9 @@
2134 import a changeset from an hgweb server:
2137 -.ft C
2138 +.ft
2139 hg import https://www.mercurial\-scm.org/repo/hg/rev/5ca8c111e9aa
2140 -.ft P
2141 +.ft
2143 .IP \(bu 2
2145 @@ -2656,9 +2629,9 @@
2146 import all the patches in an Unix\-style mbox:
2149 -.ft C
2150 +.ft
2151 hg import incoming\-patches.mbox
2152 -.ft P
2153 +.ft
2155 .IP \(bu 2
2157 @@ -2665,9 +2638,9 @@
2158 import patches from stdin:
2161 -.ft C
2162 +.ft
2163 hg import \-
2164 -.ft P
2165 +.ft
2167 .IP \(bu 2
2169 @@ -2675,35 +2648,35 @@
2170 possible):
2173 -.ft C
2174 +.ft
2175 hg import \-\-exact proposed\-fix.patch
2176 -.ft P
2177 +.ft
2179 .IP \(bu 2
2181 use an external tool to apply a patch which is too fuzzy for
2182 the default internal tool.
2183 -.INDENT 2.0
2184 -.INDENT 3.5
2185 +.RS 2
2186 +.RS 3
2188 hg import \-\-config ui.patch="patch \-\-merge" fuzzy.patch
2189 -.UNINDENT
2190 -.UNINDENT
2191 +.RE
2192 +.RE
2193 .IP \(bu 2
2195 change the default fuzzing from 2 to a less strict 7
2196 -.INDENT 2.0
2197 -.INDENT 3.5
2198 +.RS 2
2199 +.RS 3
2201 hg import \-\-config ui.fuzz=7 fuzz.patch
2202 -.UNINDENT
2203 -.UNINDENT
2204 -.UNINDENT
2205 +.RE
2206 +.RE
2207 +.RE
2209 Returns 0 on success, 1 on partial success (see \-\-partial).
2211 Options:
2212 -.INDENT 0.0
2213 +.RS 0
2215 .BI \-p, \-\-strip \ <NUM>
2217 @@ -2723,7 +2696,7 @@
2219 .B \-\-no\-commit
2221 -don\(aqt commit, just update the working directory
2222 +don't commit, just update the working directory
2224 .B \-\-bypass
2226 @@ -2766,20 +2739,20 @@
2227 guess renamed files by similarity (0<=s<=100)
2229 aliases: patch
2230 -.UNINDENT
2231 +.RE
2232 .SS incoming
2234 show new changesets found in source:
2237 -.ft C
2238 +.ft
2239 hg incoming [\-p] [\-n] [\-M] [\-f] [\-r REV]... [\-\-bundle FILENAME] [SOURCE]
2240 -.ft P
2241 +.ft
2244 Show new changesets found in the specified path/URL or the default
2245 pull location. These are the changesets that would have been pulled
2246 -by \%\fBhg pull\fP\: at the time you issued this command.
2247 +by \fBhg pull\fP at the time you issued this command.
2249 See pull for valid source format details.
2251 @@ -2788,17 +2761,17 @@
2252 status is also displayed for each bookmark like below:
2255 -.ft C
2256 +.ft
2257 BM1 01234567890a added
2258 BM2 1234567890ab advanced
2259 BM3 234567890abc diverged
2260 BM4 34567890abcd changed
2261 -.ft P
2262 +.ft
2265 The action taken locally when pulling depends on the
2266 status of each bookmark:
2267 -.INDENT 0.0
2268 +.RS 0
2270 .B \fBadded\fP
2272 @@ -2815,7 +2788,7 @@
2273 .B \fBchanged\fP
2275 result depends on remote changesets
2276 -.UNINDENT
2277 +.RE
2279 From the point of view of pulling behavior, bookmark
2280 existing only in the remote repository are treated as \fBadded\fP,
2281 @@ -2825,15 +2798,15 @@
2282 changesets twice if the incoming is followed by a pull.
2284 Examples:
2285 -.INDENT 0.0
2286 +.RS 0
2287 .IP \(bu 2
2289 show incoming changes with patches and full description:
2292 -.ft C
2293 +.ft
2294 hg incoming \-vp
2295 -.ft P
2296 +.ft
2298 .IP \(bu 2
2300 @@ -2840,10 +2813,10 @@
2301 show incoming changes excluding merges, store a bundle:
2304 -.ft C
2305 +.ft
2306 hg in \-vpM \-\-bundle incoming.hg
2307 hg pull incoming.hg
2308 -.ft P
2309 +.ft
2311 .IP \(bu 2
2313 @@ -2850,16 +2823,16 @@
2314 briefly list changes inside a bundle:
2317 -.ft C
2318 +.ft
2319 hg in changes.hg \-T "{desc|firstline}\en"
2320 -.ft P
2321 +.ft
2323 -.UNINDENT
2324 +.RE
2326 Returns 0 if there are incoming changes, 1 otherwise.
2328 Options:
2329 -.INDENT 0.0
2330 +.RS 0
2332 .B \-f, \-\-force
2334 @@ -2932,23 +2905,23 @@
2335 .B \-S, \-\-subrepos
2337 recurse into subrepositories
2338 -.UNINDENT
2339 +.RE
2341 [+] marked option can be specified multiple times
2342 -.INDENT 0.0
2343 -.INDENT 3.5
2344 +.RS 0
2345 +.RS 3
2347 aliases: in
2348 -.UNINDENT
2349 -.UNINDENT
2350 +.RE
2351 +.RE
2352 .SS init
2354 create a new repository in the given directory:
2357 -.ft C
2358 +.ft
2359 hg init [\-e CMD] [\-\-remotecmd CMD] [DEST]
2360 -.ft P
2361 +.ft
2364 Initialize a new repository in the given directory. If the given
2365 @@ -2957,12 +2930,12 @@
2366 If no directory is given, the current directory is used.
2368 It is possible to specify an \fBssh://\fP URL as the destination.
2369 -See \%\fBhg help urls\fP\: for more information.
2370 +See \fBhg help urls\fP for more information.
2372 Returns 0 on success.
2374 Options:
2375 -.INDENT 0.0
2376 +.RS 0
2378 .BI \-e, \-\-ssh \ <CMD>
2380 @@ -2975,15 +2948,15 @@
2381 .B \-\-insecure
2383 do not verify server certificate (ignoring web.cacerts config)
2384 -.UNINDENT
2385 +.RE
2386 .SS locate
2388 locate files matching specific patterns (DEPRECATED):
2391 -.ft C
2392 +.ft
2393 hg locate [OPTION]... [PATTERN]...
2394 -.ft P
2395 +.ft
2398 Print files under Mercurial control in the working directory whose
2399 @@ -3001,12 +2974,12 @@
2400 will avoid the problem of "xargs" treating single filenames that
2401 contain whitespace as multiple filenames.
2403 -See \%\fBhg help files\fP\: for a more versatile command.
2404 +See \fBhg help files\fP for a more versatile command.
2406 Returns 0 if a match is found, 1 otherwise.
2408 Options:
2409 -.INDENT 0.0
2410 +.RS 0
2412 .BI \-r, \-\-rev \ <REV>
2414 @@ -3027,7 +3000,7 @@
2415 .BI \-X, \-\-exclude \ <PATTERN[+]>
2417 exclude names matching the given patterns
2418 -.UNINDENT
2419 +.RE
2421 [+] marked option can be specified multiple times
2422 .SS log
2423 @@ -3035,9 +3008,9 @@
2424 show revision history of entire repository or files:
2427 -.ft C
2428 +.ft
2429 hg log [OPTION]... [FILE]
2430 -.ft P
2431 +.ft
2434 Print the revision history of the specified files or the entire
2435 @@ -3059,11 +3032,11 @@
2437 With \-\-graph the revisions are shown as an ASCII art DAG with the most
2438 recent changeset at the top.
2439 -\(aqo\(aq is a changeset, \(aq@\(aq is a working directory parent, \(aqx\(aq is obsolete,
2440 -and \(aq+\(aq represents a fork where the changeset from the lines below is a
2441 -parent of the \(aqo\(aq merge on the same line.
2442 -Paths in the DAG are represented with \(aq|\(aq, \(aq/\(aq and so forth. \(aq:\(aq in place
2443 -of a \(aq|\(aq indicates one or more revisions in a path are omitted.
2444 +\&'o' is a changeset, '@' is a working directory parent, 'x' is obsolete,
2445 +and '+' represents a fork where the changeset from the lines below is a
2446 +parent of the 'o' merge on the same line.
2447 +Paths in the DAG are represented with '|', '/' and so forth. ':' in place
2448 +of a '|' indicates one or more revisions in a path are omitted.
2450 Use \-L/\-\-line\-range FILE,M:N options to follow the history of lines
2451 from M to N in FILE. With \-p/\-\-patch only diff hunks affecting
2452 @@ -3072,7 +3045,7 @@
2453 compatible with \-\-graph. This option is experimental.
2454 .IP Note
2456 -\%\fBhg log \-\-patch\fP\: may generate unexpected diff output for merge
2457 +\fBhg log \-\-patch\fP may generate unexpected diff output for merge
2458 changesets, as it will only compare the merge changeset against
2459 its first parent. Also, only files different from BOTH parents
2460 will appear in files:.
2461 @@ -3079,7 +3052,7 @@
2463 .IP Note
2465 -For performance reasons, \%\fBhg log FILE\fP\: may omit duplicate changes
2466 +For performance reasons, \fBhg log FILE\fP may omit duplicate changes
2467 made on branches and will not show removals or mode changes. To
2468 see all such changes, use the \-\-removed switch.
2470 @@ -3091,15 +3064,15 @@
2473 Some examples:
2474 -.INDENT 0.0
2475 +.RS 0
2476 .IP \(bu 2
2478 changesets with full descriptions and file lists:
2481 -.ft C
2482 +.ft
2483 hg log \-v
2484 -.ft P
2485 +.ft
2487 .IP \(bu 2
2489 @@ -3106,9 +3079,9 @@
2490 changesets ancestral to the working directory:
2493 -.ft C
2494 +.ft
2495 hg log \-f
2496 -.ft P
2497 +.ft
2499 .IP \(bu 2
2501 @@ -3115,9 +3088,9 @@
2502 last 10 commits on the current branch:
2505 -.ft C
2506 +.ft
2507 hg log \-l 10 \-b .
2508 -.ft P
2509 +.ft
2511 .IP \(bu 2
2513 @@ -3124,9 +3097,9 @@
2514 changesets showing all modifications of a file, including removals:
2517 -.ft C
2518 +.ft
2519 hg log \-\-removed file.c
2520 -.ft P
2521 +.ft
2523 .IP \(bu 2
2525 @@ -3133,9 +3106,9 @@
2526 all changesets that touch a directory, with diffs, excluding merges:
2529 -.ft C
2530 +.ft
2531 hg log \-Mp lib/
2532 -.ft P
2533 +.ft
2535 .IP \(bu 2
2537 @@ -3142,9 +3115,9 @@
2538 all revision numbers that match a keyword:
2541 -.ft C
2542 +.ft
2543 hg log \-k bug \-\-template "{rev}\en"
2544 -.ft P
2545 +.ft
2547 .IP \(bu 2
2549 @@ -3151,9 +3124,9 @@
2550 the full hash identifier of the working directory parent:
2553 -.ft C
2554 +.ft
2555 hg log \-r . \-\-template "{node}\en"
2556 -.ft P
2557 +.ft
2559 .IP \(bu 2
2561 @@ -3160,9 +3133,9 @@
2562 list available log templates:
2565 -.ft C
2566 +.ft
2567 hg log \-T list
2568 -.ft P
2569 +.ft
2571 .IP \(bu 2
2573 @@ -3169,9 +3142,9 @@
2574 check if a given changeset is included in a tagged release:
2577 -.ft C
2578 +.ft
2579 hg log \-r "a21ccf and ancestor(1.9)"
2580 -.ft P
2581 +.ft
2583 .IP \(bu 2
2585 @@ -3178,9 +3151,9 @@
2586 find all changesets by some user in a date range:
2589 -.ft C
2590 +.ft
2591 hg log \-k alice \-d "may 2008 to jul 2008"
2592 -.ft P
2593 +.ft
2595 .IP \(bu 2
2597 @@ -3187,9 +3160,9 @@
2598 summary of all changesets after the last tag:
2601 -.ft C
2602 +.ft
2603 hg log \-r "last(tagged())::" \-\-template "{desc|firstline}\en"
2604 -.ft P
2605 +.ft
2607 .IP \(bu 2
2609 @@ -3196,9 +3169,9 @@
2610 changesets touching lines 13 to 23 for file.c:
2613 -.ft C
2614 +.ft
2615 hg log \-L file.c,13:23
2616 -.ft P
2617 +.ft
2619 .IP \(bu 2
2621 @@ -3206,18 +3179,18 @@
2622 main.c with patch:
2625 -.ft C
2626 +.ft
2627 hg log \-L file.c,13:23 \-L main.c,2:6 \-p
2628 -.ft P
2629 +.ft
2631 -.UNINDENT
2632 +.RE
2634 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date.
2635 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date.
2637 -See \%\fBhg help revisions\fP\: for more about specifying and ordering
2638 +See \fBhg help revisions\fP for more about specifying and ordering
2639 revisions.
2641 -See \%\fBhg help templates\fP\: for more about pre\-packaged styles and
2642 +See \fBhg help templates\fP for more about pre\-packaged styles and
2643 specifying custom templates. The default template used by the log
2644 command can be customized via the \fBui.logtemplate\fP configuration
2645 setting.
2646 @@ -3225,7 +3198,7 @@
2647 Returns 0 on success.
2649 Options:
2650 -.INDENT 0.0
2651 +.RS 0
2653 .B \-f, \-\-follow
2655 @@ -3318,23 +3291,23 @@
2656 .BI \-X, \-\-exclude \ <PATTERN[+]>
2658 exclude names matching the given patterns
2659 -.UNINDENT
2660 +.RE
2662 [+] marked option can be specified multiple times
2663 -.INDENT 0.0
2664 -.INDENT 3.5
2665 +.RS 0
2666 +.RS 3
2668 aliases: history
2669 -.UNINDENT
2670 -.UNINDENT
2671 +.RE
2672 +.RE
2673 .SS manifest
2675 output the current or given revision of the project manifest:
2678 -.ft C
2679 +.ft
2680 hg manifest [\-r REV]
2681 -.ft P
2682 +.ft
2685 Print a list of version controlled files for the given revision.
2686 @@ -3350,7 +3323,7 @@
2687 Returns 0 on success.
2689 Options:
2690 -.INDENT 0.0
2691 +.RS 0
2693 .BI \-r, \-\-rev \ <REV>
2695 @@ -3363,15 +3336,15 @@
2696 .BI \-T, \-\-template \ <TEMPLATE>
2698 display with template (EXPERIMENTAL)
2699 -.UNINDENT
2700 +.RE
2701 .SS merge
2703 merge another revision into working directory:
2706 -.ft C
2707 +.ft
2708 hg merge [\-P] [[\-r] REV]
2709 -.ft P
2710 +.ft
2713 The current working directory is updated with all changes made in
2714 @@ -3384,16 +3357,16 @@
2716 \fB\-\-tool\fP can be used to specify the merge tool used for file
2717 merges. It overrides the HGMERGE environment variable and your
2718 -configuration files. See \%\fBhg help merge\-tools\fP\: for options.
2719 +configuration files. See \fBhg help merge\-tools\fP for options.
2721 -If no revision is specified, the working directory\(aqs parent is a
2722 +If no revision is specified, the working directory's parent is a
2723 head revision, and the current branch contains exactly one other
2724 head, the other head is merged with by default. Otherwise, an
2725 explicit revision with which to merge with must be provided.
2727 -See \%\fBhg help resolve\fP\: for information on handling file conflicts.
2728 +See \fBhg help resolve\fP for information on handling file conflicts.
2730 -To undo an uncommitted merge, use \%\fBhg update \-\-clean .\fP\: which
2731 +To undo an uncommitted merge, use \fBhg update \-\-clean .\fP which
2732 will check out a clean copy of the original merge parent, losing
2733 all changes.
2735 @@ -3400,7 +3373,7 @@
2736 Returns 0 on success, 1 if there are unresolved files.
2738 Options:
2739 -.INDENT 0.0
2740 +.RS 0
2742 .B \-f, \-\-force
2744 @@ -3417,15 +3390,15 @@
2745 .BI \-t, \-\-tool \ <VALUE>
2747 specify merge tool
2748 -.UNINDENT
2749 +.RE
2750 .SS outgoing
2752 show changesets not found in the destination:
2755 -.ft C
2756 +.ft
2757 hg outgoing [\-M] [\-p] [\-n] [\-f] [\-r REV]... [DEST]
2758 -.ft P
2759 +.ft
2762 Show changesets not found in the specified destination repository
2763 @@ -3439,18 +3412,18 @@
2764 status is also displayed for each bookmark like below:
2767 -.ft C
2768 +.ft
2769 BM1 01234567890a added
2770 BM2 deleted
2771 BM3 234567890abc advanced
2772 BM4 34567890abcd diverged
2773 BM5 4567890abcde changed
2774 -.ft P
2775 +.ft
2778 The action taken when pushing depends on the
2779 status of each bookmark:
2780 -.INDENT 0.0
2781 +.RS 0
2783 .B \fBadded\fP
2785 @@ -3471,7 +3444,7 @@
2786 .B \fBchanged\fP
2788 push with \fB\-B\fP will update it
2789 -.UNINDENT
2790 +.RE
2792 From the point of view of pushing behavior, bookmarks
2793 existing only in the remote repository are treated as
2794 @@ -3480,7 +3453,7 @@
2795 Returns 0 if there are outgoing changes, 1 otherwise.
2797 Options:
2798 -.INDENT 0.0
2799 +.RS 0
2801 .B \-f, \-\-force
2803 @@ -3549,26 +3522,26 @@
2804 .B \-S, \-\-subrepos
2806 recurse into subrepositories
2807 -.UNINDENT
2808 +.RE
2810 [+] marked option can be specified multiple times
2811 -.INDENT 0.0
2812 -.INDENT 3.5
2813 +.RS 0
2814 +.RS 3
2816 aliases: out
2817 -.UNINDENT
2818 -.UNINDENT
2819 +.RE
2820 +.RE
2821 .SS parents
2823 show the parents of the working directory or revision (DEPRECATED):
2826 -.ft C
2827 +.ft
2828 hg parents [\-r REV] [FILE]
2829 -.ft P
2830 +.ft
2833 -Print the working directory\(aqs parent revisions. If a revision is
2834 +Print the working directory's parent revisions. If a revision is
2835 given via \-r/\-\-rev, the parent of that revision will be printed.
2836 If a file argument is given, the revision in which the file was
2837 last changed (before the working directory revision or the
2838 @@ -3577,20 +3550,20 @@
2839 This command is equivalent to:
2842 -.ft C
2843 +.ft
2844 hg log \-r "p1()+p2()" or
2845 hg log \-r "p1(REV)+p2(REV)" or
2846 hg log \-r "max(::p1() and file(FILE))+max(::p2() and file(FILE))" or
2847 hg log \-r "max(::p1(REV) and file(FILE))+max(::p2(REV) and file(FILE))"
2848 -.ft P
2849 +.ft
2852 -See \%\fBhg summary\fP\: and \%\fBhg help revsets\fP\: for related information.
2853 +See \fBhg summary\fP and \fBhg help revsets\fP for related information.
2855 Returns 0 on success.
2857 Options:
2858 -.INDENT 0.0
2859 +.RS 0
2861 .BI \-r, \-\-rev \ <REV>
2863 @@ -3603,15 +3576,15 @@
2864 .BI \-T, \-\-template \ <TEMPLATE>
2866 display with template
2867 -.UNINDENT
2868 +.RE
2869 .SS paths
2871 show aliases for remote repositories:
2874 -.ft C
2875 +.ft
2876 hg paths [NAME]
2877 -.ft P
2878 +.ft
2881 Show definition of symbolic path name NAME. If no name is given,
2882 @@ -3634,29 +3607,29 @@
2883 .IP Note
2885 \fBdefault\fP and \fBdefault\-push\fP apply to all inbound (e.g.
2886 -\%\fBhg incoming\fP\:) and outbound (e.g. \%\fBhg outgoing\fP\:, \%\fBhg email\fP\:
2887 -and \%\fBhg bundle\fP\:) operations.
2888 +\fBhg incoming\fP) and outbound (e.g. \fBhg outgoing\fP, \fBhg email\fP
2889 +and \fBhg bundle\fP) operations.
2892 -See \%\fBhg help urls\fP\: for more information.
2893 +See \fBhg help urls\fP for more information.
2895 Returns 0 on success.
2897 Options:
2898 -.INDENT 0.0
2899 +.RS 0
2901 .BI \-T, \-\-template \ <TEMPLATE>
2903 display with template (EXPERIMENTAL)
2904 -.UNINDENT
2905 +.RE
2906 .SS phase
2908 set or show the current phase name:
2911 -.ft C
2912 +.ft
2913 hg phase [\-p|\-d|\-s] [\-f] [\-r] [REV...]
2914 -.ft P
2915 +.ft
2918 With no argument, show the phase name of the current revision(s).
2919 @@ -3664,21 +3637,21 @@
2920 With one of \-p/\-\-public, \-d/\-\-draft or \-s/\-\-secret, change the
2921 phase value of the specified revisions.
2923 -Unless \-f/\-\-force is specified, \%\fBhg phase\fP\: won\(aqt move changesets from a
2924 +Unless \-f/\-\-force is specified, \fBhg phase\fP won't move changesets from a
2925 lower phase to a higher phase. Phases are ordered as follows:
2928 -.ft C
2929 +.ft
2930 public < draft < secret
2931 -.ft P
2932 +.ft
2935 Returns 0 on success, 1 if some phases could not be changed.
2937 -(For more information about the phases concept, see \%\fBhg help phases\fP\:.)
2938 +(For more information about the phases concept, see \fBhg help phases\fP.)
2940 Options:
2941 -.INDENT 0.0
2942 +.RS 0
2944 .B \-p, \-\-public
2946 @@ -3699,7 +3672,7 @@
2947 .BI \-r, \-\-rev \ <REV[+]>
2949 target revision
2950 -.UNINDENT
2951 +.RE
2953 [+] marked option can be specified multiple times
2954 .SS pull
2955 @@ -3707,9 +3680,9 @@
2956 pull changes from the specified source:
2959 -.ft C
2960 +.ft
2961 hg pull [\-u] [\-f] [\-r REV]... [\-e CMD] [\-\-remotecmd CMD] [SOURCE]
2962 -.ft P
2963 +.ft
2966 Pull changes from a remote repository to a local one.
2967 @@ -3719,21 +3692,21 @@
2968 \-R is specified). By default, this does not update the copy of the
2969 project in the working directory.
2971 -Use \%\fBhg incoming\fP\: if you want to see what would have been added
2972 +Use \fBhg incoming\fP if you want to see what would have been added
2973 by a pull at the time you issued this command. If you then decide
2974 -to add those changes to the repository, you should use \%\fBhg pull
2975 -\-r X\fP\: where \fBX\fP is the last changeset listed by \%\fBhg incoming\fP\:.
2976 +to add those changes to the repository, you should use \fBhg pull
2977 +\-r X\fP where \fBX\fP is the last changeset listed by \fBhg incoming\fP.
2979 -If SOURCE is omitted, the \(aqdefault\(aq path will be used.
2980 -See \%\fBhg help urls\fP\: for more information.
2981 +If SOURCE is omitted, the 'default' path will be used.
2982 +See \fBhg help urls\fP for more information.
2984 Specifying bookmark as \fB.\fP is equivalent to specifying the active
2985 -bookmark\(aqs name.
2986 +bookmark's name.
2988 Returns 0 on success, 1 if an update had unresolved files.
2990 Options:
2991 -.INDENT 0.0
2992 +.RS 0
2994 .B \-u, \-\-update
2996 @@ -3766,7 +3739,7 @@
2997 .B \-\-insecure
2999 do not verify server certificate (ignoring web.cacerts config)
3000 -.UNINDENT
3001 +.RE
3003 [+] marked option can be specified multiple times
3004 .SS push
3005 @@ -3774,9 +3747,9 @@
3006 push changes to the specified destination:
3009 -.ft C
3010 +.ft
3011 hg push [\-f] [\-r REV]... [\-e CMD] [\-\-remotecmd CMD] [DEST]
3012 -.ft P
3013 +.ft
3016 Push changesets from the local repository to the specified
3017 @@ -3806,9 +3779,9 @@
3018 If \-B/\-\-bookmark is used, the specified bookmarked revision, its
3019 ancestors, and the bookmark will be pushed to the remote
3020 repository. Specifying \fB.\fP is equivalent to specifying the active
3021 -bookmark\(aqs name.
3022 +bookmark's name.
3024 -Please see \%\fBhg help urls\fP\: for important details about \fBssh://\fP
3025 +Please see \fBhg help urls\fP for important details about \fBssh://\fP
3026 URLs. If DESTINATION is omitted, a default path will be used.
3028 The \-\-pushvars option sends strings to the server that become
3029 @@ -3826,16 +3799,16 @@
3030 following to your configuration file:
3033 -.ft C
3034 +.ft
3035 [push]
3036 pushvars.server = true
3037 -.ft P
3038 +.ft
3041 Returns 0 if push was successful, 1 if nothing to push.
3043 Options:
3044 -.INDENT 0.0
3045 +.RS 0
3047 .B \-f, \-\-force
3049 @@ -3872,7 +3845,7 @@
3050 .B \-\-insecure
3052 do not verify server certificate (ignoring web.cacerts config)
3053 -.UNINDENT
3054 +.RE
3056 [+] marked option can be specified multiple times
3057 .SS recover
3058 @@ -3880,9 +3853,9 @@
3059 roll back an interrupted transaction:
3062 -.ft C
3063 +.ft
3064 hg recover
3065 -.ft P
3066 +.ft
3069 Recover from an interrupted commit or pull.
3070 @@ -3897,16 +3870,16 @@
3071 remove the specified files on the next commit:
3074 -.ft C
3075 +.ft
3076 hg remove [OPTION]... FILE...
3077 -.ft P
3078 +.ft
3081 Schedule the indicated files for removal from the current branch.
3083 This command schedules the files to be removed at the next commit.
3084 -To undo a remove before that, see \%\fBhg revert\fP\:. To undo added
3085 -files, see \%\fBhg forget\fP\:.
3086 +To undo a remove before that, see \fBhg revert\fP. To undo added
3087 +files, see \fBhg forget\fP.
3089 \-A/\-\-after can be used to remove only files that have already
3090 been deleted, \-f/\-\-force can be used to force deletion, and \-Af
3091 @@ -3916,7 +3889,7 @@
3092 The following table details the behavior of remove for different
3093 file states (columns) and option combinations (rows). The file
3094 states are Added [A], Clean [C], Modified [M] and Missing [!]
3095 -(as reported by \%\fBhg status\fP\:). The actions are Warn, Remove
3096 +(as reported by \fBhg status\fP). The actions are Warn, Remove
3097 (from branch) and Delete (from disk):
3099 center;
3100 @@ -3985,7 +3958,7 @@
3102 .IP Note
3104 -\%\fBhg remove\fP\: never deletes files in Added [A] state from the
3105 +\fBhg remove\fP never deletes files in Added [A] state from the
3106 working directory, not even if \fB\-\-force\fP is specified.
3109 @@ -3992,7 +3965,7 @@
3110 Returns 0 on success, 1 if any warnings encountered.
3112 Options:
3113 -.INDENT 0.0
3114 +.RS 0
3116 .B \-A, \-\-after
3118 @@ -4013,23 +3986,23 @@
3119 .BI \-X, \-\-exclude \ <PATTERN[+]>
3121 exclude names matching the given patterns
3122 -.UNINDENT
3123 +.RE
3125 [+] marked option can be specified multiple times
3126 -.INDENT 0.0
3127 -.INDENT 3.5
3128 +.RS 0
3129 +.RS 3
3131 aliases: rm
3132 -.UNINDENT
3133 -.UNINDENT
3134 +.RE
3135 +.RE
3136 .SS rename
3138 rename files; equivalent of copy + remove:
3141 -.ft C
3142 +.ft
3143 hg rename [OPTION]... SOURCE... DEST
3144 -.ft P
3145 +.ft
3148 Mark dest as copies of sources; mark sources for deletion. If dest
3149 @@ -4041,12 +4014,12 @@
3150 operation is recorded, but no copying is performed.
3152 This command takes effect at the next commit. To undo a rename
3153 -before that, see \%\fBhg revert\fP\:.
3154 +before that, see \fBhg revert\fP.
3156 Returns 0 on success, 1 if errors are encountered.
3158 Options:
3159 -.INDENT 0.0
3160 +.RS 0
3162 .B \-A, \-\-after
3164 @@ -4067,23 +4040,23 @@
3165 .B \-n, \-\-dry\-run
3167 do not perform actions, just print output
3168 -.UNINDENT
3169 +.RE
3171 [+] marked option can be specified multiple times
3172 -.INDENT 0.0
3173 -.INDENT 3.5
3174 +.RS 0
3175 +.RS 3
3177 aliases: move mv
3178 -.UNINDENT
3179 -.UNINDENT
3180 +.RE
3181 +.RE
3182 .SS resolve
3184 redo merges or set/view the merge status of files:
3187 -.ft C
3188 +.ft
3189 hg resolve [OPTION]... [FILE]...
3190 -.ft P
3191 +.ft
3194 Merges with unresolved conflicts are often the result of
3195 @@ -4090,15 +4063,15 @@
3196 non\-interactive merging using the \fBinternal:merge\fP configuration
3197 setting, or a command\-line merge tool like \fBdiff3\fP. The resolve
3198 command is used to manage the files involved in a merge, after
3199 -\%\fBhg merge\fP\: has been run, and before \%\fBhg commit\fP\: is run (i.e. the
3200 -working directory must have two parents). See \%\fBhg help
3201 -merge\-tools\fP\: for information on configuring merge tools.
3202 +\fBhg merge\fP has been run, and before \fBhg commit\fP is run (i.e. the
3203 +working directory must have two parents). See \fBhg help
3204 +merge\-tools\fP for information on configuring merge tools.
3206 The resolve command can be used in the following ways:
3207 -.INDENT 0.0
3208 +.RS 0
3209 .IP \(bu 2
3211 -\%\fBhg resolve [\-\-tool TOOL] FILE...\fP\:: attempt to re\-merge the specified
3212 +\fBhg resolve [\-\-tool TOOL] FILE...\fP: attempt to re\-merge the specified
3213 files, discarding any previous merge attempts. Re\-merging is not
3214 performed for files already marked as resolved. Use \fB\-\-all/\-a\fP
3215 to select all unresolved files. \fB\-\-tool\fP can be used to specify
3216 @@ -4107,24 +4080,24 @@
3217 contents are saved with a \fB.orig\fP suffix.
3218 .IP \(bu 2
3220 -\%\fBhg resolve \-m [FILE]\fP\:: mark a file as having been resolved
3221 +\fBhg resolve \-m [FILE]\fP: mark a file as having been resolved
3222 (e.g. after having manually fixed\-up the files). The default is
3223 to mark all unresolved files.
3224 .IP \(bu 2
3226 -\%\fBhg resolve \-u [FILE]...\fP\:: mark a file as unresolved. The
3227 +\fBhg resolve \-u [FILE]...\fP: mark a file as unresolved. The
3228 default is to mark all resolved files.
3229 .IP \(bu 2
3231 -\%\fBhg resolve \-l\fP\:: list files which had or still have conflicts.
3232 +\fBhg resolve \-l\fP: list files which had or still have conflicts.
3233 In the printed list, \fBU\fP = unresolved and \fBR\fP = resolved.
3234 You can use \fBset:unresolved()\fP or \fBset:resolved()\fP to filter
3235 -the list. See \%\fBhg help filesets\fP\: for details.
3236 -.UNINDENT
3237 +the list. See \fBhg help filesets\fP for details.
3238 +.RE
3239 .IP Note
3241 Mercurial will not let you commit files with unresolved merge
3242 -conflicts. You must use \%\fBhg resolve \-m ...\fP\: before you can
3243 +conflicts. You must use \fBhg resolve \-m ...\fP before you can
3244 commit after a conflicting merge.
3247 @@ -4131,7 +4104,7 @@
3248 Returns 0 on success, 1 if any files fail a resolve attempt.
3250 Options:
3251 -.INDENT 0.0
3252 +.RS 0
3254 .B \-a, \-\-all
3256 @@ -4168,7 +4141,7 @@
3257 .BI \-T, \-\-template \ <TEMPLATE>
3259 display with template (EXPERIMENTAL)
3260 -.UNINDENT
3261 +.RE
3263 [+] marked option can be specified multiple times
3264 .SS revert
3265 @@ -4176,15 +4149,15 @@
3266 restore files to their checkout state:
3269 -.ft C
3270 +.ft
3271 hg revert [OPTION]... [\-r REV] [NAME]...
3272 -.ft P
3273 +.ft
3275 .IP Note
3277 -To check out earlier revisions, you should use \%\fBhg update REV\fP\:.
3278 +To check out earlier revisions, you should use \fBhg update REV\fP.
3279 To cancel an uncommitted merge (and lose your changes),
3280 -use \%\fBhg update \-\-clean .\fP\:.
3281 +use \fBhg update \-\-clean .\fP.
3284 With no revision specified, revert the specified files or directories
3285 @@ -4198,7 +4171,7 @@
3286 directories to their states as of a specific revision. Because
3287 revert does not change the working directory parents, this will
3288 cause these files to appear modified. This can be helpful to "back
3289 -out" some or all of an earlier change. See \%\fBhg backout\fP\: for a
3290 +out" some or all of an earlier change. See \fBhg backout\fP for a
3291 related method.
3293 Modified files are saved with a .orig suffix before reverting.
3294 @@ -4207,15 +4180,15 @@
3295 repository by setting the \fBui.origbackuppath\fP configuration
3296 option.
3298 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date.
3299 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date.
3301 -See \%\fBhg help backout\fP\: for a way to reverse the effect of an
3302 +See \fBhg help backout\fP for a way to reverse the effect of an
3303 earlier changeset.
3305 Returns 0 on success.
3307 Options:
3308 -.INDENT 0.0
3309 +.RS 0
3311 .B \-a, \-\-all
3313 @@ -4248,7 +4221,7 @@
3314 .B \-n, \-\-dry\-run
3316 do not perform actions, just print output
3317 -.UNINDENT
3318 +.RE
3320 [+] marked option can be specified multiple times
3321 .SS rollback
3322 @@ -4256,12 +4229,12 @@
3323 roll back the last transaction (DANGEROUS) (DEPRECATED):
3326 -.ft C
3327 +.ft
3328 hg rollback
3329 -.ft P
3330 +.ft
3333 -Please use \%\fBhg commit \-\-amend\fP\: instead of rollback to correct
3334 +Please use \fBhg commit \-\-amend\fP instead of rollback to correct
3335 mistakes in the last commit.
3337 This command should be used with care. There is only one level of
3338 @@ -4276,7 +4249,7 @@
3340 For example, the following commands are transactional, and their
3341 effects can be rolled back:
3342 -.INDENT 0.0
3343 +.RS 0
3344 .IP \(bu 2
3346 commit
3347 @@ -4292,15 +4265,15 @@
3348 .IP \(bu 2
3350 unbundle
3351 -.UNINDENT
3352 +.RE
3354 To avoid permanent data loss, rollback will refuse to rollback a
3355 -commit transaction if it isn\(aqt checked out. Use \-\-force to
3356 +commit transaction if it isn't checked out. Use \-\-force to
3357 override this protection.
3359 The rollback command can be entirely disabled by setting the
3360 -\fBui.rollback\fP configuration setting to false. If you\(aqre here
3361 -because you want to use rollback and it\(aqs disabled, you can
3362 +\fBui.rollback\fP configuration setting to false. If you're here
3363 +because you want to use rollback and it's disabled, you can
3364 re\-enable the command by setting \fBui.rollback\fP to true.
3366 This command is not intended for use on public repositories. Once
3367 @@ -4313,7 +4286,7 @@
3368 Returns 0 on success, 1 if no rollback data is available.
3370 Options:
3371 -.INDENT 0.0
3372 +.RS 0
3374 .B \-n, \-\-dry\-run
3376 @@ -4322,15 +4295,15 @@
3377 .B \-f, \-\-force
3379 ignore safety measures
3380 -.UNINDENT
3381 +.RE
3382 .SS root
3384 print the root (top) of the current working directory:
3387 -.ft C
3388 +.ft
3389 hg root
3390 -.ft P
3391 +.ft
3394 Print the root directory of the current repository.
3395 @@ -4341,9 +4314,9 @@
3396 start stand\-alone webserver:
3399 -.ft C
3400 +.ft
3401 hg serve [OPTION]...
3402 -.ft P
3403 +.ft
3406 Start a local HTTP repository browser and pull server. You can use
3407 @@ -4368,7 +4341,7 @@
3408 Returns 0 on success.
3410 Options:
3411 -.INDENT 0.0
3412 +.RS 0
3414 .BI \-A, \-\-accesslog \ <FILE>
3416 @@ -4404,7 +4377,7 @@
3418 .BI \-\-web\-conf \ <FILE>
3420 -name of the hgweb config file (see \(aqhg help hgweb\(aq)
3421 +name of the hgweb config file (see 'hg help hgweb')
3423 .BI \-\-webdir\-conf \ <FILE>
3425 @@ -4441,7 +4414,7 @@
3426 .B \-S, \-\-subrepos
3428 recurse into subrepositories
3429 -.UNINDENT
3430 +.RE
3432 [+] marked option can be specified multiple times
3433 .SS status
3434 @@ -4449,9 +4422,9 @@
3435 show changed files in the working directory:
3438 -.ft C
3439 +.ft
3440 hg status [OPTION]... [FILE]...
3441 -.ft P
3442 +.ft
3445 Show status of files in the repository. If names are given, only
3446 @@ -4465,7 +4438,7 @@
3447 unless explicitly requested with \-u/\-\-unknown or \-i/\-\-ignored.
3448 .IP Note
3450 -\%\fBhg status\fP\: may appear to disagree with diff if permissions have
3451 +\fBhg status\fP may appear to disagree with diff if permissions have
3452 changed or a merge has occurred. The standard diff format does
3453 not report permission changes and diff only reports changes
3454 relative to one merge parent.
3455 @@ -4479,7 +4452,7 @@
3456 The codes used to show the status of files are:
3459 -.ft C
3460 +.ft
3461 M = modified
3462 A = added
3463 R = removed
3464 @@ -4488,17 +4461,17 @@
3465 ? = not tracked
3466 I = ignored
3467 = origin of the previous file (with \-\-copies)
3468 -.ft P
3469 +.ft
3472 The \-t/\-\-terse option abbreviates the output by showing only the directory
3473 name if all the files in it share the same status. The option takes an
3474 -argument indicating the statuses to abbreviate: \(aqm\(aq for \(aqmodified\(aq, \(aqa\(aq
3475 -for \(aqadded\(aq, \(aqr\(aq for \(aqremoved\(aq, \(aqd\(aq for \(aqdeleted\(aq, \(aqu\(aq for \(aqunknown\(aq, \(aqi\(aq
3476 -for \(aqignored\(aq and \(aqc\(aq for clean.
3477 +argument indicating the statuses to abbreviate: 'm' for 'modified', 'a'
3478 +for 'added', 'r' for 'removed', 'd' for 'deleted', 'u' for 'unknown', 'i'
3479 +for 'ignored' and 'c' for clean.
3481 It abbreviates only those statuses which are passed. Note that clean and
3482 -ignored files are not displayed with \(aq\-\-terse ic\(aq unless the \-c/\-\-clean
3483 +ignored files are not displayed with '\-\-terse ic' unless the \-c/\-\-clean
3484 and \-i/\-\-ignored options are also used.
3486 The \-v/\-\-verbose option shows information when the repository is in an
3487 @@ -4506,11 +4479,11 @@
3488 turned on by default by enabling the \fBcommands.status.verbose\fP option.
3490 You can skip displaying some of these states by setting
3491 -\fBcommands.status.skipstates\fP to one or more of: \(aqbisect\(aq, \(aqgraft\(aq,
3492 -\(aqhistedit\(aq, \(aqmerge\(aq, \(aqrebase\(aq, or \(aqunshelve\(aq.
3493 +\fBcommands.status.skipstates\fP to one or more of: 'bisect', 'graft',
3494 +\&'histedit', 'merge', 'rebase', or 'unshelve'.
3496 Examples:
3497 -.INDENT 0.0
3498 +.RS 0
3499 .IP \(bu 2
3501 show changes in the working directory relative to a
3502 @@ -4517,19 +4490,19 @@
3503 changeset:
3506 -.ft C
3507 +.ft
3508 hg status \-\-rev 9353
3509 -.ft P
3510 +.ft
3512 .IP \(bu 2
3514 show changes in the working directory relative to the
3515 -current directory (see \%\fBhg help patterns\fP\: for more information):
3516 +current directory (see \fBhg help patterns\fP for more information):
3519 -.ft C
3520 +.ft
3521 hg status re:
3522 -.ft P
3523 +.ft
3525 .IP \(bu 2
3527 @@ -4536,9 +4509,9 @@
3528 show all changes including copies in an existing changeset:
3531 -.ft C
3532 +.ft
3533 hg status \-\-copies \-\-change 9353
3534 -.ft P
3535 +.ft
3537 .IP \(bu 2
3539 @@ -4545,9 +4518,9 @@
3540 get a NUL separated list of added files, suitable for xargs:
3543 -.ft C
3544 +.ft
3545 hg status \-an0
3546 -.ft P
3547 +.ft
3549 .IP \(bu 2
3551 @@ -4555,16 +4528,16 @@
3552 added, removed, modified, deleted, and untracked paths:
3555 -.ft C
3556 +.ft
3557 hg status \-v \-t mardu
3558 -.ft P
3559 +.ft
3561 -.UNINDENT
3562 +.RE
3564 Returns 0 on success.
3566 Options:
3567 -.INDENT 0.0
3568 +.RS 0
3570 .B \-A, \-\-all
3572 @@ -4637,23 +4610,23 @@
3573 .BI \-T, \-\-template \ <TEMPLATE>
3575 display with template (EXPERIMENTAL)
3576 -.UNINDENT
3577 +.RE
3579 [+] marked option can be specified multiple times
3580 -.INDENT 0.0
3581 -.INDENT 3.5
3582 +.RS 0
3583 +.RS 3
3585 aliases: st
3586 -.UNINDENT
3587 -.UNINDENT
3588 +.RE
3589 +.RE
3590 .SS summary
3592 summarize working directory state:
3595 -.ft C
3596 +.ft
3597 hg summary [\-\-remote]
3598 -.ft P
3599 +.ft
3602 This generates a brief summary of the working directory state,
3603 @@ -4665,7 +4638,7 @@
3604 Returns 0 on success.
3606 Options:
3607 -.INDENT 0.0
3608 +.RS 0
3610 .B \-\-remote
3612 @@ -4672,15 +4645,15 @@
3613 check for push and pull
3615 aliases: sum
3616 -.UNINDENT
3617 +.RE
3618 .SS tag
3620 add one or more tags for the current or given revision:
3623 -.ft C
3624 +.ft
3625 hg tag [\-f] [\-l] [\-m TEXT] [\-d DATE] [\-u USER] [\-r REV] NAME...
3626 -.ft P
3627 +.ft
3630 Name a particular revision using <name>.
3631 @@ -4701,11 +4674,11 @@
3632 repositories).
3634 Tag commits are usually made at the head of a branch. If the parent
3635 -of the working directory is not a branch head, \%\fBhg tag\fP\: aborts; use
3636 +of the working directory is not a branch head, \fBhg tag\fP aborts; use
3637 \-f/\-\-force to force the tag commit to be based on a non\-head
3638 changeset.
3640 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date.
3641 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date.
3643 Since tag names have priority over branch names during revision
3644 lookup, using an existing branch name as a tag name is discouraged.
3645 @@ -4713,7 +4686,7 @@
3646 Returns 0 on success.
3648 Options:
3649 -.INDENT 0.0
3650 +.RS 0
3652 .B \-f, \-\-force
3654 @@ -4746,15 +4719,15 @@
3655 .BI \-u, \-\-user \ <USER>
3657 record the specified user as committer
3658 -.UNINDENT
3659 +.RE
3660 .SS tags
3662 list repository tags:
3665 -.ft C
3666 +.ft
3667 hg tags
3668 -.ft P
3669 +.ft
3672 This lists both regular and local tags. When the \-v/\-\-verbose
3673 @@ -4764,20 +4737,20 @@
3674 Returns 0 on success.
3676 Options:
3677 -.INDENT 0.0
3678 +.RS 0
3680 .BI \-T, \-\-template \ <TEMPLATE>
3682 display with template (EXPERIMENTAL)
3683 -.UNINDENT
3684 +.RE
3685 .SS tip
3687 show the tip revision (DEPRECATED):
3690 -.ft C
3691 +.ft
3692 hg tip [\-p] [\-g]
3693 -.ft P
3694 +.ft
3697 The tip revision (usually just called the tip) is the changeset
3698 @@ -4789,12 +4762,12 @@
3699 that repository becomes the current tip. The "tip" tag is special
3700 and cannot be renamed or assigned to a different changeset.
3702 -This command is deprecated, please use \%\fBhg heads\fP\: instead.
3703 +This command is deprecated, please use \fBhg heads\fP instead.
3705 Returns 0 on success.
3707 Options:
3708 -.INDENT 0.0
3709 +.RS 0
3711 .B \-p, \-\-patch
3713 @@ -4811,48 +4784,48 @@
3714 .BI \-T, \-\-template \ <TEMPLATE>
3716 display with template
3717 -.UNINDENT
3718 +.RE
3719 .SS unbundle
3721 apply one or more bundle files:
3724 -.ft C
3725 +.ft
3726 hg unbundle [\-u] FILE...
3727 -.ft P
3728 +.ft
3731 -Apply one or more bundle files generated by \%\fBhg bundle\fP\:.
3732 +Apply one or more bundle files generated by \fBhg bundle\fP.
3734 Returns 0 on success, 1 if an update has unresolved files.
3736 Options:
3737 -.INDENT 0.0
3738 +.RS 0
3740 .B \-u, \-\-update
3742 update to new branch head if changesets were unbundled
3743 -.UNINDENT
3744 +.RE
3745 .SS update
3747 update working directory (or switch revisions):
3750 -.ft C
3751 +.ft
3752 hg update [\-C|\-c|\-m] [\-d DATE] [[\-r] REV]
3753 -.ft P
3754 +.ft
3757 -Update the repository\(aqs working directory to the specified
3758 +Update the repository's working directory to the specified
3759 changeset. If no changeset is specified, update to the tip of the
3760 -current named branch and move the active bookmark (see \%\fBhg help
3761 -bookmarks\fP\:).
3762 +current named branch and move the active bookmark (see \fBhg help
3763 +bookmarks\fP).
3765 -Update sets the working directory\(aqs parent revision to the specified
3766 -changeset (see \%\fBhg help parents\fP\:).
3767 +Update sets the working directory's parent revision to the specified
3768 +changeset (see \fBhg help parents\fP).
3770 If the changeset is not a descendant or ancestor of the working
3771 -directory\(aqs parent and there are uncommitted changes, the update is
3772 +directory's parent and there are uncommitted changes, the update is
3773 aborted. With the \-c/\-\-check option, the working directory is checked
3774 for uncommitted changes; if none are found, the working directory is
3775 updated to the specified changeset.
3776 @@ -4860,12 +4833,12 @@
3777 The \-C/\-\-clean, \-c/\-\-check, and \-m/\-\-merge options control what
3778 happens if the working directory contains uncommitted changes.
3779 At most of one of them can be specified.
3780 -.INDENT 0.0
3781 +.RS 0
3782 .IP 1. 3
3784 If no option is specified, and if
3785 the requested changeset is an ancestor or descendant of
3786 -the working directory\(aqs parent, the uncommitted changes
3787 +the working directory's parent, the uncommitted changes
3788 are merged into the requested changeset and the merged
3789 result is left uncommitted. If the requested changeset is
3790 not an ancestor or descendant (that is, it is on another
3791 @@ -4875,7 +4848,7 @@
3793 With the \-m/\-\-merge option, the update is allowed even if the
3794 requested changeset is not an ancestor or descendant of
3795 -the working directory\(aqs parent.
3796 +the working directory's parent.
3797 .IP 3. 3
3799 With the \-c/\-\-check option, the update is aborted and the
3800 @@ -4884,23 +4857,23 @@
3802 With the \-C/\-\-clean option, uncommitted changes are discarded and
3803 the working directory is updated to the requested changeset.
3804 -.UNINDENT
3805 +.RE
3807 To cancel an uncommitted merge (and lose your changes), use
3808 -\%\fBhg update \-\-clean .\fP\:.
3809 +\fBhg update \-\-clean .\fP.
3811 Use null as the changeset to remove the working directory (like
3812 -\%\fBhg clone \-U\fP\:).
3813 +\fBhg clone \-U\fP).
3815 If you want to revert just one file to an older revision, use
3816 -\%\fBhg revert [\-r REV] NAME\fP\:.
3817 +\fBhg revert [\-r REV] NAME\fP.
3819 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date.
3820 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date.
3822 Returns 0 on success, 1 if there are unresolved files.
3824 Options:
3825 -.INDENT 0.0
3826 +.RS 0
3828 .B \-C, \-\-clean
3830 @@ -4927,25 +4900,25 @@
3831 specify merge tool
3833 aliases: up checkout co
3834 -.UNINDENT
3835 +.RE
3836 .SS verify
3838 verify the integrity of the repository:
3841 -.ft C
3842 +.ft
3843 hg verify
3844 -.ft P
3845 +.ft
3848 Verify the integrity of the current repository.
3850 -This will perform an extensive check of the repository\(aqs
3851 +This will perform an extensive check of the repository's
3852 integrity, validating the hashes and checksums of each entry in
3853 the changelog, manifest, and tracked files, as well as the
3854 integrity of their crosslinks and indices.
3856 -Please see \%https://mercurial\-scm.org/wiki/RepositoryCorruption\:
3857 +Please see https://mercurial\-scm.org/wiki/RepositoryCorruption
3858 for more information about recovery from corruption of the
3859 repository.
3861 @@ -4955,26 +4928,26 @@
3862 output version and copyright information:
3865 -.ft C
3866 +.ft
3867 hg version
3868 -.ft P
3869 +.ft
3872 output version and copyright information
3874 Options:
3875 -.INDENT 0.0
3876 +.RS 0
3878 .BI \-T, \-\-template \ <TEMPLATE>
3880 display with template (EXPERIMENTAL)
3881 -.UNINDENT
3882 +.RE
3883 .SH BUNDLE FILE FORMATS
3885 Mercurial supports generating standalone "bundle" files that hold repository
3886 data. These "bundles" are typically saved locally and used later or exchanged
3887 between different repositories, possibly on different machines. Example
3888 -commands using bundles are \%\fBhg bundle\fP\: and \%\fBhg unbundle\fP\:.
3889 +commands using bundles are \fBhg bundle\fP and \fBhg unbundle\fP.
3891 Generation of bundle files is controlled by a "bundle specification"
3892 ("bundlespec") string. This string tells the bundle generation process how
3893 @@ -4981,7 +4954,7 @@
3894 to create the bundle.
3896 A "bundlespec" string is composed of the following elements:
3897 -.INDENT 0.0
3898 +.RS 0
3900 .B type
3902 @@ -4994,10 +4967,10 @@
3903 .B parameters
3905 Arbitrary key\-value parameters to further control bundle generation.
3906 -.UNINDENT
3907 +.RE
3909 A "bundlespec" string has the following formats:
3910 -.INDENT 0.0
3911 +.RS 0
3913 .B <type>
3915 @@ -5006,7 +4979,7 @@
3916 .B <compression>\-<type>
3918 The compression engine and format are delimited by a hyphen (\fB\-\fP).
3919 -.UNINDENT
3920 +.RE
3922 Optional parameters follow the \fB<type>\fP. Parameters are URI escaped
3923 \fBkey=value\fP pairs. Each pair is delimited by a semicolon (\fB;\fP). The
3924 @@ -5015,7 +4988,7 @@
3925 .SS Available Types
3927 The following bundle <type> strings are available:
3928 -.INDENT 0.0
3929 +.RS 0
3931 .B v1
3933 @@ -5042,11 +5015,11 @@
3935 Version 2 bundles can also use modern compression engines, such as
3936 \fBzstd\fP, making them faster to compress and often smaller.
3937 -.UNINDENT
3938 +.RE
3939 .SS Available Compression Engines
3941 The following bundle <compression> engines can be used:
3942 -.INDENT 0.0
3943 +.RS 0
3945 .B \fBbzip2\fP
3947 @@ -5074,9 +5047,9 @@
3948 No compression is performed.
3950 Use this compression engine to explicitly disable compression.
3951 -.UNINDENT
3952 +.RE
3953 .SS Examples
3954 -.INDENT 0.0
3955 +.RS 0
3957 .B \fBv2\fP
3959 @@ -5094,7 +5067,7 @@
3960 .B \fBzstd\-v1\fP
3962 This errors because \fBzstd\fP is not supported for \fBv1\fP types.
3963 -.UNINDENT
3964 +.RE
3965 .SH COLORIZING OUTPUTS
3967 Mercurial colorizes output from several commands.
3968 @@ -5107,25 +5080,25 @@
3969 To enable color (default) whenever possible use:
3972 -.ft C
3973 +.ft
3974 [ui]
3975 color = yes
3976 -.ft P
3977 +.ft
3980 To disable color use:
3983 -.ft C
3984 +.ft
3985 [ui]
3986 color = no
3987 -.ft P
3988 +.ft
3991 -See \%\fBhg help config.ui.color\fP\: for details.
3992 +See \fBhg help config.ui.color\fP for details.
3994 The default pager on Windows does not support color, so enabling the pager
3995 -will effectively disable color. See \%\fBhg help config.ui.paginate\fP\: to disable
3996 +will effectively disable color. See \fBhg help config.ui.paginate\fP to disable
3997 the pager. Alternately, MSYS and Cygwin shells provide \fIless\fP as a pager,
3998 which can be configured to support ANSI color mode. Windows 10 natively
3999 supports ANSI color mode.
4000 @@ -5132,7 +5105,7 @@
4001 .SS Mode
4003 Mercurial can use various systems to display color. The supported modes are
4004 -\fBansi\fP, \fBwin32\fP, and \fBterminfo\fP. See \%\fBhg help config.color\fP\: for details
4005 +\fBansi\fP, \fBwin32\fP, and \fBterminfo\fP. See \fBhg help config.color\fP for details
4006 about how to control the mode.
4007 .SS Effects
4009 @@ -5142,10 +5115,10 @@
4010 available, then effects are rendered with the ECMA\-48 SGR control
4011 function (aka ANSI escape codes).
4013 -The available effects in terminfo mode are \(aqblink\(aq, \(aqbold\(aq, \(aqdim\(aq,
4014 -\(aqinverse\(aq, \(aqinvisible\(aq, \(aqitalic\(aq, \(aqstandout\(aq, and \(aqunderline\(aq; in
4015 -ECMA\-48 mode, the options are \(aqbold\(aq, \(aqinverse\(aq, \(aqitalic\(aq, and
4016 -\(aqunderline\(aq. How each is rendered depends on the terminal emulator.
4017 +The available effects in terminfo mode are 'blink', 'bold', 'dim',
4018 +\&'inverse', 'invisible', 'italic', 'standout', and 'underline'; in
4019 +ECMA\-48 mode, the options are 'bold', 'inverse', 'italic', and
4020 +\&'underline'. How each is rendered depends on the terminal emulator.
4021 Some may not be available for a given terminal type, and will be
4022 silently ignored.
4024 @@ -5154,19 +5127,19 @@
4025 configuration:
4028 -.ft C
4029 +.ft
4030 [color]
4031 terminfo.dim = \eE[2m
4032 -.ft P
4033 +.ft
4036 -where \(aqE\(aq is substituted with an escape character.
4037 +where 'E' is substituted with an escape character.
4038 .SS Labels
4040 Text receives color effects depending on the labels that it has. Many
4041 default Mercurial commands emit labelled text. You can also define
4042 -your own labels in templates using the label function, see \%\fBhg help
4043 -templates\fP\:. A single portion of text may have more than one label. In
4044 +your own labels in templates using the label function, see \fBhg help
4045 +templates\fP. A single portion of text may have more than one label. In
4046 that case, effects given to the last label will override any other
4047 effects. This includes the special "none" effect, which nullifies
4048 other effects.
4049 @@ -5174,18 +5147,18 @@
4050 Labels are normally invisible. In order to see these labels and their
4051 position in the text, use the global \-\-color=debug option. The same
4052 anchor text may be associated to multiple labels, e.g.
4053 -.INDENT 0.0
4054 -.INDENT 3.5
4055 +.RS 0
4056 +.RS 3
4058 [log.changeset changeset.secret|changeset: 22611:6f0a53c8f587]
4059 -.UNINDENT
4060 -.UNINDENT
4061 +.RE
4062 +.RE
4064 The following are the default effects for some default labels. Default
4065 effects may be overridden from your configuration file:
4068 -.ft C
4069 +.ft
4070 [color]
4071 status.modified = blue bold underline red_background
4072 status.added = green bold
4073 @@ -5194,7 +5167,7 @@
4074 status.unknown = magenta bold underline
4075 status.ignored = black bold
4077 -# \(aqnone\(aq turns off all effects
4078 +# 'none' turns off all effects
4079 status.clean = none
4080 status.copied = none
4082 @@ -5239,7 +5212,7 @@
4083 shelve.name = blue bold
4085 histedit.remaining = red bold
4086 -.ft P
4087 +.ft
4089 .SS Custom colors
4091 @@ -5248,22 +5221,22 @@
4092 for your terminal type, assuming terminfo mode. For instance:
4095 -.ft C
4096 +.ft
4097 color.brightblue = 12
4098 color.pink = 207
4099 color.orange = 202
4100 -.ft P
4101 +.ft
4104 -to set \(aqbrightblue\(aq to color slot 12 (useful for 16 color terminals
4105 -that have brighter colors defined in the upper eight) and, \(aqpink\(aq and
4106 -\(aqorange\(aq to colors in 256\-color xterm\(aqs default color cube. These
4107 +to set 'brightblue' to color slot 12 (useful for 16 color terminals
4108 +that have brighter colors defined in the upper eight) and, 'pink' and
4109 +\&'orange' to colors in 256\-color xterm's default color cube. These
4110 defined colors may then be used as any of the pre\-defined eight,
4111 -including appending \(aq_background\(aq to set the background to that color.
4112 +including appending '_background' to set the background to that color.
4113 .SH DATE FORMATS
4115 Some commands allow the user to specify a date, e.g.:
4116 -.INDENT 0.0
4117 +.RS 0
4118 .IP \(bu 2
4120 backout, commit, import, tag: Specify the commit date.
4121 @@ -5270,10 +5243,10 @@
4122 .IP \(bu 2
4124 log, revert, update: Select revision(s) by date.
4125 -.UNINDENT
4126 +.RE
4128 Many date formats are valid. Here are some examples:
4129 -.INDENT 0.0
4130 +.RS 0
4131 .IP \(bu 2
4133 \fBWed Dec 6 13:18:29 2006\fP (local timezone assumed)
4134 @@ -5322,14 +5295,14 @@
4135 .IP \(bu 2
4137 \fBnow\fP \- right now
4138 -.UNINDENT
4139 +.RE
4141 -Lastly, there is Mercurial\(aqs internal format:
4142 -.INDENT 0.0
4143 +Lastly, there is Mercurial's internal format:
4144 +.RS 0
4145 .IP \(bu 2
4147 \fB1165411109 0\fP (Wed Dec 6 13:18:29 2006 UTC)
4148 -.UNINDENT
4149 +.RE
4151 This is the internal representation format for dates. The first number
4152 is the number of seconds since the epoch (1970\-01\-01 00:00 UTC). The
4153 @@ -5337,7 +5310,7 @@
4154 (negative if the timezone is east of UTC).
4156 The log command also accepts date ranges:
4157 -.INDENT 0.0
4158 +.RS 0
4159 .IP \(bu 2
4161 \fB<DATE\fP \- at or before a given date/time
4162 @@ -5350,16 +5323,16 @@
4163 .IP \(bu 2
4165 \fB\-DAYS\fP \- within a given number of days of today
4166 -.UNINDENT
4167 +.RE
4168 .SH DIFF FORMATS
4170 -Mercurial\(aqs default format for showing changes between two versions of
4171 +Mercurial's default format for showing changes between two versions of
4172 a file is compatible with the unified format of GNU diff, which can be
4173 used by GNU patch and many other standard tools.
4175 While this standard format is often enough, it does not encode the
4176 following information:
4177 -.INDENT 0.0
4178 +.RS 0
4179 .IP \(bu 2
4181 executable status and other permission bits
4182 @@ -5372,7 +5345,7 @@
4183 .IP \(bu 2
4185 creation or deletion of empty files
4186 -.UNINDENT
4187 +.RE
4189 Mercurial also supports the extended diff format from the git VCS
4190 which addresses these limitations. The git diff format is not produced
4191 @@ -5380,26 +5353,26 @@
4192 format.
4194 This means that when generating diffs from a Mercurial repository
4195 -(e.g. with \%\fBhg export\fP\:), you should be careful about things like file
4196 +(e.g. with \fBhg export\fP), you should be careful about things like file
4197 copies and renames or other things mentioned above, because when
4198 applying a standard diff to a different repository, this extra
4199 -information is lost. Mercurial\(aqs internal operations (like push and
4200 +information is lost. Mercurial's internal operations (like push and
4201 pull) are not affected by this, because they use an internal binary
4202 format for communicating changes.
4204 To make Mercurial produce the git extended diff format, use the \-\-git
4205 -option available for many commands, or set \(aqgit = True\(aq in the [diff]
4206 +option available for many commands, or set 'git = True' in the [diff]
4207 section of your configuration file. You do not need to set this option
4208 when importing diffs in this format or using them in the mq extension.
4209 .SH ENVIRONMENT VARIABLES
4210 -.INDENT 0.0
4211 +.RS 0
4213 .B HG
4215 -Path to the \(aqhg\(aq executable, automatically passed when running
4216 +Path to the 'hg' executable, automatically passed when running
4217 hooks, extensions or external tools. If unset or empty, this is
4218 -the hg executable\(aqs name if it\(aqs frozen, or an executable named
4219 -\(aqhg\(aq (with %PATHEXT% [defaulting to COM/EXE/BAT/CMD] extensions on
4220 +the hg executable's name if it's frozen, or an executable named
4221 +\&'hg' (with %PATHEXT% [defaulting to COM/EXE/BAT/CMD] extensions on
4222 Windows) is searched.
4224 .B HGEDITOR
4225 @@ -5406,7 +5379,7 @@
4227 This is the name of the editor to run when committing. See EDITOR.
4229 -(deprecated, see \%\fBhg help config.ui.editor\fP\:)
4230 +(deprecated, see \fBhg help config.ui.editor\fP)
4232 .B HGENCODING
4234 @@ -5417,9 +5390,9 @@
4236 .B HGENCODINGMODE
4238 -This sets Mercurial\(aqs behavior for handling unknown characters
4239 +This sets Mercurial's behavior for handling unknown characters
4240 while transcoding user input. The default is "strict", which
4241 -causes Mercurial to abort if it can\(aqt map a character. Other
4242 +causes Mercurial to abort if it can't map a character. Other
4243 settings include "replace", which replaces unknown characters, and
4244 "ignore", which drops them. This setting can be overridden with
4245 the \-\-encodingmode command\-line option.
4246 @@ -5426,7 +5399,7 @@
4248 .B HGENCODINGAMBIGUOUS
4250 -This sets Mercurial\(aqs behavior for handling characters with
4251 +This sets Mercurial's behavior for handling characters with
4252 "ambiguous" widths like accented Latin characters with East Asian
4253 fonts. By default, Mercurial assumes ambiguous characters are
4254 narrow, set this variable to "wide" if such characters cause
4255 @@ -5438,7 +5411,7 @@
4256 will be executed with three arguments: local file, remote file,
4257 ancestor file.
4259 -(deprecated, see \%\fBhg help config.ui.merge\fP\:)
4260 +(deprecated, see \fBhg help config.ui.merge\fP)
4262 .B HGRCPATH
4264 @@ -5448,19 +5421,19 @@
4265 the .hg/hgrc from the current repository is read.
4267 For each element in HGRCPATH:
4268 -.INDENT 7.0
4269 +.RS 7
4270 .IP \(bu 2
4272 -if it\(aqs a directory, all files ending with .rc are added
4273 +if it's a directory, all files ending with .rc are added
4274 .IP \(bu 2
4276 otherwise, the file itself will be added
4277 -.UNINDENT
4278 +.RE
4280 .B HGPLAIN
4282 When set, this disables any configuration settings that might
4283 -change Mercurial\(aqs default output. This includes encoding,
4284 +change Mercurial's default output. This includes encoding,
4285 defaults, verbose mode, debug mode, quiet mode, tracebacks, and
4286 localization. This can be useful when scripting against Mercurial
4287 in the face of existing user configuration.
4288 @@ -5472,11 +5445,11 @@
4290 This is a comma\-separated list of features to preserve when
4291 HGPLAIN is enabled. Currently the following values are supported:
4292 -.INDENT 7.0
4293 +.RS 7
4295 .B \fBalias\fP
4297 -Don\(aqt remove aliases.
4298 +Don't remove aliases.
4300 .B \fBi18n\fP
4302 @@ -5484,16 +5457,16 @@
4304 .B \fBrevsetalias\fP
4306 -Don\(aqt remove revset aliases.
4307 +Don't remove revset aliases.
4309 .B \fBtemplatealias\fP
4311 -Don\(aqt remove template aliases.
4312 +Don't remove template aliases.
4314 .B \fBprogress\fP
4316 -Don\(aqt hide progress output.
4317 -.UNINDENT
4318 +Don't hide progress output.
4319 +.RE
4321 Setting HGPLAINEXCEPT to anything (even an empty string) will
4322 enable plain mode.
4323 @@ -5502,7 +5475,7 @@
4325 This is the string used as the author of a commit. If not set,
4326 available values will be considered in this order:
4327 -.INDENT 7.0
4328 +.RS 7
4329 .IP \(bu 2
4331 HGUSER (deprecated)
4332 @@ -5518,9 +5491,9 @@
4333 .IP \(bu 2
4335 LOGNAME (with \fB@hostname\fP appended)
4336 -.UNINDENT
4337 +.RE
4339 -(deprecated, see \%\fBhg help config.ui.username\fP\:)
4340 +(deprecated, see \fBhg help config.ui.username\fP)
4342 .B EMAIL
4344 @@ -5541,13 +5514,13 @@
4345 editor it uses is determined by looking at the environment
4346 variables HGEDITOR, VISUAL and EDITOR, in that order. The first
4347 non\-empty one is chosen. If all of them are empty, the editor
4348 -defaults to \(aqvi\(aq.
4349 +defaults to 'vi'.
4351 .B PYTHONPATH
4353 This is used by Python to find imported modules and may need to be
4354 set appropriately if this Mercurial is not installed system\-wide.
4355 -.UNINDENT
4356 +.RE
4357 .SH USING ADDITIONAL FEATURES
4359 Mercurial has the ability to add new features through the use of
4360 @@ -5560,22 +5533,22 @@
4361 like this:
4364 -.ft C
4365 +.ft
4366 [extensions]
4367 foo =
4368 -.ft P
4369 +.ft
4372 You may also specify the full path to an extension:
4375 -.ft C
4376 +.ft
4377 [extensions]
4378 myfeature = ~/.hgext/myfeature.py
4379 -.ft P
4380 +.ft
4383 -See \%\fBhg help config\fP\: for more information on configuration files.
4384 +See \fBhg help config\fP for more information on configuration files.
4386 Extensions are not loaded by default for a variety of reasons:
4387 they can increase startup overhead; they may be meant for advanced
4388 @@ -5589,19 +5562,19 @@
4389 broader scope, prepend its path with !:
4392 -.ft C
4393 +.ft
4394 [extensions]
4395 # disabling extension bar residing in /path/to/extension/bar.py
4396 bar = !/path/to/extension/bar.py
4397 # ditto, but no path was supplied for extension baz
4398 baz = !
4399 -.ft P
4400 +.ft
4403 disabled extensions:
4404 -.INDENT 0.0
4405 -.INDENT 3.5
4406 -.INDENT 0.0
4407 +.RS 0
4408 +.RS 3
4409 +.RS 0
4411 .B acl
4413 @@ -5718,9 +5691,9 @@
4414 .B zeroconf
4416 discover and advertise repositories on the local network
4417 -.UNINDENT
4418 -.UNINDENT
4419 -.UNINDENT
4420 +.RE
4421 +.RE
4422 +.RE
4423 .SH SPECIFYING FILE SETS
4425 Mercurial supports a functional language for selecting a set of
4426 @@ -5727,7 +5700,7 @@
4427 files.
4429 Like other file patterns, this pattern type is indicated by a prefix,
4430 -\(aqset:\(aq. The language supports a number of predicates which are joined
4431 +\&'set:'. The language supports a number of predicates which are joined
4432 by infix operators. Parenthesis can be used for grouping.
4434 Identifiers such as filenames or patterns must be quoted with single
4435 @@ -5738,21 +5711,21 @@
4437 Special characters can be used in quoted identifiers by escaping them,
4438 e.g., \fB\en\fP is interpreted as a newline. To prevent them from being
4439 -interpreted, strings can be prefixed with \fBr\fP, e.g. \fBr\(aq...\(aq\fP.
4440 +interpreted, strings can be prefixed with \fBr\fP, e.g. \fBr'...'\fP.
4442 -See also \%\fBhg help patterns\fP\:.
4443 +See also \fBhg help patterns\fP.
4444 .SS Operators
4446 There is a single prefix operator:
4447 -.INDENT 0.0
4448 +.RS 0
4450 .B \fBnot x\fP
4452 Files not in x. Short form is \fB! x\fP.
4453 -.UNINDENT
4454 +.RE
4456 These are the supported infix operators:
4457 -.INDENT 0.0
4458 +.RS 0
4460 .B \fBx and y\fP
4462 @@ -5766,15 +5739,15 @@
4463 .B \fBx \- y\fP
4465 Files in x but not in y.
4466 -.UNINDENT
4467 +.RE
4468 .SS Predicates
4470 The following predicates are supported:
4471 -.INDENT 0.0
4472 +.RS 0
4474 .B \fBadded()\fP
4476 -File that is added according to \%\fBhg status\fP\:.
4477 +File that is added according to \fBhg status\fP.
4479 .B \fBbinary()\fP
4481 @@ -5782,7 +5755,7 @@
4483 .B \fBclean()\fP
4485 -File that is clean according to \%\fBhg status\fP\:.
4486 +File that is clean according to \fBhg status\fP.
4488 .B \fBcopied()\fP
4490 @@ -5818,29 +5791,29 @@
4492 .B \fBignored()\fP
4494 -File that is ignored according to \%\fBhg status\fP\:. These files will only be
4495 +File that is ignored according to \fBhg status\fP. These files will only be
4496 considered if this predicate is used.
4498 .B \fBmissing()\fP
4500 -File that is missing according to \%\fBhg status\fP\:.
4501 +File that is missing according to \fBhg status\fP.
4503 .B \fBmodified()\fP
4505 -File that is modified according to \%\fBhg status\fP\:.
4506 +File that is modified according to \fBhg status\fP.
4508 .B \fBportable()\fP
4510 -File that has a portable name. (This doesn\(aqt include filenames with case
4511 +File that has a portable name. (This doesn't include filenames with case
4512 collisions.)
4514 .B \fBremoved()\fP
4516 -File that is removed according to \%\fBhg status\fP\:.
4517 +File that is removed according to \fBhg status\fP.
4519 .B \fBresolved()\fP
4521 -File that is marked resolved according to \%\fBhg resolve \-l\fP\:.
4522 +File that is marked resolved according to \fBhg resolve \-l\fP.
4524 .B \fBrevs(revs, pattern)\fP
4526 @@ -5850,30 +5823,30 @@
4527 .B \fBsize(expression)\fP
4529 File size matches the given expression. Examples:
4530 -.INDENT 7.0
4531 +.RS 7
4532 .IP \(bu 2
4534 -size(\(aq1k\(aq) \- files from 1024 to 2047 bytes
4535 +size('1k') \- files from 1024 to 2047 bytes
4536 .IP \(bu 2
4538 -size(\(aq< 20k\(aq) \- files less than 20480 bytes
4539 +size('< 20k') \- files less than 20480 bytes
4540 .IP \(bu 2
4542 -size(\(aq>= .5MB\(aq) \- files at least 524288 bytes
4543 +size('>= .5MB') \- files at least 524288 bytes
4544 .IP \(bu 2
4546 -size(\(aq4k \- 1MB\(aq) \- files from 4096 bytes to 1048576 bytes
4547 -.UNINDENT
4548 +size('4k \- 1MB') \- files from 4096 bytes to 1048576 bytes
4549 +.RE
4551 .B \fBstatus(base, rev, pattern)\fP
4553 Evaluate predicate using status change between \fBbase\fP and
4554 \fBrev\fP. Examples:
4555 -.INDENT 7.0
4556 +.RS 7
4557 .IP \(bu 2
4559 \fBstatus(3, 7, added())\fP \- matches files added from "3" to "7"
4560 -.UNINDENT
4561 +.RE
4563 .B \fBsubrepo([pattern])\fP
4565 @@ -5885,25 +5858,25 @@
4567 .B \fBunknown()\fP
4569 -File that is unknown according to \%\fBhg status\fP\:. These files will only be
4570 +File that is unknown according to \fBhg status\fP. These files will only be
4571 considered if this predicate is used.
4573 .B \fBunresolved()\fP
4575 -File that is marked unresolved according to \%\fBhg resolve \-l\fP\:.
4576 -.UNINDENT
4577 +File that is marked unresolved according to \fBhg resolve \-l\fP.
4578 +.RE
4579 .SS Examples
4581 Some sample queries:
4582 -.INDENT 0.0
4583 +.RS 0
4584 .IP \(bu 2
4586 Show status of files that appear to be binary in the working directory:
4589 -.ft C
4590 +.ft
4591 hg status \-A "set:binary()"
4592 -.ft P
4593 +.ft
4595 .IP \(bu 2
4597 @@ -5910,9 +5883,9 @@
4598 Forget files that are in .hgignore but are already tracked:
4601 -.ft C
4602 +.ft
4603 hg forget "set:hgignore() and not ignored()"
4604 -.ft P
4605 +.ft
4607 .IP \(bu 2
4609 @@ -5919,9 +5892,9 @@
4610 Find text files that contain a string:
4613 -.ft C
4614 +.ft
4615 hg files "set:grep(magic) and not binary()"
4616 -.ft P
4617 +.ft
4619 .IP \(bu 2
4621 @@ -5928,9 +5901,9 @@
4622 Find C files in a non\-standard encoding:
4625 -.ft C
4626 -hg files "set:**.c and not encoding(\(aqUTF\-8\(aq)"
4627 -.ft P
4628 +.ft
4629 +hg files "set:**.c and not encoding('UTF\-8')"
4630 +.ft
4632 .IP \(bu 2
4634 @@ -5937,9 +5910,9 @@
4635 Revert copies of large binary files:
4638 -.ft C
4639 -hg revert "set:copied() and binary() and size(\(aq>1M\(aq)"
4640 -.ft P
4641 +.ft
4642 +hg revert "set:copied() and binary() and size('>1M')"
4643 +.ft
4645 .IP \(bu 2
4647 @@ -5946,9 +5919,9 @@
4648 Revert files that were added to the working directory:
4651 -.ft C
4652 -hg revert "set:revs(\(aqwdir()\(aq, added())"
4653 -.ft P
4654 +.ft
4655 +hg revert "set:revs('wdir()', added())"
4656 +.ft
4658 .IP \(bu 2
4660 @@ -5955,13 +5928,13 @@
4661 Remove files listed in foo.lst that contain the letter a or b:
4664 -.ft C
4665 -hg remove "set: \(aqlistfile:foo.lst\(aq and (**a* or **b*)"
4666 -.ft P
4667 +.ft
4668 +hg remove "set: 'listfile:foo.lst' and (**a* or **b*)"
4669 +.ft
4671 -.UNINDENT
4672 +.RE
4673 .SH GLOSSARY
4674 -.INDENT 0.0
4675 +.RS 0
4677 .B Ancestor
4679 @@ -5969,7 +5942,7 @@
4680 changesets from a given changeset. More precisely, the ancestors
4681 of a changeset can be defined by two properties: a parent of a
4682 changeset is an ancestor, and a parent of an ancestor is an
4683 -ancestor. See also: \(aqDescendant\(aq.
4684 +ancestor. See also: 'Descendant'.
4686 .B Bookmark
4688 @@ -5976,7 +5949,7 @@
4689 Bookmarks are pointers to certain commits that move when
4690 committing. They are similar to tags in that it is possible to use
4691 bookmark names in all places where Mercurial expects a changeset
4692 -ID, e.g., with \%\fBhg update\fP\:. Unlike tags, bookmarks move along
4693 +ID, e.g., with \fBhg update\fP. Unlike tags, bookmarks move along
4694 when you make a commit.
4696 Bookmarks can be renamed, copied and deleted. Bookmarks are local,
4697 @@ -5988,9 +5961,9 @@
4699 (Noun) A child changeset that has been created from a parent that
4700 is not a head. These are known as topological branches, see
4701 -\(aqBranch, topological\(aq. If a topological branch is named, it becomes
4702 +\&'Branch, topological'. If a topological branch is named, it becomes
4703 a named branch. If a topological branch is not named, it becomes
4704 -an anonymous branch. See \(aqBranch, anonymous\(aq and \(aqBranch, named\(aq.
4705 +an anonymous branch. See 'Branch, anonymous' and 'Branch, named'.
4707 Branches may be created when changes are pulled from or pushed to
4708 a remote repository, since new heads may be created by these
4709 @@ -6005,7 +5978,7 @@
4710 (Verb) The action of creating a child changeset which results in
4711 its parent having more than one child.
4713 -Example: "I\(aqm going to branch at X."
4714 +Example: "I'm going to branch at X."
4716 .B Branch, anonymous
4718 @@ -6024,19 +5997,19 @@
4720 .B Branch head
4722 -See \(aqHead, branch\(aq.
4723 +See 'Head, branch'.
4725 .B Branch, inactive
4727 If a named branch has no topological heads, it is considered to be
4728 inactive. As an example, a feature branch becomes inactive when it
4729 -is merged into the default branch. The \%\fBhg branches\fP\: command
4730 +is merged into the default branch. The \fBhg branches\fP command
4731 shows inactive branches by default, though they can be hidden with
4732 -\%\fBhg branches \-\-active\fP\:.
4733 +\fBhg branches \-\-active\fP.
4735 NOTE: this concept is deprecated because it is too implicit.
4736 -Branches should now be explicitly closed using \%\fBhg commit
4737 -\-\-close\-branch\fP\: when they are no longer needed.
4738 +Branches should now be explicitly closed using \fBhg commit
4739 +\-\-close\-branch\fP when they are no longer needed.
4741 .B Branch, named
4743 @@ -6043,8 +6016,8 @@
4744 A collection of changesets which have the same branch name. By
4745 default, children of a changeset in a named branch belong to the
4746 same named branch. A child can be explicitly assigned to a
4747 -different branch. See \%\fBhg help branch\fP\:, \%\fBhg help branches\fP\: and
4748 -\%\fBhg commit \-\-close\-branch\fP\: for more information on managing
4749 +different branch. See \fBhg help branch\fP, \fBhg help branches\fP and
4750 +\fBhg commit \-\-close\-branch\fP for more information on managing
4751 branches.
4753 Named branches can be thought of as a kind of namespace, dividing
4754 @@ -6057,7 +6030,7 @@
4756 .B Branch tip
4758 -See \(aqTip, branch\(aq.
4759 +See 'Tip, branch'.
4761 .B Branch, topological
4763 @@ -6107,24 +6080,24 @@
4764 revision. This use should probably be avoided where possible, as
4765 changeset is much more appropriate than checkout in this context.
4767 -Example: "I\(aqm using checkout X."
4768 +Example: "I'm using checkout X."
4770 (Verb) Updating the working directory to a specific changeset. See
4771 -\%\fBhg help update\fP\:.
4772 +\fBhg help update\fP.
4774 -Example: "I\(aqm going to check out changeset X."
4775 +Example: "I'm going to check out changeset X."
4777 .B Child changeset
4779 -See \(aqChangeset, child\(aq.
4780 +See 'Changeset, child'.
4782 .B Close changeset
4784 -See \(aqHead, closed branch\(aq.
4785 +See 'Head, closed branch'.
4787 .B Closed branch
4789 -See \(aqBranch, closed\(aq.
4790 +See 'Branch, closed'.
4792 .B Clone
4794 @@ -6133,13 +6106,13 @@
4796 Example: "Is your clone up to date?"
4798 -(Verb) The process of creating a clone, using \%\fBhg clone\fP\:.
4799 +(Verb) The process of creating a clone, using \fBhg clone\fP.
4801 -Example: "I\(aqm going to clone the repository."
4802 +Example: "I'm going to clone the repository."
4804 .B Closed branch head
4806 -See \(aqHead, closed branch\(aq.
4807 +See 'Head, closed branch'.
4809 .B Commit
4811 @@ -6164,7 +6137,7 @@
4812 system (DVCS) can be described as a directed acyclic graph (DAG),
4813 consisting of nodes and edges, where nodes correspond to
4814 changesets and edges imply a parent \-> child relation. This graph
4815 -can be visualized by graphical tools such as \%\fBhg log \-\-graph\fP\:. In
4816 +can be visualized by graphical tools such as \fBhg log \-\-graph\fP. In
4817 Mercurial, the DAG is limited by the requirement for children to
4818 have at most two parents.
4820 @@ -6174,7 +6147,7 @@
4822 .B Default branch
4824 -See \(aqBranch, default\(aq.
4825 +See 'Branch, default'.
4827 .B Descendant
4829 @@ -6182,7 +6155,7 @@
4830 from a given changeset. More precisely, the descendants of a
4831 changeset can be defined by two properties: the child of a
4832 changeset is a descendant, and the child of a descendant is a
4833 -descendant. See also: \(aqAncestor\(aq.
4834 +descendant. See also: 'Ancestor'.
4836 .B Diff
4838 @@ -6207,7 +6180,7 @@
4839 Mercurial, that will be recorded in the next commit. The working
4840 directory initially corresponds to the snapshot at an existing
4841 changeset, known as the parent of the working directory. See
4842 -\(aqParent, working directory\(aq. The state may be modified by changes
4843 +\&'Parent, working directory'. The state may be modified by changes
4844 to the files introduced manually or by a merge. The repository
4845 metadata exists in the .hg directory inside the working directory.
4847 @@ -6215,7 +6188,7 @@
4849 Changesets in the draft phase have not been shared with publishing
4850 repositories and may thus be safely changed by history\-modifying
4851 -extensions. See \%\fBhg help phases\fP\:.
4852 +extensions. See \fBhg help phases\fP.
4854 .B Experimental
4856 @@ -6223,13 +6196,13 @@
4858 .B Graph
4860 -See DAG and \%\fBhg log \-\-graph\fP\:.
4861 +See DAG and \fBhg log \-\-graph\fP.
4863 .B Head
4865 -The term \(aqhead\(aq may be used to refer to both a branch head or a
4866 -repository head, depending on the context. See \(aqHead, branch\(aq and
4867 -\(aqHead, repository\(aq for specific definitions.
4868 +The term 'head' may be used to refer to both a branch head or a
4869 +repository head, depending on the context. See 'Head, branch' and
4870 +\&'Head, repository' for specific definitions.
4872 Heads are where development generally takes place and are the
4873 usual targets for update and merge operations.
4874 @@ -6241,9 +6214,9 @@
4875 .B Head, closed branch
4877 A changeset that marks a head as no longer interesting. The closed
4878 -head is no longer listed by \%\fBhg heads\fP\:. A branch is considered
4879 +head is no longer listed by \fBhg heads\fP. A branch is considered
4880 closed when all its heads are closed and consequently is not
4881 -listed by \%\fBhg branches\fP\:.
4882 +listed by \fBhg branches\fP.
4884 Closed heads can be re\-opened by committing new changeset as the
4885 child of the changeset that marks a head as closed.
4886 @@ -6272,11 +6245,11 @@
4888 .B Immutable history
4890 -See \(aqHistory, immutable\(aq.
4891 +See 'History, immutable'.
4893 .B Merge changeset
4895 -See \(aqChangeset, merge\(aq.
4896 +See 'Changeset, merge'.
4898 .B Manifest
4900 @@ -6293,7 +6266,7 @@
4902 .B Named branch
4904 -See \(aqBranch, named\(aq.
4905 +See 'Branch, named'.
4907 .B Null changeset
4909 @@ -6300,30 +6273,30 @@
4910 The empty changeset. It is the parent state of newly\-initialized
4911 repositories and repositories with no checked out revision. It is
4912 thus the parent of root changesets and the effective ancestor when
4913 -merging unrelated changesets. Can be specified by the alias \(aqnull\(aq
4914 -or by the changeset ID \(aq000000000000\(aq.
4915 +merging unrelated changesets. Can be specified by the alias 'null'
4916 +or by the changeset ID '000000000000'.
4918 .B Parent
4920 -See \(aqChangeset, parent\(aq.
4921 +See 'Changeset, parent'.
4923 .B Parent changeset
4925 -See \(aqChangeset, parent\(aq.
4926 +See 'Changeset, parent'.
4928 .B Parent, working directory
4930 The working directory parent reflects a virtual revision which is
4931 the child of the changeset (or two changesets with an uncommitted
4932 -merge) shown by \%\fBhg parents\fP\:. This is changed with
4933 -\%\fBhg update\fP\:. Other commands to see the working directory parent
4934 -are \%\fBhg summary\fP\: and \%\fBhg id\fP\:. Can be specified by the alias ".".
4935 +merge) shown by \fBhg parents\fP. This is changed with
4936 +\fBhg update\fP. Other commands to see the working directory parent
4937 +are \fBhg summary\fP and \fBhg id\fP. Can be specified by the alias ".".
4939 .B Patch
4941 (Noun) The product of a diff operation.
4943 -Example: "I\(aqve sent you my patch."
4944 +Example: "I've sent you my patch."
4946 (Verb) The process of using a patch file to transform one
4947 changeset into another.
4948 @@ -6333,13 +6306,13 @@
4949 .B Phase
4951 A per\-changeset state tracking how the changeset has been or
4952 -should be shared. See \%\fBhg help phases\fP\:.
4953 +should be shared. See \fBhg help phases\fP.
4955 .B Public
4957 Changesets in the public phase have been shared with publishing
4958 -repositories and are therefore considered immutable. See \%\fBhg help
4959 -phases\fP\:.
4960 +repositories and are therefore considered immutable. See \fBhg help
4961 +phases\fP.
4963 .B Pull
4965 @@ -6347,7 +6320,7 @@
4966 not in the local repository are brought into the local
4967 repository. Note that this operation without special arguments
4968 only updates the repository, it does not update the files in the
4969 -working directory. See \%\fBhg help pull\fP\:.
4970 +working directory. See \fBhg help pull\fP.
4972 .B Push
4974 @@ -6355,7 +6328,7 @@
4975 not in a remote repository are sent to the remote repository. Note
4976 that this operation only adds changesets which have been committed
4977 locally to the remote repository. Uncommitted changes are not
4978 -sent. See \%\fBhg help push\fP\:.
4979 +sent. See \fBhg help push\fP.
4981 .B Repository
4983 @@ -6368,13 +6341,13 @@
4985 .B Repository head
4987 -See \(aqHead, repository\(aq.
4988 +See 'Head, repository'.
4990 .B Revision
4992 A state of the repository at some point in time. Earlier revisions
4993 -can be updated to by using \%\fBhg update\fP\:. See also \(aqRevision
4994 -number\(aq; See also \(aqChangeset\(aq.
4995 +can be updated to by using \fBhg update\fP. See also 'Revision
4996 +number'; See also 'Changeset'.
4998 .B Revision number
5000 @@ -6383,7 +6356,7 @@
5001 to a repository, starting with revision number 0. Note that the
5002 revision number may be different in each clone of a repository. To
5003 identify changesets uniquely between different clones, see
5004 -\(aqChangeset id\(aq.
5005 +\&'Changeset id'.
5007 .B Revlog
5009 @@ -6394,7 +6367,7 @@
5011 .B Rewriting history
5013 -See \(aqHistory, rewriting\(aq.
5014 +See 'History, rewriting'.
5016 .B Root
5018 @@ -6404,13 +6377,13 @@
5019 .B Secret
5021 Changesets in the secret phase may not be shared via push, pull,
5022 -or clone. See \%\fBhg help phases\fP\:.
5023 +or clone. See \fBhg help phases\fP.
5025 .B Tag
5027 An alternative name given to a changeset. Tags can be used in all
5028 places where Mercurial expects a changeset ID, e.g., with
5029 -\%\fBhg update\fP\:. The creation of a tag is stored in the history and
5030 +\fBhg update\fP. The creation of a tag is stored in the history and
5031 will thus automatically be shared with other using push and pull.
5033 .B Tip
5034 @@ -6422,7 +6395,7 @@
5036 The head of a given branch with the highest revision number. When
5037 a branch name is used as a revision identifier, it refers to the
5038 -branch tip. See also \(aqBranch, head\(aq. Note that because revision
5039 +branch tip. See also 'Branch, head'. Note that because revision
5040 numbers may be different in different repository clones, the
5041 branch tip may be different in different cloned repositories.
5043 @@ -6430,22 +6403,22 @@
5045 (Noun) Another synonym of changeset.
5047 -Example: "I\(aqve pushed an update."
5048 +Example: "I've pushed an update."
5050 (Verb) This term is usually used to describe updating the state of
5051 the working directory to that of a specific changeset. See
5052 -\%\fBhg help update\fP\:.
5053 +\fBhg help update\fP.
5055 Example: "You should update."
5057 .B Working directory
5059 -See \(aqDirectory, working\(aq.
5060 +See 'Directory, working'.
5062 .B Working directory parent
5064 -See \(aqParent, working directory\(aq.
5065 -.UNINDENT
5066 +See 'Parent, working directory'.
5067 +.RE
5068 .SH SYNTAX FOR MERCURIAL IGNORE FILES
5069 .SS Synopsis
5071 @@ -6472,16 +6445,16 @@
5073 In addition, a Mercurial configuration file can reference a set of
5074 per\-user or global ignore files. See the \fBignore\fP configuration
5075 -key on the \fB[ui]\fP section of \%\fBhg help config\fP\: for details of how to
5076 +key on the \fB[ui]\fP section of \fBhg help config\fP for details of how to
5077 configure these files.
5079 -To control Mercurial\(aqs handling of files that it manages, many
5080 +To control Mercurial's handling of files that it manages, many
5081 commands support the \fB\-I\fP and \fB\-X\fP options; see
5082 -\%\fBhg help <command>\fP\: and \%\fBhg help patterns\fP\: for details.
5083 +\fBhg help <command>\fP and \fBhg help patterns\fP for details.
5085 Files that are already tracked are not affected by .hgignore, even
5086 if they appear in .hgignore. An untracked file X can be explicitly
5087 -added with \%\fBhg add X\fP\:, even if X would be excluded by a pattern
5088 +added with \fBhg add X\fP, even if X would be excluded by a pattern
5089 in .hgignore.
5090 .SS Syntax
5092 @@ -6496,13 +6469,13 @@
5093 To change the syntax used, use a line of the following form:
5096 -.ft C
5097 +.ft
5098 syntax: NAME
5099 -.ft P
5100 +.ft
5103 where \fBNAME\fP is one of the following:
5104 -.INDENT 0.0
5105 +.RS 0
5107 .B \fBregexp\fP
5109 @@ -6511,7 +6484,7 @@
5110 .B \fBglob\fP
5112 Shell\-style glob.
5113 -.UNINDENT
5114 +.RE
5116 The chosen syntax stays in effect when parsing all patterns that
5117 follow, until another syntax is selected.
5118 @@ -6523,11 +6496,11 @@
5120 Subdirectories can have their own .hgignore settings by adding
5121 \fBsubinclude:path/to/subdir/.hgignore\fP to the root \fB.hgignore\fP. See
5122 -\%\fBhg help patterns\fP\: for details on \fBsubinclude:\fP and \fBinclude:\fP.
5123 +\fBhg help patterns\fP for details on \fBsubinclude:\fP and \fBinclude:\fP.
5124 .IP Note
5126 Patterns specified in other than \fB.hgignore\fP are always rooted.
5127 -Please see \%\fBhg help patterns\fP\: for details.
5128 +Please see \fBhg help patterns\fP for details.
5130 .SS Example
5132 @@ -6534,7 +6507,7 @@
5133 Here is an example ignore file.
5136 -.ft C
5137 +.ft
5138 # use glob syntax.
5139 syntax: glob
5141 @@ -6545,21 +6518,21 @@
5142 # switch to regexp syntax.
5143 syntax: regexp
5144 ^\e.pc/
5145 -.ft P
5146 +.ft
5148 .SH CONFIGURING HGWEB
5150 -Mercurial\(aqs internal web server, hgweb, can serve either a single
5151 +Mercurial's internal web server, hgweb, can serve either a single
5152 repository, or a tree of repositories. In the second case, repository
5153 paths and global options can be defined using a dedicated
5154 -configuration file common to \%\fBhg serve\fP\:, \fBhgweb.wsgi\fP,
5155 +configuration file common to \fBhg serve\fP, \fBhgweb.wsgi\fP,
5156 \fBhgweb.cgi\fP and \fBhgweb.fcgi\fP.
5158 This file uses the same syntax as other Mercurial configuration files
5159 but recognizes only the following sections:
5160 -.INDENT 0.0
5161 -.INDENT 3.5
5162 -.INDENT 0.0
5163 +.RS 0
5164 +.RS 3
5165 +.RS 0
5166 .IP \(bu 2
5169 @@ -6569,11 +6542,11 @@
5170 .IP \(bu 2
5172 collections
5173 -.UNINDENT
5174 -.UNINDENT
5175 -.UNINDENT
5176 +.RE
5177 +.RE
5178 +.RE
5180 -The \fBweb\fP options are thoroughly described in \%\fBhg help config\fP\:.
5181 +The \fBweb\fP options are thoroughly described in \fBhg help config\fP.
5183 The \fBpaths\fP section maps URL paths to paths of repositories in the
5184 filesystem. hgweb will not expose the filesystem directly \- only
5185 @@ -6588,7 +6561,7 @@
5186 path ends with \fB*\fP or \fB**\fP the filesystem will be searched
5187 recursively for repositories below that point.
5188 With \fB*\fP it will not recurse into the repositories it finds (except for
5189 -\fB.hg/patches\fP).
5190 +\fB\&.hg/patches\fP).
5191 With \fB**\fP it will also search inside repository working directories
5192 and possibly find subrepositories.
5194 @@ -6595,15 +6568,15 @@
5195 In this example:
5198 -.ft C
5199 +.ft
5200 [paths]
5201 /projects/a = /srv/tmprepos/a
5202 /projects/b = c:/repos/b
5203 / = /srv/repos/*
5204 /user/bob = /home/bob/repos/**
5205 -.ft P
5206 +.ft
5208 -.INDENT 0.0
5209 +.RS 0
5210 .IP \(bu 2
5212 The first two entries make two repositories in different directories
5213 @@ -6617,7 +6590,7 @@
5215 The fourth entry will publish both \fBhttp://server/user/bob/quux/\fP
5216 and \fBhttp://server/user/bob/quux/testsubrepo/\fP
5217 -.UNINDENT
5218 +.RE
5220 The \fBcollections\fP section is deprecated and has been superseded by
5221 \fBpaths\fP.
5222 @@ -6640,7 +6613,7 @@
5223 \fB/log?style=atom\fP. The hyphenated URL parameter is preferred.
5225 Not all templates are available for all styles. Attempting to use
5226 -a style that doesn\(aqt have all templates defined may result in an error
5227 +a style that doesn't have all templates defined may result in an error
5228 rendering the page.
5230 Many commands take a \fB{revision}\fP URL parameter. This defines the
5231 @@ -6647,7 +6620,7 @@
5232 changeset to operate on. This is commonly specified as the short,
5233 12 digit hexadecimal abbreviation for the full 40 character unique
5234 revision identifier. However, any value described by
5235 -\%\fBhg help revisions\fP\: typically works.
5236 +\fBhg help revisions\fP typically works.
5237 .SS Commands and URLs
5239 The following web commands and their URLs are available:
5240 @@ -6708,7 +6681,7 @@
5242 The argument for \fBrev\fP can be a single revision, a revision set,
5243 or a literal keyword to search for in changeset data (equivalent to
5244 -\%\fBhg log \-k\fP\:).
5245 +\fBhg log \-k\fP).
5247 The \fBrevcount\fP query string argument defines the maximum numbers of
5248 changesets to render.
5249 @@ -6793,7 +6766,7 @@
5251 Render help documentation.
5253 -This web command is roughly equivalent to \%\fBhg help\fP\:. If a \fBtopic\fP
5254 +This web command is roughly equivalent to \fBhg help\fP. If a \fBtopic\fP
5255 is defined, that help topic will be rendered. If not, an index of
5256 available help topics will be rendered.
5258 @@ -6858,9 +6831,9 @@
5259 .SH TECHNICAL IMPLEMENTATION TOPICS
5261 To access a subtopic, use "hg help internals.{subtopic\-name}"
5262 -.INDENT 0.0
5263 -.INDENT 3.5
5264 -.INDENT 0.0
5265 +.RS 0
5266 +.RS 3
5267 +.RS 0
5269 .B bundles
5271 @@ -6889,9 +6862,9 @@
5272 .B wireprotocol
5274 Wire Protocol
5275 -.UNINDENT
5276 -.UNINDENT
5277 -.UNINDENT
5278 +.RE
5279 +.RE
5280 +.RE
5281 .SH MERGE TOOLS
5283 To merge files Mercurial uses merge tools.
5284 @@ -6901,8 +6874,8 @@
5285 ancestor of the two file versions, so they can determine the changes
5286 made on both branches.
5288 -Merge tools are used both for \%\fBhg resolve\fP\:, \%\fBhg merge\fP\:, \%\fBhg update\fP\:,
5289 -\%\fBhg backout\fP\: and in several extensions.
5290 +Merge tools are used both for \fBhg resolve\fP, \fBhg merge\fP, \fBhg update\fP,
5291 +\fBhg backout\fP and in several extensions.
5293 Usually, the merge tool tries to automatically reconcile the files by
5294 combining all non\-overlapping changes that occurred separately in
5295 @@ -6927,7 +6900,7 @@
5297 There are some internal merge tools which can be used. The internal
5298 merge tools are:
5299 -.INDENT 0.0
5300 +.RS 0
5302 .B \fB:dump\fP
5304 @@ -6938,7 +6911,7 @@
5305 \fBa.txt.other\fP and \fBa.txt.base\fP and they will be placed in the
5306 same directory as \fBa.txt\fP.
5308 -This implies premerge. Therefore, files aren\(aqt dumped, if premerge
5309 +This implies premerge. Therefore, files aren't dumped, if premerge
5310 runs successfully. Use :forcedump to forcibly write files out.
5312 .B \fB:fail\fP
5313 @@ -6997,7 +6970,7 @@
5314 Uses the internal non\-interactive simple merge algorithm for merging
5315 files. It will use both left and right sides for conflict regions.
5316 No markers are inserted.
5317 -.UNINDENT
5318 +.RE
5320 Internal tools are always available and do not require a GUI but will by default
5321 not handle symlinks or binary files.
5322 @@ -7004,7 +6977,7 @@
5323 .SS Choosing a merge tool
5325 Mercurial uses these rules when deciding which merge tool to use:
5326 -.INDENT 0.0
5327 +.RS 0
5328 .IP 1. 3
5330 If a tool has been specified with the \-\-tool option to merge or resolve, it
5331 @@ -7041,11 +7014,11 @@
5332 .IP 8. 3
5334 Otherwise, \fB:prompt\fP is used.
5335 -.UNINDENT
5336 +.RE
5337 .IP Note
5339 After selecting a merge program, Mercurial will by default attempt
5340 -to merge the files using a simple merge algorithm first. Only if it doesn\(aqt
5341 +to merge the files using a simple merge algorithm first. Only if it doesn't
5342 succeed because of conflicting changes will Mercurial actually execute the
5343 merge program. Whether to use the simple merge algorithm first can be
5344 controlled by the premerge setting of the merge tool. Premerge is enabled by
5345 @@ -7062,10 +7035,10 @@
5346 To set the pager that should be used, set the application variable:
5349 -.ft C
5350 +.ft
5351 [pager]
5352 pager = less \-FRX
5353 -.ft P
5354 +.ft
5357 If no pager is set in the user or repository configuration, Mercurial uses the
5358 @@ -7075,7 +7048,7 @@
5360 On Windows, \fImore\fP is not color aware, so using it effectively disables color.
5361 MSYS and Cygwin shells provide \fIless\fP as a pager, which can be configured to
5362 -support ANSI color codes. See \%\fBhg help config.color.pagermode\fP\: to configure
5363 +support ANSI color codes. See \fBhg help config.color.pagermode\fP to configure
5364 the color mode when invoking a pager.
5366 You can disable the pager for certain commands by adding them to the
5367 @@ -7082,20 +7055,20 @@
5368 pager.ignore list:
5371 -.ft C
5372 +.ft
5373 [pager]
5374 ignore = version, help, update
5375 -.ft P
5376 +.ft
5379 -To ignore global commands like \%\fBhg version\fP\: or \%\fBhg help\fP\:, you have
5380 +To ignore global commands like \fBhg version\fP or \fBhg help\fP, you have
5381 to specify them in your user configuration file.
5383 To control whether the pager is used at all for an individual command,
5384 you can use \-\-pager=<value>:
5385 -.INDENT 0.0
5386 -.INDENT 3.5
5387 -.INDENT 0.0
5388 +.RS 0
5389 +.RS 3
5390 +.RS 0
5391 .IP \(bu 2
5393 use as needed: \fIauto\fP.
5394 @@ -7106,17 +7079,17 @@
5396 suppress the pager: \fIno\fP or \fIoff\fP (any unrecognized value
5397 will also work).
5398 -.UNINDENT
5399 -.UNINDENT
5400 -.UNINDENT
5401 +.RE
5402 +.RE
5403 +.RE
5405 To globally turn off all attempts to use a pager, set:
5408 -.ft C
5409 +.ft
5410 [ui]
5411 paginate = never
5412 -.ft P
5413 +.ft
5416 which will prevent the pager from running.
5417 @@ -7132,7 +7105,7 @@
5418 .IP Note
5420 Patterns specified in \fB.hgignore\fP are not rooted.
5421 -Please see \%\fBhg help hgignore\fP\: for details.
5422 +Please see \fBhg help hgignore\fP for details.
5425 To use a plain path name without any pattern matching, start it with
5426 @@ -7160,8 +7133,8 @@
5427 To read a set of patterns from a file, use \fBinclude:\fP or \fBsubinclude:\fP.
5428 \fBinclude:\fP will use all the patterns from the given file and treat them as if
5429 they had been passed in manually. \fBsubinclude:\fP will only apply the patterns
5430 -against files that are under the subinclude file\(aqs directory. See \%\fBhg help
5431 -hgignore\fP\: for details on the format of these files.
5432 +against files that are under the subinclude file's directory. See \fBhg help
5433 +hgignore\fP for details on the format of these files.
5435 All patterns, except for \fBglob:\fP specified in command line (not for
5436 \fB\-I\fP or \fB\-X\fP options), can match also against directories: files
5437 @@ -7171,19 +7144,19 @@
5438 Plain examples:
5441 -.ft C
5442 +.ft
5443 path:foo/bar a name bar in a directory named foo in the root
5444 of the repository
5445 path:path:name a file or directory named "path:name"
5446 rootfilesin:foo/bar the files in a directory called foo/bar, but not any files
5447 in its subdirectories and not a file bar in directory foo
5448 -.ft P
5449 +.ft
5452 Glob examples:
5455 -.ft C
5456 +.ft
5457 glob:*.c any name ending in ".c" in the current directory
5458 *.c any name ending in ".c" in the current directory
5459 **.c any name ending in ".c" in any subdirectory of the
5460 @@ -7194,36 +7167,36 @@
5461 foo/*.c any name ending in ".c" in the directory foo
5462 foo/**.c any name ending in ".c" in any subdirectory of foo
5463 including itself.
5464 -.ft P
5465 +.ft
5468 Regexp examples:
5471 -.ft C
5472 +.ft
5473 re:.*\e.c$ any name ending in ".c", anywhere in the repository
5474 -.ft P
5475 +.ft
5478 File examples:
5481 -.ft C
5482 +.ft
5483 listfile:list.txt read list from list.txt with one file pattern per line
5484 listfile0:list.txt read list from list.txt with null byte delimiters
5485 -.ft P
5486 +.ft
5489 -See also \%\fBhg help filesets\fP\:.
5490 +See also \fBhg help filesets\fP.
5492 Include examples:
5495 -.ft C
5496 +.ft
5497 include:path/to/mypatternfile reads patterns to be applied to all paths
5498 subinclude:path/to/subignorefile reads patterns specifically for paths in the
5499 subdirectory
5500 -.ft P
5501 +.ft
5503 .SH WORKING WITH PHASES
5504 .SS What are phases?
5505 @@ -7233,9 +7206,9 @@
5506 (for instance, with the mq or rebase extensions).
5508 Each changeset in a repository is in one of the following phases:
5509 -.INDENT 0.0
5510 -.INDENT 3.5
5511 -.INDENT 0.0
5512 +.RS 0
5513 +.RS 3
5514 +.RS 0
5515 .IP \(bu 2
5517 public : changeset is visible on a public server
5518 @@ -7245,9 +7218,9 @@
5519 .IP \(bu 2
5521 secret : changeset should not be pushed, pulled, or cloned
5522 -.UNINDENT
5523 -.UNINDENT
5524 -.UNINDENT
5525 +.RE
5526 +.RE
5527 +.RE
5529 These phases are ordered (public < draft < secret) and no changeset
5530 can be in a lower phase than its ancestors. For instance, if a
5531 @@ -7261,17 +7234,17 @@
5533 Once changesets become public, extensions like mq and rebase will
5534 refuse to operate on them to prevent creating duplicate changesets.
5535 -Phases can also be manually manipulated with the \%\fBhg phase\fP\: command
5536 -if needed. See \%\fBhg help \-v phase\fP\: for examples.
5537 +Phases can also be manually manipulated with the \fBhg phase\fP command
5538 +if needed. See \fBhg help \-v phase\fP for examples.
5540 To make your commits secret by default, put this in your
5541 configuration file:
5544 -.ft C
5545 +.ft
5546 [phases]
5547 new\-commit = secret
5548 -.ft P
5549 +.ft
5551 .SS Phases and servers
5553 @@ -7278,7 +7251,7 @@
5554 Normally, all servers are \fBpublishing\fP by default. This means:
5557 -.ft C
5558 +.ft
5559 \- all draft changesets that are pulled or cloned appear in phase
5560 public on the client
5562 @@ -7286,7 +7259,7 @@
5563 client and server
5565 \- secret changesets are neither pushed, pulled, or cloned
5566 -.ft P
5567 +.ft
5569 .IP Note
5571 @@ -7299,13 +7272,13 @@
5572 repository to disable publishing in its configuration file:
5575 -.ft C
5576 +.ft
5577 [phases]
5578 publish = False
5579 -.ft P
5580 +.ft
5583 -See \%\fBhg help config\fP\: for more information on configuration files.
5584 +See \fBhg help config\fP for more information on configuration files.
5585 .IP Note
5587 Servers running older versions of Mercurial are treated as
5588 @@ -7319,17 +7292,17 @@
5589 of the secret changeset may be communicated to the server.
5591 .SS Examples
5592 -.INDENT 0.0
5593 -.INDENT 3.5
5594 -.INDENT 0.0
5595 +.RS 0
5596 +.RS 3
5597 +.RS 0
5598 .IP \(bu 2
5600 list changesets in draft or secret phase:
5603 -.ft C
5604 +.ft
5605 hg log \-r "not public()"
5606 -.ft P
5607 +.ft
5609 .IP \(bu 2
5611 @@ -7336,9 +7309,9 @@
5612 change all secret changesets to draft:
5615 -.ft C
5616 +.ft
5617 hg phase \-\-draft "secret()"
5618 -.ft P
5619 +.ft
5621 .IP \(bu 2
5623 @@ -7345,9 +7318,9 @@
5624 forcibly move the current changeset and descendants from public to draft:
5627 -.ft C
5628 +.ft
5629 hg phase \-\-force \-\-draft .
5630 -.ft P
5631 +.ft
5633 .IP \(bu 2
5635 @@ -7354,9 +7327,9 @@
5636 show a list of changeset revisions and each corresponding phase:
5639 -.ft C
5640 +.ft
5641 hg log \-\-template "{rev} {phase}\en"
5642 -.ft P
5643 +.ft
5645 .IP \(bu 2
5647 @@ -7363,15 +7336,15 @@
5648 resynchronize draft changesets relative to a remote repository:
5651 -.ft C
5652 +.ft
5653 hg phase \-fd "outgoing(URL)"
5654 -.ft P
5655 +.ft
5657 -.UNINDENT
5658 -.UNINDENT
5659 -.UNINDENT
5660 +.RE
5661 +.RE
5662 +.RE
5664 -See \%\fBhg help phase\fP\: for more information on manually manipulating phases.
5665 +See \fBhg help phase\fP for more information on manually manipulating phases.
5666 .SH SPECIFYING REVISIONS
5668 Mercurial supports several ways to specify revisions.
5669 @@ -7422,19 +7395,19 @@
5671 Special characters can be used in quoted identifiers by escaping them,
5672 e.g., \fB\en\fP is interpreted as a newline. To prevent them from being
5673 -interpreted, strings can be prefixed with \fBr\fP, e.g. \fBr\(aq...\(aq\fP.
5674 +interpreted, strings can be prefixed with \fBr\fP, e.g. \fBr'...'\fP.
5675 .SS Operators
5677 There is a single prefix operator:
5678 -.INDENT 0.0
5679 +.RS 0
5681 .B \fBnot x\fP
5683 Changesets not in x. Short form is \fB! x\fP.
5684 -.UNINDENT
5685 +.RE
5687 These are the supported infix operators:
5688 -.INDENT 0.0
5689 +.RS 0
5691 .B \fBx::y\fP
5693 @@ -7491,25 +7464,25 @@
5694 For example:
5697 -.ft C
5698 +.ft
5699 [revsetalias]
5700 -issue(a1) = grep(r\(aq\ebissue[ :]?\(aq ## a1 ## r\(aq\eb|\ebbug\e(\(aq ## a1 ## r\(aq\e)\(aq)
5701 -.ft P
5702 +issue(a1) = grep(r'\ebissue[ :]?' ## a1 ## r'\eb|\ebbug\e(' ## a1 ## r'\e)')
5703 +.ft
5706 \fBissue(1234)\fP is equivalent to
5707 -\fBgrep(r\(aq\ebissue[ :]?1234\eb|\ebbug\e(1234\e)\(aq)\fP
5708 +\fBgrep(r'\ebissue[ :]?1234\eb|\ebbug\e(1234\e)')\fP
5709 in this case. This matches against all of "issue 1234", "issue:1234",
5710 "issue1234" and "bug(1234)".
5711 -.UNINDENT
5712 +.RE
5714 There is a single postfix operator:
5715 -.INDENT 0.0
5716 +.RS 0
5718 .B \fBx^\fP
5720 Equivalent to \fBx^1\fP, the first parent of each changeset in x.
5721 -.UNINDENT
5722 +.RE
5723 .SS Patterns
5725 Where noted, predicates that perform string matching can accept a pattern
5726 @@ -7522,12 +7495,12 @@
5727 insensitive match on a case\-sensitive predicate, use a regular expression,
5728 prefixed with \fB(?i)\fP.
5730 -For example, \fBtag(r\(aqre:(?i)release\(aq)\fP matches "release" or "RELEASE"
5731 +For example, \fBtag(r're:(?i)release')\fP matches "release" or "RELEASE"
5732 or "Release", etc.
5733 .SS Predicates
5735 The following predicates are supported:
5736 -.INDENT 0.0
5737 +.RS 0
5739 .B \fBadds(pattern)\fP
5741 @@ -7564,7 +7537,7 @@
5742 .B \fBbisect(string)\fP
5744 Changesets marked in the specified bisect status:
5745 -.INDENT 7.0
5746 +.RS 7
5747 .IP \(bu 2
5749 \fBgood\fP, \fBbad\fP, \fBskip\fP: csets explicitly marked as good/bad/skip
5750 @@ -7586,13 +7559,13 @@
5751 .IP \(bu 2
5753 \fBcurrent\fP : the cset currently being bisected
5754 -.UNINDENT
5755 +.RE
5757 .B \fBbookmark([name])\fP
5759 The named bookmark or all bookmarks.
5761 -Pattern matching is supported for \fIname\fP. See \%\fBhg help revisions.patterns\fP\:.
5762 +Pattern matching is supported for \fIname\fP. See \fBhg help revisions.patterns\fP.
5764 .B \fBbranch(string or set)\fP
5766 @@ -7600,7 +7573,7 @@
5767 changesets.
5769 Pattern matching is supported for \fIstring\fP. See
5770 -\%\fBhg help revisions.patterns\fP\:.
5771 +\fBhg help revisions.patterns\fP.
5773 .B \fBbranchpoint()\fP
5775 @@ -7622,8 +7595,8 @@
5777 .B \fBcontains(pattern)\fP
5779 -The revision\(aqs manifest contains a file matching pattern (but might not
5780 -modify it). See \%\fBhg help patterns\fP\: for information about file patterns.
5781 +The revision's manifest contains a file matching pattern (but might not
5782 +modify it). See \fBhg help patterns\fP for information about file patterns.
5784 The pattern without explicit kind like \fBglob:\fP is expected to be
5785 relative to the current directory and match against a file exactly
5786 @@ -7636,7 +7609,7 @@
5788 .B \fBdate(interval)\fP
5790 -Changesets within the interval, see \%\fBhg help dates\fP\:.
5791 +Changesets within the interval, see \fBhg help dates\fP.
5793 .B \fBdesc(string)\fP
5795 @@ -7643,7 +7616,7 @@
5796 Search commit message for string. The match is case\-insensitive.
5798 Pattern matching is supported for \fIstring\fP. See
5799 -\%\fBhg help revisions.patterns\fP\:.
5800 +\fBhg help revisions.patterns\fP.
5802 .B \fBdescendants(set[, depth])\fP
5804 @@ -7673,7 +7646,7 @@
5805 optional value.
5807 Pattern matching is supported for \fIvalue\fP. See
5808 -\%\fBhg help revisions.patterns\fP\:.
5809 +\fBhg help revisions.patterns\fP.
5811 .B \fBfile(pattern)\fP
5813 @@ -7690,7 +7663,7 @@
5815 For performance reasons, visits only revisions mentioned in the file\-level
5816 filelog, rather than filtering through all changesets (much faster, but
5817 -doesn\(aqt include deletes or duplicate changes). For a slower, more accurate
5818 +doesn't include deletes or duplicate changes). For a slower, more accurate
5819 result, use \fBfile()\fP.
5821 The pattern without explicit kind like \fBglob:\fP is expected to be
5822 @@ -7697,7 +7670,7 @@
5823 relative to the current directory and match against a file exactly
5824 for efficiency.
5826 -If some linkrev points to revisions filtered by the current repoview, we\(aqll
5827 +If some linkrev points to revisions filtered by the current repoview, we'll
5828 work around it to return a non\-filtered value.
5830 .B \fBfirst(set, [n])\fP
5831 @@ -7706,25 +7679,25 @@
5833 .B \fBfollow([pattern[, startrev]])\fP
5835 -An alias for \fB::.\fP (ancestors of the working directory\(aqs first parent).
5836 +An alias for \fB::.\fP (ancestors of the working directory's first parent).
5837 If pattern is specified, the histories of files matching given
5838 pattern in the revision given by startrev are followed, including copies.
5840 .B \fBfollowlines(file, fromline:toline[, startrev=., descend=False])\fP
5842 -Changesets modifying \fIfile\fP in line range (\(aqfromline\(aq, \(aqtoline\(aq).
5843 +Changesets modifying \fIfile\fP in line range ('fromline', 'toline').
5845 -Line range corresponds to \(aqfile\(aq content at \(aqstartrev\(aq and should hence be
5846 -consistent with file size. If startrev is not specified, working directory\(aqs
5847 +Line range corresponds to 'file' content at 'startrev' and should hence be
5848 +consistent with file size. If startrev is not specified, working directory's
5849 parent is used.
5851 -By default, ancestors of \(aqstartrev\(aq are returned. If \(aqdescend\(aq is True,
5852 -descendants of \(aqstartrev\(aq are returned though renames are (currently) not
5853 +By default, ancestors of 'startrev' are returned. If 'descend' is True,
5854 +descendants of 'startrev' are returned though renames are (currently) not
5855 followed in this direction.
5857 .B \fBgrep(regex)\fP
5859 -Like \fBkeyword(string)\fP but accepts a regex. Use \fBgrep(r\(aq...\(aq)\fP
5860 +Like \fBkeyword(string)\fP but accepts a regex. Use \fBgrep(r'...')\fP
5861 to ensure special escape characters are handled correctly. Unlike
5862 \fBkeyword(string)\fP, the match is case\-sensitive.
5864 @@ -7810,7 +7783,7 @@
5865 The changesets in a given namespace.
5867 Pattern matching is supported for \fInamespace\fP. See
5868 -\%\fBhg help revisions.patterns\fP\:.
5869 +\fBhg help revisions.patterns\fP.
5871 .B \fBobsolete()\fP
5873 @@ -7850,7 +7823,7 @@
5875 .B \fBpresent(set)\fP
5877 -An empty set, if any revision in set isn\(aqt found; otherwise,
5878 +An empty set, if any revision in set isn't found; otherwise,
5879 all revisions in set.
5881 If any of specified revisions is not present in the local repository,
5882 @@ -7864,7 +7837,7 @@
5883 .B \fBremote([id [,path]])\fP
5885 Local revision that corresponds to the given identifier in a
5886 -remote repository, if present. Here, the \(aq.\(aq identifier is a
5887 +remote repository, if present. Here, the '.' identifier is a
5888 synonym for the current local branch.
5890 .B \fBremoves(pattern)\fP
5891 @@ -7897,7 +7870,7 @@
5892 as \fB\-key\fP to sort in descending order.
5894 The keys can be:
5895 -.INDENT 7.0
5896 +.RS 7
5897 .IP \(bu 2
5899 \fBrev\fP for the revision number,
5900 @@ -7916,7 +7889,7 @@
5901 .IP \(bu 2
5903 \fBtopo\fP for a reverse topographical sort
5904 -.UNINDENT
5905 +.RE
5907 The \fBtopo\fP sort order cannot be combined with other sort keys. This sort
5908 takes one optional argument, \fBtopo.firstbranch\fP, which takes a revset that
5909 @@ -7936,7 +7909,7 @@
5910 The specified tag by name, or all tagged revisions if no name is given.
5912 Pattern matching is supported for \fIname\fP. See
5913 -\%\fBhg help revisions.patterns\fP\:.
5914 +\fBhg help revisions.patterns\fP.
5916 .B \fBuser(string)\fP
5918 @@ -7943,8 +7916,8 @@
5919 User name contains string. The match is case\-insensitive.
5921 Pattern matching is supported for \fIstring\fP. See
5922 -\%\fBhg help revisions.patterns\fP\:.
5923 -.UNINDENT
5924 +\fBhg help revisions.patterns\fP.
5925 +.RE
5926 .SS Aliases
5928 New predicates (known as "aliases") can be defined, using any combination of
5929 @@ -7951,9 +7924,9 @@
5930 existing predicates or other aliases. An alias definition looks like:
5933 -.ft C
5934 +.ft
5935 <alias> = <definition>
5936 -.ft P
5937 +.ft
5940 in the \fBrevsetalias\fP section of a Mercurial configuration file. Arguments
5941 @@ -7963,12 +7936,12 @@
5942 For example,
5945 -.ft C
5946 +.ft
5947 [revsetalias]
5948 h = heads()
5949 d(s) = sort(s, date)
5950 rs(s, k) = reverse(sort(s, k))
5951 -.ft P
5952 +.ft
5955 defines three aliases, \fBh\fP, \fBd\fP, and \fBrs\fP. \fBrs(0:tip, author)\fP is
5956 @@ -7975,10 +7948,10 @@
5957 exactly equivalent to \fBreverse(sort(0:tip, author))\fP.
5958 .SS Equivalents
5960 -Command line equivalents for \%\fBhg log\fP\::
5961 +Command line equivalents for \fBhg log\fP:
5964 -.ft C
5965 +.ft
5966 \-f \-> ::.
5967 \-d x \-> date(x)
5968 \-k x \-> keyword(x)
5969 @@ -7987,20 +7960,20 @@
5970 \-b x \-> branch(x)
5971 \-P x \-> !::x
5972 \-l x \-> limit(expr, x)
5973 -.ft P
5974 +.ft
5976 .SS Examples
5978 Some sample queries:
5979 -.INDENT 0.0
5980 +.RS 0
5981 .IP \(bu 2
5983 Changesets on the default branch:
5986 -.ft C
5987 +.ft
5988 hg log \-r "branch(default)"
5989 -.ft P
5990 +.ft
5992 .IP \(bu 2
5994 @@ -8007,9 +7980,9 @@
5995 Changesets on the default branch since tag 1.5 (excluding merges):
5998 -.ft C
5999 +.ft
6000 hg log \-r "branch(default) and 1.5:: and not merge()"
6001 -.ft P
6002 +.ft
6004 .IP \(bu 2
6006 @@ -8016,9 +7989,9 @@
6007 Open branch heads:
6010 -.ft C
6011 +.ft
6012 hg log \-r "head() and not closed()"
6013 -.ft P
6014 +.ft
6016 .IP \(bu 2
6018 @@ -8026,9 +7999,9 @@
6019 \fBhgext/*\fP:
6022 -.ft C
6023 -hg log \-r "1.3::1.5 and keyword(bug) and file(\(aqhgext/*\(aq)"
6024 -.ft P
6025 +.ft
6026 +hg log \-r "1.3::1.5 and keyword(bug) and file('hgext/*')"
6027 +.ft
6029 .IP \(bu 2
6031 @@ -8035,9 +8008,9 @@
6032 Changesets committed in May 2008, sorted by user:
6035 -.ft C
6036 -hg log \-r "sort(date(\(aqMay 2008\(aq), user)"
6037 -.ft P
6038 +.ft
6039 +hg log \-r "sort(date('May 2008'), user)"
6040 +.ft
6042 .IP \(bu 2
6044 @@ -8045,9 +8018,9 @@
6045 release:
6048 -.ft C
6049 +.ft
6050 hg log \-r "(keyword(bug) or keyword(issue)) and not ancestors(tag())"
6051 -.ft P
6052 +.ft
6054 .IP \(bu 2
6056 @@ -8055,9 +8028,9 @@
6057 bookmark (this works because the last revision of the revset is used):
6060 -.ft C
6061 +.ft
6062 hg update :@
6063 -.ft P
6064 +.ft
6066 .IP \(bu 2
6068 @@ -8065,11 +8038,11 @@
6069 last revisions of the revset are used):
6072 -.ft C
6073 +.ft
6074 hg diff \-r 1.3::1.5
6075 -.ft P
6076 +.ft
6078 -.UNINDENT
6079 +.RE
6080 .SH USING MERCURIAL FROM SCRIPTS AND AUTOMATION
6082 It is common for machines (as opposed to humans) to consume Mercurial.
6083 @@ -8079,7 +8052,7 @@
6085 Machines have a choice of several methods to interface with Mercurial.
6086 These include:
6087 -.INDENT 0.0
6088 +.RS 0
6089 .IP \(bu 2
6091 Executing the \fBhg\fP process
6092 @@ -8089,21 +8062,21 @@
6093 .IP \(bu 2
6095 Calling out to a command server
6096 -.UNINDENT
6097 +.RE
6099 Executing \fBhg\fP processes is very similar to how humans interact with
6100 Mercurial in the shell. It should already be familiar to you.
6102 -\%\fBhg serve\fP\: can be used to start a server. By default, this will start
6103 +\fBhg serve\fP can be used to start a server. By default, this will start
6104 a "hgweb" HTTP server. This HTTP server has support for machine\-readable
6105 -output, such as JSON. For more, see \%\fBhg help hgweb\fP\:.
6106 +output, such as JSON. For more, see \fBhg help hgweb\fP.
6108 -\%\fBhg serve\fP\: can also start a "command server." Clients can connect
6109 +\fBhg serve\fP can also start a "command server." Clients can connect
6110 to this server and issue Mercurial commands over a special protocol.
6111 For more details on the command server, including links to client
6112 -libraries, see \%https://www.mercurial\-scm.org/wiki/CommandServer\:.
6113 +libraries, see https://www.mercurial\-scm.org/wiki/CommandServer.
6115 -\%\fBhg serve\fP\: based interfaces (the hgweb and command servers) have the
6116 +\fBhg serve\fP based interfaces (the hgweb and command servers) have the
6117 advantage over simple \fBhg\fP process invocations in that they are
6118 likely more efficient. This is because there is significant overhead
6119 to spawn new Python processes.
6120 @@ -8115,14 +8088,14 @@
6122 .SS Environment Variables
6124 -As documented in \%\fBhg help environment\fP\:, various environment variables
6125 +As documented in \fBhg help environment\fP, various environment variables
6126 influence the operation of Mercurial. The following are particularly
6127 relevant for machines consuming Mercurial:
6128 -.INDENT 0.0
6129 +.RS 0
6131 .B HGPLAIN
6133 -If not set, Mercurial\(aqs output could be influenced by configuration
6134 +If not set, Mercurial's output could be influenced by configuration
6135 settings that impact its encoding, verbose mode, localization, etc.
6137 It is highly recommended for machines to set this variable when
6138 @@ -8143,7 +8116,7 @@
6139 .B HGRCPATH
6141 If not set, Mercurial will inherit config options from config files
6142 -using the process described in \%\fBhg help config\fP\:. This includes
6143 +using the process described in \fBhg help config\fP. This includes
6144 inheriting user or system\-wide config files.
6146 When utmost control over the Mercurial configuration is desired, the
6147 @@ -8154,7 +8127,7 @@
6148 consequences, as the user and system config files often define things
6149 like the username and extensions that may be required to interface
6150 with a repository.
6151 -.UNINDENT
6152 +.RE
6153 .SS Consuming Command Output
6155 It is common for machines to need to parse the output of Mercurial
6156 @@ -8178,7 +8151,7 @@
6157 .SS Using Templates to Control Output
6159 Many \fBhg\fP commands support templatized output via the
6160 -\fB\-T/\-\-template\fP argument. For more, see \%\fBhg help templates\fP\:.
6161 +\fB\-T/\-\-template\fP argument. For more, see \fBhg help templates\fP.
6163 Templates are useful for explicitly controlling output so that
6164 you get exactly the data you want formatted how you want it. For
6165 @@ -8216,13 +8189,13 @@
6167 Commands often have varying output verbosity, even when machine
6168 readable styles are being used (e.g. \fB\-T json\fP). Adding
6169 -\fB\-v/\-\-verbose\fP and \fB\-\-debug\fP to the command\(aqs arguments can
6170 +\fB\-v/\-\-verbose\fP and \fB\-\-debug\fP to the command's arguments can
6171 increase the amount of data exposed by Mercurial.
6173 An alternate way to get the data you need is by explicitly specifying
6174 a template.
6175 .SS Other Topics
6176 -.INDENT 0.0
6177 +.RS 0
6179 .B revsets
6181 @@ -8230,7 +8203,7 @@
6182 of revisions. Think of it as SQL for Mercurial repositories. Revsets
6183 are useful for querying repositories for specific data.
6185 -See \%\fBhg help revsets\fP\: for more.
6186 +See \fBhg help revsets\fP for more.
6188 .B share extension
6190 @@ -8244,8 +8217,8 @@
6191 network. This is especially true for continuous integration (CI)
6192 environments.
6194 -See \%\fBhg help \-e share\fP\: for more.
6195 -.UNINDENT
6196 +See \fBhg help \-e share\fP for more.
6197 +.RE
6198 .SH SUBREPOSITORIES
6200 Subrepositories let you nest external repositories or projects into a
6201 @@ -8256,7 +8229,7 @@
6202 subrepositories.
6204 Subrepositories are made of three components:
6205 -.INDENT 0.0
6206 +.RS 0
6207 .IP 1. 3
6209 Nested repository checkouts. They can appear anywhere in the
6210 @@ -8269,18 +8242,18 @@
6211 subrepositories are referenced like:
6214 -.ft C
6215 +.ft
6216 path/to/nested = https://example.com/nested/repo/path
6217 -.ft P
6218 +.ft
6221 Git and Subversion subrepos are also supported:
6224 -.ft C
6225 +.ft
6226 path/to/nested = [git]git://example.com/nested/repo/path
6227 path/to/nested = [svn]https://example.com/nested/trunk/path
6228 -.ft P
6229 +.ft
6232 where \fBpath/to/nested\fP is the checkout location relatively to the
6233 @@ -8303,7 +8276,7 @@
6235 The \fB.hgsubstate\fP file should not be edited manually.
6237 -.UNINDENT
6238 +.RE
6239 .SS Adding a Subrepository
6241 If \fB.hgsub\fP does not exist, create it and add it to the parent
6242 @@ -8311,7 +8284,7 @@
6243 to live in the parent repository. Edit \fB.hgsub\fP and add the
6244 subrepository entry as described above. At this point, the
6245 subrepository is tracked and the next commit will record its state in
6246 -\fB.hgsubstate\fP and bind it to the committed changeset.
6247 +\fB\&.hgsubstate\fP and bind it to the committed changeset.
6248 .SS Synchronizing a Subrepository
6250 Subrepos do not automatically track the latest changeset of their
6251 @@ -8328,7 +8301,7 @@
6252 To remove a subrepository from the parent repository, delete its
6253 reference from \fB.hgsub\fP, then remove its files.
6254 .SS Interaction with Mercurial Commands
6255 -.INDENT 0.0
6256 +.RS 0
6258 .B add
6260 @@ -8363,7 +8336,7 @@
6261 have been modified, Mercurial will abort. Mercurial can be made
6262 to instead commit all modified subrepositories by specifying
6263 \-S/\-\-subrepos, or setting "ui.commitsubrepos=True" in a
6264 -configuration file (see \%\fBhg help config\fP\:). After there are no
6265 +configuration file (see \fBhg help config\fP). After there are no
6266 longer any modified subrepositories, it records their state and
6267 finally commits it in the parent repository. The \-\-addremove
6268 option also honors the \-S/\-\-subrepos option. However, Git and
6269 @@ -8403,7 +8376,7 @@
6270 .B pull
6272 pull is not recursive since it is not clear what to pull prior
6273 -to running \%\fBhg update\fP\:. Listing and retrieving all
6274 +to running \fBhg update\fP. Listing and retrieving all
6275 subrepositories changes referenced by the parent repository pulled
6276 changesets is expensive at best, impossible in the Subversion
6277 case.
6278 @@ -8444,7 +8417,7 @@
6279 changeset is not available in the current subrepository, Mercurial
6280 will pull it in first before updating. This means that updating
6281 can require network access when using subrepositories.
6282 -.UNINDENT
6283 +.RE
6284 .SS Remapping Subrepositories Sources
6286 A subrepository source location may change during a project life,
6287 @@ -8462,12 +8435,12 @@
6288 outgoing, incoming, tip, parents, and heads.
6290 Some built\-in styles are packaged with Mercurial. These can be listed
6291 -with \%\fBhg log \-\-template list\fP\:. Example usage:
6292 +with \fBhg log \-\-template list\fP. Example usage:
6295 -.ft C
6296 +.ft
6297 $ hg log \-r1.0::1.1 \-\-template changelog
6298 -.ft P
6299 +.ft
6302 A template is a piece of text, with markup to invoke variable
6303 @@ -8474,10 +8447,10 @@
6304 expansion:
6307 -.ft C
6308 +.ft
6309 $ hg log \-r1 \-\-template "{node}\en"
6310 b56ce7b07c52de7d5fd79fb89701ea538af65746
6311 -.ft P
6312 +.ft
6314 .SS Keywords
6316 @@ -8484,7 +8457,7 @@
6317 Strings in curly braces are called keywords. The availability of
6318 keywords depends on the exact context of the templater. These
6319 keywords are usually available for templating a log\-like command:
6320 -.INDENT 0.0
6321 +.RS 0
6323 .B activebookmark
6325 @@ -8501,7 +8474,7 @@
6326 .B bookmarks
6328 List of strings. Any bookmarks associated with the
6329 -changeset. Also sets \(aqactive\(aq, the name of the active bookmark.
6330 +changeset. Also sets 'active', the name of the active bookmark.
6332 .B branch
6334 @@ -8531,7 +8504,7 @@
6336 .B extras
6338 -List of dicts with key, value entries of the \(aqextras\(aq
6339 +List of dicts with key, value entries of the 'extras'
6340 field of this changeset.
6342 .B file_adds
6343 @@ -8568,7 +8541,7 @@
6345 .B graphwidth
6347 -Integer. The width of the graph drawn by \(aqlog \-\-graph\(aq or zero.
6348 +Integer. The width of the graph drawn by 'log \-\-graph' or zero.
6350 .B index
6352 @@ -8596,24 +8569,24 @@
6354 .B p1node
6356 -String. The identification hash of the changeset\(aqs first parent,
6357 +String. The identification hash of the changeset's first parent,
6358 as a 40 digit hexadecimal string. If the changeset has no parents, all
6359 digits are 0.
6361 .B p1rev
6363 -Integer. The repository\-local revision number of the changeset\(aqs
6364 +Integer. The repository\-local revision number of the changeset's
6365 first parent, or \-1 if the changeset has no parents.
6367 .B p2node
6369 -String. The identification hash of the changeset\(aqs second
6370 +String. The identification hash of the changeset's second
6371 parent, as a 40 digit hexadecimal string. If the changeset has no second
6372 parent, all digits are 0.
6374 .B p2rev
6376 -Integer. The repository\-local revision number of the changeset\(aqs
6377 +Integer. The repository\-local revision number of the changeset's
6378 second parent, or \-1 if the changeset has no second parent.
6380 .B parents
6381 @@ -8650,25 +8623,25 @@
6382 .B termwidth
6384 Integer. The width of the current terminal.
6385 -.UNINDENT
6386 +.RE
6388 The "date" keyword does not produce human\-readable output. If you
6389 want to use a date in your output, you can use a filter to process
6390 it. Filters are functions which return a string based on the input
6391 -variable. Be sure to use the stringify filter first when you\(aqre
6392 +variable. Be sure to use the stringify filter first when you're
6393 applying a string\-input filter to a list\-like input variable.
6394 You can also use a chain of filters to get the desired output:
6397 -.ft C
6398 +.ft
6399 $ hg tip \-\-template "{date|isodate}\en"
6400 2008\-08\-21 18:22 +0000
6401 -.ft P
6402 +.ft
6404 .SS Filters
6406 List of filters:
6407 -.INDENT 0.0
6408 +.RS 0
6410 .B addbreaks
6412 @@ -8751,7 +8724,7 @@
6414 .B nonempty
6416 -Any text. Returns \(aq(none)\(aq if the string is empty.
6417 +Any text. Returns '(none)' if the string is empty.
6419 .B obfuscate
6421 @@ -8831,7 +8804,7 @@
6422 .B utf8
6424 Any text. Converts from the local character encoding to UTF\-8.
6425 -.UNINDENT
6426 +.RE
6428 Note that a filter is nothing more than a function call, i.e.
6429 \fBexpr|filter\fP is equivalent to \fBfilter(expr)\fP.
6430 @@ -8838,11 +8811,11 @@
6431 .SS Functions
6433 In addition to filters, there are some basic built\-in functions:
6434 -.INDENT 0.0
6435 +.RS 0
6437 .B date(date[, fmt])
6439 -Format a date. See \%\fBhg help dates\fP\: for formatting
6440 +Format a date. See \fBhg help dates\fP for formatting
6441 strings. The default is a Unix date format, including the timezone:
6442 "Mon Sep 04 15:13:13 2006 0700".
6444 @@ -8859,7 +8832,7 @@
6445 .B files(pattern)
6447 All files of the current changeset matching the pattern. See
6448 -\%\fBhg help patterns\fP\:.
6449 +\fBhg help patterns\fP.
6451 .B fill(text[, width[, initialident[, hangindent]]])
6453 @@ -8928,7 +8901,7 @@
6455 Calculate a mod b such that a / b + a mod b == a
6457 -.B pad(text, width[, fillchar=\(aq \(aq[, left=False]])
6458 +.B pad(text, width[, fillchar=' '[, left=False]])
6460 Pad text with a
6461 fill character.
6462 @@ -8941,7 +8914,7 @@
6463 .B revset(query[, formatargs...])
6465 Execute a revision set query. See
6466 -\%\fBhg help revset\fP\:.
6467 +\fBhg help revset\fP.
6469 .B rstdoc(text, style)
6471 @@ -8974,18 +8947,18 @@
6472 .B word(number, text[, separator])
6474 Return the nth word from a string.
6475 -.UNINDENT
6476 +.RE
6477 .SS Operators
6479 We provide a limited set of infix arithmetic operations on integers:
6482 -.ft C
6483 +.ft
6484 + for addition
6485 \- for subtraction
6486 * for multiplication
6487 / for floor division (division rounded to integer nearest \-infinity)
6488 -.ft P
6489 +.ft
6492 Division fulfills the law x = x / y + mod(x, y).
6493 @@ -8993,25 +8966,25 @@
6494 Also, for any expression that returns a list, there is a list operator:
6497 -.ft C
6498 +.ft
6499 expr % "{template}"
6500 -.ft P
6501 +.ft
6504 As seen in the above example, \fB{template}\fP is interpreted as a template.
6505 To prevent it from being interpreted, you can use an escape character \fB\e{\fP
6506 -or a raw string prefix, \fBr\(aq...\(aq\fP.
6507 +or a raw string prefix, \fBr'...'\fP.
6509 The dot operator can be used as a shorthand for accessing a sub item:
6510 -.INDENT 0.0
6511 +.RS 0
6512 .IP \(bu 2
6514 -\fBexpr.member\fP is roughly equivalent to \fBexpr % \(aq{member}\(aq\fP if \fBexpr\fP
6515 +\fBexpr.member\fP is roughly equivalent to \fBexpr % '{member}'\fP if \fBexpr\fP
6516 returns a non\-list/dict. The returned value is not stringified.
6517 .IP \(bu 2
6519 -\fBdict.key\fP is identical to \fBget(dict, \(aqkey\(aq)\fP.
6520 -.UNINDENT
6521 +\fBdict.key\fP is identical to \fBget(dict, 'key')\fP.
6522 +.RE
6523 .SS Aliases
6525 New keywords and functions can be defined in the \fBtemplatealias\fP section of
6526 @@ -9018,9 +8991,9 @@
6527 a Mercurial configuration file:
6530 -.ft C
6531 +.ft
6532 <alias> = <definition>
6533 -.ft P
6534 +.ft
6537 Arguments of the form \fIa1\fP, \fIa2\fP, etc. are substituted from the alias into
6538 @@ -9029,35 +9002,35 @@
6539 For example,
6542 -.ft C
6543 +.ft
6544 [templatealias]
6545 r = rev
6546 rn = "{r}:{node|short}"
6547 -leftpad(s, w) = pad(s, w, \(aq \(aq, True)
6548 -.ft P
6549 +leftpad(s, w) = pad(s, w, ' ', True)
6550 +.ft
6553 defines two symbol aliases, \fBr\fP and \fBrn\fP, and a function alias
6554 \fBleftpad()\fP.
6556 -It\(aqs also possible to specify complete template strings, using the
6557 +It's also possible to specify complete template strings, using the
6558 \fBtemplates\fP section. The syntax used is the general template string syntax.
6560 For example,
6563 -.ft C
6564 +.ft
6565 [templates]
6566 nodedate = "{node|short}: {date(date, "%Y\-%m\-%d")}\en"
6567 -.ft P
6568 +.ft
6571 defines a template, \fBnodedate\fP, which can be called like:
6574 -.ft C
6575 +.ft
6576 $ hg log \-r . \-Tnodedate
6577 -.ft P
6578 +.ft
6581 A template defined in \fBtemplates\fP section can also be referenced from
6582 @@ -9064,9 +9037,9 @@
6583 another template:
6586 -.ft C
6587 +.ft
6588 $ hg log \-r . \-T "{rev} {nodedate}"
6589 -.ft P
6590 +.ft
6593 but be aware that the keywords cannot be overridden by templates. For example,
6594 @@ -9076,26 +9049,26 @@
6595 are inserted before/after/between items:
6598 -.ft C
6599 +.ft
6600 [templates]
6601 -myjson = \(aq {dict(rev, node|short)|json}\(aq
6602 -myjson:docheader = \(aq\e{\en\(aq
6603 -myjson:docfooter = \(aq\en}\en\(aq
6604 -myjson:separator = \(aq,\en\(aq
6605 -.ft P
6606 +myjson = ' {dict(rev, node|short)|json}'
6607 +myjson:docheader = '\e{\en'
6608 +myjson:docfooter = '\en}\en'
6609 +myjson:separator = ',\en'
6610 +.ft
6612 .SS Examples
6614 Some sample command line templates:
6615 -.INDENT 0.0
6616 +.RS 0
6617 .IP \(bu 2
6619 Format lists, e.g. files:
6622 -.ft C
6623 -$ hg log \-r 0 \-\-template "files:\en{files % \(aq {file}\en\(aq}"
6624 -.ft P
6625 +.ft
6626 +$ hg log \-r 0 \-\-template "files:\en{files % ' {file}\en'}"
6627 +.ft
6629 .IP \(bu 2
6631 @@ -9102,9 +9075,9 @@
6632 Join the list of files with a ", ":
6635 -.ft C
6636 -$ hg log \-r 0 \-\-template "files: {join(files, \(aq, \(aq)}\en"
6637 -.ft P
6638 +.ft
6639 +$ hg log \-r 0 \-\-template "files: {join(files, ', ')}\en"
6640 +.ft
6642 .IP \(bu 2
6644 @@ -9111,9 +9084,9 @@
6645 Join the list of files ending with ".py" with a ", ":
6648 -.ft C
6649 -$ hg log \-r 0 \-\-template "pythonfiles: {join(files(\(aq**.py\(aq), \(aq, \(aq)}\en"
6650 -.ft P
6651 +.ft
6652 +$ hg log \-r 0 \-\-template "pythonfiles: {join(files('**.py'), ', ')}\en"
6653 +.ft
6655 .IP \(bu 2
6657 @@ -9120,9 +9093,9 @@
6658 Separate non\-empty arguments by a " ":
6661 -.ft C
6662 -$ hg log \-r 0 \-\-template "{separate(\(aq \(aq, node, bookmarks, tags}\en"
6663 -.ft P
6664 +.ft
6665 +$ hg log \-r 0 \-\-template "{separate(' ', node, bookmarks, tags}\en"
6666 +.ft
6668 .IP \(bu 2
6670 @@ -9129,9 +9102,9 @@
6671 Modify each line of a commit description:
6674 -.ft C
6675 -$ hg log \-\-template "{splitlines(desc) % \(aq**** {line}\en\(aq}"
6676 -.ft P
6677 +.ft
6678 +$ hg log \-\-template "{splitlines(desc) % '**** {line}\en'}"
6679 +.ft
6681 .IP \(bu 2
6683 @@ -9138,9 +9111,9 @@
6684 Format date:
6687 -.ft C
6688 -$ hg log \-r 0 \-\-template "{date(date, \(aq%Y\(aq)}\en"
6689 -.ft P
6690 +.ft
6691 +$ hg log \-r 0 \-\-template "{date(date, '%Y')}\en"
6692 +.ft
6694 .IP \(bu 2
6696 @@ -9147,9 +9120,9 @@
6697 Display date in UTC:
6700 -.ft C
6701 -$ hg log \-r 0 \-\-template "{localdate(date, \(aqUTC\(aq)|date}\en"
6702 -.ft P
6703 +.ft
6704 +$ hg log \-r 0 \-\-template "{localdate(date, 'UTC')|date}\en"
6705 +.ft
6707 .IP \(bu 2
6709 @@ -9156,9 +9129,9 @@
6710 Output the description set to a fill\-width of 30:
6713 -.ft C
6714 +.ft
6715 $ hg log \-r 0 \-\-template "{fill(desc, 30)}"
6716 -.ft P
6717 +.ft
6719 .IP \(bu 2
6721 @@ -9165,10 +9138,10 @@
6722 Use a conditional to test for the default branch:
6725 -.ft C
6726 -$ hg log \-r 0 \-\-template "{ifeq(branch, \(aqdefault\(aq, \(aqon the main branch\(aq,
6727 -\(aqon branch {branch}\(aq)}\en"
6728 -.ft P
6729 +.ft
6730 +$ hg log \-r 0 \-\-template "{ifeq(branch, 'default', 'on the main branch',
6731 +\&'on branch {branch}')}\en"
6732 +.ft
6734 .IP \(bu 2
6736 @@ -9175,9 +9148,9 @@
6737 Append a newline if not empty:
6740 -.ft C
6741 -$ hg tip \-\-template "{if(author, \(aq{author}\en\(aq)}"
6742 -.ft P
6743 +.ft
6744 +$ hg tip \-\-template "{if(author, '{author}\en')}"
6745 +.ft
6747 .IP \(bu 2
6749 @@ -9184,9 +9157,9 @@
6750 Label the output for use with the color extension:
6753 -.ft C
6754 -$ hg log \-r 0 \-\-template "{label(\(aqchangeset.{phase}\(aq, node|short)}\en"
6755 -.ft P
6756 +.ft
6757 +$ hg log \-r 0 \-\-template "{label('changeset.{phase}', node|short)}\en"
6758 +.ft
6760 .IP \(bu 2
6762 @@ -9193,27 +9166,27 @@
6763 Invert the firstline filter, i.e. everything but the first line:
6766 -.ft C
6767 -$ hg log \-r 0 \-\-template "{sub(r\(aq^.*\en?\en?\(aq, \(aq\(aq, desc)}\en"
6768 -.ft P
6769 +.ft
6770 +$ hg log \-r 0 \-\-template "{sub(r'^.*\en?\en?', '', desc)}\en"
6771 +.ft
6773 .IP \(bu 2
6775 -Display the contents of the \(aqextra\(aq field, one per line:
6776 +Display the contents of the 'extra' field, one per line:
6779 -.ft C
6780 -$ hg log \-r 0 \-\-template "{join(extras, \(aq\en\(aq)}\en"
6781 -.ft P
6782 +.ft
6783 +$ hg log \-r 0 \-\-template "{join(extras, '\en')}\en"
6784 +.ft
6786 .IP \(bu 2
6788 -Mark the active bookmark with \(aq*\(aq:
6789 +Mark the active bookmark with '*':
6792 -.ft C
6793 -$ hg log \-\-template "{bookmarks % \(aq{bookmark}{ifeq(bookmark, active, \(aq*\(aq)} \(aq}\en"
6794 -.ft P
6795 +.ft
6796 +$ hg log \-\-template "{bookmarks % '{bookmark}{ifeq(bookmark, active, '*')} '}\en"
6797 +.ft
6799 .IP \(bu 2
6801 @@ -9220,18 +9193,18 @@
6802 Find the previous release candidate tag, the distance and changes since the tag:
6805 -.ft C
6806 -$ hg log \-r . \-\-template "{latesttag(\(aqre:^.*\-rc$\(aq) % \(aq{tag}, {changes}, {distance}\(aq}\en"
6807 -.ft P
6808 +.ft
6809 +$ hg log \-r . \-\-template "{latesttag('re:^.*\-rc$') % '{tag}, {changes}, {distance}'}\en"
6810 +.ft
6812 .IP \(bu 2
6814 -Mark the working copy parent with \(aq@\(aq:
6815 +Mark the working copy parent with '@':
6818 -.ft C
6819 -$ hg log \-\-template "{ifcontains(rev, revset(\(aq.\(aq), \(aq@\(aq)}\en"
6820 -.ft P
6821 +.ft
6822 +$ hg log \-\-template "{ifcontains(rev, revset('.'), '@')}\en"
6823 +.ft
6825 .IP \(bu 2
6827 @@ -9238,9 +9211,9 @@
6828 Show details of parent revisions:
6831 -.ft C
6832 -$ hg log \-\-template "{revset(\(aqparents(%d)\(aq, rev) % \(aq{desc|firstline}\en\(aq}"
6833 -.ft P
6834 +.ft
6835 +$ hg log \-\-template "{revset('parents(%d)', rev) % '{desc|firstline}\en'}"
6836 +.ft
6838 .IP \(bu 2
6840 @@ -9247,9 +9220,9 @@
6841 Show only commit descriptions that start with "template":
6844 -.ft C
6845 -$ hg log \-\-template "{startswith(\(aqtemplate\(aq, firstline(desc))}\en"
6846 -.ft P
6847 +.ft
6848 +$ hg log \-\-template "{startswith('template', firstline(desc))}\en"
6849 +.ft
6851 .IP \(bu 2
6853 @@ -9256,34 +9229,34 @@
6854 Print the first word of each line of a commit message:
6857 -.ft C
6858 +.ft
6859 $ hg log \-\-template "{word(0, desc)}\en"
6860 -.ft P
6861 +.ft
6863 -.UNINDENT
6864 +.RE
6865 .SH URL PATHS
6867 Valid URLs are of the form:
6870 -.ft C
6871 +.ft
6872 local/filesystem/path[#revision]
6873 file://local/filesystem/path[#revision]
6874 http://[user[:pass]@]host[:port]/[path][#revision]
6875 https://[user[:pass]@]host[:port]/[path][#revision]
6876 ssh://[user@]host[:port]/[path][#revision]
6877 -.ft P
6878 +.ft
6881 Paths in the local filesystem can either point to Mercurial
6882 -repositories or to bundle files (as created by \%\fBhg bundle\fP\: or
6883 -\%\fBhg incoming \-\-bundle\fP\:). See also \%\fBhg help paths\fP\:.
6884 +repositories or to bundle files (as created by \fBhg bundle\fP or
6885 +\fBhg incoming \-\-bundle\fP). See also \fBhg help paths\fP.
6887 An optional identifier after # indicates a particular branch, tag, or
6888 -changeset to use from the remote repository. See also \%\fBhg help
6889 -revisions\fP\:.
6890 +changeset to use from the remote repository. See also \fBhg help
6891 +revisions\fP.
6893 -Some features, such as pushing to \%http://\: and \%https://\: URLs are only
6894 +Some features, such as pushing to http:// and https:// URLs are only
6895 possible if the feature is explicitly enabled on the remote Mercurial
6896 server.
6898 @@ -9291,7 +9264,7 @@
6899 web.cacerts.
6901 Some notes about using SSH with Mercurial:
6902 -.INDENT 0.0
6903 +.RS 0
6904 .IP \(bu 2
6906 SSH requires an accessible shell account on the destination machine
6907 @@ -9298,63 +9271,63 @@
6908 and a copy of hg in the remote path or specified with as remotecmd.
6909 .IP \(bu 2
6911 -path is relative to the remote user\(aqs home directory by default. Use
6912 +path is relative to the remote user's home directory by default. Use
6913 an extra slash at the start of a path to specify an absolute path:
6916 -.ft C
6917 +.ft
6918 ssh://example.com//tmp/repository
6919 -.ft P
6920 +.ft
6922 .IP \(bu 2
6924 -Mercurial doesn\(aqt use its own compression via SSH; the right thing
6925 +Mercurial doesn't use its own compression via SSH; the right thing
6926 to do is to configure it in your ~/.ssh/config, e.g.:
6929 -.ft C
6930 +.ft
6931 Host *.mylocalnetwork.example.com
6932 Compression no
6933 Host *
6934 Compression yes
6935 -.ft P
6936 +.ft
6939 Alternatively specify "ssh \-C" as your ssh command in your
6940 configuration file or with the \-\-ssh command line option.
6941 -.UNINDENT
6942 +.RE
6944 These URLs can all be stored in your configuration file with path
6945 aliases under the [paths] section like so:
6948 -.ft C
6949 +.ft
6950 [paths]
6951 alias1 = URL1
6952 alias2 = URL2
6953 \&...
6954 -.ft P
6955 +.ft
6958 You can then use the alias for any command that uses a URL (for
6959 -example \%\fBhg pull alias1\fP\: will be treated as \%\fBhg pull URL1\fP\:).
6960 +example \fBhg pull alias1\fP will be treated as \fBhg pull URL1\fP).
6962 Two path aliases are special because they are used as defaults when
6963 you do not provide the URL to a command:
6964 -.INDENT 0.0
6965 +.RS 0
6967 .B default:
6969 When you create a repository with hg clone, the clone command saves
6970 -the location of the source repository as the new repository\(aqs
6971 -\(aqdefault\(aq path. This is then used when you omit path from push\- and
6972 +the location of the source repository as the new repository's
6973 +\&'default' path. This is then used when you omit path from push\- and
6974 pull\-like commands (including incoming and outgoing).
6976 .B default\-push:
6978 -The push command will look for a path named \(aqdefault\-push\(aq, and
6979 -prefer it over \(aqdefault\(aq if both are defined.
6980 -.UNINDENT
6981 +The push command will look for a path named 'default\-push', and
6982 +prefer it over 'default' if both are defined.
6983 +.RE
6984 .SH EXTENSIONS
6986 This section contains help for extensions that are distributed together with Mercurial. Help for other extensions is available in the help system.
6987 @@ -9378,7 +9351,7 @@
6988 distinguish them.
6990 The order in which access checks are performed is:
6991 -.INDENT 0.0
6992 +.RS 0
6993 .IP 1. 3
6995 Deny list for branches (section \fBacl.deny.branches\fP)
6996 @@ -9391,7 +9364,7 @@
6997 .IP 4. 3
6999 Allow list for paths (section \fBacl.allow\fP)
7000 -.UNINDENT
7001 +.RE
7003 The allow and deny sections take key\-value pairs.
7004 .SS Branch\-based Access Control
7005 @@ -9399,7 +9372,7 @@
7006 Use the \fBacl.deny.branches\fP and \fBacl.allow.branches\fP sections to
7007 have branch\-based access control. Keys in these sections can be
7008 either:
7009 -.INDENT 0.0
7010 +.RS 0
7011 .IP \(bu 2
7013 a branch name, or
7014 @@ -9406,10 +9379,10 @@
7015 .IP \(bu 2
7017 an asterisk, to match any branch;
7018 -.UNINDENT
7019 +.RE
7021 The corresponding values can be either:
7022 -.INDENT 0.0
7023 +.RS 0
7024 .IP \(bu 2
7026 a comma\-separated list containing users and groups, or
7027 @@ -9416,7 +9389,7 @@
7028 .IP \(bu 2
7030 an asterisk, to match anyone;
7031 -.UNINDENT
7032 +.RE
7034 You can add the "!" prefix to a user or group name to invert the sense
7035 of the match.
7036 @@ -9438,7 +9411,7 @@
7037 .SS Example Configuration
7040 -.ft C
7041 +.ft
7042 [hooks]
7044 # Use this if you want to check access restrictions at commit time
7045 @@ -9514,12 +9487,12 @@
7046 src/main/resources/** = *
7048 \&.hgtags = release_engineer
7049 -.ft P
7050 +.ft
7052 .SS Examples using the "!" prefix
7054 -Suppose there\(aqs a branch that only a given user (or group) should be able to
7055 -push to, and you don\(aqt want to restrict access to any other branch that may
7056 +Suppose there's a branch that only a given user (or group) should be able to
7057 +push to, and you don't want to restrict access to any other branch that may
7058 be created.
7060 The "!" prefix allows you to prevent anyone except a given user or group to
7061 @@ -9531,18 +9504,18 @@
7062 3) Deny access to a file to anyone but user "gollum"
7065 -.ft C
7066 +.ft
7067 [acl.allow.branches]
7068 # Empty
7070 [acl.deny.branches]
7072 -# 1) only \(aqgollum\(aq can commit to branch \(aqring\(aq;
7073 -# \(aqgollum\(aq and anyone else can still commit to any other branch.
7074 +# 1) only 'gollum' can commit to branch 'ring';
7075 +# 'gollum' and anyone else can still commit to any other branch.
7076 ring = !gollum
7078 -# 2) only members of the group \(aqhobbit\(aq can commit to branch \(aqlake\(aq;
7079 -# \(aqhobbit\(aq members and anyone else can still commit to any other branch.
7080 +# 2) only members of the group 'hobbit' can commit to branch 'lake';
7081 +# 'hobbit' members and anyone else can still commit to any other branch.
7082 lake = !@hobbit
7084 # You can also deny access based on file paths:
7085 @@ -9551,10 +9524,10 @@
7086 # Empty
7088 [acl.deny]
7089 -# 3) only \(aqgollum\(aq can change the file below;
7090 -# \(aqgollum\(aq and anyone else can still change any other file.
7091 +# 3) only 'gollum' can change the file below;
7092 +# 'gollum' and anyone else can still change any other file.
7093 /misty/mountains/cave/ring = !gollum
7094 -.ft P
7095 +.ft
7097 .SS amend
7099 @@ -9568,18 +9541,18 @@
7100 amend the working copy parent with all or specified outstanding changes:
7103 -.ft C
7104 +.ft
7105 hg amend [OPTION]... [FILE]...
7106 -.ft P
7107 +.ft
7110 -Similar to \%\fBhg commit \-\-amend\fP\:, but reuse the commit message without
7111 +Similar to \fBhg commit \-\-amend\fP, but reuse the commit message without
7112 invoking editor, unless \fB\-\-edit\fP was set.
7114 -See \%\fBhg help commit\fP\: for more details.
7115 +See \fBhg help commit\fP for more details.
7117 Options:
7118 -.INDENT 0.0
7119 +.RS 0
7121 .B \-A, \-\-addremove
7123 @@ -9620,7 +9593,7 @@
7124 .BI \-u, \-\-user \ <USER>
7126 record the specified user as committer
7127 -.UNINDENT
7128 +.RE
7130 [+] marked option can be specified multiple times
7131 .SS automv
7132 @@ -9643,7 +9616,7 @@
7133 Examples:
7136 -.ft C
7137 +.ft
7138 [blackbox]
7139 track = *
7140 # dirty is *EXPENSIVE* (slow);
7141 @@ -9663,7 +9636,7 @@
7142 maxsize = 1.5 MB
7143 # rotate up to N log files when the current one gets too big
7144 maxfiles = 3
7145 -.ft P
7146 +.ft
7148 .SS Commands
7149 .SS blackbox
7150 @@ -9671,20 +9644,20 @@
7151 view the recent repository events:
7154 -.ft C
7155 +.ft
7156 hg blackbox [OPTION]...
7157 -.ft P
7158 +.ft
7161 view the recent repository events
7163 Options:
7164 -.INDENT 0.0
7165 +.RS 0
7167 .BI \-l, \-\-limit \ <VALUE>
7169 the number of events to show (default: 10)
7170 -.UNINDENT
7171 +.RE
7172 .SS bugzilla
7174 hooks for integrating with the Bugzilla bug tracker
7175 @@ -9697,7 +9670,7 @@
7176 hours spent working on the bug. Bugs can also be marked fixed.
7178 Four basic modes of access to Bugzilla are provided:
7179 -.INDENT 0.0
7180 +.RS 0
7181 .IP 1. 3
7183 Access via the Bugzilla REST\-API. Requires bugzilla 5.0 or later.
7184 @@ -9712,7 +9685,7 @@
7186 Writing directly to the Bugzilla database. Only Bugzilla installations
7187 using MySQL are supported. Requires Python MySQLdb.
7188 -.UNINDENT
7189 +.RE
7191 Writing directly to the database is susceptible to schema changes, and
7192 relies on a Bugzilla contrib script to send out bug change
7193 @@ -9744,12 +9717,12 @@
7194 the given username or the user associated with the apikey in Bugzilla.
7196 Configuration items common to all access modes:
7197 -.INDENT 0.0
7198 +.RS 0
7200 .B bugzilla.version
7202 The access type to use. Values recognized are:
7203 -.INDENT 7.0
7204 +.RS 7
7206 .B \fBrestapi\fP
7208 @@ -9776,7 +9749,7 @@
7210 MySQL access, Bugzilla 2.16 and up to but not
7211 including 2.18.
7212 -.UNINDENT
7213 +.RE
7215 .B bugzilla.regexp
7217 @@ -9821,7 +9794,7 @@
7218 Template to use when formatting comments. Overrides style if
7219 specified. In addition to the usual Mercurial keywords, the
7220 extension specifies:
7221 -.INDENT 7.0
7222 +.RS 7
7224 .B \fB{bug}\fP
7226 @@ -9838,7 +9811,7 @@
7227 .B \fB{hgweb}\fP
7229 Base URL for browsing Mercurial repositories.
7230 -.UNINDENT
7231 +.RE
7233 Default \fBchangeset {node|short} in repo {root} refers to bug
7234 {bug}.\endetails:\en\et{desc|tabindent}\fP
7235 @@ -9855,10 +9828,10 @@
7237 Base URL for browsing Mercurial repositories. Referenced from
7238 templates as \fB{hgweb}\fP.
7239 -.UNINDENT
7240 +.RE
7242 Configuration items common to XMLRPC+email and MySQL access modes:
7243 -.INDENT 0.0
7244 +.RS 0
7246 .B bugzilla.usermap
7248 @@ -9867,13 +9840,13 @@
7249 line:
7252 -.ft C
7253 +.ft
7254 committer = Bugzilla user
7255 -.ft P
7256 +.ft
7259 See also the \fB[usermap]\fP section.
7260 -.UNINDENT
7261 +.RE
7263 The \fB[usermap]\fP section is used to specify mappings of Mercurial
7264 committer email to Bugzilla user email. See also \fBbugzilla.usermap\fP.
7265 @@ -9880,7 +9853,7 @@
7266 Contains entries of the form \fBcommitter = Bugzilla user\fP.
7268 XMLRPC and REST\-API access mode configuration:
7269 -.INDENT 0.0
7270 +.RS 0
7272 .B bugzilla.bzurl
7274 @@ -9895,10 +9868,10 @@
7275 .B bugzilla.password
7277 The password for Bugzilla login.
7278 -.UNINDENT
7279 +.RE
7281 REST\-API access mode uses the options listed above as well as:
7282 -.INDENT 0.0
7283 +.RS 0
7285 .B bugzilla.apikey
7287 @@ -9905,22 +9878,22 @@
7288 An apikey generated on the Bugzilla instance for api access.
7289 Using an apikey removes the need to store the user and password
7290 options.
7291 -.UNINDENT
7292 +.RE
7294 XMLRPC+email access mode uses the XMLRPC access mode configuration items,
7295 and also:
7296 -.INDENT 0.0
7297 +.RS 0
7299 .B bugzilla.bzemail
7301 The Bugzilla email address.
7302 -.UNINDENT
7303 +.RE
7305 In addition, the Mercurial email settings must be configured. See the
7306 documentation in hgrc(5), sections \fB[email]\fP and \fB[smtp]\fP.
7308 MySQL access mode configuration:
7309 -.INDENT 0.0
7310 +.RS 0
7312 .B bugzilla.host
7314 @@ -9960,12 +9933,12 @@
7315 id) and \fBuser\fP (committer bugzilla email). Default depends on
7316 version; from 2.18 it is "cd %(bzdir)s && perl \-T
7317 contrib/sendbugmail.pl %(id)s %(user)s".
7318 -.UNINDENT
7319 +.RE
7321 Activating the extension:
7324 -.ft C
7325 +.ft
7326 [extensions]
7327 bugzilla =
7329 @@ -9972,7 +9945,7 @@
7330 [hooks]
7331 # run bugzilla hook on every change pulled or pushed in here
7332 incoming.bugzilla = python:hgext.bugzilla.hook
7333 -.ft P
7334 +.ft
7337 Example configurations:
7338 @@ -9984,7 +9957,7 @@
7339 with a web interface at \fBhttp://my\-project.org/hg\fP.
7342 -.ft C
7343 +.ft
7344 [bugzilla]
7345 bzurl=http://my\-project.org/bugzilla
7346 user=bugmail@my\-project.org
7347 @@ -9997,7 +9970,7 @@
7349 [web]
7350 baseurl=http://my\-project.org/hg
7351 -.ft P
7352 +.ft
7355 XMLRPC+email example configuration. This uses the Bugzilla at
7356 @@ -10009,7 +9982,7 @@
7357 \fBbugzilla@my\-project.org\fP.
7360 -.ft C
7361 +.ft
7362 [bugzilla]
7363 bzurl=http://my\-project.org/bugzilla
7364 user=bugmail@my\-project.org
7365 @@ -10026,7 +9999,7 @@
7367 [usermap]
7368 user@emaildomain.com=user.name@bugzilladomain.com
7369 -.ft P
7370 +.ft
7373 MySQL example configuration. This has a local Bugzilla 3.2 installation
7374 @@ -10037,7 +10010,7 @@
7375 with a web interface at \fBhttp://my\-project.org/hg\fP.
7378 -.ft C
7379 +.ft
7380 [bugzilla]
7381 host=localhost
7382 password=XYZZY
7383 @@ -10054,18 +10027,18 @@
7385 [usermap]
7386 user@emaildomain.com=user.name@bugzilladomain.com
7387 -.ft P
7388 +.ft
7391 All the above add a comment to the Bugzilla bug record of the form:
7394 -.ft C
7395 +.ft
7396 Changeset 3b16791d6642 in repository\-name.
7397 http://my\-project.org/hg/repository\-name/rev/3b16791d6642
7399 Changeset commit comment. Bug 1234.
7400 -.ft P
7401 +.ft
7403 .SS censor
7405 @@ -10079,14 +10052,14 @@
7406 Typical uses for censor are due to security or legal requirements, including:
7409 -.ft C
7410 +.ft
7411 * Passwords, private keys, cryptographic material
7412 * Licensed data/code/libraries for which the license has expired
7413 * Personally Identifiable Information or other private data
7414 -.ft P
7415 +.ft
7418 -Censored nodes can interrupt mercurial\(aqs typical operation whenever the excised
7419 +Censored nodes can interrupt mercurial's typical operation whenever the excised
7420 data needs to be materialized. Some commands, like \fBhg cat\fP/\fBhg revert\fP,
7421 simply fail when asked to produce censored data. Others, like \fBhg verify\fP and
7422 \fBhg update\fP, must be capable of tolerating censored data to continue to
7423 @@ -10096,13 +10069,13 @@
7424 .SS censor
7427 -.ft C
7428 +.ft
7429 hg censor \-r REV [\-t TEXT] [FILE]
7430 -.ft P
7431 +.ft
7434 Options:
7435 -.INDENT 0.0
7436 +.RS 0
7438 .BI \-r, \-\-rev \ <REV>
7440 @@ -10111,13 +10084,13 @@
7441 .BI \-t, \-\-tombstone \ <TEXT>
7443 replacement tombstone data
7444 -.UNINDENT
7445 +.RE
7446 .SS children
7448 command to display child changesets (DEPRECATED)
7450 -This extension is deprecated. You should use \%\fBhg log \-r
7451 -"children(REV)"\fP\: instead.
7452 +This extension is deprecated. You should use \fBhg log \-r
7453 +"children(REV)"\fP instead.
7454 .SS Commands
7455 .SS children
7457 @@ -10124,30 +10097,30 @@
7458 show the children of the given or working directory revision:
7461 -.ft C
7462 +.ft
7463 hg children [\-r REV] [FILE]
7464 -.ft P
7465 +.ft
7468 -Print the children of the working directory\(aqs revisions. If a
7469 +Print the children of the working directory's revisions. If a
7470 revision is given via \-r/\-\-rev, the children of that revision will
7471 be printed. If a file argument is given, revision in which the
7472 file was last changed (after the working directory revision or the
7473 argument to \-\-rev if given) is printed.
7475 -Please use \%\fBhg log\fP\: instead:
7476 +Please use \fBhg log\fP instead:
7479 -.ft C
7480 +.ft
7481 hg children => hg log \-r "children(.)"
7482 hg children \-r REV => hg log \-r "children(REV)"
7483 -.ft P
7484 +.ft
7487 -See \%\fBhg help log\fP\: and \%\fBhg help revsets.children\fP\:.
7488 +See \fBhg help log\fP and \fBhg help revsets.children\fP.
7490 Options:
7491 -.INDENT 0.0
7492 +.RS 0
7494 .BI \-r, \-\-rev \ <REV>
7496 @@ -10160,7 +10133,7 @@
7497 .BI \-T, \-\-template \ <TEMPLATE>
7499 display with template
7500 -.UNINDENT
7501 +.RE
7502 .SS churn
7504 command to display statistics about repository history
7505 @@ -10170,9 +10143,9 @@
7506 histogram of changes to the repository:
7509 -.ft C
7510 +.ft
7511 hg churn [\-d DATE] [\-r REV] [\-\-aliases FILE] [FILE]
7512 -.ft P
7513 +.ft
7516 This command will display a histogram representing the number
7517 @@ -10188,7 +10161,7 @@
7518 Examples:
7521 -.ft C
7522 +.ft
7523 # display count of changed lines for every committer
7524 hg churn \-T "{author|email}"
7526 @@ -10200,7 +10173,7 @@
7528 # display count of lines changed in every year
7529 hg churn \-f "%Y" \-s
7530 -.ft P
7531 +.ft
7534 It is possible to map alternate email addresses to a main address
7535 @@ -10207,9 +10180,9 @@
7536 by providing a file using the following format:
7539 -.ft C
7540 +.ft
7541 <alias email> = <actual email>
7542 -.ft P
7543 +.ft
7546 Such a file may be specified with the \-\-aliases option, otherwise
7547 @@ -10217,7 +10190,7 @@
7548 Aliases will be split from the rightmost "=".
7550 Options:
7551 -.INDENT 0.0
7552 +.RS 0
7554 .BI \-r, \-\-rev \ <REV[+]>
7556 @@ -10262,7 +10235,7 @@
7557 .BI \-X, \-\-exclude \ <PATTERN[+]>
7559 exclude names matching the given patterns
7560 -.UNINDENT
7561 +.RE
7563 [+] marked option can be specified multiple times
7564 .SS clonebundles
7565 @@ -10275,7 +10248,7 @@
7566 resources on the server.
7568 Cloning can be a CPU and I/O intensive operation on servers. Traditionally,
7569 -the server, in response to a client\(aqs request to clone, dynamically generates
7570 +the server, in response to a client's request to clone, dynamically generates
7571 a bundle containing the entire repository content and sends it to the client.
7572 There is no caching on the server and the server will have to redundantly
7573 generate the same outgoing bundle in response to each clone request. For
7574 @@ -10283,8 +10256,8 @@
7575 clones can make scaling the server challenging and costly.
7577 This extension provides server operators the ability to offload potentially
7578 -expensive clone load to an external service. Here\(aqs how it works.
7579 -.INDENT 0.0
7580 +expensive clone load to an external service. Here's how it works.
7581 +.RS 0
7582 .IP 1. 3
7584 A server operator establishes a mechanism for making bundle files available
7585 @@ -10311,10 +10284,10 @@
7586 .IP 7. 3
7588 The client reconnects to the original server and performs the equivalent
7589 -of \%\fBhg pull\fP\: to retrieve all repository data not in the bundle. (The
7590 +of \fBhg pull\fP to retrieve all repository data not in the bundle. (The
7591 repository could have been updated between when the bundle was created
7592 and when the client started the clone.)
7593 -.UNINDENT
7594 +.RE
7596 Instead of the server generating full repository bundles for every clone
7597 request, it generates full bundles once and they are subsequently reused to
7598 @@ -10324,7 +10297,7 @@
7599 clones to less than 1% of original.
7601 To work, this extension requires the following of server operators:
7602 -.INDENT 0.0
7603 +.RS 0
7604 .IP \(bu 2
7606 Generating bundle files of repository content (typically periodically,
7607 @@ -10338,23 +10311,23 @@
7609 A process for keeping the bundles manifest in sync with available bundle
7610 files.
7611 -.UNINDENT
7612 +.RE
7614 -Strictly speaking, using a static file hosting server isn\(aqt required: a server
7615 +Strictly speaking, using a static file hosting server isn't required: a server
7616 operator could use a dynamic service for retrieving bundle data. However,
7617 static file hosting services are simple and scalable and should be sufficient
7618 for most needs.
7620 -Bundle files can be generated with the \%\fBhg bundle\fP\: command. Typically
7621 -\%\fBhg bundle \-\-all\fP\: is used to produce a bundle of the entire repository.
7622 +Bundle files can be generated with the \fBhg bundle\fP command. Typically
7623 +\fBhg bundle \-\-all\fP is used to produce a bundle of the entire repository.
7625 -\%\fBhg debugcreatestreamclonebundle\fP\: can be used to produce a special
7626 +\fBhg debugcreatestreamclonebundle\fP can be used to produce a special
7627 \fIstreaming clone bundle\fP. These are bundle files that are extremely efficient
7628 to produce and consume (read: fast). However, they are larger than
7629 traditional bundle formats and require that clients support the exact set
7630 of repository data store formats in use by the repository that created them.
7631 Typically, a newer server can serve data that is compatible with older clients.
7632 -However, \fIstreaming clone bundles\fP don\(aqt have this guarantee. \fBServer
7633 +However, \fIstreaming clone bundles\fP don't have this guarantee. \fBServer
7634 operators need to be aware that newer versions of Mercurial may produce
7635 streaming clone bundles incompatible with older Mercurial versions.\fP
7637 @@ -10366,12 +10339,12 @@
7638 The manifest file contains a newline (n) delimited list of entries.
7640 Each line in this file defines an available bundle. Lines have the format:
7641 -.INDENT 0.0
7642 -.INDENT 3.5
7643 +.RS 0
7644 +.RS 3
7646 <URL> [<key>=<value>[ <key>=<value>]]
7647 -.UNINDENT
7648 -.UNINDENT
7649 +.RE
7650 +.RE
7652 That is, a URL followed by an optional, space\-delimited list of key=value
7653 pairs describing additional properties of this bundle. Both keys and values
7654 @@ -10384,7 +10357,7 @@
7655 data center closest to them.
7657 The following reserved keys are currently defined:
7658 -.INDENT 0.0
7659 +.RS 0
7661 .B BUNDLESPEC
7663 @@ -10391,21 +10364,21 @@
7664 A "bundle specification" string that describes the type of the bundle.
7666 These are string values that are accepted by the "\-\-type" argument of
7667 -\%\fBhg bundle\fP\:.
7668 +\fBhg bundle\fP.
7670 The values are parsed in strict mode, which means they must be of the
7671 "<compression>\-<type>" form. See
7672 mercurial.exchange.parsebundlespec() for more details.
7674 -\%\fBhg debugbundle \-\-spec\fP\: can be used to print the bundle specification
7675 +\fBhg debugbundle \-\-spec\fP can be used to print the bundle specification
7676 string for a bundle file. The output of this command can be used verbatim
7677 for the value of \fBBUNDLESPEC\fP (it is already escaped).
7679 Clients will automatically filter out specifications that are unknown or
7680 -unsupported so they won\(aqt attempt to download something that likely won\(aqt
7681 +unsupported so they won't attempt to download something that likely won't
7682 apply.
7684 -The actual value doesn\(aqt impact client behavior beyond filtering:
7685 +The actual value doesn't impact client behavior beyond filtering:
7686 clients will still sniff the bundle type from the header of downloaded
7687 files.
7689 @@ -10427,10 +10400,10 @@
7690 with the clonebundles facility.
7692 Value should be "true".
7693 -.UNINDENT
7694 +.RE
7696 Manifests can contain multiple entries. Assuming metadata is defined, clients
7697 -will filter entries from the manifest that they don\(aqt support. The remaining
7698 +will filter entries from the manifest that they don't support. The remaining
7699 entries are optionally sorted by client preferences
7700 (\fBui.clonebundleprefers\fP config option). The client then attempts
7701 to fetch the bundle at the first URL in the remaining list.
7702 @@ -10440,7 +10413,7 @@
7703 for this is that if a server is using clone bundles, it is probably doing so
7704 because the feature is necessary to help it scale. In other words, there
7705 is an assumption that clone load will be offloaded to another service and
7706 -that the Mercurial server isn\(aqt responsible for serving this clone load.
7707 +that the Mercurial server isn't responsible for serving this clone load.
7708 If that other service experiences issues and clients start mass falling back to
7709 the original Mercurial server, the added clone load could overwhelm the server
7710 due to unexpected load and effectively take it offline. Not having clients
7711 @@ -10468,13 +10441,13 @@
7712 convert a foreign SCM repository to a Mercurial one.:
7715 -.ft C
7716 +.ft
7717 hg convert [OPTION]... SOURCE [DEST [REVMAP]]
7718 -.ft P
7719 +.ft
7722 Accepted source formats [identifiers]:
7723 -.INDENT 0.0
7724 +.RS 0
7725 .IP \(bu 2
7727 Mercurial [hg]
7728 @@ -10502,10 +10475,10 @@
7729 .IP \(bu 2
7731 Perforce [p4]
7732 -.UNINDENT
7733 +.RE
7735 Accepted destination formats [identifiers]:
7736 -.INDENT 0.0
7737 +.RS 0
7738 .IP \(bu 2
7740 Mercurial [hg]
7741 @@ -10512,7 +10485,7 @@
7742 .IP \(bu 2
7744 Subversion [svn] (history on branches is not preserved)
7745 -.UNINDENT
7746 +.RE
7748 If no revision is given, all revisions will be converted.
7749 Otherwise, convert will only import up to the named revision
7750 @@ -10520,12 +10493,12 @@
7752 If no destination directory name is specified, it defaults to the
7753 basename of the source with \fB\-hg\fP appended. If the destination
7754 -repository doesn\(aqt exist, it will be created.
7755 +repository doesn't exist, it will be created.
7757 By default, all sources except Mercurial will use \-\-branchsort.
7758 Mercurial uses \-\-sourcesort to preserve original revision numbers
7759 order. Sort modes have the following effects:
7760 -.INDENT 0.0
7761 +.RS 0
7763 .B \-\-branchsort
7765 @@ -10550,21 +10523,21 @@
7766 try to move closed revisions as close as possible
7767 to parent branches, only supported by Mercurial
7768 sources.
7769 -.UNINDENT
7770 +.RE
7772 -If \fBREVMAP\fP isn\(aqt given, it will be put in a default location
7773 +If \fBREVMAP\fP isn't given, it will be put in a default location
7774 (\fB<dest>/.hg/shamap\fP by default). The \fBREVMAP\fP is a simple
7775 text file that maps each source commit ID to the destination ID
7776 for that revision, like so:
7779 -.ft C
7780 +.ft
7781 <source ID> <destination ID>
7782 -.ft P
7783 +.ft
7786 -If the file doesn\(aqt exist, it\(aqs automatically created. It\(aqs
7787 -updated on each commit copied, so \%\fBhg convert\fP\: can be interrupted
7788 +If the file doesn't exist, it's automatically created. It's
7789 +updated on each commit copied, so \fBhg convert\fP can be interrupted
7790 and can be run repeatedly to copy new commits.
7792 The authormap is a simple text file that maps each source commit
7793 @@ -10573,9 +10546,9 @@
7794 author mapping and the line format is:
7797 -.ft C
7798 +.ft
7799 source author = destination author
7800 -.ft P
7801 +.ft
7804 Empty lines and lines starting with a \fB#\fP are ignored.
7805 @@ -10585,13 +10558,13 @@
7806 directives:
7809 -.ft C
7810 +.ft
7811 include path/to/file\-or\-dir
7813 exclude path/to/file\-or\-dir
7815 rename path/to/source path/to/destination
7816 -.ft P
7817 +.ft
7820 Comment lines start with \fB#\fP. A specified path matches if it
7821 @@ -10624,9 +10597,9 @@
7822 comma\-separated values:
7825 -.ft C
7826 +.ft
7827 key parent1, parent2
7828 -.ft P
7829 +.ft
7832 The key is the revision ID in the source
7833 @@ -10646,9 +10619,9 @@
7834 lines of the form:
7837 -.ft C
7838 +.ft
7839 original_branch_name new_branch_name
7840 -.ft P
7841 +.ft
7844 where "original_branch_name" is the name of the branch in the
7845 @@ -10660,7 +10633,7 @@
7847 The Mercurial source recognizes the following configuration
7848 options, which you can set on the command line with \fB\-\-config\fP:
7849 -.INDENT 0.0
7850 +.RS 0
7852 .B convert.hg.ignoreerrors
7854 @@ -10682,7 +10655,7 @@
7855 .B convert.hg.revs
7857 revset specifying the source revisions to convert.
7858 -.UNINDENT
7859 +.RE
7860 .SS CVS Source
7862 CVS source will use a sandbox (i.e. a checked\-out copy) from CVS
7863 @@ -10696,7 +10669,7 @@
7864 sandbox is ignored.
7866 The following options can be used with \fB\-\-config\fP:
7867 -.INDENT 0.0
7868 +.RS 0
7870 .B convert.cvsps.cache
7872 @@ -10715,7 +10688,7 @@
7874 Specify encoding name to be used for
7875 transcoding CVS log messages. Multiple encoding names can be
7876 -specified as a list (see \%\fBhg help config.Syntax\fP\:), but only
7877 +specified as a list (see \fBhg help config.Syntax\fP), but only
7878 the first acceptable encoding in the list is used per CVS log
7879 entries. This transcoding is executed before cvslog hook below.
7881 @@ -10755,7 +10728,7 @@
7882 the changesets are calculated from the CVS log. The
7883 function is passed a list with the changeset entries, and can
7884 modify the changesets in\-place, or add or delete them.
7885 -.UNINDENT
7886 +.RE
7888 An additional "debugcvsps" Mercurial command allows the builtin
7889 changeset merging code to be run without doing a conversion. Its
7890 @@ -10775,7 +10748,7 @@
7891 detection.
7893 The following options can be set with \fB\-\-config\fP:
7894 -.INDENT 0.0
7895 +.RS 0
7897 .B convert.svn.branches
7899 @@ -10797,28 +10770,28 @@
7900 use local time (as determined by the TZ
7901 environment variable) for changeset date/times. The default
7902 is False (use UTC).
7903 -.UNINDENT
7904 +.RE
7906 Source history can be retrieved starting at a specific revision,
7907 instead of being integrally converted. Only single branch
7908 conversions are supported.
7909 -.INDENT 0.0
7910 +.RS 0
7912 .B convert.svn.startrev
7914 specify start Subversion revision number.
7915 The default is 0.
7916 -.UNINDENT
7917 +.RE
7918 .SS Git Source
7920 The Git importer converts commits from all reachable branches (refs
7921 in refs/heads) and remotes (refs in refs/remotes) to Mercurial.
7922 Branches are converted to bookmarks with the same name, with the
7923 -leading \(aqrefs/heads\(aq stripped. Git submodules are converted to Git
7924 +leading 'refs/heads' stripped. Git submodules are converted to Git
7925 subrepos in Mercurial.
7927 The following options can be set with \fB\-\-config\fP:
7928 -.INDENT 0.0
7929 +.RS 0
7931 .B convert.git.similarity
7933 @@ -10826,7 +10799,7 @@
7934 commit must be to be imported as renames or copies, as a
7935 percentage between \fB0\fP (disabled) and \fB100\fP (files must be
7936 identical). For example, \fB90\fP means that a delete/add pair will
7937 -be imported as a rename if more than 90% of the file hasn\(aqt
7938 +be imported as a rename if more than 90% of the file hasn't
7939 changed. The default is \fB50\fP.
7941 .B convert.git.findcopiesharder
7942 @@ -10889,7 +10862,7 @@
7944 remote refs are converted as bookmarks with
7945 \fBconvert.git.remoteprefix\fP as a prefix followed by a /. The default
7946 -is \(aqremote\(aq.
7947 +is 'remote'.
7949 .B convert.git.saverev
7951 @@ -10900,7 +10873,7 @@
7953 does not convert root level .gitmodules files
7954 or files with 160000 mode indicating a submodule. Default is False.
7955 -.UNINDENT
7956 +.RE
7957 .SS Perforce Source
7959 The Perforce (P4) importer can be given a p4 depot path or a
7960 @@ -10911,7 +10884,7 @@
7961 target may be named \fB...\-hg\fP.
7963 The following options can be set with \fB\-\-config\fP:
7964 -.INDENT 0.0
7965 +.RS 0
7967 .B convert.p4.encoding
7969 @@ -10923,7 +10896,7 @@
7971 specify initial Perforce revision (a
7972 Perforce changelist number).
7973 -.UNINDENT
7974 +.RE
7975 .SS Mercurial Destination
7977 The Mercurial destination will recognize Mercurial subrepositories in the
7978 @@ -10935,7 +10908,7 @@
7979 An example showing how to convert a repository with subrepositories:
7982 -.ft C
7983 +.ft
7984 # so convert knows the type when it sees a non empty destination
7985 $ hg init converted
7987 @@ -10942,11 +10915,11 @@
7988 $ hg convert orig/sub1 converted/sub1
7989 $ hg convert orig/sub2 converted/sub2
7990 $ hg convert orig converted
7991 -.ft P
7992 +.ft
7995 The following options are supported:
7996 -.INDENT 0.0
7997 +.RS 0
7999 .B convert.hg.clonebranches
8001 @@ -10965,22 +10938,22 @@
8003 .B convert.hg.sourcename
8005 -records the given string as a \(aqconvert_source\(aq extra
8006 +records the given string as a 'convert_source' extra
8007 value on each commit made in the target repository. The default is None.
8008 -.UNINDENT
8009 +.RE
8010 .SS All Destinations
8012 All destination types accept the following options:
8013 -.INDENT 0.0
8014 +.RS 0
8016 .B convert.skiptags
8018 does not convert tags from the source repo to the target
8019 repo. The default is False.
8020 -.UNINDENT
8021 +.RE
8023 Options:
8024 -.INDENT 0.0
8025 +.RS 0
8027 .BI \-\-authors \ <FILE>
8029 @@ -11033,7 +11006,7 @@
8030 .B \-\-closesort
8032 try to reorder closed revisions
8033 -.UNINDENT
8034 +.RE
8036 [+] marked option can be specified multiple times
8037 .SS eol
8038 @@ -11047,7 +11020,7 @@
8040 The extension reads its configuration from a versioned \fB.hgeol\fP
8041 configuration file found in the root of the working directory. The
8042 -\fB.hgeol\fP file use the same syntax as all other Mercurial
8043 +\fB\&.hgeol\fP file use the same syntax as all other Mercurial
8044 configuration files. It uses two sections, \fB[patterns]\fP and
8045 \fB[repository]\fP.
8047 @@ -11060,9 +11033,9 @@
8048 Files with the declared format of \fBCRLF\fP or \fBLF\fP are always
8049 checked out and stored in the repository in that format and files
8050 declared to be binary (\fBBIN\fP) are left unchanged. Additionally,
8051 -\fBnative\fP is an alias for checking out in the platform\(aqs default line
8052 +\fBnative\fP is an alias for checking out in the platform's default line
8053 ending: \fBLF\fP on Unix (including Mac OS X) and \fBCRLF\fP on
8054 -Windows. Note that \fBBIN\fP (do nothing to line endings) is Mercurial\(aqs
8055 +Windows. Note that \fBBIN\fP (do nothing to line endings) is Mercurial's
8056 default behavior; it is only needed if you need to override a later,
8057 more general pattern.
8059 @@ -11079,7 +11052,7 @@
8060 Example versioned \fB.hgeol\fP file:
8063 -.ft C
8064 +.ft
8065 [patterns]
8066 **.py = native
8067 **.vcproj = CRLF
8068 @@ -11089,7 +11062,7 @@
8070 [repository]
8071 native = LF
8072 -.ft P
8073 +.ft
8075 .IP Note
8077 @@ -11101,12 +11074,12 @@
8078 normal Mercurial configuration files and the \fB.hgeol\fP file, with the
8079 latter overriding the former. You can use that section to control the
8080 overall behavior. There are three settings:
8081 -.INDENT 0.0
8082 +.RS 0
8083 .IP \(bu 2
8085 \fBeol.native\fP (default \fBos.linesep\fP) can be set to \fBLF\fP or
8086 \fBCRLF\fP to override the default interpretation of \fBnative\fP for
8087 -checkout. This can be used with \%\fBhg archive\fP\: on Unix, say, to
8088 +checkout. This can be used with \fBhg archive\fP on Unix, say, to
8089 generate an archive where files have line endings for Windows.
8090 .IP \(bu 2
8092 @@ -11120,7 +11093,7 @@
8093 \fBeol.fix\-trailing\-newline\fP (default False) can be set to True to
8094 ensure that converted files end with a EOL character (either \fB\en\fP
8095 or \fB\er\en\fP as per the configured patterns).
8096 -.UNINDENT
8097 +.RE
8099 The extension provides \fBcleverencode:\fP and \fBcleverdecode:\fP filters
8100 like the deprecated win32text extension does. This means that you can
8101 @@ -11136,7 +11109,7 @@
8102 \fBeol.checkallhook\fP hook. These hooks are best used as
8103 \fBpretxnchangegroup\fP hooks.
8105 -See \%\fBhg help patterns\fP\: for more information about the glob patterns
8106 +See \fBhg help patterns\fP for more information about the glob patterns
8107 used.
8108 .SS extdiff
8110 @@ -11149,12 +11122,12 @@
8111 files to compare.
8113 The extdiff extension also allows you to configure new diff commands, so
8114 -you do not need to type \%\fBhg extdiff \-p kdiff3\fP\: always.
8115 +you do not need to type \fBhg extdiff \-p kdiff3\fP always.
8118 -.ft C
8119 +.ft
8120 [extdiff]
8121 -# add new command that runs GNU diff(1) in \(aqcontext diff\(aq mode
8122 +# add new command that runs GNU diff(1) in 'context diff' mode
8123 cdiff = gdiff \-Nprc5
8124 ## or the old way:
8125 #cmd.cdiff = gdiff
8126 @@ -11170,20 +11143,20 @@
8127 # English user, be sure to put "let g:DirDiffDynamicDiffText = 1" in
8128 # your .vimrc
8129 vimdiff = gvim \-f "+next" \e
8130 - "+execute \(aqDirDiff\(aq fnameescape(argv(0)) fnameescape(argv(1))"
8131 -.ft P
8132 + "+execute 'DirDiff' fnameescape(argv(0)) fnameescape(argv(1))"
8133 +.ft
8136 Tool arguments can include variables that are expanded at runtime:
8139 -.ft C
8140 +.ft
8141 $parent1, $plabel1 \- filename, descriptive label of first parent
8142 $child, $clabel \- filename, descriptive label of child revision
8143 $parent2, $plabel2 \- filename, descriptive label of second parent
8144 $root \- repository root
8145 $parent is an alias for $parent1.
8146 -.ft P
8147 +.ft
8150 The extdiff extension will look in your [diff\-tools] and [merge\-tools]
8151 @@ -11190,17 +11163,17 @@
8152 sections for diff tool arguments, when none are specified in [extdiff].
8155 -.ft C
8156 +.ft
8157 [extdiff]
8158 kdiff3 =
8160 [diff\-tools]
8161 -kdiff3.diffargs=\-\-L1 \(aq$plabel1\(aq \-\-L2 \(aq$clabel\(aq $parent $child
8162 -.ft P
8163 +kdiff3.diffargs=\-\-L1 '$plabel1' \-\-L2 '$clabel' $parent $child
8164 +.ft
8167 You can use \-I/\-X and list of file or directory names like normal
8168 -\%\fBhg diff\fP\: command. The extdiff extension makes snapshots of only
8169 +\fBhg diff\fP command. The extdiff extension makes snapshots of only
8170 needed files, so running the external diff program will actually be
8171 pretty fast (at least faster than having to compare the entire tree).
8172 .SS Commands
8173 @@ -11209,9 +11182,9 @@
8174 use external program to diff repository (or selected files):
8177 -.ft C
8178 +.ft
8179 hg extdiff [OPT]... [FILE]...
8180 -.ft P
8181 +.ft
8184 Show differences between revisions for the specified files, using
8185 @@ -11230,7 +11203,7 @@
8186 to its parent.
8188 Options:
8189 -.INDENT 0.0
8190 +.RS 0
8192 .BI \-p, \-\-program \ <CMD>
8194 @@ -11263,7 +11236,7 @@
8195 .B \-S, \-\-subrepos
8197 recurse into subrepositories
8198 -.UNINDENT
8199 +.RE
8201 [+] marked option can be specified multiple times
8202 .SS factotum
8203 @@ -11279,9 +11252,9 @@
8204 By default, keys are specified as:
8207 -.ft C
8208 +.ft
8209 proto=pass service=hg prefix=<prefix> user=<username> !password=<password>
8210 -.ft P
8211 +.ft
8214 If the factotum extension is unable to read the required key, one will be
8215 @@ -11291,12 +11264,12 @@
8216 default, these entries are:
8219 -.ft C
8220 +.ft
8221 [factotum]
8222 executable = /bin/auth/factotum
8223 mountpoint = /mnt/factotum
8224 service = hg
8225 -.ft P
8226 +.ft
8229 The executable entry defines the full path to the factotum binary. The
8230 @@ -11311,9 +11284,9 @@
8231 pull changes from a remote repository, merge new changes if needed.:
8234 -.ft C
8235 +.ft
8236 hg fetch [SOURCE]
8237 -.ft P
8238 +.ft
8241 This finds all changes from the repository at the specified path
8242 @@ -11328,12 +11301,12 @@
8243 the newly pulled changes. Local changes are then merged into the
8244 pulled changes. To switch the merge order, use \-\-switch\-parent.
8246 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date.
8247 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date.
8249 Returns 0 on success.
8251 Options:
8252 -.INDENT 0.0
8253 +.RS 0
8255 .BI \-r, \-\-rev \ <REV[+]>
8257 @@ -11378,7 +11351,7 @@
8258 .B \-\-insecure
8260 do not verify server certificate (ignoring web.cacerts config)
8261 -.UNINDENT
8262 +.RE
8264 [+] marked option can be specified multiple times
8265 .SS fsmonitor
8266 @@ -11393,8 +11366,8 @@
8267 system, with fsmonitor it takes about 0.3 seconds.
8269 fsmonitor requires no configuration \-\- it will tell Watchman about your
8270 -repository as necessary. You\(aqll need to install Watchman from
8271 -\%https://facebook.github.io/watchman/\: and make sure it is in your PATH.
8272 +repository as necessary. You'll need to install Watchman from
8273 +https://facebook.github.io/watchman/ and make sure it is in your PATH.
8275 fsmonitor is incompatible with the largefiles and eol extensions, and
8276 will disable itself if any of those are active.
8277 @@ -11402,10 +11375,10 @@
8278 The following configuration options exist:
8281 -.ft C
8282 +.ft
8283 [fsmonitor]
8284 mode = {off, on, paranoid}
8285 -.ft P
8286 +.ft
8289 When \fImode = off\fP, fsmonitor will disable itself (similar to not loading the
8290 @@ -11414,10 +11387,10 @@
8291 and ensure that the results are consistent.
8294 -.ft C
8295 +.ft
8296 [fsmonitor]
8297 timeout = (float)
8298 -.ft P
8299 +.ft
8302 A value, in seconds, that determines how long fsmonitor will wait for Watchman
8303 @@ -11424,19 +11397,19 @@
8304 to return results. Defaults to \fI2.0\fP.
8307 -.ft C
8308 +.ft
8309 [fsmonitor]
8310 blacklistusers = (list of userids)
8311 -.ft P
8312 +.ft
8315 A list of usernames for which fsmonitor will disable itself altogether.
8318 -.ft C
8319 +.ft
8320 [fsmonitor]
8321 walk_on_invalidate = (boolean)
8322 -.ft P
8323 +.ft
8326 Whether or not to walk the whole repo ourselves when our cached state has been
8327 @@ -11448,23 +11421,23 @@
8328 from Watchman. Defaults to false.
8331 -.ft C
8332 +.ft
8333 [fsmonitor]
8334 warn_when_unused = (boolean)
8335 -.ft P
8336 +.ft
8339 Whether to print a warning during certain operations when fsmonitor would be
8340 -beneficial to performance but isn\(aqt enabled.
8341 +beneficial to performance but isn't enabled.
8344 -.ft C
8345 +.ft
8346 [fsmonitor]
8347 warn_update_file_count = (integer)
8348 -.ft P
8349 +.ft
8352 -If \fBwarn_when_unused\fP is set and fsmonitor isn\(aqt enabled, a warning will
8353 +If \fBwarn_when_unused\fP is set and fsmonitor isn't enabled, a warning will
8354 be printed during working directory updates if this many files will be
8355 created.
8356 .SS gpg
8357 @@ -11476,9 +11449,9 @@
8358 verify all the signatures there may be for a particular revision:
8361 -.ft C
8362 +.ft
8363 hg sigcheck REV
8364 -.ft P
8365 +.ft
8368 verify all the signatures there may be for a particular revision
8369 @@ -11487,9 +11460,9 @@
8370 add a signature for the current or given revision:
8373 -.ft C
8374 +.ft
8375 hg sign [OPTION]... [REV]...
8376 -.ft P
8377 +.ft
8380 If no revision is given, the parent of the working directory is used,
8381 @@ -11498,10 +11471,10 @@
8382 The \fBgpg.cmd\fP config setting can be used to specify the command
8383 to run. A default key can be specified with \fBgpg.key\fP.
8385 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date.
8386 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date.
8388 Options:
8389 -.INDENT 0.0
8390 +.RS 0
8392 .B \-l, \-\-local
8394 @@ -11534,15 +11507,15 @@
8395 .BI \-u, \-\-user \ <USER>
8397 record the specified user as committer
8398 -.UNINDENT
8399 +.RE
8400 .SS sigs
8402 list signed changesets:
8405 -.ft C
8406 +.ft
8407 hg sigs
8408 -.ft P
8409 +.ft
8412 list signed changesets
8413 @@ -11551,7 +11524,7 @@
8414 command to view revision graphs from a shell (DEPRECATED)
8416 The functionality of this extension has been include in core Mercurial
8417 -since version 2.3. Please use \%\fBhg log \-G ...\fP\: instead.
8418 +since version 2.3. Please use \fBhg log \-G ...\fP instead.
8420 This extension adds a \-\-graph option to the incoming, outgoing and log
8421 commands. When this options is given, an ASCII representation of the
8422 @@ -11562,9 +11535,9 @@
8423 show revision history alongside an ASCII revision graph:
8426 -.ft C
8427 +.ft
8428 hg glog [OPTION]... [FILE]
8429 -.ft P
8430 +.ft
8433 Print a revision history alongside a revision graph drawn with
8434 @@ -11573,10 +11546,10 @@
8435 Nodes printed as an @ character are parents of the working
8436 directory.
8438 -This is an alias to \%\fBhg log \-G\fP\:.
8439 +This is an alias to \fBhg log \-G\fP.
8441 Options:
8442 -.INDENT 0.0
8443 +.RS 0
8445 .B \-f, \-\-follow
8447 @@ -11665,7 +11638,7 @@
8448 .BI \-X, \-\-exclude \ <PATTERN[+]>
8450 exclude names matching the given patterns
8451 -.UNINDENT
8452 +.RE
8454 [+] marked option can be specified multiple times
8455 .SS hgk
8456 @@ -11678,19 +11651,18 @@
8458 hgk consists of two parts: a Tcl script that does the displaying and
8459 querying of information, and an extension to Mercurial named hgk.py,
8460 -which provides hooks for hgk to get information. hgk can be found in
8461 -the contrib directory, and the extension is shipped in the hgext
8462 -repository, and needs to be enabled.
8463 +which provides hooks for hgk to get information.
8465 -The \%\fBhg view\fP\: command will launch the hgk Tcl script. For this command
8466 -to work, hgk must be in your search path. Alternately, you can specify
8467 -the path to hgk in your configuration file:
8468 +The \fBhg view\fP command will launch the hgk Tcl script. The script is
8469 +shipped in /usr/demo/mercurial, and hgk needs no configuration to find
8470 +it. You can specify the path to an alternate hgk in your configuration
8471 +file:
8474 -.ft C
8475 +.ft
8476 [hgk]
8477 path = /location/of/hgk
8478 -.ft P
8479 +.ft
8482 hgk can make use of the extdiff extension to visualize revisions.
8483 @@ -11697,10 +11669,10 @@
8484 Assuming you had already configured extdiff vdiff command, just add:
8487 -.ft C
8488 +.ft
8489 [hgk]
8490 vdiff=vdiff
8491 -.ft P
8492 +.ft
8495 Revisions context menu will now display additional entries to fire
8496 @@ -11711,36 +11683,36 @@
8497 start interactive history viewer:
8500 -.ft C
8501 +.ft
8502 hg view [\-l LIMIT] [REVRANGE]
8503 -.ft P
8504 +.ft
8507 start interactive history viewer
8509 Options:
8510 -.INDENT 0.0
8511 +.RS 0
8513 .BI \-l, \-\-limit \ <NUM>
8515 limit number of changes displayed
8516 -.UNINDENT
8517 +.RE
8518 .SS highlight
8520 syntax highlighting for hgweb (requires Pygments)
8522 It depends on the Pygments syntax highlighting library:
8523 -\%http://pygments.org/\:
8524 +http://pygments.org/
8526 There are the following configuration options:
8529 -.ft C
8530 +.ft
8531 [web]
8532 pygments_style = <style> (default: colorful)
8533 -highlightfiles = <fileset> (default: size(\(aq<5M\(aq))
8534 +highlightfiles = <fileset> (default: size('<5M'))
8535 highlightonlymatchfilename = <bool> (default False)
8536 -.ft P
8537 +.ft
8540 \fBhighlightonlymatchfilename\fP will only highlight files if their type could
8541 @@ -11755,7 +11727,7 @@
8542 is as follows, assuming the following history:
8545 -.ft C
8546 +.ft
8547 @ 3[tip] 7c2fd3b9020c 2009\-04\-27 18:04 \-0500 durin42
8548 | Add delta
8550 @@ -11767,7 +11739,7 @@
8552 o 0 d8d2fcd0e319 2009\-04\-27 18:04 \-0500 durin42
8553 Add alpha
8554 -.ft P
8555 +.ft
8558 If you were to run \fBhg histedit c561b4e977df\fP, you would see the following
8559 @@ -11774,7 +11746,7 @@
8560 file open in your editor:
8563 -.ft C
8564 +.ft
8565 pick c561b4e977df Add beta
8566 pick 030b686bedc4 Add gamma
8567 pick 7c2fd3b9020c Add delta
8568 @@ -11787,12 +11759,12 @@
8569 # p, pick = use commit
8570 # e, edit = use commit, but stop for amending
8571 # f, fold = use commit, but combine it with the one above
8572 -# r, roll = like fold, but discard this commit\(aqs description and date
8573 +# r, roll = like fold, but discard this commit's description and date
8574 # d, drop = remove commit from history
8575 # m, mess = edit commit message without changing commit content
8576 # b, base = checkout changeset and apply further changesets from there
8578 -.ft P
8579 +.ft
8582 In this file, lines beginning with \fB#\fP are ignored. You must specify a rule
8583 @@ -11801,7 +11773,7 @@
8584 would reorganize the file to look like this:
8587 -.ft C
8588 +.ft
8589 pick 030b686bedc4 Add gamma
8590 pick c561b4e977df Add beta
8591 fold 7c2fd3b9020c Add delta
8592 @@ -11814,12 +11786,12 @@
8593 # p, pick = use commit
8594 # e, edit = use commit, but stop for amending
8595 # f, fold = use commit, but combine it with the one above
8596 -# r, roll = like fold, but discard this commit\(aqs description and date
8597 +# r, roll = like fold, but discard this commit's description and date
8598 # d, drop = remove commit from history
8599 # m, mess = edit commit message without changing commit content
8600 # b, base = checkout changeset and apply further changesets from there
8602 -.ft P
8603 +.ft
8606 At which point you close the editor and \fBhistedit\fP starts working. When you
8607 @@ -11827,21 +11799,21 @@
8608 those revisions together, offering you a chance to clean up the commit message:
8611 -.ft C
8612 +.ft
8613 Add beta
8615 Add delta
8616 -.ft P
8617 +.ft
8620 Edit the commit message to your liking, then close the editor. The date used
8621 -for the commit will be the later of the two commits\(aq dates. For this example,
8622 -let\(aqs assume that the commit message was changed to \fBAdd beta and delta.\fP
8623 +for the commit will be the later of the two commits' dates. For this example,
8624 +let's assume that the commit message was changed to \fBAdd beta and delta.\fP
8625 After histedit has run and had a chance to remove any old or temporary
8626 revisions it needed, the history looks like this:
8629 -.ft C
8630 +.ft
8631 @ 2[tip] 989b4d060121 2009\-04\-27 18:04 \-0500 durin42
8632 | Add beta and delta.
8634 @@ -11850,12 +11822,12 @@
8636 o 0 d8d2fcd0e319 2009\-04\-27 18:04 \-0500 durin42
8637 Add alpha
8638 -.ft P
8639 +.ft
8642 Note that \fBhistedit\fP does \fInot\fP remove any revisions (even its own temporary
8643 ones) until after it has completed all the editing operations, so it will
8644 -probably perform several strip operations when it\(aqs done. For the above example,
8645 +probably perform several strip operations when it's done. For the above example,
8646 it had to run strip twice. Strip can be slow depending on a variety of factors,
8647 so you might need to be a little patient. You can choose to keep the original
8648 revisions by passing the \fB\-\-keep\fP flag.
8649 @@ -11862,21 +11834,21 @@
8651 The \fBedit\fP operation will drop you back to a command prompt,
8652 allowing you to edit files freely, or even use \fBhg record\fP to commit
8653 -some changes as a separate commit. When you\(aqre done, any remaining
8654 +some changes as a separate commit. When you're done, any remaining
8655 uncommitted changes will be committed as well. When done, run \fBhg
8656 histedit \-\-continue\fP to finish this step. If there are uncommitted
8657 -changes, you\(aqll be prompted for a new commit message, but the default
8658 +changes, you'll be prompted for a new commit message, but the default
8659 commit message will be the original message for the \fBedit\fP ed
8660 revision, and the date of the original commit will be preserved.
8662 The \fBmessage\fP operation will give you a chance to revise a commit
8663 -message without changing the contents. It\(aqs a shortcut for doing
8664 +message without changing the contents. It's a shortcut for doing
8665 \fBedit\fP immediately followed by \fIhg histedit \-\-continue\(ga\fP.
8667 If \fBhistedit\fP encounters a conflict when moving a revision (while
8668 -handling \fBpick\fP or \fBfold\fP), it\(aqll stop in a similar manner to
8669 -\fBedit\fP with the difference that it won\(aqt prompt you for a commit
8670 -message when done. If you decide at this point that you don\(aqt like how
8671 +handling \fBpick\fP or \fBfold\fP), it'll stop in a similar manner to
8672 +\fBedit\fP with the difference that it won't prompt you for a commit
8673 +message when done. If you decide at this point that you don't like how
8674 much work it will be to rearrange history, or that you made a mistake,
8675 you can use \fBhg histedit \-\-abort\fP to abandon the new changes you
8676 have made and return to the state before you attempted to edit your
8677 @@ -11886,7 +11858,7 @@
8678 changes, such that we have the following history:
8681 -.ft C
8682 +.ft
8683 @ 6[tip] 038383181893 2009\-04\-27 18:04 \-0500 stefan
8684 | Add theta
8686 @@ -11907,7 +11879,7 @@
8688 o 0 d8d2fcd0e319 2009\-04\-27 18:04 \-0500 durin42
8689 Add alpha
8690 -.ft P
8691 +.ft
8694 If you run \fBhg histedit \-\-outgoing\fP on the clone then it is the same
8695 @@ -11921,10 +11893,10 @@
8696 configuration file:
8699 -.ft C
8700 +.ft
8701 [histedit]
8702 linelen = 120 # truncate rule lines at 120 characters
8703 -.ft P
8704 +.ft
8707 \fBhg histedit\fP attempts to automatically choose an appropriate base
8708 @@ -11932,10 +11904,10 @@
8709 revset in your configuration file:
8712 -.ft C
8713 +.ft
8714 [histedit]
8715 defaultrev = only(.) & draft()
8716 -.ft P
8717 +.ft
8720 By default each edited revision needs to be present in histedit commands.
8721 @@ -11943,23 +11915,23 @@
8722 the drop to be implicit for missing commits by adding:
8725 -.ft C
8726 +.ft
8727 [histedit]
8728 dropmissing = True
8729 -.ft P
8730 +.ft
8733 By default, histedit will close the transaction after each action. For
8734 performance purposes, you can configure histedit to use a single transaction
8735 across the entire histedit. WARNING: This setting introduces a significant risk
8736 -of losing the work you\(aqve done in a histedit if the histedit aborts
8737 +of losing the work you've done in a histedit if the histedit aborts
8738 unexpectedly:
8741 -.ft C
8742 +.ft
8743 [histedit]
8744 singletransaction = True
8745 -.ft P
8746 +.ft
8748 .SS Commands
8749 .SS histedit
8750 @@ -11967,15 +11939,15 @@
8751 interactively edit changeset history:
8754 -.ft C
8755 +.ft
8756 hg histedit [OPTIONS] ([ANCESTOR] | \-\-outgoing [URL])
8757 -.ft P
8758 +.ft
8761 This command lets you edit a linear series of changesets (up to
8762 and including the working directory, which should be clean).
8763 You can:
8764 -.INDENT 0.0
8765 +.RS 0
8766 .IP \(bu 2
8768 \fIpick\fP to [re]order a changeset
8769 @@ -11990,7 +11962,7 @@
8770 \fIfold\fP to combine it with the preceding changeset (using the later date)
8771 .IP \(bu 2
8773 -\fIroll\fP like fold, but discarding this commit\(aqs description and date
8774 +\fIroll\fP like fold, but discarding this commit's description and date
8775 .IP \(bu 2
8777 \fIedit\fP to edit this changeset (preserving date)
8778 @@ -11997,10 +11969,10 @@
8779 .IP \(bu 2
8781 \fIbase\fP to checkout changeset and apply further changesets from there
8782 -.UNINDENT
8783 +.RE
8785 There are a number of ways to select the root changeset:
8786 -.INDENT 0.0
8787 +.RS 0
8788 .IP \(bu 2
8790 Specify ANCESTOR directly
8791 @@ -12007,7 +11979,7 @@
8792 .IP \(bu 2
8794 Use \-\-outgoing \-\- it will be the first linear changeset not
8795 -included in destination. (See \%\fBhg help config.paths.default\-push\fP\:)
8796 +included in destination. (See \fBhg help config.paths.default\-push\fP)
8797 .IP \(bu 2
8799 Otherwise, the value from the "histedit.defaultrev" config option
8800 @@ -12015,7 +11987,7 @@
8801 specified. The first revision returned by the revset is used. By
8802 default, this selects the editable history that is unique to the
8803 ancestry of the working directory.
8804 -.UNINDENT
8805 +.RE
8807 If you use \-\-outgoing, this command will abort if there are ambiguous
8808 outgoing revisions. For example, if there are multiple branches
8809 @@ -12023,13 +11995,13 @@
8811 Use "min(outgoing() and ::.)" or similar revset specification
8812 instead of \-\-outgoing to specify edit target revision exactly in
8813 -such ambiguous situation. See \%\fBhg help revsets\fP\: for detail about
8814 +such ambiguous situation. See \fBhg help revsets\fP for detail about
8815 selecting revisions.
8817 Examples:
8818 -.INDENT 0.0
8819 -.INDENT 3.5
8820 -.INDENT 0.0
8821 +.RS 0
8822 +.RS 3
8823 +.RS 0
8824 .IP \(bu 2
8826 A number of changes have been made.
8827 @@ -12038,9 +12010,9 @@
8828 Start history editing from revision 3:
8831 -.ft C
8832 +.ft
8833 hg histedit \-r 3
8834 -.ft P
8835 +.ft
8838 An editor opens, containing the list of revisions,
8839 @@ -12047,11 +12019,11 @@
8840 with specific actions specified:
8843 -.ft C
8844 +.ft
8845 pick 5339bf82f0ca 3 Zworgle the foobar
8846 pick 8ef592ce7cc4 4 Bedazzle the zerlog
8847 pick 0a9639fcda9d 5 Morgify the cromulancy
8848 -.ft P
8849 +.ft
8852 Additional information about the possible actions
8853 @@ -12059,14 +12031,14 @@
8855 To remove revision 3 from the history,
8856 its action (at the beginning of the relevant line)
8857 -is changed to \(aqdrop\(aq:
8858 +is changed to 'drop':
8861 -.ft C
8862 +.ft
8863 drop 5339bf82f0ca 3 Zworgle the foobar
8864 pick 8ef592ce7cc4 4 Bedazzle the zerlog
8865 pick 0a9639fcda9d 5 Morgify the cromulancy
8866 -.ft P
8867 +.ft
8869 .IP \(bu 2
8871 @@ -12076,9 +12048,9 @@
8872 Start history editing from revision 2:
8875 -.ft C
8876 +.ft
8877 hg histedit \-r 2
8878 -.ft P
8879 +.ft
8882 An editor opens, containing the list of revisions,
8883 @@ -12085,11 +12057,11 @@
8884 with specific actions specified:
8887 -.ft C
8888 +.ft
8889 pick 252a1af424ad 2 Blorb a morgwazzle
8890 pick 5339bf82f0ca 3 Zworgle the foobar
8891 pick 8ef592ce7cc4 4 Bedazzle the zerlog
8892 -.ft P
8893 +.ft
8896 To swap revision 2 and 4, its lines are swapped
8897 @@ -12096,15 +12068,15 @@
8898 in the editor:
8901 -.ft C
8902 +.ft
8903 pick 8ef592ce7cc4 4 Bedazzle the zerlog
8904 pick 5339bf82f0ca 3 Zworgle the foobar
8905 pick 252a1af424ad 2 Blorb a morgwazzle
8906 -.ft P
8907 +.ft
8909 -.UNINDENT
8910 -.UNINDENT
8911 -.UNINDENT
8912 +.RE
8913 +.RE
8914 +.RE
8916 Returns 0 on success, 1 if user intervention is required (not only
8917 for intentional "edit" command, but also for resolving unexpected
8918 @@ -12111,7 +12083,7 @@
8919 conflicts).
8921 Options:
8922 -.INDENT 0.0
8923 +.RS 0
8925 .BI \-\-commands \ <FILE>
8927 @@ -12127,7 +12099,7 @@
8929 .B \-k, \-\-keep
8931 -don\(aqt strip old nodes after edit is complete
8932 +don't strip old nodes after edit is complete
8934 .B \-\-abort
8936 @@ -12144,7 +12116,7 @@
8937 .BI \-r, \-\-rev \ <REV[+]>
8939 first revision to be edited
8940 -.UNINDENT
8941 +.RE
8943 [+] marked option can be specified multiple times
8944 .SS journal
8945 @@ -12159,9 +12131,9 @@
8946 show the previous position of bookmarks and the working copy:
8949 -.ft C
8950 +.ft
8951 hg journal [OPTION]... [BOOKMARKNAME]
8952 -.ft P
8953 +.ft
8956 The journal is used to see the previous commits that bookmarks and the
8957 @@ -12169,7 +12141,7 @@
8958 copy. Passing a bookmark name will show all the previous positions of
8959 that bookmark. Use the \-\-all switch to show previous locations for all
8960 bookmarks and the working copy; each line will then include the bookmark
8961 -name, or \(aq.\(aq for the working copy, as well.
8962 +name, or '.' for the working copy, as well.
8964 If \fIname\fP starts with \fIre:\fP, the remainder of the name is treated as
8965 a regular expression. To match a name that actually starts with \fIre:\fP,
8966 @@ -12186,7 +12158,7 @@
8967 \fIhg journal \-T json\fP can be used to produce machine readable output.
8969 Options:
8970 -.INDENT 0.0
8971 +.RS 0
8973 .B \-\-all
8975 @@ -12219,7 +12191,7 @@
8976 .BI \-T, \-\-template \ <TEMPLATE>
8978 display with template
8979 -.UNINDENT
8980 +.RE
8981 .SS keyword
8983 expand keywords in tracked files
8984 @@ -12240,7 +12212,7 @@
8985 Example:
8988 -.ft C
8989 +.ft
8990 [keyword]
8991 # expand keywords in every python file except those matching "x*"
8992 **.py =
8993 @@ -12249,7 +12221,7 @@
8994 [keywordset]
8995 # prefer svn\- over cvs\-like default keywordmaps
8996 svn = True
8997 -.ft P
8998 +.ft
9000 .IP Note
9002 @@ -12258,11 +12230,11 @@
9005 For [keywordmaps] template mapping and expansion demonstration and
9006 -control run \%\fBhg kwdemo\fP\:. See \%\fBhg help templates\fP\: for a list of
9007 +control run \fBhg kwdemo\fP. See \fBhg help templates\fP for a list of
9008 available templates and filters.
9010 Three additional date template filters are provided:
9011 -.INDENT 0.0
9012 +.RS 0
9014 .B \fButcdate\fP
9016 @@ -12275,20 +12247,20 @@
9017 .B \fBsvnisodate\fP
9019 "2006\-09\-18 08:13:13 \-700 (Mon, 18 Sep 2006)"
9020 -.UNINDENT
9021 +.RE
9023 -The default template mappings (view with \%\fBhg kwdemo \-d\fP\:) can be
9024 +The default template mappings (view with \fBhg kwdemo \-d\fP) can be
9025 replaced with customized keywords and templates. Again, run
9026 -\%\fBhg kwdemo\fP\: to control the results of your configuration changes.
9027 +\fBhg kwdemo\fP to control the results of your configuration changes.
9029 -Before changing/disabling active keywords, you must run \%\fBhg kwshrink\fP\:
9030 +Before changing/disabling active keywords, you must run \fBhg kwshrink\fP
9031 to avoid storing expanded keywords in the change history.
9033 To force expansion after enabling it, or a configuration change, run
9034 -\%\fBhg kwexpand\fP\:.
9035 +\fBhg kwexpand\fP.
9037 Expansions spanning more than one line and incremental expansions,
9038 -like CVS\(aq $Log$, are not supported. A keyword template map "Log =
9039 +like CVS' $Log$, are not supported. A keyword template map "Log =
9040 {desc}" expands to the first line of the changeset description.
9041 .SS Commands
9042 .SS kwdemo
9043 @@ -12296,9 +12268,9 @@
9044 print [keywordmaps] configuration and an expansion example:
9047 -.ft C
9048 +.ft
9049 hg kwdemo [\-d] [\-f RCFILE] [TEMPLATEMAP]...
9050 -.ft P
9051 +.ft
9054 Show current, custom, or default keyword template maps and their
9055 @@ -12309,10 +12281,10 @@
9057 Use \-d/\-\-default to disable current configuration.
9059 -See \%\fBhg help templates\fP\: for information on templates and filters.
9060 +See \fBhg help templates\fP for information on templates and filters.
9062 Options:
9063 -.INDENT 0.0
9064 +.RS 0
9066 .B \-d, \-\-default
9068 @@ -12321,15 +12293,15 @@
9069 .BI \-f, \-\-rcfile \ <FILE>
9071 read maps from rcfile
9072 -.UNINDENT
9073 +.RE
9074 .SS kwexpand
9076 expand keywords in the working directory:
9079 -.ft C
9080 +.ft
9081 hg kwexpand [OPTION]... [FILE]...
9082 -.ft P
9083 +.ft
9086 Run after (re)enabling keyword expansion.
9087 @@ -12337,7 +12309,7 @@
9088 kwexpand refuses to run if given files contain local changes.
9090 Options:
9091 -.INDENT 0.0
9092 +.RS 0
9094 .BI \-I, \-\-include \ <PATTERN[+]>
9096 @@ -12346,7 +12318,7 @@
9097 .BI \-X, \-\-exclude \ <PATTERN[+]>
9099 exclude names matching the given patterns
9100 -.UNINDENT
9101 +.RE
9103 [+] marked option can be specified multiple times
9104 .SS kwfiles
9105 @@ -12354,9 +12326,9 @@
9106 show files configured for keyword expansion:
9109 -.ft C
9110 +.ft
9111 hg kwfiles [OPTION]... [FILE]...
9112 -.ft P
9113 +.ft
9116 List which files in the working directory are matched by the
9117 @@ -12366,7 +12338,7 @@
9118 execution by including only files that are actual candidates for
9119 expansion.
9121 -See \%\fBhg help keyword\fP\: on how to construct patterns both for
9122 +See \fBhg help keyword\fP on how to construct patterns both for
9123 inclusion and exclusion of files.
9125 With \-A/\-\-all and \-v/\-\-verbose the codes used to show the status
9126 @@ -12373,16 +12345,16 @@
9127 of files are:
9130 -.ft C
9131 +.ft
9132 K = keyword expansion candidate
9133 k = keyword expansion candidate (not tracked)
9134 I = ignored
9135 i = ignored (not tracked)
9136 -.ft P
9137 +.ft
9140 Options:
9141 -.INDENT 0.0
9142 +.RS 0
9144 .B \-A, \-\-all
9146 @@ -12403,7 +12375,7 @@
9147 .BI \-X, \-\-exclude \ <PATTERN[+]>
9149 exclude names matching the given patterns
9150 -.UNINDENT
9151 +.RE
9153 [+] marked option can be specified multiple times
9154 .SS kwshrink
9155 @@ -12411,9 +12383,9 @@
9156 revert expanded keywords in the working directory:
9159 -.ft C
9160 +.ft
9161 hg kwshrink [OPTION]... [FILE]...
9162 -.ft P
9163 +.ft
9166 Must be run before changing/disabling active keywords.
9167 @@ -12421,7 +12393,7 @@
9168 kwshrink refuses to run if given files contain local changes.
9170 Options:
9171 -.INDENT 0.0
9172 +.RS 0
9174 .BI \-I, \-\-include \ <PATTERN[+]>
9176 @@ -12430,7 +12402,7 @@
9177 .BI \-X, \-\-exclude \ <PATTERN[+]>
9179 exclude names matching the given patterns
9180 -.UNINDENT
9181 +.RE
9183 [+] marked option can be specified multiple times
9184 .SS largefiles
9185 @@ -12439,10 +12411,10 @@
9187 Large binary files tend to be not very compressible, not very
9188 diffable, and not at all mergeable. Such files are not handled
9189 -efficiently by Mercurial\(aqs storage format (revlog), which is based on
9190 +efficiently by Mercurial's storage format (revlog), which is based on
9191 compressed binary deltas; storing large binary files as regular
9192 Mercurial files wastes bandwidth and disk space and increases
9193 -Mercurial\(aqs memory usage. The largefiles extension addresses these
9194 +Mercurial's memory usage. The largefiles extension addresses these
9195 problems by adding a centralized client\-server layer on top of
9196 Mercurial: largefiles live in a \fIcentral store\fP out on the network
9197 somewhere, and you only fetch the revisions that you need when you
9198 @@ -12454,18 +12426,18 @@
9199 identified by the SHA\-1 hash of their contents, which is written to
9200 the standin. largefiles uses that revision ID to get/put largefile
9201 revisions from/to the central store. This saves both disk space and
9202 -bandwidth, since you don\(aqt need to retrieve all historical revisions
9203 +bandwidth, since you don't need to retrieve all historical revisions
9204 of large files when you clone or pull.
9206 To start a new repository or add new large binary files, just add
9207 -\-\-large to your \%\fBhg add\fP\: command. For example:
9208 +\-\-large to your \fBhg add\fP command. For example:
9211 -.ft C
9212 +.ft
9213 $ dd if=/dev/urandom of=randomdata count=2000
9214 $ hg add \-\-large randomdata
9215 $ hg commit \-m "add randomdata as a largefile"
9216 -.ft P
9217 +.ft
9220 When you push a changeset that adds/modifies largefiles to a remote
9221 @@ -12482,8 +12454,8 @@
9222 copy to the latest pulled revision (and thereby downloading any new
9223 largefiles).
9225 -If you want to pull largefiles you don\(aqt need for update yet, then
9226 -you can use pull with the \fI\-\-lfrev\fP option or the \%\fBhg lfpull\fP\: command.
9227 +If you want to pull largefiles you don't need for update yet, then
9228 +you can use pull with the \fI\-\-lfrev\fP option or the \fBhg lfpull\fP command.
9230 If you know you are pulling from a non\-default location and want to
9231 download all the largefiles that correspond to the new changesets at
9232 @@ -12502,12 +12474,12 @@
9233 If you already have large files tracked by Mercurial without the
9234 largefiles extension, you will need to convert your repository in
9235 order to benefit from largefiles. This is done with the
9236 -\%\fBhg lfconvert\fP\: command:
9237 +\fBhg lfconvert\fP command:
9240 -.ft C
9241 +.ft
9242 $ hg lfconvert \-\-size 10 oldrepo newrepo
9243 -.ft P
9244 +.ft
9247 In repositories that already have largefiles in them, any new file
9248 @@ -12517,20 +12489,20 @@
9249 \-\-lfsize option to the add command (also in megabytes):
9252 -.ft C
9253 +.ft
9254 [largefiles]
9255 minsize = 2
9257 $ hg add \-\-lfsize 2
9258 -.ft P
9259 +.ft
9262 The \fBlargefiles.patterns\fP config option allows you to specify a list
9263 -of filename patterns (see \%\fBhg help patterns\fP\:) that should always be
9264 +of filename patterns (see \fBhg help patterns\fP) that should always be
9265 tracked as largefiles:
9268 -.ft C
9269 +.ft
9270 [largefiles]
9271 patterns =
9272 *.jpg
9273 @@ -12537,7 +12509,7 @@
9274 re:.*\e.(png|bmp)$
9275 library.zip
9276 content/audio/*
9277 -.ft P
9278 +.ft
9281 Files that match one of these patterns will be added as largefiles
9282 @@ -12546,7 +12518,7 @@
9283 The \fBlargefiles.minsize\fP and \fBlargefiles.patterns\fP config options
9284 will be ignored for any repositories not already containing a
9285 largefile. To add the first largefile to a repository, you must
9286 -explicitly do so with the \-\-large flag passed to the \%\fBhg add\fP\:
9287 +explicitly do so with the \-\-large flag passed to the \fBhg add\fP
9288 command.
9289 .SS Commands
9290 .SS lfconvert
9291 @@ -12554,9 +12526,9 @@
9292 convert a normal repository to a largefiles repository:
9295 -.ft C
9296 +.ft
9297 hg lfconvert SOURCE DEST [FILE ...]
9298 -.ft P
9299 +.ft
9302 Convert repository SOURCE to a new repository DEST, identical to
9303 @@ -12576,7 +12548,7 @@
9304 this, the DEST repository can be used without largefiles at all.
9306 Options:
9307 -.INDENT 0.0
9308 +.RS 0
9310 .BI \-s, \-\-size \ <SIZE>
9312 @@ -12585,33 +12557,33 @@
9313 .B \-\-to\-normal
9315 convert from a largefiles repo to a normal repo
9316 -.UNINDENT
9317 +.RE
9318 .SS lfpull
9320 pull largefiles for the specified revisions from the specified source:
9323 -.ft C
9324 +.ft
9325 hg lfpull \-r REV... [\-e CMD] [\-\-remotecmd CMD] [SOURCE]
9326 -.ft P
9327 +.ft
9330 Pull largefiles that are referenced from local changesets but missing
9331 locally, pulling from a remote repository to the local cache.
9333 -If SOURCE is omitted, the \(aqdefault\(aq path will be used.
9334 -See \%\fBhg help urls\fP\: for more information.
9335 +If SOURCE is omitted, the 'default' path will be used.
9336 +See \fBhg help urls\fP for more information.
9338 Some examples:
9339 -.INDENT 0.0
9340 +.RS 0
9341 .IP \(bu 2
9343 pull largefiles for all branch heads:
9346 -.ft C
9347 +.ft
9348 hg lfpull \-r "head() and not closed()"
9349 -.ft P
9350 +.ft
9352 .IP \(bu 2
9354 @@ -12618,14 +12590,14 @@
9355 pull largefiles on the default branch:
9358 -.ft C
9359 +.ft
9360 hg lfpull \-r "branch(default)"
9361 -.ft P
9362 +.ft
9364 -.UNINDENT
9365 +.RE
9367 Options:
9368 -.INDENT 0.0
9369 +.RS 0
9371 .BI \-r, \-\-rev \ <VALUE[+]>
9373 @@ -12642,7 +12614,7 @@
9374 .B \-\-insecure
9376 do not verify server certificate (ignoring web.cacerts config)
9377 -.UNINDENT
9378 +.RE
9380 [+] marked option can be specified multiple times
9381 .SS logtoprocess
9382 @@ -12658,7 +12630,7 @@
9383 prefixed with \fIOPT_\fP). The original event name is passed in the \fIEVENT\fP
9384 environment variable, and the process ID of mercurial is given in \fIHGPID\fP.
9386 -So given a call \fIui.log(\(aqfoo\(aq, \(aqbar\(aq, \(aqbaz\(aq, spam=\(aqeggs\(aq), a script configured
9387 +So given a call \fIui.log('foo', 'bar', 'baz', spam='eggs'), a script configured
9388 for the \(gafoo\fP event can expect an environment with \fIMSG1=bar\fP, \fIMSG2=baz\fP, and
9389 \fIOPT_SPAM=eggs\fP.
9391 @@ -12666,10 +12638,10 @@
9392 For example:
9395 -.ft C
9396 +.ft
9397 [logtoprocess]
9398 commandexception = echo "$MSG2$MSG3" > /var/log/mercurial_exceptions.log
9399 -.ft P
9400 +.ft
9403 would log the warning message and traceback of any failed command dispatch.
9404 @@ -12687,10 +12659,10 @@
9405 Known patches are represented as patch files in the .hg/patches
9406 directory. Applied patches are both patch files and changesets.
9408 -Common tasks (use \%\fBhg help COMMAND\fP\: for more details):
9409 +Common tasks (use \fBhg help COMMAND\fP for more details):
9412 -.ft C
9413 +.ft
9414 create new patch qnew
9415 import existing patch qimport
9417 @@ -12700,7 +12672,7 @@
9418 add known patch to applied stack qpush
9419 remove patch from applied stack qpop
9420 refresh contents of top applied patch qrefresh
9421 -.ft P
9422 +.ft
9425 By default, mq will automatically use git patches when required to
9426 @@ -12708,29 +12680,29 @@
9427 files creations or deletions. This behavior can be configured with:
9430 -.ft C
9431 +.ft
9432 [mq]
9433 git = auto/keep/yes/no
9434 -.ft P
9435 +.ft
9438 -If set to \(aqkeep\(aq, mq will obey the [diff] section configuration while
9439 -preserving existing git patches upon qrefresh. If set to \(aqyes\(aq or
9440 -\(aqno\(aq, mq will override the [diff] section and always generate git or
9441 +If set to 'keep', mq will obey the [diff] section configuration while
9442 +preserving existing git patches upon qrefresh. If set to 'yes' or
9443 +\&'no', mq will override the [diff] section and always generate git or
9444 regular patches, possibly losing data in the second case.
9446 It may be desirable for mq changesets to be kept in the secret phase (see
9447 -\%\fBhg help phases\fP\:), which can be enabled with the following setting:
9448 +\fBhg help phases\fP), which can be enabled with the following setting:
9451 -.ft C
9452 +.ft
9453 [mq]
9454 secret = True
9455 -.ft P
9456 +.ft
9459 You will by default be managing a patch queue named "patches". You can
9460 -create other, independent patch queues with the \%\fBhg qqueue\fP\: command.
9461 +create other, independent patch queues with the \fBhg qqueue\fP command.
9463 If the working directory contains uncommitted files, qpush, qpop and
9464 qgoto abort immediately. If \-f/\-\-force is used, the changes are
9465 @@ -12737,10 +12709,10 @@
9466 discarded. Setting:
9469 -.ft C
9470 +.ft
9471 [mq]
9472 keepchanges = True
9473 -.ft P
9474 +.ft
9477 make them behave as if \-\-keep\-changes were passed, and non\-conflicting
9478 @@ -12755,15 +12727,15 @@
9479 print the patches already applied:
9482 -.ft C
9483 +.ft
9484 hg qapplied [\-1] [\-s] [PATCH]
9485 -.ft P
9486 +.ft
9489 Returns 0 on success.
9491 Options:
9492 -.INDENT 0.0
9493 +.RS 0
9495 .B \-1, \-\-last
9497 @@ -12772,15 +12744,15 @@
9498 .B \-s, \-\-summary
9500 print first line of patch header
9501 -.UNINDENT
9502 +.RE
9503 .SS qclone
9505 clone main and patch repository at same time:
9508 -.ft C
9509 +.ft
9510 hg qclone [OPTION]... SOURCE [DEST]
9511 -.ft P
9512 +.ft
9515 If source is local, destination will have no patches applied. If
9516 @@ -12793,12 +12765,12 @@
9517 default. Use \-p <url> to change.
9519 The patch directory must be a nested Mercurial repository, as
9520 -would be created by \%\fBhg init \-\-mq\fP\:.
9521 +would be created by \fBhg init \-\-mq\fP.
9523 Return 0 on success.
9525 Options:
9526 -.INDENT 0.0
9527 +.RS 0
9529 .B \-\-pull
9531 @@ -12827,21 +12799,21 @@
9532 .B \-\-insecure
9534 do not verify server certificate (ignoring web.cacerts config)
9535 -.UNINDENT
9536 +.RE
9537 .SS qcommit
9539 commit changes in the queue repository (DEPRECATED):
9542 -.ft C
9543 +.ft
9544 hg qcommit [OPTION]... [FILE]...
9545 -.ft P
9546 +.ft
9549 -This command is deprecated; use \%\fBhg commit \-\-mq\fP\: instead.
9550 +This command is deprecated; use \fBhg commit \-\-mq\fP instead.
9552 Options:
9553 -.INDENT 0.0
9554 +.RS 0
9556 .B \-A, \-\-addremove
9558 @@ -12894,23 +12866,23 @@
9559 .B \-S, \-\-subrepos
9561 recurse into subrepositories
9562 -.UNINDENT
9563 +.RE
9565 [+] marked option can be specified multiple times
9566 -.INDENT 0.0
9567 -.INDENT 3.5
9568 +.RS 0
9569 +.RS 3
9571 aliases: qci
9572 -.UNINDENT
9573 -.UNINDENT
9574 +.RE
9575 +.RE
9576 .SS qdelete
9578 remove patches from queue:
9581 -.ft C
9582 +.ft
9583 hg qdelete [\-k] [PATCH]...
9584 -.ft P
9585 +.ft
9588 The patches must not be applied, and at least one patch is required. Exact
9589 @@ -12918,10 +12890,10 @@
9590 preserved in the patch directory.
9592 To stop managing a patch and move it into permanent history,
9593 -use the \%\fBhg qfinish\fP\: command.
9594 +use the \fBhg qfinish\fP command.
9596 Options:
9597 -.INDENT 0.0
9598 +.RS 0
9600 .B \-k, \-\-keep
9602 @@ -12930,23 +12902,23 @@
9603 .BI \-r, \-\-rev \ <REV[+]>
9605 stop managing a revision (DEPRECATED)
9606 -.UNINDENT
9607 +.RE
9609 [+] marked option can be specified multiple times
9610 -.INDENT 0.0
9611 -.INDENT 3.5
9612 +.RS 0
9613 +.RS 3
9615 aliases: qremove qrm
9616 -.UNINDENT
9617 -.UNINDENT
9618 +.RE
9619 +.RE
9620 .SS qdiff
9622 diff of the current patch and subsequent modifications:
9625 -.ft C
9626 +.ft
9627 hg qdiff [OPTION]... [FILE]...
9628 -.ft P
9629 +.ft
9632 Shows a diff which includes the current patch as well as any
9633 @@ -12954,8 +12926,8 @@
9634 last refresh (thus showing what the current patch would become
9635 after a qrefresh).
9637 -Use \%\fBhg diff\fP\: if you only want to see the changes made since the
9638 -last qrefresh, or \%\fBhg export qtip\fP\: if you want to see changes
9639 +Use \fBhg diff\fP if you only want to see the changes made since the
9640 +last qrefresh, or \fBhg export qtip\fP if you want to see changes
9641 made by the current patch without including changes made since the
9642 qrefresh.
9644 @@ -12962,7 +12934,7 @@
9645 Returns 0 on success.
9647 Options:
9648 -.INDENT 0.0
9649 +.RS 0
9651 .B \-a, \-\-text
9653 @@ -13027,7 +12999,7 @@
9654 .BI \-X, \-\-exclude \ <PATTERN[+]>
9656 exclude names matching the given patterns
9657 -.UNINDENT
9658 +.RE
9660 [+] marked option can be specified multiple times
9661 .SS qfinish
9662 @@ -13035,9 +13007,9 @@
9663 move applied patches into repository history:
9666 -.ft C
9667 +.ft
9668 hg qfinish [\-a] [REV]...
9669 -.ft P
9670 +.ft
9673 Finishes the specified revisions (corresponding to applied
9674 @@ -13056,20 +13028,20 @@
9675 Returns 0 on success.
9677 Options:
9678 -.INDENT 0.0
9679 +.RS 0
9681 .B \-a, \-\-applied
9683 finish all applied changesets
9684 -.UNINDENT
9685 +.RE
9686 .SS qfold
9688 fold the named patches into the current patch:
9691 -.ft C
9692 +.ft
9693 hg qfold [\-e] [\-k] [\-m TEXT] [\-l FILE] PATCH...
9694 -.ft P
9695 +.ft
9698 Patches must not yet be applied. Each patch will be successively
9699 @@ -13085,7 +13057,7 @@
9700 Returns 0 on success.
9702 Options:
9703 -.INDENT 0.0
9704 +.RS 0
9706 .B \-e, \-\-edit
9708 @@ -13102,21 +13074,21 @@
9709 .BI \-l, \-\-logfile \ <FILE>
9711 read commit message from file
9712 -.UNINDENT
9713 +.RE
9714 .SS qgoto
9716 push or pop patches until named patch is at top of stack:
9719 -.ft C
9720 +.ft
9721 hg qgoto [OPTION]... PATCH
9722 -.ft P
9723 +.ft
9726 Returns 0 on success.
9728 Options:
9729 -.INDENT 0.0
9730 +.RS 0
9732 .B \-\-keep\-changes
9734 @@ -13129,21 +13101,21 @@
9735 .B \-\-no\-backup
9737 do not save backup copies of files
9738 -.UNINDENT
9739 +.RE
9740 .SS qguard
9742 set or print guards for a patch:
9745 -.ft C
9746 +.ft
9747 hg qguard [\-l] [\-n] [PATCH] [\-\- [+GUARD]... [\-GUARD]...]
9748 -.ft P
9749 +.ft
9752 Guards control whether a patch can be pushed. A patch with no
9753 guards is always pushed. A patch with a positive guard ("+foo") is
9754 -pushed only if the \%\fBhg qselect\fP\: command has activated it. A patch with
9755 -a negative guard ("\-foo") is never pushed if the \%\fBhg qselect\fP\: command
9756 +pushed only if the \fBhg qselect\fP command has activated it. A patch with
9757 +a negative guard ("\-foo") is never pushed if the \fBhg qselect\fP command
9758 has activated it.
9760 With no arguments, print the currently active guards.
9761 @@ -13150,21 +13122,21 @@
9762 With arguments, set guards for the named patch.
9763 .IP Note
9765 -Specifying negative guards now requires \(aq\-\-\(aq.
9766 +Specifying negative guards now requires '\-\-'.
9769 To set guards on another patch:
9772 -.ft C
9773 +.ft
9774 hg qguard other.patch \-\- +2.6.17 \-stable
9775 -.ft P
9776 +.ft
9779 Returns 0 on success.
9781 Options:
9782 -.INDENT 0.0
9783 +.RS 0
9785 .B \-l, \-\-list
9787 @@ -13173,15 +13145,15 @@
9788 .B \-n, \-\-none
9790 drop all guards
9791 -.UNINDENT
9792 +.RE
9793 .SS qheader
9795 print the header of the topmost or specified patch:
9798 -.ft C
9799 +.ft
9800 hg qheader [PATCH]
9801 -.ft P
9802 +.ft
9805 Returns 0 on success.
9806 @@ -13190,9 +13162,9 @@
9807 import a patch or existing changeset:
9810 -.ft C
9811 +.ft
9812 hg qimport [\-e] [\-n NAME] [\-f] [\-g] [\-P] [\-r REV]... [FILE]...
9813 -.ft P
9814 +.ft
9817 The patch is inserted into the series after the last applied
9818 @@ -13213,7 +13185,7 @@
9819 under mq control). With \-g/\-\-git, patches imported with \-\-rev will
9820 use the git diff format. See the diffs help topic for information
9821 on why this is important for preserving rename/copy information
9822 -and permission changes. Use \%\fBhg qfinish\fP\: to remove changesets
9823 +and permission changes. Use \fBhg qfinish\fP to remove changesets
9824 from mq control.
9826 To import a patch from standard input, pass \- as the patch file.
9827 @@ -13223,15 +13195,15 @@
9828 To import an existing patch while renaming it:
9831 -.ft C
9832 +.ft
9833 hg qimport \-e existing\-patch \-n new\-name
9834 -.ft P
9835 +.ft
9838 Returns 0 if import succeeded.
9840 Options:
9841 -.INDENT 0.0
9842 +.RS 0
9844 .B \-e, \-\-existing
9846 @@ -13256,7 +13228,7 @@
9847 .B \-P, \-\-push
9849 qpush after importing
9850 -.UNINDENT
9851 +.RE
9853 [+] marked option can be specified multiple times
9854 .SS qinit
9855 @@ -13264,9 +13236,9 @@
9856 init a new queue repository (DEPRECATED):
9859 -.ft C
9860 +.ft
9861 hg qinit [\-c]
9862 -.ft P
9863 +.ft
9866 The queue repository is unversioned by default. If
9867 @@ -13275,24 +13247,24 @@
9868 an unversioned patch repository into a versioned one). You can use
9869 qcommit to commit changes to this queue repository.
9871 -This command is deprecated. Without \-c, it\(aqs implied by other relevant
9872 -commands. With \-c, use \%\fBhg init \-\-mq\fP\: instead.
9873 +This command is deprecated. Without \-c, it's implied by other relevant
9874 +commands. With \-c, use \fBhg init \-\-mq\fP instead.
9876 Options:
9877 -.INDENT 0.0
9878 +.RS 0
9880 .B \-c, \-\-create\-repo
9882 create queue repository
9883 -.UNINDENT
9884 +.RE
9885 .SS qnew
9887 create a new patch:
9890 -.ft C
9891 +.ft
9892 hg qnew [\-e] [\-m TEXT] [\-l FILE] PATCH [FILE]...
9893 -.ft P
9894 +.ft
9897 qnew creates a new patch on top of the currently\-applied patch (if
9898 @@ -13308,7 +13280,7 @@
9900 \-e/\-\-edit, \-m/\-\-message or \-l/\-\-logfile set the patch header as
9901 well as the commit message. If none is specified, the header is
9902 -empty and the commit message is \(aq[mq]: PATCH\(aq.
9903 +empty and the commit message is '[mq]: PATCH'.
9905 Use the \-g/\-\-git option to keep the patch in the git extended diff
9906 format. Read the diffs help topic for more information on why this
9907 @@ -13318,7 +13290,7 @@
9908 Returns 0 on successful creation of a new patch.
9910 Options:
9911 -.INDENT 0.0
9912 +.RS 0
9914 .B \-e, \-\-edit
9916 @@ -13363,7 +13335,7 @@
9917 .BI \-l, \-\-logfile \ <FILE>
9919 read commit message from file
9920 -.UNINDENT
9921 +.RE
9923 [+] marked option can be specified multiple times
9924 .SS qnext
9925 @@ -13371,28 +13343,28 @@
9926 print the name of the next pushable patch:
9929 -.ft C
9930 +.ft
9931 hg qnext [\-s]
9932 -.ft P
9933 +.ft
9936 Returns 0 on success.
9938 Options:
9939 -.INDENT 0.0
9940 +.RS 0
9942 .B \-s, \-\-summary
9944 print first line of patch header
9945 -.UNINDENT
9946 +.RE
9947 .SS qpop
9949 pop the current patch off the stack:
9952 -.ft C
9953 +.ft
9954 hg qpop [\-a] [\-f] [PATCH | INDEX]
9955 -.ft P
9956 +.ft
9959 Without argument, pops off the top of the patch stack. If given a
9960 @@ -13407,7 +13379,7 @@
9961 Return 0 on success.
9963 Options:
9964 -.INDENT 0.0
9965 +.RS 0
9967 .B \-a, \-\-all
9969 @@ -13428,34 +13400,34 @@
9970 .B \-\-no\-backup
9972 do not save backup copies of files
9973 -.UNINDENT
9974 +.RE
9975 .SS qprev
9977 print the name of the preceding applied patch:
9980 -.ft C
9981 +.ft
9982 hg qprev [\-s]
9983 -.ft P
9984 +.ft
9987 Returns 0 on success.
9989 Options:
9990 -.INDENT 0.0
9991 +.RS 0
9993 .B \-s, \-\-summary
9995 print first line of patch header
9996 -.UNINDENT
9997 +.RE
9998 .SS qpush
10000 push the next patch onto the stack:
10003 -.ft C
10004 +.ft
10005 hg qpush [\-f] [\-l] [\-a] [\-\-move] [PATCH | INDEX]
10006 -.ft P
10007 +.ft
10010 By default, abort if the working directory contains uncommitted
10011 @@ -13466,7 +13438,7 @@
10012 Return 0 on success.
10014 Options:
10015 -.INDENT 0.0
10016 +.RS 0
10018 .B \-\-keep\-changes
10020 @@ -13503,15 +13475,15 @@
10021 .B \-\-no\-backup
10023 do not save backup copies of files
10024 -.UNINDENT
10025 +.RE
10026 .SS qqueue
10028 manage multiple patch queues:
10031 -.ft C
10032 +.ft
10033 hg qqueue [OPTION] [QUEUE]
10034 -.ft P
10035 +.ft
10038 Supports switching between different patch queues, as well as creating
10039 @@ -13533,7 +13505,7 @@
10040 Returns 0 on success.
10042 Options:
10043 -.INDENT 0.0
10044 +.RS 0
10046 .B \-l, \-\-list
10048 @@ -13558,15 +13530,15 @@
10049 .B \-\-purge
10051 delete queue, and remove patch dir
10052 -.UNINDENT
10053 +.RE
10054 .SS qrefresh
10056 update the current patch:
10059 -.ft C
10060 +.ft
10061 hg qrefresh [\-I] [\-X] [\-e] [\-m TEXT] [\-l FILE] [\-s] [FILE]...
10062 -.ft P
10063 +.ft
10066 If any file patterns are provided, the refreshed patch will
10067 @@ -13588,7 +13560,7 @@
10068 Returns 0 on success.
10070 Options:
10071 -.INDENT 0.0
10072 +.RS 0
10074 .B \-e, \-\-edit
10076 @@ -13633,7 +13605,7 @@
10077 .BI \-l, \-\-logfile \ <FILE>
10079 read commit message from file
10080 -.UNINDENT
10081 +.RE
10083 [+] marked option can be specified multiple times
10084 .SS qrename
10085 @@ -13641,9 +13613,9 @@
10086 rename a patch:
10089 -.ft C
10090 +.ft
10091 hg qrename PATCH1 [PATCH2]
10092 -.ft P
10093 +.ft
10096 With one argument, renames the current patch to PATCH1.
10097 @@ -13650,26 +13622,26 @@
10098 With two arguments, renames PATCH1 to PATCH2.
10100 Returns 0 on success.
10101 -.INDENT 0.0
10102 -.INDENT 3.5
10103 +.RS 0
10104 +.RS 3
10106 aliases: qmv
10107 -.UNINDENT
10108 -.UNINDENT
10109 +.RE
10110 +.RE
10111 .SS qrestore
10113 restore the queue state saved by a revision (DEPRECATED):
10116 -.ft C
10117 +.ft
10118 hg qrestore [\-d] [\-u] REV
10119 -.ft P
10120 +.ft
10123 -This command is deprecated, use \%\fBhg rebase\fP\: instead.
10124 +This command is deprecated, use \fBhg rebase\fP instead.
10126 Options:
10127 -.INDENT 0.0
10128 +.RS 0
10130 .B \-d, \-\-delete
10132 @@ -13678,21 +13650,21 @@
10133 .B \-u, \-\-update
10135 update queue working directory
10136 -.UNINDENT
10137 +.RE
10138 .SS qsave
10140 save current queue state (DEPRECATED):
10143 -.ft C
10144 +.ft
10145 hg qsave [\-m TEXT] [\-l FILE] [\-c] [\-n NAME] [\-e] [\-f]
10146 -.ft P
10147 +.ft
10150 -This command is deprecated, use \%\fBhg rebase\fP\: instead.
10151 +This command is deprecated, use \fBhg rebase\fP instead.
10153 Options:
10154 -.INDENT 0.0
10155 +.RS 0
10157 .B \-c, \-\-copy
10159 @@ -13717,18 +13689,18 @@
10160 .BI \-l, \-\-logfile \ <FILE>
10162 read commit message from file
10163 -.UNINDENT
10164 +.RE
10165 .SS qselect
10167 set or print guarded patches to push:
10170 -.ft C
10171 +.ft
10172 hg qselect [OPTION]... [GUARD]...
10173 -.ft P
10174 +.ft
10177 -Use the \%\fBhg qguard\fP\: command to set or print guards on patch, then use
10178 +Use the \fBhg qguard\fP command to set or print guards on patch, then use
10179 qselect to tell mq which guards to use. A patch will be pushed if
10180 it has no guards or any positive guards match the currently
10181 selected guard, but will not be pushed if any negative guards
10182 @@ -13735,11 +13707,11 @@
10183 match the current guard. For example:
10186 -.ft C
10187 +.ft
10188 qguard foo.patch \-\- \-stable (negative guard)
10189 qguard bar.patch +stable (positive guard)
10190 qselect stable
10191 -.ft P
10192 +.ft
10195 This activates the "stable" guard. mq will skip foo.patch (because
10196 @@ -13765,7 +13737,7 @@
10197 Returns 0 on success.
10199 Options:
10200 -.INDENT 0.0
10201 +.RS 0
10203 .B \-n, \-\-none
10205 @@ -13782,21 +13754,21 @@
10206 .B \-\-reapply
10208 pop, then reapply patches
10209 -.UNINDENT
10210 +.RE
10211 .SS qseries
10213 print the entire series file:
10216 -.ft C
10217 +.ft
10218 hg qseries [\-ms]
10219 -.ft P
10220 +.ft
10223 Returns 0 on success.
10225 Options:
10226 -.INDENT 0.0
10227 +.RS 0
10229 .B \-m, \-\-missing
10231 @@ -13805,40 +13777,40 @@
10232 .B \-s, \-\-summary
10234 print first line of patch header
10235 -.UNINDENT
10236 +.RE
10237 .SS qtop
10239 print the name of the current patch:
10242 -.ft C
10243 +.ft
10244 hg qtop [\-s]
10245 -.ft P
10246 +.ft
10249 Returns 0 on success.
10251 Options:
10252 -.INDENT 0.0
10253 +.RS 0
10255 .B \-s, \-\-summary
10257 print first line of patch header
10258 -.UNINDENT
10259 +.RE
10260 .SS qunapplied
10262 print the patches not yet applied:
10265 -.ft C
10266 +.ft
10267 hg qunapplied [\-1] [\-s] [PATCH]
10268 -.ft P
10269 +.ft
10272 Returns 0 on success.
10274 Options:
10275 -.INDENT 0.0
10276 +.RS 0
10278 .B \-1, \-\-first
10280 @@ -13847,7 +13819,7 @@
10281 .B \-s, \-\-summary
10283 print first line of patch header
10284 -.UNINDENT
10285 +.RE
10286 .SS notify
10288 hooks for sending email push notifications
10289 @@ -13855,13 +13827,13 @@
10290 This extension implements hooks to send email notifications when
10291 changesets are sent from or received by the local repository.
10293 -First, enable the extension as explained in \%\fBhg help extensions\fP\:, and
10294 +First, enable the extension as explained in \fBhg help extensions\fP, and
10295 register the hook you want to run. \fBincoming\fP and \fBchangegroup\fP hooks
10296 are run when changesets are received, while \fBoutgoing\fP hooks are for
10297 changesets sent to another repository:
10300 -.ft C
10301 +.ft
10302 [hooks]
10303 # one email for each incoming changeset
10304 incoming.notify = python:hgext.notify.hook
10305 @@ -13870,7 +13842,7 @@
10307 # one email for all outgoing changesets
10308 outgoing.notify = python:hgext.notify.hook
10309 -.ft P
10310 +.ft
10313 This registers the hooks. To enable notification, subscribers must
10314 @@ -13879,7 +13851,7 @@
10315 multiple recipients to a single repository:
10318 -.ft C
10319 +.ft
10320 [usersubs]
10321 # key is subscriber email, value is a comma\-separated list of repo patterns
10322 user@host = pattern
10323 @@ -13887,7 +13859,7 @@
10324 [reposubs]
10325 # key is repo pattern, value is a comma\-separated list of subscriber emails
10326 pattern = user@host
10327 -.ft P
10328 +.ft
10331 A \fBpattern\fP is a \fBglob\fP matching the absolute path to a repository,
10332 @@ -13895,10 +13867,10 @@
10333 present, is separated from the glob by a hash. Example:
10336 -.ft C
10337 +.ft
10338 [reposubs]
10339 */widgets#branch(release) = qa\-team@example.com
10340 -.ft P
10341 +.ft
10344 This sends to \fBqa\-team@example.com\fP whenever a changeset on the \fBrelease\fP
10345 @@ -13909,10 +13881,10 @@
10346 incorporated by reference:
10349 -.ft C
10350 +.ft
10351 [notify]
10352 config = /path/to/subscriptionsfile
10353 -.ft P
10354 +.ft
10357 Notifications will not be sent until the \fBnotify.test\fP value is set
10358 @@ -13919,7 +13891,7 @@
10359 to \fBFalse\fP; see below.
10361 Notifications content can be tweaked with the following configuration entries:
10362 -.INDENT 0.0
10363 +.RS 0
10365 .B notify.test
10367 @@ -13928,8 +13900,8 @@
10368 .B notify.sources
10370 Space\-separated list of change sources. Notifications are activated only
10371 -when a changeset\(aqs source is in this list. Sources may be:
10372 -.INDENT 7.0
10373 +when a changeset's source is in this list. Sources may be:
10374 +.RS 7
10376 .B \fBserve\fP
10378 @@ -13950,7 +13922,7 @@
10379 .B \fBbundle\fP
10381 changesets sent via \fBhg unbundle\fP
10382 -.UNINDENT
10383 +.RE
10385 Default: serve.
10387 @@ -13993,7 +13965,7 @@
10389 .B notify.maxsubject
10391 -Maximum number of characters in email\(aqs subject line. Default: 67.
10392 +Maximum number of characters in email's subject line. Default: 67.
10394 .B notify.diffstat
10396 @@ -14012,11 +13984,11 @@
10397 If set, use the committer of the first changeset in a changegroup for
10398 the "From" field of the notification mail. If not set, take the user
10399 from the pushing repo. Default: False.
10400 -.UNINDENT
10401 +.RE
10403 If set, the following entries will also be used to customize the
10404 notifications:
10405 -.INDENT 0.0
10406 +.RS 0
10408 .B email.from
10410 @@ -14027,20 +13999,20 @@
10412 Root repository URL to combine with repository paths when making
10413 references. See also \fBnotify.strip\fP.
10414 -.UNINDENT
10415 +.RE
10416 .SS pager
10418 browse command output with an external pager (DEPRECATED)
10420 -Forcibly enable paging for individual commands that don\(aqt typically
10421 +Forcibly enable paging for individual commands that don't typically
10422 request pagination with the attend\-<command> option. This setting
10423 takes precedence over ignore options and defaults:
10426 -.ft C
10427 +.ft
10428 [pager]
10429 attend\-cat = false
10430 -.ft P
10431 +.ft
10433 .SS patchbomb
10435 @@ -14052,7 +14024,7 @@
10436 Each patch email has a Subject line of "[PATCH M of N] ...", using the
10437 first line of the changeset description as the subject text. The
10438 message contains two or three body parts:
10439 -.INDENT 0.0
10440 +.RS 0
10441 .IP \(bu 2
10443 The changeset description.
10444 @@ -14061,8 +14033,8 @@
10445 [Optional] The result of running diffstat on the patch.
10446 .IP \(bu 2
10448 -The patch itself, as generated by \%\fBhg export\fP\:.
10449 -.UNINDENT
10450 +The patch itself, as generated by \fBhg export\fP.
10451 +.RE
10453 Each message refers to the first in the series using the In\-Reply\-To
10454 and References headers, so they will show up as a sequence in threaded
10455 @@ -14072,7 +14044,7 @@
10456 configuration file:
10459 -.ft C
10460 +.ft
10461 [email]
10462 from = My Name <my@email>
10463 to = recipient1, recipient2, ...
10464 @@ -14079,13 +14051,13 @@
10465 cc = cc1, cc2, ...
10466 bcc = bcc1, bcc2, ...
10467 reply\-to = address1, address2, ...
10468 -.ft P
10469 +.ft
10472 Use \fB[patchbomb]\fP as configuration section name if you need to
10473 override global \fB[email]\fP address settings.
10475 -Then you can use the \%\fBhg email\fP\: command to mail a series of
10476 +Then you can use the \fBhg email\fP command to mail a series of
10477 changesets as a patchbomb.
10479 You can also either configure the method option in the email section
10480 @@ -14094,15 +14066,15 @@
10481 directly from the commandline. See the [email] and [smtp] sections in
10482 hgrc(5) for details.
10484 -By default, \%\fBhg email\fP\: will prompt for a \fBTo\fP or \fBCC\fP header if
10485 +By default, \fBhg email\fP will prompt for a \fBTo\fP or \fBCC\fP header if
10486 you do not supply one via configuration or the command line. You can
10487 override this to never prompt by configuring an empty value:
10490 -.ft C
10491 +.ft
10492 [email]
10493 cc =
10494 -.ft P
10495 +.ft
10498 You can control the default inclusion of an introduction message with the
10499 @@ -14110,12 +14082,12 @@
10500 overwritten by command line flags like \-\-intro and \-\-desc:
10503 -.ft C
10504 +.ft
10505 [patchbomb]
10506 intro=auto # include introduction message if more than 1 patch (default)
10507 intro=never # never include an introduction message
10508 intro=always # always include an introduction message
10509 -.ft P
10510 +.ft
10513 You can specify a template for flags to be added in subject prefixes. Flags
10514 @@ -14122,12 +14094,12 @@
10515 specified by \-\-flag option are exported as \fB{flags}\fP keyword:
10518 -.ft C
10519 +.ft
10520 [patchbomb]
10521 -flagtemplate = "{separate(\(aq \(aq,
10522 - ifeq(branch, \(aqdefault\(aq, \(aq\(aq, branch|upper),
10523 +flagtemplate = "{separate(' ',
10524 + ifeq(branch, 'default', '', branch|upper),
10525 flags)}"
10526 -.ft P
10527 +.ft
10530 You can set patchbomb to always ask for confirmation by setting
10531 @@ -14138,13 +14110,13 @@
10532 send changesets by email:
10535 -.ft C
10536 +.ft
10537 hg email [OPTION]... [DEST]...
10538 -.ft P
10539 +.ft
10542 By default, diffs are sent in the format generated by
10543 -\%\fBhg export\fP\:, one per message. The series starts with a "[PATCH 0
10544 +\fBhg export\fP, one per message. The series starts with a "[PATCH 0
10545 of N]" introduction, which describes the series as a whole.
10547 Each patch email has a Subject line of "[PATCH M of N] ...", using
10548 @@ -14155,7 +14127,7 @@
10549 With the \-d/\-\-diffstat option, if the diffstat program is
10550 installed, the result of running diffstat on the patch is inserted.
10552 -Finally, the patch itself, as generated by \%\fBhg export\fP\:.
10553 +Finally, the patch itself, as generated by \fBhg export\fP.
10555 With the \-d/\-\-diffstat or \-\-confirm options, you will be presented
10556 with a final summary of all messages and asked for confirmation before
10557 @@ -14178,7 +14150,7 @@
10558 With \-b/\-\-bundle, changesets are selected as for \-\-outgoing, but a
10559 single email containing a binary Mercurial bundle as an attachment
10560 will be sent. Use the \fBpatchbomb.bundletype\fP config option to
10561 -control the bundle type as with \%\fBhg bundle \-\-type\fP\:.
10562 +control the bundle type as with \fBhg bundle \-\-type\fP.
10564 With \-m/\-\-mbox, instead of previewing each patchbomb message in a
10565 pager or sending the messages directly, it will create a UNIX
10566 @@ -14195,12 +14167,12 @@
10567 introductory message in \fB.hg/last\-email.txt\fP.
10569 The default behavior of this command can be customized through
10570 -configuration. (See \%\fBhg help patchbomb\fP\: for details)
10571 +configuration. (See \fBhg help patchbomb\fP for details)
10573 Examples:
10576 -.ft C
10577 +.ft
10578 hg email \-r 3000 # send patch 3000 only
10579 hg email \-r 3000 \-r 3001 # send patches 3000 and 3001
10580 hg email \-r 3000:3005 # send patches 3000 through 3005
10581 @@ -14223,7 +14195,7 @@
10582 hg email \-o \-m mbox && # generate an mbox file ...
10583 formail \-s sendmail \e # ... and use formail to send from the mbox
10584 \-bm \-t < mbox # ... using sendmail
10585 -.ft P
10586 +.ft
10589 Before using this command, you will need to enable email in your
10590 @@ -14230,7 +14202,7 @@
10591 hgrc. See the [email] section in hgrc(5) for details.
10593 Options:
10594 -.INDENT 0.0
10595 +.RS 0
10597 .B \-g, \-\-git
10599 @@ -14351,7 +14323,7 @@
10600 .B \-\-insecure
10602 do not verify server certificate (ignoring web.cacerts config)
10603 -.UNINDENT
10604 +.RE
10606 [+] marked option can be specified multiple times
10607 .SS purge
10608 @@ -14363,9 +14335,9 @@
10609 removes files not tracked by Mercurial:
10612 -.ft C
10613 +.ft
10614 hg purge [OPTION]... [DIR]...
10615 -.ft P
10616 +.ft
10619 Delete files not known to Mercurial. This is useful to test local
10620 @@ -14372,18 +14344,18 @@
10621 and uncommitted changes in an otherwise\-clean source tree.
10623 This means that purge will delete the following by default:
10624 -.INDENT 0.0
10625 +.RS 0
10626 .IP \(bu 2
10628 -Unknown files: files marked with "?" by \%\fBhg status\fP\:
10629 +Unknown files: files marked with "?" by \fBhg status\fP
10630 .IP \(bu 2
10632 Empty directories: in fact Mercurial ignores directories unless
10633 they contain files under source control management
10634 -.UNINDENT
10635 +.RE
10637 But it will leave untouched:
10638 -.INDENT 0.0
10639 +.RS 0
10640 .IP \(bu 2
10642 Modified and unmodified tracked files
10643 @@ -14392,8 +14364,8 @@
10644 Ignored files (unless \-\-all is specified)
10645 .IP \(bu 2
10647 -New files added to the repository (with \%\fBhg add\fP\:)
10648 -.UNINDENT
10649 +New files added to the repository (with \fBhg add\fP)
10650 +.RE
10652 The \-\-files and \-\-dirs options can be used to direct purge to delete
10653 only files, only directories, or both. If neither option is given,
10654 @@ -14408,7 +14380,7 @@
10655 option.
10657 Options:
10658 -.INDENT 0.0
10659 +.RS 0
10661 .B \-a, \-\-abort\-on\-err
10663 @@ -14441,15 +14413,15 @@
10664 .BI \-X, \-\-exclude \ <PATTERN[+]>
10666 exclude names matching the given patterns
10667 -.UNINDENT
10668 +.RE
10670 [+] marked option can be specified multiple times
10671 -.INDENT 0.0
10672 -.INDENT 3.5
10673 +.RS 0
10674 +.RS 3
10676 aliases: clean
10677 -.UNINDENT
10678 -.UNINDENT
10679 +.RE
10680 +.RE
10681 .SS rebase
10683 command to move sets of revisions to a different ancestor
10684 @@ -14458,7 +14430,7 @@
10685 repository.
10687 For more information:
10688 -\%https://mercurial\-scm.org/wiki/RebaseExtension\:
10689 +https://mercurial\-scm.org/wiki/RebaseExtension
10690 .SS Commands
10691 .SS rebase
10693 @@ -14465,9 +14437,9 @@
10694 move changeset (and descendants) to a different branch:
10697 -.ft C
10698 +.ft
10699 hg rebase [\-s REV | \-b REV] [\-d REV] [OPTION]
10700 -.ft P
10701 +.ft
10704 Rebase uses repeated merging to graft changesets from one part of
10705 @@ -14475,11 +14447,11 @@
10706 useful for linearizing \fIlocal\fP changes relative to a master
10707 development tree.
10709 -Published commits cannot be rebased (see \%\fBhg help phases\fP\:).
10710 -To copy commits, see \%\fBhg help graft\fP\:.
10711 +Published commits cannot be rebased (see \fBhg help phases\fP).
10712 +To copy commits, see \fBhg help graft\fP.
10714 -If you don\(aqt specify a destination changeset (\fB\-d/\-\-dest\fP), rebase
10715 -will use the same logic as \%\fBhg merge\fP\: to pick a destination. if
10716 +If you don't specify a destination changeset (\fB\-d/\-\-dest\fP), rebase
10717 +will use the same logic as \fBhg merge\fP to pick a destination. if
10718 the current branch contains exactly one other head, the other head
10719 is merged with by default. Otherwise, an explicit revision with
10720 which to merge with must be provided. (destination changeset is not
10721 @@ -14487,9 +14459,9 @@
10722 descendants.)
10724 Here are the ways to select changesets:
10725 -.INDENT 0.0
10726 -.INDENT 3.5
10727 -.INDENT 0.0
10728 +.RS 0
10729 +.RS 3
10730 +.RS 0
10731 .IP 1. 3
10733 Explicitly select them using \fB\-\-rev\fP.
10734 @@ -14505,9 +14477,9 @@
10736 If you do not specify any of \fB\-\-rev\fP, \fBsource\fP, or \fB\-\-base\fP,
10737 rebase will use \fB\-\-base .\fP as above.
10738 -.UNINDENT
10739 -.UNINDENT
10740 -.UNINDENT
10741 +.RE
10742 +.RE
10743 +.RE
10745 Rebase will destroy original changesets unless you use \fB\-\-keep\fP.
10746 It will also move your bookmarks (even if you do).
10747 @@ -14520,7 +14492,7 @@
10748 and/or destination.
10750 If you need to use a tool to automate merge/conflict decisions, you
10751 -can specify one with \fB\-\-tool\fP, see \%\fBhg help merge\-tools\fP\:.
10752 +can specify one with \fB\-\-tool\fP, see \fBhg help merge\-tools\fP.
10753 As a caveat: the tool will not be used to mediate when a file was
10754 deleted, there is no hook presently available for this.
10756 @@ -14528,7 +14500,7 @@
10757 continued with \-\-continue/\-c or aborted with \-\-abort/\-a.
10759 Examples:
10760 -.INDENT 0.0
10761 +.RS 0
10762 .IP \(bu 2
10764 move "local changes" (current commit back to branching point)
10765 @@ -14535,9 +14507,9 @@
10766 to the current branch tip after a pull:
10769 -.ft C
10770 +.ft
10771 hg rebase
10772 -.ft P
10773 +.ft
10775 .IP \(bu 2
10777 @@ -14544,9 +14516,9 @@
10778 move a single changeset to the stable branch:
10781 -.ft C
10782 +.ft
10783 hg rebase \-r 5f493448 \-d stable
10784 -.ft P
10785 +.ft
10787 .IP \(bu 2
10789 @@ -14553,9 +14525,9 @@
10790 splice a commit and all its descendants onto another part of history:
10793 -.ft C
10794 +.ft
10795 hg rebase \-\-source c0c3 \-\-dest 4cf9
10796 -.ft P
10797 +.ft
10799 .IP \(bu 2
10801 @@ -14563,9 +14535,9 @@
10802 default branch:
10805 -.ft C
10806 +.ft
10807 hg rebase \-\-base myfeature \-\-dest default
10808 -.ft P
10809 +.ft
10811 .IP \(bu 2
10813 @@ -14572,9 +14544,9 @@
10814 collapse a sequence of changes into a single commit:
10817 -.ft C
10818 +.ft
10819 hg rebase \-\-collapse \-r 1520:1525 \-d .
10820 -.ft P
10821 +.ft
10823 .IP \(bu 2
10825 @@ -14581,11 +14553,11 @@
10826 move a named branch while preserving its name:
10829 -.ft C
10830 +.ft
10831 hg rebase \-r "branch(featureX)" \-d 1.3 \-\-keepbranches
10832 -.ft P
10833 +.ft
10835 -.UNINDENT
10836 +.RE
10838 Configuration Options:
10840 @@ -14593,23 +14565,23 @@
10841 option:
10844 -.ft C
10845 +.ft
10846 [commands]
10847 rebase.requiredest = True
10848 -.ft P
10849 +.ft
10852 By default, rebase will close the transaction after each commit. For
10853 performance purposes, you can configure rebase to use a single transaction
10854 across the entire rebase. WARNING: This setting introduces a significant
10855 -risk of losing the work you\(aqve done in a rebase if the rebase aborts
10856 +risk of losing the work you've done in a rebase if the rebase aborts
10857 unexpectedly:
10860 -.ft C
10861 +.ft
10862 [rebase]
10863 singletransaction = True
10864 -.ft P
10865 +.ft
10868 Return Values:
10869 @@ -14618,7 +14590,7 @@
10870 unresolved conflicts.
10872 Options:
10873 -.INDENT 0.0
10874 +.RS 0
10876 .BI \-s, \-\-source \ <REV>
10878 @@ -14687,7 +14659,7 @@
10879 .BI \-T, \-\-template \ <TEMPLATE>
10881 display with template
10882 -.UNINDENT
10883 +.RE
10885 [+] marked option can be specified multiple times
10886 .SS record
10887 @@ -14695,7 +14667,7 @@
10888 commands to interactively select changes for commit/qrefresh (DEPRECATED)
10890 The feature provided by this extension has been moved into core Mercurial as
10891 -\%\fBhg commit \-\-interactive\fP\:.
10892 +\fBhg commit \-\-interactive\fP.
10893 .SS Commands
10894 .SS qrecord
10896 @@ -14702,12 +14674,12 @@
10897 interactively record a new patch:
10900 -.ft C
10901 +.ft
10902 hg qrecord [OPTION]... PATCH [FILE]...
10903 -.ft P
10904 +.ft
10907 -See \%\fBhg help qnew\fP\: & \%\fBhg help record\fP\: for more information and
10908 +See \fBhg help qnew\fP & \fBhg help record\fP for more information and
10909 usage.
10910 .SS record
10912 @@ -14714,17 +14686,17 @@
10913 interactively select changes to commit:
10916 -.ft C
10917 +.ft
10918 hg record [OPTION]... [FILE]...
10919 -.ft P
10920 +.ft
10923 -If a list of files is omitted, all changes reported by \%\fBhg status\fP\:
10924 +If a list of files is omitted, all changes reported by \fBhg status\fP
10925 will be candidates for recording.
10927 -See \%\fBhg help dates\fP\: for a list of formats valid for \-d/\-\-date.
10928 +See \fBhg help dates\fP for a list of formats valid for \-d/\-\-date.
10930 -If using the text interface (see \%\fBhg help config\fP\:),
10931 +If using the text interface (see \fBhg help config\fP),
10932 you will be prompted for whether to record changes to each
10933 modified file, and for files with multiple changes, for each
10934 change to use. For each query, the following responses are
10935 @@ -14731,7 +14703,7 @@
10936 possible:
10939 -.ft C
10940 +.ft
10941 y \- record this change
10942 n \- skip this change
10943 e \- edit this change manually
10944 @@ -14744,13 +14716,13 @@
10945 q \- quit, recording no changes
10947 ? \- display help
10948 -.ft P
10949 +.ft
10952 This command is not available when committing a merge.
10954 Options:
10955 -.INDENT 0.0
10956 +.RS 0
10958 .B \-A, \-\-addremove
10960 @@ -14815,7 +14787,7 @@
10961 .B \-Z, \-\-ignore\-space\-at\-eol
10963 ignore changes in whitespace at EOL
10964 -.UNINDENT
10965 +.RE
10967 [+] marked option can be specified multiple times
10968 .SS releasenotes
10969 @@ -14824,7 +14796,7 @@
10971 It is common to maintain files detailing changes in a project between
10972 releases. Maintaining these files can be difficult and time consuming.
10973 -The \%\fBhg releasenotes\fP\: command provided by this extension makes the
10974 +The \fBhg releasenotes\fP command provided by this extension makes the
10975 process simpler by automating it.
10976 .SS Commands
10977 .SS releasenotes
10978 @@ -14832,9 +14804,9 @@
10979 parse release notes from commit messages into an output file:
10982 -.ft C
10983 +.ft
10984 hg releasenotes [\-r REV] [\-c] FILE
10985 -.ft P
10986 +.ft
10989 Given an output file and set of revisions, this command will parse commit
10990 @@ -14844,11 +14816,11 @@
10991 directives. These have the form:
10994 -.ft C
10995 +.ft
10996 \&.. directive:: title
10998 content
10999 -.ft P
11000 +.ft
11003 Each \fBdirective\fP maps to an output section in a generated release notes
11004 @@ -14864,7 +14836,7 @@
11005 notes to. The format of the file is:
11008 -.ft C
11009 +.ft
11010 Section 1
11011 =========
11013 @@ -14874,7 +14846,7 @@
11014 =========
11016 \&...
11017 -.ft P
11018 +.ft
11021 Only sections with defined release notes are emitted.
11022 @@ -14882,19 +14854,19 @@
11023 If a section only has short\-form notes, it will consist of bullet list:
11026 -.ft C
11027 +.ft
11028 Section
11029 =======
11031 * Release note 1
11032 * Release note 2
11033 -.ft P
11034 +.ft
11037 If a section has long\-form notes, sub\-sections will be emitted:
11040 -.ft C
11041 +.ft
11042 Section
11043 =======
11045 @@ -14907,7 +14879,7 @@
11046 \-\-\-\-\-\-\-\-\-\-\-\-
11048 Description of the second long\-form note.
11049 -.ft P
11050 +.ft
11053 If the \fBFILE\fP argument points to an existing file, that file will be
11054 @@ -14916,7 +14888,7 @@
11055 into this parsed set.
11057 During release notes merging:
11058 -.INDENT 0.0
11059 +.RS 0
11060 .IP \(bu 2
11062 Duplicate items are automatically ignored
11063 @@ -14924,7 +14896,7 @@
11065 Items that are different are automatically ignored if the similarity is
11066 greater than a threshold.
11067 -.UNINDENT
11068 +.RE
11070 This means that the release notes file can be updated independently from
11071 this command and changes should not be lost when running this command on
11072 @@ -14938,7 +14910,7 @@
11073 admonitions (if any).
11075 Options:
11076 -.INDENT 0.0
11077 +.RS 0
11079 .BI \-r, \-\-rev \ <REV>
11081 @@ -14951,7 +14923,7 @@
11082 .B \-l, \-\-list
11084 list the available admonitions with their title
11085 -.UNINDENT
11086 +.RE
11087 .SS relink
11089 recreates hardlinks between repository clones
11090 @@ -14961,9 +14933,9 @@
11091 recreate hardlinks between two repositories:
11094 -.ft C
11095 +.ft
11096 hg relink [ORIGIN]
11097 -.ft P
11098 +.ft
11101 When repositories are cloned locally, their data files will be
11102 @@ -14995,18 +14967,18 @@
11103 lot of repositories to act like a scheme, for example:
11106 -.ft C
11107 +.ft
11108 [schemes]
11109 py = http://code.python.org/hg/
11110 -.ft P
11111 +.ft
11114 After that you can use it like:
11117 -.ft C
11118 +.ft
11119 hg clone py://trunk/
11120 -.ft P
11121 +.ft
11124 Additionally there is support for some more complex schemas, for
11125 @@ -15013,10 +14985,10 @@
11126 example used by Google Code:
11129 -.ft C
11130 +.ft
11131 [schemes]
11132 gcode = http://{1}.googlecode.com/hg/
11133 -.ft P
11134 +.ft
11137 The syntax is taken from Mercurial templates, and you have unlimited
11138 @@ -15028,7 +15000,7 @@
11139 For convenience, the extension adds these schemes by default:
11142 -.ft C
11143 +.ft
11144 [schemes]
11145 py = http://hg.python.org/
11146 bb = https://bitbucket.org/
11147 @@ -15035,7 +15007,7 @@
11148 bb+ssh = ssh://hg@bitbucket.org/
11149 gcode = https://{1}.googlecode.com/hg/
11150 kiln = https://{1}.kilnhg.com/Repo/
11151 -.ft P
11152 +.ft
11155 You can override a predefined scheme by defining a new scheme with the
11156 @@ -15046,19 +15018,19 @@
11157 share a common history between several working directories
11158 .SS Automatic Pooled Storage for Clones
11160 -When this extension is active, \%\fBhg clone\fP\: can be configured to
11161 +When this extension is active, \fBhg clone\fP can be configured to
11162 automatically share/pool storage across multiple clones. This
11163 -mode effectively converts \%\fBhg clone\fP\: to \%\fBhg clone\fP\: + \%\fBhg share\fP\:.
11164 +mode effectively converts \fBhg clone\fP to \fBhg clone\fP + \fBhg share\fP.
11165 The benefit of using this mode is the automatic management of
11166 store paths and intelligent pooling of related repositories.
11168 The following \fBshare.\fP config options influence this feature:
11169 -.INDENT 0.0
11170 +.RS 0
11172 .B \fBshare.pool\fP
11174 Filesystem path where shared repository data will be stored. When
11175 -defined, \%\fBhg clone\fP\: will automatically use shared repository
11176 +defined, \fBhg clone\fP will automatically use shared repository
11177 storage instead of creating a store inside each clone.
11179 .B \fBshare.poolnaming\fP
11180 @@ -15070,13 +15042,13 @@
11181 root/initial changeset is identical. In this mode, the local shared
11182 repository is an aggregate of all encountered remote repositories.
11184 -"remote" means the name is derived from the source repository\(aqs
11185 +"remote" means the name is derived from the source repository's
11186 path or URL. In this mode, storage is only shared if the path or URL
11187 -requested in the \%\fBhg clone\fP\: command matches exactly to a repository
11188 +requested in the \fBhg clone\fP command matches exactly to a repository
11189 that was cloned before.
11191 The default naming mode is "identity".
11192 -.UNINDENT
11193 +.RE
11194 .SS Commands
11195 .SS share
11197 @@ -15083,9 +15055,9 @@
11198 create a new shared repository:
11201 -.ft C
11202 +.ft
11203 hg share [\-U] [\-B] SOURCE [DEST]
11204 -.ft P
11205 +.ft
11208 Initialize a new repository and working directory that shares its
11209 @@ -15103,7 +15075,7 @@
11212 Options:
11213 -.INDENT 0.0
11214 +.RS 0
11216 .B \-U, \-\-noupdate
11218 @@ -15116,15 +15088,15 @@
11219 .B \-\-relative
11221 point to source using a relative path (EXPERIMENTAL)
11222 -.UNINDENT
11223 +.RE
11224 .SS unshare
11226 convert a shared repository to a normal one:
11229 -.ft C
11230 +.ft
11231 hg unshare
11232 -.ft P
11233 +.ft
11236 Copy the store data to the repo and remove the sharedpath data.
11237 @@ -15138,7 +15110,7 @@
11239 Later on, the "hg unshelve" command restores the changes saved by "hg
11240 shelve". Changes can be restored even after updating to a different
11241 -parent, in which case Mercurial\(aqs merge machinery will resolve any
11242 +parent, in which case Mercurial's merge machinery will resolve any
11243 conflicts if necessary.
11245 You can have more than one shelved change outstanding at a time; each
11246 @@ -15150,9 +15122,9 @@
11247 save and set aside changes from the working directory:
11250 -.ft C
11251 +.ft
11252 hg shelve [OPTION]... [FILE]...
11253 -.ft P
11254 +.ft
11257 Shelving takes files that "hg status" reports as not clean, saves
11258 @@ -15186,7 +15158,7 @@
11259 all shelved changes, use \fB\-\-cleanup\fP.
11261 Options:
11262 -.INDENT 0.0
11263 +.RS 0
11265 .B \-A, \-\-addremove
11267 @@ -15243,7 +15215,7 @@
11268 .BI \-X, \-\-exclude \ <PATTERN[+]>
11270 exclude names matching the given patterns
11271 -.UNINDENT
11272 +.RE
11274 [+] marked option can be specified multiple times
11275 .SS unshelve
11276 @@ -15251,9 +15223,9 @@
11277 restore a shelved change to the working directory:
11280 -.ft C
11281 +.ft
11282 hg unshelve [[\-n] SHELVED]
11283 -.ft P
11284 +.ft
11287 This command accepts an optional name of a shelved change to
11288 @@ -15288,7 +15260,7 @@
11289 prevents from deciding exact order of them, for safety.
11291 Options:
11292 -.INDENT 0.0
11293 +.RS 0
11295 .B \-a, \-\-abort
11297 @@ -15313,18 +15285,18 @@
11298 .BI \-\-date \ <DATE>
11300 set date for temporary commits (DEPRECATED)
11301 -.UNINDENT
11302 +.RE
11303 .SS show
11305 unified command to show various repository information (EXPERIMENTAL)
11307 -This extension provides the \%\fBhg show\fP\: command, which provides a central
11308 +This extension provides the \fBhg show\fP command, which provides a central
11309 command for displaying commonly\-accessed repository data and views of that
11310 data.
11312 The following config options can influence operation.
11313 .SS \fBcommands\fP
11314 -.INDENT 0.0
11315 +.RS 0
11317 .B \fBshow.aliasprefix\fP
11319 @@ -15334,7 +15306,7 @@
11321 Aliases that would conflict with existing registrations will not be
11322 performed.
11323 -.UNINDENT
11324 +.RE
11325 .SS Commands
11326 .SS show
11328 @@ -15341,9 +15313,9 @@
11329 show various repository information:
11332 -.ft C
11333 +.ft
11334 hg show VIEW
11335 -.ft P
11336 +.ft
11339 A requested view of repository data is displayed.
11340 @@ -15365,15 +15337,15 @@
11342 stack current line of work
11344 -work changesets that aren\(aqt finished
11345 +work changesets that aren't finished
11347 Options:
11348 -.INDENT 0.0
11349 +.RS 0
11351 .BI \-T, \-\-template \ <TEMPLATE>
11353 display with template
11354 -.UNINDENT
11355 +.RE
11356 .SS sparse
11358 allow sparse checkouts of the working directory (EXPERIMENTAL)
11359 @@ -15407,7 +15379,7 @@
11360 have \fB[include]\fP after \fB[exclude]\fP.
11362 Non\-special lines resemble file patterns to be added to either includes
11363 -or excludes. The syntax of these lines is documented by \%\fBhg help patterns\fP\:.
11364 +or excludes. The syntax of these lines is documented by \fBhg help patterns\fP.
11365 Patterns are interpreted as \fBglob:\fP by default and match against the
11366 root of the repository.
11368 @@ -15421,7 +15393,7 @@
11369 between both projects. Your sparse config files may resemble:
11372 -.ft C
11373 +.ft
11374 # frontend.sparse
11375 frontend/**
11376 tools/**
11377 @@ -15429,15 +15401,15 @@
11378 # backend.sparse
11379 backend/**
11380 tools/**
11381 -.ft P
11382 +.ft
11385 -Say the backend grows in size. Or there\(aqs a directory with thousands
11386 +Say the backend grows in size. Or there's a directory with thousands
11387 of files you wish to exclude. You can modify the profile to exclude
11388 certain files:
11391 -.ft C
11392 +.ft
11393 [include]
11394 backend/**
11395 tools/**
11396 @@ -15444,7 +15416,7 @@
11398 [exclude]
11399 tools/tests/**
11400 -.ft P
11401 +.ft
11403 .SS Commands
11404 .SS strip
11405 @@ -15459,9 +15431,9 @@
11406 strip changesets and all their descendants from the repository:
11409 -.ft C
11410 +.ft
11411 hg strip [\-k] [\-f] [\-B bookmark] [\-r] REV...
11412 -.ft P
11413 +.ft
11416 The strip command removes the specified changesets and all their
11417 @@ -15475,8 +15447,8 @@
11418 completes.
11420 Any stripped changesets are stored in \fB.hg/strip\-backup\fP as a
11421 -bundle (see \%\fBhg help bundle\fP\: and \%\fBhg help unbundle\fP\:). They can
11422 -be restored by running \%\fBhg unbundle .hg/strip\-backup/BUNDLE\fP\:,
11423 +bundle (see \fBhg help bundle\fP and \fBhg help unbundle\fP). They can
11424 +be restored by running \fBhg unbundle .hg/strip\-backup/BUNDLE\fP,
11425 where BUNDLE is the bundle file created by the strip. Note that
11426 the local revision numbers will in general be different after the
11427 restore.
11428 @@ -15491,7 +15463,7 @@
11429 Return 0 on success.
11431 Options:
11432 -.INDENT 0.0
11433 +.RS 0
11435 .BI \-r, \-\-rev \ <REV[+]>
11437 @@ -15520,7 +15492,7 @@
11438 .BI \-B, \-\-bookmark \ <VALUE[+]>
11440 remove revs only reachable from given bookmark
11441 -.UNINDENT
11442 +.RE
11444 [+] marked option can be specified multiple times
11445 .SS transplant
11446 @@ -15528,7 +15500,7 @@
11447 command to transplant changesets from another branch
11449 This extension allows you to transplant changes to another parent revision,
11450 -possibly in another repository. The transplant is done using \(aqdiff\(aq patches.
11451 +possibly in another repository. The transplant is done using 'diff' patches.
11453 Transplanted patches are recorded in .hg/transplant/transplants, as a
11454 map from a changeset hash to its hash in the source repository.
11455 @@ -15538,9 +15510,9 @@
11456 transplant changesets from another branch:
11459 -.ft C
11460 +.ft
11461 hg transplant [\-s REPO] [\-b BRANCH [\-a]] [\-p REV] [\-m REV] [REV]...
11462 -.ft P
11463 +.ft
11466 Selected changesets will be applied on top of the current working
11467 @@ -15557,9 +15529,9 @@
11468 of the form:
11471 -.ft C
11472 +.ft
11473 (transplanted from CHANGESETHASH)
11474 -.ft P
11475 +.ft
11478 You can rewrite the changelog message with the \-\-filter option.
11479 @@ -15575,17 +15547,17 @@
11480 with \-\-branch will be transplanted.
11482 Example:
11483 -.INDENT 0.0
11484 +.RS 0
11485 .IP \(bu 2
11487 transplant all changes up to REV on top of your current revision:
11490 -.ft C
11491 +.ft
11492 hg transplant \-\-branch REV \-\-all
11493 -.ft P
11494 +.ft
11496 -.UNINDENT
11497 +.RE
11499 You can optionally mark selected transplanted changesets as merge
11500 changesets. You will not be prompted to transplant any ancestors
11501 @@ -15593,17 +15565,17 @@
11502 normally instead of transplanting them.
11504 Merge changesets may be transplanted directly by specifying the
11505 -proper parent changeset by calling \%\fBhg transplant \-\-parent\fP\:.
11506 +proper parent changeset by calling \fBhg transplant \-\-parent\fP.
11508 -If no merges or revisions are provided, \%\fBhg transplant\fP\: will
11509 +If no merges or revisions are provided, \fBhg transplant\fP will
11510 start an interactive changeset browser.
11512 If a changeset application fails, you can fix the merge by hand
11513 -and then resume where you left off by calling \%\fBhg transplant
11514 -\-\-continue/\-c\fP\:.
11515 +and then resume where you left off by calling \fBhg transplant
11516 +\-\-continue/\-c\fP.
11518 Options:
11519 -.INDENT 0.0
11520 +.RS 0
11522 .BI \-s, \-\-source \ <REPO>
11524 @@ -15644,7 +15616,7 @@
11525 .BI \-\-filter \ <CMD>
11527 filter changesets through command
11528 -.UNINDENT
11529 +.RE
11531 [+] marked option can be specified multiple times
11532 .SS uncommit
11533 @@ -15661,9 +15633,9 @@
11534 uncommit part or all of a local changeset:
11537 -.ft C
11538 +.ft
11539 hg uncommit [OPTION]... [FILE]...
11540 -.ft P
11541 +.ft
11544 This command undoes the effect of a local commit, returning the affected
11545 @@ -15672,7 +15644,7 @@
11546 modified in the working directory.
11548 Options:
11549 -.INDENT 0.0
11550 +.RS 0
11552 .B \-\-keep
11554 @@ -15685,7 +15657,7 @@
11555 .BI \-X, \-\-exclude \ <PATTERN[+]>
11557 exclude names matching the given patterns
11558 -.UNINDENT
11559 +.RE
11561 [+] marked option can be specified multiple times
11562 .SS win32mbcs
11563 @@ -15700,7 +15672,7 @@
11564 operation.
11566 This extension is useful for:
11567 -.INDENT 0.0
11568 +.RS 0
11569 .IP \(bu 2
11571 Japanese Windows users using shift_jis encoding.
11572 @@ -15711,10 +15683,10 @@
11574 All users who use a repository with one of problematic encodings on
11575 case\-insensitive file system.
11576 -.UNINDENT
11577 +.RE
11579 This extension is not needed for:
11580 -.INDENT 0.0
11581 +.RS 0
11582 .IP \(bu 2
11584 Any user who use only ASCII chars in path.
11585 @@ -15721,10 +15693,10 @@
11586 .IP \(bu 2
11588 Any user who do not use any of problematic encodings.
11589 -.UNINDENT
11590 +.RE
11592 Note that there are some limitations on using this extension:
11593 -.INDENT 0.0
11594 +.RS 0
11595 .IP \(bu 2
11597 You should use single encoding in one repository.
11598 @@ -15734,16 +15706,16 @@
11599 .IP \(bu 2
11601 win32mbcs is not compatible with fixutf8 extension.
11602 -.UNINDENT
11603 +.RE
11605 By default, win32mbcs uses encoding.encoding decided by Mercurial.
11606 You can specify the encoding by config option:
11609 -.ft C
11610 +.ft
11611 [win32mbcs]
11612 encoding = sjis
11613 -.ft P
11614 +.ft
11617 It is useful for the users who want to commit with UTF\-8 log message.
11618 @@ -15750,8 +15722,8 @@
11619 .SS win32text
11621 perform automatic newline conversion (DEPRECATED)
11622 -.INDENT 0.0
11623 -.INDENT 3.5
11624 +.RS 0
11625 +.RS 3
11627 Deprecation: The win32text extension requires each user to configure
11628 the extension again and again for each clone since the configuration
11629 @@ -15760,13 +15732,13 @@
11630 We have therefore made the \fBeol\fP as an alternative. The \fBeol\fP
11631 uses a version controlled file for its configuration and each clone
11632 will therefore use the right settings from the start.
11633 -.UNINDENT
11634 -.UNINDENT
11635 +.RE
11636 +.RE
11638 To perform automatic newline conversion, use:
11641 -.ft C
11642 +.ft
11643 [extensions]
11644 win32text =
11645 [encode]
11646 @@ -15776,17 +15748,17 @@
11647 [decode]
11648 ** = cleverdecode:
11649 # or ** = macdecode:
11650 -.ft P
11651 +.ft
11654 If not doing conversion, to make sure you do not commit CRLF/CR by accident:
11657 -.ft C
11658 +.ft
11659 [hooks]
11660 pretxncommit.crlf = python:hgext.win32text.forbidcrlf
11661 # or pretxncommit.cr = python:hgext.win32text.forbidcr
11662 -.ft P
11663 +.ft
11666 To do the same check on a server to prevent CRLF/CR from being
11667 @@ -15793,11 +15765,11 @@
11668 pushed or pulled:
11671 -.ft C
11672 +.ft
11673 [hooks]
11674 pretxnchangegroup.crlf = python:hgext.win32text.forbidcrlf
11675 # or pretxnchangegroup.cr = python:hgext.win32text.forbidcr
11676 -.ft P
11677 +.ft
11679 .SS zeroconf
11681 @@ -15808,33 +15780,33 @@
11682 without knowing their actual IP address.
11684 To allow other people to discover your repository using run
11685 -\%\fBhg serve\fP\: in your repository:
11686 +\fBhg serve\fP in your repository:
11689 -.ft C
11690 +.ft
11691 $ cd test
11692 $ hg serve
11693 -.ft P
11694 +.ft
11697 You can discover Zeroconf\-enabled repositories by running
11698 -\%\fBhg paths\fP\::
11699 +\fBhg paths\fP:
11702 -.ft C
11703 +.ft
11704 $ hg paths
11705 zc\-test = http://example.com:8000/test
11706 -.ft P
11707 +.ft
11709 .SH FILES
11710 -.INDENT 0.0
11711 +.RS 0
11713 .B \fB/etc/mercurial/hgrc\fP, \fB$HOME/.hgrc\fP, \fB.hg/hgrc\fP
11715 This file contains defaults and configuration. Values in
11716 -\fB.hg/hgrc\fP override those in \fB$HOME/.hgrc\fP, and these override
11717 +\fB\&.hg/hgrc\fP override those in \fB$HOME/.hgrc\fP, and these override
11718 settings made in the global \fB/etc/mercurial/hgrc\fP configuration.
11719 -See \%\fBhgrc\fP(5)\: for details of the contents and format of these
11720 +See \fBhgrc\fP(5) for details of the contents and format of these
11721 files.
11723 .B \fB.hgignore\fP
11724 @@ -15841,13 +15813,13 @@
11726 This file contains regular expressions (one per line) that
11727 describe file names that should be ignored by \fBhg\fP. For details,
11728 -see \%\fBhgignore\fP(5)\:.
11729 +see \fBhgignore\fP(5).
11731 .B \fB.hgsub\fP
11733 This file defines the locations of all subrepositories, and
11734 tells where the subrepository checkouts came from. For details, see
11735 -\%\fBhg help subrepos\fP\:.
11736 +\fBhg help subrepos\fP.
11738 .B \fB.hgsubstate\fP
11740 @@ -15862,7 +15834,7 @@
11742 .B \fB.hg/last\-message.txt\fP
11744 -This file is used by \%\fBhg commit\fP\: to store a backup of the commit message
11745 +This file is used by \fBhg commit\fP to store a backup of the commit message
11746 in case the commit fails.
11748 .B \fB.hg/localtags\fP
11749 @@ -15870,28 +15842,34 @@
11750 This file can be used to define local tags which are not shared among
11751 repositories. The file format is the same as for \fB.hgtags\fP, but it is
11752 encoded using the local system encoding.
11753 -.UNINDENT
11754 +.TP
11755 +.B \fB/usr/demo/mercurial\fP
11757 +This directory contains assorted files which are part of the Mercurial
11758 +distribution, but not core to its functionality. They will generally
11759 +need to be copied elsewhere to be of use.
11760 +.RE
11761 +.sp
11762 Some commands (e.g. revert) produce backup files ending in \fB.orig\fP,
11763 if the \fB.orig\fP file already exists and is not tracked by Mercurial,
11764 it will be overwritten.
11765 .SH BUGS
11767 -Probably lots, please post them to the mailing list (see \%Resources\:
11768 +Probably lots, please post them to the mailing list (see Resources
11769 below) when you find them.
11770 .SH SEE ALSO
11772 -\%\fBhgignore\fP(5)\:, \%\fBhgrc\fP(5)\:
11773 +\fBhgignore\fP(5), \fBhgrc\fP(5)
11774 .SH AUTHOR
11776 -Written by Matt Mackall <\%mpm@selenic.com\:>
11777 +Written by Matt Mackall <mpm@selenic.com>
11778 .SH RESOURCES
11780 -Main Web Site: \%https://mercurial\-scm.org/\:
11781 +Main Web Site: https://mercurial\-scm.org/
11783 -Source code repository: \%https://www.mercurial\-scm.org/repo/hg\:
11784 +Source code repository: https://www.mercurial\-scm.org/repo/hg
11786 -Mailing list: \%https://www.mercurial\-scm.org/mailman/listinfo/mercurial/\:
11787 +Mailing list: https://www.mercurial\-scm.org/mailman/listinfo/mercurial/
11788 .SH COPYING
11790 Copyright (C) 2005\-2017 Matt Mackall.
11791 --- mercurial-4.4/doc/hgignore.5.orig Thu Nov 2 00:54:44 2017
11792 +++ mercurial-4.4/doc/hgignore.5 Thu Nov 2 09:06:20 2017
11793 @@ -3,33 +3,6 @@
11794 .TH HGIGNORE 5 "" "" "Mercurial Manual"
11795 .SH NAME
11796 hgignore \- syntax for Mercurial ignore files
11798 -.nr rst2man-indent-level 0
11800 -.de1 rstReportMargin
11801 -\\$1 \\n[an-margin]
11802 -level \\n[rst2man-indent-level]
11803 -level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
11805 -\\n[rst2man-indent0]
11806 -\\n[rst2man-indent1]
11807 -\\n[rst2man-indent2]
11809 -.de1 INDENT
11810 -.\" .rstReportMargin pre:
11811 -. RS \\$1
11812 -. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
11813 -. nr rst2man-indent-level +1
11814 -.\" .rstReportMargin post:
11816 -.de UNINDENT
11817 -. RE
11818 -.\" indent \\n[an-margin]
11819 -.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
11820 -.nr rst2man-indent-level -1
11821 -.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
11822 -.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
11824 .SH SYNOPSIS
11826 The Mercurial system uses a file called \fB.hgignore\fP in the root
11827 @@ -55,16 +28,16 @@
11829 In addition, a Mercurial configuration file can reference a set of
11830 per\-user or global ignore files. See the \fBignore\fP configuration
11831 -key on the \fB[ui]\fP section of \%\fBhg help config\fP\: for details of how to
11832 +key on the \fB[ui]\fP section of \fBhg help config\fP for details of how to
11833 configure these files.
11835 -To control Mercurial\(aqs handling of files that it manages, many
11836 +To control Mercurial's handling of files that it manages, many
11837 commands support the \fB\-I\fP and \fB\-X\fP options; see
11838 -\%\fBhg help <command>\fP\: and \%\fBhg help patterns\fP\: for details.
11839 +\fBhg help <command>\fP and \fBhg help patterns\fP for details.
11841 Files that are already tracked are not affected by .hgignore, even
11842 if they appear in .hgignore. An untracked file X can be explicitly
11843 -added with \%\fBhg add X\fP\:, even if X would be excluded by a pattern
11844 +added with \fBhg add X\fP, even if X would be excluded by a pattern
11845 in .hgignore.
11846 .SH SYNTAX
11848 @@ -79,13 +52,13 @@
11849 To change the syntax used, use a line of the following form:
11852 -.ft C
11853 +.ft
11854 syntax: NAME
11855 -.ft P
11856 +.ft
11859 where \fBNAME\fP is one of the following:
11860 -.INDENT 0.0
11861 +.RS 0
11863 .B \fBregexp\fP
11865 @@ -94,7 +67,7 @@
11866 .B \fBglob\fP
11868 Shell\-style glob.
11869 -.UNINDENT
11870 +.RE
11872 The chosen syntax stays in effect when parsing all patterns that
11873 follow, until another syntax is selected.
11874 @@ -106,11 +79,11 @@
11876 Subdirectories can have their own .hgignore settings by adding
11877 \fBsubinclude:path/to/subdir/.hgignore\fP to the root \fB.hgignore\fP. See
11878 -\%\fBhg help patterns\fP\: for details on \fBsubinclude:\fP and \fBinclude:\fP.
11879 +\fBhg help patterns\fP for details on \fBsubinclude:\fP and \fBinclude:\fP.
11880 .IP Note
11882 Patterns specified in other than \fB.hgignore\fP are always rooted.
11883 -Please see \%\fBhg help patterns\fP\: for details.
11884 +Please see \fBhg help patterns\fP for details.
11886 .SH EXAMPLE
11888 @@ -117,7 +90,7 @@
11889 Here is an example ignore file.
11892 -.ft C
11893 +.ft
11894 # use glob syntax.
11895 syntax: glob
11897 @@ -128,16 +101,16 @@
11898 # switch to regexp syntax.
11899 syntax: regexp
11900 ^\e.pc/
11901 -.ft P
11902 +.ft
11904 .SH AUTHOR
11906 -Vadim Gelfer <\%vadim.gelfer@gmail.com\:>
11907 +Vadim Gelfer <vadim.gelfer@gmail.com>
11909 -Mercurial was written by Matt Mackall <\%mpm@selenic.com\:>.
11910 +Mercurial was written by Matt Mackall <mpm@selenic.com>.
11911 .SH SEE ALSO
11913 -\%\fBhg\fP(1)\:, \%\fBhgrc\fP(5)\:
11914 +\fBhg\fP(1), \fBhgrc\fP(5)
11915 .SH COPYING
11917 This manual page is copyright 2006 Vadim Gelfer.
11918 --- mercurial-4.4/doc/hgrc.5.orig Thu Nov 2 00:54:45 2017
11919 +++ mercurial-4.4/doc/hgrc.5 Thu Nov 2 09:06:20 2017
11920 @@ -3,33 +3,6 @@
11921 .TH HGRC 5 "" "" "Mercurial Manual"
11922 .SH NAME
11923 hgrc \- configuration files for Mercurial
11925 -.nr rst2man-indent-level 0
11927 -.de1 rstReportMargin
11928 -\\$1 \\n[an-margin]
11929 -level \\n[rst2man-indent-level]
11930 -level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
11932 -\\n[rst2man-indent0]
11933 -\\n[rst2man-indent1]
11934 -\\n[rst2man-indent2]
11936 -.de1 INDENT
11937 -.\" .rstReportMargin pre:
11938 -. RS \\$1
11939 -. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
11940 -. nr rst2man-indent-level +1
11941 -.\" .rstReportMargin post:
11943 -.de UNINDENT
11944 -. RE
11945 -.\" indent \\n[an-margin]
11946 -.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
11947 -.nr rst2man-indent-level -1
11948 -.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
11949 -.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
11951 .SH DESCRIPTION
11953 The Mercurial system uses a set of configuration files to control
11954 @@ -36,11 +9,11 @@
11955 aspects of its behavior.
11956 .SH TROUBLESHOOTING
11958 -If you\(aqre having problems with your configuration,
11959 -\%\fBhg config \-\-debug\fP\: can help you understand what is introducing
11960 +If you're having problems with your configuration,
11961 +\fBhg config \-\-debug\fP can help you understand what is introducing
11962 a setting into your environment.
11964 -See \%\fBhg help config.syntax\fP\: and \%\fBhg help config.files\fP\:
11965 +See \fBhg help config.syntax\fP and \fBhg help config.files\fP
11966 for information about how and where to override things.
11967 .SH STRUCTURE
11969 @@ -49,15 +22,15 @@
11970 by \fBname = value\fP entries:
11973 -.ft C
11974 +.ft
11975 [ui]
11976 username = Firstname Lastname <firstname.lastname@example.net>
11977 verbose = True
11978 -.ft P
11979 +.ft
11982 The above entries will be referred to as \fBui.username\fP and
11983 -\fBui.verbose\fP, respectively. See \%\fBhg help config.syntax\fP\:.
11984 +\fBui.verbose\fP, respectively. See \fBhg help config.syntax\fP.
11985 .SH FILES
11987 Mercurial reads configuration data from several files, if they exist.
11988 @@ -67,16 +40,11 @@
11989 Local configuration is put into the per\-repository \fB<repo>/.hg/hgrc\fP file.
11991 Global configuration like the username setting is typically put into:
11992 -.INDENT 0.0
11993 +.RS 0
11994 .IP \(bu 2
11996 -\fB%USERPROFILE%\emercurial.ini\fP (on Windows)
11997 -.UNINDENT
11998 -.INDENT 0.0
11999 -.IP \(bu 2
12001 \fB$HOME/.hgrc\fP (on Unix, Plan9)
12002 -.UNINDENT
12003 +.RE
12005 The names of these files depend on the system on which Mercurial is
12006 installed. \fB*.rc\fP files from a single directory are read in
12007 @@ -84,8 +52,8 @@
12008 paths are given below, settings from earlier paths override later
12009 ones.
12011 -On Unix, the following files are consulted:
12012 -.INDENT 0.0
12013 +The following files are consulted:
12014 +.RS 0
12015 .IP \(bu 2
12017 \fB<repo>/.hg/hgrc\fP (per\-repository)
12018 @@ -110,79 +78,16 @@
12019 .IP \(bu 2
12021 \fB<internal>/default.d/*.rc\fP (defaults)
12022 -.UNINDENT
12023 -.sp
12024 -On Windows, the following files are consulted:
12025 -.INDENT 0.0
12026 -.IP \(bu 2
12028 -\fB<repo>/.hg/hgrc\fP (per\-repository)
12029 -.IP \(bu 2
12031 -\fB%USERPROFILE%\e.hgrc\fP (per\-user)
12032 -.IP \(bu 2
12034 -\fB%USERPROFILE%\eMercurial.ini\fP (per\-user)
12035 -.IP \(bu 2
12037 -\fB%HOME%\e.hgrc\fP (per\-user)
12038 -.IP \(bu 2
12040 -\fB%HOME%\eMercurial.ini\fP (per\-user)
12041 -.IP \(bu 2
12043 -\fBHKEY_LOCAL_MACHINE\eSOFTWARE\eMercurial\fP (per\-installation)
12044 -.IP \(bu 2
12046 -\fB<install\-dir>\ehgrc.d\e*.rc\fP (per\-installation)
12047 -.IP \(bu 2
12049 -\fB<install\-dir>\eMercurial.ini\fP (per\-installation)
12050 -.IP \(bu 2
12052 -\fB<internal>/default.d/*.rc\fP (defaults)
12053 -.UNINDENT
12054 -.IP Note
12056 -The registry key \fBHKEY_LOCAL_MACHINE\eSOFTWARE\eWow6432Node\eMercurial\fP
12057 -is used when running 32\-bit Python on 64\-bit Windows.
12060 -On Windows 9x, \fB%HOME%\fP is replaced by \fB%APPDATA%\fP.
12061 -.sp
12062 -On Plan9, the following files are consulted:
12063 -.INDENT 0.0
12064 -.IP \(bu 2
12066 -\fB<repo>/.hg/hgrc\fP (per\-repository)
12067 -.IP \(bu 2
12069 -\fB$home/lib/hgrc\fP (per\-user)
12070 -.IP \(bu 2
12072 -\fB<install\-root>/lib/mercurial/hgrc\fP (per\-installation)
12073 -.IP \(bu 2
12075 -\fB<install\-root>/lib/mercurial/hgrc.d/*.rc\fP (per\-installation)
12076 -.IP \(bu 2
12078 -\fB/lib/mercurial/hgrc\fP (per\-system)
12079 -.IP \(bu 2
12081 -\fB/lib/mercurial/hgrc.d/*.rc\fP (per\-system)
12082 -.IP \(bu 2
12084 -\fB<internal>/default.d/*.rc\fP (defaults)
12085 -.UNINDENT
12086 -.sp
12087 Per\-repository configuration options only apply in a
12088 particular repository. This file is not version\-controlled, and
12089 will not get transferred during a "clone" operation. Options in
12090 this file override options in all other configuration files.
12092 -On Plan 9 and Unix, most of this file will be ignored if it doesn\(aqt
12093 +On Unix, most of this file will be ignored if it doesn't
12094 belong to a trusted user or to a trusted group. See
12095 -\%\fBhg help config.trusted\fP\: for more details.
12096 +\fBhg help config.trusted\fP for more details.
12098 Per\-user configuration file(s) are for the user running Mercurial. Options
12099 in these files apply to all Mercurial commands executed by this user in any
12100 @@ -200,10 +105,8 @@
12102 Per\-installation configuration files are for the system on
12103 which Mercurial is running. Options in these files apply to all
12104 -Mercurial commands executed by any user in any directory. Registry
12105 -keys contain PATH\-like strings, every part of which must reference
12106 -a \fBMercurial.ini\fP file or be a directory where \fB*.rc\fP files will
12107 -be read. Mercurial checks each of these locations in the specified
12108 +Mercurial commands executed by any user in any directory.
12109 +Mercurial checks each of these locations in the specified
12110 order until one or more configuration files are detected.
12112 Per\-system configuration files are for the system on which Mercurial
12113 @@ -224,12 +127,12 @@
12114 \fBconfiguration keys\fP):
12117 -.ft C
12118 +.ft
12119 [spam]
12120 eggs=ham
12121 green=
12122 eggs
12123 -.ft P
12124 +.ft
12127 Each line contains one entry. If the lines that follow are indented,
12128 @@ -241,12 +144,12 @@
12129 will use the value that was configured last. As an example:
12132 -.ft C
12133 +.ft
12134 [spam]
12135 eggs=large
12136 ham=serrano
12137 eggs=small
12138 -.ft P
12139 +.ft
12142 This would set the configuration key named \fBeggs\fP to \fBsmall\fP.
12143 @@ -256,7 +159,7 @@
12144 example:
12147 -.ft C
12148 +.ft
12149 [foo]
12150 eggs=large
12151 ham=serrano
12152 @@ -271,7 +174,7 @@
12153 ham=prosciutto
12154 eggs=medium
12155 bread=toasted
12156 -.ft P
12157 +.ft
12160 This would set the \fBeggs\fP, \fBham\fP, and \fBbread\fP configuration keys
12161 @@ -293,9 +196,9 @@
12162 \fBfile\fP. This lets you do something like:
12165 -.ft C
12166 +.ft
12167 %include ~/.hgrc.d/$HOST.rc
12168 -.ft P
12169 +.ft
12172 to include a different configuration file on each computer you use.
12173 @@ -312,9 +215,9 @@
12174 placed in double quotation marks:
12177 -.ft C
12178 +.ft
12179 allow_read = "John Doe, PhD", brian, betty
12180 -.ft P
12181 +.ft
12184 Quotation marks can be escaped by prefixing them with a backslash. Only
12185 @@ -339,17 +242,17 @@
12186 Alias definitions consist of lines of the form:
12189 -.ft C
12190 +.ft
12191 <alias> = <command> [<argument>]...
12192 -.ft P
12193 +.ft
12196 For example, this definition:
12199 -.ft C
12200 +.ft
12201 latest = log \-\-limit 5
12202 -.ft P
12203 +.ft
12206 creates a new command \fBlatest\fP that shows only the five most recent
12207 @@ -356,9 +259,9 @@
12208 changesets. You can define subsequent aliases using earlier ones:
12211 -.ft C
12212 +.ft
12213 stable5 = latest \-b stable
12214 -.ft P
12215 +.ft
12217 .IP Note
12219 @@ -372,9 +275,9 @@
12220 run arbitrary commands. As an example,
12223 -.ft C
12224 +.ft
12225 echo = !echo $@
12226 -.ft P
12227 +.ft
12230 will let you do \fBhg echo foo\fP to have \fBfoo\fP printed in your
12231 @@ -381,9 +284,9 @@
12232 terminal. A better example might be:
12235 -.ft C
12236 +.ft
12237 purge = !$HG status \-\-no\-status \-\-unknown \-0 re: | xargs \-0 rm \-f
12238 -.ft P
12239 +.ft
12242 which will make \fBhg purge\fP delete all unknown files in the
12243 @@ -411,9 +314,9 @@
12244 .SS \fBannotate\fP
12246 Settings used when displaying file annotations. All values are
12247 -Booleans and default to False. See \%\fBhg help config.diff\fP\: for
12248 +Booleans and default to False. See \fBhg help config.diff\fP for
12249 related options for the diff command.
12250 -.INDENT 0.0
12251 +.RS 0
12253 .B \fBignorews\fP
12255 @@ -430,17 +333,17 @@
12256 .B \fBignoreblanklines\fP
12258 Ignore changes whose lines are all blank.
12259 -.UNINDENT
12260 +.RE
12261 .SS \fBauth\fP
12263 Authentication credentials and other authentication\-like configuration
12264 for HTTP connections. This section allows you to store usernames and
12265 passwords for use when logging \fIinto\fP HTTP servers. See
12266 -\%\fBhg help config.web\fP\: if you want to configure \fIwho\fP can login to
12267 +\fBhg help config.web\fP if you want to configure \fIwho\fP can login to
12268 your HTTP server.
12270 The following options apply to all hosts.
12271 -.INDENT 0.0
12272 +.RS 0
12274 .B \fBcookiefile\fP
12276 @@ -458,15 +361,15 @@
12277 This could result in a cookie being disclosed to an unwanted server.
12279 The cookies file is read\-only.
12280 -.UNINDENT
12281 +.RE
12283 Other options in this section are grouped by name and have the following
12284 format:
12287 -.ft C
12288 +.ft
12289 <name>.<argument> = <value>
12290 -.ft P
12291 +.ft
12294 where \fB<name>\fP is used to group arguments into authentication
12295 @@ -473,7 +376,7 @@
12296 entries. Example:
12299 -.ft C
12300 +.ft
12301 foo.prefix = hg.intevation.de/mercurial
12302 foo.username = foo
12303 foo.password = bar
12304 @@ -483,11 +386,11 @@
12305 bar.key = path/to/file.key
12306 bar.cert = path/to/file.cert
12307 bar.schemes = https
12308 -.ft P
12309 +.ft
12312 Supported arguments:
12313 -.INDENT 0.0
12314 +.RS 0
12316 .B \fBprefix\fP
12318 @@ -494,7 +397,7 @@
12319 Either \fB*\fP or a URI prefix with or without the scheme part.
12320 The authentication entry with the longest matching prefix is used
12321 (where \fB*\fP matches everything and counts as a match of length
12322 -1). If the prefix doesn\(aqt include a scheme, the match is performed
12323 +1). If the prefix doesn't include a scheme, the match is performed
12324 against the URI with its scheme stripped as well, and the schemes
12325 argument, q.v., is then subsequently consulted.
12327 @@ -526,11 +429,11 @@
12328 .B \fBschemes\fP
12330 Optional. Space separated list of URI schemes to use this
12331 -authentication entry with. Only used if the prefix doesn\(aqt include
12332 +authentication entry with. Only used if the prefix doesn't include
12333 a scheme. Supported schemes are http and https. They will match
12334 static\-http and static\-https respectively, as well.
12335 (default: https)
12336 -.UNINDENT
12337 +.RE
12339 If no suitable authentication entry is found, the user is prompted
12340 for credentials as usual if required by the remote.
12341 @@ -537,8 +440,8 @@
12342 .SS \fBcolor\fP
12344 Configure the Mercurial color mode. For details about how to define your custom
12345 -effect and style see \%\fBhg help color\fP\:.
12346 -.INDENT 0.0
12347 +effect and style see \fBhg help color\fP.
12348 +.RS 0
12350 .B \fBmode\fP
12352 @@ -554,7 +457,7 @@
12353 On some systems, terminfo mode may cause problems when using
12354 color with \fBless \-R\fP as a pager program. less with the \-R option
12355 will only display ECMA\-48 color codes, and terminfo mode may sometimes
12356 -emit codes that less doesn\(aqt understand. You can work around this by
12357 +emit codes that less doesn't understand. You can work around this by
12358 either using ansi mode (or auto mode), or by using less \-r (which will
12359 pass through all terminal control codes, not just color control
12360 codes).
12361 @@ -561,18 +464,18 @@
12363 On some systems (such as MSYS in Windows), the terminal may support
12364 a different color mode than the pager program.
12365 -.UNINDENT
12366 +.RE
12367 .SS \fBcommands\fP
12368 -.INDENT 0.0
12369 +.RS 0
12371 .B \fBstatus.relative\fP
12373 -Make paths in \%\fBhg status\fP\: output relative to the current directory.
12374 +Make paths in \fBhg status\fP output relative to the current directory.
12375 (default: False)
12377 .B \fBupdate.check\fP
12379 -Determines what level of checking \%\fBhg update\fP\: will perform before moving
12380 +Determines what level of checking \fBhg update\fP will perform before moving
12381 to a destination revision. Valid values are \fBabort\fP, \fBnone\fP,
12382 \fBlinear\fP, and \fBnoconflict\fP. \fBabort\fP always fails if the working
12383 directory has uncommitted changes. \fBnone\fP performs no checking, and may
12384 @@ -585,67 +488,67 @@
12386 .B \fBupdate.requiredest\fP
12388 -Require that the user pass a destination when running \%\fBhg update\fP\:.
12389 -For example, \%\fBhg update .::\fP\: will be allowed, but a plain \%\fBhg update\fP\:
12390 +Require that the user pass a destination when running \fBhg update\fP.
12391 +For example, \fBhg update .::\fP will be allowed, but a plain \fBhg update\fP
12392 will be disallowed.
12393 (default: False)
12394 -.UNINDENT
12395 +.RE
12396 .SS \fBcommittemplate\fP
12397 -.INDENT 0.0
12398 +.RS 0
12400 .B \fBchangeset\fP
12402 String: configuration in this section is used as the template to
12403 customize the text shown in the editor when committing.
12404 -.UNINDENT
12405 +.RE
12407 In addition to pre\-defined template keywords, commit log specific one
12408 below can be used for customization:
12409 -.INDENT 0.0
12410 +.RS 0
12412 .B \fBextramsg\fP
12414 -String: Extra message (typically \(aqLeave message empty to abort
12415 -commit.\(aq). This may be changed by some commands or extensions.
12416 -.UNINDENT
12417 +String: Extra message (typically 'Leave message empty to abort
12418 +commit.'). This may be changed by some commands or extensions.
12419 +.RE
12421 For example, the template configuration below shows as same text as
12422 one shown by default:
12425 -.ft C
12426 +.ft
12427 [committemplate]
12428 changeset = {desc}\en\en
12429 - HG: Enter commit message. Lines beginning with \(aqHG:\(aq are removed.
12430 + HG: Enter commit message. Lines beginning with 'HG:' are removed.
12431 HG: {extramsg}
12432 HG: \-\-
12433 HG: user: {author}\en{ifeq(p2rev, "\-1", "",
12434 "HG: branch merge\en")
12435 - }HG: branch \(aq{branch}\(aq\en{if(activebookmark,
12436 - "HG: bookmark \(aq{activebookmark}\(aq\en") }{subrepos %
12437 + }HG: branch '{branch}'\en{if(activebookmark,
12438 + "HG: bookmark '{activebookmark}'\en") }{subrepos %
12439 "HG: subrepo {subrepo}\en" }{file_adds %
12440 "HG: added {file}\en" }{file_mods %
12441 "HG: changed {file}\en" }{file_dels %
12442 "HG: removed {file}\en" }{if(files, "",
12443 "HG: no files changed\en")}
12444 -.ft P
12445 +.ft
12447 -.INDENT 0.0
12448 +.RS 0
12450 .B \fBdiff()\fP
12452 -String: show the diff (see \%\fBhg help templates\fP\: for detail)
12453 -.UNINDENT
12454 +String: show the diff (see \fBhg help templates\fP for detail)
12455 +.RE
12457 Sometimes it is helpful to show the diff of the changeset in the editor without
12458 -having to prefix \(aqHG: \(aq to each line so that highlighting works correctly. For
12459 +having to prefix 'HG: ' to each line so that highlighting works correctly. For
12460 this, Mercurial provides a special string which will ignore everything below
12464 -.ft C
12465 +.ft
12466 HG: \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- >8 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
12467 -.ft P
12468 +.ft
12471 For example, the template configuration below will show the diff below the
12472 @@ -652,158 +555,158 @@
12473 extra message:
12476 -.ft C
12477 +.ft
12478 [committemplate]
12479 changeset = {desc}\en\en
12480 - HG: Enter commit message. Lines beginning with \(aqHG:\(aq are removed.
12481 + HG: Enter commit message. Lines beginning with 'HG:' are removed.
12482 HG: {extramsg}
12483 HG: \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- >8 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
12484 HG: Do not touch the line above.
12485 HG: Everything below will be removed.
12486 {diff()}
12487 -.ft P
12488 +.ft
12490 .IP Note
12492 -For some problematic encodings (see \%\fBhg help win32mbcs\fP\: for
12493 +For some problematic encodings (see \fBhg help win32mbcs\fP for
12494 detail), this customization should be configured carefully, to
12495 avoid showing broken characters.
12497 For example, if a multibyte character ending with backslash (0x5c) is
12498 -followed by the ASCII character \(aqn\(aq in the customized template,
12499 -the sequence of backslash and \(aqn\(aq is treated as line\-feed unexpectedly
12500 +followed by the ASCII character 'n' in the customized template,
12501 +the sequence of backslash and 'n' is treated as line\-feed unexpectedly
12502 (and the multibyte character is broken, too).
12505 Customized template is used for commands below (\fB\-\-edit\fP may be
12506 required):
12507 -.INDENT 0.0
12508 +.RS 0
12509 .IP \(bu 2
12511 -\%\fBhg backout\fP\:
12512 +\fBhg backout\fP
12513 .IP \(bu 2
12515 -\%\fBhg commit\fP\:
12516 +\fBhg commit\fP
12517 .IP \(bu 2
12519 -\%\fBhg fetch\fP\: (for merge commit only)
12520 +\fBhg fetch\fP (for merge commit only)
12521 .IP \(bu 2
12523 -\%\fBhg graft\fP\:
12524 +\fBhg graft\fP
12525 .IP \(bu 2
12527 -\%\fBhg histedit\fP\:
12528 +\fBhg histedit\fP
12529 .IP \(bu 2
12531 -\%\fBhg import\fP\:
12532 +\fBhg import\fP
12533 .IP \(bu 2
12535 -\%\fBhg qfold\fP\:, \%\fBhg qnew\fP\: and \%\fBhg qrefresh\fP\:
12536 +\fBhg qfold\fP, \fBhg qnew\fP and \fBhg qrefresh\fP
12537 .IP \(bu 2
12539 -\%\fBhg rebase\fP\:
12540 +\fBhg rebase\fP
12541 .IP \(bu 2
12543 -\%\fBhg shelve\fP\:
12544 +\fBhg shelve\fP
12545 .IP \(bu 2
12547 -\%\fBhg sign\fP\:
12548 +\fBhg sign\fP
12549 .IP \(bu 2
12551 -\%\fBhg tag\fP\:
12552 +\fBhg tag\fP
12553 .IP \(bu 2
12555 -\%\fBhg transplant\fP\:
12556 -.UNINDENT
12557 +\fBhg transplant\fP
12558 +.RE
12560 Configuring items below instead of \fBchangeset\fP allows showing
12561 customized message only for specific actions, or showing different
12562 messages for each action.
12563 -.INDENT 0.0
12564 +.RS 0
12565 .IP \(bu 2
12567 -\fBchangeset.backout\fP for \%\fBhg backout\fP\:
12568 +\fBchangeset.backout\fP for \fBhg backout\fP
12569 .IP \(bu 2
12571 -\fBchangeset.commit.amend.merge\fP for \%\fBhg commit \-\-amend\fP\: on merges
12572 +\fBchangeset.commit.amend.merge\fP for \fBhg commit \-\-amend\fP on merges
12573 .IP \(bu 2
12575 -\fBchangeset.commit.amend.normal\fP for \%\fBhg commit \-\-amend\fP\: on other
12576 +\fBchangeset.commit.amend.normal\fP for \fBhg commit \-\-amend\fP on other
12577 .IP \(bu 2
12579 -\fBchangeset.commit.normal.merge\fP for \%\fBhg commit\fP\: on merges
12580 +\fBchangeset.commit.normal.merge\fP for \fBhg commit\fP on merges
12581 .IP \(bu 2
12583 -\fBchangeset.commit.normal.normal\fP for \%\fBhg commit\fP\: on other
12584 +\fBchangeset.commit.normal.normal\fP for \fBhg commit\fP on other
12585 .IP \(bu 2
12587 -\fBchangeset.fetch\fP for \%\fBhg fetch\fP\: (impling merge commit)
12588 +\fBchangeset.fetch\fP for \fBhg fetch\fP (impling merge commit)
12589 .IP \(bu 2
12591 -\fBchangeset.gpg.sign\fP for \%\fBhg sign\fP\:
12592 +\fBchangeset.gpg.sign\fP for \fBhg sign\fP
12593 .IP \(bu 2
12595 -\fBchangeset.graft\fP for \%\fBhg graft\fP\:
12596 +\fBchangeset.graft\fP for \fBhg graft\fP
12597 .IP \(bu 2
12599 -\fBchangeset.histedit.edit\fP for \fBedit\fP of \%\fBhg histedit\fP\:
12600 +\fBchangeset.histedit.edit\fP for \fBedit\fP of \fBhg histedit\fP
12601 .IP \(bu 2
12603 -\fBchangeset.histedit.fold\fP for \fBfold\fP of \%\fBhg histedit\fP\:
12604 +\fBchangeset.histedit.fold\fP for \fBfold\fP of \fBhg histedit\fP
12605 .IP \(bu 2
12607 -\fBchangeset.histedit.mess\fP for \fBmess\fP of \%\fBhg histedit\fP\:
12608 +\fBchangeset.histedit.mess\fP for \fBmess\fP of \fBhg histedit\fP
12609 .IP \(bu 2
12611 -\fBchangeset.histedit.pick\fP for \fBpick\fP of \%\fBhg histedit\fP\:
12612 +\fBchangeset.histedit.pick\fP for \fBpick\fP of \fBhg histedit\fP
12613 .IP \(bu 2
12615 -\fBchangeset.import.bypass\fP for \%\fBhg import \-\-bypass\fP\:
12616 +\fBchangeset.import.bypass\fP for \fBhg import \-\-bypass\fP
12617 .IP \(bu 2
12619 -\fBchangeset.import.normal.merge\fP for \%\fBhg import\fP\: on merges
12620 +\fBchangeset.import.normal.merge\fP for \fBhg import\fP on merges
12621 .IP \(bu 2
12623 -\fBchangeset.import.normal.normal\fP for \%\fBhg import\fP\: on other
12624 +\fBchangeset.import.normal.normal\fP for \fBhg import\fP on other
12625 .IP \(bu 2
12627 -\fBchangeset.mq.qnew\fP for \%\fBhg qnew\fP\:
12628 +\fBchangeset.mq.qnew\fP for \fBhg qnew\fP
12629 .IP \(bu 2
12631 -\fBchangeset.mq.qfold\fP for \%\fBhg qfold\fP\:
12632 +\fBchangeset.mq.qfold\fP for \fBhg qfold\fP
12633 .IP \(bu 2
12635 -\fBchangeset.mq.qrefresh\fP for \%\fBhg qrefresh\fP\:
12636 +\fBchangeset.mq.qrefresh\fP for \fBhg qrefresh\fP
12637 .IP \(bu 2
12639 -\fBchangeset.rebase.collapse\fP for \%\fBhg rebase \-\-collapse\fP\:
12640 +\fBchangeset.rebase.collapse\fP for \fBhg rebase \-\-collapse\fP
12641 .IP \(bu 2
12643 -\fBchangeset.rebase.merge\fP for \%\fBhg rebase\fP\: on merges
12644 +\fBchangeset.rebase.merge\fP for \fBhg rebase\fP on merges
12645 .IP \(bu 2
12647 -\fBchangeset.rebase.normal\fP for \%\fBhg rebase\fP\: on other
12648 +\fBchangeset.rebase.normal\fP for \fBhg rebase\fP on other
12649 .IP \(bu 2
12651 -\fBchangeset.shelve.shelve\fP for \%\fBhg shelve\fP\:
12652 +\fBchangeset.shelve.shelve\fP for \fBhg shelve\fP
12653 .IP \(bu 2
12655 -\fBchangeset.tag.add\fP for \%\fBhg tag\fP\: without \fB\-\-remove\fP
12656 +\fBchangeset.tag.add\fP for \fBhg tag\fP without \fB\-\-remove\fP
12657 .IP \(bu 2
12659 -\fBchangeset.tag.remove\fP for \%\fBhg tag \-\-remove\fP\:
12660 +\fBchangeset.tag.remove\fP for \fBhg tag \-\-remove\fP
12661 .IP \(bu 2
12663 -\fBchangeset.transplant.merge\fP for \%\fBhg transplant\fP\: on merges
12664 +\fBchangeset.transplant.merge\fP for \fBhg transplant\fP on merges
12665 .IP \(bu 2
12667 -\fBchangeset.transplant.normal\fP for \%\fBhg transplant\fP\: on other
12668 -.UNINDENT
12669 +\fBchangeset.transplant.normal\fP for \fBhg transplant\fP on other
12670 +.RE
12672 These dot\-separated lists of names are treated as hierarchical ones.
12673 For example, \fBchangeset.tag.remove\fP customizes the commit message
12674 -only for \%\fBhg tag \-\-remove\fP\:, but \fBchangeset.tag\fP customizes the
12675 -commit message for \%\fBhg tag\fP\: regardless of \fB\-\-remove\fP option.
12676 +only for \fBhg tag \-\-remove\fP, but \fBchangeset.tag\fP customizes the
12677 +commit message for \fBhg tag\fP regardless of \fB\-\-remove\fP option.
12679 When the external editor is invoked for a commit, the corresponding
12680 dot\-separated list of names without the \fBchangeset.\fP prefix
12681 @@ -815,7 +718,7 @@
12682 below can be referred as \fB{listupfiles}\fP:
12685 -.ft C
12686 +.ft
12687 [committemplate]
12688 listupfiles = {file_adds %
12689 "HG: added {file}\en" }{file_mods %
12690 @@ -822,7 +725,7 @@
12691 "HG: changed {file}\en" }{file_dels %
12692 "HG: removed {file}\en" }{if(files, "",
12693 "HG: no files changed\en")}
12694 -.ft P
12695 +.ft
12697 .SS \fBdecode/encode\fP
12699 @@ -846,7 +749,7 @@
12700 Pipe example:
12703 -.ft C
12704 +.ft
12705 [encode]
12706 # uncompress gzip files on checkin to improve delta compression
12707 # note: not necessarily a good idea, just an example
12708 @@ -854,9 +757,9 @@
12710 [decode]
12711 # recompress gzip files when writing them to the working dir (we
12712 -# can safely omit "pipe:", because it\(aqs the default)
12713 +# can safely omit "pipe:", because it's the default)
12714 *.gz = gzip
12715 -.ft P
12716 +.ft
12719 A \fBtempfile:\fP command is a template. The string \fBINFILE\fP is replaced
12720 @@ -864,12 +767,6 @@
12721 filtered by the command. The string \fBOUTFILE\fP is replaced with the name
12722 of an empty temporary file, where the filtered data must be written by
12723 the command.
12724 -.IP Note
12726 -The tempfile mechanism is recommended for Windows systems,
12727 -where the standard shell I/O redirection operators often have
12728 -strange effects and may corrupt the contents of your files.
12729 -.RE
12731 This filter mechanism is used internally by the \fBeol\fP extension to
12732 translate line ending characters between Windows (CRLF) and Unix (LF)
12733 @@ -876,20 +773,20 @@
12734 format. We suggest you use the \fBeol\fP extension for convenience.
12735 .SS \fBdefaults\fP
12737 -(defaults are deprecated. Don\(aqt use them. Use aliases instead.)
12738 +(defaults are deprecated. Don't use them. Use aliases instead.)
12740 Use the \fB[defaults]\fP section to define command defaults, i.e. the
12741 default options/arguments to pass to the specified commands.
12743 -The following example makes \%\fBhg log\fP\: run in verbose mode, and
12744 -\%\fBhg status\fP\: show only the modified files, by default:
12745 +The following example makes \fBhg log\fP run in verbose mode, and
12746 +\fBhg status\fP show only the modified files, by default:
12749 -.ft C
12750 +.ft
12751 [defaults]
12752 log = \-v
12753 status = \-m
12754 -.ft P
12755 +.ft
12758 The actual commands, instead of their aliases, must be used when
12759 @@ -898,9 +795,9 @@
12760 .SS \fBdiff\fP
12762 Settings used when displaying diffs. Everything except for \fBunified\fP
12763 -is a Boolean and defaults to False. See \%\fBhg help config.annotate\fP\:
12764 +is a Boolean and defaults to False. See \fBhg help config.annotate\fP
12765 for related options for the annotate command.
12766 -.INDENT 0.0
12767 +.RS 0
12769 .B \fBgit\fP
12771 @@ -912,11 +809,11 @@
12773 .B \fBnodates\fP
12775 -Don\(aqt include dates in diff headers.
12776 +Don't include dates in diff headers.
12778 .B \fBnoprefix\fP
12780 -Omit \(aqa/\(aq and \(aqb/\(aq prefixes from filenames. Ignored in plain mode.
12781 +Omit 'a/' and 'b/' prefixes from filenames. Ignored in plain mode.
12783 .B \fBshowfunc\fP
12785 @@ -937,11 +834,11 @@
12786 .B \fBunified\fP
12788 Number of lines of context to show.
12789 -.UNINDENT
12790 +.RE
12791 .SS \fBemail\fP
12793 Settings for extensions that send email messages.
12794 -.INDENT 0.0
12795 +.RS 0
12797 .B \fBfrom\fP
12799 @@ -950,16 +847,16 @@
12801 .B \fBto\fP
12803 -Optional. Comma\-separated list of recipients\(aq email addresses.
12804 +Optional. Comma\-separated list of recipients' email addresses.
12806 .B \fBcc\fP
12808 -Optional. Comma\-separated list of carbon copy recipients\(aq
12809 +Optional. Comma\-separated list of carbon copy recipients'
12810 email addresses.
12812 .B \fBbcc\fP
12814 -Optional. Comma\-separated list of blind carbon copy recipients\(aq
12815 +Optional. Comma\-separated list of blind carbon copy recipients'
12816 email addresses.
12818 .B \fBmethod\fP
12819 @@ -979,10 +876,10 @@
12820 first character set to which conversion from local encoding
12821 (\fB$HGENCODING\fP, \fBui.fallbackencoding\fP) succeeds. If correct
12822 conversion fails, the text in question is sent as is.
12823 -(default: \(aq\(aq)
12824 +(default: '')
12826 Order of outgoing email character sets:
12827 -.INDENT 7.0
12828 +.RS 7
12829 .IP 1. 3
12831 \fBus\-ascii\fP: always first, regardless of settings
12832 @@ -998,13 +895,13 @@
12833 .IP 5. 3
12835 \fButf\-8\fP: always last, regardless of settings
12836 -.UNINDENT
12837 -.UNINDENT
12838 +.RE
12839 +.RE
12841 Email example:
12844 -.ft C
12845 +.ft
12846 [email]
12847 from = Joseph User <joe.user@example.com>
12848 method = /usr/sbin/sendmail
12849 @@ -1011,7 +908,7 @@
12850 # charsets for western Europeans
12851 # us\-ascii, utf\-8 omitted, as they are tried first and last
12852 charsets = iso\-8859\-1, iso\-8859\-15, windows\-1252
12853 -.ft P
12854 +.ft
12856 .SS \fBextensions\fP
12858 @@ -1018,7 +915,7 @@
12859 Mercurial has an extension mechanism for adding new features. To
12860 enable an extension, create an entry for it in this section.
12862 -If you know that the extension is already in Python\(aqs search path,
12863 +If you know that the extension is already in Python's search path,
12864 you can give the name of the module, followed by \fB=\fP, with nothing
12865 after the \fB=\fP.
12867 @@ -1033,16 +930,16 @@
12868 Example for \fB~/.hgrc\fP:
12871 -.ft C
12872 +.ft
12873 [extensions]
12874 -# (the churn extension will get loaded from Mercurial\(aqs path)
12875 +# (the churn extension will get loaded from Mercurial's path)
12876 churn =
12877 # (this extension will get loaded from the file specified)
12878 myfeature = ~/.hgext/myfeature.py
12879 -.ft P
12880 +.ft
12882 .SS \fBformat\fP
12883 -.INDENT 0.0
12884 +.RS 0
12886 .B \fBusegeneraldelta\fP
12888 @@ -1087,7 +984,7 @@
12889 Repositories with this on\-disk format require Mercurial version 0.9.4.
12891 Enabled by default.
12892 -.UNINDENT
12893 +.RE
12894 .SS \fBgraph\fP
12896 Web graph view configuration. This section let you change graph
12897 @@ -1097,9 +994,9 @@
12898 Each line has the following format:
12901 -.ft C
12902 +.ft
12903 <branch>.<argument> = <value>
12904 -.ft P
12905 +.ft
12908 where \fB<branch>\fP is the name of the branch being
12909 @@ -1106,17 +1003,17 @@
12910 customized. Example:
12913 -.ft C
12914 +.ft
12915 [graph]
12916 # 2px width
12917 default.width = 2
12918 # red color
12919 default.color = FF0000
12920 -.ft P
12921 +.ft
12924 Supported arguments:
12925 -.INDENT 0.0
12926 +.RS 0
12928 .B \fBwidth\fP
12930 @@ -1125,7 +1022,7 @@
12931 .B \fBcolor\fP
12933 Set branch edges color in hexadecimal RGB notation.
12934 -.UNINDENT
12935 +.RE
12936 .SS \fBhooks\fP
12938 Commands or Python functions that get automatically executed by
12939 @@ -1139,7 +1036,7 @@
12940 Example \fB.hg/hgrc\fP:
12943 -.ft C
12944 +.ft
12945 [hooks]
12946 # update working directory after adding changesets
12947 changegroup.update = hg update
12948 @@ -1149,7 +1046,7 @@
12949 incoming.autobuild = /my/build/hook
12950 # force autobuild hook to run before other incoming hooks
12951 priority.incoming.autobuild = 1
12952 -.ft P
12953 +.ft
12956 Most hooks are run with environment variables set that give useful
12957 @@ -1159,7 +1056,7 @@
12958 They contain the type of hook which triggered the run and the full name
12959 of the hook in the config, respectively. In the example above, this will
12960 be \fB$HG_HOOKTYPE=incoming\fP and \fB$HG_HOOKNAME=incoming.email\fP.
12961 -.INDENT 0.0
12962 +.RS 0
12964 .B \fBchangegroup\fP
12966 @@ -1183,7 +1080,7 @@
12968 Run after sending changes from the local repository to another. The ID of
12969 first changeset sent is in \fB$HG_NODE\fP. The source of operation is in
12970 -\fB$HG_SOURCE\fP. Also see \%\fBhg help config.hooks.preoutgoing\fP\:.
12971 +\fB$HG_SOURCE\fP. Also see \fBhg help config.hooks.preoutgoing\fP.
12973 .B \fBpost\-<command>\fP
12975 @@ -1213,7 +1110,7 @@
12976 representations of the data internally passed to <command>. \fB$HG_OPTS\fP
12977 is a dictionary of options (with unspecified options set to their
12978 defaults). \fB$HG_PATS\fP is a list of arguments. If the hook returns
12979 -failure, the command doesn\(aqt execute and Mercurial returns the failure
12980 +failure, the command doesn't execute and Mercurial returns the failure
12981 code.
12983 .B \fBprechangegroup\fP
12984 @@ -1315,7 +1212,7 @@
12986 Run after any repository transaction has been committed. At this
12987 point, the transaction can no longer be rolled back. The hook will run
12988 -after the lock is released. See \%\fBhg help config.hooks.pretxnclose\fP\: for
12989 +after the lock is released. See \fBhg help config.hooks.pretxnclose\fP for
12990 details about available variables.
12992 .B \fBtxnclose\-bookmark\fP
12993 @@ -1322,7 +1219,7 @@
12995 Run after any bookmark change has been committed. At this point, the
12996 transaction can no longer be rolled back. The hook will run after the lock
12997 -is released. See \%\fBhg help config.hooks.pretxnclose\-bookmark\fP\: for details
12998 +is released. See \fBhg help config.hooks.pretxnclose\-bookmark\fP for details
12999 about available variables.
13001 .B \fBtxnclose\-phase\fP
13002 @@ -1329,12 +1226,12 @@
13004 Run after any phase change has been committed. At this point, the
13005 transaction can no longer be rolled back. The hook will run after the lock
13006 -is released. See \%\fBhg help config.hooks.pretxnclose\-phase\fP\: for details about
13007 +is released. See \fBhg help config.hooks.pretxnclose\-phase\fP for details about
13008 available variables.
13010 .B \fBtxnabort\fP
13012 -Run when a transaction is aborted. See \%\fBhg help config.hooks.pretxnclose\fP\:
13013 +Run when a transaction is aborted. See \fBhg help config.hooks.pretxnclose\fP
13014 for details about available variables.
13016 .B \fBpretxnchangegroup\fP
13017 @@ -1388,7 +1285,7 @@
13018 new parent is in \fB$HG_PARENT1\fP. If updating to a merge, the ID of second new
13019 parent is in \fB$HG_PARENT2\fP. If the update succeeded, \fB$HG_ERROR=0\fP. If the
13020 update failed (e.g. because conflicts were not resolved), \fB$HG_ERROR=1\fP.
13021 -.UNINDENT
13022 +.RE
13023 .IP Note
13025 It is generally better to use standard hooks rather than the
13026 @@ -1397,21 +1294,14 @@
13027 Also, hooks like "commit" will be called in all contexts that
13028 generate a commit (e.g. tag) and not just the commit command.
13030 -.IP Note
13032 -Environment variables with empty values may not be passed to
13033 -hooks on platforms such as Windows. As an example, \fB$HG_PARENT2\fP
13034 -will have an empty value under Unix\-like platforms for non\-merge
13035 -changesets, while it will not be available at all under Windows.
13036 -.RE
13038 The syntax for Python hooks is as follows:
13041 -.ft C
13042 +.ft
13043 hookname = python:modulename.submodule.callable
13044 hookname = python:/path/to/python/module.py:callable
13045 -.ft P
13046 +.ft
13049 Python hooks are run within the Mercurial process. Each hook is
13050 @@ -1425,7 +1315,7 @@
13051 is treated as a failure.
13052 .SS \fBhostfingerprints\fP
13054 -(Deprecated. Use \fB[hostsecurity]\fP\(aqs \fBfingerprints\fP options instead.)
13055 +(Deprecated. Use \fB[hostsecurity]\fP\&'s \fBfingerprints\fP options instead.)
13057 Fingerprints of the certificates of known HTTPS servers.
13059 @@ -1443,11 +1333,11 @@
13060 For example:
13063 -.ft C
13064 +.ft
13065 [hostfingerprints]
13066 hg.intevation.de = fc:e2:8d:d9:51:cd:cb:c1:4d:18:6b:b7:44:8d:49:72:57:e6:cd:33
13067 hg.intevation.org = fc:e2:8d:d9:51:cd:cb:c1:4d:18:6b:b7:44:8d:49:72:57:e6:cd:33
13068 -.ft P
13069 +.ft
13071 .SS \fBhostsecurity\fP
13073 @@ -1455,7 +1345,7 @@
13074 other machines.
13076 The following options control default behavior for all hosts.
13077 -.INDENT 0.0
13078 +.RS 0
13080 .B \fBciphers\fP
13082 @@ -1462,7 +1352,7 @@
13083 Defines the cryptographic ciphers to use for connections.
13085 Value must be a valid OpenSSL Cipher List Format as documented at
13086 -\%https://www.openssl.org/docs/manmaster/apps/ciphers.html#CIPHER\-LIST\-FORMAT\:.
13087 +https://www.openssl.org/docs/manmaster/apps/ciphers.html#CIPHER\-LIST\-FORMAT.
13089 This setting is for advanced users only. Setting to incorrect values
13090 can significantly lower connection security or decrease performance.
13091 @@ -1486,7 +1376,7 @@
13092 \fBtls1.1\fP. \fBtls1.0\fP can still be used to allow TLS 1.0. However, this
13093 weakens security and should only be used as a feature of last resort if
13094 a server does not support TLS 1.1+.
13095 -.UNINDENT
13096 +.RE
13098 Options in the \fB[hostsecurity]\fP section can have the form
13099 \fBhostname\fP:\fBsetting\fP. This allows multiple settings to be defined on a
13100 @@ -1493,7 +1383,7 @@
13101 per\-host basis.
13103 The following per\-host settings can be defined.
13104 -.INDENT 0.0
13105 +.RS 0
13107 .B \fBciphers\fP
13109 @@ -1532,7 +1422,7 @@
13110 verify the server certificate. Environment variables and \fB~user\fP
13111 constructs are expanded in the filename.
13113 -The server certificate or the certificate\(aqs certificate authority (CA)
13114 +The server certificate or the certificate's certificate authority (CA)
13115 must match a certificate from this file or certificate verification
13116 will fail and connections to the server will be refused.
13118 @@ -1546,7 +1436,7 @@
13119 The format of the file is as follows:
13122 -.ft C
13123 +.ft
13124 \-\-\-\-\-BEGIN CERTIFICATE\-\-\-\-\-
13125 \&... (certificate in base64 PEM encoding) ...
13126 \-\-\-\-\-END CERTIFICATE\-\-\-\-\-
13127 @@ -1553,20 +1443,20 @@
13128 \-\-\-\-\-BEGIN CERTIFICATE\-\-\-\-\-
13129 \&... (certificate in base64 PEM encoding) ...
13130 \-\-\-\-\-END CERTIFICATE\-\-\-\-\-
13131 -.ft P
13132 +.ft
13134 -.UNINDENT
13135 +.RE
13137 For example:
13140 -.ft C
13141 +.ft
13142 [hostsecurity]
13143 hg.example.com:fingerprints = sha256:c3ab8ff13720e8ad9047dd39466b3c8974e592c2fa383d4a3960714caef0c4f2
13144 hg2.example.com:fingerprints = sha1:914f1aff87249c09b6859b88b1906d30756491ca, sha1:fc:e2:8d:d9:51:cd:cb:c1:4d:18:6b:b7:44:8d:49:72:57:e6:cd:33
13145 hg3.example.com:fingerprints = sha256:9a:b0:dc:e2:75:ad:8a:b7:84:58:e5:1f:07:32:f1:87:e6:bd:24:22:af:b7:ce:8e:9c:b4:10:cf:b9:f4:0e:d2
13146 foo.example.com:verifycertsfile = /etc/ssl/trusted\-ca\-certs.pem
13147 -.ft P
13148 +.ft
13151 To change the default minimum protocol version to TLS 1.2 but to allow TLS 1.1
13152 @@ -1573,17 +1463,17 @@
13153 when connecting to \fBhg.example.com\fP:
13156 -.ft C
13157 +.ft
13158 [hostsecurity]
13159 minimumprotocol = tls1.2
13160 hg.example.com:minimumprotocol = tls1.1
13161 -.ft P
13162 +.ft
13164 .SS \fBhttp_proxy\fP
13166 Used to access web\-based Mercurial repositories through a HTTP
13167 proxy.
13168 -.INDENT 0.0
13169 +.RS 0
13171 .B \fBhost\fP
13173 @@ -1607,11 +1497,11 @@
13175 Optional. Always use the proxy, even for localhost and any entries
13176 in \fBhttp_proxy.no\fP. (default: False)
13177 -.UNINDENT
13178 +.RE
13179 .SS \fBmerge\fP
13181 This section specifies behavior during merges and updates.
13182 -.INDENT 0.0
13183 +.RS 0
13185 .B \fBcheckignored\fP
13187 @@ -1619,12 +1509,12 @@
13188 file in the changeset being merged or updated to, and has different
13189 contents. Options are \fBabort\fP, \fBwarn\fP and \fBignore\fP. With \fBabort\fP,
13190 abort on such files. With \fBwarn\fP, warn on such files and back them up as
13191 -\fB.orig\fP. With \fBignore\fP, don\(aqt print a warning and back them up as
13192 -\fB.orig\fP. (default: \fBabort\fP)
13193 +\fB\&.orig\fP. With \fBignore\fP, don't print a warning and back them up as
13194 +\fB\&.orig\fP. (default: \fBabort\fP)
13196 .B \fBcheckunknown\fP
13198 -Controls behavior when an unknown file that isn\(aqt ignored has the same name
13199 +Controls behavior when an unknown file that isn't ignored has the same name
13200 as a tracked file in the changeset being merged or updated to, and has
13201 different contents. Similar to \fBmerge.checkignored\fP, except for files that
13202 are not ignored. (default: \fBabort\fP)
13203 @@ -1640,7 +1530,7 @@
13204 can be restarted by using the \fBresolve\fP command. When a merge is
13205 halted, the repository is left in a normal \fBunresolved\fP merge state.
13206 (default: \fBcontinue\fP)
13207 -.UNINDENT
13208 +.RE
13209 .SS \fBmerge\-patterns\fP
13211 This section specifies merge tools to associate with particular file
13212 @@ -1651,23 +1541,23 @@
13213 Example:
13216 -.ft C
13217 +.ft
13218 [merge\-patterns]
13219 **.c = kdiff3
13220 **.jpg = myimgmerge
13221 -.ft P
13222 +.ft
13224 .SS \fBmerge\-tools\fP
13226 This section configures external merge tools to use for file\-level
13227 merges. This section has likely been preconfigured at install time.
13228 -Use \%\fBhg config merge\-tools\fP\: to check the existing configuration.
13229 -Also see \%\fBhg help merge\-tools\fP\: for more details.
13230 +Use \fBhg config merge\-tools\fP to check the existing configuration.
13231 +Also see \fBhg help merge\-tools\fP for more details.
13233 Example \fB~/.hgrc\fP:
13236 -.ft C
13237 +.ft
13238 [merge\-tools]
13239 # Override stock tool location
13240 kdiff3.executable = ~/bin/kdiff3
13241 @@ -1684,13 +1574,12 @@
13243 # Define new tool
13244 myHtmlTool.args = \-m $local $other $base $output
13245 -myHtmlTool.regkey = Software\eFooSoftware\eHtmlMerge
13246 myHtmlTool.priority = 1
13247 -.ft P
13248 +.ft
13251 Supported arguments:
13252 -.INDENT 0.0
13253 +.RS 0
13255 .B \fBpriority\fP
13257 @@ -1701,9 +1590,6 @@
13259 Either just the name of the executable or its pathname.
13261 -On Windows, the path can use environment variables with ${ProgramFiles}
13262 -syntax.
13263 -.sp
13264 (default: the tool name)
13266 .B \fBargs\fP
13267 @@ -1726,7 +1612,7 @@
13268 \fBkeep\-merge3\fP. The \fBkeep\fP option will leave markers in the file if the
13269 premerge fails. The \fBkeep\-merge3\fP will do the same but include information
13270 about the base of the merge in the marker (see internal :merge3 in
13271 -\%\fBhg help merge\-tools\fP\:).
13272 +\fBhg help merge\-tools\fP).
13273 (default: True)
13275 .B \fBbinary\fP
13276 @@ -1741,7 +1627,7 @@
13277 .B \fBcheck\fP
13279 A list of merge success\-checking options:
13280 -.INDENT 7.0
13281 +.RS 7
13283 .B \fBchanged\fP
13285 @@ -1754,7 +1640,7 @@
13286 .B \fBprompt\fP
13288 Always prompt for merge success, regardless of success reported by tool.
13289 -.UNINDENT
13290 +.RE
13292 .B \fBfixeol\fP
13294 @@ -1764,40 +1650,12 @@
13295 .B \fBgui\fP
13297 This tool requires a graphical interface to run. (default: False)
13298 -.UNINDENT
13299 -.INDENT 0.0
13300 -.TP
13301 -.B \fBregkey\fP
13302 -.sp
13303 -Windows registry key which describes install location of this
13304 -tool. Mercurial will search for this key first under
13305 -\fBHKEY_CURRENT_USER\fP and then under \fBHKEY_LOCAL_MACHINE\fP.
13306 -(default: None)
13307 -.TP
13308 -.B \fBregkeyalt\fP
13309 -.sp
13310 -An alternate Windows registry key to try if the first key is not
13311 -found. The alternate key uses the same \fBregname\fP and \fBregappend\fP
13312 -semantics of the primary key. The most common use for this key
13313 -is to search for 32bit applications on 64bit operating systems.
13314 -(default: None)
13315 -.TP
13316 -.B \fBregname\fP
13317 -.sp
13318 -Name of value to read from specified registry key.
13319 -(default: the unnamed (default) value)
13320 -.TP
13321 -.B \fBregappend\fP
13322 -.sp
13323 -String to append to the value read from the registry, typically
13324 -the executable name of the tool.
13325 -(default: None)
13326 -.UNINDENT
13327 +.RE
13328 .SS \fBpager\fP
13330 Setting used to control when to paginate and with what external tool. See
13331 -\%\fBhg help pager\fP\: for details.
13332 -.INDENT 0.0
13333 +\fBhg help pager\fP for details.
13334 +.RS 0
13336 .B \fBpager\fP
13338 @@ -1808,10 +1666,10 @@
13339 used, typically \fIless\fP on Unix and \fImore\fP on Windows. Example:
13342 -.ft C
13343 +.ft
13344 [pager]
13345 pager = less \-FRX
13346 -.ft P
13347 +.ft
13350 .B \fBignore\fP
13351 @@ -1819,21 +1677,21 @@
13352 List of commands to disable the pager for. Example:
13355 -.ft C
13356 +.ft
13357 [pager]
13358 ignore = version, help, update
13359 -.ft P
13360 +.ft
13362 -.UNINDENT
13363 +.RE
13364 .SS \fBpatch\fP
13366 -Settings used when applying patches, for instance through the \(aqimport\(aq
13367 +Settings used when applying patches, for instance through the 'import'
13368 command or with Mercurial Queues extension.
13369 -.INDENT 0.0
13370 +.RS 0
13372 .B \fBeol\fP
13374 -When set to \(aqstrict\(aq patch content and patched files end of lines
13375 +When set to 'strict' patch content and patched files end of lines
13376 are preserved. When set to \fBlf\fP or \fBcrlf\fP, both files end of
13377 lines are ignored when patching and the result line endings are
13378 normalized to either LF (Unix) or CRLF (Windows). When set to
13379 @@ -1845,11 +1703,11 @@
13381 .B \fBfuzz\fP
13383 -The number of lines of \(aqfuzz\(aq to allow when applying patches. This
13384 +The number of lines of 'fuzz' to allow when applying patches. This
13385 controls how much context the patcher is allowed to ignore when
13386 trying to apply a patch.
13387 (default: 2)
13388 -.UNINDENT
13389 +.RE
13390 .SS \fBpaths\fP
13392 Assigns symbolic names and behavior to repositories.
13393 @@ -1858,70 +1716,70 @@
13394 location of the repository. Example:
13397 -.ft C
13398 +.ft
13399 [paths]
13400 my_server = https://example.com/my_repo
13401 local_path = /home/me/repo
13402 -.ft P
13403 +.ft
13406 These symbolic names can be used from the command line. To pull
13407 -from \fBmy_server\fP: \%\fBhg pull my_server\fP\:. To push to \fBlocal_path\fP:
13408 -\%\fBhg push local_path\fP\:.
13409 +from \fBmy_server\fP: \fBhg pull my_server\fP. To push to \fBlocal_path\fP:
13410 +\fBhg push local_path\fP.
13412 Options containing colons (\fB:\fP) denote sub\-options that can influence
13413 behavior for that specific path. Example:
13416 -.ft C
13417 +.ft
13418 [paths]
13419 my_server = https://example.com/my_path
13420 my_server:pushurl = ssh://example.com/my_path
13421 -.ft P
13422 +.ft
13425 The following sub\-options can be defined:
13426 -.INDENT 0.0
13427 +.RS 0
13429 .B \fBpushurl\fP
13431 The URL to use for push operations. If not defined, the location
13432 -defined by the path\(aqs main entry is used.
13433 +defined by the path's main entry is used.
13435 .B \fBpushrev\fP
13437 A revset defining which revisions to push by default.
13439 -When \%\fBhg push\fP\: is executed without a \fB\-r\fP argument, the revset
13440 +When \fBhg push\fP is executed without a \fB\-r\fP argument, the revset
13441 defined by this sub\-option is evaluated to determine what to push.
13443 -For example, a value of \fB.\fP will push the working directory\(aqs
13444 +For example, a value of \fB.\fP will push the working directory's
13445 revision by default.
13447 Revsets specifying bookmarks will not result in the bookmark being
13448 pushed.
13449 -.UNINDENT
13450 +.RE
13452 The following special named paths exist:
13453 -.INDENT 0.0
13454 +.RS 0
13456 .B \fBdefault\fP
13458 The URL or directory to use when no source or remote is specified.
13460 -\%\fBhg clone\fP\: will automatically define this path to the location the
13461 +\fBhg clone\fP will automatically define this path to the location the
13462 repository was cloned from.
13464 .B \fBdefault\-push\fP
13466 -(deprecated) The URL or directory for the default \%\fBhg push\fP\: location.
13467 +(deprecated) The URL or directory for the default \fBhg push\fP location.
13468 \fBdefault:pushurl\fP should be used instead.
13469 -.UNINDENT
13470 +.RE
13471 .SS \fBphases\fP
13473 -Specifies default handling of phases. See \%\fBhg help phases\fP\: for more
13474 +Specifies default handling of phases. See \fBhg help phases\fP for more
13475 information about working with phases.
13476 -.INDENT 0.0
13477 +.RS 0
13479 .B \fBpublish\fP
13481 @@ -1946,7 +1804,7 @@
13482 either aborted (if checksubrepos is set to "abort") or the higher phase is
13483 used for the parent repository commit (if set to "follow").
13484 (default: follow)
13485 -.UNINDENT
13486 +.RE
13487 .SS \fBprofiling\fP
13489 Specifies profiling type, format, and file output. Two profilers are
13490 @@ -1953,11 +1811,11 @@
13491 supported: an instrumenting profiler (named \fBls\fP), and a sampling
13492 profiler (named \fBstat\fP).
13494 -In this section description, \(aqprofiling data\(aq stands for the raw data
13495 -collected during profiling, while \(aqprofiling report\(aq stands for a
13496 +In this section description, 'profiling data' stands for the raw data
13497 +collected during profiling, while 'profiling report' stands for a
13498 statistical text report generated from the profiling data. The
13499 profiling is done using lsprof.
13500 -.INDENT 0.0
13501 +.RS 0
13503 .B \fBenabled\fP
13505 @@ -1970,11 +1828,11 @@
13507 The type of profiler to use.
13508 (default: stat)
13509 -.INDENT 7.0
13510 +.RS 7
13512 .B \fBls\fP
13514 -Use Python\(aqs built\-in instrumenting profiler. This profiler
13515 +Use Python's built\-in instrumenting profiler. This profiler
13516 works on all platforms, but each line number it reports is the
13517 first line of a function. This restriction makes it difficult to
13518 identify the expensive parts of a non\-trivial function.
13519 @@ -1984,13 +1842,13 @@
13520 Use a statistical profiler, statprof. This profiler is most
13521 useful for profiling commands that run for longer than about 0.1
13522 seconds.
13523 -.UNINDENT
13524 +.RE
13526 .B \fBformat\fP
13528 Profiling format. Specific to the \fBls\fP instrumenting profiler.
13529 (default: text)
13530 -.INDENT 7.0
13531 +.RS 7
13533 .B \fBtext\fP
13535 @@ -2003,13 +1861,13 @@
13536 Format profiling data for kcachegrind use: when saving to a
13537 file, the generated file can directly be loaded into
13538 kcachegrind.
13539 -.UNINDENT
13540 +.RE
13542 .B \fBstatformat\fP
13544 Profiling format for the \fBstat\fP profiler.
13545 (default: hotpath)
13546 -.INDENT 7.0
13547 +.RS 7
13549 .B \fBhotpath\fP
13551 @@ -2027,7 +1885,7 @@
13552 .B \fBjson\fP
13554 Render profiling data as JSON.
13555 -.UNINDENT
13556 +.RE
13558 .B \fBfrequency\fP
13560 @@ -2082,13 +1940,13 @@
13561 For the \fBchrome\fP format, default is \fB0.999\fP.
13563 The option is unused on other formats.
13564 -.UNINDENT
13565 +.RE
13566 .SS \fBprogress\fP
13568 Mercurial commands can draw progress bars that are as informative as
13569 possible. Some progress bars only offer indeterminate information, while others
13570 have a definite end point.
13571 -.INDENT 0.0
13572 +.RS 0
13574 .B \fBdelay\fP
13576 @@ -2127,31 +1985,31 @@
13578 .B \fBclear\-complete\fP
13580 -Clear the progress bar after it\(aqs done. (default: True)
13581 +Clear the progress bar after it's done. (default: True)
13583 .B \fBdisable\fP
13585 -If true, don\(aqt show a progress bar.
13586 +If true, don't show a progress bar.
13588 .B \fBassume\-tty\fP
13590 If true, ALWAYS show a progress bar, unless disable is given.
13591 -.UNINDENT
13592 +.RE
13593 .SS \fBrebase\fP
13594 -.INDENT 0.0
13595 +.RS 0
13597 .B \fBevolution.allowdivergence\fP
13599 Default to False, when True allow creating divergence when performing
13600 rebase of obsolete changesets.
13601 -.UNINDENT
13602 +.RE
13603 .SS \fBrevsetalias\fP
13605 -Alias definitions for revsets. See \%\fBhg help revsets\fP\: for details.
13606 +Alias definitions for revsets. See \fBhg help revsets\fP for details.
13607 .SS \fBserver\fP
13609 Controls generic server settings.
13610 -.INDENT 0.0
13611 +.RS 0
13613 .B \fBcompressionengines\fP
13615 @@ -2160,10 +2018,10 @@
13617 The order of compression engines determines their priority, the first
13618 having the highest priority. If a compression engine is not listed
13619 -here, it won\(aqt be advertised to clients.
13620 +here, it won't be advertised to clients.
13622 If not set (the default), built\-in defaults are used. Run
13623 -\%\fBhg debuginstall\fP\: to list available compression engines and their
13624 +\fBhg debuginstall\fP to list available compression engines and their
13625 default wire protocol priority.
13627 Older Mercurial clients only support zlib compression and this setting
13628 @@ -2202,19 +2060,19 @@
13629 .B \fBconcurrent\-push\-mode\fP
13631 Level of allowed race condition between two pushing clients.
13632 -.INDENT 7.0
13633 +.RS 7
13634 .IP \(bu 2
13636 -\(aqstrict\(aq: push is abort if another client touched the repository
13637 +\&'strict': push is abort if another client touched the repository
13638 while the push was preparing. (default)
13639 .IP \(bu 2
13641 -\(aqcheck\-related\(aq: push is only aborted if it affects head that got also
13642 +\&'check\-related': push is only aborted if it affects head that got also
13643 affected while the push was preparing.
13644 -.UNINDENT
13645 +.RE
13647 This requires compatible client (version 4.3 and later). Old client will
13648 -use \(aqstrict\(aq.
13649 +use 'strict'.
13651 .B \fBvalidate\fP
13653 @@ -2290,11 +2148,11 @@
13654 This option only impacts the HTTP server.
13656 See also \fBserver.zliblevel\fP.
13657 -.UNINDENT
13658 +.RE
13659 .SS \fBsmtp\fP
13661 Configuration for extensions that need to send email messages.
13662 -.INDENT 0.0
13663 +.RS 0
13665 .B \fBhost\fP
13667 @@ -2325,7 +2183,7 @@
13669 Optional. The hostname that the sender can use to identify
13670 itself to the MTA.
13671 -.UNINDENT
13672 +.RE
13673 .SS \fBsubpaths\fP
13675 Subrepository source URLs can go stale if a remote server changes name
13676 @@ -2333,9 +2191,9 @@
13677 rewrite rules of the form:
13680 -.ft C
13681 +.ft
13682 <pattern> = <replacement>
13683 -.ft P
13684 +.ft
13687 where \fBpattern\fP is a regular expression matching a subrepository
13688 @@ -2344,9 +2202,9 @@
13689 \fBreplacements\fP. For instance:
13692 -.ft C
13693 +.ft
13694 http://server/(.*)\-hg/ = http://hg.server/\e1/
13695 -.ft P
13696 +.ft
13699 rewrites \fBhttp://server/foo\-hg/\fP into \fBhttp://hg.server/foo/\fP.
13700 @@ -2353,19 +2211,19 @@
13702 Relative subrepository paths are first made absolute, and the
13703 rewrite rules are then applied on the full (absolute) path. If \fBpattern\fP
13704 -doesn\(aqt match the full path, an attempt is made to apply it on the
13705 +doesn't match the full path, an attempt is made to apply it on the
13706 relative path alone. The rules are applied in definition order.
13707 .SS \fBtemplatealias\fP
13709 -Alias definitions for templates. See \%\fBhg help templates\fP\: for details.
13710 +Alias definitions for templates. See \fBhg help templates\fP for details.
13711 .SS \fBtemplates\fP
13713 Use the \fB[templates]\fP section to define template strings.
13714 -See \%\fBhg help templates\fP\: for details.
13715 +See \fBhg help templates\fP for details.
13716 .SS \fBtrusted\fP
13718 Mercurial will not use the settings in the
13719 -\fB.hg/hgrc\fP file from a repository if it doesn\(aqt belong to a trusted
13720 +\fB\&.hg/hgrc\fP file from a repository if it doesn't belong to a trusted
13721 user or to a trusted group, as various hgrc features allow arbitrary
13722 commands to be run. This issue is often encountered when configuring
13723 hooks or extensions for shared repositories or servers. However,
13724 @@ -2377,7 +2235,7 @@
13725 group with name \fB*\fP. These settings must be placed in an
13726 \fIalready\-trusted file\fP to take effect, such as \fB$HOME/.hgrc\fP of the
13727 user or service running Mercurial.
13728 -.INDENT 0.0
13729 +.RS 0
13731 .B \fBusers\fP
13733 @@ -2386,17 +2244,17 @@
13734 .B \fBgroups\fP
13736 Comma\-separated list of trusted groups.
13737 -.UNINDENT
13738 +.RE
13739 .SS \fBui\fP
13741 User interface controls.
13742 -.INDENT 0.0
13743 +.RS 0
13745 .B \fBarchivemeta\fP
13747 Whether to include the .hg_archival.txt file containing meta data
13748 (hashes for the repository base and for tip) in archives created
13749 -by the \%\fBhg archive\fP\: command or downloaded via hgweb.
13750 +by the \fBhg archive\fP command or downloaded via hgweb.
13751 (default: True)
13753 .B \fBaskusername\fP
13754 @@ -2411,7 +2269,7 @@
13756 Whether the "clone bundles" feature is enabled.
13758 -When enabled, \%\fBhg clone\fP\: may download and apply a server\-advertised
13759 +When enabled, \fBhg clone\fP may download and apply a server\-advertised
13760 bundle file from a URL instead of using the normal exchange mechanism.
13762 This can likely result in faster and more reliable clones.
13763 @@ -2429,7 +2287,7 @@
13764 clone, this would add significant and unexpected load to the server
13765 since the server is expecting clone operations to be offloaded to
13766 pre\-generated bundles. Failing fast (the default behavior) ensures
13767 -clients don\(aqt overwhelm the server when "clone bundle" application
13768 +clients don't overwhelm the server when "clone bundle" application
13769 fails.
13771 (default: False)
13772 @@ -2444,17 +2302,17 @@
13773 bundle over another.
13775 The following keys are defined by Mercurial:
13776 -.INDENT 7.0
13777 +.RS 7
13779 .B BUNDLESPEC
13781 -A bundle type specifier. These are strings passed to \%\fBhg bundle \-t\fP\:.
13782 +A bundle type specifier. These are strings passed to \fBhg bundle \-t\fP.
13783 e.g. \fBgzip\-v2\fP or \fBbzip2\-v1\fP.
13785 .B COMPRESSION
13787 The compression format of the bundle. e.g. \fBgzip\fP and \fBbzip2\fP.
13788 -.UNINDENT
13789 +.RE
13791 Server operators may define custom keys.
13793 @@ -2467,7 +2325,7 @@
13795 When to colorize output. Possible value are Boolean ("yes" or "no"), or
13796 "debug", or "always". (default: "yes"). "yes" will use color whenever it
13797 -seems possible. See \%\fBhg help color\fP\: for details.
13798 +seems possible. See \fBhg help color\fP for details.
13800 .B \fBcommitsubrepos\fP
13802 @@ -2486,7 +2344,7 @@
13804 .B \fBfallbackencoding\fP
13806 -Encoding to try if it\(aqs not possible to decode the changelog using
13807 +Encoding to try if it's not possible to decode the changelog using
13808 UTF\-8. (default: ISO\-8859\-1)
13810 .B \fBgraphnodetemplate\fP
13811 @@ -2510,12 +2368,12 @@
13812 .B \fBinterface\fP
13814 Select the default interface for interactive features (default: text).
13815 -Possible values are \(aqtext\(aq and \(aqcurses\(aq.
13816 +Possible values are 'text' and 'curses'.
13818 .B \fBinterface.chunkselector\fP
13820 -Select the interface for change recording (e.g. \%\fBhg commit \-i\fP\:).
13821 -Possible values are \(aqtext\(aq and \(aqcurses\(aq.
13822 +Select the interface for change recording (e.g. \fBhg commit \-i\fP).
13823 +Possible values are 'text' and 'curses'.
13824 This config overrides the interface specified by ui.interface.
13826 .B \fBlogtemplate\fP
13827 @@ -2525,7 +2383,7 @@
13828 .B \fBmerge\fP
13830 The conflict resolution program to use during a manual merge.
13831 -For more information on merge tools see \%\fBhg help merge\-tools\fP\:.
13832 +For more information on merge tools see \fBhg help merge\-tools\fP.
13833 For configuring merge tools see the \fB[merge\-tools]\fP section.
13835 .B \fBmergemarkers\fP
13836 @@ -2532,7 +2390,7 @@
13838 Sets the merge conflict marker label styling. The \fBdetailed\fP
13839 style uses the \fBmergemarkertemplate\fP setting to style the labels.
13840 -The \fBbasic\fP style just uses \(aqlocal\(aq and \(aqother\(aq as the marker label.
13841 +The \fBbasic\fP style just uses 'local' and 'other' as the marker label.
13842 One of \fBbasic\fP or \fBdetailed\fP.
13843 (default: \fBbasic\fP)
13845 @@ -2539,7 +2397,7 @@
13846 .B \fBmergemarkertemplate\fP
13848 The template used to print the commit description next to each conflict
13849 -marker during merge conflicts. See \%\fBhg help templates\fP\: for the template
13850 +marker during merge conflicts. See \fBhg help templates\fP for the template
13851 format.
13853 Defaults to showing the hash, tags, branches, bookmarks, author, and
13854 @@ -2562,7 +2420,7 @@
13856 .B \fBpaginate\fP
13858 -Control the pagination of command output (default: True). See \%\fBhg help pager\fP\:
13859 +Control the pagination of command output (default: True). See \fBhg help pager\fP
13860 for details.
13862 .B \fBpatch\fP
13863 @@ -2583,12 +2441,12 @@
13865 Check for portable filenames. Can be \fBwarn\fP, \fBignore\fP or \fBabort\fP.
13866 (default: \fBwarn\fP)
13867 -.INDENT 7.0
13868 +.RS 7
13870 .B \fBwarn\fP
13872 Print a warning message on POSIX platforms, if a file with a non\-portable
13873 -filename is added (e.g. a file with a name that can\(aqt be created on
13874 +filename is added (e.g. a file with a name that can't be created on
13875 Windows because it contains reserved parts like \fBAUX\fP, reserved
13876 characters like \fB:\fP, or would cause a case collision with an existing
13877 file).
13878 @@ -2595,7 +2453,7 @@
13880 .B \fBignore\fP
13882 -Don\(aqt print a warning.
13883 +Don't print a warning.
13885 .B \fBabort\fP
13887 @@ -2608,9 +2466,7 @@
13888 .B \fBfalse\fP
13890 Alias for \fBignore\fP.
13891 -.UNINDENT
13892 -.sp
13893 -On Windows, this configuration option is ignored and the command aborted.
13894 +.RE
13896 .B \fBquiet\fP
13898 @@ -2678,26 +2534,26 @@
13899 occurs. Setting this to True will make Mercurial print a traceback
13900 on all exceptions, even those recognized by Mercurial (such as
13901 IOError or MemoryError). (default: False)
13902 -.UNINDENT
13903 +.RE
13905 \fBtweakdefaults\fP
13906 -.INDENT 0.0
13907 -.INDENT 3.5
13908 +.RS 0
13909 +.RS 3
13911 -By default Mercurial\(aqs behavior changes very little from release
13912 +By default Mercurial's behavior changes very little from release
13913 to release, but over time the recommended config settings
13914 shift. Enable this config to opt in to get automatic tweaks to
13915 -Mercurial\(aqs behavior over time. This config setting will have no
13916 +Mercurial's behavior over time. This config setting will have no
13917 effet if \fBHGPLAIN\(ga is set or \(ga\(gaHGPLAINEXCEPT\fP is set and does
13918 not include \fBtweakdefaults\fP. (default: False)
13919 -.UNINDENT
13920 -.UNINDENT
13921 -.INDENT 0.0
13922 +.RE
13923 +.RE
13924 +.RS 0
13926 .B \fBusername\fP
13928 The committer of a changeset created when running "commit".
13929 -Typically a person\(aqs name and email address, e.g. \fBFred Widget
13930 +Typically a person's name and email address, e.g. \fBFred Widget
13931 <fred@example.com>\fP. Environment variables in the
13932 username are expanded.
13934 @@ -2709,11 +2565,11 @@
13935 .B \fBverbose\fP
13937 Increase the amount of output printed. (default: False)
13938 -.UNINDENT
13939 +.RE
13940 .SS \fBweb\fP
13942 Web interface configuration. The settings in this section apply to
13943 -both the builtin webserver (started by \%\fBhg serve\fP\:) and the script you
13944 +both the builtin webserver (started by \fBhg serve\fP) and the script you
13945 run through a webserver (\fBhgweb.cgi\fP and the derivatives for FastCGI
13946 and WSGI).
13948 @@ -2729,9 +2585,9 @@
13949 command line:
13952 -.ft C
13953 +.ft
13954 $ hg \-\-config web.allow_push=* \-\-config web.push_ssl=False serve
13955 -.ft P
13956 +.ft
13959 Note that this will allow anybody to push anything to the server and
13960 @@ -2738,7 +2594,7 @@
13961 that this should not be used for public servers.
13963 The full set of options is:
13964 -.INDENT 0.0
13965 +.RS 0
13967 .B \fBaccesslog\fP
13969 @@ -2818,13 +2674,13 @@
13970 To disable SSL verification temporarily, specify \fB\-\-insecure\fP from
13971 command line.
13973 -You can use OpenSSL\(aqs CA certificate file if your platform has
13974 +You can use OpenSSL's CA certificate file if your platform has
13975 one. On most Linux systems this will be
13976 \fB/etc/ssl/certs/ca\-certificates.crt\fP. Otherwise you will have to
13977 generate this file manually. The form must be as follows:
13980 -.ft C
13981 +.ft
13982 \-\-\-\-\-BEGIN CERTIFICATE\-\-\-\-\-
13983 \&... (certificate in base64 PEM encoding) ...
13984 \-\-\-\-\-END CERTIFICATE\-\-\-\-\-
13985 @@ -2831,7 +2687,7 @@
13986 \-\-\-\-\-BEGIN CERTIFICATE\-\-\-\-\-
13987 \&... (certificate in base64 PEM encoding) ...
13988 \-\-\-\-\-END CERTIFICATE\-\-\-\-\-
13989 -.ft P
13990 +.ft
13993 .B \fBcache\fP
13994 @@ -2840,7 +2696,7 @@
13996 .B \fBcertificate\fP
13998 -Certificate to use when running \%\fBhg serve\fP\:.
13999 +Certificate to use when running \fBhg serve\fP.
14001 .B \fBcollapse\fP
14003 @@ -2912,7 +2768,7 @@
14005 .B \fBdescription\fP
14007 -Textual description of the repository\(aqs purpose or contents.
14008 +Textual description of the repository's purpose or contents.
14009 (default: "unknown")
14011 .B \fBencoding\fP
14012 @@ -2986,7 +2842,7 @@
14014 .B \fBprefix\fP
14016 -Prefix path to serve from. (default: \(aq\(aq (server root))
14017 +Prefix path to serve from. (default: '' (server root))
14019 .B \fBpush_ssl\fP
14021 @@ -3025,7 +2881,7 @@
14023 Where to find the HTML templates. The default path to the HTML templates
14024 can be obtained from \fBhg debuginstall\fP.
14025 -.UNINDENT
14026 +.RE
14027 .SS \fBwebsub\fP
14029 Web substitution filter definition. You can use this section to
14030 @@ -3047,9 +2903,9 @@
14031 which in turn imitates the Unix sed replacement syntax:
14034 -.ft C
14035 +.ft
14036 patternname = s/SEARCH_REGEX/REPLACE_EXPRESSION/[i]
14037 -.ft P
14038 +.ft
14041 You can use any separator other than "/". The final "i" is optional
14042 @@ -3058,12 +2914,12 @@
14043 Examples:
14046 -.ft C
14047 +.ft
14048 [websub]
14049 issues = s|issue(\ed+)|<a href="http://bts.example.org/issue\e1">issue\e1</a>|i
14050 italic = s/\eb_(\eS+)_\eb/<i>\e1<\e/i>/
14051 bold = s/\e*\eb(\eS+)\eb\e*/<b>\e1<\e/b>/
14052 -.ft P
14053 +.ft
14055 .SS \fBworker\fP
14057 @@ -3070,7 +2926,7 @@
14058 Parallel master/worker configuration. We currently perform working
14059 directory updates in parallel on Unix\-like systems, which greatly
14060 helps performance.
14061 -.INDENT 0.0
14062 +.RS 0
14064 .B \fBnumcpus\fP
14066 @@ -3081,7 +2937,7 @@
14067 .B \fBbackgroundclose\fP
14069 Whether to enable closing file handles on background threads during certain
14070 -operations. Some platforms aren\(aqt very efficient at closing file
14071 +operations. Some platforms aren't very efficient at closing file
14072 handles that have been written or appended to. By performing file closing
14073 on background threads, file write rate can increase substantially.
14074 (default: true on Windows, false elsewhere)
14075 @@ -3089,7 +2945,7 @@
14076 .B \fBbackgroundcloseminfilecount\fP
14078 Minimum number of files required to trigger background file closing.
14079 -Operations not writing this many files won\(aqt start background close
14080 +Operations not writing this many files won't start background close
14081 threads.
14082 (default: 2048)
14084 @@ -3105,18 +2961,18 @@
14085 Number of threads to process background file closes. Only relevant if
14086 \fBbackgroundclose\fP is enabled.
14087 (default: 4)
14088 -.UNINDENT
14089 +.RE
14090 .SH AUTHOR
14092 -Bryan O\(aqSullivan <\%bos@serpentine.com\:>.
14093 +Bryan O'Sullivan <bos@serpentine.com>.
14095 -Mercurial was written by Matt Mackall <\%mpm@selenic.com\:>.
14096 +Mercurial was written by Matt Mackall <mpm@selenic.com>.
14097 .SH SEE ALSO
14099 -\%\fBhg\fP(1)\:, \%\fBhgignore\fP(5)\:
14100 +\fBhg\fP(1), \fBhgignore\fP(5)
14101 .SH COPYING
14103 -This manual page is copyright 2005 Bryan O\(aqSullivan.
14104 +This manual page is copyright 2005 Bryan O'Sullivan.
14105 Mercurial is copyright 2005\-2017 Matt Mackall.
14106 Free use of this software is granted under the terms of the GNU General
14107 Public License version 2 or any later version.