Fix: Update Sphinx to fix RTD build

The old version pinned in requirements.txt was causing build failures
on RTD. This has been updated, along with a few small fixes that
showed up once the build was working again.

Issue: RELENG-5138
Change-Id: Icaa18d3a39540148b328654bddb9d7fb98ecbd31
Signed-off-by: Eric Ball <eball@linuxfoundation.org>

diff --git a/docs/conf.py b/docs/conf.py
index c8325f7..e9f9271 100644 (file)
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -97,7 +97,7 @@ release = version
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = "en"
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:

diff --git a/docs/jjb/lf-gradle-jobs.rst b/docs/jjb/lf-gradle-jobs.rst
index f32ee40..d9a8a28 100644 (file)
--- a/docs/jjb/lf-gradle-jobs.rst
+++ b/docs/jjb/lf-gradle-jobs.rst
@@ -42,7 +42,7 @@ Runs a gradle build command to perform the verification.
     :gerrit_verify_triggers: Override Gerrit Triggers.
 
 Gradle Publish Jar
-------------
+------------------
 
 Runs a gradle publish command to publish the jar.
 

diff --git a/requirements.txt b/requirements.txt
index 3879339..f6d3550 100644 (file)
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,5 +1,5 @@
 reno~=2.11.2
-Sphinx~=4.2.0
+Sphinx~=7.2.6
 sphinx_bootstrap_theme
 sphinxcontrib-programoutput
 urllib3