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

Re: [PATCH] pretty-options.txt: fix --no-abbrev-commit description

From
Junio C Hamano <gitster@pobox.com>
Date
Aug 27, 2020, 04:32 UTC
Message-ID
<xmqqd03cso7o.fsf@gitster.c.googlers.com>
In-Reply-To
<20200827042530.GE3346457@coredump.intra.peff.net>
Jeff King <peff@peff.net> writes:
Show 40 quoted lines
> On Wed, Aug 26, 2020 at 03:07:52PM -0700, Junio C Hamano wrote:
>
>> Sergey Organov <sorganov@gmail.com> writes:
>> 
>> >> Keeping the original sentence structure, e.g.
>> >>
>> >>     ... and those options which imply abbreviating commit object names
>> >>     such as ...
>> >>
>> >> would have been what I wrote, instead of "either explicit or implied
>> >> by", though.
>> >
>> > Sorry, but it'd then read:
>> >
>> >   This negates `--abbrev-commit` and those options which imply
>> >   abbreviating commit object names such as "--oneline".
>> >
>> > that again essentially reduces to:
>> >
>> >   This negates "--oneline"
>> 
>> "--oneline" means a lot more than "do not use full object name", and
>> I think we are on the same page with our shared goal of not negating
>> everything "--oneline" means.  We just want to say the option
>> negates only the "do not use full object name" aspect.
>> 
>> "and the effect of abbreviating commit objects implied by other
>> options, such as '--oneline'" may be a more verbose way to say the
>> same thing, I would think, but that would be overkill.  I would have
>> expected that with common sense readers would think it would be
>> crazy for --no-abbrev to override everything --oneline means, but if
>> you found that the original risks such an interpretation, perhaps we
>> would need to be more verbose and explicit.  I dunno.
>
> FWIW, as a third-party observer (because you wanted more opinions,
> right?), I found the result of Sergey's original patch easy to read and
> understand.
>
> I also think it's unlikely for people to misinterpret the current text,
> but it does not hurt to be more precise just in case.
Yup, I think I said the same already ;-)
Previous: Jeff King
Message 6 of 6 in “pretty-options.txt: fix --no-abbrev-commit description”
  1. pretty-options.txt: fix --no-abbrev-commit descriptionSergey Organov, Aug 26, 2020
  2. Junio C HamanoAug 26, 2020
  3. Sergey OrganovAug 26, 2020
  4. Junio C HamanoAug 26, 2020
  5. Jeff KingAug 27, 2020
  6. Junio C HamanoAug 27, 2020

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.