Fix Sphinx errors in the documentation and re-activate the suspicious check (GH-25368)

The suspicious check is still executed as part of the release process and release managers have been
lately fixing some actual errors that the suspicious target can find. For this reason, reactivate the suspicious
until we decide what to do in a coordinated fashion.

diff --git a/.github/workflows/doc.yml b/.github/workflows/doc.yml
index 864303bfff85052918fc58e70f5c4e43b9058cfd..8924fc992e25e61cf9a0408d54eae924bda8dbd1 100644 (file)
--- a/.github/workflows/doc.yml
+++ b/.github/workflows/doc.yml
@@ -36,7 +36,7 @@ jobs:
     - name: 'Install build dependencies'
       run: make -C Doc/ PYTHON=../python venv
     - name: 'Build documentation'
-      run: xvfb-run make -C Doc/ PYTHON=../python SPHINXOPTS="-q -W --keep-going -j4" doctest html
+      run: xvfb-run make -C Doc/ PYTHON=../python SPHINXOPTS="-q -W --keep-going -j4" doctest html suspicious
     - name: 'Upload'
       uses: actions/upload-artifact@v2.2.2
       with:

diff --git a/.travis.yml b/.travis.yml
index 7050d2557a7fc69016ec195ef8449b52612028e2..fc063216914446146ba6dff17fb7cf1c6ad22760 100644 (file)
--- a/.travis.yml
+++ b/.travis.yml
@@ -53,7 +53,7 @@ matrix:
         - cd Doc
         - make venv PYTHON=python
       script:
-        - make check html SPHINXOPTS="-q -W -j4"
+        - make check html suspicious SPHINXOPTS="-q -W -j4"
     - name: "Documentation tests"
       os: linux
       language: c

diff --git a/Doc/c-api/init_config.rst b/Doc/c-api/init_config.rst
index 7ececeb6c6269ba58df6d3fcaf90477d47a18735..d364f4a3c98b5db8d188bf9d34509019e3e4f5d1 100644 (file)
--- a/Doc/c-api/init_config.rst
+++ b/Doc/c-api/init_config.rst
@@ -831,7 +831,7 @@ PyConfig
       Set by the :envvar:`PYTHONPLATLIBDIR` environment variable.
 
       Default: value of the ``PLATLIBDIR`` macro which is set by the
-      :option`configure --with-platlibdir option <--with-platlibdir>` (default:
+      :option:`configure --with-platlibdir option <--with-platlibdir>` (default:
       ``"lib"``).
 
       Part of the :ref:`Python Path Configuration <init-path-config>` input.

diff --git a/Doc/tools/susp-ignored.csv b/Doc/tools/susp-ignored.csv
index fd27ab5d80dc232b479bd99a168f542ed4f4da00..325c5fa35eed7a8fa3eb9dd18bdcafb9fe74add9 100644 (file)
--- a/Doc/tools/susp-ignored.csv
+++ b/Doc/tools/susp-ignored.csv
@@ -365,3 +365,4 @@ whatsnew/changelog,,::,default::DeprecationWarning
 library/importlib.metadata,,:main,"EntryPoint(name='wheel', value='wheel.cli:main', group='console_scripts')"
 library/importlib.metadata,,`,loading the metadata for packages for the indicated ``context``.
 library/re,,`,"`"
+using/configure,84,:db2,=db1:db2:...