bpo-42238: Doc: Remove make suspicious from the CI and docs builds. (GH-23313)

It probably helped a lot a while back, but may not be as usefull
today.  We'll continue monitoring it before deletion, so true
positives can be migrated to rstlint.

diff --git a/.azure-pipelines/docs-steps.yml b/.azure-pipelines/docs-steps.yml
index eaf4ad01927aebae1ca46c2b5a95107b4d2b91db..55c38611b95c81baa37600f46ef25ecf55b52240 100644 (file)
--- a/.azure-pipelines/docs-steps.yml
+++ b/.azure-pipelines/docs-steps.yml
@@ -16,7 +16,7 @@ steps:
   displayName: 'Install build dependencies'
 
 - ${{ if ne(parameters.latex, 'true') }}:
-  - script: make check suspicious html PYTHON=python
+  - script: make check html PYTHON=python
     workingDirectory: '$(build.sourcesDirectory)/Doc'
     displayName: 'Build documentation'
 

diff --git a/.github/workflows/doc.yml b/.github/workflows/doc.yml
index 7c6012eed4f2d22ecdfd39e482728f9d49c0dc3f..f0dbfcd9d3b49ea170f7502894216cd86eb29c6a 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 suspicious html
+      run: xvfb-run make -C Doc/ PYTHON=../python SPHINXOPTS="-q -W --keep-going -j4" doctest html
     - name: 'Upload'
       uses: actions/upload-artifact@v2.2.0
       with:

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

diff --git a/Doc/Makefile b/Doc/Makefile
index 6bf1f408b56f0da0eb32dc5a1c372b2982e88b15..c24c70c699a06a5ba208579e124dd93e51f070f2 100644 (file)
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -216,7 +216,6 @@ serve:
 # for development releases: always build
 autobuild-dev:
        make dist SPHINXOPTS='$(SPHINXOPTS) -Ea -A daily=1'
-       -make suspicious
 
 # for quick rebuilds (HTML only)
 autobuild-dev-html:

diff --git a/Misc/NEWS.d/next/Documentation/2020-11-24-22-54-49.bpo-42238.62EOTu.rst b/Misc/NEWS.d/next/Documentation/2020-11-24-22-54-49.bpo-42238.62EOTu.rst
new file mode 100644 (file)
index 0000000..d9edf9c
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2020-11-24-22-54-49.bpo-42238.62EOTu.rst
@@ -0,0 +1,2 @@
+Tentative to deprecate ``make suspicious`` by first removing it from the CI
+and documentation builds, but keeping it around for manual uses.