When rendering docs, preserve the syntax for defaults. Fixes jaraco/p…

…ath#197. Incidentally, re-organize the extensions a bit for clarity.
jaraco · Sep 25, 2022 · 92fd50c · 92fd50c
1 parent 27c5534
commit 92fd50c
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 2 deletions.
diff --git a/docs/conf.py b/docs/conf.py
@@ -1,7 +1,11 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 
-extensions = ['sphinx.ext.autodoc', 'jaraco.packaging.sphinx', 'rst.linker']
+extensions = [
+    'sphinx.ext.autodoc',
+    'jaraco.packaging.sphinx',
+    'rst.linker',
+]
 
 master_doc = "index"
 
@@ -34,3 +38,6 @@
 intersphinx_mapping = {
     'python': ('https://docs.python.org/3', None),
 }
+
+# Preserve authored syntax for defaults
+autodoc_preserve_defaults = True
diff --git a/setup.cfg b/setup.cfg
@@ -46,7 +46,7 @@ testing =
 
 docs =
 	# upstream
-	sphinx
+	sphinx >= 3.5
 	jaraco.packaging >= 9
 	rst.linker >= 1.9