| <?xml version="1.0"?> |
| |
| <reference><info><title>FO Processing Instruction Reference</title> |
| <releaseinfo role="meta"> |
| $Id$ |
| </releaseinfo> |
| </info> |
| |
| <partintro xml: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> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_background-color"> |
| <refnamediv> |
| <refname>dbfo_background-color</refname> |
| <refpurpose>Sets background color for an image</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo background-color="<replaceable>color</replaceable>"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">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> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <variablelist> |
| <varlistentry><term>background-color="<replaceable>color</replaceable>"</term> |
| <listitem> |
| |
| <para>An HTML color value</para> |
| |
| </listitem> |
| </varlistentry> |
| </variablelist> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="BGcolor.html">Background color</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_bgcolor"> |
| <refnamediv> |
| <refname>dbfo_bgcolor</refname> |
| <refpurpose>Sets background color on a table row or table cell</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo bgcolor="<replaceable>color</replaceable>"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">dbfo bgcolor</tag> PI as child of a table row |
| or cell to set a background color for that table row or cell.</para> |
| |
| |
| <para>This PI works for both CALS and HTML tables.</para> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <variablelist> |
| <varlistentry><term>bgcolor="<replaceable>color</replaceable>"</term> |
| <listitem> |
| |
| <para>An HTML color value</para> |
| |
| </listitem> |
| </varlistentry> |
| </variablelist> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="BGtableColor.html#CellBGColor">Cell background color</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_float-type"> |
| <refnamediv> |
| <refname>dbfo_float-type</refname> |
| <refpurpose>Specifies float behavior for a sidebar</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo float-type="margin.note"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">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> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <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> |
| |
| </refsect1><refsect1 role="params"><title>Related Global Parameters</title> |
| |
| <para><parameter>sidebar.float.type</parameter> (parameter), |
| <parameter>sidebar.float.width</parameter> (parameter), |
| <parameter>sidebar.properties</parameter> (attribute-set), |
| <parameter>sidebar.title.properties</parameter> (attribute-set) |
| </para> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="SideFloats.html#SidebarFloats">A sidebar as |
| side float</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_funcsynopsis-style"> |
| <refnamediv> |
| <refname>dbfo_funcsynopsis-style</refname> |
| <refpurpose>Specifies presentation style for a funcsynopsis</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo funcsynopsis-style="kr"|"ansi"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">dbfo funcsynopsis-style</tag> PI as a child of |
| a <tag>funcsynopsis</tag> or anywhere within a funcsynopsis |
| to control the presentation style for output of all |
| <tag>funcprototype</tag> instances within that funcsynopsis.</para> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <variablelist> |
| <varlistentry><term>funcsynopsis-style="kr"</term> |
| <listitem> |
| |
| <para>Displays <tag>funcprototype</tag> output in K&R style</para> |
| |
| </listitem> |
| </varlistentry> |
| <varlistentry><term>funcsynopsis-style="ansi"</term> |
| <listitem> |
| |
| <para>Displays <tag>funcprototype</tag> output in ANSI style</para> |
| |
| </listitem> |
| </varlistentry> |
| </variablelist> |
| |
| </refsect1><refsect1 role="params"><title>Related Global Parameters</title> |
| |
| <para><parameter>funcsynopsis.style</parameter></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_glossary-presentation"> |
| <refnamediv> |
| <refname>dbfo_glossary-presentation</refname> |
| <refpurpose>Specifies presentation style for a glossary</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo glossary-presentation="list"|"blocks"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">dbfo glossary-presentation</tag> PI as a child of |
| a <tag>glossary</tag> to control its presentation style.</para> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <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> |
| |
| </refsect1><refsect1 role="params"><title>Related Global Parameters</title> |
| |
| <para><parameter>glossary.as.blocks</parameter></para> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="Glossaries.html#GlossaryFormatPrint">Glossary |
| formatting in print</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_glosslist-presentation"> |
| <refnamediv> |
| <refname>dbfo_glosslist-presentation</refname> |
| <refpurpose>Specifies presentation style for a glosslist</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo glosslist-presentation="list"|"blocks"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">dbfo glosslist-presentation</tag> PI as a child of |
| a <tag>glosslist</tag> to control its presentation style.</para> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <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> |
| |
| </refsect1><refsect1 role="params"><title>Related Global Parameters</title> |
| |
| <para><parameter>glosslist.as.blocks</parameter> </para> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="Glossaries.html#GlossaryFormatPrint">Glossary |
| formatting in print</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_glossterm-width"> |
| <refnamediv> |
| <refname>dbfo_glossterm-width</refname> |
| <refpurpose>Specifies the glossterm width for a glossary or |
| glosslist</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo glossterm-width="<replaceable>width</replaceable>"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">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> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <variablelist> |
| <varlistentry><term>glossterm-width="<replaceable>width</replaceable>"</term> |
| <listitem> |
| |
| <para>Specifies the glossterm width (including units)</para> |
| |
| </listitem> |
| </varlistentry> |
| </variablelist> |
| |
| </refsect1><refsect1 role="params"><title>Related Global Parameters</title> |
| |
| <para><parameter>glossterm.width</parameter>, |
| <parameter>glossterm.separation</parameter> |
| </para> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="Glossaries.html#GlossaryFormatPrint">Glossary |
| formatting in print</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_keep-together"> |
| <refnamediv> |
| <refname>dbfo_keep-together</refname> |
| <refpurpose>Specifies “keep” behavior for a table, example, |
| figure, equation, procedure, or task</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo keep-together="auto"|"always"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">dbfo keep-together</tag> PI as a child of a |
| formal object (<tag>table</tag>, <tag>example</tag>, |
| <tag>figure</tag>, <tag>equation</tag>, <tag>procedure</tag>, or |
| <tag>task</tag>) to specify “keep” behavior (to allow the object to |
| “break” across a page).</para> |
| |
| |
| <para>The PI also works with <tag>informaltable</tag>, <tag>informalexample</tag>, |
| <tag>informalfigure</tag> and <tag>informalequation</tag>. |
| </para> |
| |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <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> |
| |
| </refsect1><refsect1 role="params"><title>Related Global Parameters</title> |
| |
| <para>formal.object.properties</para> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="PageBreaking.html#KeepTogetherPI">Keep-together processing instruction</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_label-width"> |
| <refnamediv> |
| <refname>dbfo_label-width</refname> |
| <refpurpose>Specifies the label width for a qandaset, itemizedlist, orderedlist |
| or calloutlist</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo label-width="<replaceable>width</replaceable>"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">dbfo label-width</tag> PI as a child of a |
| <tag>qandaset</tag>, <tag>itemizedlist</tag>, <tag>orderedlist</tag>, |
| or <tag>calloutlist</tag> to specify the width of labels.</para> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <variablelist> |
| <varlistentry><term>label-width="<replaceable>width</replaceable>"</term> |
| <listitem> |
| |
| <para>Specifies the label width (including units)</para> |
| |
| </listitem> |
| </varlistentry> |
| </variablelist> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="QandAformat.html">Q and A formatting</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_linenumbering.everyNth"> |
| <refnamediv> |
| <refname>dbfo_linenumbering.everyNth</refname> |
| <refpurpose>Specifies interval for line numbers in verbatims</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo linenumbering.everyNth="<replaceable>N</replaceable>"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">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> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <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> |
| |
| </refsect1><refsect1 role="params"><title>Related Global Parameters</title> |
| |
| <para><parameter>linenumbering.everyNth</parameter></para> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="AnnotateListing.html#LineNumbering">Line numbering</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_linenumbering.separator"> |
| <refnamediv> |
| <refname>dbfo_linenumbering.separator</refname> |
| <refpurpose>Specifies separator text for line numbers in verbatims</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo linenumbering.separator="<replaceable>text</replaceable>"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">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> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <variablelist> |
| <varlistentry><term>linenumbering.separator="<replaceable>text</replaceable>"</term> |
| <listitem> |
| |
| <para>Specifies the text (zero or more characters)</para> |
| |
| </listitem> |
| </varlistentry> |
| </variablelist> |
| |
| </refsect1><refsect1 role="params"><title>Related Global Parameters</title> |
| |
| <para><parameter>linenumbering.separator</parameter></para> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="AnnotateListing.html#LineNumbering">Line numbering</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_linenumbering.width"> |
| <refnamediv> |
| <refname>dbfo_linenumbering.width</refname> |
| <refpurpose>Specifies width for line numbers in verbatims</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo linenumbering.width="<replaceable>width</replaceable>"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">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> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <variablelist> |
| <varlistentry><term>linenumbering.width="<replaceable>width</replaceable>"</term> |
| <listitem> |
| |
| <para>Specifies the width (inluding units)</para> |
| |
| </listitem> |
| </varlistentry> |
| </variablelist> |
| |
| </refsect1><refsect1 role="params"><title>Related Global Parameters</title> |
| |
| <para><parameter>linenumbering.width</parameter></para> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="AnnotateListing.html#LineNumbering">Line numbering</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_list-presentation"> |
| <refnamediv> |
| <refname>dbfo_list-presentation</refname> |
| <refpurpose>Specifies presentation style for a variablelist or |
| segmentedlist</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo list-presentation="list"|"blocks"|"table"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">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> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <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> |
| |
| </refsect1><refsect1 role="params"><title>Related Global Parameters</title> |
| |
| <itemizedlist> |
| <listitem> |
| |
| <para><parameter>variablelist.as.blocks</parameter></para> |
| |
| </listitem> |
| <listitem> |
| |
| <para><parameter>variablelist.as.table</parameter></para> |
| |
| </listitem> |
| </itemizedlist> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="Variablelists.html#ListIndents">Variable list formatting in print</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_list-width"> |
| <refnamediv> |
| <refname>dbfo_list-width</refname> |
| <refpurpose>Specifies the width of a horizontal simplelist</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo list-width="<replaceable>width</replaceable>"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">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> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <variablelist> |
| <varlistentry><term>list-width="<replaceable>width</replaceable>"</term> |
| <listitem> |
| |
| <para>Specifies the <tag>simplelist</tag> width (including units)</para> |
| |
| </listitem> |
| </varlistentry> |
| </variablelist> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_orientation"> |
| <refnamediv> |
| <refname>dbfo_orientation</refname> |
| <refpurpose>Specifies the orientation for a CALS table row or cell</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo orientation="0"|"90"|"180"|"270"|"-90"|"-180"|"-270"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">dbfo orientation</tag> PI as a child of a CALS |
| <tag>table</tag> row or cell to specify the orientation |
| (rotation) for the row or cell.</para> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <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> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_pgwide"> |
| <refnamediv> |
| <refname>dbfo_pgwide</refname> |
| <refpurpose>Specifies if an <tag>equation</tag> or <tag>example</tag> goes across full page width</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo pgwide="0"|"1"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">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> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <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> |
| |
| </refsect1><refsect1 role="params"><title>Related Global Parameters</title> |
| |
| <para><parameter>pgwide.properties</parameter></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_rotated-width"> |
| <refnamediv> |
| <refname>dbfo_rotated-width</refname> |
| <refpurpose>Specifies the width for a CALS table <tag>entry</tag> or |
| <tag>row</tag></refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo rotated-width="<replaceable>width</replaceable>"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">dbfo rotated-width</tag> PI as a child of |
| <tag>entry</tag> or <tag>row</tag> instance in a CALS table 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> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <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> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_sidebar-width"> |
| <refnamediv> |
| <refname>dbfo_sidebar-width</refname> |
| <refpurpose>Specifies the width of a sidebar</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo sidebar-width="<replaceable>width</replaceable>"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">dbfo sidebar-width</tag> PI as a child of a |
| <tag>sidebar</tag> to specify the width of the sidebar.</para> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <variablelist> |
| <varlistentry><term>sidebar-width="<replaceable>width</replaceable>"</term> |
| <listitem> |
| |
| <para>Specifies the <tag>sidebar</tag> width (including units)</para> |
| |
| </listitem> |
| </varlistentry> |
| </variablelist> |
| |
| </refsect1><refsect1 role="params"><title>Related Global Parameters</title> |
| |
| <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> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="SideFloats.html#SidebarFloats">A sidebar as |
| side float</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_start"> |
| <refnamediv> |
| <refname>dbfo_start</refname> |
| <refpurpose>(obsolete) Sets the starting number on an ordered list</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo start="<replaceable>character</replaceable>"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <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> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <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> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="Orderedlists.html#ListStartNum">List starting number</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_table-width"> |
| <refnamediv> |
| <refname>dbfo_table-width</refname> |
| <refpurpose>Specifies the width for a CALS table or for revhistory |
| output</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo table-width="<replaceable>width</replaceable>"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">dbfo table-width</tag> PI as a child or |
| sibling of a CALS <tag>table</tag>, or as a child of an |
| <tag>informaltable</tag>, <tag>entrytbl</tag>, or |
| <tag>revhistory</tag> instance (which is rendered as a table |
| in output) to specify the width of the table in output.</para> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <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> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="Tables.html#TableWidth">Table width</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_term-width"> |
| <refnamediv> |
| <refname>dbfo_term-width</refname> |
| <refpurpose>Specifies the term width for a variablelist</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo term-width="<replaceable>width</replaceable>"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">dbfo term-width</tag> PI as a child of a |
| <tag>variablelist</tag> to specify the width for |
| <tag>term</tag> output.</para> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <variablelist> |
| <varlistentry><term>term-width="<replaceable>width</replaceable>"</term> |
| <listitem> |
| |
| <para>Specifies the term width (including units)</para> |
| |
| </listitem> |
| </varlistentry> |
| </variablelist> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="Variablelists.html#ListIndents">Variable list formatting in print</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_toc"> |
| <refnamediv> |
| <refname>dbfo_toc</refname> |
| <refpurpose>Specifies whether a TOC should be generated for a qandaset</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo toc="0"|"1"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">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> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <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> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <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> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo-need"> |
| <refnamediv> |
| <refname>dbfo-need</refname> |
| <refpurpose>Specify a need for space (a kind of soft page break)</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo-need height="<replaceable>n</replaceable>" [space-before="<replaceable>n</replaceable>"]</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <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> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <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> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="PageBreaking.html#SoftPageBreaks">Soft page breaks</link></para> |
| |
| </refsect1></refentry> |
| |
| <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_row-height"> |
| <refnamediv> |
| <refname>dbfo_row-height</refname> |
| <refpurpose>Specifies the height for a CALS table row</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv> |
| |
| <synopsis><tag class="xmlpi">dbfo row-height="<replaceable>height</replaceable>"</tag></synopsis> |
| |
| </refsynopsisdiv> |
| <refsect1><title>Description</title> |
| |
| <para>Use the <tag class="xmlpi">dbfo row-height</tag> PI as a child of a |
| <tag>row</tag> to specify the height of the row.</para> |
| |
| </refsect1><refsect1><title>Parameters</title> |
| |
| <variablelist> |
| <varlistentry><term>row-height="<replaceable>height</replaceable>"</term> |
| <listitem> |
| |
| <para>Specifies the row height (including units)</para> |
| |
| </listitem> |
| </varlistentry> |
| </variablelist> |
| |
| </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title> |
| |
| <para><link role="tcg" xlink:href="RowHeight.html">Row height</link></para> |
| |
| </refsect1></refentry> |
| </reference> |
| |