Mercurial > public > mercurial-scm > hg-stable

comparison mercurial/help.py @ 9302:73bec717b825

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
help: improve "hg help revisions" Add info about branch names, and other clarifications.
author Stuart W Marks <smarks@smarks.org>
date Sun, 02 Aug 2009 19:21:47 -0700
parents 42956a93db3a
children c9d71b317832 74e717a21779 9bf49b37a32c
comparison
equal deleted inserted replaced
9287:53fdf18fd63b 9302:73bec717b825
262 (['revs', 'revisions'], _('Specifying Single Revisions'), 262 (['revs', 'revisions'], _('Specifying Single Revisions'),
263 _(r''' 263 _(r'''
264 Mercurial supports several ways to specify individual revisions. 264 Mercurial supports several ways to specify individual revisions.
265 265
266 A plain integer is treated as a revision number. Negative integers 266 A plain integer is treated as a revision number. Negative integers
267 are treated as topological offsets from the tip, with -1 denoting 267 are treated as sequential offsets from the tip, with -1 denoting
268 the tip. As such, negative numbers are only useful if you've 268 the tip, -2 denoting the revision prior to the tip, and so forth.
269 memorized your local tree numbers and want to save typing a single
270 digit. This editor suggests copy and paste.
271 269
272 A 40-digit hexadecimal string is treated as a unique revision 270 A 40-digit hexadecimal string is treated as a unique revision
273 identifier. 271 identifier.
274 272
275 A hexadecimal string less than 40 characters long is treated as a 273 A hexadecimal string less than 40 characters long is treated as a
276 unique revision identifier, and referred to as a short-form 274 unique revision identifier and is referred to as a short-form
277 identifier. A short-form identifier is only valid if it is the 275 identifier. A short-form identifier is only valid if it is the
278 prefix of exactly one full-length identifier. 276 prefix of exactly one full-length identifier.
279 277
280 Any other string is treated as a tag name, which is a symbolic 278 Any other string is treated as a tag or branch name. A tag name is
281 name associated with a revision identifier. Tag names may not 279 a symbolic name associated with a revision identifier. A branch
282 contain the ":" character. 280 name denotes the tipmost revision of that branch. Tag and branch
281 names must not contain the ":" character.
283 282
284 The reserved name "tip" is a special tag that always identifies 283 The reserved name "tip" is a special tag that always identifies
285 the most recent revision. 284 the most recent revision.
286 285
287 The reserved name "null" indicates the null revision. This is the 286 The reserved name "null" indicates the null revision. This is the