From: Adam Turner <aaturnerpython@outlook.com>
To: "linux-doc@vger.kernel.org" <linux-doc@vger.kernel.org>
Cc: "corbet@lwn.net" <corbet@lwn.net>
Subject: Sphinx pre v3 -- removing support
Date: Fri, 3 Jun 2022 14:13:27 +0000 [thread overview]
Message-ID: <LO3P123MB26810D190462B6BBBF1305F6C2A19@LO3P123MB2681.GBRP123.PROD.OUTLOOK.COM> (raw)
Hi,
I was pointed in the direction of this mailing list by Jani Nikula in
[1]_, who said:
> Thanks for the ping. I was heavily involved in the early days of
> converting the kernel to use Sphinx, but I haven't closely followed
> the recent developments. Basically I think I'd also be inclined to
> push for much higher minimum Sphinx version requirements than what
> the kernel currently has. The minimum at the moment is v1.7.9
> (or v2.4.4 for PDF). It's difficult to maintain support for a wide
> range of Sphinx versions. Perhaps the best bet would be to mail the
> kernel documentation list at linux-doc@vger.kernel.org and Cc
> Jonathan Corbet corbet@lwn.net to try to reach an understanding on
> the recommended minimum version and version ranges that makes sense
> for both parties to support. HTH.
This email is an attempt to do that.
From Sphinx's perspective, we'd like to remove long-deprecated code.
What is a good solution here for both sides? The intertial option is
for us to delay the deprecation by another major version (removal is
currently scheduled for Sphinx 6 (2023-05), and we are currently
releasing a major version every May.
Jani reports that you still require Sphinx 1.7.9 -- I have no
investment in the documentation development of the kernel, but he
rightly notes that is quite an old version -- released 3 years and 9
months ago.
Please would you let me know if there is anything required on our
(Sphinx's) end that would let us drop the "pre v3" support gracefully.
A
Thanks,
Adam
_[1]: https://github.com/sphinx-doc/sphinx/pull/10471#discussion_r888962744
next reply other threads:[~2022-06-03 14:13 UTC|newest]
Thread overview: 24+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-06-03 14:13 Adam Turner [this message]
2022-06-03 14:21 ` Sphinx pre v3 -- removing support Jonathan Corbet
2022-06-03 14:30 ` Adam Turner
2022-06-03 21:34 ` Jonathan Corbet
2022-06-03 15:22 ` Matthew Wilcox
2022-06-03 15:30 ` Adam Turner
2022-06-03 15:38 ` Matthew Wilcox
2022-06-03 15:42 ` Konstantin Ryabitsev
2022-06-03 16:00 ` Jonathan Corbet
2022-06-03 16:26 ` Konstantin Ryabitsev
2022-06-03 21:50 ` Jonathan Corbet
2022-06-13 15:40 ` Konstantin Ryabitsev
2022-06-13 16:00 ` Matthew Wilcox
2022-06-13 16:16 ` Adam Turner
2022-06-13 16:19 ` Matthew Wilcox
2022-06-03 22:11 ` Jonathan Corbet
2022-06-03 15:05 ` Akira Yokosawa
2022-06-03 15:27 ` Adam Turner
2022-06-03 15:44 ` Jani Nikula
2022-06-03 15:54 ` Adam Turner
2022-06-03 16:36 ` Akira Yokosawa
2022-06-03 19:05 ` Jani Nikula
2022-06-04 8:13 ` Mauro Carvalho Chehab
2022-07-02 11:23 ` Mauro Carvalho Chehab
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=LO3P123MB26810D190462B6BBBF1305F6C2A19@LO3P123MB2681.GBRP123.PROD.OUTLOOK.COM \
--to=aaturnerpython@outlook.com \
--cc=corbet@lwn.net \
--cc=linux-doc@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).