On Fri, Oct 29, 2021 at 2:45 PM Eli Schwartz <eschwartz@xxxxxxxxxxxxx> wrote: > The %(describe) placeholder by default, like `git describe`, uses a > seven-character abbreviated commit object name. This may not be > sufficient to fully describe all commits in a given repository, > resulting in a placeholder replacement changing its length because the > repository grew in size. This could cause the output of git-archive to > change. > > Add the --abbrev option to `git describe` to the placeholder interface > in order to provide tools to the user for fine-tuning project defaults > and ensure reproducible archives. > [...] > Signed-off-by: Eli Schwartz <eschwartz@xxxxxxxxxxxxx> > --- > diff --git a/Documentation/pretty-formats.txt b/Documentation/pretty-formats.txt > @@ -222,6 +222,10 @@ The placeholders are: > +** 'abbrev=<N>': 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. There's still an inconsistent mix of `<N>` and `<n>` here (mentioned in my earlier review). Is that intentional or just a simple oversight?
