From caa7fe100a868ca3b13d253635db6a5cddce0180 Mon Sep 17 00:00:00 2001
From: Michael Smith <xmldoc@users.sourceforge.net>
Date: Fri, 1 Sep 2006 00:03:46 +0000
Subject: [PATCH] Added torefsect1.xsl stylesheet for converting refparameter,
 refreturn, etc. markup to refsect1, and added a target in makefiles for
 generating DocBook-valid versions of doc source that can be Xincluded into
 reference doc.

---
 xsl/docsrc/common/Makefile   |  6 ++-
 xsl/docsrc/fo/Makefile       |  6 ++-
 xsl/docsrc/refentry/Makefile |  6 ++-
 xsl/docsrc/template/Makefile |  6 ++-
 xsl/docsrc/torefsect1.xsl    | 97 ++++++++++++++++++++++++++++++++++++
 5 files changed, 117 insertions(+), 4 deletions(-)
 create mode 100644 xsl/docsrc/torefsect1.xsl

diff --git a/xsl/docsrc/common/Makefile b/xsl/docsrc/common/Makefile
index 3db2d185f..8973b18b2 100644
--- a/xsl/docsrc/common/Makefile
+++ b/xsl/docsrc/common/Makefile
@@ -2,15 +2,19 @@ XSLT=../../../cvstools/saxon
 XJPARSE=../../../cvstools/xjparse
 
 JSTYLE=../../docsrc/xsl2jref.xsl
+TOREFSECT1=../../docsrc/torefsect1.xsl
 VPATH=../../common
 
-XMLFILES = common.xml
+XMLFILES = common.xml common.refsect1.xml
 
 all: $(XMLFILES)
 
 clean:
 	rm -f $(XMLFILES)
 
+%.refsect1.xml: %.xml $(TOREFSECT1)
+	$(XSLT) $< $(TOREFSECT1) $@
+
 %.xml : %.xsl $(JSTYLE) ../../docsrc/legalnotice.xml
 	$(XSLT) $< $(JSTYLE) /dev/null output-file=$@
 	$(XJPARSE) $@
diff --git a/xsl/docsrc/fo/Makefile b/xsl/docsrc/fo/Makefile
index 822619e9e..c720aaf6f 100644
--- a/xsl/docsrc/fo/Makefile
+++ b/xsl/docsrc/fo/Makefile
@@ -1,15 +1,19 @@
 include ../../../cvstools/Makefile.incl
 
 JSTYLE=../../docsrc/xsl2jref.xsl
+TOREFSECT1=../../docsrc/torefsect1.xsl
 VPATH=../../fo
 
-XMLFILES = docparam.xml table.xml
+XMLFILES = docparam.xml table.xml table.refsect1.xml
 
 all: $(XMLFILES)
 
 clean:
 	$(RM) $(XMLFILES)
 
+%.refsect1.xml: %.xml $(TOREFSECT1)
+	$(XSLT) $< $(TOREFSECT1) $@
+
 %.xml : %.xsl $(JSTYLE)
 	$(XSLT) $< $(JSTYLE) /dev/null output-file=$@
 	$(XJPARSE) $@
diff --git a/xsl/docsrc/refentry/Makefile b/xsl/docsrc/refentry/Makefile
index c2bd9f8dc..64397b508 100644
--- a/xsl/docsrc/refentry/Makefile
+++ b/xsl/docsrc/refentry/Makefile
@@ -2,14 +2,18 @@ XSLT=../../../cvstools/saxon
 XJPARSE=../../../cvstools/xjparse
 
 JSTYLE=../../docsrc/xsl2jref.xsl
+TOREFSECT1=../../docsrc/torefsect1.xsl
 VPATH=../../common
 
-XMLFILES = refentry.xml
+XMLFILES = refentry.xml refentry.refsect1.xml
 
 all: $(XMLFILES)
 
 clean:
 	rm -f $(XMLFILES)
 
+%.refsect1.xml: %.xml $(TOREFSECT1)
+	$(XSLT) $< $(TOREFSECT1) $@
+
 %.xml : %.xsl $(JSTYLE) ../../docsrc/legalnotice.xml
 	$(XSLT) $< $(JSTYLE) /dev/null output-file=$@
