Re: [PATCH v3 0/2] doc: refs: put ref migration warning under the command

Karthik Nayak <[email protected]> Thu, 6 Aug 2026 04:01:12 -0700

Newsgroups	org.kernel.vger.git
Message-ID	<CAOLa=ZQQnrRca60BAfnm6Azu=bHvnoVhcGwQ3KkDT7yqLDd8Dw@mail.gmail.com>

[email protected] writes:

> From: Kristoffer Haugsbakk <[email protected]>
>
> Topic name (applied): doc-refs-migrate-limitations
>
> Topic summary: Put ref migration warning as an admonition under the command
> so that it is visible.
>
> That’s the first patch. The second patch adds a missing `linkgit` since it
> touches that same warning text.
>
> I have two other patches that are not included here. They are unrelated
> cleanups that I will post later. Here are the commit subjects and the first
> paragraph so that you can see what they are about:
>
> • doc: refs: wrap standalone placeholders in underscores
>
>   This is a synopsis manpage which means that standalone placeholders[1]
>   are supposed to use underscores (_), not backticks (`).[2]
> • doc: refs: use inline-verbatim throughout
>
>   Use inline-verbatim backticks (`) for literal commands, options, and
>   subcommands listed under the “Commands” section.
>
> § Cc list
>
> The two people that I have the impression that have worked most on
> this command.
>

Sorry for the late review, been a bit busy. The two patches look good to
me! Thanks!

signature.asc (application/pgp-signature, 690 B)