Diff for "ChangeSetID"

Differences between revisions 2 and 8 (spanning 6 versions)

Changeset ID

A changeset ID is a 160-bit identifier that uniquely describes a [:ChangeSet:changeset] and its position in the change history of a [:Repository:repository], regardless of which machine or repository it's on. This is represented to the user as a 40 digit hexadecimal number. Technically, a changeset ID is a [:Nodeid:nodeid].

Short-form Changeset IDs

Since a 40 digit hex number is unwieldy, Mercurial will accept any unambiguous prefix of a changeset ID as shorthand for that ID.

When printing a changeset ID, Mercurial usually prints just the first twelve characters. This is called the "short form" of the ID.

Note: a short-form ID can start out valid, but become invalid because another changeset with the same prefix shows up later on. Do not use short-form IDs for long-lived representations. You can use the --debug option to display the full changeset ID. For example:

$ hg --debug tags
tip                                1:1ef7872431f9c64908c732f0bcd4db5700b4cb70
test-tag                           0:1438e82fac1c2191394e67257b7b94e05c7caa2f

Revision numbers are shorthand

Within a single repository, you can use a [:RevisionNumber:revision number] as shorthand for a changeset ID.

CategoryGlossary

-  ⇤ ← Revision 2 as of 2005-08-26 01:22:44 → 
  Size: 887
  Editor: waste
  Comment:
+   ← Revision 8 as of 2008-09-24 05:19:47 → ⇥
  Size: 1308
  Editor: BenAndre
  Comment: It wasn't clear how to get Mercurial to display the full changeset ID.
-Deletions are marked like this.
+Additions are marked like this.
 Line 3:
-A ChangeSet ID is a 160-bit
identifier that uniquely describes a ChangeSet and its position in the
change history, regardless of which machine it's on. This is
represented to the user as a 40 digit hexadecimal number.
+A '''changeset ID''' is a 160-bit
identifier that uniquely describes a [:ChangeSet:changeset] and its position in the
change history of a [:Repository:repository], regardless of which machine or repository it's on. This is
represented to the user as a 40 digit hexadecimal number. Technically, a changeset ID is a [:Nodeid:nodeid].
 Line 8:
-=== Short-form Changeset !IDs ===
+=== Short-form Changeset IDs ===
 Line 10:
-Since a 40 digit hex number is unwieldy, ["Mercurial"] will accept any unambiguous prefix of a ChangeSet ID as shorthand for that ID.
+Since a 40 digit hex number is unwieldy, Mercurial will accept any unambiguous prefix of a changeset ID as shorthand for that ID.
 Line 12:
-When printing a ChangeSet ID, Mercurial usually prints just the first twelve characters.  This is called the "short form" of the ID.
+When printing a changeset ID, Mercurial usually prints just the first twelve characters.  This is called the "short form" of the ID.
 Line 14:
-'''Note''': a short-form ID can start out valid, but become invalid because another ChangeSet with the same prefix shows up later on.  Do not use short-form I``Ds for long-lived representations.
+'''Note''': a short-form ID can start out valid, but become invalid because another changeset with the same prefix shows up later on.  Do not use short-form I``Ds for long-lived representations. You can use the `--debug` option to display the full changeset ID. For example:
{{{
$ hg --debug tags
tip                                1:1ef7872431f9c64908c732f0bcd4db5700b4cb70
test-tag                           0:1438e82fac1c2191394e67257b7b94e05c7caa2f
}}}
-Line 18:
+Line 23:
-Within a single repository, you can use a RevisionNumber as shorthand for a changeset ID.
+Within a single repository, you can use a [:RevisionNumber:revision number] as shorthand for a changeset ID.

----
CategoryGlossary