From: Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
Date: Sat, 07 Feb 2026 14:24:05 GMT
Subject: Re: [PATCH v4 0/4] doc: some more synopsis conversions and fixes
Message-ID: <879fc9f4-e1a1-4b79-9086-b7278de5a1fb@app.fastmail.com>
In-Reply-To: <pull.2036.v4.git.1770351146.gitgitgadget@gmail.com>

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/4e15eb56-a6d6-42da-97ba-86367eb9102b@free.fr/#t