Re: [PATCH 2/4] doc: finalize git-clone documentation conversion to synopsis style

From: Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
Date: Feb 2, 2026, 08:36 UTC
Message-ID: <bc69a105-5621-4ecb-b89e-82bbe1c4bc51@app.fastmail.com>
In-Reply-To: <13939780.uLZWGnKmhe@piment-oiseau>

On Sun, Feb 1, 2026, at 14:14, Jean-Noël AVILA wrote:

Show 13 quoted lines

>>[snip]
>>
>> Doesn’t need to be done now in this series, but the “stuck form” of
>> `--origin=<name>` is recommended by gitcli(7) for long optoins. This doc
>> uses a mix of unstuck form (no `=`) and stuck form.
>>
>
> Is this something that is automatically available, i.e can we already convert
> and advise so to writers in all pages?
> For me, these synopsis series are a chance to push forward a larger range of
> reworks on formal formats such as this one.
>
>[snip]

I am not aware of any static analysis tool or helper.

I think I learned about in this combination with that gitcli(7) as well as Junio writing about the preferred way to write options.

Thanks

Kristoffer