Ignore:
Timestamp:
Jul 21, 2007, 8:07:11 AM (17 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
master
Children:
a6966fa
Parents:
3ca2208
Message:

Merged r8226 from new-xsl branch.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • BOOK/stylesheets/lfs-xsl/docbook-xsl-snapshot/fo/pi.xsl

    r3ca2208 r00b1e11  
    11<?xml version='1.0'?>
    2 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    3                 xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
    4                 xmlns:fo="http://www.w3.org/1999/XSL/Format"
    5                 exclude-result-prefixes="doc"
    6                 version='1.0'>
     2<xsl:stylesheet
     3  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
     4  xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
     5  xmlns:fo="http://www.w3.org/1999/XSL/Format"
     6  xmlns:xlink="http://www.w3.org/1999/xlink"
     7  exclude-result-prefixes="doc"
     8  version='1.0'>
    79
    810<!-- ********************************************************************
    … …  
    1618     ******************************************************************** -->
    1719
    18 <doc:reference xmlns="">
    19 <referenceinfo>
    20 <releaseinfo role="meta">
    21 $Id$
    22 </releaseinfo>
    23 <authorgroup>
    24   <author>
    25     <orgname>The DocBook Project Development Team</orgname>
    26   </author>
    27 </authorgroup>
    28 <copyright>
    29   <year>2007</year>
    30   <holder>The DocBook Project</holder>
    31 </copyright>
    32 </referenceinfo>
    33 <title>FO Processing Instruction Reference</title>
    34 
    35 <partintro id="partintro">
    36 <title>Introduction</title>
    37 
    38 <para>This is generated reference documentation for all
    39   user-configurable processing instructions (PIs) in the DocBook
    40   XSL stylesheets for FO output.
    41   <note>
    42     <para>You add these PIs at particular points in a document to
    43       cause specific “exceptions” to formatting/output behavior. To
    44       make global changes in formatting/output behavior across an
    45       entire document, it’s better to do it by setting an
    46       appropriate stylesheet parameter (if there is one).</para>
    47   </note>
    48 </para>
    49 </partintro>
     20<doc:reference xmlns=""><info><title>FO Processing Instruction Reference</title>
     21    <releaseinfo role="meta">
     22      $Id$
     23    </releaseinfo>
     24  </info>
     25
     26  <partintro id="partintro">
     27    <title>Introduction</title>
     28
     29    <para>This is generated reference documentation for all
     30      user-specifiable processing instructions (PIs) in the DocBook
     31      XSL stylesheets for FO output.
     32      <note>
     33        <para>You add these PIs at particular points in a document to
     34          cause specific “exceptions” to formatting/output behavior. To
     35          make global changes in formatting/output behavior across an
     36          entire document, it’s better to do it by setting an
     37          appropriate stylesheet parameter (if there is one).</para>
     38      </note>
     39    </para>
     40  </partintro>
    5041</doc:reference>
    5142
    … …  
    5344
    5445<doc:pi name="dbfo_background-color" xmlns="">
    55 <refpurpose>Sets background color for an image</refpurpose>
    56 <refdescription>
    57   <para>Use the <tag>dbfo background-color</tag> PI before or
    58     after an image (<tag>graphic</tag>, <tag>inlinegraphic</tag>,
    59     <tag>imagedata</tag>, or <tag>videodata</tag> element) as a
    60     sibling to the element, to set a background color for the
    61     image.</para>
    62 </refdescription>
     46  <refpurpose>Sets background color for an image</refpurpose>
     47  <refdescription>
     48    <para>Use the <tag>dbfo background-color</tag> PI before or
     49      after an image (<tag>graphic</tag>, <tag>inlinegraphic</tag>,
     50      <tag>imagedata</tag>, or <tag>videodata</tag> element) as a
     51      sibling to the element, to set a background color for the
     52      image.</para>
     53  </refdescription>
    6354  <refsynopsisdiv>
    6455    <synopsis><tag class="xmlpi">dbfo background-color="<replaceable>color</replaceable>"</tag></synopsis>
    6556  </refsynopsisdiv>
    66 <refparameter>
    67   <variablelist>
    68     <varlistentry><term>background-color="<replaceable>color</replaceable>"</term>
     57  <refparameter>
     58    <variablelist>
     59      <varlistentry><term>background-color="<replaceable>color</replaceable>"</term>
     60        <listitem>
     61          <para>An HTML color value</para>
     62        </listitem>
     63      </varlistentry>
     64    </variablelist>
     65  </refparameter>
     66  <refsee role="tcg">
     67    <para><link role="tcg"
     68        xlink:href="BGcolor.html"
     69        >Background color</link></para>
     70  </refsee>
     71</doc:pi>
     72<xsl:template name="pi.dbfo_background-color">
     73  <xsl:param name="node" select="."/>
     74  <xsl:call-template name="dbfo-attribute">
     75    <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
     76    <xsl:with-param name="attribute" select="'background-color'"/>
     77  </xsl:call-template>
     78</xsl:template>
     79
     80<doc:pi name="dbfo_bgcolor" xmlns="">
     81  <refpurpose>Sets background color on a table row or table cell</refpurpose>
     82  <refdescription>
     83    <para>Use the <tag>dbfo bgcolor</tag> PI as child of a table row
     84      or cell to set a background color for that table row or cell.</para>
     85  </refdescription>
     86  <refsynopsisdiv>
     87    <synopsis><tag class="xmlpi">dbfo bgcolor="<replaceable>color</replaceable>"</tag></synopsis>
     88  </refsynopsisdiv>
     89  <refparameter>
     90    <variablelist>
     91      <varlistentry><term>bgcolor="<replaceable>color</replaceable>"</term>
     92        <listitem>
     93          <para>An HTML color value</para>
     94        </listitem>
     95      </varlistentry>
     96    </variablelist>
     97  </refparameter>
     98  <refsee role="tcg">
     99    <para><link role="tcg"
     100        xlink:href="BGtableColor.html#CellBGColor"
     101        >Cell background color</link></para>
     102  </refsee>
     103</doc:pi>
     104<xsl:template name="pi.dbfo_bgcolor">
     105  <xsl:param name="node" select="."/>
     106  <xsl:call-template name="dbfo-attribute">
     107    <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
     108    <xsl:with-param name="attribute" select="'bgcolor'"/>
     109  </xsl:call-template>
     110</xsl:template>
     111
     112<doc:pi name="dbfo_float-type" xmlns="">
     113  <refpurpose>Specifies float behavior for a sidebar</refpurpose>
     114  <refdescription>
     115    <para>Use the <tag>dbfo float-type</tag> PI to specify the float
     116      behavior for a <tag>sidebar</tag> (to cause the sidebar to be
     117      displayed as a marginal note).</para>
     118  </refdescription>
     119  <refsynopsisdiv>
     120    <synopsis><tag class="xmlpi">dbfo float-type="margin.note"</tag></synopsis>
     121  </refsynopsisdiv>
     122  <refparameter>
     123    <variablelist>
     124      <varlistentry><term>float-type="margin.note"</term>
     125        <listitem>
     126          <para>Specifies that the <tag>sidebar</tag> should be
     127            displayed as a marginal note.</para>
     128        </listitem>
     129      </varlistentry>
     130    </variablelist>
     131  </refparameter>
     132  <refsee role="params">
     133    <para><parameter>sidebar.float.type parameter</parameter>,
     134      <parameter>sidebar.float.width parameter</parameter>,
     135      <parameter>sidebar.properties attribute-set</parameter>,
     136      <parameter>sidebar.title.properties</parameter>
     137    </para>
     138  </refsee>
     139  <refsee role="tcg">
     140    <para><link xlink:href="SideFloats.html#SidebarFloats" >A sidebar as
     141        side float</link></para>
     142  </refsee>
     143</doc:pi>
     144<xsl:template name="pi.dbfo_float-type">
     145  <xsl:param name="node" select="."/>
     146  <xsl:call-template name="dbfo-attribute">
     147    <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
     148    <xsl:with-param name="attribute" select="'float-type'"/>
     149  </xsl:call-template>
     150</xsl:template>
     151
     152<doc:pi name="dbfo_glossary-presentation" xmlns="">
     153  <refpurpose>Specifies presentation style for a glossary</refpurpose>
     154  <refdescription>
     155    <para>Use the <tag>dbfo glossary-presentation</tag> PI as a child of
     156      a <tag>glossary</tag> to control its presentation style.</para>
     157  </refdescription>
     158  <refsynopsisdiv>
     159    <synopsis><tag class="xmlpi">dbfo glossary-presentation="list"|"blocks"</tag></synopsis>
     160  </refsynopsisdiv>
     161  <refparameter>
     162    <variablelist>
     163      <varlistentry><term>glossary-presentation="list"</term>
     164        <listitem>
     165          <para>Displays the glossary as a list</para>
     166        </listitem>
     167      </varlistentry>
     168      <varlistentry><term>glossary-presentation="blocks"</term>
     169        <listitem>
     170          <para>Displays the glossary as blocks</para>
     171        </listitem>
     172      </varlistentry>
     173    </variablelist>
     174  </refparameter>
     175  <refsee role="params">
     176    <para><parameter>glossary.as.blocks</parameter></para>
     177  </refsee>
     178  <refsee role="tcg">
     179    <para><link xlink:href="Glossaries.html#GlossaryFormatPrint" >Glossary
     180        formatting in print</link></para>
     181  </refsee>
     182</doc:pi>
     183<xsl:template name="pi.dbfo_glossary-presentation">
     184  <xsl:param name="node" select="."/>
     185  <xsl:call-template name="dbfo-attribute">
     186    <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
     187    <xsl:with-param name="attribute" select="'glossary-presentation'"/>
     188  </xsl:call-template>
     189</xsl:template>
     190
     191<doc:pi name="dbfo_glosslist-presentation" xmlns="">
     192  <refpurpose>Specifies presentation style for a glosslist</refpurpose>
     193  <refdescription>
     194    <para>Use the <tag>dbfo glosslist-presentation</tag> PI as a child of
     195      a <tag>glosslist</tag> to control its presentation style.</para>
     196  </refdescription>
     197  <refsynopsisdiv>
     198    <synopsis><tag class="xmlpi">dbfo glosslist-presentation="list"|"blocks"</tag></synopsis>
     199  </refsynopsisdiv>
     200  <refparameter>
     201    <variablelist>
     202      <varlistentry><term>glosslist-presentation="list"</term>
     203        <listitem>
     204          <para>Displays the glosslist as a list</para>
     205        </listitem>
     206      </varlistentry>
     207      <varlistentry><term>glosslist-presentation="blocks"</term>
     208        <listitem>
     209          <para>Displays the glosslist as blocks</para>
     210        </listitem>
     211      </varlistentry>
     212    </variablelist>
     213  </refparameter>
     214  <refsee role="params">
     215    <para><parameter>glosslist.as.blocks</parameter> </para>
     216  </refsee>
     217  <refsee role="tcg">
     218    <para><link xlink:href="Glossaries.html#GlossaryFormatPrint" >Glossary
     219        formatting in print</link></para>
     220  </refsee>
     221</doc:pi>
     222<xsl:template name="pi.dbfo_glosslist-presentation">
     223  <xsl:param name="node" select="."/>
     224  <xsl:call-template name="dbfo-attribute">
     225    <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
     226    <xsl:with-param name="attribute" select="'glosslist-presentation'"/>
     227  </xsl:call-template>
     228</xsl:template>
     229
     230<doc:pi name="dbfo_glossterm-width" xmlns="">
     231  <refpurpose>Specifies the glossterm width for a glossary or
     232    glosslist</refpurpose>
     233  <refdescription>
     234    <para>Use the <tag>dbfo glossterm-width</tag> PI as a child of a
     235      <tag>glossary</tag> or <tag>glosslist</tag> to specify the
     236      width for output of <tag>glossterm</tag> instances in the
     237      output.</para>
     238  </refdescription>
     239  <refsynopsisdiv>
     240    <synopsis><tag class="xmlpi">dbfo glossterm-width="<replaceable>width</replaceable>"</tag></synopsis>
     241  </refsynopsisdiv>
     242  <refparameter>
     243    <variablelist>
     244      <varlistentry><term>glossterm-width="<replaceable>width</replaceable>"</term>
     245        <listitem>
     246          <para>Specifies the glossterm width (including units)</para>
     247        </listitem>
     248      </varlistentry>
     249    </variablelist>
     250  </refparameter>
     251  <refsee role="params">
     252    <para><parameter>glossterm.width</parameter>,
     253      <parameter>glossterm.separation</parameter>
     254    </para>
     255  </refsee>
     256  <refsee role="tcg">
     257    <para><link xlink:href="Glossaries.html#GlossaryFormatPrint" >Glossary
     258        formatting in print</link></para>
     259  </refsee>
     260</doc:pi>
     261<xsl:template name="pi.dbfo_glossterm-width">
     262  <xsl:param name="node" select="."/>
     263  <xsl:call-template name="dbfo-attribute">
     264    <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
     265    <xsl:with-param name="attribute" select="'glossterm-width'"/>
     266  </xsl:call-template>
     267</xsl:template>
     268
     269<doc:pi name="dbfo_keep-together" xmlns="">
     270  <refpurpose>Specifies “keep” behavior for a table, example,
     271    figure, or equation</refpurpose>
     272  <refdescription>
     273    <para>Use the <tag>dbfo keep-together</tag> PI as a child of a
     274      formal object (<tag>table</tag>, <tag>example</tag>,
     275      <tag>figure</tag>, or <tag>equation</tag>) or their informal
     276      equivalents) to specify “keep” behavior for the object (to
     277      allow the object to “break” across a page).</para>
     278  </refdescription>
     279  <refsynopsisdiv>
     280    <synopsis><tag class="xmlpi">dbfo keep-together="auto"|"always"</tag></synopsis>
     281  </refsynopsisdiv>
     282  <refparameter>
     283    <variablelist>
     284      <varlistentry><term>keep-together="auto"</term>
     285        <listitem>
     286          <para>Enables the object to break across a page</para>
     287        </listitem>
     288      </varlistentry>
     289      <varlistentry><term>keep-together="always"</term>
     290        <listitem>
     291          <para>Prevents the object from breaking across a page (the
     292            default stylesheet behavior)</para>
     293        </listitem>
     294      </varlistentry>
     295    </variablelist>
     296  </refparameter>
     297  <refsee role="params">
     298    <para>formal.object.properties</para>
     299  </refsee>
     300  <refsee role="tcg">
     301    <para><link xlink:href="PageBreaking.html#KeepTogetherPI"
     302        >Keep-together processing instruction</link></para>
     303  </refsee>
     304</doc:pi>
     305<xsl:template name="pi.dbfo_keep-together">
     306  <xsl:param name="node" select="."/>
     307  <xsl:call-template name="dbfo-attribute">
     308    <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
     309    <xsl:with-param name="attribute" select="'keep-together'"/>
     310  </xsl:call-template>
     311</xsl:template>
     312
     313<doc:pi name="dbfo_label-width" xmlns="">
     314  <refpurpose>Specifies the label width for a qandaset</refpurpose>
     315  <refdescription>
     316    <para>Use the <tag>dbfo label-width</tag> PI as a child of a
     317      <tag>qandaset</tag> to specify the width of labels.</para>
     318  </refdescription>
     319  <refsynopsisdiv>
     320    <synopsis><tag class="xmlpi">dbfo label-width="<replaceable>width</replaceable>"</tag></synopsis>
     321  </refsynopsisdiv>
     322  <refparameter>
     323    <variablelist>
     324      <varlistentry><term>label-width="<replaceable>width</replaceable>"</term>
     325        <listitem>
     326          <para>Specifies the label width (including units)</para>
     327        </listitem>
     328      </varlistentry>
     329    </variablelist>
     330  </refparameter>
     331  <refsee role="tcg">
     332    <para><link role="tcg"
     333        xlink:href="QandAformat.html"
     334        >Q and A formatting</link></para>
     335  </refsee>
     336</doc:pi>
     337<xsl:template name="pi.dbfo_label-width">
     338  <xsl:param name="node" select="."/>
     339  <xsl:call-template name="dbfo-attribute">
     340    <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
     341    <xsl:with-param name="attribute" select="'label-width'"/>
     342  </xsl:call-template>
     343</xsl:template>
     344
     345<doc:pi name="dbfo_linenumbering.everyNth" xmlns="">
     346  <refpurpose>Specifies interval for lines numbers in verbatims</refpurpose>
     347  <refdescription>
     348    <para>Use the <tag>dbfo linenumbering.everyNth</tag> PI as a child
     349      of a “verbatim” element – <tag>programlisting</tag>,
     350      <tag>screen</tag>, <tag>synopsis</tag> — to specify
     351      the interval at which lines are numbered.</para>
     352  </refdescription>
     353  <refsynopsisdiv>
     354    <synopsis><tag class="xmlpi">dbfo linenumbering.everyNth="<replaceable>N</replaceable>"</tag></synopsis>
     355  </refsynopsisdiv>
     356  <refparameter>
     357    <variablelist>
     358      <varlistentry><term>linenumbering.everyNth="<replaceable>N</replaceable>"</term>
     359        <listitem>
     360          <para>Specifies numbering interval; a number is output
     361            before every <replaceable>N</replaceable>th line</para>
     362        </listitem>
     363      </varlistentry>
     364    </variablelist>
     365  </refparameter>
     366  <refsee role="params">
     367    <para><parameter>linenumbering.everyNth</parameter></para>
     368  </refsee>
     369  <refsee role="tcg">
     370    <para><link role="tcg"
     371        xlink:href="AnnotateListing.html#LineNumbering"
     372        >Line numbering</link></para>
     373  </refsee>
     374</doc:pi>
     375<xsl:template name="pi.dbfo_linenumbering.everyNth">
     376  <xsl:param name="node" select="."/>
     377  <xsl:call-template name="dbfo-attribute">
     378    <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
     379    <xsl:with-param name="attribute" select="'linenumbering.everyNth'"/>
     380  </xsl:call-template>
     381</xsl:template>
     382
     383<doc:pi name="dbfo_linenumbering.separator" xmlns="">
     384  <refpurpose>Specifies separator text for line numbers in verbatims</refpurpose>
     385  <refdescription>
     386    <para>Use the <tag>dbfo linenumbering.separator</tag> PI as a child
     387      of a “verbatim” element – <tag>programlisting</tag>,
     388      <tag>screen</tag>, <tag>synopsis</tag> — to specify
     389      the separator text output between the line numbers and content.</para>
     390  </refdescription>
     391  <refsynopsisdiv>
     392    <synopsis><tag class="xmlpi">dbfo linenumbering.separator="<replaceable>text</replaceable>"</tag></synopsis>
     393  </refsynopsisdiv>
     394  <refparameter>
     395    <variablelist>
     396      <varlistentry><term>linenumbering.separator="<replaceable>text</replaceable>"</term>
     397        <listitem>
     398          <para>Specifies the text (zero or more characters)</para>
     399        </listitem>
     400      </varlistentry>
     401    </variablelist>
     402  </refparameter>
     403  <refsee role="params">
     404    <para><parameter>linenumbering.separator</parameter></para>
     405  </refsee>
     406  <refsee role="tcg">
     407    <para><link role="tcg"
     408        xlink:href="AnnotateListing.html#LineNumbering"
     409        >Line numbering</link></para>
     410  </refsee>
     411</doc:pi>
     412<xsl:template name="pi.dbfo_linenumbering.separator">
     413  <xsl:param name="node" select="."/>
     414  <xsl:call-template name="dbfo-attribute">
     415    <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
     416    <xsl:with-param name="attribute" select="'linenumbering.separator'"/>
     417  </xsl:call-template>
     418</xsl:template>
     419
     420<doc:pi name="dbfo_linenumbering.width" xmlns="">
     421  <refpurpose>Specifies width for line numbers in verbatims</refpurpose>
     422  <refdescription>
     423    <para>Use the <tag>dbfo linenumbering.width</tag> PI as a child
     424      of a “verbatim” element – <tag>programlisting</tag>,
     425      <tag>screen</tag>, <tag>synopsis</tag> — to specify
     426      the width set aside for line numbers.</para>
     427  </refdescription>
     428  <refsynopsisdiv>
     429    <synopsis><tag class="xmlpi">dbfo linenumbering.width="<replaceable>width</replaceable>"</tag></synopsis>
     430  </refsynopsisdiv>
     431  <refparameter>
     432    <variablelist>
     433      <varlistentry><term>linenumbering.width="<replaceable>width</replaceable>"</term>
     434        <listitem>
     435          <para>Specifies the width (inluding units)</para>
     436        </listitem>
     437      </varlistentry>
     438    </variablelist>
     439  </refparameter>
     440  <refsee role="params">
     441    <para><parameter>linenumbering.width</parameter></para>
     442  </refsee>
     443  <refsee role="tcg">
     444    <para><link role="tcg"
     445        xlink:href="AnnotateListing.html#LineNumbering"
     446        >Line numbering</link></para>
     447  </refsee>
     448</doc:pi>
     449<xsl:template name="pi.dbfo_linenumbering.width">
     450  <xsl:param name="node" select="."/>
     451  <xsl:call-template name="dbfo-attribute">
     452    <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
     453    <xsl:with-param name="attribute" select="'linenumbering.width'"/>
     454  </xsl:call-template>
     455</xsl:template>
     456
     457<doc:pi name="dbfo_list-presentation" xmlns="">
     458  <refpurpose>Specifies presentation style for a variablelist or
     459    segmentedlist</refpurpose>
     460  <refdescription>
     461    <para>Use the <tag>dbfo list-presentation</tag> PI as a child of
     462      a <tag>variablelist</tag> or <tag>segmentedlist</tag> to
     463      control the presentation style for the list (to cause it, for
     464      example, to be displayed as a table).</para>
     465  </refdescription>
     466  <refsynopsisdiv>
     467    <synopsis><tag class="xmlpi">dbfo list-presentation="list"|"blocks"|"table"</tag></synopsis>
     468  </refsynopsisdiv>
     469  <refparameter>
     470    <variablelist>
     471      <varlistentry><term>list-presentation="list"</term>
     472        <listitem>
     473          <para>Displays the list as a list</para>
     474        </listitem>
     475      </varlistentry>
     476      <varlistentry><term>list-presentation="blocks"</term>
     477        <listitem>
     478          <para>(<tag>variablelist</tag> only) Displays the list as blocks</para>
     479        </listitem>
     480      </varlistentry>
     481      <varlistentry><term>list-presentation="table"</term>
     482        <listitem>
     483          <para>(<tag>segmentedlist</tag> only) Displays the list as a table</para>
     484        </listitem>
     485      </varlistentry>
     486    </variablelist>
     487  </refparameter>
     488  <refsee role="params">
     489    <itemizedlist>
    69490      <listitem>
    70         <para>FIXME: A color value? [In hex, as a name, or what?]</para>
     491        <para><parameter>variablelist.as.blocks</parameter></para>
    71492      </listitem>
    72     </varlistentry>
    73   </variablelist>
    74 </refparameter>
    75 </doc:pi>
    76 <xsl:template name="pi.dbfo_background-color">
    77   <xsl:param name="node" select="."/>
    78   <xsl:call-template name="dbfo-attribute">
    79     <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
    80     <xsl:with-param name="attribute" select="'background-color'"/>
    81   </xsl:call-template>
    82 </xsl:template>
    83 
    84 <doc:pi name="dbfo_bgcolor" xmlns="">
    85 <refpurpose>Sets background color on an table row or table cell</refpurpose>
    86 <refdescription>
    87   <para>Use the <tag>dbfo bgcolor</tag> PI as child of a table row
    88     or cell to set a background color for that table row or cell.</para>
    89 </refdescription>
    90   <refsynopsisdiv>
    91     <synopsis><tag class="xmlpi">dbfo bgcolor="<replaceable>color</replaceable>"</tag></synopsis>
    92   </refsynopsisdiv>
    93 <refparameter>
    94   <variablelist>
    95     <varlistentry><term>bgcolor="<replaceable>color</replaceable>"</term>
    96493      <listitem>
    97         <para>FIXME: A color value? [In hex, as a name, or what?]</para>
     494        <para><parameter>variablelist.as.table</parameter></para>
    98495      </listitem>
    99     </varlistentry>
    100   </variablelist>
    101 </refparameter>
    102 </doc:pi>
    103 <xsl:template name="pi.dbfo_bgcolor">
    104   <xsl:param name="node" select="."/>
    105   <xsl:call-template name="dbfo-attribute">
    106     <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
    107     <xsl:with-param name="attribute" select="'bgcolor'"/>
    108   </xsl:call-template>
    109 </xsl:template>
    110 
    111 <doc:pi name="dbfo_float-type" xmlns="">
    112 <refpurpose>Specifies float behavior for a sidebar</refpurpose>
    113 <refdescription>
    114   <para>Use the <tag>dbfo float-type</tag> PI to specify the float
    115     behavior for a <tag>sidebar</tag> (to cause the sidebar to be
    116   displayed as a marginal note).</para>
    117 </refdescription>
    118   <refsynopsisdiv>
    119     <synopsis><tag class="xmlpi">dbfo float-type="margin.note"</tag></synopsis>
    120   </refsynopsisdiv>
    121 <refparameter>
    122   <variablelist>
    123     <varlistentry><term>float-type="margin.note"</term>
    124       <listitem>
    125         <para>Specifies that the <tag>sidebar</tag> should be
    126           displayed as a marginal note.</para>
    127       </listitem>
    128     </varlistentry>
    129   </variablelist>
    130 </refparameter>
    131 </doc:pi>
    132 <xsl:template name="pi.dbfo_float-type">
    133   <xsl:param name="node" select="."/>
    134   <xsl:call-template name="dbfo-attribute">
    135     <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
    136     <xsl:with-param name="attribute" select="'float-type'"/>
    137   </xsl:call-template>
    138 </xsl:template>
    139 
    140 <doc:pi name="dbfo_glossary-presentation" xmlns="">
    141 <refpurpose>Specifies presentation style for a glossary</refpurpose>
    142 <refdescription>
    143   <para>Use the <tag>dbfo glossary-presentation</tag> PI as a child of
    144     a <tag>glossary</tag> to control its presentation style.</para>
    145 </refdescription>
    146   <refsynopsisdiv>
    147     <synopsis><tag class="xmlpi">dbfo glossary-presentation="list"|"blocks"</tag></synopsis>
    148   </refsynopsisdiv>
    149 <refparameter>
    150   <variablelist>
    151     <varlistentry><term>glossary-presentation="list"</term>
    152       <listitem>
    153         <para>Displayed the glossary as a list</para>
    154       </listitem>
    155     </varlistentry>
    156     <varlistentry><term>glossary-presentation="blocks"</term>
    157       <listitem>
    158         <para>Displays the glossary as blocks</para>
    159       </listitem>
    160     </varlistentry>
    161   </variablelist>
    162 </refparameter>
    163 </doc:pi>
    164 <xsl:template name="pi.dbfo_glossary-presentation">
    165   <xsl:param name="node" select="."/>
    166   <xsl:call-template name="dbfo-attribute">
    167     <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
    168     <xsl:with-param name="attribute" select="'glossary-presentation'"/>
    169   </xsl:call-template>
    170 </xsl:template>
    171 
    172 <doc:pi name="dbfo_glosslist-presentation" xmlns="">
    173 <refpurpose>Specifies presentation style for a glosslist</refpurpose>
    174 <refdescription>
    175   <para>Use the <tag>dbfo glosslist-presentation</tag> PI as a child of
    176     a <tag>glosslist</tag> to control its presentation style.</para>
    177 </refdescription>
    178   <refsynopsisdiv>
    179     <synopsis><tag class="xmlpi">dbfo glosslist-presentation="list"|"blocks"</tag></synopsis>
    180   </refsynopsisdiv>
    181 <refparameter>
    182   <variablelist>
    183     <varlistentry><term>glosslist-presentation="list"</term>
    184       <listitem>
    185         <para>Displayed the glosslist as a list</para>
    186       </listitem>
    187     </varlistentry>
    188     <varlistentry><term>glosslist-presentation="blocks"</term>
    189       <listitem>
    190         <para>Displays the glosslist as blocks</para>
    191       </listitem>
    192     </varlistentry>
    193   </variablelist>
    194 </refparameter>
    195 </doc:pi>
    196 <xsl:template name="pi.dbfo_glosslist-presentation">
    197   <xsl:param name="node" select="."/>
    198   <xsl:call-template name="dbfo-attribute">
    199     <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
    200     <xsl:with-param name="attribute" select="'glosslist-presentation'"/>
    201   </xsl:call-template>
    202 </xsl:template>
    203 
    204 <doc:pi name="dbfo_glossterm-width" xmlns="">
    205 <refpurpose>Specifies the glossterm width for a glossary or
    206   glosslist</refpurpose>
    207 <refdescription>
    208   <para>Use the <tag>dbfo glossterm-width</tag> PI as a child of a
    209     <tag>glossary</tag> or <tag>glosslist</tag> to specify the
    210     width for output of <tag>glossterm</tag> instances in the
    211     output.</para>
    212 </refdescription>
    213   <refsynopsisdiv>
    214     <synopsis><tag class="xmlpi">dbfo glossterm-width="<replaceable>width</replaceable>"</tag></synopsis>
    215   </refsynopsisdiv>
    216 <refparameter>
    217   <variablelist>
    218     <varlistentry><term>glossterm-width="<replaceable>width</replaceable>"</term>
    219       <listitem>
    220         <para>FIXME: Specifies the glossterm width (in what units?)</para>
    221       </listitem>
    222     </varlistentry>
    223   </variablelist>
    224 </refparameter>
    225 </doc:pi>
    226 <xsl:template name="pi.dbfo_glossterm-width">
    227   <xsl:param name="node" select="."/>
    228   <xsl:call-template name="dbfo-attribute">
    229     <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
    230     <xsl:with-param name="attribute" select="'glossterm-width'"/>
    231   </xsl:call-template>
    232 </xsl:template>
    233 
    234 <doc:pi name="dbfo_keep-together" xmlns="">
    235 <refpurpose>Specifies “keep” behavior for a table, example,
    236   figure, or equation</refpurpose>
    237 <refdescription>
    238   <para>Use the <tag>dbfo keep-together</tag> PI as a child of a
    239     formal object (<tag>table</tag>, <tag>example</tag>,
    240     <tag>figure</tag>, or <tag>equation</tag>) or their informal
    241     equivalents) to specify “keep” behavior for the object (to
    242     allow the object to “break” across a page).</para>
    243 </refdescription>
    244   <refsynopsisdiv>
    245     <synopsis><tag class="xmlpi">dbfo keep-together="auto"|"always"</tag></synopsis>
    246   </refsynopsisdiv>
    247 <refparameter>
    248   <variablelist>
    249     <varlistentry><term>keep-together="auto"</term>
    250       <listitem>
    251         <para>Enables the object to break across a page</para>
    252       </listitem>
    253     </varlistentry>
    254     <varlistentry><term>keep-together="always"</term>
    255       <listitem>
    256         <para>Prevents the object from breaking across a page (the
    257           default stylesheet behavior)</para>
    258       </listitem>
    259     </varlistentry>
    260   </variablelist>
    261 </refparameter>
    262 </doc:pi>
    263 <xsl:template name="pi.dbfo_keep-together">
    264   <xsl:param name="node" select="."/>
    265   <xsl:call-template name="dbfo-attribute">
    266     <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
    267     <xsl:with-param name="attribute" select="'keep-together'"/>
    268   </xsl:call-template>
    269 </xsl:template>
    270 
    271 <doc:pi name="dbfo_label-width" xmlns="">
    272 <refpurpose>Specifies the label width for an itemizedlist,
    273   orderedlist, or qandaset</refpurpose>
    274 <refdescription>
    275   <para>Use the <tag>dbfo label-width</tag> PI as a child of an
    276     <tag>itemizedlist</tag>, <tag>orderedlist</tag>, or
    277     <tag>qandaset</tag> to specify the width of labels.</para>
    278 </refdescription>
    279   <refsynopsisdiv>
    280     <synopsis><tag class="xmlpi">dbfo label-width="<replaceable>width</replaceable>"</tag></synopsis>
    281   </refsynopsisdiv>
    282 <refparameter>
    283   <variablelist>
    284     <varlistentry><term>label-width="<replaceable>width</replaceable>"</term>
    285       <listitem>
    286         <para>FIXME: Specifies the label width (in what units?)</para>
    287       </listitem>
    288     </varlistentry>
    289   </variablelist>
    290 </refparameter>
    291 </doc:pi>
    292 <xsl:template name="pi.dbfo_label-width">
    293   <xsl:param name="node" select="."/>
    294   <xsl:call-template name="dbfo-attribute">
    295     <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
    296     <xsl:with-param name="attribute" select="'label-width'"/>
    297   </xsl:call-template>
    298 </xsl:template>
    299 
    300 <doc:pi name="dbfo_linenumbering.everyNth" xmlns="">
    301 <refpurpose>Specifies the interval at which lines are numbered
    302   output of verbatim environments</refpurpose>
    303 <refdescription>
    304   <para>Use the <tag>dbfo linenumbering.everyNth</tag> PI as a child
    305     of a “verbatim” element – <tag>programlisting</tag>,
    306     <tag>screen</tag>, <tag>synopsis</tag> — to specify
    307     the interval at which lines are numbered.</para>
    308 </refdescription>
    309   <refsynopsisdiv>
    310     <synopsis><tag class="xmlpi">dbfo linenumbering.everyNth="<replaceable>N</replaceable>"</tag></synopsis>
    311   </refsynopsisdiv>
    312 <refparameter>
    313   <variablelist>
    314     <varlistentry><term>linenumbering.everyNth="<replaceable>N</replaceable>"</term>
    315       <listitem>
    316         <para>FIXME: Specifies numbering interval; a number is
    317           output before every <replaceable>N</replaceable>th line</para>
    318       </listitem>
    319     </varlistentry>
    320   </variablelist>
    321 </refparameter>
    322 </doc:pi>
    323 <xsl:template name="pi.dbfo_linenumbering.everyNth">
    324   <xsl:param name="node" select="."/>
    325   <xsl:call-template name="dbfo-attribute">
    326     <xsl:with-param name="pis"
    327       select="$node/processing-instruction('dbfo')"/>
    328     <xsl:with-param name="attribute" select="'linenumbering.everyNth'"/>
    329   </xsl:call-template>
    330 </xsl:template>
    331 
    332 <doc:pi name="dbfo_linenumbering.separator" xmlns="">
    333 <refpurpose>Specifies the separator text used between line numbers
    334   and content in output of verbatim environments</refpurpose>
    335 <refdescription>
    336   <para>Use the <tag>dbfo linenumbering.separator</tag> PI as a child
    337     of a “verbatim” element – <tag>programlisting</tag>,
    338     <tag>screen</tag>, <tag>synopsis</tag> — to specify
    339     the separator text output between the line numbers and content.</para>
    340 </refdescription>
    341   <refsynopsisdiv>
    342     <synopsis><tag class="xmlpi">dbfo linenumbering.separator="<replaceable>text</replaceable>"</tag></synopsis>
    343   </refsynopsisdiv>
    344 <refparameter>
    345   <variablelist>
    346     <varlistentry><term>linenumbering.separator="<replaceable>text</replaceable>"</term>
    347       <listitem>
    348         <para>FIXME: Specifies the text (zero or more characters)</para>
    349       </listitem>
    350     </varlistentry>
    351   </variablelist>
    352 </refparameter>
    353 </doc:pi>
    354 <xsl:template name="pi.dbfo_linenumbering.separator">
    355   <xsl:param name="node" select="."/>
    356   <xsl:call-template name="dbfo-attribute">
    357     <xsl:with-param name="pis"
    358       select="$node/processing-instruction('dbfo')"/>
    359     <xsl:with-param name="attribute" select="'linenumbering.separator'"/>
    360   </xsl:call-template>
    361 </xsl:template>
    362 
    363 <doc:pi name="dbfo_linenumbering.width" xmlns="">
    364 <refpurpose>Specifies the width set aside for line numbers in
    365   output of verbatim environments</refpurpose>
    366 <refdescription>
    367   <para>Use the <tag>dbfo linenumbering.width</tag> PI as a child
    368     of a “verbatim” element – <tag>programlisting</tag>,
    369     <tag>screen</tag>, <tag>synopsis</tag> — to specify
    370     the width set aside for line numbers.</para>
    371 </refdescription>
    372   <refsynopsisdiv>
    373     <synopsis><tag class="xmlpi">dbfo linenumbering.width="<replaceable>width</replaceable>"</tag></synopsis>
    374   </refsynopsisdiv>
    375 <refparameter>
    376   <variablelist>
    377     <varlistentry><term>linenumbering.width="<replaceable>width</replaceable>"</term>
    378       <listitem>
    379         <para>FIXME: Specifies the width (in what units?)</para>
    380       </listitem>
    381     </varlistentry>
    382   </variablelist>
    383 </refparameter>
    384 </doc:pi>
    385 <xsl:template name="pi.dbfo_linenumbering.width">
    386   <xsl:param name="node" select="."/>
    387   <xsl:call-template name="dbfo-attribute">
    388     <xsl:with-param name="pis"
    389       select="$node/processing-instruction('dbfo')"/>
    390     <xsl:with-param name="attribute" select="'linenumbering.width'"/>
     496    </itemizedlist>
     497  </refsee>
     498  <refsee role="tcg">
     499    <para><link role="tcg"
     500        xlink:href="Variablelists.html#ListIndents"
     501        >Variable list formatting in print</link></para>
     502  </refsee>
     503</doc:pi>
     504<xsl:template name="pi.dbfo_list-presentation">
     505  <xsl:param name="node" select="."/>
     506  <xsl:call-template name="dbfo-attribute">
     507    <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
     508    <xsl:with-param name="attribute" select="'list-presentation'"/>
    391509  </xsl:call-template>
    392510</xsl:template>
    393511
    394512<doc:pi name="dbfo_list-width" xmlns="">
    395 <refpurpose>Specifies the width of a horizontal simplelist</refpurpose>
    396 <refdescription>
    397   <para>Use the <tag>dbfo list-width</tag> PI as a child of a
    398     <tag>simplelist</tag> whose <tag class="attribute">class</tag>
    399     value is <literal>horizontal</literal>, to specify the width
    400     of the <tag>simplelist</tag>.</para>
    401 </refdescription>
     513  <refpurpose>Specifies the width of a horizontal simplelist</refpurpose>
     514  <refdescription>
     515    <para>Use the <tag>dbfo list-width</tag> PI as a child of a
     516      <tag>simplelist</tag> whose <tag class="attribute">class</tag>
     517      value is <literal>horizontal</literal>, to specify the width
     518      of the <tag>simplelist</tag>.</para>
     519  </refdescription>
    402520  <refsynopsisdiv>
    403521    <synopsis><tag class="xmlpi">dbfo list-width="<replaceable>width</replaceable>"</tag></synopsis>
    404522  </refsynopsisdiv>
    405 <refparameter>
    406   <variablelist>
    407     <varlistentry><term>list-width="<replaceable>width</replaceable>"</term>
    408       <listitem>
    409         <para>FIXME: Specifies the <tag>simplelist</tag> width (in what units?)</para>
    410       </listitem>
    411     </varlistentry>
    412   </variablelist>
    413 </refparameter>
     523  <refparameter>
     524    <variablelist>
     525      <varlistentry><term>list-width="<replaceable>width</replaceable>"</term>
     526        <listitem>
     527          <para>Specifies the <tag>simplelist</tag> width (including units)</para>
     528        </listitem>
     529      </varlistentry>
     530    </variablelist>
     531  </refparameter>
    414532</doc:pi>
    415533<xsl:template name="pi.dbfo_list-width">
    … …  
    421539</xsl:template>
    422540
    423 <doc:pi name="dbfo_list-presentation" xmlns="">
    424 <refpurpose>Specifies presentation style for a variablelist or
    425   segmentedlist</refpurpose>
    426 <refdescription>
    427   <para>Use the <tag>dbfo list-presentation</tag> PI as a child of
    428     a <tag>variablelist</tag> or <tag>segmentedlist</tag> to
    429     control the presentation style for the list (to cause it, for
    430     example, to be displayed as a table).</para>
    431 </refdescription>
    432   <refsynopsisdiv>
    433     <synopsis><tag class="xmlpi">dbfo list-presentation="list"|"blocks"|"table"</tag></synopsis>
    434   </refsynopsisdiv>
    435 <refparameter>
    436   <variablelist>
    437     <varlistentry><term>list-presentation="list"</term>
    438       <listitem>
    439         <para>Displayed the list as a list</para>
    440       </listitem>
    441     </varlistentry>
    442     <varlistentry><term>list-presentation="blocks"</term>
    443       <listitem>
    444         <para>(<tag>variablelist</tag> only) Displays the list as blocks</para>
    445       </listitem>
    446     </varlistentry>
    447     <varlistentry><term>list-presentation="table"</term>
    448       <listitem>
    449         <para>(<tag>segmentedlist</tag> only) Displays the list as a table</para>
    450       </listitem>
    451     </varlistentry>
    452   </variablelist>
    453 </refparameter>
    454 </doc:pi>
    455 <xsl:template name="pi.dbfo_list-presentation">
    456   <xsl:param name="node" select="."/>
    457   <xsl:call-template name="dbfo-attribute">
    458     <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
    459     <xsl:with-param name="attribute" select="'list-presentation'"/>
    460   </xsl:call-template>
    461 </xsl:template>
    462 
    463541<doc:pi name="dbfo_orientation" xmlns="">
    464 <refpurpose>Specifies the orientation for table row or cell</refpurpose>
    465 <refdescription>
    466   <para>Use the <tag>dbfo orientation</tag> PI as a child of an
    467     <tag>table</tag> row or cell to specify the orientation
    468     (rotation) for the row or cell.</para>
    469 </refdescription>
     542  <refpurpose>Specifies the orientation for table row or cell</refpurpose>
     543  <refdescription>
     544    <para>Use the <tag>dbfo orientation</tag> PI as a child of an
     545      <tag>table</tag> row or cell to specify the orientation
     546      (rotation) for the row or cell.</para>
     547  </refdescription>
    470548  <refsynopsisdiv>
    471549    <synopsis><tag class="xmlpi">dbfo orientation="0"|"90"|"180"|"270"|"-90"|"-180"|"-270"</tag></synopsis>
    472550  </refsynopsisdiv>
    473 <refparameter>
    474   <variablelist>
    475     <varlistentry><term>orientation="0"|"90"|"180"|"270"|"-90"|"-180"|"-270"</term>
    476       <listitem>
    477         <para>Specifies the number of degrees by which the cell or
    478           row is rotated</para>
    479       </listitem>
    480     </varlistentry>
    481   </variablelist>
    482 </refparameter>
     551  <refparameter>
     552    <variablelist>
     553      <varlistentry><term>orientation="0"|"90"|"180"|"270"|"-90"|"-180"|"-270"</term>
     554        <listitem>
     555          <para>Specifies the number of degrees by which the cell or
     556            row is rotated</para>
     557        </listitem>
     558      </varlistentry>
     559    </variablelist>
     560  </refparameter>
    483561</doc:pi>
    484562<xsl:template name="pi.dbfo_orientation">
    … …  
    491569
    492570<doc:pi name="dbfo_pgwide" xmlns="">
    493   <refpurpose>Species whether an <tag>equation</tag> or
    494     <tag>example</tag> should rendered across the full width of a
    495     page</refpurpose>
    496 <refdescription>
    497   <para>Use the <tag>dbfo pgwide</tag> PI as a child of an
    498     <tag>equation</tag> or <tag>example</tag> to specify that the
    499     content should rendered across the full width of the page.</para>
    500 </refdescription>
     571  <refpurpose>Specifies if an <tag>equation</tag> or <tag>example</tag> goes across full page width</refpurpose>
     572  <refdescription>
     573    <para>Use the <tag>dbfo pgwide</tag> PI as a child of an
     574      <tag>equation</tag> or <tag>example</tag> to specify that the
     575      content should rendered across the full width of the page.</para>
     576  </refdescription>
    501577  <refsynopsisdiv>
    502578    <synopsis><tag class="xmlpi">dbfo pgwide="0"|"1"</tag></synopsis>
    503579  </refsynopsisdiv>
    504 <refparameter>
    505   <variablelist>
    506     <varlistentry><term>pgwide="0"</term>
    507       <listitem>
    508         <para>If zero, the content is rendered across the current
    509         text flow</para>
    510       </listitem>
    511     </varlistentry>
    512     <varlistentry><term>pgwide="1"</term>
    513       <listitem>
    514         <para>If <code>1</code> (or any non-zero value), the
    515           content is rendered across the full width of the page</para>
    516       </listitem>
    517     </varlistentry>
    518   </variablelist>
    519 </refparameter>
     580  <refparameter>
     581    <variablelist>
     582      <varlistentry><term>pgwide="0"</term>
     583        <listitem>
     584          <para>If zero, the content is rendered across the current
     585            text flow</para>
     586        </listitem>
     587      </varlistentry>
     588      <varlistentry><term>pgwide="1"</term>
     589        <listitem>
     590          <para>If <code>1</code> (or any non-zero value), the
     591            content is rendered across the full width of the page</para>
     592        </listitem>
     593      </varlistentry>
     594    </variablelist>
     595  </refparameter>
     596  <refsee role="params">
     597    <para><parameter>pgwide.properties</parameter></para>
     598  </refsee>
    520599</doc:pi>
    521600<xsl:template name="pi.dbfo_pgwide">
    … …  
    530609  <refpurpose>Specifies the width for a table <tag>entry</tag> or
    531610    <tag>row</tag></refpurpose>
    532 <refdescription>
    533   <para>Use the <tag>dbfo rotated-width</tag> PI as a child of an
    534     <tag>entry</tag> or <tag>row</tag> instance to specify the
    535     width of that the <tag>entry</tag> or <tag>row</tag>; or
    536     use it higher up in table to cause the width to be inherited
    537     recursively down.</para>
    538 </refdescription>
     611  <refdescription>
     612    <para>Use the <tag>dbfo rotated-width</tag> PI as a child of an
     613      <tag>entry</tag> or <tag>row</tag> instance to specify the
     614      width of that the <tag>entry</tag> or <tag>row</tag>; or
     615      use it higher up in table to cause the width to be inherited
     616      recursively down.</para>
     617  </refdescription>
    539618  <refsynopsisdiv>
    540619    <synopsis><tag class="xmlpi">dbfo rotated-width="<replaceable>width</replaceable>"</tag></synopsis>
    541620  </refsynopsisdiv>
    542 <refparameter>
    543   <variablelist>
    544     <varlistentry><term>rotated-width="<replaceable>width</replaceable>"</term>
    545       <listitem>
    546         <para>FIXME: Specifies the width of a row or cell (in what units?)</para>
    547       </listitem>
    548     </varlistentry>
    549   </variablelist>
    550 </refparameter>
     621  <refparameter>
     622    <variablelist>
     623      <varlistentry><term>rotated-width="<replaceable>width</replaceable>"</term>
     624        <listitem>
     625          <para>Specifies the width of a row or cell (including units)</para>
     626        </listitem>
     627      </varlistentry>
     628    </variablelist>
     629  </refparameter>
    551630</doc:pi>
    552631<xsl:template name="pi.dbfo_rotated-width">
    553632  <xsl:param name="node" select="."/>
    554633  <xsl:call-template name="dbfo-attribute">
    555     <xsl:with-param name="pis"
    556       select="$node/processing-instruction('dbfo')"/>
     634    <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
    557635    <xsl:with-param name="attribute" select="'rotated-width'"/>
    558636  </xsl:call-template>
    … …  
    560638
    561639<doc:pi name="dbfo_sidebar-width" xmlns="">
    562 <refpurpose>Specifies the width of a sidebar</refpurpose>
    563 <refdescription>
    564   <para>Use the <tag>dbfo sidebar-width</tag> PI as a child of a
    565     <tag>sidebar</tag> to specify the width of the sidebar.</para>
    566 </refdescription>
     640  <refpurpose>Specifies the width of a sidebar</refpurpose>
     641  <refdescription>
     642    <para>Use the <tag>dbfo sidebar-width</tag> PI as a child of a
     643      <tag>sidebar</tag> to specify the width of the sidebar.</para>
     644  </refdescription>
    567645  <refsynopsisdiv>
    568646    <synopsis><tag class="xmlpi">dbfo sidebar-width="<replaceable>width</replaceable>"</tag></synopsis>
    569647  </refsynopsisdiv>
    570 <refparameter>
    571   <variablelist>
    572     <varlistentry><term>sidebar-width="<replaceable>width</replaceable>"</term>
    573       <listitem>
    574         <para>FIXME: Specifies the <tag>sidebar</tag> width (in what units?)</para>
    575       </listitem>
    576     </varlistentry>
    577   </variablelist>
    578 </refparameter>
     648  <refparameter>
     649    <variablelist>
     650      <varlistentry><term>sidebar-width="<replaceable>width</replaceable>"</term>
     651        <listitem>
     652          <para>Specifies the <tag>sidebar</tag> width (including units)</para>
     653        </listitem>
     654      </varlistentry>
     655    </variablelist>
     656  </refparameter>
     657  <refsee role="params">
     658    <para><parameter>sidebar.float.type parameter</parameter>,
     659      <parameter>sidebar.float.width parameter</parameter>,
     660      <parameter>sidebar.properties attribute-set</parameter>,
     661      <parameter>sidebar.title.properties</parameter>
     662    </para>
     663  </refsee>
     664  <refsee role="tcg">
     665    <para><link xlink:href="SideFloats.html#SidebarFloats" >A sidebar as
     666        side float</link></para>
     667  </refsee>
    579668</doc:pi>
    580669<xsl:template name="pi.dbfo_sidebar-width">
    … …  
    586675</xsl:template>
    587676
     677<doc:pi name="dbfo_start" xmlns="">
     678  <refpurpose>(obsolete) Sets the starting number on an ordered list</refpurpose>
     679  <refdescription>
     680    <para><emphasis>This PI is obsolete</emphasis>. The intent of
     681      it was to provide a means for setting a specific starting
     682      number for an ordered list. Instead of this PI, set a value
     683      for the <literal>override</literal> attribute on the first
     684      <tag>listitem</tag> in the list; that will have the same
     685      effect as what this PI was intended for.</para>
     686  </refdescription>
     687  <refsynopsisdiv>
     688    <synopsis><tag class="xmlpi">dbfo start="<replaceable>character</replaceable>"</tag></synopsis>
     689  </refsynopsisdiv>
     690  <refparameter>
     691    <variablelist>
     692      <varlistentry><term>start="<replaceable>character</replaceable>"</term>
     693        <listitem>
     694          <para>Specifies the character to use as the starting
     695            number; use 0-9, a-z, A-Z, or lowercase or uppercase
     696            Roman numerals</para>
     697        </listitem>
     698      </varlistentry>
     699    </variablelist>
     700  </refparameter>
     701  <refsee role="tcg">
     702    <para><link role="tcg"
     703        xlink:href="Orderedlists.html#ListStartNum"
     704        >List starting number</link></para>
     705  </refsee>
     706</doc:pi>
     707<xsl:template name="pi.dbfo_start">
     708  <xsl:param name="node" select="."/>
     709  <xsl:call-template name="pi-attribute">
     710    <xsl:with-param name="pis" select="$node/processing-instruction('dbfo')"/>
     711    <xsl:with-param name="attribute" select="'start'"/>
     712  </xsl:call-template>
     713</xsl:template>
     714
    588715<doc:pi name="dbfo_table-width" xmlns="">
    589 <refpurpose>Specifies the width for a table or for revhistory
    590   output</refpurpose>
    591 <refdescription>
    592   <para>Use the <tag>dbfo table-width</tag> PI as a child of a
    593     <tag>table</tag> or <tag>revhistory</tag> instance (which is
    594     rendered as a table in output) to specify the width of the
    595     table in output.</para>
    596 </refdescription>
     716  <refpurpose>Specifies the width for a table or for revhistory
     717    output</refpurpose>
     718  <refdescription>
     719    <para>Use the <tag>dbfo table-width</tag> PI as a child or
     720      sibling of a <tag>table</tag>, or as a child of an
     721      <tag>informaltable</tag>, <tag>entrybl</tag>, or
     722      <tag>revhistory</tag> instance (which is rendered as a table
     723      in output) to specify the width of the table in output.</para>
     724  </refdescription>
    597725  <refsynopsisdiv>
    598726    <synopsis><tag class="xmlpi">dbfo table-width="<replaceable>width</replaceable>"</tag></synopsis>
    599727  </refsynopsisdiv>
    600 <refparameter>
    601   <variablelist>
    602     <varlistentry><term>table-width="<replaceable>width</replaceable>"</term>
    603       <listitem>
    604         <para>FIXME: Specifies the table width (in what units?)</para>
    605       </listitem>
    606     </varlistentry>
    607   </variablelist>
    608 </refparameter>
     728  <refparameter>
     729    <variablelist>
     730      <varlistentry><term>table-width="<replaceable>width</replaceable>"</term>
     731        <listitem>
     732          <para>Specifies the table width (including units or as a percentage)</para>
     733        </listitem>
     734      </varlistentry>
     735    </variablelist>
     736  </refparameter>
     737  <refsee role="tcg">
     738    <para><link role="tcg"
     739        xlink:href="Tables.html#TableWidth"
     740        >Table width</link></para>
     741  </refsee>
    609742</doc:pi>
    610743<xsl:template name="pi.dbfo_table-width">
    … …  
    617750
    618751<doc:pi name="dbfo_term-width" xmlns="">
    619 <refpurpose>Specifies the term width for a variablelist</refpurpose>
    620 <refdescription>
    621   <para>Use the <tag>dbfo term-width</tag> PI as a child of a
    622     <tag>variablelist</tag> to specify the width for
    623     <tag>term</tag> output.</para>
    624 </refdescription>
     752  <refpurpose>Specifies the term width for a variablelist</refpurpose>
     753  <refdescription>
     754    <para>Use the <tag>dbfo term-width</tag> PI as a child of a
     755      <tag>variablelist</tag> to specify the width for
     756      <tag>term</tag> output.</para>
     757  </refdescription>
    625758  <refsynopsisdiv>
    626759    <synopsis><tag class="xmlpi">dbfo term-width="<replaceable>width</replaceable>"</tag></synopsis>
    627760  </refsynopsisdiv>
    628 <refparameter>
    629   <variablelist>
    630     <varlistentry><term>term-width="<replaceable>width</replaceable>"</term>
    631       <listitem>
    632         <para>FIXME: Specifies the term width (in what units?)</para>
    633       </listitem>
    634     </varlistentry>
    635   </variablelist>
    636 </refparameter>
     761  <refparameter>
     762    <variablelist>
     763      <varlistentry><term>term-width="<replaceable>width</replaceable>"</term>
     764        <listitem>
     765          <para>Specifies the term width (including units)</para>
     766        </listitem>
     767      </varlistentry>
     768    </variablelist>
     769  </refparameter>
     770  <refsee role="tcg">
     771    <para><link role="tcg"
     772        xlink:href="Variablelists.html#ListIndents"
     773        >Variable list formatting in print</link></para>
     774  </refsee>
    637775</doc:pi>
    638776<xsl:template name="pi.dbfo_term-width">
    … …  
    645783
    646784<doc:pi name="dbfo_toc" xmlns="">
    647 <refpurpose>Species whether a TOC should be generated for a qandaset</refpurpose>
    648 <refdescription>
    649   <para>Use the <tag>dbfo toc</tag> PI as a child of a
    650     <tag>jandaset</tag> to specify whether a table of contents
    651     (TOC) is generated for the <tag>qandaset</tag>.</para>
    652 </refdescription>
     785  <refpurpose>Species whether a TOC should be generated for a qandaset</refpurpose>
     786  <refdescription>
     787    <para>Use the <tag>dbfo toc</tag> PI as a child of a
     788      <tag>qandaset</tag> to specify whether a table of contents
     789      (TOC) is generated for the <tag>qandaset</tag>.</para>
     790  </refdescription>
    653791  <refsynopsisdiv>
    654792    <synopsis><tag class="xmlpi">dbfo toc="0"|"1"</tag></synopsis>
    655793  </refsynopsisdiv>
    656 <refparameter>
    657   <variablelist>
    658     <varlistentry><term>toc="0"</term>
    659       <listitem>
    660         <para>If zero, no TOC is generated</para>
    661       </listitem>
    662     </varlistentry>
    663     <varlistentry><term>toc="1"</term>
    664       <listitem>
    665         <para>If <code>1</code> (or any non-zero value),
    666           a TOC is generated</para>
    667       </listitem>
    668     </varlistentry>
    669   </variablelist>
    670 </refparameter>
     794  <refparameter>
     795    <variablelist>
     796      <varlistentry><term>toc="0"</term>
     797        <listitem>
     798          <para>If zero, no TOC is generated</para>
     799        </listitem>
     800      </varlistentry>
     801      <varlistentry><term>toc="1"</term>
     802        <listitem>
     803          <para>If <code>1</code> (or any non-zero value),
     804            a TOC is generated</para>
     805        </listitem>
     806      </varlistentry>
     807    </variablelist>
     808  </refparameter>
     809  <refsee role="tcg">
     810    <para><link role="tcg"
     811        xlink:href="QandAtoc.html"
     812        >Q and A list of questions</link>,
     813      <link role="tcg"
     814        xlink:href="QandAformat.html"
     815        >Q and A formatting</link></para>
     816  </refsee>
    671817</doc:pi>
    672818<xsl:template name="pi.dbfo_toc">
    … …  
    678824</xsl:template>
    679825
    680 <!-- ==================================================================== -->
    681 
    682826<doc:pi name="dbfo-need" xmlns="">
    683 <refpurpose>Specify a need for space (a kind of soft page break)</refpurpose>
    684 <refdescription>
    685   <para>A “need” is a request for space on a page.  If the
    686     requested space is not available, the page breaks and the
    687     content that follows the need request appears on the next
    688     page. If the requested space is available, then the request is
    689     ignored.</para>
    690 </refdescription>
    691   <refsynopsisdiv>
    692     <synopsis><tag class="xmlpi">dbfo-need height="<replaceable>n</replaceable>"</tag></synopsis>
    693     <synopsis><tag class="xmlpi">dbfo-need space-before="<replaceable>n</replaceable>"</tag></synopsis>
    694   </refsynopsisdiv>
    695 <refparameter>
    696   <variablelist>
    697     <varlistentry><term>height="<replaceable>n</replaceable>"</term>
    698       <listitem>
    699         <para>FIXME: the amount of height(?) needed? In what units? pt?.</para>
    700       </listitem>
    701     </varlistentry>
    702     <varlistentry><term>space-before"<replaceable>n</replaceable>"</term>
    703       <listitem>
    704         <para>FIXME: the amount of space needed before the
    705           [something]? In what units? pt?.</para>
    706       </listitem>
    707     </varlistentry>
    708   </variablelist>
    709 </refparameter>
     827  <refpurpose>Specify a need for space (a kind of soft page break)</refpurpose>
     828  <refdescription>
     829    <para>A “need” is a request for space on a page.  If the
     830      requested space is not available, the page breaks and the
     831      content that follows the need request appears on the next
     832      page. If the requested space is available, then no page break
     833      is inserted.</para>
     834  </refdescription>
     835  <refsynopsisdiv>
     836    <synopsis><tag class="xmlpi">dbfo-need height="<replaceable>n</replaceable>" [space-before="<replaceable>n</replaceable>"]</tag></synopsis>
     837  </refsynopsisdiv>
     838  <refparameter>
     839    <variablelist>
     840      <varlistentry><term>height="<replaceable>n</replaceable>"</term>
     841        <listitem>
     842          <para>The amount of height needed (including units)</para>
     843        </listitem>
     844      </varlistentry>
     845      <varlistentry><term>space-before"<replaceable>n</replaceable>"</term>
     846        <listitem>
     847          <para>The amount of extra vertical space to add (including units)</para>
     848        </listitem>
     849      </varlistentry>
     850    </variablelist>
     851  </refparameter>
     852  <refsee role="tcg">
     853    <para><link role="tcg"
     854        xlink:href="PageBreaking.html#SoftPageBreaks"
     855        >Soft page breaks</link></para>
     856  </refsee>
    710857</doc:pi>
    711858<xsl:template name="pi.dbfo-need">
    … …  
    744891    </xsl:when>
    745892    <xsl:when test="$pi-before != '' and
    746                     not(following-sibling::listitem) and
    747                     not(following-sibling::step)">
     893      not(following-sibling::listitem) and
     894      not(following-sibling::step)">
    748895      <fo:block space-after="0pt" space-before="{$pi-before}">
    749896        <xsl:copy-of select="$spacer"/>
    … …  
    752899    <xsl:when test="following-sibling::para">
    753900      <fo:block space-after="0pt"
    754                 xsl:use-attribute-sets="normal.para.spacing">
     901        xsl:use-attribute-sets="normal.para.spacing">
    755902        <xsl:copy-of select="$spacer"/>
    756903      </fo:block>
    757904    </xsl:when>
    758905    <xsl:when test="following-sibling::table or
    759                     following-sibling::figure or
    760                     following-sibling::example or
    761                     following-sibling::equation">
     906      following-sibling::figure or
     907      following-sibling::example or
     908      following-sibling::equation">
    762909      <fo:block space-after="0pt"
    763                 xsl:use-attribute-sets="formal.object.properties">
     910        xsl:use-attribute-sets="formal.object.properties">
    764911        <xsl:copy-of select="$spacer"/>
    765912      </fo:block>
    766913    </xsl:when>
    767914    <xsl:when test="following-sibling::informaltable or
    768                     following-sibling::informalfigure or
    769                     following-sibling::informalexample or
    770                     following-sibling::informalequation">
     915      following-sibling::informalfigure or
     916      following-sibling::informalexample or
     917      following-sibling::informalequation">
    771918      <fo:block space-after="0pt"
    772                 xsl:use-attribute-sets="informal.object.properties">
     919        xsl:use-attribute-sets="informal.object.properties">
    773920        <xsl:copy-of select="$spacer"/>
    774921      </fo:block>
    775922    </xsl:when>
    776923    <xsl:when test="following-sibling::itemizedlist or
    777                     following-sibling::orderedlist or
    778                     following-sibling::variablelist or
    779                     following-sibling::simplelist">
     924      following-sibling::orderedlist or
     925      following-sibling::variablelist or
     926      following-sibling::simplelist">
    780927      <fo:block space-after="0pt"
    781                 xsl:use-attribute-sets="informal.object.properties">
     928        xsl:use-attribute-sets="informal.object.properties">
    782929        <xsl:copy-of select="$spacer"/>
    783930      </fo:block>
    784931    </xsl:when>
    785932    <xsl:when test="following-sibling::listitem or
    786                     following-sibling::step">
     933      following-sibling::step">
    787934      <fo:list-item space-after="0pt"
    788                 xsl:use-attribute-sets="informal.object.properties">
     935        xsl:use-attribute-sets="informal.object.properties">
    789936        <fo:list-item-label/>
    790937        <fo:list-item-body start-indent="0pt" end-indent="0pt">
    … …  
    794941    </xsl:when>
    795942    <xsl:when test="following-sibling::sect1 or
    796                     following-sibling::sect2 or
    797                     following-sibling::sect3 or
    798                     following-sibling::sect4 or
    799                     following-sibling::sect5 or
    800                     following-sibling::section">
     943      following-sibling::sect2 or
     944      following-sibling::sect3 or
     945      following-sibling::sect4 or
     946      following-sibling::sect5 or
     947      following-sibling::section">
    801948      <fo:block space-after="0pt"
    802                 xsl:use-attribute-sets="section.title.properties">
     949        xsl:use-attribute-sets="section.title.properties">
    803950        <xsl:copy-of select="$spacer"/>
    804951      </fo:block>
    … …  
    816963    </xsl:when>
    817964    <xsl:when test="following-sibling::listitem or
    818                     following-sibling::step">
     965      following-sibling::step">
    819966      <fo:list-item space-before.precedence="force"
    820                 space-before="-{$height}"
    821                 space-after="0pt"
    822                 space-after.precedence="force">
     967        space-before="-{$height}"
     968        space-after="0pt"
     969        space-after.precedence="force">
    823970        <fo:list-item-label/>
    824971        <fo:list-item-body start-indent="0pt" end-indent="0pt"/>
    … …  
    827974    <xsl:otherwise>
    828975      <fo:block space-before.precedence="force"
    829                 space-before="-{$height}"
    830                 space-after="0pt"
    831                 space-after.precedence="force">
     976        space-before="-{$height}"
     977        space-after="0pt"
     978        space-after.precedence="force">
    832979      </fo:block>
    833980    </xsl:otherwise>
    … …  
    849996
    850997<!-- ==================================================================== -->
     998
    851999<xsl:template match="processing-instruction()">
    8521000</xsl:template>
Note: See TracChangeset for help on using the changeset viewer.