booky 0.0.4 → 0.0.6

data/lib/stylesheets/manpages/refentry.xsl

@@ -1,321 +0,0 @@
-<?xml version='1.0'?>
-<xsl:stylesheet exclude-result-prefixes="d"
-                 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-                xmlns:d="http://docbook.org/ns/docbook"
-version='1.0'>
-
-<!-- ********************************************************************
-     $Id: refentry.xsl 8235 2009-02-09 16:22:14Z xmldoc $
-     ********************************************************************
-
-     This file is part of the XSL DocBook Stylesheet distribution.
-     See ../README or http://docbook.sf.net/release/xsl/current/ for
-     copyright and other information.
-
-     ******************************************************************** -->
-
-<!-- ==================================================================== -->
-
-  <xsl:template match="d:refnamediv">
-    <xsl:choose>
-      <xsl:when test="preceding-sibling::d:refnamediv">
-        <!-- * No title on secondary refnamedivs! -->
-        <!-- * Just put a single line break instead -->
-        <xsl:text>.br&#10;</xsl:text>
-      </xsl:when>
-      <xsl:otherwise>
-        <xsl:call-template name="make.subheading">
-          <xsl:with-param name="title">
-            <xsl:apply-templates select="." mode="subheading.markup"/>
-          </xsl:with-param>
-        </xsl:call-template>
-      </xsl:otherwise>
-    </xsl:choose>
-    <xsl:call-template name="mark.subheading"/>
-    <!-- * if we have multiple Refname instances, separate the names -->
-    <!-- * with commas -->
-    <xsl:for-each select="d:refname">
-      <xsl:if test="position()>1">
-        <xsl:text>, </xsl:text>
-      </xsl:if>
-      <xsl:call-template name="string.subst">
-        <!-- * To create the name(s) for this man page, replace any -->
-        <!-- * spaces in the refname(s) with underscores. This ensures -->
-        <!-- * that tools like lexgrog(1) will be able to parse the name -->
-        <!-- * (lexgrog won’t parse names that contain spaces). -->
-        <xsl:with-param name="string" select="."/>
-        <xsl:with-param name="target" select="' '"/>
-        <xsl:with-param name="replacement" select="'_'"/>
-      </xsl:call-template>
-    </xsl:for-each>
-    <!-- * The man(7) man pages says: -->
-    <!-- * -->
-    <!-- *   The only required heading is NAME, which should be the -->
-    <!-- *   first section and be followed on the next line by a one -->
-    <!-- *   line description of the program: -->
-    <!-- * -->
-    <!-- *      .SH NAME chess \- the game of chess -->
-    <!-- * -->
-    <!-- *   It is extremely important that this format is followed, -->
-    <!-- *   and that there is a backslash before the single dash -->
-    <!-- *   which follows the command name.  This syntax is used by -->
-    <!-- *   the makewhatis(8) program to create a database of short -->
-    <!-- *   command descriptions for the whatis(1) and apropos(1) -->
-    <!-- *   commands. -->
-    <!-- * -->
-    <xsl:if test="d:refpurpose/node()">
-      <xsl:text> \- </xsl:text>
-      <xsl:variable name="refpurpose">
-        <xsl:apply-templates select="d:refpurpose/node()"/>
-      </xsl:variable>
-      <xsl:value-of select="normalize-space($refpurpose)"/>
-    </xsl:if>
-    <xsl:text>&#10;</xsl:text>
-  </xsl:template>
-
-  <xsl:template match="d:refsynopsisdiv">
-    <xsl:call-template name="make.subheading">
-      <xsl:with-param name="title">
-        <xsl:apply-templates select="." mode="subheading.markup"/>
-      </xsl:with-param>
-    </xsl:call-template>
-    <xsl:apply-templates/>
-  </xsl:template>
-
-  <xsl:template match="d:refsect1|d:refentry/d:refsection">
-    <xsl:variable name="title">
-      <xsl:apply-templates select="." mode="subheading.markup"/>
-    </xsl:variable>
-    <xsl:call-template name="make.subheading">
-      <xsl:with-param name="title">
-        <xsl:value-of select="normalize-space($title)"/>
-      </xsl:with-param>
-    </xsl:call-template>
-    <xsl:apply-templates/>
-  </xsl:template>
-
-  <xsl:template match="d:refsect2|d:refentry/d:refsection/d:refsection">
-    <xsl:call-template name="mark.subheading"/>
-    <xsl:variable name="title">
-      <xsl:apply-templates
-          select="(d:info/d:title
-                  |d:refsectioninfo/d:title
-                  |d:refsect1info/d:title
-                  |d:title)[1]/node()"/>
-    </xsl:variable>
-    <xsl:text>.SS "</xsl:text>
-    <xsl:value-of select="normalize-space($title)"/>
-    <xsl:text>"&#10;</xsl:text>
-    <xsl:call-template name="mark.subheading"/>
-    <xsl:choose>
-      <!-- * If default-indentation adjustment is on, then indent the -->
-      <!-- * child content of this Refsect2 -->
-      <xsl:when test="not($man.indent.refsect = 0)">
-        <xsl:text>.RS&#10;</xsl:text>
-        <xsl:apply-templates/>
-        <xsl:text>.RE&#10;</xsl:text>
-      </xsl:when>
-      <xsl:otherwise>
-        <!-- * If default-indentation adjustment is on, then do not -->
-        <!-- * indent the child content of this Refsect2, because -->
-        <!-- * the title is already "sticking out to the left" -->
-        <!-- * (as the groff_man(7) man page describes it), which -->
-        <!-- * actually means the title is indented by the value of -->
-        <!-- * the SN register, which appears by default to be -->
-        <!-- * about half of the default indentation value -->
-        <xsl:apply-templates/>
-      </xsl:otherwise>
-    </xsl:choose>
-  </xsl:template>
-
-  <xsl:template match="d:refsect3|d:refentry/d:refsection/d:refsection/d:refsection">
-    <xsl:variable name="title">
-      <xsl:value-of select="(d:info/d:title
-                            |d:refsectioninfo/d:title
-                            |d:refsect1info/d:title
-                            |d:title)[1]"/>
-    </xsl:variable>
-    <xsl:choose>
-      <!-- * If default-indentation adjustment is on, then indent the -->
-      <!-- * child content of this Refsect3 or Refsection. -->
-      <xsl:when test="not($man.indent.refsect != 0)">
-        <xsl:call-template name="nested-section-title"/>
-        <xsl:text>.RS</xsl:text>
-        <xsl:if test="not($man.indent.width = '')">
-          <xsl:text> </xsl:text>
-          <xsl:value-of select="$man.indent.width"/>
-        </xsl:if>
-        <xsl:text>&#10;</xsl:text>
-        <xsl:apply-templates/>
-        <xsl:text>.RE&#10;</xsl:text>
-      </xsl:when>
-      <xsl:otherwise>
-        <!-- * If default-indentation adjustment is on, then do not -->
-        <!-- * indent the child content of this Refsect2, because -->
-        <!-- * the title is already "sticking out to the left" -->
-        <!-- * (as the groff_man(7) man page describes it), which -->
-        <!-- * actually means the title is indented by the value of -->
-        <!-- * the SN register, which appears by default to be -->
-        <!-- * about half of the default indentation value -->
-        <xsl:text>.ti (\n(SNu * 5u / 3u)&#10;</xsl:text>
-        <xsl:call-template name="nested-section-title"/>
-        <xsl:apply-templates/>
-      </xsl:otherwise>
-    </xsl:choose>
-  </xsl:template>
-
-  <xsl:template match="d:refsection">
-    <!-- * This template is used for a nested Refsection that is -->
-    <!-- * is a child of a Refsect3-level section (The numberd -->
-    <!-- * Refsect hierarchy in DocBook ends with Refsect3, so -->
-    <!-- * there is not actually a Refsect4 element.) -->
-    <xsl:variable name="title">
-      <xsl:value-of select="(d:info/d:title
-                            |d:refsectioninfo/d:title
-                            |d:refsect1info/d:title
-                            |d:title)[1]"/>
-    </xsl:variable>
-    <xsl:variable name="indent-width">
-      <xsl:if test="not($man.indent.refsect = 0)">
-        <!-- * If default-indentation adjustment is on, then indent the -->
-        <!-- * child content of this Refsect3 or Refsection. -->
-        <xsl:text>(\n(SNu)&#10;</xsl:text>
-      </xsl:if>
-    </xsl:variable>
-    <xsl:call-template name="nested-section-title"/>
-    <xsl:text>.RS (\n(SNu)&#10;</xsl:text>
-    <xsl:apply-templates/>
-    <xsl:text>.RE&#10;</xsl:text>
-  </xsl:template>
-
-  <!-- ==================================================================== -->
-
-  <xsl:template match="d:refsect1|d:refentry/d:refsection"
-                mode="subheading.markup">
-    <xsl:variable name="title" select="(d:info/d:title
-      |d:refsectioninfo/d:title
-      |d:refsect1info/d:title
-      |d:title)[1]"/>
-    <xsl:apply-templates select="$title" mode="title.markup"/>
-  </xsl:template>
-
-  <xsl:template match="d:refsect1|d:refentry/d:refsection"
-    mode="title.markup">
-    <!-- * Note: This template is used just for generating the text for -->
-    <!-- * cross-references to Refsect1 or top-level Refsection instances. -->
-    <xsl:variable name="title" select="(d:info/d:title
-      |d:refsectioninfo/d:title
-      |d:refsect1info/d:title
-      |d:title)[1]"/>
-    <xsl:call-template name="process.SH.xref">
-      <xsl:with-param name="title">
-        <xsl:apply-templates select="$title" mode="title.markup"/>
-      </xsl:with-param>
-    </xsl:call-template>
-  </xsl:template>
-
-  <!-- * Output of Titles from Xref with Endterm needs to be handled -->
-  <!-- * separately from output for Endterm-less Xref -->
-  <xsl:template match="d:refsect1/d:title
-    |d:refentry/d:refsection/d:title
-    |d:refsynopsisdiv/d:title"
-    mode="endterm">
-    <xsl:call-template name="process.SH.xref">
-      <xsl:with-param name="title">
-        <xsl:apply-templates/>
-      </xsl:with-param>
-    </xsl:call-template>
-  </xsl:template>
-
-  <xsl:template match="d:refsynopsisdiv" mode="subheading.markup">
-    <xsl:param name="allow-anchors" select="0"/>
-    <xsl:variable name="title">
-      <xsl:call-template name="get.refsynopsisdiv.title">
-        <xsl:with-param name="allow-anchors" select="$allow-anchors"/>
-      </xsl:call-template>
-    </xsl:variable>
-    <xsl:value-of select="$title"/>
-  </xsl:template>
-
-  <xsl:template match="d:refsynopsisdiv" mode="title.markup">
-    <!-- * Note: This template is used just for generating the text for -->
-    <!-- * cross-references to Refsynopsisdiv instances. -->
-    <xsl:param name="allow-anchors" select="0"/>
-    <xsl:variable name="title">
-      <xsl:call-template name="get.refsynopsisdiv.title">
-        <xsl:with-param name="allow-anchors" select="$allow-anchors"/>
-      </xsl:call-template>
-    </xsl:variable>
-    <xsl:call-template name="process.SH.xref">
-      <xsl:with-param name="title" select="$title"/>
-    </xsl:call-template>
-  </xsl:template>
-
-  <xsl:template name="get.refsynopsisdiv.title">
-    <xsl:param name="allow-anchors"/>
-    <xsl:choose>
-      <xsl:when test="d:info/d:title
-        |d:refsynopsisdivinfo/d:title
-        |d:title">
-        <xsl:apply-templates
-          select="(d:info/d:title
-          |d:refsynopsisdivinfo/d:title
-          |d:title)[1]" mode="title.markup">
-          <xsl:with-param name="allow-anchors" select="$allow-anchors"/>
-        </xsl:apply-templates>
-      </xsl:when>
-      <xsl:otherwise>
-        <xsl:call-template name="gentext">
-          <xsl:with-param name="key" select="'RefSynopsisDiv'"/>
-        </xsl:call-template>
-      </xsl:otherwise>
-    </xsl:choose>
-  </xsl:template>
-
-  <xsl:template match="d:refnamediv" mode="subheading.markup">
-    <xsl:call-template name="gentext">
-      <xsl:with-param name="key" select="'RefName'"/>
-    </xsl:call-template>
-  </xsl:template>
-
-  <xsl:template match="d:refnamediv" mode="title.markup">
-    <xsl:call-template name="process.SH.xref">
-      <xsl:with-param name="title">
-        <xsl:call-template name="gentext">
-          <xsl:with-param name="key" select="'RefName'"/>
-        </xsl:call-template>
-      </xsl:with-param>
-    </xsl:call-template>
-  </xsl:template>
-
-  <xsl:template match="d:refnamediv" mode="xref-to">
-    <xsl:apply-templates select="." mode="title.markup"/>
-  </xsl:template>
-
-  <!-- * suppress any title we don't otherwise process elsewhere -->
-  <xsl:template match="d:title"/>
-
-  <!-- ==================================================================== -->
-
-  <xsl:template name="process.SH.xref">
-    <xsl:param name="title"/>
-    <xsl:choose>
-      <xsl:when test="not($man.output.better.ps.enabled = 0)">
-        <xsl:text>\c</xsl:text>
-        <xsl:text>&#x2592;</xsl:text>
-        <xsl:text>.SH-xref </xsl:text>
-        <xsl:text>"</xsl:text>
-        <xsl:value-of select="$title"/>
-        <xsl:text>\c"</xsl:text>
-        <xsl:text>&#x2592;</xsl:text>
-        <xsl:text>\&amp;</xsl:text>
-      </xsl:when>
-      <xsl:otherwise>
-        <xsl:call-template name="string.upper">
-          <xsl:with-param name="string" select="$title"/>
-        </xsl:call-template>
-      </xsl:otherwise>
-    </xsl:choose>
-  </xsl:template>
-
-</xsl:stylesheet>

