Mercurial > hg > mercurial-crew-with-dirclash
annotate doc/hg.1.txt @ 3577:7f7425306925
Correct optimization from 3464f5e77f34; add a test.
If there are two (or more) heads that point to the same .hgtags
node, we can safely skip parsing the file in all but the last head.
(In 3464f5e77f34, we were parsing the file in the first head and
skipping all the others.)
author | Alexis S. L. Carvalho <alexis@cecm.usp.br> |
---|---|
date | Sat, 28 Oct 2006 23:37:59 -0300 |
parents | 4745cf66f77d |
children | 6859d049ed9c |
rev | line source |
---|---|
177 | 1 HG(1) |
2 ===== | |
3 Matt Mackall <mpm@selenic.com> | |
4 | |
5 NAME | |
6 ---- | |
438 | 7 hg - Mercurial source code management system |
177 | 8 |
9 SYNOPSIS | |
10 -------- | |
3530
4745cf66f77d
Corrected hg synopsis.
Thomas Arendsen Hein <thomas@intevation.de>
parents:
3286
diff
changeset
|
11 'hg' [global option]... <command> [command/global option]... [argument]... |
177 | 12 |
13 DESCRIPTION | |
14 ----------- | |
15 The hg(1) command provides a command line interface to the Mercurial system. | |
16 | |
17 COMMAND ELEMENTS | |
18 ---------------- | |
19 | |
20 files ...:: | |
724
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
21 indicates one or more filename or relative path filenames; see |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
22 "FILE NAME PATTERNS" for information on pattern matching |
177 | 23 |
24 path:: | |
25 indicates a path on the local machine | |
26 | |
478
f1804f2e7f35
Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents:
438
diff
changeset
|
27 revision:: |
438 | 28 indicates a changeset which can be specified as a changeset revision |
29 number, a tag, or a unique substring of the changeset hash value | |
177 | 30 |
31 repository path:: | |
498 | 32 either the pathname of a local repository or the URI of a remote |
181
038e4d8602bd
updated for .hgpaths and http/old-http protocol name change
jake@edge2.net
parents:
177
diff
changeset
|
33 repository. There are two available URI protocols, http:// which is |
2431
d90a9d7c7d4d
replace old-http:// syntax by static-http:// and deprecate the redundant hg://
Benoit Boissinot <benoit.boissinot@ens-lyon.org>
parents:
2209
diff
changeset
|
34 fast and the static-http:// protocol which is much slower but does not |
438 | 35 require a special server on the web host. |
177 | 36 |
438 | 37 |
1814
7956893e8458
generate hg manpage from commands.py docstring
Benoit Boissinot <benoit.boissinot@ens-lyon.org>
parents:
1758
diff
changeset
|
38 include::hg.1.gendoc.txt[] |
438 | 39 |
724
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
40 FILE NAME PATTERNS |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
41 ------------------ |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
42 |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
43 Mercurial accepts several notations for identifying one or more |
1274 | 44 files at a time. |
724
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
45 |
1274 | 46 By default, Mercurial treats filenames as shell-style extended |
724
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
47 glob patterns. |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
48 |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
49 Alternate pattern notations must be specified explicitly. |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
50 |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
51 To use a plain path name without any pattern matching, start a |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
52 name with "path:". These path names must match completely, from |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
53 the root of the current repository. |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
54 |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
55 To use an extended glob, start a name with "glob:". Globs are |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
56 rooted at the current directory; a glob such as "*.c" will match |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
57 files ending in ".c" in the current directory only. |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
58 |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
59 The supported glob syntax extensions are "**" to match any string |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
60 across path separators, and "{a,b}" to mean "a or b". |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
61 |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
62 To use a Perl/Python regular expression, start a name with "re:". |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
63 Regexp pattern matching is anchored at the root of the repository. |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
64 |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
65 Plain examples: |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
66 |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
67 path:foo/bar a name bar in a directory named foo in the root of |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
68 the repository |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
69 path:path:name a file or directory named "path:name" |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
70 |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
71 Glob examples: |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
72 |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
73 glob:*.c any name ending in ".c" in the current directory |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
74 *.c any name ending in ".c" in the current directory |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
75 **.c any name ending in ".c" in the current directory, or |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
76 any subdirectory |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
77 foo/*.c any name ending in ".c" in the directory foo |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
78 foo/**.c any name ending in ".c" in the directory foo, or any |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
79 subdirectory |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
80 |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
81 Regexp examples: |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
82 |
1045
b35d5b86e240
run the doc/* through aspell.
Benoit Boissinot <benoit.boissinot@ens-lyon.org>
parents:
1036
diff
changeset
|
83 re:.*\.c$ any name ending in ".c", anywhere in the repository |
724
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
84 |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
85 |
580 | 86 SPECIFYING SINGLE REVISIONS |
87 --------------------------- | |
88 | |
89 Mercurial accepts several notations for identifying individual | |
90 revisions. | |
91 | |
92 A plain integer is treated as a revision number. Negative | |
93 integers are treated as offsets from the tip, with -1 denoting the | |
94 tip. | |
95 | |
96 A 40-digit hexadecimal string is treated as a unique revision | |
97 identifier. | |
98 | |
99 A hexadecimal string less than 40 characters long is treated as a | |
100 unique revision identifier, and referred to as a short-form | |
101 identifier. A short-form identifier is only valid if it is the | |
102 prefix of one full-length identifier. | |
103 | |
104 Any other string is treated as a tag name, which is a symbolic | |
105 name associated with a revision identifier. Tag names may not | |
106 contain the ":" character. | |
107 | |
108 The reserved name "tip" is a special tag that always identifies | |
109 the most recent revision. | |
110 | |
111 SPECIFYING MULTIPLE REVISIONS | |
112 ----------------------------- | |
113 | |
114 When Mercurial accepts more than one revision, they may be | |
115 specified individually, or provided as a continuous range, | |
116 separated by the ":" character. | |
117 | |
118 The syntax of range notation is [BEGIN]:[END], where BEGIN and END | |
119 are revision identifiers. Both BEGIN and END are optional. If | |
120 BEGIN is not specified, it defaults to revision number 0. If END | |
121 is not specified, it defaults to the tip. The range ":" thus | |
122 means "all revisions". | |
123 | |
124 If BEGIN is greater than END, revisions are treated in reverse | |
125 order. | |
126 | |
860
8ccbac05cf59
Use correct term "closed interval" for ranges.
Thomas Arendsen Hein <thomas@intevation.de>
parents:
840
diff
changeset
|
127 A range acts as a closed interval. This means that a range of 3:5 |
580 | 128 gives 3, 4 and 5. Similarly, a range of 4:2 gives 4, 3, and 2. |
196
48827121af7e
add export, recover, and undo to the man page
jake@edge2.net
parents:
182
diff
changeset
|
129 |
3252
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
130 DATE FORMATS |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
131 ------------ |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
132 |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
133 Some commands (backout, commit, tag) allow the user to specify a date. |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
134 Possible formats for dates are: |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
135 |
3286
9d5fcf1d6863
Put in backslash again, it was needed to disable an asciidoc macro.
Thomas Arendsen Hein <thomas@intevation.de>
parents:
3285
diff
changeset
|
136 YYYY-mm-dd \HH:MM[:SS] [(+|-)NNNN]:: |
3252
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
137 This is a subset of ISO 8601, allowing just the recommended notations |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
138 for date and time. The last part represents the timezone; if omitted, |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
139 local time is assumed. Examples: |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
140 |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
141 "2005-08-22 03:27 -0700" |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
142 |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
143 "2006-04-19 21:39:51" |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
144 |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
145 aaa bbb dd HH:MM:SS YYYY [(+|-)NNNN]:: |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
146 This is the date format used by the C library. Here, aaa stands for |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
147 abbreviated weekday name and bbb for abbreviated month name. The last |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
148 part represents the timezone; if omitted, local time is assumed. |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
149 Examples: |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
150 |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
151 "Mon Aug 22 03:27:00 2005 -0700" |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
152 |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
153 "Wed Apr 19 21:39:51 2006" |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
154 |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
155 unixtime offset:: |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
156 This is the internal representation format for dates. unixtime is |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
157 the number of seconds since the epoch (1970-01-01 00:00 UTC). offset |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
158 is the offset of the local timezone, in seconds west of UTC (negative |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
159 if the timezone is east of UTC). |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
160 Examples: |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
161 |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
162 "1124706420 25200" (2005-08-22 03:27:00 -0700) |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
163 |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
164 "1145475591 -7200" (2006-04-19 21:39:51 +0200) |
c9cd63a6fce9
Add documentation about the date formats allowed in the command line
Jose M. Prieto <jmprieto@gmx.net>
parents:
3018
diff
changeset
|
165 |
177 | 166 ENVIRONMENT VARIABLES |
167 --------------------- | |
438 | 168 |
478
f1804f2e7f35
Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents:
438
diff
changeset
|
169 HGEDITOR:: |
f1804f2e7f35
Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents:
438
diff
changeset
|
170 This is the name of the editor to use when committing. Defaults to the |
1216
1639fc7c2ccf
Cleanup of tabs and trailing spaces in documentation.
Thomas Arendsen Hein <thomas@intevation.de>
parents:
1212
diff
changeset
|
171 value of EDITOR. |
608
d2994b5298fb
Add username/merge/editor to .hgrc
Matt Mackall <mpm@selenic.com>
parents:
606
diff
changeset
|
172 |
d2994b5298fb
Add username/merge/editor to .hgrc
Matt Mackall <mpm@selenic.com>
parents:
606
diff
changeset
|
173 (deprecated, use .hgrc) |
478
f1804f2e7f35
Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents:
438
diff
changeset
|
174 |
177 | 175 HGMERGE:: |
498 | 176 An executable to use for resolving merge conflicts. The program |
438 | 177 will be executed with three arguments: local file, remote file, |
178 ancestor file. | |
179 | |
180 The default program is "hgmerge", which is a shell script provided | |
181 by Mercurial with some sensible defaults. | |
177 | 182 |
608
d2994b5298fb
Add username/merge/editor to .hgrc
Matt Mackall <mpm@selenic.com>
parents:
606
diff
changeset
|
183 (deprecated, use .hgrc) |
d2994b5298fb
Add username/merge/editor to .hgrc
Matt Mackall <mpm@selenic.com>
parents:
606
diff
changeset
|
184 |
1951
696230e52e4d
add HGRCPATH env var, list of places to look for hgrc files.
Vadim Gelfer <vadim.gelfer@gmail.com>
parents:
1920
diff
changeset
|
185 HGRCPATH:: |
696230e52e4d
add HGRCPATH env var, list of places to look for hgrc files.
Vadim Gelfer <vadim.gelfer@gmail.com>
parents:
1920
diff
changeset
|
186 A list of files or directories to search for hgrc files. Item |
696230e52e4d
add HGRCPATH env var, list of places to look for hgrc files.
Vadim Gelfer <vadim.gelfer@gmail.com>
parents:
1920
diff
changeset
|
187 separator is ":" on Unix, ";" on Windows. If HGRCPATH is not set, |
696230e52e4d
add HGRCPATH env var, list of places to look for hgrc files.
Vadim Gelfer <vadim.gelfer@gmail.com>
parents:
1920
diff
changeset
|
188 platform default search path is used. If empty, only .hg/hgrc of |
696230e52e4d
add HGRCPATH env var, list of places to look for hgrc files.
Vadim Gelfer <vadim.gelfer@gmail.com>
parents:
1920
diff
changeset
|
189 current repository is read. |
696230e52e4d
add HGRCPATH env var, list of places to look for hgrc files.
Vadim Gelfer <vadim.gelfer@gmail.com>
parents:
1920
diff
changeset
|
190 |
696230e52e4d
add HGRCPATH env var, list of places to look for hgrc files.
Vadim Gelfer <vadim.gelfer@gmail.com>
parents:
1920
diff
changeset
|
191 For each element in path, if a directory, all entries in directory |
696230e52e4d
add HGRCPATH env var, list of places to look for hgrc files.
Vadim Gelfer <vadim.gelfer@gmail.com>
parents:
1920
diff
changeset
|
192 ending with ".rc" are added to path. Else, element itself is |
696230e52e4d
add HGRCPATH env var, list of places to look for hgrc files.
Vadim Gelfer <vadim.gelfer@gmail.com>
parents:
1920
diff
changeset
|
193 added to path. |
696230e52e4d
add HGRCPATH env var, list of places to look for hgrc files.
Vadim Gelfer <vadim.gelfer@gmail.com>
parents:
1920
diff
changeset
|
194 |
177 | 195 HGUSER:: |
438 | 196 This is the string used for the author of a commit. |
177 | 197 |
608
d2994b5298fb
Add username/merge/editor to .hgrc
Matt Mackall <mpm@selenic.com>
parents:
606
diff
changeset
|
198 (deprecated, use .hgrc) |
d2994b5298fb
Add username/merge/editor to .hgrc
Matt Mackall <mpm@selenic.com>
parents:
606
diff
changeset
|
199 |
177 | 200 EMAIL:: |
438 | 201 If HGUSER is not set, this will be used as the author for a commit. |
177 | 202 |
203 LOGNAME:: | |
478
f1804f2e7f35
Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents:
438
diff
changeset
|
204 If neither HGUSER nor EMAIL is set, LOGNAME will be used (with |
438 | 205 '@hostname' appended) as the author value for a commit. |
177 | 206 |
207 EDITOR:: | |
478
f1804f2e7f35
Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents:
438
diff
changeset
|
208 This is the name of the editor used in the hgmerge script. It will be |
498 | 209 used for commit messages if HGEDITOR isn't set. Defaults to 'vi'. |
438 | 210 |
211 PYTHONPATH:: | |
212 This is used by Python to find imported modules and may need to be set | |
213 appropriately if Mercurial is not installed system-wide. | |
177 | 214 |
215 FILES | |
216 ----- | |
217 .hgignore:: | |
438 | 218 This file contains regular expressions (one per line) that describe file |
2209
956e329f9e13
document hgignore syntax in new file doc/hgignore.5.txt.
Vadim Gelfer <vadim.gelfer@gmail.com>
parents:
2031
diff
changeset
|
219 names that should be ignored by hg. For details, see hgignore(5). |
177 | 220 |
221 .hgtags:: | |
438 | 222 This file contains changeset hash values and text tag names (one of each |
1045
b35d5b86e240
run the doc/* through aspell.
Benoit Boissinot <benoit.boissinot@ens-lyon.org>
parents:
1036
diff
changeset
|
223 separated by spaces) that correspond to tagged versions of the repository |
177 | 224 contents. |
225 | |
951
859de3ebc041
Read global config file /etc/mercurial/hgrc and fix reading hgrc on Windows.
Thomas Arendsen Hein <thomas@intevation.de>
parents:
940
diff
changeset
|
226 /etc/mercurial/hgrc, $HOME/.hgrc, .hg/hgrc:: |
438 | 227 This file contains defaults and configuration. Values in .hg/hgrc |
951
859de3ebc041
Read global config file /etc/mercurial/hgrc and fix reading hgrc on Windows.
Thomas Arendsen Hein <thomas@intevation.de>
parents:
940
diff
changeset
|
228 override those in $HOME/.hgrc, and these override settings made in the |
859de3ebc041
Read global config file /etc/mercurial/hgrc and fix reading hgrc on Windows.
Thomas Arendsen Hein <thomas@intevation.de>
parents:
940
diff
changeset
|
229 global /etc/mercurial/hgrc configuration. See hgrc(5) for details of |
859de3ebc041
Read global config file /etc/mercurial/hgrc and fix reading hgrc on Windows.
Thomas Arendsen Hein <thomas@intevation.de>
parents:
940
diff
changeset
|
230 the contents and format of these files. |
321 | 231 |
3018
b9dbbcf8a488
Document the fact that revert might overwrite .orig files
Benoit Boissinot <benoit.boissinot@ens-lyon.org>
parents:
2858
diff
changeset
|
232 Some commands (e.g. revert) produce backup files ending in .orig, if |
b9dbbcf8a488
Document the fact that revert might overwrite .orig files
Benoit Boissinot <benoit.boissinot@ens-lyon.org>
parents:
2858
diff
changeset
|
233 the .orig file already exists and is not tracked by Mercurial, it |
b9dbbcf8a488
Document the fact that revert might overwrite .orig files
Benoit Boissinot <benoit.boissinot@ens-lyon.org>
parents:
2858
diff
changeset
|
234 will be overwritten. |
b9dbbcf8a488
Document the fact that revert might overwrite .orig files
Benoit Boissinot <benoit.boissinot@ens-lyon.org>
parents:
2858
diff
changeset
|
235 |
177 | 236 BUGS |
237 ---- | |
238 Probably lots, please post them to the mailing list (See Resources below) | |
239 when you find them. | |
240 | |
671
efa4a7e2f322
Move hgrc documentation out to its own man page, hgrc(5).
Bryan O'Sullivan <bos@serpentine.com>
parents:
631
diff
changeset
|
241 SEE ALSO |
efa4a7e2f322
Move hgrc documentation out to its own man page, hgrc(5).
Bryan O'Sullivan <bos@serpentine.com>
parents:
631
diff
changeset
|
242 -------- |
2209
956e329f9e13
document hgignore syntax in new file doc/hgignore.5.txt.
Vadim Gelfer <vadim.gelfer@gmail.com>
parents:
2031
diff
changeset
|
243 hgignore(5), hgrc(5) |
671
efa4a7e2f322
Move hgrc documentation out to its own man page, hgrc(5).
Bryan O'Sullivan <bos@serpentine.com>
parents:
631
diff
changeset
|
244 |
177 | 245 AUTHOR |
246 ------ | |
247 Written by Matt Mackall <mpm@selenic.com> | |
248 | |
249 RESOURCES | |
250 --------- | |
251 http://selenic.com/mercurial[Main Web Site] | |
252 | |
253 http://selenic.com/hg[Source code repository] | |
254 | |
255 http://selenic.com/mailman/listinfo/mercurial[Mailing list] | |
256 | |
257 COPYING | |
258 ------- | |
2858 | 259 Copyright \(C) 2005, 2006 Matt Mackall. |
177 | 260 Free use of this software is granted under the terms of the GNU General |
261 Public License (GPL). |