diff --git a/xsl/docsrc/template/Makefile b/xsl/docsrc/template/Makefile
index 1c45f23df..67c93f9ad 100644
--- a/xsl/docsrc/template/Makefile
+++ b/xsl/docsrc/template/Makefile
@@ -2,15 +2,19 @@ XSLT=../../../cvstools/saxon
 XJPARSE=../../../cvstools/xjparse
 
 JSTYLE=../../docsrc/xsl2jref.xsl
+TOREFSECT1=../../docsrc/torefsect1.xsl
 VPATH=../../template
 
-XMLFILES = titlepage.xml
+XMLFILES = titlepage.xml titlepage.refsect1.xml
 
 all: $(XMLFILES)
 
 clean:
 	rm -f $(XMLFILES)
 
+%.refsect1.xml: %.xml $(TOREFSECT1)
+	$(XSLT) $< $(TOREFSECT1) $@
+
 %.xml : %.xsl $(JSTYLE)
 	$(XSLT) $< $(JSTYLE) /dev/null output-file=$@
 	$(XJPARSE) $@
diff --git a/xsl/docsrc/torefsect1.xsl b/xsl/docsrc/torefsect1.xsl
new file mode 100644
index 000000000..eeee50915
--- /dev/null
+++ b/xsl/docsrc/torefsect1.xsl
@@ -0,0 +1,97 @@
+<?xml version='1.0'?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                xmlns:xi="http://www.w3.org/2001/XInclude"
+                xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
+                exclude-result-prefixes="xsl xi src"
+                version='1.0'>
+
+<xsl:output method="xml" indent="no"/>
+
+
+<!-- ********************************************************************
+     $Id$
+     ********************************************************************
+
+     This file is part of the XSL DocBook Stylesheet distribution.
+     See ../README or http://nwalsh.com/docbook/xsl/ for copyright
+     and other information.
+
+     ******************************************************************** -->
+
+<xsl:template match="node() | @*">
+  <xsl:copy>
+    <xsl:apply-templates select="@* | node()"/>
+  </xsl:copy>
+</xsl:template>
+
+<xsl:template match="refdescription">
+  <refsect1>
+    <title></title>
+    <xsl:apply-templates/>
+  </refsect1>
+</xsl:template>
+
+<xsl:template match="refauthor">
+  <refsect1>
+    <title>Author</title>
+    <xsl:apply-templates/>
+  </refsect1>
+</xsl:template>
+
+<xsl:template match="refversion">
+  <refsect1>
+    <title>Version</title>
+    <xsl:apply-templates/>
+  </refsect1>
+</xsl:template>
+
+<xsl:template match="refparameter">
+  <refsect1>
+    <title>Parameters</title>
+    <xsl:apply-templates/>
+  </refsect1>
+</xsl:template>
+
+<xsl:template match="refreturn">
+  <refsect1>
+    <title>Returns</title>
+    <xsl:apply-templates/>
+  </refsect1>
+</xsl:template>
+
+<xsl:template match="refexception|refthrows">
+  <refsect1>
+    <title>Exceptions</title>
+    <xsl:apply-templates/>
+  </refsect1>
+</xsl:template>
+
+<xsl:template match="refsee">
+  <refsect1>
+    <title>See</title>
+    <xsl:apply-templates/>
+  </refsect1>
+</xsl:template>
+
+<xsl:template match="refsince">
+  <refsect1>
+    <title>Since</title>
+    <xsl:apply-templates/>
+  </refsect1>
+</xsl:template>
+
+<xsl:template match="refserial">
+  <refsect1>
+    <title>Serial</title>
+    <xsl:apply-templates/>
+  </refsect1>
+</xsl:template>
+
+<xsl:template match="refdeprecated">
+  <refsect1>
+    <title>Deprecated</title>
+    <xsl:apply-templates/>
+  </refsect1>
+</xsl:template>
+
+</xsl:stylesheet>
-- 
2.40.0