RFC Raise the bar with regards to Python and Sphinx requirements
Get series with b4
b4 am [email protected]Versions newest first
- v1 RFC Latest6 patches 8 repliesIn review
Patches in v1 No applies recorded yet
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/6 | scripts/get_abi.py: make it backward-compatible with Python 3.6scripts/ | +10 | 5 replies | |
| 2/6 | docs: extensions: don't use utf-8 syntax for descriptionsDocumentation/ Documentation/ Documentation/ +5 more | +22 | 1 reply | |
| 3/6 | docs: automarkup: drop legacy supportDocumentation/ | +7 | 0 replies | |
| 4/6 | scripts/kernel-doc: drop Sphinx version checkDocumentation/ Documentation/ scripts/ | +16 | 0 replies | |
| 5/6 | docs: changes: update Sphinx minimal version to 3.4.3Documentation/ Documentation/ | +2 | 0 replies | |
| 6/6 | doc: changes: update Python minimal versionDocumentation/ | +1 | 0 replies |
Reviews trailers per patch
None of the 6 patches has a Reviewed-by or Acked-by.
| Patch | Akira Yokosawa |
|---|---|
| 1/6 | T-b |
| 2/6 | |
| 3/6 | |
| 4/6 | |
| 5/6 | |
| 6/6 |
Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.
Cover letter [RFC 0/6] Raise the bar with regards to Python and Sphinx requirements
This series comes after https://lore.kernel.org/linux-doc/[email protected]/T/#t
It increases the minimal requirements for Sphinx and Python.
Sphinx release dates:
Release 2.4.0 (released Feb 09, 2020) Release 2.4.4 (released Mar 05, 2020) (current minimal requirement) Release 3.4.0 (released Dec 20, 2020) Release 3.4.3 (released Jan 08, 2021) (https://www.sphinx-doc.org/en/master/changes/index.html)
In terms of Python, we're currently at 3.5:
Python Release date 3.5 2015-09-13 (current minimal requirement) 3.6 2016-12-23 3.7 2018-06-27 3.8 2019-10-14 3.9 2020-10-05 3.10 2021-10-04 (according with https://en.wikipedia.org/w/index.php?title=History_of_Python)
The new minimal requirements are now:
- Sphinx 3.4.3;
- Python 3.9
The new Sphinx minimal requirement allows dropping all backward-compatible code we have at kernel-doc and at Sphinx extensions.
The new Python minimal requirement matches the current required level for all scripts but one (*). The one that doesn't match is at tools/net/sunrpc/xdrgen.
Those matches a 4-years old toolchain, which sounds a reasonable period of time, as Python/Sphinx aren't required for the Kernel build.
Mauro Carvalho Chehab (6):
scripts/get_abi.py: make it backward-compatible with Python 3.6
docs: extensions: don't use utf-8 syntax for descriptions
docs: automarkup: drop legacy support scripts/kernel-doc: drop Sphinx version check
docs: changes: update Sphinx minimal version to 3.4.3
doc: changes: update Python minimal version
Documentation/conf.py | 2 +- Documentation/process/changes.rst | 4 +- Documentation/sphinx/automarkup.py | 32 ++--- Documentation/sphinx/cdomain.py | 7 +- Documentation/sphinx/kernel_abi.py | 6 +- Documentation/sphinx/kernel_feat.py | 4 +- Documentation/sphinx/kernel_include.py | 4 +- Documentation/sphinx/kerneldoc.py | 5 - Documentation/sphinx/kfigure.py | 10 +- Documentation/sphinx/load_config.py | 2 +- Documentation/sphinx/maintainers_include.py | 4 +- Documentation/sphinx/rstFlatTable.py | 10 +- scripts/get_abi.py | 16 ++- scripts/kernel-doc | 129 +++----------------- 14 files changed, 58 insertions(+), 177 deletions(-)
Signature · 1 line
2.48.1