Mercurial > hg
comparison mercurial/help.py @ 6655:ab798a37b846
help: move "revision syntax" help topics into online help
Move the "Specifying Single Revisions" and "Specifying Multiple
Revisions" help topics from the manual page into the helptable
so they are available both online and in the manual page.
author | Johannes Stezenbach <js@sig21.net> |
---|---|
date | Tue, 03 Jun 2008 21:20:52 +0200 |
parents | 2713e42dcf4e |
children | c68f84448012 |
comparison
equal
deleted
inserted
replaced
6654:2713e42dcf4e | 6655:ab798a37b846 |
---|---|
159 | 159 |
160 PYTHONPATH:: | 160 PYTHONPATH:: |
161 This is used by Python to find imported modules and may need to be set | 161 This is used by Python to find imported modules and may need to be set |
162 appropriately if Mercurial is not installed system-wide. | 162 appropriately if Mercurial is not installed system-wide. |
163 '''), | 163 '''), |
164 | |
165 ('revs|revisions|Specifying Single Revisions', | |
166 r''' | |
167 Mercurial accepts several notations for identifying individual | |
168 revisions. | |
169 | |
170 A plain integer is treated as a revision number. Negative | |
171 integers are treated as offsets from the tip, with -1 denoting the | |
172 tip. | |
173 | |
174 A 40-digit hexadecimal string is treated as a unique revision | |
175 identifier. | |
176 | |
177 A hexadecimal string less than 40 characters long is treated as a | |
178 unique revision identifier, and referred to as a short-form | |
179 identifier. A short-form identifier is only valid if it is the | |
180 prefix of one full-length identifier. | |
181 | |
182 Any other string is treated as a tag name, which is a symbolic | |
183 name associated with a revision identifier. Tag names may not | |
184 contain the ":" character. | |
185 | |
186 The reserved name "tip" is a special tag that always identifies | |
187 the most recent revision. | |
188 | |
189 The reserved name "null" indicates the null revision. This is the | |
190 revision of an empty repository, and the parent of revision 0. | |
191 | |
192 The reserved name "." indicates the working directory parent. If | |
193 no working directory is checked out, it is equivalent to null. | |
194 If an uncommitted merge is in progress, "." is the revision of | |
195 the first parent. | |
196 '''), | |
197 | |
198 ('mrevs|multirevs|Specifying Multiple Revisions', | |
199 r''' | |
200 When Mercurial accepts more than one revision, they may be | |
201 specified individually, or provided as a continuous range, | |
202 separated by the ":" character. | |
203 | |
204 The syntax of range notation is [BEGIN]:[END], where BEGIN and END | |
205 are revision identifiers. Both BEGIN and END are optional. If | |
206 BEGIN is not specified, it defaults to revision number 0. If END | |
207 is not specified, it defaults to the tip. The range ":" thus | |
208 means "all revisions". | |
209 | |
210 If BEGIN is greater than END, revisions are treated in reverse | |
211 order. | |
212 | |
213 A range acts as a closed interval. This means that a range of 3:5 | |
214 gives 3, 4 and 5. Similarly, a range of 4:2 gives 4, 3, and 2. | |
215 '''), | |
164 ) | 216 ) |