matplotlib
diff --git a/‎doc/devel/documenting_mpl.rst
Copy file name to clipboardExpand all lines: doc/devel/documenting_mpl.rst
+4-3Lines changed: 4 additions & 3 deletions b/‎doc/devel/documenting_mpl.rst
Copy file name to clipboardExpand all lines: doc/devel/documenting_mpl.rst
+4-3Lines changed: 4 additions & 3 deletions
diff --git a/‎requirements/doc/doc-requirements.txt
Copy file name to clipboardExpand all lines: requirements/doc/doc-requirements.txt
+1-1Lines changed: 1 addition & 1 deletion b/‎requirements/doc/doc-requirements.txt
Copy file name to clipboardExpand all lines: requirements/doc/doc-requirements.txt
+1-1Lines changed: 1 addition & 1 deletion
@@ -81,8 +81,9 @@ Other useful invocations include
    # Build pdf docs.
    make latexpdf
 
-The ``SPHINXOPTS`` variable is set to ``-W`` by default to turn warnings into
-errors.  To unset it, use
+The ``SPHINXOPTS`` variable is set to ``-W --keep-going`` by default to build
+the complete docs but exit with exit status 1 if there are warnings.  To unset
+it, use
 
 .. code-block:: sh
 
@@ -98,7 +99,7 @@ Multiple options can be combined using e.g. ``make O='-j4 -Dplot_gallery=0'
 html``.
 
 On Windows, options needs to be set as environment variables, e.g. ``set O=-W
--j4 & make html``.
+--keep-going -j4 & make html``.
 
 .. _writing-rest-pages:
 
 
@@ -7,7 +7,7 @@
 # Install the documentation requirements with:
 #     pip install -r requirements/doc/doc-requirements.txt
 #
-sphinx>=1.3,!=1.5.0,!=1.6.4,!=1.7.3,!=1.8.0
+sphinx>=1.8.1
 colorspacious
 ipython
 ipywidgets