[PATCH 3/5 v3] Show Xserver release/version date in DIX & DDX docs

Alan Coopersmith alan.coopersmith at oracle.com
Mon May 17 20:39:28 PDT 2010


Uses a catalog file to provide the path to an entity file in a
different directory than the xml sources.

Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>
---
 configure.ac                   |    2 ++
 doc/xml/Makefile.am            |    5 ++++-
 doc/xml/Xserver-spec.xml       |    4 +++-
 doc/xml/xmlrules.in            |   16 ++++++++++++----
 hw/xfree86/doc/sgml/DESIGN.xml |    4 +++-
 5 files changed, 24 insertions(+), 7 deletions(-)

diff --git a/configure.ac b/configure.ac
index 3c7a8de..5fc6d35 100644
--- a/configure.ac
+++ b/configure.ac
@@ -2147,6 +2147,7 @@ AC_TRY_COMPILE([
 
 AC_DEFINE_DIR(PROJECTROOT, prefix, [Overall prefix])
 
+AC_SUBST([RELEASE_DATE])
 BUILD_DATE="`date +'%Y%m%d'`"
 AC_SUBST([BUILD_DATE])
 BUILD_TIME="`date +'1%H%M%S'`"
@@ -2170,6 +2171,7 @@ dbe/Makefile
 dix/Makefile
 doc/Makefile
 doc/xml/Makefile
+doc/xml/xserver.ent
 fb/Makefile
 record/Makefile
 config/Makefile
diff --git a/doc/xml/Makefile.am b/doc/xml/Makefile.am
index df4833c..f3b0aa3 100644
--- a/doc/xml/Makefile.am
+++ b/doc/xml/Makefile.am
@@ -28,6 +28,9 @@ include xmlrules.in
 if ENABLE_DEVEL_DOCS
 noinst_DATA = $(BUILT_DOC_FILES)
 endif
-CLEANFILES = $(CLEAN_DOC_FILES)
+CLEANFILES = $(CLEAN_DOC_FILES) catalog
 
 EXTRA_DIST = $(XML_FILES)
+
+catalog:
+	$(AM_V_GEN)echo 'SYSTEM "xserver.ent" "$(abs_builddir)/xserver.ent"' > $@
diff --git a/doc/xml/Xserver-spec.xml b/doc/xml/Xserver-spec.xml
index 8691f18..5ce13c9 100644
--- a/doc/xml/Xserver-spec.xml
+++ b/doc/xml/Xserver-spec.xml
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+ <!ENTITY % defs SYSTEM "xserver.ent"> %defs;
 ]>
 
 <article>
@@ -38,7 +39,8 @@
       <affiliation><orgname>X.org Foundation and Hewlett Packard</orgname></affiliation>
     </author>
     <publisher><publishername>The X.Org Foundation</publishername></publisher>
-    <pubdate>2004</pubdate>
+    <pubdate>&xserver.reldate;</pubdate>
+    <releaseinfo>X server version &xserver.version;</releaseinfo>
     <title>Definition of the Porting Layer for the X v11 Sample Server</title>
     <titleabbrev>X Porting Layer</titleabbrev>
     <revhistory>
diff --git a/doc/xml/xmlrules.in b/doc/xml/xmlrules.in
index b5856f7..e9d0e43 100644
--- a/doc/xml/xmlrules.in
+++ b/doc/xml/xmlrules.in
@@ -36,26 +36,34 @@ BUILT_DOC_FILES =
 
 SUFFIXES = .xml .txt .html .pdf
 
+XML_ENT_DIR = $(top_builddir)/doc/xml
+DOCBOOK_FLAGS = --cat $(XML_ENT_DIR)/catalog
+
 if BUILD_TXTDOC
 BUILT_DOC_FILES += $(TXT_FILES)
 .xml.txt:
 	@rm -f $@
-	$(AM_V_GEN)$(MAKE_TEXT) $<
+	$(AM_V_GEN)$(MAKE_TEXT) $(DOCBOOK_FLAGS) $<
 endif
 
 if BUILD_HTMLDOC
 BUILT_DOC_FILES += $(HTML_FILES)
 .xml.html:
 	@rm -f $@
-	$(AM_V_GEN)$(MAKE_HTML) -u $<
+	$(AM_V_GEN)$(MAKE_HTML) $(DOCBOOK_FLAGS) -u $<
 endif
 
 if BUILD_PDFDOC
 BUILT_DOC_FILES += $(PDF_FILES)
 .xml.pdf:
 	@rm -f $@
-	$(AM_V_GEN)$(MAKE_PDF) $<
+	$(AM_V_GEN)$(MAKE_PDF) $(DOCBOOK_FLAGS) $<
 endif
 
-
 CLEAN_DOC_FILES = $(TXT_FILES) $(HTML_FILES) $(PDF_FILES)
+
+# All the files we build depend on the entities & catalog
+$(BUILT_DOC_FILES): $(XML_ENT_DIR)/xserver.ent $(XML_ENT_DIR)/catalog
+
+$(XML_ENT_DIR)/xserver.ent $(XML_ENT_DIR)/catalog:
+	(cd $(XML_ENT_DIR) && $(MAKE) $(AM_MAKEFLAGS) $(@F))
diff --git a/hw/xfree86/doc/sgml/DESIGN.xml b/hw/xfree86/doc/sgml/DESIGN.xml
index 0613359..639e92c 100644
--- a/hw/xfree86/doc/sgml/DESIGN.xml
+++ b/hw/xfree86/doc/sgml/DESIGN.xml
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+ <!ENTITY % defs SYSTEM "xserver.ent"> %defs;
  <!-- config file keyword markup -->
  <!-- specific config file keywords -->
  <!ENTITY k.device "<emphasis>Device</emphasis>">
@@ -29,7 +30,8 @@
       </othercredit>
     </authorgroup>
 
-    <pubdate>19 December 2003</pubdate>
+    <pubdate>&xserver.reldate;</pubdate>
+    <releaseinfo>Xorg server version &xserver.version;</releaseinfo>
 
   </articleinfo>
 
-- 
1.5.6.5



More information about the xorg-devel mailing list