diff options
author | buckE <buckE@disroot.org> | 2020-06-26 04:13:40 +0000 |
---|---|---|
committer | buckE <buckE@disroot.org> | 2020-06-26 04:13:40 +0000 |
commit | ac542c2f0bf79cfc302b0fb7059adbbc6bdf60f0 (patch) | |
tree | 1b25824b105a904167fc307dec4d9d46c84a8141 | |
parent | 7f6d92f19506e45e4e526d34af5210214e063311 (diff) | |
download | docs-ac542c2f0bf79cfc302b0fb7059adbbc6bdf60f0.tar.gz docs-ac542c2f0bf79cfc302b0fb7059adbbc6bdf60f0.tar.bz2 docs-ac542c2f0bf79cfc302b0fb7059adbbc6bdf60f0.zip |
removed exit 1 on sphinx warnings
-rw-r--r-- | Makefile | 7 | ||||
-rw-r--r-- | README | 4 |
2 files changed, 7 insertions, 4 deletions
@@ -60,8 +60,8 @@ 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; write log to ~/warnings.log - $(SPHINXBUILD) -W --keep-going -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html +# -W = exit 1 on warning; --keep-going = complete build anyway; -w /tmp/sphinx-warnings.log = write log to ~/warnings.log + $(SPHINXBUILD) -b html-linked $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." @@ -122,8 +122,7 @@ latex: "(use \`make latexpdf' here to do that automatically)." latexpdf: - # -W = exit 1 on warning; --keep-going = complete build anyway - $(SPHINXBUILD) -W --keep-going -w $(shell echo $HOME)/logs/sphinx-warnings.log -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." @@ -4,3 +4,7 @@ Before building the documentation, make sure that you have the required dependencies installed using pip3: $ pip3 install --user --upgrade recommonmark sphinx + +Note by Buck: when setting up on VM, I also needed: + +# apt install texlive-latex-extra graphviz |