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
Date: Thu, 30 Nov 2023 09:27:33 +0100 [thread overview]
Message-ID: <20231130092733.26f0b7c4@coco.lan> (raw)
In-Reply-To: <c3accd5b-c8d9-4eb9-86a1-054e89893a8f@gmail.com>
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
prev parent reply other threads:[~2023-11-30 8:27 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-11-27 23:31 [PATCH] docs: Raise the minimum Sphinx requirement to 2.4.4 Jonathan Corbet
2023-11-28 1:30 ` Mauro Carvalho Chehab
2023-11-28 14:42 ` Jonathan Corbet
2023-11-28 15:56 ` Mauro Carvalho Chehab
2023-11-30 7:33 ` Akira Yokosawa
2023-11-30 8:27 ` Mauro Carvalho Chehab [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20231130092733.26f0b7c4@coco.lan \
--to=mchehab@kernel.org \
--cc=akiyks@gmail.com \
--cc=corbet@lwn.net \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).