Issue #15759: "make suspicious", "make linkcheck" and "make doctest" in Doc/

now display special message when and only when there are failures.

2 files changed, 19 insertions, 10 deletions

diff --git a/Doc/Makefile b/Doc/Makefile
index 370c3faa3b..43dd80478a 100644
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -69,24 +69,30 @@ changes: build
 	@echo "The overview file is in build/changes."
 
 linkcheck: BUILDER = linkcheck
-linkcheck: build
-	@echo "Link check complete; look for any errors in the above output" \
-	      "or in build/$(BUILDER)/output.txt"
+linkcheck:
+	@$(MAKE) build BUILDER=$(BUILDER) || { \
+	echo "Link check complete; look for any errors in the above output" \
+	     "or in build/$(BUILDER)/output.txt"; \
+	false; }
 
 suspicious: BUILDER = suspicious
-suspicious: build
-	@echo "Suspicious check complete; look for any errors in the above output" \
-	      "or in build/$(BUILDER)/suspicious.csv.  If all issues are false" \
-	      "positives, append that file to tools/sphinxext/susp-ignored.csv."
+suspicious:
+	@$(MAKE) build BUILDER=$(BUILDER) || { \
+	echo "Suspicious check complete; look for any errors in the above output" \
+	     "or in build/$(BUILDER)/suspicious.csv.  If all issues are false" \
+	     "positives, append that file to tools/sphinxext/susp-ignored.csv."; \
+	false; }
 
 coverage: BUILDER = coverage
 coverage: build
 	@echo "Coverage finished; see c.txt and python.txt in build/coverage"
 
 doctest: BUILDER = doctest
-doctest: build
-	@echo "Testing of doctests in the sources finished, look at the" \
-	      "results in build/doctest/output.txt"
+doctest:
+	@$(MAKE) build BUILDER=$(BUILDER) || { \
+	echo "Testing of doctests in the sources finished, look at the" \
+	     "results in build/doctest/output.txt"; \
+	false; }
 
 pydoc-topics: BUILDER = pydoc-topics
 pydoc-topics: build
diff --git a/Misc/NEWS b/Misc/NEWS
index 6b16b644eb..e542d50ac8 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -635,6 +635,9 @@ IDLE
 Build
 -----
 
+- Issue #15759: "make suspicious", "make linkcheck" and "make doctest" in Doc/
+  now display special message when and only when there are failures.
+
 - Issue #21141: The Windows build process no longer attempts to find Perl,
   instead relying on OpenSSL source being configured and ready to build.  The
   ``PCbuild\build_ssl.py`` script has been re-written and re-named to