git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] describe-doc: clarify default length of abbreviation

From
Bagas Sanjaya <bagasdotme@gmail.com>
Date
May 16, 2021, 12:00 UTC
Message-ID
<1dc7877e-adb4-e3f5-3b59-bd45f9673596@gmail.com>
In-Reply-To
<pull.1026.git.git.1621150366442.gitgitgadget@gmail.com>
On 16/05/21 14.32, Anders Höckersten via GitGitGadget wrote:
  >   --abbrev=<n>::
Show 10 quoted lines
> -	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
> -	will suppress long format, only showing the closest tag.
> +	Instead of using the default number of hexadecimal digits (which
> +	will vary according to the size of 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.
>   

I think the more correct is the abbreviated hash length is determined by number of objects.

Show 13 quoted lines
>   --candidates=<n>::
>   	Instead of considering only the 10 most recent tags as
> @@ -139,8 +140,11 @@ at the end.
>   
>   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 `2414721b194453f058079d897d13c4e377f92dc6`).
> +The hash suffix is "-g" + an unambigous abbreviation for the tip commit
> +of parent (which was `2414721b194453f058079d897d13c4e377f92dc6`). 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.
What is the birthday paradox then?
Also, better say "... and by default the minimum length is 7.".
Thanks.
-- 
An old man doll... just what I always wanted! - Clara
Previous: Junio C HamanoNext: Anders Höckersten
Message 3 of 11 in “describe-doc: clarify default length of abbreviation”
  1. describe-doc: clarify default length of abbreviationAnders Höckersten via GitGitGadget, May 16, 2021
  2. Junio C HamanoMay 16, 2021
  3. Bagas SanjayaMay 16, 2021
  4. Anders HöckerstenMay 16, 2021
  5. Junio C HamanoMay 16, 2021
  6. Anders HöckerstenMay 17, 2021
  7. Felipe ContrerasMay 16, 2021
  8. Robert P. J. DayMay 16, 2021
  9. Felipe ContrerasMay 16, 2021
  10. describe-doc: clarify default length of abbreviationAnders Höckersten via GitGitGadget, May 17, 2021
  11. Derrick StoleeMay 17, 2021

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.