Update of /cvsroot/docbook/xsl/docsrc
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv6558/docsrc
Modified Files:
Tag: build
Makefile
No tag
make-xsl-params.pl reference.xml xsl-param-link.xsl
Log Message:
Added litprog reference documentation infrastructure for manpages.
Note that changes to the existing Makefile doc/Makefile docsrc/Makefile files
are on the build branch only, so will need to be back-ported to head
in order for head builds of the docs to include doc for manpage params
Index: Makefile
===================================================================
RCS file: /cvsroot/docbook/xsl/docsrc/Makefile,v
retrieving revision 1.6.2.1
retrieving revision 1.6.2.2
diff -u -U2 -r1.6.2.1 -r1.6.2.2
--- Makefile 2 Dec 2004 11:30:58 -0000 1.6.2.1
+++ Makefile 24 Feb 2005 08:23:15 -0000 1.6.2.2
@@ -1,3 +1,3 @@
-DIRS=common html fo template tools pi
+DIRS=common html fo manpages template tools pi
all: xsl-params.xsl
Index: make-xsl-params.pl
===================================================================
RCS file: /cvsroot/docbook/xsl/docsrc/make-xsl-params.pl,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -U2 -r1.1 -r1.2
--- make-xsl-params.pl 19 Sep 2002 22:05:34 -0000 1.1
+++ make-xsl-params.pl 24 Feb 2005 08:23:15 -0000 1.2
@@ -42,4 +42,20 @@
</xsl:variable>
+<xsl:variable name="xsl-fo-parameters-list">
+ <simplelist>
+EOF3
+
+open (F, "../manpages/param.xsl");
+read (F, $_, -s "../manpages/param.xsl");
+close (F);
+foreach my $param (/<xsl:param name="[^\"]+"/gs) {
+ $param =~ /name=\"(.*)\"/;
+ print " <member>$1</member>\n",
+}
+
+print <<EOF4;
+ </simplelist>
+</xsl:variable>
+
<xsl:variable name="xsl-html-parameters"
select="exsl:node-set(\$xsl-html-parameters-list)/simplelist"/>
@@ -48,4 +64,7 @@
select="exsl:node-set(\$xsl-fo-parameters-list)/simplelist"/>
+<xsl:variable name="xsl-manpages-parameters"
+ select="exsl:node-set(\$xsl-manpages-parameters-list)/simplelist"/>
+
<xsl:template name="is-html-parameter">
<xsl:param name="param" select="''"/>
@@ -66,4 +85,13 @@
</xsl:template>
+<xsl:template name="is-manpages-parameter">
+ <xsl:param name="param" select="''"/>
+
+ <xsl:choose>
+ <xsl:when test="\$xsl-manpages-parameters/member[. = \$param]">1</xsl:when>
+ <xsl:otherwise>0</xsl:otherwise>
+ </xsl:choose>
+</xsl:template>
+
</xsl:stylesheet>
-EOF3
+EOF4
Index: reference.xml
===================================================================
RCS file: /cvsroot/docbook/xsl/docsrc/reference.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -U2 -r1.5 -r1.6
--- reference.xml 25 Mar 2002 14:01:39 -0000 1.5
+++ reference.xml 24 Feb 2005 08:23:15 -0000 1.6
@@ -7,4 +7,5 @@
<!ENTITY fo-param.xml SYSTEM "fo/param.xml" NDATA SGML>
<!ENTITY fo-table.xml SYSTEM "fo/table.xml" NDATA SGML>
+<!ENTITY manpages-param.xml SYSTEM "manpages/param.xml" NDATA SGML>
<!ENTITY titlepage.xml SYSTEM "template/titlepage.xml" NDATA SGML>
]>
@@ -46,4 +47,7 @@
targetdocent="fo-table.xml"/></para>
</listitem>
+<listitem><para><olink type="title" localinfo="manpages/index.html"
+ targetdocent="manpages-param.xml"/></para>
+</listitem>
</itemizedlist>
Index: xsl-param-link.xsl
===================================================================
RCS file: /cvsroot/docbook/xsl/docsrc/xsl-param-link.xsl,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -U2 -r1.1 -r1.2
--- xsl-param-link.xsl 19 Sep 2002 22:05:34 -0000 1.1
+++ xsl-param-link.xsl 24 Feb 2005 08:23:15 -0000 1.2
@@ -11,4 +11,7 @@
select="'http://docbook.sourceforge.net/release/xsl/current/doc/fo/'"/>
+<xsl:param name="manpages-baseuri"
+ select="'http://docbook.sourceforge.net/release/xsl/current/doc/manpages/'"/>
+
<xsl:template match="parameter">
<xsl:variable name="markup">
@@ -28,4 +31,10 @@
</xsl:variable>
+ <xsl:variable name="ismanpages">
+ <xsl:call-template name="is-manpages-parameter">
+ <xsl:with-param name="param" select="normalize-space(.)"/>
+ </xsl:call-template>
+ </xsl:variable>
+
<xsl:choose>
<xsl:when test="$ishtml != 0">
@@ -39,4 +48,9 @@
</a>
</xsl:when>
+ <xsl:when test="$ismanpages != 0">
+ <a href="{concat($manpages-baseuri, normalize-space(.))}.html">
+ <xsl:copy-of select="$markup"/>
+ </a>
+ </xsl:when>
<xsl:otherwise>
<xsl:copy-of select="$markup"/>
|