aboutsummaryrefslogtreecommitdiffstats
path: root/stylesheets/lfs-xsl/docbook-xsl-snapshot/fo/pi.xsl
diff options
context:
space:
mode:
Diffstat (limited to 'stylesheets/lfs-xsl/docbook-xsl-snapshot/fo/pi.xsl')
-rw-r--r--stylesheets/lfs-xsl/docbook-xsl-snapshot/fo/pi.xsl1084
1 files changed, 616 insertions, 468 deletions
diff --git a/stylesheets/lfs-xsl/docbook-xsl-snapshot/fo/pi.xsl b/stylesheets/lfs-xsl/docbook-xsl-snapshot/fo/pi.xsl
index 5f0a2c264..e03e989e2 100644
--- a/stylesheets/lfs-xsl/docbook-xsl-snapshot/fo/pi.xsl
+++ b/stylesheets/lfs-xsl/docbook-xsl-snapshot/fo/pi.xsl
@@ -1,9 +1,11 @@
<?xml version='1.0'?>
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
- xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
- xmlns:fo="http://www.w3.org/1999/XSL/Format"
- exclude-result-prefixes="doc"
- version='1.0'>
+<xsl:stylesheet
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
+ xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ exclude-result-prefixes="doc"
+ version='1.0'>
<!-- ********************************************************************
$Id$
@@ -15,63 +17,57 @@
******************************************************************** -->
-<doc:reference xmlns="">
-<referenceinfo>
-<releaseinfo role="meta">
-$Id$
-</releaseinfo>
-<authorgroup>
- <author>
- <orgname>The DocBook Project Development Team</orgname>
- </author>
-</authorgroup>
-<copyright>
- <year>2007</year>
- <holder>The DocBook Project</holder>
-</copyright>
-</referenceinfo>
-<title>FO Processing Instruction Reference</title>
-
-<partintro id="partintro">
-<title>Introduction</title>
-
-<para>This is generated reference documentation for all
- user-configurable processing instructions (PIs) in the DocBook
- XSL stylesheets for FO output.
- <note>
- <para>You add these PIs at particular points in a document to
- cause specific “exceptions” to formatting/output behavior. To
- make global changes in formatting/output behavior across an
- entire document, it’s better to do it by setting an
- appropriate stylesheet parameter (if there is one).</para>
- </note>
-</para>
-</partintro>
+<doc:reference xmlns=""><info><title>FO Processing Instruction Reference</title>
+ <releaseinfo role="meta">
+ $Id$
+ </releaseinfo>
+ </info>
+
+ <partintro id="partintro">
+ <title>Introduction</title>
+
+ <para>This is generated reference documentation for all
+ user-specifiable processing instructions (PIs) in the DocBook
+ XSL stylesheets for FO output.
+ <note>
+ <para>You add these PIs at particular points in a document to
+ cause specific “exceptions” to formatting/output behavior. To
+ make global changes in formatting/output behavior across an
+ entire document, it’s better to do it by setting an
+ appropriate stylesheet parameter (if there is one).</para>
+ </note>
+ </para>
+ </partintro>
</doc:reference>
<!-- ==================================================================== -->
<doc:pi name="dbfo_background-color" xmlns="">
-<refpurpose>Sets background color for an image</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo background-color</tag> PI before or
- after an image (<tag>graphic</tag>, <tag>inlinegraphic</tag>,
- <tag>imagedata</tag>, or <tag>videodata</tag> element) as a
- sibling to the element, to set a background color for the
- image.</para>
-</refdescription>
+ <refpurpose>Sets background color for an image</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo background-color</tag> PI before or
+ after an image (<tag>graphic</tag>, <tag>inlinegraphic</tag>,
+ <tag>imagedata</tag>, or <tag>videodata</tag> element) as a
+ sibling to the element, to set a background color for the
+ image.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo background-color="<replaceable>color</replaceable>"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>background-color="<replaceable>color</replaceable>"</term>
- <listitem>
- <para>FIXME: A color value? [In hex, as a name, or what?]</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>background-color="<replaceable>color</replaceable>"</term>
+ <listitem>
+ <para>An HTML color value</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="tcg">
+ <para><link role="tcg"
+ xlink:href="BGcolor.html"
+ >Background color</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_background-color">
<xsl:param name="node" select="."/>
@@ -82,23 +78,28 @@ $Id$
</xsl:template>
<doc:pi name="dbfo_bgcolor" xmlns="">
-<refpurpose>Sets background color on an table row or table cell</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo bgcolor</tag> PI as child of a table row
- or cell to set a background color for that table row or cell.</para>
-</refdescription>
+ <refpurpose>Sets background color on a table row or table cell</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo bgcolor</tag> PI as child of a table row
+ or cell to set a background color for that table row or cell.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo bgcolor="<replaceable>color</replaceable>"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>bgcolor="<replaceable>color</replaceable>"</term>
- <listitem>
- <para>FIXME: A color value? [In hex, as a name, or what?]</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>bgcolor="<replaceable>color</replaceable>"</term>
+ <listitem>
+ <para>An HTML color value</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="tcg">
+ <para><link role="tcg"
+ xlink:href="BGtableColor.html#CellBGColor"
+ >Cell background color</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_bgcolor">
<xsl:param name="node" select="."/>
@@ -109,25 +110,36 @@ $Id$
</xsl:template>
<doc:pi name="dbfo_float-type" xmlns="">
-<refpurpose>Specifies float behavior for a sidebar</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo float-type</tag> PI to specify the float
- behavior for a <tag>sidebar</tag> (to cause the sidebar to be
- displayed as a marginal note).</para>
-</refdescription>
+ <refpurpose>Specifies float behavior for a sidebar</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo float-type</tag> PI to specify the float
+ behavior for a <tag>sidebar</tag> (to cause the sidebar to be
+ displayed as a marginal note).</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo float-type="margin.note"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>float-type="margin.note"</term>
- <listitem>
- <para>Specifies that the <tag>sidebar</tag> should be
- displayed as a marginal note.</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>float-type="margin.note"</term>
+ <listitem>
+ <para>Specifies that the <tag>sidebar</tag> should be
+ displayed as a marginal note.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="params">
+ <para><parameter>sidebar.float.type parameter</parameter>,
+ <parameter>sidebar.float.width parameter</parameter>,
+ <parameter>sidebar.properties attribute-set</parameter>,
+ <parameter>sidebar.title.properties</parameter>
+ </para>
+ </refsee>
+ <refsee role="tcg">
+ <para><link xlink:href="SideFloats.html#SidebarFloats" >A sidebar as
+ side float</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_float-type">
<xsl:param name="node" select="."/>
@@ -138,28 +150,35 @@ $Id$
</xsl:template>
<doc:pi name="dbfo_glossary-presentation" xmlns="">
-<refpurpose>Specifies presentation style for a glossary</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo glossary-presentation</tag> PI as a child of
- a <tag>glossary</tag> to control its presentation style.</para>
-</refdescription>
+ <refpurpose>Specifies presentation style for a glossary</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo glossary-presentation</tag> PI as a child of
+ a <tag>glossary</tag> to control its presentation style.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo glossary-presentation="list"|"blocks"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>glossary-presentation="list"</term>
- <listitem>
- <para>Displayed the glossary as a list</para>
- </listitem>
- </varlistentry>
- <varlistentry><term>glossary-presentation="blocks"</term>
- <listitem>
- <para>Displays the glossary as blocks</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>glossary-presentation="list"</term>
+ <listitem>
+ <para>Displays the glossary as a list</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>glossary-presentation="blocks"</term>
+ <listitem>
+ <para>Displays the glossary as blocks</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="params">
+ <para><parameter>glossary.as.blocks</parameter></para>
+ </refsee>
+ <refsee role="tcg">
+ <para><link xlink:href="Glossaries.html#GlossaryFormatPrint" >Glossary
+ formatting in print</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_glossary-presentation">
<xsl:param name="node" select="."/>
@@ -170,28 +189,35 @@ $Id$
</xsl:template>
<doc:pi name="dbfo_glosslist-presentation" xmlns="">
-<refpurpose>Specifies presentation style for a glosslist</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo glosslist-presentation</tag> PI as a child of
- a <tag>glosslist</tag> to control its presentation style.</para>
-</refdescription>
+ <refpurpose>Specifies presentation style for a glosslist</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo glosslist-presentation</tag> PI as a child of
+ a <tag>glosslist</tag> to control its presentation style.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo glosslist-presentation="list"|"blocks"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>glosslist-presentation="list"</term>
- <listitem>
- <para>Displayed the glosslist as a list</para>
- </listitem>
- </varlistentry>
- <varlistentry><term>glosslist-presentation="blocks"</term>
- <listitem>
- <para>Displays the glosslist as blocks</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>glosslist-presentation="list"</term>
+ <listitem>
+ <para>Displays the glosslist as a list</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>glosslist-presentation="blocks"</term>
+ <listitem>
+ <para>Displays the glosslist as blocks</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="params">
+ <para><parameter>glosslist.as.blocks</parameter> </para>
+ </refsee>
+ <refsee role="tcg">
+ <para><link xlink:href="Glossaries.html#GlossaryFormatPrint" >Glossary
+ formatting in print</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_glosslist-presentation">
<xsl:param name="node" select="."/>
@@ -202,26 +228,35 @@ $Id$
</xsl:template>
<doc:pi name="dbfo_glossterm-width" xmlns="">
-<refpurpose>Specifies the glossterm width for a glossary or
- glosslist</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo glossterm-width</tag> PI as a child of a
- <tag>glossary</tag> or <tag>glosslist</tag> to specify the
- width for output of <tag>glossterm</tag> instances in the
- output.</para>
-</refdescription>
+ <refpurpose>Specifies the glossterm width for a glossary or
+ glosslist</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo glossterm-width</tag> PI as a child of a
+ <tag>glossary</tag> or <tag>glosslist</tag> to specify the
+ width for output of <tag>glossterm</tag> instances in the
+ output.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo glossterm-width="<replaceable>width</replaceable>"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>glossterm-width="<replaceable>width</replaceable>"</term>
- <listitem>
- <para>FIXME: Specifies the glossterm width (in what units?)</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>glossterm-width="<replaceable>width</replaceable>"</term>
+ <listitem>
+ <para>Specifies the glossterm width (including units)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="params">
+ <para><parameter>glossterm.width</parameter>,
+ <parameter>glossterm.separation</parameter>
+ </para>
+ </refsee>
+ <refsee role="tcg">
+ <para><link xlink:href="Glossaries.html#GlossaryFormatPrint" >Glossary
+ formatting in print</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_glossterm-width">
<xsl:param name="node" select="."/>
@@ -232,33 +267,40 @@ $Id$
</xsl:template>
<doc:pi name="dbfo_keep-together" xmlns="">
-<refpurpose>Specifies “keep” behavior for a table, example,
- figure, or equation</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo keep-together</tag> PI as a child of a
- formal object (<tag>table</tag>, <tag>example</tag>,
- <tag>figure</tag>, or <tag>equation</tag>) or their informal
- equivalents) to specify “keep” behavior for the object (to
- allow the object to “break” across a page).</para>
-</refdescription>
+ <refpurpose>Specifies “keep” behavior for a table, example,
+ figure, or equation</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo keep-together</tag> PI as a child of a
+ formal object (<tag>table</tag>, <tag>example</tag>,
+ <tag>figure</tag>, or <tag>equation</tag>) or their informal
+ equivalents) to specify “keep” behavior for the object (to
+ allow the object to “break” across a page).</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo keep-together="auto"|"always"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>keep-together="auto"</term>
- <listitem>
- <para>Enables the object to break across a page</para>
- </listitem>
- </varlistentry>
- <varlistentry><term>keep-together="always"</term>
- <listitem>
- <para>Prevents the object from breaking across a page (the
- default stylesheet behavior)</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>keep-together="auto"</term>
+ <listitem>
+ <para>Enables the object to break across a page</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>keep-together="always"</term>
+ <listitem>
+ <para>Prevents the object from breaking across a page (the
+ default stylesheet behavior)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="params">
+ <para>formal.object.properties</para>
+ </refsee>
+ <refsee role="tcg">
+ <para><link xlink:href="PageBreaking.html#KeepTogetherPI"
+ >Keep-together processing instruction</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_keep-together">
<xsl:param name="node" select="."/>
@@ -269,25 +311,28 @@ $Id$
</xsl:template>
<doc:pi name="dbfo_label-width" xmlns="">
-<refpurpose>Specifies the label width for an itemizedlist,
- orderedlist, or qandaset</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo label-width</tag> PI as a child of an
- <tag>itemizedlist</tag>, <tag>orderedlist</tag>, or
- <tag>qandaset</tag> to specify the width of labels.</para>
-</refdescription>
+ <refpurpose>Specifies the label width for a qandaset</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo label-width</tag> PI as a child of a
+ <tag>qandaset</tag> to specify the width of labels.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo label-width="<replaceable>width</replaceable>"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>label-width="<replaceable>width</replaceable>"</term>
- <listitem>
- <para>FIXME: Specifies the label width (in what units?)</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>label-width="<replaceable>width</replaceable>"</term>
+ <listitem>
+ <para>Specifies the label width (including units)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="tcg">
+ <para><link role="tcg"
+ xlink:href="QandAformat.html"
+ >Q and A formatting</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_label-width">
<xsl:param name="node" select="."/>
@@ -298,188 +343,221 @@ $Id$
</xsl:template>
<doc:pi name="dbfo_linenumbering.everyNth" xmlns="">
-<refpurpose>Specifies the interval at which lines are numbered
- output of verbatim environments</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo linenumbering.everyNth</tag> PI as a child
- of a “verbatim” element – <tag>programlisting</tag>,
- <tag>screen</tag>, <tag>synopsis</tag> — to specify
- the interval at which lines are numbered.</para>
-</refdescription>
+ <refpurpose>Specifies interval for lines numbers in verbatims</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo linenumbering.everyNth</tag> PI as a child
+ of a “verbatim” element – <tag>programlisting</tag>,
+ <tag>screen</tag>, <tag>synopsis</tag> — to specify
+ the interval at which lines are numbered.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo linenumbering.everyNth="<replaceable>N</replaceable>"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>linenumbering.everyNth="<replaceable>N</replaceable>"</term>
- <listitem>
- <para>FIXME: Specifies numbering interval; a number is
- output before every <replaceable>N</replaceable>th line</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>linenumbering.everyNth="<replaceable>N</replaceable>"</term>
+ <listitem>
+ <para>Specifies numbering interval; a number is output
+ before every <replaceable>N</replaceable>th line</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="params">
+ <para><parameter>linenumbering.everyNth</parameter></para>
+ </refsee>
+ <refsee role="tcg">
+ <para><link role="tcg"
+ xlink:href="AnnotateListing.html#LineNumbering"
+ >Line numbering</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_linenumbering.everyNth">
<xsl:param name="node" select="."/>
<xsl:call-template name="dbfo-attribute">
- <xsl:with-param name="pis"
- select="$node/processing-instruction('dbfo')"/>
+ <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
<xsl:with-param name="attribute" select="'linenumbering.everyNth'"/>
</xsl:call-template>
</xsl:template>
<doc:pi name="dbfo_linenumbering.separator" xmlns="">
-<refpurpose>Specifies the separator text used between line numbers
- and content in output of verbatim environments</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo linenumbering.separator</tag> PI as a child
- of a “verbatim” element – <tag>programlisting</tag>,
- <tag>screen</tag>, <tag>synopsis</tag> — to specify
- the separator text output between the line numbers and content.</para>
-</refdescription>
+ <refpurpose>Specifies separator text for line numbers in verbatims</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo linenumbering.separator</tag> PI as a child
+ of a “verbatim” element – <tag>programlisting</tag>,
+ <tag>screen</tag>, <tag>synopsis</tag> — to specify
+ the separator text output between the line numbers and content.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo linenumbering.separator="<replaceable>text</replaceable>"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>linenumbering.separator="<replaceable>text</replaceable>"</term>
- <listitem>
- <para>FIXME: Specifies the text (zero or more characters)</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>linenumbering.separator="<replaceable>text</replaceable>"</term>
+ <listitem>
+ <para>Specifies the text (zero or more characters)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="params">
+ <para><parameter>linenumbering.separator</parameter></para>
+ </refsee>
+ <refsee role="tcg">
+ <para><link role="tcg"
+ xlink:href="AnnotateListing.html#LineNumbering"
+ >Line numbering</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_linenumbering.separator">
<xsl:param name="node" select="."/>
<xsl:call-template name="dbfo-attribute">
- <xsl:with-param name="pis"
- select="$node/processing-instruction('dbfo')"/>
+ <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
<xsl:with-param name="attribute" select="'linenumbering.separator'"/>
</xsl:call-template>
</xsl:template>
<doc:pi name="dbfo_linenumbering.width" xmlns="">
-<refpurpose>Specifies the width set aside for line numbers in
- output of verbatim environments</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo linenumbering.width</tag> PI as a child
- of a “verbatim” element – <tag>programlisting</tag>,
- <tag>screen</tag>, <tag>synopsis</tag> — to specify
- the width set aside for line numbers.</para>
-</refdescription>
+ <refpurpose>Specifies width for line numbers in verbatims</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo linenumbering.width</tag> PI as a child
+ of a “verbatim” element – <tag>programlisting</tag>,
+ <tag>screen</tag>, <tag>synopsis</tag> — to specify
+ the width set aside for line numbers.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo linenumbering.width="<replaceable>width</replaceable>"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>linenumbering.width="<replaceable>width</replaceable>"</term>
- <listitem>
- <para>FIXME: Specifies the width (in what units?)</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>linenumbering.width="<replaceable>width</replaceable>"</term>
+ <listitem>
+ <para>Specifies the width (inluding units)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="params">
+ <para><parameter>linenumbering.width</parameter></para>
+ </refsee>
+ <refsee role="tcg">
+ <para><link role="tcg"
+ xlink:href="AnnotateListing.html#LineNumbering"
+ >Line numbering</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_linenumbering.width">
<xsl:param name="node" select="."/>
<xsl:call-template name="dbfo-attribute">
- <xsl:with-param name="pis"
- select="$node/processing-instruction('dbfo')"/>
+ <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
<xsl:with-param name="attribute" select="'linenumbering.width'"/>
</xsl:call-template>
</xsl:template>
-<doc:pi name="dbfo_list-width" xmlns="">
-<refpurpose>Specifies the width of a horizontal simplelist</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo list-width</tag> PI as a child of a
- <tag>simplelist</tag> whose <tag class="attribute">class</tag>
- value is <literal>horizontal</literal>, to specify the width
- of the <tag>simplelist</tag>.</para>
-</refdescription>
+<doc:pi name="dbfo_list-presentation" xmlns="">
+ <refpurpose>Specifies presentation style for a variablelist or
+ segmentedlist</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo list-presentation</tag> PI as a child of
+ a <tag>variablelist</tag> or <tag>segmentedlist</tag> to
+ control the presentation style for the list (to cause it, for
+ example, to be displayed as a table).</para>
+ </refdescription>
<refsynopsisdiv>
- <synopsis><tag class="xmlpi">dbfo list-width="<replaceable>width</replaceable>"</tag></synopsis>
+ <synopsis><tag class="xmlpi">dbfo list-presentation="list"|"blocks"|"table"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>list-width="<replaceable>width</replaceable>"</term>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>list-presentation="list"</term>
+ <listitem>
+ <para>Displays the list as a list</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>list-presentation="blocks"</term>
+ <listitem>
+ <para>(<tag>variablelist</tag> only) Displays the list as blocks</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>list-presentation="table"</term>
+ <listitem>
+ <para>(<tag>segmentedlist</tag> only) Displays the list as a table</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="params">
+ <itemizedlist>
+ <listitem>
+ <para><parameter>variablelist.as.blocks</parameter></para>
+ </listitem>
<listitem>
- <para>FIXME: Specifies the <tag>simplelist</tag> width (in what units?)</para>
+ <para><parameter>variablelist.as.table</parameter></para>
</listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ </itemizedlist>
+ </refsee>
+ <refsee role="tcg">
+ <para><link role="tcg"
+ xlink:href="Variablelists.html#ListIndents"
+ >Variable list formatting in print</link></para>
+ </refsee>
</doc:pi>
-<xsl:template name="pi.dbfo_list-width">
+<xsl:template name="pi.dbfo_list-presentation">
<xsl:param name="node" select="."/>
<xsl:call-template name="dbfo-attribute">
<xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
- <xsl:with-param name="attribute" select="'list-width'"/>
+ <xsl:with-param name="attribute" select="'list-presentation'"/>
</xsl:call-template>
</xsl:template>
-<doc:pi name="dbfo_list-presentation" xmlns="">
-<refpurpose>Specifies presentation style for a variablelist or
- segmentedlist</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo list-presentation</tag> PI as a child of
- a <tag>variablelist</tag> or <tag>segmentedlist</tag> to
- control the presentation style for the list (to cause it, for
- example, to be displayed as a table).</para>
-</refdescription>
+<doc:pi name="dbfo_list-width" xmlns="">
+ <refpurpose>Specifies the width of a horizontal simplelist</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo list-width</tag> PI as a child of a
+ <tag>simplelist</tag> whose <tag class="attribute">class</tag>
+ value is <literal>horizontal</literal>, to specify the width
+ of the <tag>simplelist</tag>.</para>
+ </refdescription>
<refsynopsisdiv>
- <synopsis><tag class="xmlpi">dbfo list-presentation="list"|"blocks"|"table"</tag></synopsis>
+ <synopsis><tag class="xmlpi">dbfo list-width="<replaceable>width</replaceable>"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>list-presentation="list"</term>
- <listitem>
- <para>Displayed the list as a list</para>
- </listitem>
- </varlistentry>
- <varlistentry><term>list-presentation="blocks"</term>
- <listitem>
- <para>(<tag>variablelist</tag> only) Displays the list as blocks</para>
- </listitem>
- </varlistentry>
- <varlistentry><term>list-presentation="table"</term>
- <listitem>
- <para>(<tag>segmentedlist</tag> only) Displays the list as a table</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>list-width="<replaceable>width</replaceable>"</term>
+ <listitem>
+ <para>Specifies the <tag>simplelist</tag> width (including units)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
</doc:pi>
-<xsl:template name="pi.dbfo_list-presentation">
+<xsl:template name="pi.dbfo_list-width">
<xsl:param name="node" select="."/>
<xsl:call-template name="dbfo-attribute">
<xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
- <xsl:with-param name="attribute" select="'list-presentation'"/>
+ <xsl:with-param name="attribute" select="'list-width'"/>
</xsl:call-template>
</xsl:template>
<doc:pi name="dbfo_orientation" xmlns="">
-<refpurpose>Specifies the orientation for table row or cell</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo orientation</tag> PI as a child of an
- <tag>table</tag> row or cell to specify the orientation
- (rotation) for the row or cell.</para>
-</refdescription>
+ <refpurpose>Specifies the orientation for table row or cell</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo orientation</tag> PI as a child of an
+ <tag>table</tag> row or cell to specify the orientation
+ (rotation) for the row or cell.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo orientation="0"|"90"|"180"|"270"|"-90"|"-180"|"-270"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>orientation="0"|"90"|"180"|"270"|"-90"|"-180"|"-270"</term>
- <listitem>
- <para>Specifies the number of degrees by which the cell or
- row is rotated</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>orientation="0"|"90"|"180"|"270"|"-90"|"-180"|"-270"</term>
+ <listitem>
+ <para>Specifies the number of degrees by which the cell or
+ row is rotated</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
</doc:pi>
<xsl:template name="pi.dbfo_orientation">
<xsl:param name="node" select="."/>
@@ -490,33 +568,34 @@ $Id$
</xsl:template>
<doc:pi name="dbfo_pgwide" xmlns="">
- <refpurpose>Species whether an <tag>equation</tag> or
- <tag>example</tag> should rendered across the full width of a
- page</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo pgwide</tag> PI as a child of an
- <tag>equation</tag> or <tag>example</tag> to specify that the
- content should rendered across the full width of the page.</para>
-</refdescription>
+ <refpurpose>Specifies if an <tag>equation</tag> or <tag>example</tag> goes across full page width</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo pgwide</tag> PI as a child of an
+ <tag>equation</tag> or <tag>example</tag> to specify that the
+ content should rendered across the full width of the page.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo pgwide="0"|"1"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>pgwide="0"</term>
- <listitem>
- <para>If zero, the content is rendered across the current
- text flow</para>
- </listitem>
- </varlistentry>
- <varlistentry><term>pgwide="1"</term>
- <listitem>
- <para>If <code>1</code> (or any non-zero value), the
- content is rendered across the full width of the page</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>pgwide="0"</term>
+ <listitem>
+ <para>If zero, the content is rendered across the current
+ text flow</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>pgwide="1"</term>
+ <listitem>
+ <para>If <code>1</code> (or any non-zero value), the
+ content is rendered across the full width of the page</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="params">
+ <para><parameter>pgwide.properties</parameter></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_pgwide">
<xsl:param name="node" select="."/>
@@ -529,53 +608,63 @@ $Id$
<doc:pi name="dbfo_rotated-width" xmlns="">
<refpurpose>Specifies the width for a table <tag>entry</tag> or
<tag>row</tag></refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo rotated-width</tag> PI as a child of an
- <tag>entry</tag> or <tag>row</tag> instance to specify the
- width of that the <tag>entry</tag> or <tag>row</tag>; or
- use it higher up in table to cause the width to be inherited
- recursively down.</para>
-</refdescription>
+ <refdescription>
+ <para>Use the <tag>dbfo rotated-width</tag> PI as a child of an
+ <tag>entry</tag> or <tag>row</tag> instance to specify the
+ width of that the <tag>entry</tag> or <tag>row</tag>; or
+ use it higher up in table to cause the width to be inherited
+ recursively down.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo rotated-width="<replaceable>width</replaceable>"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>rotated-width="<replaceable>width</replaceable>"</term>
- <listitem>
- <para>FIXME: Specifies the width of a row or cell (in what units?)</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>rotated-width="<replaceable>width</replaceable>"</term>
+ <listitem>
+ <para>Specifies the width of a row or cell (including units)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
</doc:pi>
<xsl:template name="pi.dbfo_rotated-width">
<xsl:param name="node" select="."/>
<xsl:call-template name="dbfo-attribute">
- <xsl:with-param name="pis"
- select="$node/processing-instruction('dbfo')"/>
+ <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
<xsl:with-param name="attribute" select="'rotated-width'"/>
</xsl:call-template>
</xsl:template>
<doc:pi name="dbfo_sidebar-width" xmlns="">
-<refpurpose>Specifies the width of a sidebar</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo sidebar-width</tag> PI as a child of a
- <tag>sidebar</tag> to specify the width of the sidebar.</para>
-</refdescription>
+ <refpurpose>Specifies the width of a sidebar</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo sidebar-width</tag> PI as a child of a
+ <tag>sidebar</tag> to specify the width of the sidebar.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo sidebar-width="<replaceable>width</replaceable>"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>sidebar-width="<replaceable>width</replaceable>"</term>
- <listitem>
- <para>FIXME: Specifies the <tag>sidebar</tag> width (in what units?)</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>sidebar-width="<replaceable>width</replaceable>"</term>
+ <listitem>
+ <para>Specifies the <tag>sidebar</tag> width (including units)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="params">
+ <para><parameter>sidebar.float.type parameter</parameter>,
+ <parameter>sidebar.float.width parameter</parameter>,
+ <parameter>sidebar.properties attribute-set</parameter>,
+ <parameter>sidebar.title.properties</parameter>
+ </para>
+ </refsee>
+ <refsee role="tcg">
+ <para><link xlink:href="SideFloats.html#SidebarFloats" >A sidebar as
+ side float</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_sidebar-width">
<xsl:param name="node" select="."/>
@@ -585,27 +674,71 @@ $Id$
</xsl:call-template>
</xsl:template>
+<doc:pi name="dbfo_start" xmlns="">
+ <refpurpose>(obsolete) Sets the starting number on an ordered list</refpurpose>
+ <refdescription>
+ <para><emphasis>This PI is obsolete</emphasis>. The intent of
+ it was to provide a means for setting a specific starting
+ number for an ordered list. Instead of this PI, set a value
+ for the <literal>override</literal> attribute on the first
+ <tag>listitem</tag> in the list; that will have the same
+ effect as what this PI was intended for.</para>
+ </refdescription>
+ <refsynopsisdiv>
+ <synopsis><tag class="xmlpi">dbfo start="<replaceable>character</replaceable>"</tag></synopsis>
+ </refsynopsisdiv>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>start="<replaceable>character</replaceable>"</term>
+ <listitem>
+ <para>Specifies the character to use as the starting
+ number; use 0-9, a-z, A-Z, or lowercase or uppercase
+ Roman numerals</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="tcg">
+ <para><link role="tcg"
+ xlink:href="Orderedlists.html#ListStartNum"
+ >List starting number</link></para>
+ </refsee>
+</doc:pi>
+<xsl:template name="pi.dbfo_start">
+ <xsl:param name="node" select="."/>
+ <xsl:call-template name="pi-attribute">
+ <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
+ <xsl:with-param name="attribute" select="'start'"/>
+ </xsl:call-template>
+</xsl:template>
+
<doc:pi name="dbfo_table-width" xmlns="">
-<refpurpose>Specifies the width for a table or for revhistory
- output</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo table-width</tag> PI as a child of a
- <tag>table</tag> or <tag>revhistory</tag> instance (which is
- rendered as a table in output) to specify the width of the
- table in output.</para>
-</refdescription>
+ <refpurpose>Specifies the width for a table or for revhistory
+ output</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo table-width</tag> PI as a child or
+ sibling of a <tag>table</tag>, or as a child of an
+ <tag>informaltable</tag>, <tag>entrybl</tag>, or
+ <tag>revhistory</tag> instance (which is rendered as a table
+ in output) to specify the width of the table in output.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo table-width="<replaceable>width</replaceable>"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>table-width="<replaceable>width</replaceable>"</term>
- <listitem>
- <para>FIXME: Specifies the table width (in what units?)</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>table-width="<replaceable>width</replaceable>"</term>
+ <listitem>
+ <para>Specifies the table width (including units or as a percentage)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="tcg">
+ <para><link role="tcg"
+ xlink:href="Tables.html#TableWidth"
+ >Table width</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_table-width">
<xsl:param name="node" select="."/>
@@ -616,24 +749,29 @@ $Id$
</xsl:template>
<doc:pi name="dbfo_term-width" xmlns="">
-<refpurpose>Specifies the term width for a variablelist</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo term-width</tag> PI as a child of a
- <tag>variablelist</tag> to specify the width for
- <tag>term</tag> output.</para>
-</refdescription>
+ <refpurpose>Specifies the term width for a variablelist</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo term-width</tag> PI as a child of a
+ <tag>variablelist</tag> to specify the width for
+ <tag>term</tag> output.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo term-width="<replaceable>width</replaceable>"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>term-width="<replaceable>width</replaceable>"</term>
- <listitem>
- <para>FIXME: Specifies the term width (in what units?)</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>term-width="<replaceable>width</replaceable>"</term>
+ <listitem>
+ <para>Specifies the term width (including units)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="tcg">
+ <para><link role="tcg"
+ xlink:href="Variablelists.html#ListIndents"
+ >Variable list formatting in print</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_term-width">
<xsl:param name="node" select="."/>
@@ -644,30 +782,38 @@ $Id$
</xsl:template>
<doc:pi name="dbfo_toc" xmlns="">
-<refpurpose>Species whether a TOC should be generated for a qandaset</refpurpose>
-<refdescription>
- <para>Use the <tag>dbfo toc</tag> PI as a child of a
- <tag>jandaset</tag> to specify whether a table of contents
- (TOC) is generated for the <tag>qandaset</tag>.</para>
-</refdescription>
+ <refpurpose>Species whether a TOC should be generated for a qandaset</refpurpose>
+ <refdescription>
+ <para>Use the <tag>dbfo toc</tag> PI as a child of a
+ <tag>qandaset</tag> to specify whether a table of contents
+ (TOC) is generated for the <tag>qandaset</tag>.</para>
+ </refdescription>
<refsynopsisdiv>
<synopsis><tag class="xmlpi">dbfo toc="0"|"1"</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>toc="0"</term>
- <listitem>
- <para>If zero, no TOC is generated</para>
- </listitem>
- </varlistentry>
- <varlistentry><term>toc="1"</term>
- <listitem>
- <para>If <code>1</code> (or any non-zero value),
- a TOC is generated</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>toc="0"</term>
+ <listitem>
+ <para>If zero, no TOC is generated</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>toc="1"</term>
+ <listitem>
+ <para>If <code>1</code> (or any non-zero value),
+ a TOC is generated</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="tcg">
+ <para><link role="tcg"
+ xlink:href="QandAtoc.html"
+ >Q and A list of questions</link>,
+ <link role="tcg"
+ xlink:href="QandAformat.html"
+ >Q and A formatting</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo_toc">
<xsl:param name="node" select="."/>
@@ -677,36 +823,37 @@ $Id$
</xsl:call-template>
</xsl:template>
-<!-- ==================================================================== -->
-
<doc:pi name="dbfo-need" xmlns="">
-<refpurpose>Specify a need for space (a kind of soft page break)</refpurpose>
-<refdescription>
- <para>A “need” is a request for space on a page. If the
- requested space is not available, the page breaks and the
- content that follows the need request appears on the next
- page. If the requested space is available, then the request is
- ignored.</para>
-</refdescription>
+ <refpurpose>Specify a need for space (a kind of soft page break)</refpurpose>
+ <refdescription>
+ <para>A “need” is a request for space on a page. If the
+ requested space is not available, the page breaks and the
+ content that follows the need request appears on the next
+ page. If the requested space is available, then no page break
+ is inserted.</para>
+ </refdescription>
<refsynopsisdiv>
- <synopsis><tag class="xmlpi">dbfo-need height="<replaceable>n</replaceable>"</tag></synopsis>
- <synopsis><tag class="xmlpi">dbfo-need space-before="<replaceable>n</replaceable>"</tag></synopsis>
+ <synopsis><tag class="xmlpi">dbfo-need height="<replaceable>n</replaceable>" [space-before="<replaceable>n</replaceable>"]</tag></synopsis>
</refsynopsisdiv>
-<refparameter>
- <variablelist>
- <varlistentry><term>height="<replaceable>n</replaceable>"</term>
- <listitem>
- <para>FIXME: the amount of height(?) needed? In what units? pt?.</para>
- </listitem>
- </varlistentry>
- <varlistentry><term>space-before"<replaceable>n</replaceable>"</term>
- <listitem>
- <para>FIXME: the amount of space needed before the
- [something]? In what units? pt?.</para>
- </listitem>
- </varlistentry>
- </variablelist>
-</refparameter>
+ <refparameter>
+ <variablelist>
+ <varlistentry><term>height="<replaceable>n</replaceable>"</term>
+ <listitem>
+ <para>The amount of height needed (including units)</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term>space-before"<replaceable>n</replaceable>"</term>
+ <listitem>
+ <para>The amount of extra vertical space to add (including units)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refparameter>
+ <refsee role="tcg">
+ <para><link role="tcg"
+ xlink:href="PageBreaking.html#SoftPageBreaks"
+ >Soft page breaks</link></para>
+ </refsee>
</doc:pi>
<xsl:template name="pi.dbfo-need">
<xsl:variable name="pi-height">
@@ -743,49 +890,49 @@ $Id$
<!-- Doesn't work in fop -->
</xsl:when>
<xsl:when test="$pi-before != '' and
- not(following-sibling::listitem) and
- not(following-sibling::step)">
+ not(following-sibling::listitem) and
+ not(following-sibling::step)">
<fo:block space-after="0pt" space-before="{$pi-before}">
<xsl:copy-of select="$spacer"/>
</fo:block>
</xsl:when>
<xsl:when test="following-sibling::para">
<fo:block space-after="0pt"
- xsl:use-attribute-sets="normal.para.spacing">
+ xsl:use-attribute-sets="normal.para.spacing">
<xsl:copy-of select="$spacer"/>
</fo:block>
</xsl:when>
<xsl:when test="following-sibling::table or
- following-sibling::figure or
- following-sibling::example or
- following-sibling::equation">
+ following-sibling::figure or
+ following-sibling::example or
+ following-sibling::equation">
<fo:block space-after="0pt"
- xsl:use-attribute-sets="formal.object.properties">
+ xsl:use-attribute-sets="formal.object.properties">
<xsl:copy-of select="$spacer"/>
</fo:block>
</xsl:when>
<xsl:when test="following-sibling::informaltable or
- following-sibling::informalfigure or
- following-sibling::informalexample or
- following-sibling::informalequation">
+ following-sibling::informalfigure or
+ following-sibling::informalexample or
+ following-sibling::informalequation">
<fo:block space-after="0pt"
- xsl:use-attribute-sets="informal.object.properties">
+ xsl:use-attribute-sets="informal.object.properties">
<xsl:copy-of select="$spacer"/>
</fo:block>
</xsl:when>
<xsl:when test="following-sibling::itemizedlist or
- following-sibling::orderedlist or
- following-sibling::variablelist or
- following-sibling::simplelist">
+ following-sibling::orderedlist or
+ following-sibling::variablelist or
+ following-sibling::simplelist">
<fo:block space-after="0pt"
- xsl:use-attribute-sets="informal.object.properties">
+ xsl:use-attribute-sets="informal.object.properties">
<xsl:copy-of select="$spacer"/>
</fo:block>
</xsl:when>
<xsl:when test="following-sibling::listitem or
- following-sibling::step">
+ following-sibling::step">
<fo:list-item space-after="0pt"
- xsl:use-attribute-sets="informal.object.properties">
+ xsl:use-attribute-sets="informal.object.properties">
<fo:list-item-label/>
<fo:list-item-body start-indent="0pt" end-indent="0pt">
<xsl:copy-of select="$spacer"/>
@@ -793,13 +940,13 @@ $Id$
</fo:list-item>
</xsl:when>
<xsl:when test="following-sibling::sect1 or
- following-sibling::sect2 or
- following-sibling::sect3 or
- following-sibling::sect4 or
- following-sibling::sect5 or
- following-sibling::section">
+ following-sibling::sect2 or
+ following-sibling::sect3 or
+ following-sibling::sect4 or
+ following-sibling::sect5 or
+ following-sibling::section">
<fo:block space-after="0pt"
- xsl:use-attribute-sets="section.title.properties">
+ xsl:use-attribute-sets="section.title.properties">
<xsl:copy-of select="$spacer"/>
</fo:block>
</xsl:when>
@@ -815,20 +962,20 @@ $Id$
<!-- Doesn't work in fop -->
</xsl:when>
<xsl:when test="following-sibling::listitem or
- following-sibling::step">
+ following-sibling::step">
<fo:list-item space-before.precedence="force"
- space-before="-{$height}"
- space-after="0pt"
- space-after.precedence="force">
+ space-before="-{$height}"
+ space-after="0pt"
+ space-after.precedence="force">
<fo:list-item-label/>
<fo:list-item-body start-indent="0pt" end-indent="0pt"/>
</fo:list-item>
</xsl:when>
<xsl:otherwise>
<fo:block space-before.precedence="force"
- space-before="-{$height}"
- space-after="0pt"
- space-after.precedence="force">
+ space-before="-{$height}"
+ space-after="0pt"
+ space-after.precedence="force">
</fo:block>
</xsl:otherwise>
</xsl:choose>
@@ -848,6 +995,7 @@ $Id$
</xsl:template>
<!-- ==================================================================== -->
+
<xsl:template match="processing-instruction()">
</xsl:template>