From 1a562f77a3ebf12de90c3d811adeb0971acbe268 Mon Sep 17 00:00:00 2001
From: Alex Dunn <alexander.e.dunn@jpl.nasa.gov>
Date: Tue, 16 Jan 2024 10:36:55 -0800
Subject: [PATCH] pin sphinx components/deps for compatibility with existing
 sphinx version

---
 setup.cfg | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/setup.cfg b/setup.cfg
index ea427d4..6d476d5 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -47,6 +47,8 @@ python_requires = >= 3.9
 
 [options.extras_require]
 dev =
+# later versions of alabaster require sphinx>=3.4
+    alabaster <=0.7.13
     black~=23.7.0
     flake8~=6.1.0
     flake8-bugbear~=23.7.10
@@ -62,6 +64,15 @@ dev =
     pre-commit~=3.3.3
     sphinx~=3.2.1
     sphinx-rtd-theme~=0.5.0
+
+# unclear why the following pins are necessary, but without them, versions dependent on sphinx>=5.0 are installed
+    sphinxcontrib-applehelp==1.0.4
+    sphinxcontrib-devhelp==1.0.2
+    sphinxcontrib-htmlhelp==2.0.1
+    sphinxcontrib-jsmath==1.0.1
+    sphinxcontrib-qthelp==1.0.3
+    sphinxcontrib-serializinghtml==1.1.5
+
     tox~=4.11.0
     types-psutil~=5.9.5
     types_requests~=2.28