Make sphinx-build warnings fatal

In order to prevent documentation building issues from being glossed
over, pass the -W command line switch to all sphinx-build invocations.
This causes the latter to return with a non-zero exit code whenever any
Sphinx warnings are triggered.

(cherry picked from commit 51479ed9a3f76ec3b8113e2614438cef77e0ce27)

diff --git a/doc/arm/Makefile.in b/doc/arm/Makefile.in
index 7105478b2eb8c2c8b8542c7912c471d62455d4a0..3f653b794c7e0d5b180caa3acc2dee09d3a21e0e 100644 (file)
--- a/doc/arm/Makefile.in
+++ b/doc/arm/Makefile.in
@@ -27,6 +27,7 @@ SPHINXBUILD = @SPHINX_BUILD@
 SPHINXBUILDDIR = ${builddir}/_build
 
 common_SPHINXOPTS =    \
+       -W              \
        -a              \
        -v              \
        -c "${abs_srcdir}"

diff --git a/doc/man/Makefile.in b/doc/man/Makefile.in
index ebe21f1998a42e828ce25b97e0954cbdfd63a08b..81d3681972326921b9f1c80d26ae5b7c352a8f7e 100644 (file)
--- a/doc/man/Makefile.in
+++ b/doc/man/Makefile.in
@@ -152,6 +152,7 @@ SPHINXBUILD = @SPHINX_BUILD@
 SPHINXBUILDDIR = ${builddir}/_build
 
 common_SPHINXOPTS =            \
+       -W                      \
        -a                      \
        -v                      \
        -c "${abs_srcdir}"