From: Kristoffer Haugsbakk Date: Sun, 28 Sep 2025 19:25:26 GMT Subject: Re: [PATCH] doc: patch-id: fix accidental literal blocks Message-ID: In-Reply-To: On Sun, Sep 28, 2025, at 18:01, Junio C Hamano wrote: > kristofferhaugsbakk@fastmail.com writes: > >> From: Kristoffer Haugsbakk >> >> 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). I don’t understand why but `doc-diff` agrees that these last ones are the only ones affected by this change.