summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonathan Corbet <corbet@lwn.net>2023-01-04 13:59:16 -0700
committerJonathan Corbet <corbet@lwn.net>2023-01-06 13:04:15 -0700
commit31abfdda65279a860b10a98038135501e4fc00a1 (patch)
tree3cc4761ed310944bb993dcf3a58ac7451b4a90d5
parent0283189e8f3d0917e2ac399688df85211f48447b (diff)
downloadlwn-31abfdda65279a860b10a98038135501e4fc00a1.tar.gz
lwn-31abfdda65279a860b10a98038135501e4fc00a1.zip
docs: Deprecate use of Sphinx < 2.4.x
The Sphinx 2.4 release is three years old, and it is becoming increasingly difficult to even find a system with an sufficiently archaic Python installation that can run versions older than that. I can no longer test changes against anything prior to 2.4.x. Move toward raising our minimum Sphinx requirement to 2.4.x so we can delete some older support code and claim to support a range of versions that we can actually test. In the absence of screams, the actual removal of support can happen later in 2023. Signed-off-by: Jonathan Corbet <corbet@lwn.net>
-rw-r--r--Documentation/conf.py6
1 files changed, 6 insertions, 0 deletions
diff --git a/Documentation/conf.py b/Documentation/conf.py
index a5c45df0bd83..44899be7b2cc 100644
--- a/Documentation/conf.py
+++ b/Documentation/conf.py
@@ -31,6 +31,12 @@ def have_command(cmd):
# Get Sphinx version
major, minor, patch = sphinx.version_info[:3]
+#
+# Warn about older versions that we don't want to support for much
+# longer.
+#
+if (major < 2) or (major == 2 and minor < 4):
+ print('WARNING: support for Sphinx < 2.4 will be removed soon.')
# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the