From: Kristoffer Haugsbakk <code@khaugsbakk.name>
Date: Wed, 11 Feb 2026 17:32:15 GMT
Subject: Re: [PATCH 1/4] doc: am: normalize git(1) command links
Message-ID: <1a05ca33-dda0-4315-970d-b61a3f48a8f4@app.fastmail.com>
In-Reply-To: <git-am_gitlinks.322@msgid.xyz>

On Mon, Feb 9, 2026, at 18:34, kristofferhaugsbakk@fastmail.com wrote:
> From: Kristoffer Haugsbakk <code@khaugsbakk.name>
>
> 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 <code@khaugsbakk.name>
>[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/1a4060f1-6607-4b50-859d-927642eb34df@free.fr/

>[snip]