[Python-checkins] bpo-34081: Fix wrong example link that was linking to distutils (GH-8248)

[Julien Palard]

https://github.com/python/cpython/commit/121eb1694cab14df857ba6abe9839654cada15cf
commit: 121eb1694cab14df857ba6abe9839654cada15cf
branch: master
author: Xtreak <tirkarthi at users.noreply.github.com>
committer: Julien Palard <julien at palard.fr>
date: 2018-10-21T16:54:52+02:00
summary:

bpo-34081: Fix wrong example link that was linking to distutils (GH-8248)

files:
A Misc/NEWS.d/next/Build/2018-09-06-07-15-20.bpo-34081.cuSTnH.rst
M .azure-pipelines/docs-steps.yml
M Doc/Makefile

diff --git a/.azure-pipelines/docs-steps.yml b/.azure-pipelines/docs-steps.yml
index c0404aebdcc5..460576cbc955 100644
--- a/.azure-pipelines/docs-steps.yml
+++ b/.azure-pipelines/docs-steps.yml
@@ -12,7 +12,7 @@ steps:
   inputs:
     versionSpec: '>=3.6'
 
-- script: python -m pip install sphinx~=1.6.1 blurb python-docs-theme
+- script: python -m pip install sphinx==1.8.1 blurb python-docs-theme
   displayName: 'Install build dependencies'
 
 - ${{ if ne(parameters.latex, 'true') }}:
diff --git a/Doc/Makefile b/Doc/Makefile
index 042f960b93e7..50beac58ec38 100644
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -12,7 +12,7 @@ PAPER        =
 SOURCES      =
 DISTVERSION  = $(shell $(PYTHON) tools/extensions/patchlevel.py)
 
-ALLSPHINXOPTS = -b $(BUILDER) -d build/doctrees -D latex_elements.papersize=$(PAPER) \
+ALLSPHINXOPTS = -b $(BUILDER) -d build/doctrees -W -D latex_elements.papersize=$(PAPER) \
                 $(SPHINXOPTS) . build/$(BUILDER) $(SOURCES)
 
 .PHONY: help build html htmlhelp latex text changes linkcheck \
diff --git a/Misc/NEWS.d/next/Build/2018-09-06-07-15-20.bpo-34081.cuSTnH.rst b/Misc/NEWS.d/next/Build/2018-09-06-07-15-20.bpo-34081.cuSTnH.rst
new file mode 100644
index 000000000000..af385bac231b
--- /dev/null
+++ b/Misc/NEWS.d/next/Build/2018-09-06-07-15-20.bpo-34081.cuSTnH.rst
@@ -0,0 +1 @@
+Make Sphinx warnings as errors in the Docs Makefile.