git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] doc: patch-id: fix accidental literal blocks

From
Junio C Hamano <gitster@pobox.com>
Date
Sep 28, 2025, 16:01 UTC
Message-ID
<xmqq4ism7eh4.fsf@gitster.g>
In-Reply-To
<0520e8f9caf.1759067095.git.code@khaugsbakk.name>
kristofferhaugsbakk@fastmail.com writes:
Show 12 quoted lines
> From: Kristoffer Haugsbakk <code@khaugsbakk.name>
>
> The options here are apparently written with the assumption that you
> can continue a block like e.g. a description list by maintaining the
> same indentation level.  This is not the the case; you need to use list
> continuation (+) for the elements following the first paragraph if you
> want to be guaranteed a predictable output
>
> This is kind of subtle since only the last paragraph of each option gets
> rendered in an unintended way, namely as literal blocks.  This is easier
> to see in the HTML output since the man page output just has a slightly
> larger indentation on these paragraphs.

Hmph, I've always thought that the practice breaks every paragraph except for the first one (which is the same as "only the last", only when you have exactly 2 paragraphs; when you have more than 2, it makes a difference).

The changes in the diff part all look reasonable to me.
Thanks.
Previous: Kristoffer HaugsbakkNext: Kristoffer Haugsbakk
Message 3 of 7 in “doc: patch-id: fix accidental literal blocks”
  1. doc: patch-id: fix accidental literal blockskristofferhaugsbakk@fastmail.com, Sep 28, 2025
  2. Kristoffer HaugsbakkSep 28, 2025
  3. Junio C HamanoSep 28, 2025
  4. Kristoffer HaugsbakkSep 28, 2025
  5. Junio C HamanoSep 28, 2025
  6. doc: patch-id: fix accidental literal blockskristofferhaugsbakk@fastmail.com, Sep 29, 2025
  7. Junio C HamanoSep 29, 2025

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.