Diff for "RevisionNumber"

Differences between revisions 7 and 8

Revision number

A revision number is a small integer.

It is a strictly local convenience identifier for a [:Revision:revision]. It can be useful as it is shorter to type than the 40-digit hexadecimal string that uniquely identifies a revision.

Common usage

Although all files have revision numbers, revision numbers are almost always used to identify a [:ChangeSet:changeset] within a given [:Repository:repository].

Pitfalls

Revision numbers referring to changesets are very likely to be different in another copy of a repository. Do not use them to talk about changesets with other people. Use the [:ChangeSetID:changeset ID] instead.

Notes

An empty repository (with no changesets) has a revision number -1, which corresponds to the nullid [:Nodeid:nodeid]. For example:

$ hg log
$ hg status
$ hg head
changeset:   -1:000000000000
tag:         tip
user:
date:        Thu Jan 01 00:00:00 1970 +0000

CategoryGlossary

-  ⇤ ← Revision 7 as of 2008-01-13 10:03:17 → 
  Size: 717
  Editor: abuehl
  Comment: lowercase links, minor rewording
+   ← Revision 8 as of 2008-06-06 18:27:21 → ⇥
  Size: 1016
  Editor: MichaelPloujnikov
  Comment: added a note about -1 revision and nullid
-Deletions are marked like this.
+Additions are marked like this.
 Line 15:
+=== Notes ===
An empty repository (with no changesets) has a revision number -1, which corresponds to the '''nullid''' [:Nodeid:nodeid].
For example:
{{{
$ hg log
$ hg status
$ hg head
changeset:   -1:000000000000
tag:         tip
user:
date:        Thu Jan 01 00:00:00 1970 +0000
}}}