data/lib/stylesheets/manpages/synop.xsl

@@ -1,433 +0,0 @@
-<?xml version='1.0'?>
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-                xmlns:d="http://docbook.org/ns/docbook"
-xmlns:exsl="http://exslt.org/common"
-                exclude-result-prefixes="exsl d"
-                version='1.0'>
-
-<!-- ********************************************************************
-     $Id: synop.xsl 7956 2008-03-27 12:07:43Z xmldoc $
-     ********************************************************************
-
-     This file is part of the XSL DocBook Stylesheet distribution.
-     See ../README or http://docbook.sf.net/release/xsl/current/ for
-     copyright and other information.
-
-     ******************************************************************** -->
-
-<xsl:variable name="arg.or.sep"> |</xsl:variable>
-
-<!-- * Note: If you're looking for the *Synopsis* element, you won't -->
-<!-- * find any code here for handling it. It's a "verbatim" -->
-<!-- * environment; see the block.xsl file instead. -->
-
-<xsl:template match="d:synopfragmentref">
-  <xsl:variable name="target" select="key('id',@linkend)"/>
-  <xsl:variable name="snum">
-    <xsl:apply-templates select="$target" mode="synopfragment.number"/>
-  </xsl:variable>
-  <xsl:text>(</xsl:text>
-  <xsl:value-of select="$snum"/>
-  <xsl:text>)</xsl:text>
-  <xsl:text>&#x2580;</xsl:text>
-  <xsl:call-template name="italic">
-    <xsl:with-param name="node" select="."/>
-    <xsl:with-param name="context" select="."/>
-  </xsl:call-template>
-</xsl:template>
-
-<xsl:template match="d:synopfragment" mode="synopfragment.number">
-  <xsl:number format="1"/>
-</xsl:template>
-
-<xsl:template match="d:synopfragment">
-  <xsl:variable name="snum">
-    <xsl:apply-templates select="." mode="synopfragment.number"/>
-  </xsl:variable>
-  <xsl:text>&#10;</xsl:text>
-  <!-- * If we have a group of Synopfragments, we only want to output a -->
-  <!-- * line of space before the first; so when we find a Synopfragment -->
-  <!-- * which has another Synopfragment as a following sibling, we use-->
-  <!-- * the pinch-together template to close up the line of space -->
-  <!-- * that would otherwise be generated by the .HP macro -->
-  <xsl:if test="following-sibling::*[self::d:synopfragment]">
-    <xsl:call-template name="pinch.together"/>
-  </xsl:if>
-  <xsl:text>.HP </xsl:text>
-  <xsl:text>\w'</xsl:text>
-  <xsl:text>(</xsl:text>
-  <xsl:value-of select="$snum"/>
-  <xsl:text>)</xsl:text>
-  <xsl:text>\ 'u</xsl:text>
-  <xsl:text>&#10;</xsl:text>
-  <xsl:text>(</xsl:text>
-  <xsl:value-of select="$snum"/>
-  <xsl:text>)</xsl:text>
-  <xsl:text>\ </xsl:text>
-  <xsl:apply-templates/>
-</xsl:template>
-
-<xsl:template match="d:group|d:arg" name="group-or-arg">
-  <xsl:variable name="choice" select="@choice"/>
-  <xsl:variable name="rep" select="@rep"/>
-  <xsl:variable name="sepchar">
-    <xsl:choose>
-      <xsl:when test="ancestor-or-self::*/@sepchar">
-        <xsl:value-of select="ancestor-or-self::*/@sepchar"/>
-      </xsl:when>
-      <xsl:otherwise>
-        <xsl:text> </xsl:text>
-      </xsl:otherwise>
-    </xsl:choose>
-  </xsl:variable>
-  <xsl:if test="position()>1 and
-                not(preceding-sibling::*[1][self::d:sbr])"
-          ><xsl:value-of select="$sepchar"/></xsl:if>
-  <xsl:choose>
-    <xsl:when test="$choice='plain'">
-      <!-- * do nothing -->
-    </xsl:when>
-    <xsl:when test="$choice='req'">
-      <xsl:value-of select="$arg.choice.req.open.str"/>
-    </xsl:when>
-    <xsl:when test="$choice='opt'">
-      <xsl:value-of select="$arg.choice.opt.open.str"/>
-    </xsl:when>
-    <xsl:otherwise>
-      <xsl:value-of select="$arg.choice.def.open.str"/>
-    </xsl:otherwise>
-  </xsl:choose>
-  <xsl:variable name="arg">
-    <xsl:apply-templates/>
-  </xsl:variable>
-  <xsl:choose>
-    <xsl:when test="local-name(.) = 'arg' and not(ancestor::d:arg)">
-      <!-- * Prevent arg contents from getting wrapped and broken up -->
-      <xsl:variable name="arg.wrapper">
-        <Arg><xsl:value-of select="normalize-space($arg)"/></Arg>
-      </xsl:variable>
-      <xsl:apply-templates mode="prevent.line.breaking"
-                           select="exsl:node-set($arg.wrapper)"/>
-    </xsl:when>
-    <xsl:otherwise>
-      <xsl:value-of select="$arg"/>
-    </xsl:otherwise>
-  </xsl:choose>
-  <xsl:choose>
-    <xsl:when test="$rep='repeat'">
-      <xsl:value-of select="$arg.rep.repeat.str"/>
-    </xsl:when>
-    <xsl:when test="$rep='norepeat'">
-      <xsl:value-of select="$arg.rep.norepeat.str"/>
-    </xsl:when>
-    <xsl:otherwise>
-      <xsl:value-of select="$arg.rep.def.str"/>
-    </xsl:otherwise>
-  </xsl:choose>
-  <xsl:choose>
-    <xsl:when test="$choice='plain'">
-      <xsl:if test='d:arg'>
-      <xsl:value-of select="$arg.choice.plain.close.str"/>
-      </xsl:if>
-    </xsl:when>
-    <xsl:when test="$choice='req'">
-      <xsl:value-of select="$arg.choice.req.close.str"/>
-    </xsl:when>
-    <xsl:when test="$choice='opt'">
-      <xsl:value-of select="$arg.choice.opt.close.str"/>
-    </xsl:when>
-    <xsl:otherwise>
-      <xsl:value-of select="$arg.choice.def.close.str"/>
-    </xsl:otherwise>
-  </xsl:choose>
-</xsl:template>
-
-<xsl:template match="d:group/d:arg">
-  <xsl:variable name="choice" select="@choice"/>
-  <xsl:variable name="rep" select="@rep"/>
-  <xsl:if test="position()>1"><xsl:value-of select="$arg.or.sep"/></xsl:if>
-  <xsl:call-template name="group-or-arg"/>
-</xsl:template>
-
-<xsl:template match="d:sbr">
-  <xsl:text>&#x2592;</xsl:text>
-  <xsl:text>.br&#x2592;</xsl:text>
-</xsl:template>
-
-<xsl:template match="d:cmdsynopsis">
-  <!-- * if justification is enabled by default, turn it off temporarily -->
-  <xsl:if test="$man.justify != 0">
-    <xsl:text>.ad l&#10;</xsl:text>
-  </xsl:if>
-  <!-- * if hyphenation is enabled by default, turn it off temporarily -->
-  <xsl:if test="$man.hyphenate != 0">
-    <xsl:text>.hy 0&#10;</xsl:text>
-  </xsl:if>
-  <xsl:call-template name="synopsis-block-start"/>
-  <xsl:text>.HP </xsl:text>
-  <xsl:text>\w'</xsl:text>
-  <xsl:variable name="command">
-    <xsl:apply-templates select="d:command"/>
-  </xsl:variable>
-  <xsl:call-template name="string.subst">
-    <xsl:with-param name="string" select="normalize-space($command)"/>
-    <xsl:with-param name="target" select="' '"/>
-    <xsl:with-param name="replacement" select="'\ '"/>
-  </xsl:call-template>
-  <xsl:text>\ 'u</xsl:text>
-  <xsl:text>&#10;</xsl:text>
-  <xsl:apply-templates/>
-  <xsl:text>&#10;</xsl:text>
-  <xsl:call-template name="synopsis-block-end"/>
-  <!-- * if justification is enabled by default, turn it back on -->
-  <xsl:if test="$man.justify != 0">
-    <xsl:text>.ad&#10;</xsl:text>
-  </xsl:if>
-  <!-- * if hyphenation is enabled by default, turn it back on -->
-  <xsl:if test="$man.hyphenate != 0">
-    <xsl:text>.hy&#10;</xsl:text>
-  </xsl:if>
-</xsl:template>
-
-<!-- ==================================================================== -->
-<!-- *  Funcsynopis hierarchy starts here -->
-<!-- ==================================================================== -->
-
-<!-- * Note: If you're looking for the *Funcsynopsisinfo* element, -->
-<!-- * you won't find any code here for handling it. It's a "verbatim" -->
-<!-- * environment; see the block.xsl file instead. -->
-
-<!-- * Within funcsynopis output, disable hyphenation, and use -->
-<!-- * left-aligned filling for the duration of the synopsis, so that -->
-<!-- * line breaks only occur between separate paramdefs. -->
-<xsl:template match="d:funcsynopsis">
-  <!-- * if justification is enabled by default, turn it off temporarily -->
-  <xsl:if test="$man.justify != 0">
-    <xsl:text>.ad l&#10;</xsl:text>
-  </xsl:if>
-  <!-- * if hyphenation is enabled by default, turn it off temporarily -->
-  <xsl:if test="$man.hyphenate != 0">
-    <xsl:text>.hy 0&#10;</xsl:text>
-  </xsl:if>
-  <xsl:apply-templates/>
-  <!-- * if justification is enabled by default, turn it back on -->
-  <xsl:if test="$man.justify != 0">
-    <xsl:text>.ad&#10;</xsl:text>
-  </xsl:if>
-  <!-- * if hyphenation is enabled by default, turn it back on -->
-  <xsl:if test="$man.hyphenate != 0">
-    <xsl:text>.hy&#10;</xsl:text>
-  </xsl:if>
-</xsl:template>
-
-<!-- * In HTML output, placing a dbfunclist PI as a child of a particular -->
-<!-- * element creates a hyperlinked list of all funcsynopsis instances -->
-<!-- * that are descendants of that element. But we can’t really do this -->
-<!-- * kind of hyperlinked list in manpages output, so we just need to -->
-<!-- * suppress it instead. -->
-<xsl:template match="processing-instruction('dbfunclist')"/>
-
-<!-- * ***************************************************************** -->
-<!-- *           Note about boldface in funcprototype output -->
-<!-- * ***************************************************************** -->
-<!-- * All funcprototype content is by default rendered in bold, -->
-<!-- * because the old man(7) man page, now man-pages(7) says this: -->
-<!-- * -->
-<!-- *   For functions, the arguments are always specified using -->
-<!-- *   italics, even in the SYNOPSIS section, where the rest of -->
-<!-- *   the function is specified in bold -->
-<!-- * -->
-<!-- * Look through the contents of the man/man2 and man3 directories -->
-<!-- * on your system, and you'll see that most existing pages do follow -->
-<!-- * this "bold everything in function synopsis" rule. -->
-<!-- * -->
-<!-- * Users who don't want the bold output can choose to adjust the -->
-<!-- * man.font.funcprototype parameter on their own. So even if you -->
-<!-- * don't personally like the way it looks, please don't change the -->
-<!-- * default to be non-bold - because it's a convention that's -->
-<!-- * followed is the vast majority of existing man pages that document -->
-<!-- * functions, and we need to follow it by default, like it or no. -->
-<!-- * ***************************************************************** -->
-
-<xsl:template match="d:funcprototype">
-  <xsl:variable name="man-funcprototype-style">
-    <xsl:call-template name="pi.dbman_funcsynopsis-style">
-      <xsl:with-param name="node" select="ancestor::d:funcsynopsis/descendant-or-self::*"/>
-    </xsl:call-template>
-  </xsl:variable>
-  <xsl:variable name="style">
-    <xsl:choose>
-      <xsl:when test="not($man-funcprototype-style = '')">
-        <xsl:value-of select="$man-funcprototype-style"/>
-      </xsl:when>
-      <xsl:otherwise>
-        <xsl:value-of select="$man.funcsynopsis.style"/>
-      </xsl:otherwise>
-    </xsl:choose>
-  </xsl:variable>
-  <xsl:variable name="funcprototype.string.value">
-    <xsl:value-of select="d:funcdef"/>
-  </xsl:variable>
-  <xsl:variable name="funcprototype">
-    <xsl:apply-templates select="d:funcdef"/>
-  </xsl:variable>
-  <xsl:call-template name="synopsis-block-start"/>
-  <xsl:text>.HP </xsl:text>
-  <xsl:text>\w'</xsl:text>
-  <xsl:variable name="funcdef">
-    <xsl:apply-templates select="d:funcdef"/>
-  </xsl:variable>
-  <xsl:call-template name="string.subst">
-    <xsl:with-param name="string" select="normalize-space($funcdef)"/>
-    <xsl:with-param name="target" select="' '"/>
-    <xsl:with-param name="replacement" select="'\ '"/>
-  </xsl:call-template>
-  <xsl:text>('u</xsl:text>
-  <xsl:text>&#10;</xsl:text>
-  <xsl:text>.</xsl:text>
-  <xsl:value-of select="$man.font.funcprototype"/>
-  <xsl:text> </xsl:text>
-  <!-- * The following quotation mark (and the one further below) are -->
-  <!-- * needed to properly delimit the parts of the Funcprototype that -->
-  <!-- * should be rendered in the prevailing font (either Bold or Roman) -->
-  <!-- * from Parameter output that needs to be alternately rendered in -->
-  <!-- * italic. -->
-  <xsl:text>"</xsl:text>
-  <xsl:value-of select="normalize-space($funcprototype)"/>
-  <xsl:text>(</xsl:text>
-  <xsl:choose>
-    <xsl:when test="not($style = 'ansi')">
-      <xsl:apply-templates select="*[local-name() != 'funcdef']" mode="kr"/>
-    </xsl:when>
-    <xsl:otherwise>
-      <xsl:apply-templates select="*[local-name() != 'funcdef']" mode="ansi"/>
-    </xsl:otherwise>
-  </xsl:choose>
-  <xsl:text>"</xsl:text>
-  <xsl:text>&#10;</xsl:text>
-  <xsl:if test="d:paramdef and not($style = 'ansi')">
-    <!-- * if we have any paramdef instances in this funcprototype and -->
-    <!-- * the user has chosen K&R style output (by specifying some style -->
-    <!-- * value other than the default 'ansi'), then we need to generate -->
-    <!-- * the separate list of param definitions for this funcprototype -->
-    <!-- * -->
-    <!-- * we put a blank line after the prototype and before the list, -->
-    <!-- * and we indent the list by whatever width $list-indent is set -->
-    <!-- * to (4 spaces by default) -->
-    <xsl:text>.sp&#10;</xsl:text>
-    <xsl:text>.RS</xsl:text> 
-    <xsl:if test="not($list-indent = '')">
-      <xsl:text> </xsl:text>
-      <xsl:value-of select="$list-indent"/>
-    </xsl:if>
-    <xsl:text>&#10;</xsl:text>
-    <xsl:apply-templates select="d:paramdef" mode="kr-paramdef-list"/>
-    <xsl:text>.RE&#10;</xsl:text>
-  </xsl:if>
-  <xsl:call-template name="synopsis-block-end"/>
-</xsl:template>
-
-<xsl:template match="d:funcdef">
-  <xsl:apply-templates mode="prevent.line.breaking"/>
-</xsl:template>
-
-<xsl:template match="d:funcdef/d:function">
-  <xsl:apply-templates/>
-</xsl:template>
-
-<xsl:template match="d:void" mode="kr">
-  <xsl:text>);</xsl:text>
-</xsl:template>
-
-<xsl:template match="d:varargs" mode="kr">
-  <xsl:text>...);</xsl:text>
-</xsl:template>
-
-<xsl:template match="d:void" mode="ansi">
-  <xsl:text>void);</xsl:text>
-</xsl:template>
-
-<xsl:template match="d:varargs" mode="ansi">
-  <xsl:text>...);</xsl:text>
-</xsl:template>
-
-<xsl:template match="d:paramdef" mode="kr">
-  <!-- * in K&R-style output, the prototype just contains the parameter -->
-  <!-- * names - because the parameter definitions for each parameter -->
-  <!-- * (including the type information) are displayed in a separate -->
-  <!-- * list following the prototype; so in this mode (which is for the -->
-  <!-- * prototype, not the separate list), we first just want to grab -->
-  <!-- * the parameter for each paramdef -->
-  <xsl:variable name="contents">
-    <xsl:apply-templates select="d:parameter"/>
-  </xsl:variable>
-  <xsl:apply-templates mode="prevent.line.breaking" select="exsl:node-set($contents)"/>
-  <xsl:choose>
-    <xsl:when test="following-sibling::*">
-      <xsl:text>, </xsl:text>
-    </xsl:when>
-    <xsl:otherwise>
-      <xsl:text>);</xsl:text>
-    </xsl:otherwise>
-  </xsl:choose>
-</xsl:template>
-
-<xsl:template match="d:paramdef" mode="ansi">
-  <!-- * in ANSI-style output, the prototype contains the complete -->
-  <!-- * parameter definitions for each parameter (there is no separate -->
-  <!-- * list of parameter definitions like the one for K&R style -->
-  <xsl:apply-templates mode="prevent.line.breaking" select="."/>
-  <xsl:choose>
-    <xsl:when test="following-sibling::*">
-      <xsl:text>, </xsl:text>
-    </xsl:when>
-    <xsl:otherwise>
-      <xsl:text>);</xsl:text>
-    </xsl:otherwise>
-  </xsl:choose>
-</xsl:template>
-
-<xsl:template match="d:paramdef" mode="kr-paramdef-list">
-  <!-- * this mode is for generating the separate list of parameter -->
-  <!-- * definitions in K&R-style output -->
-  <xsl:text>.br&#10;</xsl:text>
-  <xsl:text>.</xsl:text>
-  <xsl:value-of select="$man.font.funcprototype"/>
-  <xsl:text> </xsl:text>
-  <!-- * The following quotation mark (and the one further below) are -->
-  <!-- * needed to properly delimit the parts of the Funcprototype that -->
-  <!-- * should be rendered in the prevailing font (either Bold or Roman) -->
-  <!-- * from Parameter output that needs to be alternately rendered in -->
-  <!-- * italic. -->
-  <xsl:text>"</xsl:text>
-  <xsl:variable name="contents">
-    <xsl:apply-templates/>
-  </xsl:variable>
-  <xsl:value-of select="normalize-space($contents)"/>
-  <xsl:text>;</xsl:text>
-  <xsl:text>"</xsl:text>
-  <xsl:text>&#10;</xsl:text>
-</xsl:template>
-
-<xsl:template match="d:paramdef/d:parameter">
-  <!-- * We use U+2591 here in place of a normal space, because if we -->
-  <!-- * were to just use a normal space, it would get replaced with a -->
-  <!-- * non-breaking space when we run the whole Paramdef through the -->
-  <!-- * prevent.line.breaking template. And as far as why we're -->
-  <!-- * inserting the space and quotation marks around each Parameter -->
-  <!-- * to begin with, the reason is that we need to because we are -->
-  <!-- * outputting Funcsynopsis in either the "BI" or "RI" font, and -->
-  <!-- * the space and quotation marks delimit the text as the -->
-  <!-- * "alternate" or "I" text that needs to be rendered in italic. -->
-  <xsl:text>"&#x2591;"</xsl:text>
-  <xsl:apply-templates/>
-  <xsl:text>"&#x2591;"</xsl:text>
-</xsl:template>
-
-<xsl:template match="d:funcparams">
-  <xsl:text>(</xsl:text>
-  <xsl:apply-templates/>
-  <xsl:text>)</xsl:text>
-</xsl:template>
-
-</xsl:stylesheet>