commit 7ff50a732b6bb0e6e4de5387c2bff623e335f240
parent 0406210f38cebe8a46af29a64b81a083c9f8a762
Author: Christian Grothoff <christian@grothoff.org>
Date: Fri, 26 Jun 2020 09:31:32 +0200
Merge branch 'master' of git+ssh://git.taler.net/docs
Diffstat:
2 files changed, 7 insertions(+), 4 deletions(-)
diff --git a/Makefile b/Makefile
@@ -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."
diff --git a/README b/README
@@ -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