doc: use builtin confval directive

bluetech · bluetech · commit 41179d5ff4ff · 2025-11-29T02:25:34.000+02:00
Since version 7.4, Sphinx had a standard `confval` directive: https://www.sphinx-doc.org/en/master/usage/domains/standard.html#directive-confval So we can drop our custom one.
diff --git a/changelog/14012.packaging.rst b/changelog/14012.packaging.rst
@@ -0,0 +1 @@
+Sphinx>=7.4 is now required to build the documentation.
diff --git a/doc/en/conf.py b/doc/en/conf.py
@@ -279,13 +279,6 @@ def setup(app: sphinx.application.Sphinx) -> None:
         indextemplate="pair: %s; fixture",
     )
 
-    app.add_object_type(
-        "confval",
-        "confval",
-        objname="configuration value",
-        indextemplate="pair: %s; configuration value",
-    )
-
     app.add_object_type(
         "globalvar",
         "globalvar",
diff --git a/doc/en/requirements.txt b/doc/en/requirements.txt
@@ -2,7 +2,7 @@
 pluggy>=1.5.0
 pygments-pytest>=2.5.0
 sphinx-removed-in>=0.2.0
-sphinx>=7
+sphinx>=7.4
 sphinxcontrib-trio
 sphinxcontrib-svg2pdfconverter
 furo

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+Sphinx>=7.4 is now required to build the documentation.`