[Spice-devel] [PATCH v2] doc: Generate chunked manual
Christophe Fergeau
cfergeau at redhat.com
Tue Apr 1 08:09:37 PDT 2014
This commit makes use of a2x in order to generate a chunked manual in
addition to the "all in one page" one.
---
Change since v1:
- keep using 'asciidoc' to generate single page manual
configure.ac | 7 ++++++-
docs/manual/Makefile.am | 14 +++++++++++++-
2 files changed, 19 insertions(+), 2 deletions(-)
diff --git a/configure.ac b/configure.ac
index 53d05a2..e4ba9b2 100644
--- a/configure.ac
+++ b/configure.ac
@@ -425,9 +425,14 @@ if test "x$enable_manual" != "xno"; then
AC_PATH_PROG([ASCIIDOC], [asciidoc])
AS_IF([test -z "$ASCIIDOC" && test "x$enable_manual" = "xyes"],
[AC_MSG_ERROR([asciidoc is missing and build of manual was requested])])
+ AC_PATH_PROG([A2X], [a2x])
+ AS_IF([test -z "$A2X" && test "x$enable_manual" = "xyes"],
+ [AC_MSG_ERROR([a2x is missing and build of manual was requested])])
fi
AS_IF([test -n "$ASCIIDOC"], [have_asciidoc=yes], [have_asciidoc=no])
-AM_CONDITIONAL([BUILD_MANUAL], [test -n "$ASCIIDOC"])
+AM_CONDITIONAL([BUILD_MANUAL], [test -n "$ASCIIDOC" || test -n "$A2X"])
+AM_CONDITIONAL([BUILD_HTML_MANUAL], [test -n "$ASCIIDOC"])
+AM_CONDITIONAL([BUILD_CHUNKED_MANUAL], [test -n "$A2X"])
dnl ===========================================================================
diff --git a/docs/manual/Makefile.am b/docs/manual/Makefile.am
index f464e7a..c8471b3 100644
--- a/docs/manual/Makefile.am
+++ b/docs/manual/Makefile.am
@@ -7,13 +7,25 @@ EXTRA_DIST = \
images/icons/*.png \
images/spicec01.png \
manual.html \
+ manual.chunked/* \
manual.txt \
$(NULL)
.txt.html:
$(AM_V_GEN) $(ASCIIDOC) $(ASCIIDOC_FLAGS) $<
-all-local: manual.html
+manual.chunked: manual.txt
+ $(AM_V_GEN) $(A2X) -f chunked $(ASCIIDOC_FLAGS) $<
+
+docfiles =
+if BUILD_HTML_MANUAL
+docfiles += manual.html
+endif
+if BUILD_CHUNKED_MANUAL
+docfiles += manual.chunked
+endif
+
+all-local: $(docfiles)
clean-local:
rm manual.html
--
1.9.0
More information about the Spice-devel
mailing list