Re: [PATCH 1/4] doc: am: normalize git(1) command links
- From
Kristoffer Haugsbakk <code@khaugsbakk.name>
- Date
- Feb 11, 2026, 17:32 UTC
- 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:
Show 25 quoted lines
> 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]