Documentation: Modernize versions of Sphinx and friends

amotl · jonathanslenders · commit 29bc027c627d · 2023-01-17T19:37:22.000+01:00
diff --git a/.gitignore b/.gitignore
@@ -44,3 +44,6 @@ docs/_build
 
 # pycharm metadata
 .idea
+
+# virtualenvs
+.venv*
diff --git a/docs/conf.py b/docs/conf.py
@@ -92,6 +92,14 @@
 # If true, keep warnings as "system message" paragraphs in the built documents.
 # keep_warnings = False
 
+# autodoc configuration
+# https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html
+autodoc_inherit_docstrings = False
+autodoc_mock_imports = [
+    "prompt_toolkit.eventloop.win32",
+    "prompt_toolkit.input.win32",
+    "prompt_toolkit.output.win32",
+]
 
 # -- Options for HTML output ----------------------------------------------
 
diff --git a/docs/requirements.txt b/docs/requirements.txt
@@ -1,4 +1,4 @@
-Sphinx==4.1.2
-wcwidth==0.2.5
-pyperclip==1.8.2
-sphinx_rtd_theme==0.5.2
+Sphinx<7
+wcwidth<1
+pyperclip<2
+sphinx_rtd_theme<2
