Skip to content

Commit 129b8e3

Browse files
committed
docs glossary: clarify the definition of a change id
I wanted to mention the fact that a full change id is 32 reverse-hexadecimal letters long. Before, the text could be interpreted as though it was 12 or 16.
1 parent ce7e185 commit 129b8e3

File tree

1 file changed

+10
-4
lines changed

1 file changed

+10
-4
lines changed

docs/glossary.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -49,10 +49,16 @@ ID is a property of a commit.
4949

5050
## Change ID
5151

52-
A change ID is a unique identifier for a [change](#change). They are typically
53-
16 bytes long and are often randomly generated. By default, `jj log` presents
54-
them as a sequence of 12 letters in the k-z range, at the beginning of a line.
55-
These are actually hexadecimal numbers that use "digits" z-k instead of 0-9a-f.
52+
A change ID is a unique identifier for a [change](#change).
53+
54+
A change id typically consists of 16 bytes of information, usually
55+
randomly generated when a change is created. A full change id, as shown
56+
by e.g. `jj show`, is displayed to the user as a sequence of 32 letters
57+
in the `k-z` range. These are actually hexadecimal numbers that use
58+
"digits" z-k instead of 0-9a-f.
59+
60+
By default, `jj log` presents a 12-letter prefix of the 32-letter change
61+
id, at the beginning of a line.
5662

5763
## Commit
5864

0 commit comments

Comments
 (0)