From cd74008d47fd9231bd57e77c87a2d36dc07d4b45 Mon Sep 17 00:00:00 2001 From: buckE Date: Thu, 18 Jun 2020 05:49:33 +0000 Subject: added -W --keep-going to provide exit 1 on sphinx warnings --- Makefile | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) (limited to 'Makefile') diff --git a/Makefile b/Makefile index e15550e5..e94ea203 100644 --- a/Makefile +++ b/Makefile @@ -60,7 +60,8 @@ diagrams: arch-api.png # The html-linked builder does not support caching, so we # remove all cached state first. html: diagrams - $(SPHINXBUILD) -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html + # -W = exit 1 on warning; --keep-going = complete build anyway + $(SPHINXBUILD) -W --keep-going -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." @@ -121,7 +122,8 @@ latex: "(use \`make latexpdf' here to do that automatically)." latexpdf: - $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + # -W = exit 1 on warning; --keep-going = complete build anyway + $(SPHINXBUILD) -W --keep-going -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through pdflatex..." $(MAKE) -C $(BUILDDIR)/latex all-pdf @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." -- cgit v1.2.3 From 6680f37efc13cb16dbf13a3f7561b48a4a207b07 Mon Sep 17 00:00:00 2001 From: buckE Date: Thu, 18 Jun 2020 05:51:29 +0000 Subject: verify build failure is due to new option --- Makefile | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'Makefile') diff --git a/Makefile b/Makefile index e94ea203..305de63e 100644 --- a/Makefile +++ b/Makefile @@ -61,7 +61,7 @@ diagrams: arch-api.png # remove all cached state first. html: diagrams # -W = exit 1 on warning; --keep-going = complete build anyway - $(SPHINXBUILD) -W --keep-going -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html + $(SPHINXBUILD) -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." @@ -123,7 +123,7 @@ latex: latexpdf: # -W = exit 1 on warning; --keep-going = complete build anyway - $(SPHINXBUILD) -W --keep-going -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through pdflatex..." $(MAKE) -C $(BUILDDIR)/latex all-pdf @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." -- cgit v1.2.3 From 4860d7c536ec75938faeabf616c396bc6c4988c5 Mon Sep 17 00:00:00 2001 From: buckE Date: Thu, 18 Jun 2020 05:53:16 +0000 Subject: re-add options to cause exit 1 on warnings --- Makefile | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'Makefile') diff --git a/Makefile b/Makefile index 305de63e..e94ea203 100644 --- a/Makefile +++ b/Makefile @@ -61,7 +61,7 @@ diagrams: arch-api.png # remove all cached state first. html: diagrams # -W = exit 1 on warning; --keep-going = complete build anyway - $(SPHINXBUILD) -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html + $(SPHINXBUILD) -W --keep-going -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." @@ -123,7 +123,7 @@ latex: latexpdf: # -W = exit 1 on warning; --keep-going = complete build anyway - $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + $(SPHINXBUILD) -W --keep-going -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through pdflatex..." $(MAKE) -C $(BUILDDIR)/latex all-pdf @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." -- cgit v1.2.3 From 48e5bddaec721fa55ffe4bca42fe21e35077d03c Mon Sep 17 00:00:00 2001 From: buckE Date: Thu, 18 Jun 2020 05:55:09 +0000 Subject: write warning messages to ~/warnings.log --- Makefile | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'Makefile') diff --git a/Makefile b/Makefile index e94ea203..3aff632b 100644 --- a/Makefile +++ b/Makefile @@ -61,7 +61,7 @@ diagrams: arch-api.png # remove all cached state first. html: diagrams # -W = exit 1 on warning; --keep-going = complete build anyway - $(SPHINXBUILD) -W --keep-going -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html + $(SPHINXBUILD) -W --keep-going -w /home/docbuilder/warnings.log -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." @@ -123,7 +123,7 @@ latex: latexpdf: # -W = exit 1 on warning; --keep-going = complete build anyway - $(SPHINXBUILD) -W --keep-going -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + $(SPHINXBUILD) -W --keep-going -w /home/docbuilder/warnings.log -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through pdflatex..." $(MAKE) -C $(BUILDDIR)/latex all-pdf @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." -- cgit v1.2.3 From 5d1416bd0f1b3056f9c871ba3073b4fe10721891 Mon Sep 17 00:00:00 2001 From: buckE Date: Thu, 18 Jun 2020 05:58:21 +0000 Subject: testing e-mail report --- Makefile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'Makefile') diff --git a/Makefile b/Makefile index 3aff632b..51fbf3d8 100644 --- a/Makefile +++ b/Makefile @@ -60,7 +60,7 @@ diagrams: arch-api.png # The html-linked builder does not support caching, so we # remove all cached state first. html: diagrams - # -W = exit 1 on warning; --keep-going = complete build anyway + # -W = exit 1 on warning; --keep-going = complete build anyway; write log to ~/warnings.log $(SPHINXBUILD) -W --keep-going -w /home/docbuilder/warnings.log -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." -- cgit v1.2.3 From d521aaacc36d9f2df11a9d5e88f653e467d1a9ee Mon Sep 17 00:00:00 2001 From: buckE Date: Fri, 19 Jun 2020 07:17:07 +0000 Subject: changed logfile name --- Makefile | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'Makefile') diff --git a/Makefile b/Makefile index 51fbf3d8..60745923 100644 --- a/Makefile +++ b/Makefile @@ -61,7 +61,7 @@ diagrams: arch-api.png # remove all cached state first. html: diagrams # -W = exit 1 on warning; --keep-going = complete build anyway; write log to ~/warnings.log - $(SPHINXBUILD) -W --keep-going -w /home/docbuilder/warnings.log -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html + $(SPHINXBUILD) -W --keep-going -w /home/docbuilder/sphinx-warnings.log -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." @@ -123,7 +123,7 @@ latex: latexpdf: # -W = exit 1 on warning; --keep-going = complete build anyway - $(SPHINXBUILD) -W --keep-going -w /home/docbuilder/warnings.log -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + $(SPHINXBUILD) -W --keep-going -w /home/docbuilder/sphinx-warnings.log -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through pdflatex..." $(MAKE) -C $(BUILDDIR)/latex all-pdf @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." -- cgit v1.2.3