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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.