Subject: Re: [PATCH 1/4] doc: am: normalize git(1) command links

From: "Kristoffer Haugsbakk" <[email-masked]>
Date: Wed, 11 Feb 2026 18:32:15 +0100

On Mon, Feb 9, 2026, at 18:34, [email-masked] wrote:
> From: Kristoffer Haugsbakk <[email-masked]>
>
> There are many mentions of commands using inline-verbatim or
> emphasis ('). We just mention the command themselves, not specific
> invocations like `git am <opts>`. Let’s link to them instead.
>
> There are also many such mentions which then link to the command right
> afterwards. Simplify to just using a link.
>
> Also remove “see <gitlink>” phrases where they have now already
> been mentioned.
>
> Signed-off-by: Kristoffer Haugsbakk <[email-masked]>
>[snip]
> diff --git a/Documentation/git-am.adoc b/Documentation/git-am.adoc
>[snip]
>  Valid <action> for the `--whitespace` option are:
>  `nowarn`, `warn`, `fix`, `error`, and `error-all`.
> @@ -205,7 +203,8 @@ applying.
>  	to the screen before exiting.  This overrides the
>  	standard message informing you to use `--continue`
>  	or `--skip` to handle the failure.  This is solely
> -	for internal use between 'git rebase' and 'git am'.
> +	for internal use between linkgit:git-rebase[1] and
> +	linkgit:git-am[1].

Jean-Noël, regarding [this]. This change adds a lot of self-references:
git-am(1) inside the git-am(1) doc. Is that problematic?

[this]: https://lore.kernel.org/git/[email-masked]/

>[snip]