From: Jeff King <peff@peff.net>
Date: Thu, 11 Jun 2026 06:02:26 GMT
Subject: Re: [PATCH v2 1/3] doc: config: terminate runaway lists
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:

> 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