From: Todd Zullinger <tmz@pobox.com>
Date: Tue, 15 Sep 2026 13:15:09 GMT
Subject: Re: [PATCH v2 1/2] doc/pack-refs: convert synopsis and options to new style
Message-ID: <20260915131509.EztJBORN@teonanacatl.net>
In-Reply-To: <20260914154350.LjUwy8DF@teonanacatl.net>

I wrote:
> Junio C Hamano wrote:
>> Todd Zullinger <tmz@pobox.com> writes:
>> 
>>> Replace [verse] with [synopsis] in the SYNOPSIS block and remove
>>> single-quote formatting from the command name.
>>>
>>> Backtick-quote all option terms in the OPTIONS section and convert
>>> the standalone placeholder _<branch>_ in prose.
>>>
>>> Update the included pack-refs-options.adoc to backtick-quote all
>>> configuration key terms.
>> 
>> Micronit.  I think you backtick-quoted `--all`, `--no-prune`, and
>> friends, that are not configuration keyu terms but command line
>> options.
> 
> Ahh, right you are.  That was due to my re-use of an earlier
> example from Jean-Noël's work and an incomplete
> proof-reading.  So I'll want to change "configuration key
> terms" to something like "option terms" to match what
> previous commits have used for similar changes.

In looking at that commit message further, I update the
wording slightly as there are no options in the OPTION
section which are not part of pack-refs-options.adoc.  I
condensed that to a single, more accurate sentence.

With luck, v3 is now ready to go.

Thanks,

-- 
Todd