diff options
| author | Junio C Hamano <gitster@pobox.com> | 2021-06-10 12:53:56 +0900 |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2021-06-10 12:53:56 +0900 |
| commit | 37c77fd2893de182d484f65cca6ba011fe633019 (patch) | |
| tree | d0d7faa8ef69c255ae158f80754e3ee1b15fec90 /git-describe.html | |
| parent | 7cac38b31559760e4baa97b11aa0356cc96485d4 (diff) | |
| download | git-htmldocs-37c77fd2893de182d484f65cca6ba011fe633019.tar.gz | |
Autogenerated HTML docs for v2.32.0-29-g211ec
Diffstat (limited to 'git-describe.html')
| -rw-r--r-- | git-describe.html | 16 |
1 files changed, 10 insertions, 6 deletions
diff --git a/git-describe.html b/git-describe.html index 206ff9c61..b136235af 100644 --- a/git-describe.html +++ b/git-describe.html @@ -840,9 +840,10 @@ from HEAD.</p></div> </dt>
<dd>
<p>
- Instead of using the default 7 hexadecimal digits as the
- abbreviated object name, use <n> digits, or as many digits
- as needed to form a unique object name. An <n> of 0
+ Instead of using the default number of hexadecimal digits (which
+ will vary according to the number of objects in the repository with
+ a default of 7) of the abbreviated object name, use <n> digits, or
+ as many digits as needed to form a unique object name. An <n> of 0
will suppress long format, only showing the closest tag.
</p>
</dd>
@@ -960,8 +961,11 @@ an abbreviated object name for the commit itself ("2414721") at the end.</p></div>
<div class="paragraph"><p>The number of additional commits is the number
of commits which would be displayed by "git log v1.0.4..parent".
-The hash suffix is "-g" + unambiguous abbreviation for the tip commit
-of parent (which was <code>2414721b194453f058079d897d13c4e377f92dc6</code>).
+The hash suffix is "-g" + an unambigous abbreviation for the tip commit
+of parent (which was <code>2414721b194453f058079d897d13c4e377f92dc6</code>). The
+length of the abbreviation scales as the repository grows, using the
+approximate number of objects in the repository and a bit of math
+around the birthday paradox, and defaults to a minimum of 7.
The "g" prefix stands for "git" and is used to allow describing the version of
a software depending on the SCM the software is managed with. This is useful
in an environment where people may use different SCMs.</p></div>
@@ -1038,7 +1042,7 @@ tag being favorable.</p></div> <div id="footer">
<div id="footer-text">
Last updated
- 2020-03-11 00:03:13 JST
+ 2021-06-10 12:50:35 JST
</div>
</div>
</body>
|