Re: [PATCH v2 1/2] doc/pack-refs: convert synopsis and options to new style

From: Todd Zullinger <tmz@pobox.com>
Date: Sep 14, 2026, 15:43 UTC
Message-ID: <20260914154350.LjUwy8DF@teonanacatl.net>
In-Reply-To: <xmqqcxuf7svp.fsf@gitster.g>

Junio C Hamano wrote:

Show 14 quoted lines

> 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.

Thanks for spotting.

-- 
Todd