git/list[1] front-page[2] threads[3] people[4] search[5] about
wed 2026-10-07 16:57 UTC

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]
Previous: Junio C Hamano
Message 8 of 8 in “doc: am: improve command linking and add am.messageId”
  1. 0/4 doc: am: improve command linking and add am.messageIdkristofferhaugsbakk@fastmail.com, Feb 9, 2026
  2. 1/4 doc: am: normalize git(1) command linkskristofferhaugsbakk@fastmail.com, Feb 9, 2026
  3. 2/4 doc: am: say that --message-id adds a trailerkristofferhaugsbakk@fastmail.com, Feb 9, 2026
  4. 3/4 doc: am: add missing config am.messageIdkristofferhaugsbakk@fastmail.com, Feb 9, 2026
  5. 4/4 doc: am: fill out hook discussionkristofferhaugsbakk@fastmail.com, Feb 9, 2026
  6. D. Ben KnobleFeb 9, 2026
  7. Junio C HamanoFeb 9, 2026
  8. Kristoffer HaugsbakkFeb 11, 2026

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.