MAINT: write sphinx-build flags full

pyproject.toml

@@ -113,22 +113,26 @@ depends_on = ["docnb", "linkcheck", "sty"]
 [tool.pixi.feature.dev.tasks.doc]
 cmd = """
 sphinx-build \
+    --builder dirhtml \
     --color \
+    --fail-on-warning \
     --keep-going \
-    -TW \
-    -b dirhtml \
+    --show-traceback \
     docs/ docs/_build/html
 """
 env = {PYTHONWARNINGS = ""}
 
 [tool.pixi.feature.dev.tasks.doclive]
 cmd = """
 sphinx-autobuild \
+    --builder dirhtml \
     --open-browser \
-    --re-ignore .*/.ipynb_checkpoints/.* \
     --re-ignore .*/__pycache__/.* \
+    --re-ignore .*/.ipynb_checkpoints/.* \
     --re-ignore .*\\.gitignore \
     --re-ignore .*\\.tmp \
+    --re-ignore docs/_build/.* \
+    --re-ignore docs/_images/.* \
     --re-ignore docs/.*\\.csv \
     --re-ignore docs/.*\\.gif \
     --re-ignore docs/.*\\.gv \
@@ -139,12 +143,9 @@ sphinx-autobuild \
     --re-ignore docs/.*\\.svg \
     --re-ignore docs/.*\\.yaml \
     --re-ignore docs/.*\\.yml \
-    --re-ignore docs/_build/.* \
-    --re-ignore docs/_images/.* \
     --re-ignore docs/api/.* \
     --watch docs \
     --watch src \
-    -b dirhtml \
     docs/ docs/_build/html
 """
 env = {PYTHONWARNINGS = ""}
@@ -156,9 +157,9 @@ env = {EXECUTE_NB = "\"yes\""}
 [tool.pixi.feature.dev.tasks.linkcheck]
 cmd = """
 sphinx-build \
+    --builder linkcheck \
     --color \
-    -T \
-    -b linkcheck \
+    --show-traceback \
     docs/ docs/_build/linkcheck
 """
 env = {PYTHONWARNINGS = ""}

tox.ini

@@ -13,10 +13,11 @@ allowlist_externals =
   sphinx-build
 commands =
   sphinx-build \
+    --builder dirhtml \
     --color \
+    --fail-on-warning \
     --keep-going \
-    -TW \
-    -b dirhtml \
+    --show-traceback \
     docs/ docs/_build/html
 passenv = *
 setenv =
@@ -29,11 +30,14 @@ allowlist_externals =
   sphinx-autobuild
 commands =
   sphinx-autobuild \
+    --builder dirhtml \
     --open-browser \
-    --re-ignore .*/.ipynb_checkpoints/.* \
     --re-ignore .*/__pycache__/.* \
+    --re-ignore .*/.ipynb_checkpoints/.* \
     --re-ignore .*\.gitignore \
     --re-ignore .*\.tmp \
+    --re-ignore docs/_build/.* \
+    --re-ignore docs/_images/.* \
     --re-ignore docs/.*\.csv \
     --re-ignore docs/.*\.gif \
     --re-ignore docs/.*\.gv \
@@ -44,12 +48,9 @@ commands =
     --re-ignore docs/.*\.svg \
     --re-ignore docs/.*\.yaml \
     --re-ignore docs/.*\.yml \
-    --re-ignore docs/_build/.* \
-    --re-ignore docs/_images/.* \
     --re-ignore docs/api/.* \
     --watch docs \
     --watch src \
-    -b dirhtml \
     docs/ docs/_build/html
 passenv = *
 setenv =
@@ -62,10 +63,11 @@ allowlist_externals =
   sphinx-build
 commands =
   sphinx-build \
+    --builder dirhtml \
     --color \
+    --fail-on-warning \
     --keep-going \
-    -TW \
-    -b dirhtml \
+    --show-traceback \
     docs/ docs/_build/html
 passenv = *
 setenv =
@@ -79,9 +81,9 @@ allowlist_externals =
   sphinx-build
 commands =
   sphinx-build \
+    --builder linkcheck \
     --color \
-    -T \
-    -b linkcheck \
+    --show-traceback \
     docs/ docs/_build/linkcheck
 passenv = *
 setenv =