Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Message-ID: <bdd04f2e-64a4-e3ef-eb4c-3681c6f52c2f@gmail.com>
Date:   Thu, 12 Jan 2023 08:13:25 +0900
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101
 Thunderbird/102.4.2
Subject: Re: [PATCH] docs: Fix the docs build with Sphinx 6.0
To:     =?UTF-8?Q?Martin_Li=c5=a1ka?= <mliska@suse.cz>
Cc:     Jonathan Corbet <corbet@lwn.net>, linux-doc@vger.kernel.org,
        linux-kernel@vger.kernel.org,
        Mauro Carvalho Chehab <mchehab@kernel.org>
References: <87wn629ggg.fsf@meer.lwn.net>
 <cb916eae-fdf6-504f-8f38-7928e0fa8344@gmail.com>
 <20230108150135.060b0c7a@coco.lan>
 <6e81b372-d010-fb75-cdfe-b76c6b197f07@suse.cz>
 <e2d98136-3c4c-8910-d116-93070c48474d@gmail.com>
Content-Language: en-US
From:   Akira Yokosawa <akiyks@gmail.com>
In-Reply-To: <e2d98136-3c4c-8910-d116-93070c48474d@gmail.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
Precedence: bulk

On Tue, 10 Jan 2023 00:17:11 +0900, Akira Yokosawa wrote:
> On Mon, 9 Jan 2023 15:14:46 +0100, Martin Li=C5=A1ka wrote:
>> Hi.
>>
>> I can confirm the regression, I bisected Sphinx revision that caused t=
hat
>> and filled an upstream issues:
>> https://github.com/sphinx-doc/sphinx/issues/11116
>=20
> Thank you Martin for looking into this!

Thanks to Martin's inputs on the github issue, Sphinx 6.1.3 has released
and the issue is resolved for parallel builds.

However, for non-parallel builds, the memory hog still remains.
Again, this is a table comparing 5.3.0, 6.1.2, and 6.1.3.

 =3D=3D=3D=3D=3D=3D  =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D  =3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
                     elapsed time                       maxresident
         -----------------------------------  ---------------------------=
----
 Sphinx     -j1     -j2      -j4      -j6       -j1     -j2     -j4     -=
j6
 =3D=3D=3D=3D=3D=3D  =3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D =3D=
=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D  =3D=3D=3D=3D=3D=3D=3D =3D=
=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D
  6.1.3  15:03.83 11:31.99  9:35.15  8:49.01  2949056 1059516  978232  96=
7400
  6.1.2  15:11.74 18:06.89 16:39.93      OOM  2961524 5548344 5255372    =
  --
  5.3.0  14:13.04 10:16.81  8:22.37  8:09.74   711532  937660  846016  80=
0340
 =3D=3D=3D=3D=3D=3D  =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D  =3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

    Note:
      - The -j1 run needs an explicit option given to sphinx-build:
        make SPHINXOPTS=3D"-q -j1" htmldocs

I naively assumed that the memory hog would be resolved all together,
but that's not the case.

Martin, could you report the remaining issue to upstream Sphinx?

        Thanks, Akira