</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="admon.graphics.extension.frag"><xsl:param name="admon.graphics.extension" select="'.png'"/></src:fragment>
+<src:fragment xml:id="admon.graphics.extension.frag">
+<xsl:param name="admon.graphics.extension">.png</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsection><info><title>Description</title></info>
-<para>Sets the path, probably relative to the directory where the HTML
-files are created, to the admonition graphics.
-</para>
+<para>Sets the path to the directory containing the admonition graphics
+(caution.png, important.png etc). This location is normally relative
+to the output html directory. See <parameter>base.dir</parameter></para>
</refsection>
</refentry>
</refmeta>
<refnamediv>
<refname>admon.style</refname>
-<refpurpose>CSS style attributes for admonitions</refpurpose>
+<refpurpose>Specifies the CSS style attribute that should be added to
+admonitions.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Specifies the value of the <tag class="attribute">STYLE</tag>
+<para>Specifies the value of the CSS <tag class="attribute">style</tag>
attribute that should be added to admonitions.
</para>
<refsection><info><title>Description</title></info>
-<para>If <property>annotation.support</property> is enabled and the
+<para>If <parameter>annotation.support</parameter> is enabled and the
document contains <tag>annotation</tag>s, then the CSS in this
parameter will be included in the document.</para>
<refsynopsisdiv>
<src:fragment xml:id="annotation.graphic.close.frag">
-<xsl:param name="annotation.graphic.close" select="'http://docbook.sourceforge.net/release/images/annot-close.png'"/>
+<xsl:param name="annotation.graphic.close">
+http://docbook.sourceforge.net/release/images/annot-close.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
<para>This image is used on popup annotations as the “x” that the
user can click to dismiss the popup.</para>
+<para>This image is used on popup annotations as the “x” that the user can
+click to dismiss the popup. It may be replaced by a user provided graphic. The size should be approximately 10x10 pixels.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="annotation.graphic.open.frag">
-<xsl:param name="annotation.graphic.open" select="'http://docbook.sourceforge.net/release/images/annot-open.png'"/>
+<xsl:param name="annotation.graphic.open">http://docbook.sourceforge.net/release/images/annot-open.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>This image is used inline to identify the location of
-annotations.</para>
+annotations. The default image is on the docbook site. Users may
+utilise other images. size should be approximately 10x10
+pixels.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="annotation.js.frag">
-<xsl:param name="annotation.js" select="'http://docbook.sourceforge.net/release/script/AnchorPosition.js http://docbook.sourceforge.net/release/script/PopupWindow.js'"/>
+
+<xsl:param name="annotation.js">
+<xsl:text>http://docbook.sourceforge.net/release/script/AnchorPosition.js http://docbook.sourceforge.net/release/script/PopupWindow.js</xsl:text></xsl:param>
+
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="appendix.autolabel.frag">
-<xsl:param name="appendix.autolabel" select="'A'"/>
+<xsl:param name="appendix.autolabel">A</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If zero, then appendices will not be numbered.
-Otherwise appendices will be numbered, using the parameter value
-as the number format if the value matches one of the following:
+<para>If non-zero, then appendices will be numbered using the
+parameter value as the number format if the value matches one of the
+following:
</para>
<variablelist>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="author.othername.in.middle.frag"><xsl:param name="author.othername.in.middle" select="1"/></src:fragment>
+<src:fragment xml:id="author.othername.in.middle.frag">
+<xsl:param name="author.othername.in.middle" select="1"/></src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true (non-zero), the <tag>othername</tag> of an <tag>author</tag>
+<para>If non-zero, the <tag>othername</tag> of an <tag>author</tag>
appears between the <tag>firstname</tag> and
<tag>surname</tag>. Otherwise, <tag>othername</tag>
is suppressed.
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="autotoc.label.separator.frag"><xsl:param name="autotoc.label.separator" select="'. '"/></src:fragment>
+<src:fragment xml:id="autotoc.label.separator.frag">
+<xsl:param name="autotoc.label.separator">. </xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="base.dir.frag"><xsl:param name="base.dir" select="''"/></src:fragment>
+<src:fragment xml:id="base.dir.frag">
+<xsl:param name="base.dir"></xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If specified, the <literal>base.dir</literal> identifies
+<para>If specified, the <parameter>base.dir</parameter> identifies
the output directory for chunks. (If not specified, the output directory
is system dependent.)</para>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="bibliography.collection.frag"><xsl:param name="bibliography.collection" select="'http://docbook.sourceforge.net/release/bibliography/bibliography.xml'"/></src:fragment>
+<src:fragment xml:id="bibliography.collection.frag">
+<xsl:param name="bibliography.collection">http://docbook.sourceforge.net/release/bibliography/bibliography.xml</xsl:param>
+
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
\r
<refsynopsisdiv>\r
<src:fragment xml:id='bibliography.style.frag'>\r
-<xsl:param name="bibliography.style" select="'normal'"/>\r
+<xsl:param name="bibliography.style">normal</xsl:param>\r
</src:fragment>\r
</refsynopsisdiv>\r
\r
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="blurb.on.titlepage.enabled.frag"><xsl:param name="blurb.on.titlepage.enabled">0</xsl:param></src:fragment>
+<src:fragment xml:id="blurb.on.titlepage.enabled.frag">
+<xsl:param name="blurb.on.titlepage.enabled" select="0"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>If non-zero, output from <tag>authorblurb</tag> and
-<tag>personblurb</tag> elements is displayed on title
-pages. If zero (the default), output from those elements is suppressed
-on title pages (unless you are using a titlepage customization that
-causes them to be included).</para>
+<tag>personblurb</tag> elements is displayed on title pages. If zero
+(the default), output from those elements is suppressed on title pages
+(unless you are using a <literal>titlepage</literal> customization
+that causes them to be included).</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="body.bg.color.frag">
-<xsl:param name="body.bg.color" select="'#FFFFFF'"/>
+<xsl:param name="body.bg.color">#FFFFFF</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Specifies the background color used in the body column of tabular slides.</para>
+<para>Specifies the background color used in the body column of
+tabular slides.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="body.end.indent.frag">
-<xsl:param name="body.end.indent" select="'0pt'"/>
+<xsl:param name="body.end.indent">0pt</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="body.font.family.frag">
-<xsl:param name="body.font.family" select="'serif'"/>
+<xsl:param name="body.font.family">serif</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="body.font.size.frag"><xsl:param name="body.font.size">
+<src:fragment xml:id="body.font.size.frag">
+<xsl:param name="body.font.size">
<xsl:value-of select="$body.font.master"/><xsl:text>pt</xsl:text>
</xsl:param></src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="body.margin.bottom.frag">
-<xsl:param name="body.margin.bottom" select="'0.5in'"/>
+<xsl:param name="body.margin.bottom">0.5in</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="body.margin.top.frag">
-<xsl:param name="body.margin.top" select="'0.5in'"/>
+<xsl:param name="body.margin.top">0.5in</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>The body top margin is the distance from the top of the region-before
-to the first line of text in the page body.
-</para>
+<para>The body top margin is the distance from the top of the
+region-before to the first line of text in the page body.</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If non-zero, bridgeheads appear in the TOC. Note that this option
-is not fully supported and may be removed in a future version of the
-stylesheets.
+<para>If non-zero, <tag>bridgehead</tag>s appear in the TOC. Note that
+this option is not fully supported and may be removed in a future
+version of the stylesheets.
</para>
</refsection>
<refsynopsisdiv>
<src:fragment xml:id="bullet.image.frag">
-<xsl:param name="bullet.image" select="'toc/bullet.png'"/>
+<xsl:param name="bullet.image">toc/bullet.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="callout.defaultcolumn.frag"><xsl:param name="callout.defaultcolumn" select="'60'"/></src:fragment>
+<src:fragment xml:id="callout.defaultcolumn.frag">
+<xsl:param name="callout.defaultcolumn">60</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsynopsisdiv>
<src:fragment xml:id="callout.graphics.extension.frag">
-<xsl:param condition="html" name="callout.graphics.extension" select="'.png'"/>
-<xsl:param condition="fo" name="callout.graphics.extension" select="'.svg'"/>
+<xsl:param condition="html" name="callout.graphics.extension">.png</xsl:param>
+<xsl:param condition="fo" name="callout.graphics.extension">.svg</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Sets the file name extension to use on callout graphics.</para>
+<para>Sets the extension to use on callout graphics, hence the callout
+graphic format. The appropriate format (and range used) should be
+available. svg, png and gif are provided.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="callout.graphics.number.limit.frag">
-<xsl:param condition="html" name="callout.graphics.number.limit" select="'15'"/>
-<xsl:param condition="fo" name="callout.graphics.number.limit" select="'30'"/>
+<xsl:param condition="html" name="callout.graphics.number.limit">15</xsl:param>
+<xsl:param condition="fo" name="callout.graphics.number.limit">30</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If <parameter>callout.graphics</parameter>
-is non-zero, graphics are used to represent
-callout numbers. The value of
-<parameter>callout.graphics.number.limit</parameter>
-is
-the largest number for which a graphic exists. If the callout number
-exceeds this limit, the default presentation "(nnn)" will always
-be used.
+<para>If <parameter>callout.graphics</parameter> is non-zero, graphics
+are used to represent callout numbers instead of plain text. The value
+of <parameter>callout.graphics.number.limit</parameter> is the largest
+number for which a graphic exists. If the callout number exceeds this
+limit, the default presentation "(plain text instead of a graphic)"
+will be used.
</para>
</refsection>
<refsynopsisdiv>
<src:fragment xml:id="callout.graphics.path.frag">
-<xsl:param name="callout.graphics.path" select="'images/callouts/'"/>
+<xsl:param name="callout.graphics.path">images/callouts/</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Sets the path, probably relative to the directory where the HTML
-files are created, to the callout graphics.
+<para>Sets the path to the directory holding the callout graphics. his
+location is normally relative to the output html directory. see
+base.dir. Always terminate the directory with / since the graphic file
+is appended to this string, hence needs the separator.
</para>
</refsection>
<refsynopsisdiv>
<src:fragment xml:id="callout.graphics.frag">
-<xsl:param name="callout.graphics" select="'1'"/>
+<xsl:param name="callout.graphics" select="1"/>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="callout.list.table.frag"><xsl:param name="callout.list.table" select="'1'"/></src:fragment>
+<src:fragment xml:id="callout.list.table.frag">
+<xsl:param name="callout.list.table" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="callout.unicode.font.frag"><xsl:param name="callout.unicode.font" select="'ZapfDingbats'"/></src:fragment>
+<src:fragment xml:id="callout.unicode.font.frag">
+<xsl:param name="callout.unicode.font">ZapfDingbats</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="callout.unicode.number.limit.frag"><xsl:param name="callout.unicode.number.limit" select="'10'"/></src:fragment>
+<src:fragment xml:id="callout.unicode.number.limit.frag">
+<xsl:param name="callout.unicode.number.limit">10</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="callout.unicode.start.character.frag"><xsl:param name="callout.unicode.start.character" select="10102"/></src:fragment>
+<src:fragment xml:id="callout.unicode.start.character.frag">
+<xsl:param name="callout.unicode.start.character">10102</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="callouts.extension.frag"><xsl:param name="callouts.extension" select="'1'"/></src:fragment>
+<src:fragment xml:id="callouts.extension.frag">
+<xsl:param name="callouts.extension" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-
+<!-- DP. Note this is not used in the same manner as callout.graphics.extension -->
<para>The callouts extension processes <tag>areaset</tag>
elements in <tag>ProgramListingCO</tag> and other text-based
callout elements.
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="chapter.autolabel.frag"><xsl:param name="chapter.autolabel" select="1"/></src:fragment>
+<src:fragment xml:id="chapter.autolabel.frag">
+<xsl:param name="chapter.autolabel" select="1"/></src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If zero, then chapters will not be numbered.
-Otherwise chapters will be numbered, using the parameter value
-as the number format if the value matches one of the following:
+<para>If non-zero, then chapters will be numbered using the parameter
+value as the number format if the value matches one of the following:
</para>
<variablelist>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="chunk.sections.frag"><xsl:param name="chunk.sections" select="'1'"/></src:fragment>
+<src:fragment xml:id="chunk.sections.frag">
+<xsl:param name="chunk.sections" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsynopsisdiv>
<src:fragment xml:id="chunk.toc.frag">
-<xsl:param name="chunk.toc" select="''"/>
+<xsl:param name="chunk.toc"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refpurpose>List of elements to escape with CDATA sections</refpurpose>
</refnamediv>
+
<refsynopsisdiv>
- <src:fragment xml:id="chunker.output.cdata-section-elements.frag"><xsl:param name="chunker.output.cdata-section-elements" select="''"/></src:fragment>
+<src:fragment xml:id="chunker.output.cdata-section-elements">
+<xsl:param name="chunker.output.cdata-section-elements"></xsl:param>
+</src:fragment>
+
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
- <src:fragment xml:id="chunker.output.doctype-public.frag"><xsl:param name="chunker.output.doctype-public" select="''"/></src:fragment>
+<src:fragment xml:id="chunker.output.doctype-public">
+<xsl:param name="chunker.output.doctype-public"></xsl:param>
+</src:fragment>
+
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refpurpose>System identifier to use for the document type in generated pages</refpurpose>
</refnamediv>
+
<refsynopsisdiv>
- <src:fragment xml:id="chunker.output.doctype-system.frag"><xsl:param name="chunker.output.doctype-system" select="''"/></src:fragment>
+<src:fragment xml:id="chunker.output.doctype-system">
+<xsl:param name="chunker.output.doctype-system"></xsl:param>
+</src:fragment>
+
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
- <src:fragment xml:id="chunker.output.encoding.frag"><xsl:param name="chunker.output.encoding" select="'ISO-8858-1'"/></src:fragment>
+<src:fragment xml:id="chunker.output.encoding">
+<xsl:param name="chunker.output.encoding">ISO-8859-1</xsl:param>
+</src:fragment>
+
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refpurpose>Specification of indentation on generated pages</refpurpose>
</refnamediv>
+
<refsynopsisdiv>
- <src:fragment xml:id="chunker.output.indent.frag"><xsl:param name="chunker.output.indent" select="'no'"/></src:fragment>
+<src:fragment xml:id="chunker.output.indent">
+<xsl:param name="chunker.output.indent">no</xsl:param>
+</src:fragment>
+
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
- <src:fragment xml:id="chunker.output.media-type.frag"><xsl:param name="chunker.output.media-type" select="''"/></src:fragment>
+<src:fragment xml:id="chunker.output.media-type">
+<xsl:param name="chunker.output.media-type"></xsl:param>
+</src:fragment>
+
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
the chunking stylesheet. Not all processors support specification of
this parameter.
</para>
+<para>This parameter specifies the media type that should be used by the
+chunking stylesheet. This should be one from those defined in
+<link xlink:href="http://www.ietf.org/rfc/rfc2045.txt">[RFC2045]</link> and
+ <link xlink:href="http://www.ietf.org/rfc/rfc2046.txt">[RFC2046]</link> </para>
<note>
<para>This parameter is documented here, but the declaration is actually
in the <filename>chunker.xsl</filename> stylesheet module.</para>
+<para>It must be one from html, xml or text</para>
</note>
</refsection>
</refnamediv>
<refsynopsisdiv>
- <src:fragment xml:id="chunker.output.method.frag"><xsl:param name="chunker.output.method" select="'html'"/></src:fragment>
+<src:fragment xml:id="chunker.output.method">
+<xsl:param name="chunker.output.method">html</xsl:param>
+</src:fragment>
+
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
- <src:fragment xml:id="chunker.output.omit-xml-declaration.frag"><xsl:param name="chunker.output.omit-xml-declaration" select="'no'"/></src:fragment>
+<src:fragment xml:id="chunker.output.omit-xml-declaration">
+<xsl:param name="chunker.output.omit-xml-declaration">no</xsl:param>
+</src:fragment>
+
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
- <src:fragment xml:id="chunker.output.standalone.frag"><xsl:param name="chunker.output.standalone" select="'no'"/></src:fragment>
+<src:fragment xml:id="chunker.output.standalone">
+<xsl:param name="chunker.output.standalone">no</xsl:param>
+</src:fragment>
+
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>This parameter specifies the value of the standalone
-specification for generated pages. Not all processors support
+specification for generated pages. It must be either <literal>yes</literal> or <literal>no</literal>. Not all processors support
specification of this parameter.
</para>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="citerefentry.link.frag"><xsl:param name="citerefentry.link" select="'0'"/></src:fragment>
+<src:fragment xml:id="citerefentry.link.frag">
+<xsl:param name="citerefentry.link" select="0"/></src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true, a web link will be generated, presumably
+<para>If non-zero, a web link will be generated, presumably
to an online man->HTML gateway. The text of the link is
-generated by the generate.citerefentry.link template.
+generated by the <literal>generate.citerefentry.link</literal> template.
</para>
</refsection>
collected</refpurpose>
</refnamediv>
<refsynopsisdiv> <src:fragment xml:id="collect.xref.targets.frag">
-<xsl:param name="collect.xref.targets" select="'no'"/>
+<xsl:param name="collect.xref.targets">no</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsynopsisdiv>
<src:fragment xml:id="column.count.index.frag">
-<xsl:param name="column.count.index" select="2"/>
+<xsl:param name="column.count.index">2</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="column.gap.back.frag">
-<xsl:param name="column.gap.back" select="'12pt'"/>
+<xsl:param name="column.gap.back">12pt</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="column.gap.body.frag">
-<xsl:param name="column.gap.body" select="'12pt'"/>
+<xsl:param name="column.gap.body">12pt</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="column.gap.front.frag">
-<xsl:param name="column.gap.front" select="'12pt'"/>
+<xsl:param name="column.gap.front">12pt</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="column.gap.index.frag">
-<xsl:param name="column.gap.index" select="'12pt'"/>
+<xsl:param name="column.gap.index">12pt</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="column.gap.lot.frag">
-<xsl:param name="column.gap.lot" select="'12pt'"/>
+<xsl:param name="column.gap.lot">12pt</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="column.gap.titlepage.frag">
-<xsl:param name="column.gap.titlepage" select="'12pt'"/>
+<xsl:param name="column.gap.titlepage">12pt</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true (non-zero), number labels for chapters, appendices, and other component
-elements are prefixed with the label of the
-part element that contains them.
-So you might see Chapter II.3 instead of Chapter 3.
-Also, the labels for formal elements such as table and figure will
-include the part label.
-If there is no part element container, then no prefix is generated.
+<para>If non-zero, number labels for <tag>chapter</tag>,
+<tag>appendix</tag>, and other component elements are prefixed with
+the label of the part element that contains them. So you might see
+Chapter II.3 instead of Chapter 3. Also, the labels for formal
+elements such as <tag>table</tag> and <tag>figure</tag> will include
+the part label. If there is no part element container, then no prefix
+is generated.
</para>
<para>
This feature is most useful when the
-<literal>label.from.part</literal> parameter is turned on.
-In that case, there would be more than one chapter
+<parameter>label.from.part</parameter> parameter is turned on.
+In that case, there would be more than one <tag>chapter</tag>
<quote>1</quote>, and the extra part label prefix will identify
each chapter unambiguously.
</para>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="crop.mark.bleed.frag"><xsl:param name="crop.mark.bleed" select="'6pt'"/></src:fragment>
+<src:fragment xml:id="crop.mark.bleed.frag">
+<xsl:param name="crop.mark.bleed">6pt</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="crop.mark.offset.frag"><xsl:param name="crop.mark.offset" select="'24pt'"/></src:fragment>
+<src:fragment xml:id="crop.mark.offset.frag">
+<xsl:param name="crop.mark.offset">24pt</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="crop.mark.width.frag"><xsl:param name="crop.mark.width" select="'0.5pt'"/></src:fragment>
+<src:fragment xml:id="crop.mark.width.frag">
+<xsl:param name="crop.mark.width">0.5pt</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="crop.marks.frag"><xsl:param name="crop.marks" select="0"/></src:fragment>
+<src:fragment xml:id="crop.marks.frag">
+<xsl:param name="crop.marks" select="0"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsection><info><title>Description</title></info>
<para>
-If <literal>css.decoration</literal> is turned on, then HTML elements
-produced by the
-stylesheet may be decorated with STYLE attributes. For example, the
-LI tags produced for list items may include a fragment of CSS in the
-STYLE attribute which sets the CSS property "list-style-type".
+If non-zero, then html elements produced by the stylesheet may be
+decorated with <literal>style</literal> attributes. For example, the
+<literal>li</literal> tags produced for list items may include a
+fragment of CSS in the <literal>style</literal> attribute which sets
+the CSS property "list-style-type".
</para>
</refsection>
<refsynopsisdiv>
<src:fragment xml:id="css.stylesheet.dir.frag">
-<xsl:param name="css.stylesheet.dir" select="''"/>
+<xsl:param name="css.stylesheet.dir"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="css.stylesheet.frag">
-<xsl:param name="css.stylesheet" select="'slides.css'"/>
+<xsl:param name="css.stylesheet">slides.css</xsl:param>
</src:fragment>
</refsynopsisdiv>
processed</refpurpose>
</refnamediv>
<refsynopsisdiv> <src:fragment xml:id="current.docid.frag">
-<xsl:param name="current.docid" select="''"/> </src:fragment>
+<xsl:param name="current.docid"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsynopsisdiv>
<src:fragment xml:id="currentpage.marker.frag">
-<xsl:param name="currentpage.marker" select="'@'"/>
+<xsl:param name="currentpage.marker">@</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>FIXME</para>
+<para>Character to use as identifying the current page in </para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>FIXME:</para>
+<para>Selects the direction in which a float should be placed. for
+xsl-fo this is before, for html it is left. For Western texts, the
+before direction is the top of the page.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="default.image.width.frag">
-<xsl:param name="default.image.width" select="''"/>
+<xsl:param name="default.image.width"></xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="default.table.frame.frag"><xsl:param name="default.table.frame" select="'all'"/></src:fragment>
+<src:fragment xml:id="default.table.frame.frag">
+<xsl:param name="default.table.frame">all</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>This value will be used when there is no frame attribute on the table.</para>
+<para>This value will be used when there is no frame attribute on the
+table. </para>
</refsection>
</refentry>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="default.table.width.frag"><xsl:param name="default.table.width" select="''"/></src:fragment>
+<src:fragment xml:id="default.table.width.frag">
+<xsl:param name="default.table.width"></xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If specified, this value will be used for the WIDTH attribute on
-tables that do not specify an alternate width (with the dbhtml processing
-instruction).</para>
+<para>If non-zero, this value will be used for the
+<literal>width</literal> attribute on <tag>table</tag>s that do not specify an
+alternate <width>width</width> (with the dbhtml processing instruction).</para>
</refsection>
</refentry>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="default.units.frag"><xsl:param name="default.units" select="'pt'"/></src:fragment>
+<src:fragment xml:id="default.units.frag">
+<xsl:param name="default.units">pt</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsynopsisdiv>
<src:fragment xml:id="dingbat.font.family.frag">
-<xsl:param name="dingbat.font.family" select="'serif'"/>
+<xsl:param name="dingbat.font.family">serif</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="draft.mode.frag">
-<xsl:param name="draft.mode" select="'maybe'"/>
+<xsl:param name="draft.mode">maybe</xsl:param>
</src:fragment>
</refsynopsisdiv>
as a draft. If it is <quote><literal>no</literal></quote>, the entire document
will be treated as a final copy. If it is <quote><literal>maybe</literal></quote>,
individual sections will be treated as draft or final independently, depending
-on how their <tag class="attribute">status</tag> attribute is set.
+on how their <literal>status</literal> attribute is set.
</para>
</refsection>
<refsynopsisdiv>
<src:fragment xml:id="draft.watermark.image.frag">
-<xsl:param name="draft.watermark.image" select="'http://docbook.sourceforge.net/release/images/draft.png'"/>
+<xsl:param name="draft.watermark.image">http://docbook.sourceforge.net/release/images/draft.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="dry-run.frag">
-<xsl:param name="dry-run" select="'0'"/>
-</src:fragment>
+ <src:fragment xml:id="dry-run">
+ <xsl:param name="dry-run" select="0"/>
+ </src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="ebnf.table.bgcolor.frag"><xsl:param name="ebnf.table.bgcolor" select="'#F5DCB3'"/></src:fragment>
+<src:fragment xml:id="ebnf.table.bgcolor.frag">
+<xsl:param name="ebnf.table.bgcolor" >#F5DCB3</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Sets the background color for EBNF tables. No <tag>bgcolor</tag>
-attribute is output if <varname>ebnf.table.bgcolor</varname> is set to
-the null string. The default value matches the value used in recent
-online versions of the W3C's XML Spec productions.</para>
+<para>Sets the background color for EBNF tables (a pale brown). No
+<tag>bgcolor</tag> attribute is output if
+<parameter>ebnf.table.bgcolor</parameter> is set to the null string. </para>
+
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If non-zero (the default), a localized <emphasis role="bold">Edited by</emphasis> heading is displayed above editor
-names in output of the <tag>editor</tag> element.</para>
+<para>If non-zero, a localized <emphasis role="bold">Edited
+by</emphasis> heading is displayed above editor names in output of the
+<tag>editor</tag> element.</para>
</refsection>
</refentry>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="email.delimiters.enabled.frag"><xsl:param name="email.delimiters.enabled">1</xsl:param></src:fragment>
+<src:fragment xml:id="email.delimiters.enabled.frag">
+<xsl:param name="email.delimiters.enabled" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If non-zero, delimiters<footnote><para>For delimiters, the
+<para>If non-zero, delimiters
+
+<footnote><para>For delimiters, the
stylesheets are currently hard-coded to output angle
-brackets.</para></footnote> are generated around e-mail addresses
+brackets.</para></footnote>
+
+are generated around e-mail addresses
(the output of the <tag>email</tag> element).</para>
</refsection>
<refsection><info><title>Description</title></info>
-<para>If true, the role attribute of <tag>emphasis</tag> elements
-will be passed through to the HTML as a class attribute on a
-<tag>span</tag> that surrounds the emphasis.</para>
+<para>If non-zero, the <literal>role</literal> attribute of
+<literal>emphasis</literal> elements will be passed through to the HTML as a
+class attribute on a <literal>span</literal> that surrounds the
+emphasis.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="filename-prefix.frag">
-<xsl:param name="filename-prefix" select="''"/>
+<xsl:param name="filename-prefix"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true, only <tag>firstterm</tag>s will be automatically linked
+<para>If non-zero, only <tag>firstterm</tag>s will be automatically linked
to the glossary. If glossary linking is not enabled, this parameter
has no effect.</para>
<refsynopsisdiv>
<src:fragment xml:id="foil.title.master.frag">
-<xsl:param name="foil.title.master" select="36"/>
+<xsl:param name="foil.title.master">36</xsl:param>
+<!-- Inconsistant use of point size? -->
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv><src:fragment xml:id="footer.column.widths.frag">
-<xsl:param name="footer.column.widths" select="'1 1 1'"/>
+<xsl:param name="footer.column.widths">1 1 1</xsl:param>
</src:fragment></refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv><src:fragment xml:id="footer.table.height.frag">
-<xsl:param name="footer.table.height" select="'14pt'"/>
+<xsl:param name="footer.table.height" >14pt</xsl:param>
</src:fragment></refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsynopsisdiv>
<src:fragment xml:id="footnote.number.format.frag">
-<xsl:param name="footnote.number.format" select="'1'"/>
+<xsl:param name="footnote.number.format" >1</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="footnote.number.symbols.frag">
-<xsl:param name="footnote.number.symbols" select="''"/>
+<xsl:param name="footnote.number.symbols"></xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="funcsynopsis.decoration.frag"><xsl:param name="funcsynopsis.decoration" select="1"/></src:fragment>
+<src:fragment xml:id="funcsynopsis.decoration.frag">
+<xsl:param name="funcsynopsis.decoration" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true (non-zero), elements of the FuncSynopsis will be decorated (e.g. bold or
-italic). The decoration is controlled by functions that can be redefined
-in a customization layer.
+<para>If non-zero, elements of the <tag>funcsynopsis</tag> will be
+decorated (e.g. bold or italic). The decoration is controlled by
+functions that can be redefined in a customization layer.
</para>
</refsection>
<refsection><info><title>Description</title></info>
-<para>If <varname>funcsynopsis.style</varname> is <literal>ansi</literal>,
+<para>If <parameter>funcsynopsis.style</parameter> is <literal>ansi</literal>,
ANSI-style function synopses are generated for a
<tag>funcsynopsis</tag>, otherwise K&R-style
function synopses are generated.
<refsynopsisdiv>
<src:fragment xml:id="funcsynopsis.tabular.threshold.frag">
-<xsl:param name="funcsynopsis.tabular.threshold" select="40"/>
+<xsl:param name="funcsynopsis.tabular.threshold" >40</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="function.parens.frag"><xsl:param name="function.parens">0</xsl:param></src:fragment>
+<src:fragment xml:id="function.parens.frag">
+<xsl:param name="function.parens" select="0"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If not 0, the formatting of
-a <tag class="starttag">function</tag> element will include
-generated parenthesis.
+<para>If nono-zero, the formatting of a <tag>function</tag> element
+will include generated parenthesis.
</para>
</refsection>
<refsection><info><title>Description</title></info>
<para>If non-zero, document abstracts will be reproduced in the HTML
-<tag>HEAD</tag> with <tag class="starttag">meta name="description" content="..."</tag>.</para>
+<literal>head</literal>, with <literal>>meta name="description" content="..."</literal></para>
+
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
<para>The <parameter>generate.section.toc.level</parameter> parameter
-controls the depth of section in which TOCs will be generated. Note
+controls the depth of <tag>section</tag> in which TOCs will be generated. Note
that this is related to, but not the same as
<parameter>toc.section.depth</parameter>, which controls the depth to
which TOC entries will be generated in a given TOC.</para>
<refsynopsisdiv>
<src:fragment xml:id="glossary.collection.frag">
-<xsl:param name="glossary.collection" select="''"/>
+<xsl:param name="glossary.collection"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="glossentry.show.acronym.frag">
-<xsl:param name="glossentry.show.acronym" select="'no'"/>
+<xsl:param name="glossentry.show.acronym">no</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="glossterm.separation.frag">
-<xsl:param name="glossterm.separation" select="'0.25in'"/>
+<xsl:param name="glossterm.separation" >0.25in</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="glossterm.width.frag">
-<xsl:param name="glossterm.width" select="'2in'"/>
+<xsl:param name="glossterm.width" >2in</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="graphics.dir.frag">
-<xsl:param name="graphics.dir" select="''"/>
+<xsl:param name="graphics.dir"></xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv><src:fragment xml:id="header.column.widths.frag">
-<xsl:param name="header.column.widths" select="'1 1 1'"/>
+<xsl:param name="header.column.widths">1 1 1</xsl:param>
</src:fragment></refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv><src:fragment xml:id="header.table.height.frag">
-<xsl:param name="header.table.height" select="'14pt'"/>
+<xsl:param name="header.table.height">14pt</xsl:param>
</src:fragment></refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsynopsisdiv>
<src:fragment xml:id="hidetoc.image.frag">
-<xsl:param name="hidetoc.image" select="'hidetoc.gif'"/>
+<xsl:param name="hidetoc.image">hidetoc.gif</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="highlight.default.language.frag">
-<xsl:param name="highlight.default.language" select="''"/>
+<xsl:param name="highlight.default.language"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="home.image.frag">
-<xsl:param name="home.image" select="'active/nav-home.png'"/>
+<xsl:param name="home.image">active/nav-home.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="html.base.frag"><xsl:param name="html.base"/></src:fragment>
+<src:fragment xml:id="html.base.frag">
+<xsl:param name="html.base"/></src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If html.base is set, it is used for the <tag>BASE</tag>
-element in the <tag>HEAD</tag> of the HTML documents.
-This is useful for dynamically served HTML where the base URI needs
-to be shifted.</para>
+<para>If html.base is set, it is used for the <tag>base</tag> element
+in the <tag>head</tag> of the html documents. The parameter specifies
+the base URL for all relative URLs in the document. This is useful
+for dynamically served html where the base URI needs to be
+shifted.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="html.cellpadding.frag">
-<xsl:param name="html.cellpadding" select="''"/>
+<xsl:param name="html.cellpadding"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If specified, this value will be used as the default cellpadding value
-in HTML tables.</para>
+<para>If non-zero, this value will be used as the default cellpadding value
+in HTML tables. nn for pixels or nn% for percentage length. E.g. 5 or
+5%</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="html.cellspacing.frag">
-<xsl:param name="html.cellspacing" select="''"/>
+<xsl:param name="html.cellspacing"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If specified, this value will be used as the default cellspacing value
-in HTML tables.</para>
+<para>If non-zero, this value will be used as the default cellspacing
+value in HTML tables. nn for pixels or nn% for percentage
+length. E.g. 5 or 5%</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="html.ext.frag">
-<xsl:param name="html.ext" select="'.html'"/>
+<xsl:param name="html.ext">.html</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>The extension identified by <parameter>html.ext</parameter> will
-be used as the filename extension for chunks created by this stylesheet.
-</para>
+be used as the filename extension for chunks created by this
+stylesheet. </para>
</refsection>
</refentry>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="html.head.legalnotice.link.multiple.frag"><xsl:param name="html.head.legalnotice.link.multiple" select="1"/></src:fragment>
+<src:fragment xml:id="html.head.legalnotice.link.multiple.frag">
+<xsl:param name="html.head.legalnotice.link.multiple" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>If non-zero, links will be created to the
HTML files created for the
-<tag class="attribute">longdesc</tag> attribute. It makes no
+<literal>longdesc</literal> attribute. It makes no
sense to turn enable this option without also enabling the
-<parameter>$html.longdesc</parameter> parameter.</para>
+<parameter>html.longdesc</parameter> parameter.</para>
+<!--
<para>The <literal>longdesc.link</literal> named template is called
to construct the link.</para>
+Assumption. That this documentation is for the user, do they need to know
+how it's done?
+
+-->
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
<para>If non-zero, HTML files will be created for the
-<tag class="attribute">longdesc</tag> attribute. These files
-are created from the <tag>textobject</tag>s in
+<literal>longdesc</literal> attribute. These files
+are created from the <literal>textobject</literal>s in
<tag>mediaobject</tag>s and
<tag>inlinemediaobject</tag>.
</para>
<refsynopsisdiv>
<src:fragment xml:id="html.stylesheet.frag">
-<xsl:param name="html.stylesheet" select="''"/>
+<xsl:param name="html.stylesheet" ></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>The <parameter>html.stylesheet</parameter> parameter is either empty,
-indicating that no stylesheet <tag>LINK</tag> tag should be generated
-in the HTML output, or it is a list of one or more stylesheets.</para>
+<para>The <parameter>html.stylesheet</parameter> parameter is either
+empty, indicating that no stylesheet <tag>link</tag> tag should be
+generated in the html output, or it is a list of one or more
+stylesheet files.</para>
<para>Multiple stylesheets are space-delimited. If you need to
reference a stylesheet URI that includes a space, encode it with
-<literal>%20</literal>. A seprate HTML <tag>LINK</tag> element will
+<literal>%20</literal>. A separate html <literal>link</literal> element will
be generated for each stylesheet in the order they are listed in the
parameter.</para>
<refsynopsisdiv>
<src:fragment xml:id="htmlhelp.alias.file.frag">
-<xsl:param name="htmlhelp.alias.file" select="'alias.h'"/>
+<xsl:param name="htmlhelp.alias.file">alias.h</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If you want to include chapter and section numbers into ToC in
-the left panel, set this parameter to 1.</para>
+<para>Set this to non-zero to include chapter and section numbers into ToC
+in the left panel.</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If you want Back button shown on toolbar, turn this
-parameter to 1.</para>
+<para>Set to non-zero to include the Hide/Show button shown on toolbar</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If you want Forward button shown on toolbar, turn this
-parameter to 1.</para>
+<para>Set to non-zero to include the Forward button on the toolbar.</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If you want Hide/Show button shown on toolbar, turn this
-parameter to 1.</para>
+<para>Set to non-zero to include the Hide/Show button shown on toolbar</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If you want Home button shown on toolbar, turn this
-parameter to 1.</para>
+<para>Set to non-zero to include the Home button on the toolbar.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="htmlhelp.button.jump1.title.frag">
-<xsl:param name="htmlhelp.button.jump1.title" select="'User1'"/>
+<xsl:param name="htmlhelp.button.jump1.title">User1</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If you want Jump1 button shown on toolbar, turn this
-parameter to 1.</para>
+<para>Set to non-zero to include the Jump2 button on the toolbar.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="htmlhelp.button.jump2.title.frag">
-<xsl:param name="htmlhelp.button.jump2.title" select="'User2'"/>
+<xsl:param name="htmlhelp.button.jump2.title">User2</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="htmlhelp.button.jump2.url.frag">
-<xsl:param name="htmlhelp.button.jump2.url"/>
+<xsl:param name="htmlhelp.button.jump2.url"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If you want Jump2 button shown on toolbar, turn this
-parameter to 1.</para>
+<para>Set to non-zero to include the Jump2 button on the toolbar.</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If you want Next button shown on toolbar, turn this
-parameter to 1.</para>
+<para>Set to non-zero to include the Next button on the toolbar.</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If you want Prev button shown on toolbar, turn this
-parameter to 1.</para>
+<para>Set to non-zero to include the Prev button on the toolbar.
+</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If you want Print button shown on toolbar, turn this
-parameter to 1.</para>
+<para>Set to non-zero to include the Print button on the toolbar.
+</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If you want Refresh button shown on toolbar, turn this
-parameter to 1.</para>
+<para>Set to non-zero to include the Stop button on the toolbar.</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If you want Zoom button shown on toolbar, turn this
-parameter to 1.</para>
+<para>Set to non-zero to include the Zoom button on the toolbar.
+</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="htmlhelp.chm.frag">
-<xsl:param name="htmlhelp.chm" select="'htmlhelp.chm'"/>
+<xsl:param name="htmlhelp.chm">htmlhelp.chm</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Change this parameter if you want different name of result
-CHM file than htmlhelp.chm.</para>
+<para>Set the name of resulting CHM file</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="htmlhelp.default.topic.frag">
-<xsl:param name="htmlhelp.default.topic" select="''"/>
+<xsl:param name="htmlhelp.default.topic"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<programlisting><xsl:param name="generate.book.toc" select="0"/>
<xsl:param name="htmlhelp.hhc.show.root" select="0"/>
-<xsl:param name="htmlhelp.default.topic" select="'pr01.html'"/></programlisting>
+<xsl:param name="htmlhelp.default.topic">pr01.html</xsl:param>
+</programlisting>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>You can swith off display of compile progress by setting this
-parameter to 0.</para>
+<para>Set to non-zero to to display compile progress
+</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="htmlhelp.encoding.frag">
-<xsl:param name="htmlhelp.encoding" select="'iso-8859-1'"/>
+<xsl:param name="htmlhelp.encoding">iso-8859-1</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>HTML Help Compiler is not UTF-8 aware, so you should always use
-apropriate single-byte encoding here.</para>
+<para>HTML Help Compiler is not UTF-8 aware, so you should always use an
+appropriate single-byte encoding here. Use one from <link xlink:href="ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets">iana</link>, the registered charset values.</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>When set to 1 this parameter enables enhanced decompilation of CHM.</para>
+<para>When non-zero this parameter enables enhanced decompilation of CHM.</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>You should turn on this flag, if you insert images into your documents
-as external binary entities or if you are using absolute path in image names.</para>
+<para>Set to non-zero if you insert images into your documents as
+external binary entities or if you are using absolute path in image
+names.</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>You should turn on this flag if you have your own
-<filename>alias.h</filename> and <filename>context.h</filename> files
-and you want to include references to them in the project file.</para>
+<para>Set to non-zero if you have your own alias.h and contex.h files and
+you want to include reference to them in project file.</para>
+
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>This parametr controls whether binary TOC will be generated. You
-must create binary TOC if you want to add Prev/Next buttons to toolbar
-(which is default behaviour). Files with binary TOC can't be merged.</para>
+<para>Set to non-zero to generate a binary TOC. You must create a binary TOC
+if you want to add Prev/Next buttons to toolbar (which is default
+behaviour). Files with binary TOC can't be merged.</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>This parameter controls whether there should be folder-like
-icons (1) or book-like icons (0) in ToC. If you want to use
-folder-like icons you must swith off binary ToC using
-<parameter>htmlhelp.hhc.binary</parameter>.</para>
+<para>Set non-zero for folder-like icons or zero for book-like icons in the TOC
+ToC. If you want to use folder-like icons you must swith off binary
+ToC using (xref) <parameter>htmlhelp.hhc.binary</parameter>.
+
+
+
+</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="htmlhelp.hhc.section.depth.frag">
-<xsl:param name="htmlhelp.hhc.section.depth" select="5"/>
+<xsl:param name="htmlhelp.hhc.section.depth">5</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Change this parameter if you want shallower ToC in a left pane
-of HTML Help viewer.</para>
+<para>Set the section depth in the left pane of HTML Help viewer. </para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If set to 0, there will be no entry for root element in
-ToC. This is useful when you want provide user with expanded ToC as
-a default.</para>
+<para>If set to zero, there will be no entry for the root element in
+ToC. This is useful when you want provide the user with an expanded
+ToC as a default.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="htmlhelp.hhc.frag">
-<xsl:param name="htmlhelp.hhc" select="'toc.hhc'"/>
+<xsl:param name="htmlhelp.hhc">toc.hhc</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Change this parameter if you want different name of TOC file
-than toc.hhc.</para>
+<para>Set the name of the TOC file. The default is <filename>toc.hhc</filename>.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="htmlhelp.hhk.frag">
-<xsl:param name="htmlhelp.hhk" select="'index.hhk'"/>
+<xsl:param name="htmlhelp.hhk">index.hhk</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Change this parameter if you want different name of index file
-than index.hhk.</para>
+<para>set the name of the index file. The default is <filename>index.hhk</filename>.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="htmlhelp.hhp.window.frag">
-<xsl:param name="htmlhelp.hhp.window" select="'Main'"/>
+<xsl:param name="htmlhelp.hhp.window">Main</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="htmlhelp.hhp.frag">
-<xsl:param name="htmlhelp.hhp" select="'htmlhelp.hhp'"/>
+<xsl:param name="htmlhelp.hhp">htmlhelp.hhp</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="htmlhelp.map.file.frag">
-<xsl:param name="htmlhelp.map.file" select="'context.h'"/>
+<xsl:param name="htmlhelp.map.file">context.h</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Specifies the filename of the map file (used for context-sensitive help).</para>
+
+<para>Set the name of map file. The default is <filename>alias.h</filename>. (used for context-sensitive help).</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If you want to play with various HTML Help parameters and you
-don't need to regenerate all HTML files, you can set this parameter to
-1. This setting will not process the whole source document; only project files
-(hhp, hhc, hhk,...) will be generated.</para>
+
+<para>Set to non-zero if you want to play with various HTML Help parameters
+and you don't need to regenerate all HTML files. This setting will not
+process whole document, only project files (hhp, hhc, hhk,...) will be
+generated.</para>
+
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>To remember help window position between starts set this
-parameter to 1.</para>
+<para>Set to non-zero to remember help window position between starts.</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If you want favorities tab shown in your help, turn this
-parameter to 1.</para>
+<para>Set to non-zero for advanced search features in your help.</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If you want application menu in your HTML Help file, turn this
-parameter to 1.</para>
+<para>Set to non-zero to have an application menu in your HTML Help file.
+</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>You can switch off display of texts under toolbar buttons by
-setting this parameter to 0.</para>
+<para>Set to non-zero to display texts under toolbar buttons, zero to switch
+off displays.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="htmlhelp.title.frag">
-<xsl:param name="htmlhelp.title" select="''"/>
+<xsl:param name="htmlhelp.title"></xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="hyphenate.verbatim.characters.frag"><xsl:param name="hyphenate.verbatim.characters" select="''"/></src:fragment>
+<src:fragment xml:id="hyphenate.verbatim.characters.frag">
+<xsl:param name="hyphenate.verbatim.characters"></xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsection><info><title>Description</title></info>
-<para>If non-zero, the stylesheet will issue a warning for
-any element (other than the root element) which
-has a title but does not have an ID.</para>
+<para>If non-zero, the stylesheet will issue a warning for any element
+(other than the root element) which has a <tag>title</tag> but does not have an
+ID. The default is to issue such warnings.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="index.method.frag">
-<xsl:param name="index.method" select="'basic'"/>
+<xsl:param name="index.method">basic</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="index.number.separator.frag">
-<xsl:param name="index.number.separator" select="''"/>
+<xsl:param name="index.number.separator"></xsl:param>
</src:fragment>
</refsynopsisdiv>
</refmeta>
<refnamediv>
<refname>index.prefer.titleabbrev</refname>
-<refpurpose>Should be abbreviated titles used as back references</refpurpose>
+<refpurpose>Should abbreviated titles be used as back references</refpurpose>
</refnamediv>
<refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="index.range.separator.frag">
-<xsl:param name="index.range.separator" select="''"/>
+<xsl:param name="index.range.separator"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="index.term.separator.frag">
-<xsl:param name="index.term.separator" select="''"/>
+<xsl:param name="index.term.separator"></xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="inherit.keywords.frag"><xsl:param name="inherit.keywords" select="'1'"/></src:fragment>
+<src:fragment xml:id="inherit.keywords.frag">
+<xsl:param name="inherit.keywords" select="1"/></src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>If <parameter>inherit.keywords</parameter>
-is non-zero, the keyword <tag>META</tag> for each HTML
-<tag>HEAD</tag> element will include all of the keywords from
-ancestral elements. Otherwise, only the keywords from the current section
+is non-zero, the keyword <literal>meta</literal> for each HTML
+<literal>head</literal> element will include all of the keywords from
+ancestor elements. Otherwise, only the keywords from the current section
will be used.
</para>
<refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
</refmeta>
<refnamediv>
-<refname>itemizedlist.label.width</refname>
+ <refname>itemizedlist.label.width</refname>
<refpurpose>The default width of the label (bullet) in an itemized list.</refpurpose>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="itemizedlist.label.width.frag">
-<xsl:param name="itemizedlist.label.width" select="'1.0em'"/>
-</src:fragment>
+ <src:fragment xml:id="itemizedlist.label.width.frag">
+ <xsl:param name="itemizedlist.label.width">1.0em</xsl:param>
+ </src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsection><info><title>Description</title></info>
-<para>If non-zero, relative URIs (in, for example fileref attributes) will
-be used in the generated output. Otherwise, the URIs will be made absolute
-with respect to the base URI.</para>
+<para>If non-zero, relative URIs (in, for example
+<literal>fileref</literal> attributes) will be used in the generated
+output. Otherwise, the URIs will be made absolute with respect to the
+base URI.</para>
<para>Note that the stylesheets calculate (and use) the absolute form
for some purposes, this only applies to the resulting output.</para>
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
- version="5.0" xml:id="l10n.gentext.default.language">
-<refmeta>
-<refentrytitle>l10n.gentext.default.language</refentrytitle>
-<refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
-</refmeta>
-<refnamediv>
-<refname>l10n.gentext.default.language</refname>
-<refpurpose>Sets the default language for generated text</refpurpose>
-</refnamediv>
+ version="5.0"
+ xml:id="l10n.gentext.default.language">
+ <refmeta>
+ <refentrytitle>l10n.gentext.default.language</refentrytitle>
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
+ </refmeta>
+ <refnamediv>
+ <refname>l10n.gentext.default.language</refname>
+ <refpurpose>Sets the default language for generated text</refpurpose>
+ </refnamediv>
-<refsynopsisdiv>
+ <refsynopsisdiv>
<src:fragment xml:id="l10n.gentext.default.language.frag">
-<xsl:param name="l10n.gentext.default.language" select="'en'"/>
+<xsl:param name="l10n.gentext.default.language">en</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="l10n.gentext.language.frag">
-<xsl:param name="l10n.gentext.language" select="''"/>
+<xsl:param name="l10n.gentext.language"></xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="label.from.part.frag"><xsl:param name="label.from.part" select="'0'"/></src:fragment>
+<src:fragment xml:id="label.from.part.frag">
+<xsl:param name="label.from.part" select="0"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsynopsisdiv>
<src:fragment xml:id="line-height.frag">
-<xsl:param name="line-height" select="'normal'"/>
+<xsl:param name="line-height">normal</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="linenumbering.everyNth.frag"><xsl:param name="linenumbering.everyNth" select="'5'"/></src:fragment>
+<src:fragment xml:id="linenumbering.everyNth.frag">
+<xsl:param name="linenumbering.everyNth">5</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If line numbering is enabled, everyNth line will be numbered.
+<para>If line numbering is enabled, everyNth line will be
+numbered. Note that numbering is one based, not zero based.
</para>
</refsection>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="linenumbering.extension.frag"><xsl:param name="linenumbering.extension" select="'1'"/></src:fragment>
+<src:fragment xml:id="linenumbering.extension.frag">
+<xsl:param name="linenumbering.extension" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true, verbatim environments (elements that have the
+<para>If non-zero, verbatim environments (elements that have the
format='linespecific' notation attribute: address, literallayout,
programlisting, screen, synopsis) that specify line numbering will
-have, surprise, line numbers.
+have, line numbers.
</para>
</refsection>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="linenumbering.separator.frag"><xsl:param name="linenumbering.separator" select="' '"/></src:fragment>
+<src:fragment xml:id="linenumbering.separator.frag">
+<xsl:param name="linenumbering.separator"><xsl:text> </xsl:text></xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>The separator is inserted between line numbers and lines in
-the verbatim environment.
+<para>The separator is inserted between line numbers and lines in the
+verbatim environment. The default value is a single white space.
+ Note the interaction with <parameter>linenumbering.width</parameter>
</para>
</refsection>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="linenumbering.width.frag"><xsl:param name="linenumbering.width" select="'3'"/></src:fragment>
+<src:fragment xml:id="linenumbering.width.frag">
+<xsl:param name="linenumbering.width">3</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="link.mailto.url.frag"><xsl:param name="link.mailto.url"/></src:fragment>
+<src:fragment xml:id="link.mailto.url.frag">
+<xsl:param name="link.mailto.url"></xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>If not the empty string, this address will be used for the
-REL=made <tag>LINK</tag> element in the HTML <tag>HEAD</tag>.
+rel=made <literal>link</literal> element in the html <literal>head</literal>
</para>
</refsection>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="make.single.year.ranges.frag"><xsl:param name="make.single.year.ranges" select="0"/></src:fragment>
+<src:fragment xml:id="make.single.year.ranges.frag">
+<xsl:param name="make.single.year.ranges" select="0"/></src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsynopsisdiv>
<src:fragment xml:id="man.charmap.uri.frag">
-<xsl:param name="man.charmap.uri" select="''"/>
+<xsl:param name="man.charmap.uri"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="man.endnotes.list.heading.frag">
-<xsl:param name="man.endnotes.list.heading" select="''"/>
+<xsl:param name="man.endnotes.list.heading"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="man.output.encoding.frag">
-<xsl:param name="man.output.encoding" select="'UTF-8'"/></src:fragment>
+<xsl:param name="man.output.encoding">UTF-8</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
- <src:fragment xml:id="manifest.frag"><xsl:param name="manifest" select="'HTML.manifest'"/></src:fragment>
+ <src:fragment xml:id="manifest.frag">
+ <xsl:param name="manifest" >HTML.manifest</xsl:param>
+ </src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsynopsisdiv>
<src:fragment xml:id="manual.toc.frag">
-<xsl:param name="manual.toc" select="''"/>
+<xsl:param name="manual.toc"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="margin.note.float.type.frag">
-<xsl:param name="margin.note.float.type" select="'none'"/>
+<xsl:param name="margin.note.float.type">none</xsl:param>
</src:fragment>
</refsynopsisdiv>
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
- version="5.0" xml:id="margin.note.title.Properties">
+ version="5.0" xml:id="margin.note.title.properties">
<refmeta>
<refentrytitle>margin.note.title.properties</refentrytitle>
<refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
<refsynopsisdiv>
<src:fragment xml:id="margin.note.width.frag">
-<xsl:param name="margin.note.width" select="'1in'"/>
+<xsl:param name="margin.note.width" >1in</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Sets the default width for margin notes when used as a side float.
-The width determines the degree to which the margin note block intrudes into
-the text area.
+<para>Sets the default width for margin notes when used as a side
+float. The width determines the degree to which the margin note block
+intrudes into the text area.
</para>
<para>If <parameter>margin.note.float.type</parameter> is
<quote><literal>before</literal></quote> or
<refsynopsisdiv>
<src:fragment xml:id="marker.section.level.frag">
-<xsl:param name="marker.section.level" select="2"/>
+<xsl:param name="marker.section.level" >2</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="menuchoice.separator.frag">
-<xsl:param name="menuchoice.separator" select="'+'"/>
+<xsl:param name="menuchoice.separator">+</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="minus.image.frag">
-<xsl:param name="minus.image" select="'toc/open.png'"/>
+<xsl:param name="minus.image">toc/open.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="monospace.font.family.frag">
-<xsl:param name="monospace.font.family" select="'monospace'"/>
+<xsl:param name="monospace.font.family">monospace</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="multiframe.bottom.bgcolor.frag">
-<xsl:param name="multiframe.bottom.bgcolor" select="'white'"/>
+<xsl:param name="multiframe.bottom.bgcolor">white</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="multiframe.navigation.height.frag">
-<xsl:param name="multiframe.navigation.height" select="40"/>
+<xsl:param name="multiframe.navigation.height">40</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Specifies the height of the navigation frames when
+<para>Specifies the height of the navigation frames in pixels when
<link linkend="multiframe">multiframe</link> is enabled.</para>
</refsection>
<refsynopsisdiv>
<src:fragment xml:id="multiframe.top.bgcolor.frag">
-<xsl:param name="multiframe.top.bgcolor" select="'white'"/>
+<xsl:param name="multiframe.top.bgcolor" >white</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="navig.graphics.extension.frag"><xsl:param name="navig.graphics.extension" select="'.gif'"/></src:fragment>
+<src:fragment xml:id="navig.graphics.extension.frag">
+<xsl:param name="navig.graphics.extension">.gif</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="navig.graphics.path.frag"><xsl:param name="navig.graphics.path">images/</xsl:param></src:fragment>
+<src:fragment xml:id="navig.graphics.path.frag">
+<xsl:param name="navig.graphics.path">images/</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="navig.graphics.frag"><xsl:param name="navig.graphics" select="0"/></src:fragment>
+<src:fragment xml:id="navig.graphics.frag">
+<xsl:param name="navig.graphics" select="0"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true (non-zero), the navigational headers and footers in chunked
-HTML are presented in an alternate style that uses
-graphical icons for Next, Previous, Up, and Home.
-Default graphics are provided in the distribution.
+<para>If non-zero, the navigational headers and footers in chunked
+HTML are presented in an alternate style that uses graphical icons for
+Next, Previous, Up, and Home. Default graphics are provided in the
+distribution. If zero, text is used instead of graphics.
</para>
</refsection>
<refsection><info><title>Description</title></info>
-<para>If true (non-zero),
+<para>If non-zero,
the headers and footers of chunked HTML
display the titles of the next and previous chunks,
along with the words 'Next' and 'Previous' (or the
<refsynopsisdiv>
<src:fragment xml:id="next.image.frag">
-<xsl:param name="next.image" select="'active/nav-next.png'"/>
+<xsl:param name="next.image" >active/nav-next.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="no.home.image.frag">
-<xsl:param name="no.home.image" select="'inactive/nav-home.png'"/>
+<xsl:param name="no.home.image">inactive/nav-home.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="no.next.image.frag">
-<xsl:param name="no.next.image" select="'inactive/nav-next.png'"/>
+<xsl:param name="no.next.image">inactive/nav-next.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="no.prev.image.frag">
-<xsl:param name="no.prev.image" select="'inactive/nav-prev.png'"/>
+<xsl:param name="no.prev.image" >inactive/nav-prev.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="no.toc.image.frag">
-<xsl:param name="no.toc.image" select="'inactive/nav-toc.png'"/>
+<xsl:param name="no.toc.image">inactive/nav-toc.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="no.up.image.frag">
-<xsl:param name="no.up.image" select="'inactive/nav-up.png'"/>
+<xsl:param name="no.up.image" >inactive/nav-up.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="nominal.image.width.frag">
-<xsl:param name="nominal.image.width" select="6 * $pixels.per.inch"/>
+<xsl:param name="nominal.image.width">6 * $pixels.per.inch</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="nominal.table.width.frag"><xsl:param name="nominal.table.width" select="'6in'"/></src:fragment>
+<src:fragment xml:id="nominal.table.width.frag">
+<xsl:param name="nominal.table.width">6in</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refpurpose>Base URI used in olink hrefs</refpurpose>
</refnamediv>
<refsynopsisdiv> <src:fragment xml:id="olink.base.uri.frag">
-<xsl:param name="olink.base.uri" select="''"/> </src:fragment>
+<xsl:param name="olink.base.uri"></xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>When cross reference data is collected for resolving olinks, it may be necessary to prepend a base URI to each target's href. This parameter lets you set that base URI when cross reference data is collected. This feature is needed when you want to link to a document that is processed without chunking. The output filename for such a document is not known to the XSL stylesheet; the only target information consists of fragment identifiers such as <literal>#idref</literal>. To enable the resolution of olinks between documents, you should pass the name of the HTML output file as the value of this parameter. Then the hrefs recorded in the cross reference data collection look like <literal>outfile.html#idref</literal>, which can be reached as links from other documents.</para>
+<para>When cross reference data is collected for resolving olinks, it
+may be necessary to prepend a base URI to each target's href. This
+parameter lets you set that base URI when cross reference data is
+collected. This feature is needed when you want to link to a document
+that is processed without chunking. The output filename for such a
+document is not known to the XSL stylesheet; the only target
+information consists of fragment identifiers such as
+<literal>#idref</literal>. To enable the resolution of olinks between
+documents, you should pass the name of the HTML output file as the
+value of this parameter. Then the hrefs recorded in the cross
+reference data collection look like
+<literal>outfile.html#idref</literal>, which can be reached as links
+from other documents.</para>
</refsection>
</refentry>
</refnamediv>
<refsynopsisdiv> <src:fragment xml:id="olink.doctitle.frag">
-<xsl:param name="olink.doctitle" select="'no'"/> </src:fragment>
+<xsl:param name="olink.doctitle">no</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="olink.fragid.frag"><xsl:param name="olink.fragid" select="'fragid='"/></src:fragment>
+<src:fragment xml:id="olink.fragid.frag">
+<xsl:param name="olink.fragid">fragid</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>FIXME:</para>
+<para>The fragment identifier portion of an <tag>olink</tag> target.</para>
</refsection>
</refentry>
</refnamediv>
<refsynopsisdiv> <src:fragment xml:id="olink.lang.fallback.sequence.frag">
-<xsl:param name="olink.lang.fallback.sequence" select="''"/> </src:fragment>
+<xsl:param name="olink.lang.fallback.sequence"></xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="olink.outline.ext.frag"><xsl:param name="olink.outline.ext" select="'.olink'"/></src:fragment>
+<src:fragment xml:id="olink.outline.ext.frag">
+<xsl:param name="olink.outline.ext">.olink</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>FIXME:</para>
+<para>The extension to be expected for OLink outline files</para>
+<para>Bob has this parameter as dead. Please don't use</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>This attribute set is applied to the <tag>fo:basic-link</tag>
-element of an olink. It is not applied to the
-optional page number or
-optional title of the external document.</para>
+<para>This <literal>attribute set</literal> is applied to the
+<literal>fo:basic-link</literal> element of an olink. It is not applied to the
+optional page number or optional title of the external
+document.</para>
</refsection>
</refentry>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="olink.pubid.frag"><xsl:param name="olink.pubid" select="'pubid='"/></src:fragment>
+<src:fragment xml:id="olink.pubid.frag">
+<xsl:param name="olink.pubid">pubid</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>FIXME:</para>
+<para></para>
</refsection>
</refentry>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="olink.resolver.frag"><xsl:param name="olink.resolver" select="'/cgi-bin/olink'"/></src:fragment>
+<src:fragment xml:id="olink.resolver.frag">
+<xsl:param name="olink.resolver" >cgi-bin/olink</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="olink.sysid.frag"><xsl:param name="olink.sysid" select="'sysid='"/></src:fragment>
+<src:fragment xml:id="olink.sysid.frag">
+<xsl:param name="olink.sysid">sysid</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>FIXME:</para>
+<para>FIXME</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="orderedlist.label.width.frag">
-<xsl:param name="orderedlist.label.width" select="'1.2em'"/>
+<xsl:param name="orderedlist.label.width">1.2em</xsl:param>
</src:fragment>
</refsynopsisdiv>
<para>If non-zero, output of the
<tag>othercredit</tag> element on titlepages is displayed in
the same style as <tag>author</tag> and
-<tag>editor</tag> output. If zero (the default),
+<tag>editor</tag> output. If zero then
<tag>othercredit</tag> output is displayed using a style
different than that of <tag>author</tag> and
<tag>editor</tag>.</para>
<refsynopsisdiv>
<src:fragment xml:id="output-root.frag">
-<xsl:param name="output-root" select="'.'"/>
+<xsl:param name="output-root">.</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="output.indent.frag">
-<xsl:param name="output.indent" select="'no'"/>
+<xsl:param name="output.indent" >no</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Specifies the setting of the <parameter>indent</parameter> parameter
-on the HTML slides. For more information, see the discussion of the
-<tag>xsl:output</tag> element in the XSLT specification.</para>
+<para>Specifies the setting of the <parameter>indent</parameter>
+parameter on the HTML slides. For more information, see the discussion
+of the <tag>xsl:output</tag> element in the XSLT specification.</para>
+<para>Select from <literal>yes</literal> or <literal>no</literal>.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="overlay.js.frag">
-<xsl:param name="overlay.js" select="'overlay.js'"/>
+<xsl:param name="overlay.js">overlay.js</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="overlay.logo.frag">
-<xsl:param name="overlay.logo" select="'http://docbook.sourceforge.net/release/buttons/slides-1.png'"/>
+<xsl:param name="overlay.logo">http://docbook.sourceforge.net/release/buttons/slides-1.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="page.margin.bottom.frag">
-<xsl:param name="page.margin.bottom" select="'0.5in'"/>
+<xsl:param name="page.margin.bottom">0.5in</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="page.margin.top.frag">
-<xsl:param name="page.margin.top" select="'0.5in'"/>
+<xsl:param name="page.margin.top">0.5in</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="page.orientation.frag"><xsl:param name="page.orientation" select="'portrait'"/></src:fragment>
+<src:fragment xml:id="page.orientation.frag">
+<xsl:param name="page.orientation">portrait</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>In portrait orientation, the short edge is horizontal; in
+<para> Select one from portrait or landscape.
+In portrait orientation, the short edge is horizontal; in
landscape orientation, it is vertical.
</para>
<refsynopsisdiv>
<src:fragment xml:id="pages.template.frag">
-<xsl:param name="pages.template" select="''"/>
+<xsl:param name="pages.template"></xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="paper.type.frag"><xsl:param name="paper.type" select="'USletter'"/></src:fragment>
+<src:fragment xml:id="paper.type.frag">
+<xsl:param name="paper.type">USletter</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>The paper type is a convenient way to specify the paper size.
The list of known paper sizes includes USletter and most of the A,
-B, and C sizes. See <literal>page.width.portrait</literal>, for example.
+B, and C sizes. See <parameter>page.width.portrait</parameter>, for example.
+
+
</para>
</refsection>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="part.autolabel.frag"><xsl:param name="part.autolabel" select="'I'"/></src:fragment>
+<src:fragment xml:id="part.autolabel.frag">
+<xsl:param name="part.autolabel">I</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If zero, then parts will not be numbered.
-Otherwise parts will be numbered, using the parameter value
-as the number format if the value matches one of the following:
+<para>If non-zero, then parts will be numbered using the parameter
+value as the number format if the value matches one of the following:
</para>
<variablelist>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="phrase.propagates.style.frag"><xsl:param name="phrase.propagates.style" select="1"/></src:fragment>
+<src:fragment xml:id="phrase.propagates.style.frag">
+<xsl:param name="phrase.propagates.style" select="1"/></src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true, the role attribute of <tag>phrase</tag> elements
-will be passed through to the HTML as a class attribute on a
-<tag>span</tag> that surrounds the phrase.</para>
+<para>If non-zero, the role attribute of <tag>phrase</tag> elements
+will be passed through to the HTML as a <literal>class</literal>
+attribute on a <literal>span</literal> that surrounds the
+phrase.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="pixels.per.inch.frag">
-<xsl:param name="pixels.per.inch" select="90"/>
+<xsl:param name="pixels.per.inch">90</xsl:param>
</src:fragment>
</refsynopsisdiv>
<para>When lengths are converted to pixels, this value is used to
determine the size of a pixel. The default value is taken from the
-<link xlink:href="http://www.w3.org/TR/xsl/slice5.html#pixels">XSL
+<link xlink:href="http://www.w3.org/TR/2004/WD-xsl11-20041216/">XSL
Recommendation</link>.
</para>
<refsynopsisdiv>
<src:fragment xml:id="plus.image.frag">
-<xsl:param name="plus.image" select="'toc/closed.png'"/>
+<xsl:param name="plus.image">toc/closed.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="points.per.em.frag">
-<xsl:param name="points.per.em" select="10"/>
+<xsl:param name="points.per.em">10</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>FIXME:</para>
+<para>The fixed value used for calculations based upon the size of a
+character. The assumption made is that ten point font is in use. This
+assumption may not be valid.</para>
</refsection>
</refentry>
<refsection><info><title>Description</title></info>
-<para>If zero (default), then prefaces will not be numbered.
-Otherwise prefaces will be numbered, using the parameter value
-as the number format if the value matches one of the following:
+<para>If non-zero then prefaces will be numbered using the parameter
+value as the number format if the value matches one of the following:
</para>
<variablelist>
<refsection><info><title>Description</title></info>
<para>A mediaobject may contain several objects such as imageobjects.
-If the parameter <parameter>use.role.for.mediaobject</parameter>
-is non-zero, then the <tag class="attribute">role</tag> attribute on
-<tag>imageobject</tag>s and other objects within a <tag>mediaobject</tag> container will be used to select which object will be
-used. If one of the objects has a role value that matches the
-preferred.mediaobject.role parameter, then it has first
-priority for selection. If more than one has such a
-role value, the first one is used.
+If the parameter <parameter>use.role.for.mediaobject</parameter> is
+non-zero, then the <literal>role</literal> attribute on
+<tag>imageobject</tag>s and other objects within a
+<tag>mediaobject</tag> container will be used to select which object
+will be used. If one of the objects has a role value that matches the
+<parameter>preferred.mediaobject.role</parameter> parameter, then it
+has first priority for selection. If more than one has such a role
+value, the first one is used.
</para>
<para>
See the <parameter>use.role.for.mediaobject</parameter> parameter
<refsynopsisdiv>
<src:fragment xml:id="prev.image.frag">
-<xsl:param name="prev.image" select="'active/nav-prev.png'"/>
+<xsl:param name="prev.image">active/nav-prev.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Specifies that if an empty <tag>toc</tag> element is
-found in a source document, an automated TOC is generated.
+<para>Specifies that if an empty <tag>toc</tag> element is found in a
+source document, an automated TOC is generated at this point in the
+document.
<note>
<para>Depending on what the value of the
<parameter>generate.toc</parameter> parameter is, setting this
<refsynopsisdiv>
<src:fragment xml:id="profile.arch.frag">
-<xsl:param name="profile.arch" select="''"/>
+<xsl:param name="profile.arch"></xsl:param>
</src:fragment>
</refsynopsisdiv>
+
<refsection><info><title>Description</title></info>
-<para>Value of this parameter specifies profiles which should be
+<para>The value of this parameter specifies profiles which should be
included in the output. You can specify multiple profiles by
separating them by semicolon. You can change separator character by
<parameter>profile.separator</parameter>
<refsynopsisdiv>
<src:fragment xml:id="profile.attribute.frag">
-<xsl:param name="profile.attribute" select="''"/>
+<xsl:param name="profile.attribute"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="profile.audience.frag">
-<xsl:param name="profile.audience" select="''"/>
+<xsl:param name="profile.audience"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="profile.condition.frag">
-<xsl:param name="profile.condition" select="''"/>
+<xsl:param name="profile.condition"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Value of this parameter specifies profiles which should be
+<para>The value of this parameter specifies profiles which should be
included in the output. You can specify multiple profiles by
separating them by semicolon. You can change separator character by
<parameter>profile.separator</parameter>
<refsynopsisdiv>
<src:fragment xml:id="profile.conformance.frag">
-<xsl:param name="profile.conformance" select="''"/>
+<xsl:param name="profile.conformance"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Value of this parameter specifies profiles which should be
+<para>The value of this parameter specifies profiles which should be
included in the output. You can specify multiple profiles by
separating them by semicolon. You can change separator character by
<parameter>profile.separator</parameter>
<refsynopsisdiv>
<src:fragment xml:id="profile.lang.frag">
-<xsl:param name="profile.lang" select="''"/>
+<xsl:param name="profile.lang"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Value of this parameter specifies profiles which should be
+<para>The value of this parameter specifies profiles which should be
included in the output. You can specify multiple profiles by
separating them by semicolon. You can change separator character by
<parameter>profile.separator</parameter>
<refsynopsisdiv>
<src:fragment xml:id="profile.os.frag">
-<xsl:param name="profile.os" select="''"/>
+<xsl:param name="profile.os"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Value of this parameter specifies profiles which should be
+<para>The value of this parameter specifies profiles which should be
included in the output. You can specify multiple profiles by
separating them by semicolon. You can change separator character by
<parameter>profile.separator</parameter>
<refsynopsisdiv>
<src:fragment xml:id="profile.revision.frag">
-<xsl:param name="profile.revision" select="''"/>
+<xsl:param name="profile.revision" ></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Value of this parameter specifies profiles which should be
+<para>The value of this parameter specifies profiles which should be
included in the output. You can specify multiple profiles by
separating them by semicolon. You can change separator character by
<parameter>profile.separator</parameter>
<refsynopsisdiv>
<src:fragment xml:id="profile.revisionflag.frag">
-<xsl:param name="profile.revisionflag" select="''"/>
+<xsl:param name="profile.revisionflag"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Value of this parameter specifies profiles which should be
+<para>The value of this parameter specifies profiles which should be
included in the output. You can specify multiple profiles by
separating them by semicolon. You can change separator character by
<parameter>profile.separator</parameter>
<refsynopsisdiv>
<src:fragment xml:id="profile.role.frag">
-<xsl:param name="profile.role" select="''"/>
+<xsl:param name="profile.role"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Value of this parameter specifies profiles which should be
+<para>The value of this parameter specifies profiles which should be
included in the output. You can specify multiple profiles by
separating them by semicolon. You can change separator character by
<parameter>profile.separator</parameter>
<refsynopsisdiv>
<src:fragment xml:id="profile.security.frag">
-<xsl:param name="profile.security" select="''"/>
+<xsl:param name="profile.security"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Value of this parameter specifies profiles which should be
+<para>The value of this parameter specifies profiles which should be
included in the output. You can specify multiple profiles by
separating them by semicolon. You can change separator character by
<parameter>profile.separator</parameter>
<refsynopsisdiv>
<src:fragment xml:id="profile.separator.frag">
-<xsl:param name="profile.separator" select="';'"/>
+<xsl:param name="profile.separator">;</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Separator character for compound profile values.</para>
+<para>Separator character used for compound profile values. See <parameter>profile.arch</parameter></para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="profile.status.frag">
-<xsl:param name="profile.status" select="''"/>
+<xsl:param name="profile.status"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Value of this parameter specifies profiles which should be
+<para>The value of this parameter specifies profiles which should be
included in the output. You can specify multiple profiles by
separating them by semicolon. You can change separator character by
<parameter>profile.separator</parameter>
<refsynopsisdiv>
<src:fragment xml:id="profile.userlevel.frag">
-<xsl:param name="profile.userlevel" select="''"/>
+<xsl:param name="profile.userlevel"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Value of this parameter specifies profiles which should be
+<para>The value of this parameter specifies profiles which should be
included in the output. You can specify multiple profiles by
separating them by semicolon. You can change separator character by
<parameter>profile.separator</parameter>
<refsynopsisdiv>
<src:fragment xml:id="profile.value.frag">
-<xsl:param name="profile.value" select="''"/>
+<xsl:param name="profile.value"></xsl:param>
</src:fragment>
</refsynopsisdiv>
profiling attribute with parameter
<parameter>profile.attribute</parameter>.</para>
-<para>Value of this parameter specifies profiles which should be
+<para>The value of this parameter specifies profiles which should be
included in the output. You can specify multiple profiles by
separating them by semicolon. You can change separator character by
<parameter>profile.separator</parameter>
<refsynopsisdiv>
<src:fragment xml:id="profile.vendor.frag">
-<xsl:param name="profile.vendor" select="''"/>
+<xsl:param name="profile.vendor"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Value of this parameter specifies profiles which should be
+<para>The value of this parameter specifies profiles which should be
included in the output. You can specify multiple profiles by
separating them by semicolon. You can change separator character by
<parameter>profile.separator</parameter>
<refsynopsisdiv>
<src:fragment xml:id="profile.wordsize.frag">
-<xsl:param name="profile.wordsize" select="''"/>
+<xsl:param name="profile.wordsize"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Value of this parameter specifies profiles which should be
+<para>The value of this parameter specifies profiles which should be
included in the output. You can specify multiple profiles by
separating them by semicolon. You can change separator character by
<parameter>profile.separator</parameter>
<refsynopsisdiv>
<src:fragment xml:id="punct.honorific.frag">
-<xsl:param name="punct.honorific" select="'.'"/>
+<xsl:param name="punct.honorific">.</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="qanda.defaultlabel.frag"><xsl:param name="qanda.defaultlabel">number</xsl:param></src:fragment>
+<src:fragment xml:id="qanda.defaultlabel.frag">
+<xsl:param name="qanda.defaultlabel">number</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If no defaultlabel attribute is specified on a QandASet, this
-value is used. It must be one of the legal values for the defaultlabel
-attribute.
+<para>If no <literal>defaultlabel</literal> attribute is specified on
+a <tag>qandaset</tag>, this value is used. It must be one of the legal
+values for the defaultlabel attribute, one from none, number or
+qanda. The default value is 'number'.
</para>
+<para>Meaning</para>
+<para>qanda - <tag>question</tag>s are labeled “Q:” and <tag>answer</tag>s are labeled “A:”. </para>
+<para>number - The entries are enumerated. </para>
+<para>none - No distinguishing label precedes Questions or Answers.
+
+</para>
+
+
+
+
</refsection>
</refentry>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="qanda.inherit.numeration.frag"><xsl:param name="qanda.inherit.numeration" select="1"/></src:fragment>
+<src:fragment xml:id="qanda.inherit.numeration.frag">
+<xsl:param name="qanda.inherit.numeration" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true (non-zero), numbered QandADiv elements and Questions and Answers inherit
-the numeration of the ancestors of the QandASet.
+<para>If non-zero, numbered <tag>qandadiv</tag> elements and
+<tag>question</tag> and <tag>answer</tag> inherit the enumeration of
+the ancestors of the <tag>qandaset</tag>.
</para>
</refsection>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="qanda.nested.in.toc.frag"><xsl:param name="qanda.nested.in.toc" select="0"/></src:fragment>
+<src:fragment xml:id="qanda.nested.in.toc.frag">
+<xsl:param name="qanda.nested.in.toc" select="0"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true (non-zero), instances of <tag>qandaentry</tag>
+<para>If non-zero, instances of <tag>qandaentry</tag>
that are children of <tag>answer</tag> elements are shown in
the TOC.</para>
<refsection><info><title>Description</title></info>
-<para>If true (non-zero), unlabeled qandadivs will be enumerated.
+<para>If non-zero, unlabeled qandadivs will be enumerated.
</para>
</refsection>
<refsynopsisdiv>
<src:fragment xml:id="rebuild-all.frag">
-<xsl:param name="rebuild-all" select="'0'"/>
+<xsl:param name="rebuild-all" select="0"/>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="refentry.generate.name.frag"><xsl:param name="refentry.generate.name" select="1"/></src:fragment>
+<src:fragment xml:id="refentry.generate.name.frag">
+<xsl:param name="refentry.generate.name" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true (non-zero), a "NAME" section title is output before the list
+<para>If non-zero, a "NAME" section title is output before the list
of 'RefName's. This parameter and
<parameter>refentry.generate.title</parameter> are mutually
exclusive. This means that if you change this parameter to zero, you
-should set <parameter>refentry.generate.title</parameter> to 1 unless
+should set <parameter>refentry.generate.title</parameter> to non-zero unless
you want get quite strange output.
</para>
<refsection><info><title>Description</title></info>
-<para>If true (non-zero), the reference page title or first name is
+<para>If non-zero, the reference page title or first name is
output before the list of 'RefName's. This parameter and
<parameter>refentry.generate.name</parameter> are mutually exclusive.
-This means that if you change this parameter to 1, you
-should set <parameter>refentry.generate.name</parameter> to 0 unless
+This means that if you change this parameter to non-zero, you
+should set <parameter>refentry.generate.name</parameter> to zero unless
you want get quite strange output.</para>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="refentry.separator.frag"><xsl:param name="refentry.separator" select="'1'"/></src:fragment>
+<src:fragment xml:id="refentry.separator.frag">
+<xsl:param name="refentry.separator" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="refentry.xref.manvolnum.frag"><xsl:param name="refentry.xref.manvolnum" select="1"/></src:fragment>
+<src:fragment xml:id="refentry.xref.manvolnum.frag">
+<xsl:param name="refentry.xref.manvolnum" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>if true (non-zero), the <tag>manvolnum</tag> is used when cross-referencing
+<para>if non-zero, the <tag>manvolnum</tag> is used when cross-referencing
<tag>refentry</tag>s, either with <tag>xref</tag>
or <tag>citerefentry</tag>.
</para>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="reference.autolabel.frag"><xsl:param name="reference.autolabel" select="'I'"/></src:fragment>
+<src:fragment xml:id="reference.autolabel.frag">
+ <xsl:param name="reference.autolabel">I</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If zero, then references will not be numbered.
+<para>If non-zero, then references will not be numbered.
Otherwise references will be numbered, using the parameter value
as the number format if the value matches one of the following:
</para>
<refsynopsisdiv>
<src:fragment xml:id="region.after.extent.frag">
-<xsl:param name="region.after.extent" select="'0.4in'"/>
+<xsl:param name="region.after.extent">0.4in</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="region.before.extent.frag">
-<xsl:param name="region.before.extent" select="'0.4in'"/>
+<xsl:param name="region.before.extent">0.4in</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="root.filename.frag"><xsl:param name="root.filename" select="'index'"/></src:fragment>
+<src:fragment xml:id="root.filename.frag">
+<xsl:param name="root.filename">index</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="rootid.frag"><xsl:param name="rootid" select="''"/></src:fragment>
+<src:fragment xml:id="rootid.frag">
+<xsl:param name="rootid" ></xsl:param></src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If <parameter>rootid</parameter> is specified, it must be the
+<para>If <parameter>rootid</parameter> is not empty, it must be the
value of an ID that occurs in the document being formatted. The entire
document will be loaded and parsed, but formatting will begin at the
element identified, rather than at the root. For example, this allows
-you to process only chapter 4 of a book.</para>
+you to process only <tag>chapter</tag> 4 of a <tag>book</tag>.</para>
<para>Because the entire document is available to the processor, automatic
numbering, cross references, and other dependencies are correctly
resolved.</para>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="runinhead.default.title.end.punct.frag"><xsl:param name="runinhead.default.title.end.punct" select="'.'"/></src:fragment>
+<src:fragment xml:id="runinhead.default.title.end.punct.frag"><xsl:param name="runinhead.default.title.end.punct">.</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>FIXME:
-</para>
+<para>If non-zero, For a <tag>formalpara</tag>, use the specified
+string as the separator between the title and following text. The period is the default value.</para>
</refsection>
</refentry>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="runinhead.title.end.punct.frag"><xsl:param name="runinhead.title.end.punct" select="'.!?:'"/></src:fragment>
+<src:fragment xml:id="runinhead.title.end.punct.frag">
+<xsl:param name="runinhead.title.end.punct">.!?:</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>FIXME:
+<para>Specify which characters are to be counted as punctuation. These
+characters are checked for a match with the last character of the
+title. If no match is found, the
+<parameter>runinhead.default.title.end.punct</parameter> contents are
+inserted. This is to avoid duplicated punctuation in the output.
</para>
</refsection>
<refsynopsisdiv>
<src:fragment xml:id="sans.font.family.frag">
-<xsl:param name="sans.font.family" select="'sans-serif'"/>
+<xsl:param name="sans.font.family" >sans-serif</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="saxon.callouts.frag"><xsl:param name="saxon.callouts" select="'1'"/></src:fragment>
+<src:fragment xml:id="saxon.callouts.frag">
+<xsl:param name="saxon.callouts" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="saxon.linenumbering.frag"><xsl:param name="saxon.linenumbering" select="'1'"/></src:fragment>
+<src:fragment xml:id="saxon.linenumbering.frag">
+<xsl:param name="saxon.linenumbering" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true, verbatim environments (elements that have the
-format='linespecific' notation attribute: address, literallayout,
-programlisting, screen, synopsis) that specify line numbering will
-have, surprise, line numbers.
+<para>If non-zero, verbatim environments (elements that have the
+format='linespecific' notation attribute: <tag>address</tag>,
+<tag>literallayout</tag>, <tag>programlisting</tag>,
+<tag>screen</tag>, <tag>synopsis</tag>) that specify line numbering
+will have line numbers.
</para>
</refsection>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="saxon.tablecolumns.frag"><xsl:param name="saxon.tablecolumns" select="'1'"/></src:fragment>
+<src:fragment xml:id="saxon.tablecolumns.frag">
+<xsl:param name="saxon.tablecolumns" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsynopsisdiv>
<src:fragment xml:id="script.dir.frag">
-<xsl:param name="script.dir" select="''"/>
+<xsl:param name="script.dir"></xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="section.autolabel.max.depth.frag"><xsl:param name="section.autolabel.max.depth" select="8"/></src:fragment>
+<src:fragment xml:id="section.autolabel.max.depth.frag">
+<xsl:param name="section.autolabel.max.depth">8</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>When section numbering is turned on by the
-<literal>section.autolabel</literal> parameter,
-then this parameter controls the depth of section nesting
-that is numbered.
-Sections nested to a level deeper than this value will
-not be numbered.
+<parameter>section.autolabel</parameter> parameter, then this
+parameter controls the depth of <tag>section</tag> nesting that is
+numbered. Sections nested to a level deeper than this value will not
+be numbered.
</para>
</refsection>
<refsynopsisdiv>
<src:fragment xml:id="section.container.element.frag">
-<xsl:param name="section.container.element" select="'block'"/>
+<xsl:param name="section.container.element">block</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true (non-zero), section labels are prefixed with the label of the
+<para>If non-zero, section labels are prefixed with the label of the
component that contains them.
</para>
<refsynopsisdiv>
<src:fragment xml:id="sequential.links.frag">
-<xsl:param name="sequential.links" select="'0'"/>
+<xsl:param name="sequential.links" select="0"/>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>FIXME:</para>
+<para>Properties that specify the style of shaded verbatim listings. The
+parameters specified (the border and background color) are added to
+the styling of the xsl-fo output. A border might be specified as "thin
+black solid" for example. See <link xlink:href="http://www.w3.org/TR/2004/WD-xsl11-20041216/#border">xsl-fo</link></para>
</refsection>
</refentry>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="show.comments.frag"><xsl:param name="show.comments">1</xsl:param></src:fragment>
+<src:fragment xml:id="show.comments.frag">
+<xsl:param name="show.comments" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true (non-zero), comments will be displayed, otherwise they are suppressed.
-Comments here refers to the <tag>remark</tag> element (which was called <tag role="obsolete">comment</tag> prior to
-DocBook 4.0), not XML comments (<-- like this -->) which are unavailable.
+<para>If non-zero, comments will be displayed, otherwise they
+are suppressed. Comments here refers to the <tag>remark</tag> element
+(which was called <literal>comment</literal> prior to DocBook
+4.0), not XML comments (<-- like this -->) which are
+unavailable.
</para>
</refsection>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="show.revisionflag.frag"><xsl:param name="show.revisionflag">0</xsl:param></src:fragment>
+<src:fragment xml:id="show.revisionflag.frag">
+<xsl:param name="show.revisionflag" select="0"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>
-If <literal>show.revisionflag</literal> is turned on, then the stylesheets
+If <parameter>show.revisionflag</parameter> is turned on, then the stylesheets
may produce additional markup designed to allow a CSS stylesheet to
highlight elements that have specific revisionflag settings.</para>
-<para>The markup inserted will be usually be either a <span> or <div>
-with an appropriate <literal>class</literal> attribute. (The value of
-the class attribute will be the same as the value of the revisionflag
-attribute). In some contexts, for example tables, where extra markup
-would be structurally illegal, the class attribute will be added to the
-appropriate container element.</para>
+<para>The markup inserted will be usually be either a <span> or
+<div> with an appropriate <literal>class</literal>
+attribute. (The value of the class attribute will be the same as the
+value of the revisionflag attribute). In some contexts, for example
+tables, where extra markup would be structurally illegal, the class
+attribute will be added to the appropriate container element.</para>
<para>In general, the stylesheets only test for revisionflag in contexts
where an importing stylesheet would have to redefine whole templates.
<refsynopsisdiv>
<src:fragment xml:id="showtoc.image.frag">
-<xsl:param name="showtoc.image" select="'showtoc.gif'"/>
+<xsl:param name="showtoc.image">showtoc.gif</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="sidebar.float.type.frag">
-<xsl:param name="sidebar.float.type" select="'none'"/>
+<xsl:param name="sidebar.float.type">none</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="sidebar.float.width.frag">
-<xsl:param name="sidebar.float.width" select="'1in'"/>
+<xsl:param name="sidebar.float.width">1in</xsl:param>
</src:fragment>
</refsynopsisdiv>
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
- version="5.0" xml:id="sidebar.title.Properties">
+ version="5.0" xml:id="sidebar.title.properties">
<refmeta>
<refentrytitle>sidebar.title.properties</refentrytitle>
<refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
<refsection><info><title>Description</title></info>
-<para>If non-zero, <tag>simplesect</tag>s appear in the TOC.
+<para>If non-zero, <tag>simplesect</tag>s will be included in the TOC.
</para>
</refsection>
<refsynopsisdiv>
<src:fragment xml:id="slide.font.family.frag">
-<xsl:param name="slide.font.family" select="'Helvetica'"/>
+<xsl:param name="slide.font.family" >Helvetica</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="slide.title.font.family.frag">
-<xsl:param name="slide.title.font.family" select="'Helvetica'"/>
+<xsl:param name="slide.title.font.family">Helvetica</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="slides.js.frag">
-<xsl:param name="slides.js" select="'slides.js'"/>
+<xsl:param name="slides.js" >slides.js</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="spacing.paras.frag"><xsl:param name="spacing.paras" select="'0'"/></src:fragment>
+<src:fragment xml:id="spacing.paras.frag">
+<xsl:param name="spacing.paras" select="0"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsection><info><title>Description</title></info>
<para>
-If <literal>suppress.footer.navigation</literal> is turned on, footer
-navigation will be suppressed.</para>
+If non-zero, footer navigation will be suppressed.</para>
</refsection>
</refentry>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="suppress.header.navigation.frag"><xsl:param name="suppress.header.navigation">0</xsl:param></src:fragment>
+<src:fragment xml:id="suppress.header.navigation.frag">
+<xsl:param name="suppress.header.navigation" select="0"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>
-If <literal>suppress.header.navigation</literal> is turned on, header
-navigation will be suppressed.</para>
+<para>If non-zero, header navigation will be suppressed.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="suppress.homepage.title.frag">
-<xsl:param name="suppress.homepage.title" select="'1'"/>
+<xsl:param name="suppress.homepage.title" select="1"/>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="suppress.navigation.frag"><xsl:param name="suppress.navigation">0</xsl:param></src:fragment>
+<src:fragment xml:id="suppress.navigation.frag">
+<xsl:param name="suppress.navigation" select="0"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>
-If <literal>suppress.navigation</literal> is turned on, header and
-footer navigation will be suppressed.</para>
+If non-zero, header and footer navigation will be suppressed.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="symbol.font.family.frag">
-<xsl:param name="symbol.font.family" select="'Symbol,ZapfDingbats'"/>
+<xsl:param name="symbol.font.family">Symbol,ZapfDingbats</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If true (non-zero), CSS will be used to draw table borders.
+<para>If non-zero, CSS will be used to draw table borders.
</para>
</refsection>
<refsynopsisdiv>
<src:fragment xml:id="table.cell.border.color.frag">
-<xsl:param condition="html" name="table.cell.border.color" select="''"/>
-<xsl:param condition="fo" name="table.cell.border.color" select="'black'"/>
+<xsl:param condition="html" name="table.cell.border.color"></xsl:param>
+<xsl:param condition="fo" name="table.cell.border.color">black</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>FIXME:</para>
+<para>Set the color of table borders. If non-zero, the value is used
+for the border coloration. See <link
+xlink:href="http://www.w3.org/TR/CSS21/syndata.html#value-def-color">CSS</link>. A
+<literal>color</literal> is either a keyword or a numerical RGB specification.
+keywords are aqua, black, blue, fuchsia, gray, green, lime, maroon,
+navy, olive, orange, purple, red, silver, teal, white, and
+yellow.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="table.cell.border.style.frag">
-<xsl:param name="table.cell.border.style" select="'solid'"/>
+<xsl:param name="table.cell.border.style">solid</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="table.cell.border.thickness.frag">
-<xsl:param name="table.cell.border.thickness" select="'0.5pt'"/>
+<xsl:param name="table.cell.border.thickness">0.5pt</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>FIXME:</para>
+<para>If non-zero, specifies the thickness of borders on table
+cells. The units are points. See <link
+xlink:href="http://www.w3.org/TR/CSS21/box.html#border-width-properties">
+CSS</link></para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="table.entry.padding.frag">
-<xsl:param name="table.entry.padding" select="'2pt'"/>
+<xsl:param name="table.entry.padding">2pt</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="table.footnote.number.format.frag">
-<xsl:param name="table.footnote.number.format" select="'a'"/>
+<xsl:param name="table.footnote.number.format">a</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="table.footnote.number.symbols.frag">
-<xsl:param name="table.footnote.number.symbols" select="''"/>
+<xsl:param name="table.footnote.number.symbols"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="table.frame.border.color.frag">
-<xsl:param condition="html" name="table.frame.border.color" select="''"/>
-<xsl:param condition="fo" name="table.frame.border.color" select="'black'"/>
+<xsl:param condition="html" name="table.frame.border.color"></xsl:param>
+<xsl:param condition="fo" name="table.frame.border.color">black</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="table.frame.border.style.frag">
-<xsl:param name="table.frame.border.style" select="'solid'"/>
+<xsl:param name="table.frame.border.style">solid</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="table.frame.border.thickness.frag">
-<xsl:param name="table.frame.border.thickness" select="'0.5pt'"/>
+<xsl:param name="table.frame.border.thickness">0.5pt</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="table.spacer.image.frag">
-<xsl:param name="table.spacer.image" select="'graphics/spacer.gif'"/>
+<xsl:param name="table.spacer.image">graphics/spacer.gif</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="tablecolumns.extension.frag"><xsl:param name="tablecolumns.extension" select="'1'"/></src:fragment>
+<src:fragment xml:id="tablecolumns.extension.frag">
+<xsl:param name="tablecolumns.extension" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refpurpose>Name of master database file for resolving
olinks</refpurpose>
</refnamediv>
-<refsynopsisdiv> <src:fragment xml:id="target.database.document.frag">
-<xsl:param name="target.database.document" select="''"/>
+<refsynopsisdiv>
+<src:fragment xml:id="target.database.document.frag">
+ <xsl:param name="target.database.document">olinkdb.xml</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>
-To resolve olinks between documents, the stylesheets use
-a master database document that identifies the target datafiles for all the documents within the scope
-of the olinks. This parameter value is the URI of
-the master document to be read during processing to resolve olinks.
-The default value is <filename>olinkdb.xml</filename>.</para>
-<para>The data structure of the file is defined in the <filename>targetdatabase.dtd</filename> DTD. The database file provides the high level elements to record the identifiers, locations, and relationships of documents. The cross reference data for individual documents is generally pulled into the database using system entity references or XIncludes. See also <parameter>targets.filename</parameter>.
+To resolve olinks between documents, the stylesheets use a master
+database document that identifies the target datafiles for all the
+documents within the scope of the olinks. This parameter value is the
+URI of the master document to be read during processing to resolve
+olinks. The default value is <filename>olinkdb.xml</filename>.</para>
-</para>
-</refsection>
+<para>The data structure of the file is defined in the
+<filename>targetdatabase.dtd</filename> DTD. The database file
+provides the high level elements to record the identifiers, locations,
+and relationships of documents. The cross reference data for
+individual documents is generally pulled into the database using
+system entity references or XIncludes. See also
+<parameter>targets.filename</parameter>. </para> </refsection>
</refentry>
<refpurpose>Name of cross reference targets data file</refpurpose>
</refnamediv>
<refsynopsisdiv> <src:fragment xml:id="targets.filename.frag">
-<xsl:param name="targets.filename" select="'target.db'"/>
+<xsl:param name="targets.filename">target.db</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsynopsisdiv>
<src:fragment xml:id="tex.math.delims.frag">
-<xsl:param name="tex.math.delims" select="'1'"/>
+<xsl:param name="tex.math.delims" select="1"/>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="tex.math.file.frag">
-<xsl:param name="tex.math.file" select="'tex-math-equations.tex'"/>
+<xsl:param name="tex.math.file">tex-math-equations.tex</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="tex.math.in.alt.frag">
-<xsl:param name="tex.math.in.alt" select="''"/>
+<xsl:param name="tex.math.in.alt"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="text.home.frag">
-<xsl:param name="text.home" select="'Home'"/>
+<xsl:param name="text.home">Home</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="text.next.frag">
-<xsl:param name="text.next" select="'Next'"/>
+<xsl:param name="text.next">Next</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="text.prev.frag">
-<xsl:param name="text.prev" select="'Prev'"/>
+<xsl:param name="text.prev">Prev</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="text.toc.frag">
-<xsl:param name="text.toc" select="'ToC'"/>
+<xsl:param name="text.toc">ToC</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="text.up.frag">
-<xsl:param name="text.up" select="'Up'"/>
+<xsl:param name="text.up" >Up</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="textdata.default.encoding.frag">
-<xsl:param name="textdata.default.encoding" select="''"/>
+<xsl:param name="textdata.default.encoding"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Default encoding of external text files which are included using
-textdata element. This value is used only when you do not specify
-encoding by appropriate attribute directly on textdata. Default
-encoding (empty string) is interpreted as system default
-encoding.</para>
+<para>Specifies the encoding of any external text files included using
+<tag>textdata</tag> element. This value is used only when you do
+not specify encoding by the appropriate attribute <!-- Which is what? -->
+directly on textdata. An empty string is interpreted as the system
+default encoding.</para>
</refsection>
</refentry>
</refmeta>
<refnamediv>
<refname>textinsert.extension</refname>
- <refpurpose>Enable the textinsert extension element</refpurpose>
+ <refpurpose>Insert the contents of a file</refpurpose>
</refnamediv>
<refsynopsisdiv>
- <src:fragment xml:id="textinsert.extension.frag"><xsl:param name="textinsert.extension" select="'1'"/></src:fragment>
+ <src:fragment xml:id="textinsert.extension.frag">
+ <xsl:param name="textinsert.extension" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>The textinsert extension element inserts the contents of
<refsynopsisdiv>
<src:fragment xml:id="title.font.family.frag">
-<xsl:param name="title.font.family" select="'sans-serif'"/>
+<xsl:param name="title.font.family">sans-serif</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="toc.bg.color.frag">
-<xsl:param name="toc.bg.color" select="'#FFFFFF'"/>
+<xsl:param name="toc.bg.color">#FFFFFF</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="toc.image.frag">
-<xsl:param name="toc.image" select="'active/nav-toc.png'"/>
+<xsl:param name="toc.image">active/nav-toc.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="toc.indent.width.frag">
-<xsl:param name="toc.indent.width" select="24"/>
+<xsl:param name="toc.indent.width">24</xsl:param>
+<!-- inconsistant point specification? -->
</src:fragment>
</refsynopsisdiv>
</refmeta>
<refnamediv>
<refname>toc.max.depth</refname>
-<refpurpose>How maximaly deep should be each TOC?</refpurpose>
+<refpurpose>How many levels should be created for each TOC?</refpurpose>
</refnamediv>
<refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="toc.row.height.frag">
-<xsl:param name="toc.row.height" select="22"/>
+<xsl:param name="toc.row.height">22</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<para>This parameter specifies the height of each row in the table of
-contents. This is only applicable if a <link linkend="dynamic.toc">dynamic ToC</link> is used. You may want to
-adjust this parameter for optimal appearance with the font and image sizes
-selected by your <link linkend="css.stylesheet">CSS stylesheet</link>.
+contents. This is only applicable if a <link
+linkend="dynamic.toc">dynamic ToC</link> is used. You may want to
+adjust this parameter for optimal appearance with the font and image
+sizes selected by your <link linkend="css.stylesheet">CSS
+stylesheet</link>.
</para>
-
+<!-- This uses link for cross param linking, unlike most others -->
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="toc.width.frag">
-<xsl:param name="toc.width" select="250"/>
+<xsl:param name="toc.width" >250</xsl:param>
+<!-- Presumably in pixels? -->
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>Specifies the width of the ToC frame.</para>
+<para>Specifies the width of the ToC frame in pixels.</para>
</refsection>
</refentry>
<refsynopsisdiv>
<src:fragment xml:id="ua.js.frag">
-<xsl:param name="ua.js" select="'ua.js'"/>
+<xsl:param name="ua.js">ua.js</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="ulink.hyphenate.chars.frag">
-<xsl:param name="ulink.hyphenate.chars" select="'/'"/>
+<xsl:param name="ulink.hyphenate.chars">/</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="ulink.hyphenate.frag">
-<xsl:param name="ulink.hyphenate" select="''"/>
+<xsl:param name="ulink.hyphenate"></xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="ulink.target.frag"><xsl:param name="ulink.target" select="'_top'"/></src:fragment>
+<src:fragment xml:id="ulink.target.frag">
+<xsl:param name="ulink.target">_top</xsl:param>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>If <parameter>ulink.target</parameter> is set, its value will
-be used for the <tag class="attribute">target</tag> attribute
+<para>If <parameter>ulink.target</parameter> is non-zero, its value will
+be used for the <literal>target</literal> attribute
on anchors generated for <tag>ulink</tag>s.</para>
</refsection>
<refsynopsisdiv>
<src:fragment xml:id="up.image.frag">
-<xsl:param name="up.image" select="'active/nav-up.png'"/>
+<xsl:param name="up.image">active/nav-up.png</xsl:param>
</src:fragment>
</refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="use.extensions.frag"><xsl:param name="use.extensions" select="'0'"/></src:fragment>
+<src:fragment xml:id="use.extensions.frag">
+<xsl:param name="use.extensions" select="0"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="use.id.as.filename.frag"><xsl:param name="use.id.as.filename" select="'0'"/></src:fragment>
+<src:fragment xml:id="use.id.as.filename.frag">
+<xsl:param name="use.id.as.filename" select="0"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
</refnamediv>
<refsynopsisdiv>
-<src:fragment xml:id="use.id.function.frag"><xsl:param name="use.id.function" select="'1'"/></src:fragment>
+<src:fragment xml:id="use.id.function.frag">
+<xsl:param name="use.id.function" select="1"/>
+</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
<refsection><info><title>Example</title></info>
-<para>The following small stylesheet shows how to configure the stylesheets to make
-use of the cross reference style:</para>
+<para>The following small stylesheet shows how to configure the
+stylesheets to make use of the cross reference style:</para>
<programlisting><?xml version="1.0"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
<refsynopsisdiv>
<src:fragment xml:id="wordml.template.frag">
-<xsl:param name="wordml.template" select="''"/>
+<xsl:param name="wordml.template"></xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="xbCollapsibleLists.js.frag">
-<xsl:param name="xbCollapsibleLists.js" select="'xbCollapsibleLists.js'"/>
+<xsl:param name="xbCollapsibleLists.js">xbCollapsibleLists.js</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="xbDOM.js.frag">
-<xsl:param name="xbDOM.js" select="'xbDOM.js'"/>
+<xsl:param name="xbDOM.js">xbDOM.js</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="xbLibrary.js.frag">
-<xsl:param name="xbLibrary.js" select="'xbLibrary.js'"/>
+<xsl:param name="xbLibrary.js">xbLibrary.js</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsynopsisdiv>
<src:fragment xml:id="xbStyle.js.frag">
-<xsl:param name="xbStyle.js" select="'xbStyle.js'"/>
+<xsl:param name="xbStyle.js">xbStyle.js</xsl:param>
</src:fragment>
</refsynopsisdiv>
<refsection><info><title>Description</title></info>
-<para>FIXME:</para>
+<para>A cross reference may include the number (for example, the number of
+an example or figure) and the <tag>title</tag> which is a required child of some
+targets. This parameter inserts both the relevant number as well as
+the title into the link. </para>
</refsection>
</refentry>
projects / docbook-dsssl / commitdiff