Re: [PATCH v2 1/3] doc: config: terminate runaway lists

From: Jeff King <peff@peff.net>
Date: Jun 11, 2026, 06:02 UTC
Message-ID: <20260611060226.GB2187173@coredump.intra.peff.net>
In-Reply-To: <20260610225513.6269-2-taahol@utu.fi>

On Thu, Jun 11, 2026 at 01:55:11AM +0300, Tuomas Ahola wrote:

Show 13 quoted lines

> There are many places in git-config(1) where paragraphs that should
> logically come after a list are instead appended to the last item of
> the list.  This is a well-documented quirk of AsciiDoc, and can be
> mitigated by enclosing the list in an open block:
> 
> 	--
> 	* first item
> 	* last item
> 	--
> 	+
> 	New paragraph after the list.
> 
> Fix the issue accordingly.

Makes sense. We've run into problems in the past where adding "--" doesn't quite work, because we are already inside a "--" (and IIRC the behavior is not always completely predictable). But I double-checked these cases, and we are not already in a "--". So we should be good here.

-Peff