Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:8 as permitted sender) client-ip=2620:137:e000::3:8;
Date:   Thu, 30 Nov 2023 09:27:33 +0100
From:   Mauro Carvalho Chehab <mchehab@kernel.org>
To:     Akira Yokosawa <akiyks@gmail.com>
Cc:     Jonathan Corbet <corbet@lwn.net>, linux-doc@vger.kernel.org,
        linux-kernel@vger.kernel.org
Subject: Re: [PATCH] docs: Raise the minimum Sphinx requirement to 2.4.4
Message-ID: <20231130092733.26f0b7c4@coco.lan>
In-Reply-To: <c3accd5b-c8d9-4eb9-86a1-054e89893a8f@gmail.com>
References: <87sf4qvkmc.fsf@meer.lwn.net>
        <20231128023015.0e446a06@coco.lan>
        <877cm2uegr.fsf@meer.lwn.net>
        <20231128165645.2dbe416c@coco.lan>
        <c3accd5b-c8d9-4eb9-86a1-054e89893a8f@gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Precedence: bulk

Em Thu, 30 Nov 2023 16:33:56 +0900
Akira Yokosawa <akiyks@gmail.com> escreveu:

> Hi,
> 
> On 2023/11/29 0:56, Mauro Carvalho Chehab wrote:
> [snip]
> 
> > While I didn't make any benchmarks, I remember people reported
> > poor performance with newer versions, so, without thinking to
> > much, 3.1 or 3.2 seems a good candidate for the recommended
> > version.  
> 
> Well, I have different impressions on the performance of Sphinx >=3.1
> and have done some quick benchmarks.
> Here are results on a not-so-performant machine.
> 
> Benchmark of building htmldocs on Ubuntu 22.04 (after "make cleandocs"):
> 
> Sphinx   elapesed   maxresident (k)
> ======== ========== ===============
>  2.4.5     7m44.57     2806152      (parallel slot = 3)
>  3.1.2    11m25.28     1036264      (parallel slot = 4)
>  3.4.3    10m22.26     1067100      (ditto.)
>  4.2.0    10m16.53     1151220
>  4.3.2    10m06.07     1123432      (distro pkg of Ubuntu 22.04LTS)
>  5.3.0    10m18.73     1145524
>  7.2.6     9m53.80     1261736
> 
> python3: Python 3.10.12
> 
> Sidenotes:
> 
>   1: Sphinx 4.3.0 officially added Python 3.10 support.
>      Sphinx 4.2.0 also works with Python 3.10.
>      Sphinx <3.5.0 happen to work with Python 3.10.
>   2: Sphinx 7.2.0 obsoleted Python 3.8.
>   3: Sphinx 6.0.0 obsoleted Python 3.6 and 3.7.
> 
> 
> And here is a table of distro Sphinx packages:
> 
>           As of 2023.11.30
> 
> ----------------------------------
> Distro              Sphinx Python3
> =================== ====== =======
> Ubuntu 22.04 LTS    4.3.2  3.10.12
> Debian 11           3.4.3  3.9.2
> Debian 12           5.3.0  3.11.2
> Fedora 39           6.2.1  3.12.0
> RHEL 9              3.4.3  3.9.18
> Mageia 9            6.1.3  3.10.11
> openSUSE Leap 15.5  4.2.0  3.6.15  (provided as python3-Sphinx_4_2_0)
> ----------------------------------
> 
> So, I think Sphinx 3.4.3 would be a reasonable choice for
> recommending.

Works for me.

Regards,
Mauro