Subject: Re: [PATCH v4 0/4] doc: some more synopsis conversions and fixes

From: "Kristoffer Haugsbakk" <[email-masked]>
Date: Sat, 07 Feb 2026 15:24:05 +0100

On Fri, Feb 6, 2026, at 05:12, Jean-Noël Avila via GitGitGadget wrote:
> This time, git-show and git-submodule are converted. Some mistakes on
> previous work were also spotted and fixed.
>
> Changes since V1:
>
>  * fix mistakes spotted by Kristoffer Haugsbakk Changes since V2:
>  * more fixes Changes since V3:
>  * again more fixes, origin and HEAD
>
> Jean-Noël Avila (4):
>   doc: convert git-submodule to synopsis style
>   doc: finalize git-clone documentation conversion to synopsis style
>   doc: fix some style issues in git-clone and for-each-ref-options
>   doc: convert git-show to synopsis style
>
>[snip]
>
> Range-diff vs v3:
>[snip]

The range diff looks great. `Documentation/doc-diff` also looks good.

The only thing is that “the HEAD”.[1] But I did a search for that phrase
with something like

    cd Documentation
    git grep 'the .\?HEAD' -- ':^RelNotes'

And there are many hits throughout the docs. So I think it’s best to let
that one rest for now.

In my little opinion this series is ready.

Thanks.

🔗 1: https://lore.kernel.org/git/[email-masked]/#t