Add a note about doc/manual.tex generation.

The invocation doesn't work for me, but does work for Ken.  I'm
reluctant to touch and break it for existing users, so instead
add a note to the Makefile.am.  Perhaps someone with more knowledge of
those tools can make it portable.

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 0eb196ece2136acc638a858c6ffd7f03afcc8556..c612281e75b749d2199d90f67339e3da2bf2ea77 100644 (file)
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -131,6 +131,13 @@ $(CHUNKED_DOCFILES): stamp-doc-chunked
 manual.pdf: manual.tex
        -if test -f manual.tex; then pdfjadetex manual.tex; pdfjadetex manual.tex; pdfjadetex manual.tex; fi
 
+# Note / Request For Help:
+# On Debian, the below invocation of openjade is not working for me.
+# I was able to generate manual.tex by instead running:
+#     openjade -t tex -D $(DSLROOT) -d print/docbook.dsl \
+#       -i xml /usr/share/xml/declaration/xml.dcl manual.xml
+# However, being completely unfamiliar with these tools, am unsure how to
+# make this portable.
 manual.tex: stamp-doc-xml
        -if test -n "$(DSLROOT)"; then \
          openjade -t tex -D $(DSLROOT) -d print/docbook.dsl dtds/decls/xml.dcl manual.xml; \