From: Markus Lehtonen <markus.lehtonen@linux.intel.com>
Date: Mon, 13 Feb 2012 10:28:13 +0000 (+0200)
Subject: docs: enable building html docs with docbook2html
X-Git-Tag: release/20120807~87
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=289ff4db25a852ca76fee9f87c87da84a6c40a26;p=tools%2Fgit-buildpackage.git

docs: enable building html docs with docbook2html

This is useful if sgml2x package is not available.
---

diff --git a/docs/Makefile b/docs/Makefile
index a4b44046..53be8027 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -20,10 +20,18 @@ GBP_VERSION=../gbp/version.py
 DEB_VERSION=$(shell sed -ne 's/^gbp_version="\([.a-z0-9~]\+\)"/\1/p' $(GBP_VERSION))
 CHANGELOG=../debian/changelog
 
+# Stuff to build docs outside Debian
+HAVE_SGML2X ?= 1
+GTK_DOC_CATALOG_FILE ?= /usr/share/sgml/gtk-doc/gtk-doc.cat
+
 all: $(MANUAL) $(MANPAGES)
 
 $(MANUAL): manual.sgml chapters/*.sgml manpages/*.sgml
+ifeq ($(HAVE_SGML2X),1)
 	docbook-2-html -s local $<
+else
+	docbook2html -d local-nosgml2x.dsl -c $(GTK_DOC_CATALOG_FILE) -o $(MANUAL) $<
+endif
 	cp /usr/share/gtk-doc/data/*.png $(MANUAL)
 
 %.1: man.%.sgml manpages/%.sgml
diff --git a/docs/local-nosgml2x.dsl b/docs/local-nosgml2x.dsl
new file mode 100644
index 00000000..f9faab62
--- /dev/null
+++ b/docs/local-nosgml2x.dsl
@@ -0,0 +1,34 @@
+<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
+<!ENTITY dbstyle PUBLIC "-//Gtk//DOCUMENT Gtk-doc HTML Stylesheet//EN" CDATA DSSSL>
+]>
+
+<style-sheet>
+<style-specification use="gtk">
+<style-specification-body>
+
+;; Don't split up the doc as much.
+(define (chunk-element-list)
+  (list (normalize "preface")
+        (normalize "chapter")
+        (normalize "appendix")
+        (normalize "article")
+        (normalize "glossary")
+        (normalize "bibliography")
+        (normalize "index")
+        (normalize "colophon")
+        (normalize "setindex")
+        (normalize "reference")
+        (normalize "refentry")
+        (normalize "part")
+        (normalize "book") ;; just in case nothing else matches...
+        (normalize "set")  ;; sets are definitely chunks...
+        ))
+
+</style-specification-body>
+</style-specification>
+<external-specification id="gtk" document="dbstyle">
+</style-sheet>
+
+<!--
+# arch-tag: web stylesheet for documentation
+-->