Re: [PATCH 0/2] documentation fixes for 2.48.0

From: Martin Ågren <martin.agren@gmail.com>
Date: Jan 3, 2025, 11:59 UTC
Message-ID: <CAN0heSqKsAoeQdhUhP1fK8V3H2Xi=UeoHGM1GH-=QdysC99qwA@mail.gmail.com>
In-Reply-To: <CAPig+cQoFC_2M-S0d7SLBPFvusXQC93pbk3QP2+qhsa7BJGnuQ@mail.gmail.com>

On Fri, 3 Jan 2025 at 12:39, Eric Sunshine <sunshine@sunshineco.com> wrote:

Show 9 quoted lines

>
> On Fri, Jan 3, 2025 at 6:34 AM Martin Ågren <martin.agren@gmail.com> wrote:
> > These two patches fix some misrenderings of the built documentation,
> > introduced during the 2.48 cycle. As usual, the exact current behaviors
> > (symptoms) differ a bit between AsciiDoc and Asciidoctor.
>
> Both patches make sense. Out of curiosity, how are you discovering
> these problems? Are you, for instance, running doc-diff and manually
> scanning the output?

Yes, exactly. Something like

  ./doc-diff v2.47.0 v2.48.0-rc1

is a nice way of finding out what's new. Occasionally, some oddity like these stick out.

(The diff can easily look huge, but often several pages contain the same content, so the 2nd/3rd/4th/... instance of a particular diff can be skipped. Inclusion of diff-options.txt would be the typical example.)

Martin