From 77f08675a4d598d40949caac865219dff9e73efd Mon Sep 17 00:00:00 2001
From: Sunil Mohan Adapa <sunil@medhas.org>
Date: Wed, 18 May 2016 18:27:08 +0530
Subject: [PATCH] doc: Ability to debug documentation generation

---
 doc/Makefile | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/doc/Makefile b/doc/Makefile
index de97d8c3a..40fcf4654 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -20,6 +20,17 @@ MANUAL_URL="https://wiki.debian.org/FreedomBox/Manual?action=show&mimetype=text%
 
 OUTPUTS=freedombox-manual.pdf freedombox-manual.html freedombox-manual.part.html plinth.1
 
+# In order to debug various problems with the documents especially
+# intermediate LaTeX state, run make as follows:
+#
+#   $ make DEBUG=true
+#   or
+#   $ make DEBUG=true <target>
+#
+XMLTO_DEBUG_FLAGS=
+ifneq ($(DEBUG),)
+    XMLTO_DEBUG_FLAGS=--noclean -p '--debug'
+endif
 
 all: $(OUTPUTS)
 
@@ -47,7 +58,7 @@ fetch:
 
 
 %.pdf: %.xml
-	xmlto --with-dblatex pdf $<
+	xmlto $(XMLTO_DEBUG_FLAGS) --with-dblatex pdf $<
 
 
 %.part.html: %.html