Thread (7 messages) 7 messages, 3 authors, 2026-02-11

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

From: Kristoffer Haugsbakk <hidden>
Date: 2026-02-11 17:32:47

On Mon, Feb 9, 2026, at 18:34, kristofferhaugsbakk@fastmail.com wrote:
quoted hunk ↗ jump to hunk
From: Kristoffer Haugsbakk <redacted>

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 <redacted>
[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/ (local)
[snip]
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help