fo/param.xml

   1 <?xml version="1.0" encoding="ASCII"?>
   2 <book version="5.0">
   3 <info>
   4 <title>FO Parameter Reference</title>
   5 <releaseinfo role="meta">
   6 $Id: param.xweb 9996 2015-10-01 16:35:10Z bobstayton $
   7 </releaseinfo>
   8 <author>
   9   <personname>
  10     <surname>Walsh</surname>
  11     <firstname>Norman</firstname>
  12   </personname>
  13 </author>
  14 <copyright>
  15   <year>1999</year>
  16   <year>2000</year>
  17   <year>2001</year>
  18   <year>2002</year>
  19   <year>2003</year>
  20   <year>2004</year>
  21   <year>2005</year>
  22   <year>2006</year>
  23   <year>2007</year>
  24   <year>2008</year>
  25   <year>2009</year>
  26   <year>2010</year>
  27   <year>2011</year>
  28   <holder>Norman Walsh</holder>
  29 </copyright>
  30 <abstract>
  31   <para>This is reference documentation for all user-configurable
  32   parameters in the DocBook XSL FO stylesheets (for generating
  33   XSL-FO output destined for final print/PDF output).</para>
  34 </abstract>
  35 </info>
  36 <reference xml:id="admons"><title>Admonitions</title>
  37 <refentry version="5.0" xml:id="admon.graphics">
  38 <refmeta>
  39 <refentrytitle>admon.graphics</refentrytitle>
  40 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
  41 </refmeta>
  42 <refnamediv>
  43 <refname>admon.graphics</refname>
  44 <refpurpose>Use graphics in admonitions?</refpurpose>
  45 </refnamediv>
  46
  47 <refsynopsisdiv>
  48 <programlisting xml:id="admon.graphics.frag">
  49 &lt;xsl:param name="admon.graphics" select="0"&gt;&lt;/xsl:param&gt;
  50 </programlisting>
  51 </refsynopsisdiv>
  52
  53 <refsection><info><title>Description</title></info>
  54
  55 <para>If true (non-zero), admonitions are presented in an alternate style that uses
  56 a graphic.  Default graphics are provided in the distribution.
  57 </para>
  58
  59 </refsection>
  60 </refentry>
  61
  62 <refentry version="5.0" xml:id="admon.graphics.extension">
  63 <refmeta>
  64 <refentrytitle>admon.graphics.extension</refentrytitle>
  65 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
  66 </refmeta>
  67 <refnamediv>
  68 <refname>admon.graphics.extension</refname>
  69 <refpurpose>Filename extension for admonition graphics</refpurpose>
  70 </refnamediv>
  71
  72 <refsynopsisdiv>
  73 <programlisting xml:id="admon.graphics.extension.frag">
  74 &lt;xsl:param name="admon.graphics.extension"&gt;.png&lt;/xsl:param&gt;
  75 </programlisting>
  76 </refsynopsisdiv>
  77
  78 <refsection><info><title>Description</title></info>
  79
  80 <para>Sets the filename extension to use on admonition graphics.</para>
  81
  82 <itemizedlist>
  83   <para>The DocBook XSL distribution provides admonition graphics in the following formats:</para>
  84   <listitem><para>GIF (extension: <filename class="extension">.gif</filename>)</para></listitem>
  85   <listitem><para>PNG (extension: <filename class="extension">.png</filename>)</para></listitem>
  86   <listitem><para>SVG (extension: <filename class="extension">.svg</filename>)</para></listitem>
  87   <listitem><para>TIFF (extension: <filename class="extension">.tif</filename>)</para></listitem>
  88 </itemizedlist>
  89
  90 </refsection>
  91 </refentry>
  92
  93 <refentry version="5.0" xml:id="admon.graphics.path">
  94 <refmeta>
  95 <refentrytitle>admon.graphics.path</refentrytitle>
  96 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
  97 </refmeta>
  98 <refnamediv>
  99 <refname>admon.graphics.path</refname>
 100 <refpurpose>Path to admonition graphics</refpurpose>
 101 </refnamediv>
 102
 103 <refsynopsisdiv>
 104 <programlisting xml:id="admon.graphics.path.frag">&lt;xsl:param name="admon.graphics.path"&gt;images/&lt;/xsl:param&gt;</programlisting>
 105 </refsynopsisdiv>
 106
 107 <refsection><info><title>Description</title></info>
 108
 109 <para>Sets the path to the directory containing the admonition graphics
 110 (caution.png, important.png etc). This location is normally relative
 111 to the output html directory. See <parameter>base.dir</parameter></para>
 112
 113 </refsection>
 114 </refentry>
 115
 116 <refentry version="5.0" xml:id="admon.textlabel">
 117 <refmeta>
 118 <refentrytitle>admon.textlabel</refentrytitle>
 119 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
 120 </refmeta>
 121 <refnamediv>
 122 <refname>admon.textlabel</refname>
 123 <refpurpose>Use text label in admonitions?</refpurpose>
 124 </refnamediv>
 125
 126 <refsynopsisdiv>
 127 <programlisting xml:id="admon.textlabel.frag">
 128 &lt;xsl:param name="admon.textlabel" select="1"&gt;&lt;/xsl:param&gt;
 129 </programlisting>
 130 </refsynopsisdiv>
 131
 132 <refsection><info><title>Description</title></info>
 133
 134 <para>If true (non-zero), admonitions are presented with a generated
 135 text label such as Note or Warning in the appropriate language.
 136 If zero, such labels are turned off, but any title child
 137 of the admonition element are still output.
 138 The default value is 1.
 139 </para>
 140
 141 </refsection>
 142 </refentry>
 143
 144 <refentry version="5.0" xml:id="admonition.title.properties">
 145
 146 <refmeta>
 147   <refentrytitle>admonition.title.properties</refentrytitle>
 148   <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
 149 </refmeta>
 150 <refnamediv>
 151 <refname>admonition.title.properties</refname>
 152 <refpurpose>To set the style for admonitions titles.</refpurpose>
 153 </refnamediv>
 154
 155 <refsynopsisdiv>
 156 <programlisting xml:id="admonition.title.properties.frag">
 157 &lt;xsl:attribute-set name="admonition.title.properties"&gt;
 158   &lt;xsl:attribute name="font-size"&gt;14pt&lt;/xsl:attribute&gt;
 159   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
 160   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
 161   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
 162 &lt;/xsl:attribute-set&gt;
 163 </programlisting>
 164 </refsynopsisdiv>
 165 <refsection><info><title>Description</title></info>
 166 <para>How do you want admonitions titles styled? </para>
 167 <para>Set the font-size, weight etc to the style required.</para>
 168
 169 </refsection>
 170 </refentry>
 171
 172 <refentry version="5.0" xml:id="admonition.properties">
 173 <refmeta>
 174   <refentrytitle>admonition.properties</refentrytitle>
 175   <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
 176 </refmeta>
 177 <refnamediv>
 178 <refname>admonition.properties</refname>
 179 <refpurpose>To set the style for admonitions.</refpurpose>
 180 </refnamediv>
 181
 182 <refsynopsisdiv>
 183 <programlisting xml:id="admonition.properties.frag">&lt;xsl:attribute-set name="admonition.properties"&gt;&lt;/xsl:attribute-set&gt;
 184 </programlisting>
 185 </refsynopsisdiv>
 186 <refsection><info><title>Description</title></info>
 187 <para>How do you want admonitions styled? </para>
 188 <para>Set the font-size, weight, etc. to the style required</para>
 189
 190 </refsection>
 191 </refentry>
 192
 193 <refentry version="5.0" xml:id="graphical.admonition.properties">
 194 <refmeta>
 195 <refentrytitle>graphical.admonition.properties</refentrytitle>
 196 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
 197 </refmeta>
 198 <refnamediv>
 199 <refname>graphical.admonition.properties</refname>
 200 <refpurpose>To add properties to the outer block of a graphical admonition.</refpurpose>
 201 </refnamediv>
 202
 203 <refsynopsisdiv>
 204 <programlisting xml:id="graphical.admonition.properties.frag">&lt;xsl:attribute-set name="graphical.admonition.properties"&gt;
 205   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
 206   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
 207   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
 208   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;
 209   &lt;xsl:attribute name="space-after.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
 210   &lt;xsl:attribute name="space-after.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
 211 &lt;/xsl:attribute-set&gt;
 212 </programlisting>
 213 </refsynopsisdiv>
 214 <refsection><info><title>Description</title></info>
 215 <para>These properties are added to the outer block containing the
 216 entire graphical admonition, including its title.
 217 It is used when the parameter
 218 <parameter>admon.graphics</parameter> is set to nonzero.
 219 Use this attribute-set to set the space above and below,
 220 and any indent for the whole admonition.</para>
 221
 222 <para>In addition to these properties, a graphical admonition
 223 also applies the <parameter>admonition.title.properties</parameter>
 224 attribute-set to the title, and applies the
 225 <parameter>admonition.properties</parameter> attribute-set
 226 to the rest of the content.</para>
 227
 228 </refsection>
 229 </refentry>
 230
 231 <refentry version="5.0" xml:id="nongraphical.admonition.properties">
 232 <refmeta>
 233 <refentrytitle>nongraphical.admonition.properties</refentrytitle>
 234 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
 235 </refmeta>
 236 <refnamediv>
 237 <refname>nongraphical.admonition.properties</refname>
 238 <refpurpose>To add properties to the outer block of a nongraphical admonition.</refpurpose>
 239 </refnamediv>
 240
 241 <refsynopsisdiv>
 242 <programlisting xml:id="nongraphical.admonition.properties.frag">&lt;xsl:attribute-set name="nongraphical.admonition.properties"&gt;
 243   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
 244   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
 245   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
 246   &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;0.25in&lt;/xsl:attribute&gt;
 247   &lt;xsl:attribute name="margin-{$direction.align.end}"&gt;0.25in&lt;/xsl:attribute&gt;
 248 &lt;/xsl:attribute-set&gt;
 249 </programlisting>
 250 </refsynopsisdiv>
 251 <refsection><info><title>Description</title></info>
 252 <para>These properties are added to the outer block containing the
 253 entire nongraphical admonition, including its title.
 254 It is used when the parameter
 255 <parameter>admon.graphics</parameter> is set to zero.
 256 Use this attribute-set to set the space above and below,
 257 and any indent for the whole admonition.</para>
 258
 259 <para>In addition to these properties, a nongraphical admonition
 260 also applies the <parameter>admonition.title.properties</parameter>
 261 attribute-set to the title, and the
 262 <parameter>admonition.properties</parameter> attribute-set
 263 to the rest of the content.</para>
 264
 265 </refsection>
 266 </refentry>
 267
 268 </reference>
 269 <reference xml:id="callouts"><title>Callouts</title>
 270 <refentry version="5.0" xml:id="calloutlist.properties">
 271 <refmeta>
 272 <refentrytitle>calloutlist.properties</refentrytitle>
 273 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
 274 </refmeta>
 275 <refnamediv>
 276 <refname>calloutlist.properties</refname>
 277 <refpurpose>Properties that apply to each list-block generated by calloutlist.</refpurpose>
 278 </refnamediv>
 279
 280 <refsynopsisdiv>
 281 <programlisting xml:id="calloutlist.properties.frag">&lt;xsl:attribute-set name="calloutlist.properties"&gt;
 282   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
 283   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
 284   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
 285   &lt;xsl:attribute name="provisional-distance-between-starts"&gt;2.2em&lt;/xsl:attribute&gt;
 286   &lt;xsl:attribute name="provisional-label-separation"&gt;0.2em&lt;/xsl:attribute&gt;
 287 &lt;/xsl:attribute-set&gt;</programlisting>
 288 </refsynopsisdiv>
 289 <refsection><info><title>Description</title></info>
 290 <para>Properties that apply to the fo:list-block generated by calloutlist.
 291 Typically used to adjust spacing or margins of the entire list.
 292 Change the <literal>provisional-distance-between-starts</literal> attribute to
 293 change the indent of the list paragraphs relative to the
 294 callout numbers.</para>
 295 </refsection>
 296 </refentry>
 297
 298 <refentry version="5.0" xml:id="callout.properties">
 299 <refmeta>
 300 <refentrytitle>callout.properties</refentrytitle>
 301 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
 302 </refmeta>
 303 <refnamediv>
 304 <refname>callout.properties</refname>
 305 <refpurpose>Properties that apply to the list-item generated by each callout within a calloutlist.</refpurpose>
 306 </refnamediv>
 307
 308 <refsynopsisdiv>
 309 <programlisting xml:id="callout.properties.frag">&lt;xsl:attribute-set name="callout.properties"&gt;
 310 &lt;/xsl:attribute-set&gt;</programlisting>
 311 </refsynopsisdiv>
 312 <refsection><info><title>Description</title></info>
 313 <para>Properties that apply to the fo:list-item generated by each callout within a calloutlist. Typically used to add spacing properties.</para>
 314 </refsection>
 315 </refentry>
 316
 317 <refentry version="5.0" xml:id="callout.defaultcolumn">
 318 <refmeta>
 319 <refentrytitle>callout.defaultcolumn</refentrytitle>
 320 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
 321 </refmeta>
 322 <refnamediv>
 323 <refname>callout.defaultcolumn</refname>
 324 <refpurpose>Indicates what column callouts appear in by default</refpurpose>
 325 </refnamediv>
 326
 327 <refsynopsisdiv>
 328 <programlisting xml:id="callout.defaultcolumn.frag">
 329 &lt;xsl:param name="callout.defaultcolumn"&gt;60&lt;/xsl:param&gt;
 330 </programlisting>
 331 </refsynopsisdiv>
 332
 333 <refsection><info><title>Description</title></info>
 334
 335 <para>If a callout does not identify a column (for example, if it uses
 336 the <literal>linerange</literal> <tag class="attribute">unit</tag>),
 337 it will appear in the default column.
 338 </para>
 339
 340 </refsection>
 341 </refentry>
 342
 343 <refentry version="5.0" xml:id="callout.graphics">
 344 <refmeta>
 345 <refentrytitle>callout.graphics</refentrytitle>
 346 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
 347 </refmeta>
 348 <refnamediv>
 349 <refname>callout.graphics</refname>
 350 <refpurpose>Use graphics for callouts?</refpurpose>
 351 </refnamediv>
 352
 353 <refsynopsisdiv>
 354 <programlisting xml:id="callout.graphics.frag">
 355 &lt;xsl:param name="callout.graphics" select="1"&gt;&lt;/xsl:param&gt;
 356 </programlisting>
 357 </refsynopsisdiv>
 358
 359 <refsection><info><title>Description</title></info>
 360
 361 <para>If non-zero, callouts are presented with graphics (e.g., reverse-video
 362 circled numbers instead of "(1)", "(2)", etc.).
 363 Default graphics are provided in the distribution.
 364 </para>
 365
 366 </refsection>
 367 </refentry>
 368
 369 <refentry version="5.0" xml:id="callout.graphics.extension">
 370 <refmeta>
 371 <refentrytitle>callout.graphics.extension</refentrytitle>
 372 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
 373 </refmeta>
 374 <refnamediv>
 375 <refname>callout.graphics.extension</refname>
 376 <refpurpose>Filename extension for callout graphics</refpurpose>
 377 </refnamediv>
 378
 379 <refsynopsisdiv>
 380 <programlisting xml:id="callout.graphics.extension.frag">
 381
 382 &lt;xsl:param name="callout.graphics.extension"&gt;.svg&lt;/xsl:param&gt;
 383 </programlisting>
 384 </refsynopsisdiv>
 385
 386 <refsection><info><title>Description</title></info>
 387 <para>Sets the filename extension to use on callout graphics. </para>
 388
 389 <itemizedlist>
 390 <para>The Docbook XSL distribution provides callout graphics in the following formats:</para>
 391 <listitem><para>SVG (extension: <filename class="extension">.svg</filename>)</para></listitem>
 392 <listitem><para>PNG (extension: <filename class="extension">.png</filename>)</para></listitem>
 393 <listitem><para>GIF (extension: <filename class="extension">.gif</filename>)</para></listitem>
 394 </itemizedlist>
 395 </refsection>
 396 </refentry>
 397
 398 <refentry version="5.0" xml:id="callout.graphics.number.limit">
 399 <refmeta>
 400 <refentrytitle>callout.graphics.number.limit</refentrytitle>
 401 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
 402 </refmeta>
 403 <refnamediv>
 404 <refname>callout.graphics.number.limit</refname>
 405 <refpurpose>Number of the largest callout graphic</refpurpose>
 406 </refnamediv>
 407
 408 <refsynopsisdiv>
 409 <programlisting xml:id="callout.graphics.number.limit.frag">
 410
 411 &lt;xsl:param name="callout.graphics.number.limit"&gt;30&lt;/xsl:param&gt;
 412 </programlisting>
 413 </refsynopsisdiv>
 414
 415 <refsection><info><title>Description</title></info>
 416
 417 <para>If <parameter>callout.graphics</parameter> is non-zero, graphics
 418 are used to represent callout numbers instead of plain text. The value
 419 of <parameter>callout.graphics.number.limit</parameter> is the largest
 420 number for which a graphic exists. If the callout number exceeds this
 421 limit, the default presentation "(plain text instead of a graphic)"
 422 will  be used.
 423 </para>
 424
 425 </refsection>
 426 </refentry>
 427
 428 <refentry version="5.0" xml:id="callout.graphics.path">
 429 <refmeta>
 430 <refentrytitle>callout.graphics.path</refentrytitle>
 431 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
 432 </refmeta>
 433 <refnamediv>
 434 <refname>callout.graphics.path</refname>
 435 <refpurpose>Path to callout graphics</refpurpose>
 436 </refnamediv>
 437
 438 <refsynopsisdiv>
 439 <programlisting xml:id="callout.graphics.path.frag">
 440 &lt;xsl:param name="callout.graphics.path"&gt;images/callouts/&lt;/xsl:param&gt;
 441 </programlisting>
 442 </refsynopsisdiv>
 443
 444 <refsection><info><title>Description</title></info>
 445
 446 <para>Sets the path to the directory holding the callout graphics. his
 447 location is normally relative to the output html directory. see
 448 base.dir. Always terminate the directory with / since the graphic file
 449 is appended to this string, hence needs the separator.
 450 </para>
 451
 452 </refsection>
 453 </refentry>
 454
 455 <refentry version="5.0" xml:id="callout.icon.size">
 456 <refmeta>
 457 <refentrytitle>callout.icon.size</refentrytitle>
 458 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
 459 </refmeta>
 460 <refnamediv>
 461 <refname>callout.icon.size</refname>
 462 <refpurpose>Specifies the size of callout marker icons</refpurpose>
 463 </refnamediv>
 464
 465 <refsynopsisdiv>
 466 <programlisting xml:id="callout.icon.size.frag">
 467 &lt;xsl:param name="callout.icon.size"&gt;7pt&lt;/xsl:param&gt;
 468 </programlisting>
 469 </refsynopsisdiv>
 470
 471 <refsection><info><title>Description</title></info>
 472
 473 <para>Specifies the size of the callout marker icons.
 474 The default size is 7 points.</para>
 475
 476 </refsection>
 477 </refentry>
 478
 479 <refentry version="5.0" xml:id="callout.unicode">
 480 <refmeta>
 481 <refentrytitle>callout.unicode</refentrytitle>
 482 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
 483 </refmeta>
 484 <refnamediv>
 485 <refname>callout.unicode</refname>
 486 <refpurpose>Use Unicode characters rather than images for callouts.</refpurpose>
 487 </refnamediv>
 488
 489 <refsynopsisdiv>
 490 <programlisting xml:id="callout.unicode.frag">&lt;xsl:param name="callout.unicode" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
 491 </refsynopsisdiv>
 492
 493 <refsection><info><title>Description</title></info>
 494
 495 <para>The stylesheets can use either an image of the numbers one to ten, or the single Unicode character which represents the numeral, in white on a black background. Use this to select the Unicode character option.
 496 </para>
 497
 498 </refsection>
 499 </refentry>
 500
 501 <refentry version="5.0" xml:id="callout.unicode.font">
 502 <refmeta>
 503 <refentrytitle>callout.unicode.font</refentrytitle>
 504 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
 505 </refmeta>
 506 <refnamediv>
 507 <refname>callout.unicode.font</refname>
 508 <refpurpose>Specify a font for Unicode glyphs</refpurpose>
 509 </refnamediv>
 510
 511 <refsynopsisdiv>
 512 <programlisting xml:id="callout.unicode.font.frag">
 513 &lt;xsl:param name="callout.unicode.font"&gt;ZapfDingbats&lt;/xsl:param&gt;
 514 </programlisting>
 515 </refsynopsisdiv>
 516
 517 <refsection><info><title>Description</title></info>
 518
 519 <para>The name of the font to specify around Unicode callout glyphs.
 520 If set to the empty string, no font change will occur.
 521 </para>
 522
 523 </refsection>
 524 </refentry>
 525
 526 <refentry version="5.0" xml:id="callout.unicode.number.limit">
 527 <refmeta>
 528 <refentrytitle>callout.unicode.number.limit</refentrytitle>
 529 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
 530 </refmeta>
 531 <refnamediv>
 532 <refname>callout.unicode.number.limit</refname>
 533 <refpurpose>Number of the largest unicode callout character</refpurpose>
 534 </refnamediv>
 535
 536 <refsynopsisdiv>
 537 <programlisting xml:id="callout.unicode.number.limit.frag">
 538 &lt;xsl:param name="callout.unicode.number.limit"&gt;10&lt;/xsl:param&gt;
 539 </programlisting>
 540 </refsynopsisdiv>
 541
 542 <refsection><info><title>Description</title></info>
 543
 544 <para>If <parameter>callout.unicode</parameter>
 545 is non-zero, unicode characters are used to represent
 546 callout numbers. The value of
 547 <parameter>callout.unicode.number.limit</parameter>
 548 is
 549 the largest number for which a unicode character exists. If the callout number
 550 exceeds this limit, the default presentation "(nnn)" will always
 551 be used.
 552 </para>
 553
 554 </refsection>
 555 </refentry>
 556
 557 <refentry version="5.0" xml:id="callout.unicode.start.character">
 558 <refmeta>
 559 <refentrytitle>callout.unicode.start.character</refentrytitle>
 560 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
 561 </refmeta>
 562 <refnamediv>
 563 <refname>callout.unicode.start.character</refname>
 564 <refpurpose>First Unicode character to use, decimal value.</refpurpose>
 565 </refnamediv>
 566
 567 <refsynopsisdiv>
 568 <programlisting xml:id="callout.unicode.start.character.frag">
 569 &lt;xsl:param name="callout.unicode.start.character"&gt;10102&lt;/xsl:param&gt;
 570 </programlisting>
 571 </refsynopsisdiv>
 572
 573 <refsection><info><title>Description</title></info>
 574
 575 <para>If <parameter>callout.graphics</parameter> is zero and <parameter>callout.unicode</parameter>
 576 is non-zero, unicode characters are used to represent
 577 callout numbers. The value of
 578 <parameter>callout.unicode.start.character</parameter>
 579 is the decimal unicode value used for callout number one. Currently,
 580 only values 9312 and 10102 are supported in the stylesheets for this parameter.
 581 </para>
 582
 583 </refsection>
 584 </refentry>
 585
 586 <refentry version="5.0" xml:id="callouts.extension">
 587 <refmeta>
 588 <refentrytitle>callouts.extension</refentrytitle>
 589 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
 590 </refmeta>
 591 <refnamediv>
 592 <refname>callouts.extension</refname>
 593 <refpurpose>Enable the callout extension</refpurpose>
 594 </refnamediv>
 595
 596 <refsynopsisdiv>
 597 <programlisting xml:id="callouts.extension.frag">
 598 &lt;xsl:param name="callouts.extension" select="1"&gt;&lt;/xsl:param&gt;
 599 </programlisting>
 600 </refsynopsisdiv>
 601
 602 <refsection><info><title>Description</title></info>
 603
 604 <para>The callouts extension processes <tag>areaset</tag>
 605 elements in <tag>programlistingco</tag> and other text-based
 606 callout elements.
 607 </para>
 608
 609 </refsection>
 610 </refentry>
 611
 612 </reference>
 613 <reference xml:id="toc_index"><title>ToC/LoT/Index Generation</title>
 614 <refentry version="5.0" xml:id="autotoc.label.separator">
 615 <refmeta>
 616 <refentrytitle>autotoc.label.separator</refentrytitle>
 617 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
 618 </refmeta>
 619 <refnamediv>
 620 <refname>autotoc.label.separator</refname>
 621 <refpurpose>Separator between labels and titles in the ToC</refpurpose>
 622 </refnamediv>
 623
 624 <refsynopsisdiv>
 625 <programlisting xml:id="autotoc.label.separator.frag">
 626 &lt;xsl:param name="autotoc.label.separator"&gt;. &lt;/xsl:param&gt;
 627 </programlisting>
 628 </refsynopsisdiv>
 629
 630 <refsection><info><title>Description</title></info>
 631
 632 <para>String used to separate labels and titles in a table of contents.</para>
 633
 634 </refsection>
 635 </refentry>
 636
 637 <refentry version="5.0" xml:id="process.empty.source.toc">
 638 <refmeta>
 639 <refentrytitle>process.empty.source.toc</refentrytitle>
 640 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
 641 </refmeta>
 642 <refnamediv>
 643 <refname>process.empty.source.toc</refname>
 644 <refpurpose>Generate automated TOC if <tag>toc</tag> element occurs in a source document?</refpurpose>
 645 </refnamediv>
 646
 647 <refsynopsisdiv>
 648 <programlisting xml:id="process.empty.source.toc.frag">&lt;xsl:param name="process.empty.source.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
 649 </refsynopsisdiv>
 650
 651 <refsection><info><title>Description</title></info>
 652
 653 <para>Specifies that if an empty <tag>toc</tag> element is found in a
 654 source document, an automated TOC is generated at this point in the
 655 document.
 656 <note>
 657   <para>Depending on what the value of the
 658   <parameter>generate.toc</parameter> parameter is, setting this
 659   parameter to <literal>1</literal> could result in generation of
 660   duplicate automated TOCs. So the
 661   <parameter>process.empty.source.toc</parameter> is primarily useful
 662   as an "override": by placing an empty <tag>toc</tag> in your
 663   document and setting this parameter to <literal>1</literal>, you can
 664   force a TOC to be generated even if <tag>generate.toc</tag>
 665   says not to.</para>
 666 </note>
 667 </para>
 668
 669 </refsection>
 670 </refentry>
 671
 672 <refentry version="5.0" xml:id="process.source.toc">
 673 <refmeta>
 674 <refentrytitle>process.source.toc</refentrytitle>
 675 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
 676 </refmeta>
 677 <refnamediv>
 678 <refname>process.source.toc</refname>
 679 <refpurpose>Process a non-empty <tag>toc</tag> element if it occurs in a source document?</refpurpose>
 680 </refnamediv>
 681
 682 <refsynopsisdiv>
 683 <programlisting xml:id="process.source.toc.frag">&lt;xsl:param name="process.source.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
 684 </refsynopsisdiv>
 685
 686 <refsection><info><title>Description</title></info>
 687
 688 <para>Specifies that the contents of a non-empty "hard-coded"
 689 <tag>toc</tag> element in a source document are processed to
 690 generate a TOC in output.
 691 <note>
 692   <para>This parameter has no effect on automated generation of
 693   TOCs. An automated TOC may still be generated along with the
 694   "hard-coded" TOC. To suppress automated TOC generation, adjust the
 695   value of the <parameter>generate.toc</parameter> paramameter.</para>
 696
 697   <para>The <tag>process.source.toc</tag> parameter also has
 698   no effect if the <tag>toc</tag> element is empty; handling
 699   for empty <tag>toc</tag> is controlled by the
 700   <parameter>process.empty.source.toc</parameter> parameter.</para>
 701 </note>
 702 </para>
 703
 704 </refsection>
 705 </refentry>
 706
 707 <refentry version="5.0" xml:id="generate.toc">
 708 <refmeta>
 709 <refentrytitle>generate.toc</refentrytitle>
 710 <refmiscinfo class="other" otherclass="datatype">table</refmiscinfo>
 711 </refmeta>
 712 <refnamediv>
 713 <refname>generate.toc</refname>
 714 <refpurpose>Control generation of ToCs and LoTs</refpurpose>
 715 </refnamediv>
 716
 717 <refsynopsisdiv>
 718 <programlisting xml:id="generate.toc.frag">
 719
 720 &lt;xsl:param name="generate.toc"&gt;
 721 /appendix toc,title
 722 article/appendix  nop
 723 /article  toc,title
 724 book      toc,title,figure,table,example,equation
 725 /chapter  toc,title
 726 part      toc,title
 727 /preface  toc,title
 728 reference toc,title
 729 /sect1    toc
 730 /sect2    toc
 731 /sect3    toc
 732 /sect4    toc
 733 /sect5    toc
 734 /section  toc
 735 set       toc,title
 736 &lt;/xsl:param&gt;
 737 </programlisting>
 738 </refsynopsisdiv>
 739
 740 <refsection><info><title>Description</title></info>
 741
 742 <para>This parameter has a structured value. It is a table of space-delimited
 743 path/value pairs. Each path identifies some element in the source document
 744 using a restricted subset of XPath (only the implicit child axis, no wildcards,
 745 no predicates). Paths can be either relative or absolute.</para>
 746
 747 <para>When processing a particular element, the stylesheets consult this table to
 748 determine if a ToC (or LoT(s)) should be generated.</para>
 749
 750 <para>For example, consider the entry:</para>
 751
 752 <screen>book toc,figure</screen>
 753
 754 <para>This indicates that whenever a <tag>book</tag> is formatted, a
 755 Table Of Contents and a List of Figures should be generated. Similarly,</para>
 756
 757 <screen>/chapter toc</screen>
 758
 759 <para>indicates that whenever a document <emphasis>that has a root
 760 of</emphasis> <tag>chapter</tag> is formatted, a Table of
 761 Contents should be generated. The entry <literal>chapter</literal> would match
 762 all chapters, but <literal>/chapter</literal> matches only <tag>chapter</tag>
 763 document elements.</para>
 764
 765 <para>Generally, the longest match wins. So, for example, if you want to distinguish
 766 articles in books from articles in parts, you could use these two entries:</para>
 767
 768 <screen>book/article toc,figure
 769 part/article toc</screen>
 770
 771 <para>Note that an article in a part can never match a <literal>book/article</literal>,
 772 so if you want nothing to be generated for articles in parts, you can simply leave
 773 that rule out.</para>
 774
 775 <para>If you want to leave the rule in, to make it explicit that you're turning
 776 something off, use the value <quote>nop</quote>. For example, the following
 777 entry disables ToCs and LoTs for articles:</para>
 778
 779 <screen>article nop</screen>
 780
 781 <para>Do not simply leave the word <quote>article</quote> in the file
 782 without a matching value. That'd be just begging the silly little
 783 path/value parser to get confused.</para>
 784
 785 <para>Section ToCs are further controlled by the
 786 <parameter>generate.section.toc.level</parameter> parameter.
 787 For a given section level to have a ToC, it must have both an entry in
 788 <parameter>generate.toc</parameter> and be within the range enabled by
 789 <parameter>generate.section.toc.level</parameter>.</para>
 790 </refsection>
 791 </refentry>
 792
 793 <refentry version="5.0" xml:id="generate.index">
 794 <refmeta>
 795 <refentrytitle>generate.index</refentrytitle>
 796 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
 797 </refmeta>
 798 <refnamediv>
 799 <refname>generate.index</refname>
 800 <refpurpose>Do you want an index?</refpurpose>
 801 </refnamediv>
 802
 803 <refsynopsisdiv>
 804 <programlisting xml:id="generate.index.frag">&lt;xsl:param name="generate.index" select="1"&gt;&lt;/xsl:param&gt;</programlisting>
 805 </refsynopsisdiv>
 806
 807 <refsection><info><title>Description</title></info>
 808
 809 <para>Specify if an index should be generated. </para>
 810
 811 </refsection>
 812 </refentry>
 813
 814 <refentry version="5.0" xml:id="make.index.markup">
 815 <refmeta>
 816 <refentrytitle>make.index.markup</refentrytitle>
 817 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
 818 </refmeta>
 819 <refnamediv>
 820 <refname>make.index.markup</refname>
 821 <refpurpose>Generate XML index markup in the index?</refpurpose>
 822 </refnamediv>
 823
 824 <refsynopsisdiv>
 825 <programlisting xml:id="make.index.markup.frag">
 826 &lt;xsl:param name="make.index.markup" select="0"&gt;&lt;/xsl:param&gt;
 827 </programlisting>
 828 </refsynopsisdiv>
 829
 830 <refsection><info><title>Description</title></info>
 831
 832 <para>This parameter enables a very neat trick for getting properly
 833 merged, collated back-of-the-book indexes. G. Ken Holman suggested
 834 this trick at Extreme Markup Languages 2002 and I'm indebted to him
 835 for it.</para>
 836
 837 <para>Jeni Tennison's excellent code in
 838 <filename>autoidx.xsl</filename> does a great job of merging and
 839 sorting <tag>indexterm</tag>s in the document and building a
 840 back-of-the-book index. However, there's one thing that it cannot
 841 reasonably be expected to do: merge page numbers into ranges. (I would
 842 not have thought that it could collate and suppress duplicate page
 843 numbers, but in fact it appears to manage that task somehow.)</para>
 844
 845 <para>Ken's trick is to produce a document in which the index at the
 846 back of the book is <quote>displayed</quote> in XML. Because the index
 847 is generated by the FO processor, all of the page numbers have been resolved.
 848 It's a bit hard to explain, but what it boils down to is that instead of having
 849 an index at the back of the book that looks like this:</para>
 850
 851 <blockquote>
 852 <formalpara><info><title>A</title></info>
 853 <para>ap1, 1, 2, 3</para>
 854 </formalpara>
 855 </blockquote>
 856
 857 <para>you get one that looks like this:</para>
 858
 859 <blockquote>
 860 <programlisting>&lt;indexdiv&gt;A&lt;/indexdiv&gt;
 861 &lt;indexentry&gt;
 862 &lt;primaryie&gt;ap1&lt;/primaryie&gt;,
 863 &lt;phrase role="pageno"&gt;1&lt;/phrase&gt;,
 864 &lt;phrase role="pageno"&gt;2&lt;/phrase&gt;,
 865 &lt;phrase role="pageno"&gt;3&lt;/phrase&gt;
 866 &lt;/indexentry&gt;</programlisting>
 867 </blockquote>
 868
 869 <para>After building a PDF file with this sort of odd-looking index, you can
 870 extract the text from the PDF file and the result is a proper index expressed in
 871 XML.</para>
 872
 873 <para>Now you have data that's amenable to processing and a simple Perl script
 874 (such as <filename>fo/pdf2index</filename>) can
 875 merge page ranges and generate a proper index.</para>
 876
 877 <para>Finally, reformat your original document using this literal index instead of
 878 an automatically generated one and <quote>bingo</quote>!</para>
 879
 880 </refsection>
 881 </refentry>
 882
 883 <refentry version="5.0" xml:id="index.method">
 884 <refmeta>
 885 <refentrytitle>index.method</refentrytitle>
 886 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
 887 <refmiscinfo class="other" otherclass="value">basic</refmiscinfo>
 888 <refmiscinfo class="other" otherclass="value">kosek</refmiscinfo>
 889 <refmiscinfo class="other" otherclass="value">kimber</refmiscinfo>
 890 </refmeta>
 891 <refnamediv>
 892 <refname>index.method</refname>
 893 <refpurpose>Select method used to group index entries in an index</refpurpose>
 894 </refnamediv>
 895
 896 <refsynopsisdiv>
 897 <programlisting xml:id="index.method.frag">
 898 &lt;xsl:param name="index.method"&gt;basic&lt;/xsl:param&gt;
 899 </programlisting>
 900 </refsynopsisdiv>
 901
 902 <refsection><info><title>Description</title></info>
 903
 904 <para>This parameter lets you select which method to use for sorting and grouping
 905  index entries in an index.
 906 Indexes in Latin-based languages that have accented characters typically
 907 sort together accented words and unaccented words.
 908 Thus <quote>&#193;</quote> (U+00C1 LATIN CAPITAL LETTER A WITH ACUTE) would sort together
 909 with <quote>A</quote> (U+0041 LATIN CAPITAL LETTER A), so both would appear in the <quote>A</quote>
 910 section of the index.
 911 Languages using other alphabets (such as Russian,  which is written in the Cyrillic alphabet)
 912 and languages using ideographic chararacters (such as Japanese)
 913 require grouping specific to the languages and alphabets.
 914 </para>
 915
 916 <para>The default indexing method is limited.
 917 It can group accented characters in Latin-based languages only.
 918 It cannot handle non-Latin alphabets or ideographic languages.
 919 The other indexing methods require extensions of one type or
 920 another, and do not work with
 921 all XSLT processors, which is why they are not used by default.</para>
 922
 923 <para>The three choices for indexing method are:</para>
 924 <variablelist>
 925 <varlistentry>
 926 <term><literal>basic</literal></term>
 927 <listitem>
 928 <para>
 929 (default)  Sort and groups words based only on the Latin alphabet.
 930 Words with accented Latin letters will group and sort with
 931 their respective primary letter, but
 932 words in non-Latin alphabets will be
 933 put in the <quote>Symbols</quote> section of the index.
 934 </para>
 935 </listitem>
 936 </varlistentry>
 937 <varlistentry>
 938 <term><literal>kosek</literal></term>
 939 <listitem>
 940 <para>
 941 This method sorts and groups words based on letter groups configured in
 942 the DocBook locale file for the given language.
 943 See, for example, the French locale file <filename>common/fr.xml</filename>.
 944 This method requires that the XSLT processor
 945 supports the EXSLT extensions (most do).
 946 It also requires support for using
 947 user-defined functions in xsl:key (xsltproc does not).
 948 </para>
 949 <para>This method is suitable for any language for which you can
 950 list all the individual characters that should appear
 951 in each letter group in an index.
 952 It is probably not practical to use it for ideographic languages
 953 such as Chinese that have hundreds or thousands of characters.
 954 </para>
 955
 956 <para>To use the kosek method, you must:</para>
 957
 958 <orderedlist>
 959 <listitem>
 960 <para>Use a processor that supports its extensions, such as
 961 Saxon 6 or Xalan (xsltproc and Saxon 8 do not).
 962 </para>
 963 </listitem>
 964 <listitem>
 965 <para>Set the index.method parameter's value to <quote>kosek</quote>.
 966 </para>
 967 </listitem>
 968 <listitem>
 969 <para>Import the appropriate index extensions stylesheet module
 970 <filename>fo/autoidx-kosek.xsl</filename> or
 971 <filename>html/autoidx-kosek.xsl</filename> into your
 972 customization.
 973 </para>
 974 </listitem>
 975 </orderedlist>
 976
 977 </listitem>
 978 </varlistentry>
 979 <varlistentry>
 980 <term><literal>kimber</literal></term>
 981 <listitem>
 982 <para>
 983 This method uses extensions to the Saxon processor to implement
 984 sophisticated indexing processes. It uses its own
 985 configuration file, which can include information for any number of
 986 languages. Each language's configuration can group
 987 words using one of two processes. In the
 988 enumerated process similar to that used in the kosek method,
 989 you indicate the groupings character-by-character.
 990 In the between-key process, you specify the
 991 break-points in the sort order that should start a new group.
 992 The latter configuration is useful for ideographic languages
 993 such as Chinese, Japanese, and Korean.
 994 You can also define your own collation algorithms and how you
 995 want mixed Latin-alphabet words sorted.</para>
 996 <itemizedlist>
 997 <listitem>
 998 <para>For a whitepaper describing the extensions, see:
 999 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.innodata-isogen.com/knowledge_center/white_papers/back_of_book_for_xsl_fo.pdf">http://www.innodata-isogen.com/knowledge_center/white_papers/back_of_book_for_xsl_fo.pdf</link>.
1000 </para>
1001 </listitem>
1002 <listitem>
1003 <para>To download the extension library, see
1004 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.innodata-isogen.com/knowledge_center/tools_downloads/i18nsupport">http://www.innodata-isogen.com/knowledge_center/tools_downloads/i18nsupport</link>.
1005 </para>
1006 </listitem>
1007 </itemizedlist>
1008
1009 <para>To use the kimber method, you must:</para>
1010
1011 <orderedlist>
1012 <listitem>
1013 <para>Use Saxon (version 6 or 8) as your XSLT processor.
1014 </para>
1015 </listitem>
1016 <listitem>
1017 <para>Install and configure the Innodata Isogen library, using
1018 the documentation that comes with it.
1019 </para>
1020 </listitem>
1021 <listitem>
1022 <para>Set the index.method parameter's value to <quote>kimber</quote>.
1023 </para>
1024 </listitem>
1025 <listitem>
1026 <para>Import the appropriate index extensions stylesheet module
1027 <filename>fo/autoidx-kimber.xsl</filename> or
1028 <filename>html/autoidx-kimber.xsl</filename> into your
1029 customization.
1030 </para>
1031 </listitem>
1032 </orderedlist>
1033
1034 </listitem>
1035 </varlistentry>
1036 </variablelist>
1037
1038 </refsection>
1039 </refentry>
1040
1041 <refentry version="5.0" xml:id="index.on.type">
1042 <refmeta>
1043 <refentrytitle>index.on.type</refentrytitle>
1044 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1045 </refmeta>
1046 <refnamediv>
1047 <refname>index.on.type</refname>
1048 <refpurpose>Select indexterms based on <tag class="attribute">type</tag>
1049 attribute value</refpurpose>
1050 </refnamediv>
1051
1052 <refsynopsisdiv>
1053 <programlisting xml:id="index.on.type.frag">
1054 &lt;xsl:param name="index.on.type" select="0"&gt;&lt;/xsl:param&gt;
1055 </programlisting>
1056 </refsynopsisdiv>
1057
1058 <refsection><info><title>Description</title></info>
1059
1060 <para>
1061 If non-zero,
1062 then an <tag>index</tag> element that has a
1063 <tag class="attribute">type</tag> attribute
1064 value will contain only those <tag>indexterm</tag>
1065 elements with a matching <tag class="attribute">type</tag> attribute value.
1066 If an <tag>index</tag> has no <tag class="attribute">type</tag>
1067 attribute or it is blank, then the index will contain
1068 all <tag>indexterm</tag>s in the current scope.
1069 </para>
1070
1071 <para>
1072 If <literal>index.on.type</literal> is zero, then the
1073 <tag class="attribute">type</tag> attribute has no effect
1074 on selecting indexterms for an index.
1075 </para>
1076
1077 <para>For those using DocBook version 4.2 or earlier,
1078 the <tag class="attribute">type</tag> attribute is not available
1079 for index terms.  However, you can achieve the same
1080 effect by using the <tag class="attribute">role</tag> attribute
1081 in the same manner on <tag>indexterm</tag>
1082 and <tag>index</tag>, and setting the stylesheet parameter
1083 <parameter>index.on.role</parameter> to a nonzero value.
1084 </para>
1085
1086 </refsection>
1087 </refentry>
1088
1089 <refentry version="5.0" xml:id="index.on.role">
1090 <refmeta>
1091 <refentrytitle>index.on.role</refentrytitle>
1092 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1093 </refmeta>
1094 <refnamediv>
1095 <refname>index.on.role</refname>
1096 <refpurpose>Select indexterms based on <tag class="attribute">role</tag> value</refpurpose>
1097 </refnamediv>
1098
1099 <refsynopsisdiv>
1100 <programlisting xml:id="index.on.role.frag">
1101 &lt;xsl:param name="index.on.role" select="0"&gt;&lt;/xsl:param&gt;
1102 </programlisting>
1103 </refsynopsisdiv>
1104
1105 <refsection><info><title>Description</title></info>
1106
1107 <para>
1108 If non-zero,
1109 then an <tag>index</tag> element that has a
1110 <tag class="attribute">role</tag> attribute
1111 value will contain only those <tag>indexterm</tag>
1112 elements with a matching role value.
1113 If an <tag>index</tag> has no <tag class="attribute">role</tag>
1114 attribute or it is blank, then the index will contain
1115 all <tag>indexterm</tag>s in the current scope.
1116 </para>
1117 <para>
1118 If <literal>index.on.role</literal> is zero, then the
1119 <tag class="attribute">role</tag> attribute has no effect
1120 on selecting indexterms for an index.
1121 </para>
1122
1123 <para>If you are using DocBook version 4.3 or later, you should
1124 use the <tag class="attribute">type</tag> attribute instead of <tag class="attribute">role</tag>
1125 on <tag>indexterm</tag> and <tag>index</tag>,
1126 and set the <parameter>index.on.type</parameter> to a nonzero
1127 value.
1128 </para>
1129
1130 </refsection>
1131 </refentry>
1132
1133 <refentry version="5.0" xml:id="index.preferred.page.properties">
1134 <refmeta>
1135 <refentrytitle>index.preferred.page.properties</refentrytitle>
1136 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
1137 </refmeta>
1138 <refnamediv>
1139 <refname>index.preferred.page.properties</refname>
1140 <refpurpose>Properties used to emphasize page number references for
1141 significant index terms</refpurpose>
1142 </refnamediv>
1143
1144 <refsynopsisdiv>
1145 <programlisting xml:id="index.preferred.page.properties.frag">
1146 &lt;xsl:attribute-set name="index.preferred.page.properties"&gt;
1147   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
1148 &lt;/xsl:attribute-set&gt;
1149 </programlisting>
1150 </refsynopsisdiv>
1151
1152 <refsection><info><title>Description</title></info>
1153
1154 <para>Properties used to emphasize page number references for
1155 significant index terms (<tag class="attribute">significance</tag>=<tag class="attvalue">preferred</tag>). Currently works only with
1156 XEP.</para>
1157
1158 </refsection>
1159 </refentry>
1160
1161 <refentry version="5.0" xml:id="index.entry.properties">
1162 <refmeta>
1163 <refentrytitle>index.entry.properties</refentrytitle>
1164 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
1165 </refmeta>
1166 <refnamediv>
1167 <refname>index.entry.properties</refname>
1168 <refpurpose>Properties applied to the formatted entries
1169 in an index</refpurpose>
1170 </refnamediv>
1171
1172 <refsynopsisdiv>
1173 <programlisting xml:id="index.entry.properties.frag">
1174 &lt;xsl:attribute-set name="index.entry.properties"&gt;
1175   &lt;xsl:attribute name="start-indent"&gt;0pt&lt;/xsl:attribute&gt;
1176 &lt;/xsl:attribute-set&gt;
1177 </programlisting>
1178 </refsynopsisdiv>
1179
1180 <refsection><info><title>Description</title></info>
1181
1182 <para>This attribute set is applied to the block containing
1183 the entries in a letter division in an index.  It can be used to set the
1184 font-size, font-family, and other inheritable properties that will be
1185 applied to all index entries.</para>
1186
1187 </refsection>
1188 </refentry>
1189
1190 <refentry version="5.0" xml:id="index.div.title.properties">
1191 <refmeta>
1192 <refentrytitle>index.div.title.properties</refentrytitle>
1193 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
1194 </refmeta>
1195 <refnamediv>
1196 <refname>index.div.title.properties</refname>
1197 <refpurpose>Properties associated with the letter headings in an
1198 index</refpurpose>
1199 </refnamediv>
1200
1201 <refsynopsisdiv>
1202 <programlisting xml:id="index.div.title.properties.frag">
1203 &lt;xsl:attribute-set name="index.div.title.properties"&gt;
1204   &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;0pt&lt;/xsl:attribute&gt;
1205   &lt;xsl:attribute name="font-size"&gt;14.4pt&lt;/xsl:attribute&gt;
1206   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$title.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
1207   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
1208   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
1209   &lt;xsl:attribute name="space-before.optimum"&gt;&lt;xsl:value-of select="concat($body.font.master,'pt')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
1210   &lt;xsl:attribute name="space-before.minimum"&gt;&lt;xsl:value-of select="concat($body.font.master,'pt * 0.8')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
1211   &lt;xsl:attribute name="space-before.maximum"&gt;&lt;xsl:value-of select="concat($body.font.master,'pt * 1.2')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
1212   &lt;xsl:attribute name="start-indent"&gt;0pt&lt;/xsl:attribute&gt;
1213 &lt;/xsl:attribute-set&gt;
1214 </programlisting>
1215 </refsynopsisdiv>
1216
1217 <refsection><info><title>Description</title></info>
1218
1219 <para>This attribute set is used on the letter headings that separate
1220 the divisions in an index.</para>
1221
1222 </refsection>
1223 </refentry>
1224
1225 <refentry version="5.0" xml:id="autolink.index.see">
1226 <refmeta>
1227 <refentrytitle>autolink.index.see</refentrytitle>
1228 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1229 </refmeta>
1230 <refnamediv>
1231 <refname>autolink.index.see</refname>
1232 <refpurpose>Link index see and seealso to index primary</refpurpose>
1233 </refnamediv>
1234
1235 <refsynopsisdiv>
1236 <programlisting xml:id="autolink.index.see.frag">&lt;xsl:param name="autolink.index.see" select="1"&gt;&lt;/xsl:param&gt;</programlisting>
1237 </refsynopsisdiv>
1238
1239 <refsection><info><title>Description</title></info>
1240
1241 <para>If this param is set to a non-zero value,
1242 (default = 1), then the
1243 stylesheet will attempt for form a link between a
1244 <tag>see</tag> or <tag>seealso</tag> element
1245 and a matching indexterm <tag>primary</tag> element.
1246 </para>
1247
1248 <para>The stylesheet uses an exact text match after
1249 applying the <literal>normalize-space()</literal> function.
1250 If the <tag>see</tag> or <tag>seealso</tag> text contains a comma,
1251 then only the text prior to the comma is used.
1252 This assumes the author is using the convention "see primary, secondary"
1253 to specify a subentry.  Automatic links always land on the primary
1254 entry in the index, so the reader has to look down to see the
1255 secondary entry.</para>
1256 <para>If there is no match on a
1257 <tag>primary</tag>, no link is formed, but the text
1258 still displays.</para>
1259
1260 <para>No attempt is made to automatically link to text in
1261 <tag>secondary</tag> or <tag>tertiary</tag> elements.
1262 If you want to link to such elements, you can form a
1263 manual link by adding a linkend attribute to the
1264 <tag>see</tag> or <tag>seealso</tag> element, where
1265 the linkend references an id or xml:id attribute on
1266 such a subelement.  Such manual links take precedence over
1267 any automatic links.
1268 </para>
1269
1270 <para>If this parameter is zero, then
1271 no automatic links from see and seealso
1272 are formed within the index.  Any manual links are
1273 still processed, however.</para>
1274
1275 </refsection>
1276 </refentry>
1277
1278 <refentry version="5.0" xml:id="index.number.separator">
1279 <refmeta>
1280 <refentrytitle>index.number.separator</refentrytitle>
1281 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
1282 </refmeta>
1283 <refnamediv>
1284 <refname>index.number.separator</refname>
1285 <refpurpose>Override for punctuation separating page numbers in index</refpurpose>
1286 </refnamediv>
1287
1288 <refsynopsisdiv>
1289 <programlisting xml:id="index.number.separator.frag">
1290 &lt;xsl:param name="index.number.separator"&gt;&lt;/xsl:param&gt;
1291 </programlisting>
1292 </refsynopsisdiv>
1293
1294 <refsection><info><title>Description</title></info>
1295
1296 <para>This parameter permits you to override the text to insert between
1297 page references in a formatted index entry.  Typically
1298 that would be a comma and a space.
1299 </para>
1300
1301 <para>Because this text may be locale dependent,
1302 this parameter's value is normally taken from a gentext
1303 template named 'number-separator' in the
1304 context 'index' in the stylesheet
1305 locale file for the language
1306 of the current document.
1307 This parameter can be used to override the gentext string,
1308 and would typically be used on the command line.
1309 This parameter would apply to all languages.
1310 </para>
1311
1312 <para>So this text string can be customized in two ways.
1313 You can reset the default gentext string using
1314 the <parameter>local.l10n.xml</parameter> parameter, or you can
1315 override the gentext with the content of this parameter.
1316 The content can be a simple string, or it can be
1317 something more complex such as a call-template.
1318 </para>
1319
1320 <para>In HTML index output, section title references are used instead of
1321 page number references.  This punctuation appears between
1322 such section titles in an HTML index.
1323 </para>
1324
1325 </refsection>
1326 </refentry>
1327
1328 <refentry version="5.0" xml:id="index.range.separator">
1329 <refmeta>
1330 <refentrytitle>index.range.separator</refentrytitle>
1331 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
1332 </refmeta>
1333 <refnamediv>
1334 <refname>index.range.separator</refname>
1335 <refpurpose>Override for punctuation separating the two numbers
1336 in a page range in index</refpurpose>
1337 </refnamediv>
1338
1339 <refsynopsisdiv>
1340 <programlisting xml:id="index.range.separator.frag">
1341 &lt;xsl:param name="index.range.separator"&gt;&lt;/xsl:param&gt;
1342 </programlisting>
1343 </refsynopsisdiv>
1344
1345 <refsection><info><title>Description</title></info>
1346
1347 <para>This parameter permits you
1348 to override the text to insert between
1349 the two numbers of a page range in an index.
1350 This parameter is only used by those XSL-FO processors
1351 that support an extension for generating such page ranges
1352 (such as XEP).</para>
1353
1354 <para>Because this text may be locale dependent,
1355 this parameter's value is normally taken from a gentext
1356 template named 'range-separator' in the
1357 context 'index' in the stylesheet
1358 locale file for the language
1359 of the current document.
1360 This parameter can be used to override the gentext string,
1361 and would typically be used on the command line.
1362 This parameter would apply to all languages.
1363 </para>
1364
1365 <para>So this text string can be customized in two ways.
1366 You can reset the default gentext string using
1367 the <parameter>local.l10n.xml</parameter> parameter, or you can
1368 override the gentext with the content of this parameter.
1369 The content can be a simple string, or it can be
1370 something more complex such as a call-template.
1371 </para>
1372
1373 <para>In HTML index output, section title references are used instead of
1374 page number references. So there are no page ranges
1375 and this parameter has no effect.
1376 </para>
1377
1378 </refsection>
1379 </refentry>
1380
1381 <refentry version="5.0" xml:id="index.term.separator">
1382 <refmeta>
1383 <refentrytitle>index.term.separator</refentrytitle>
1384 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
1385 </refmeta>
1386 <refnamediv>
1387 <refname>index.term.separator</refname>
1388 <refpurpose>Override for punctuation separating an index term
1389 from its list of page references in an index</refpurpose>
1390 </refnamediv>
1391
1392 <refsynopsisdiv>
1393 <programlisting xml:id="index.term.separator.frag">
1394 &lt;xsl:param name="index.term.separator"&gt;&lt;/xsl:param&gt;
1395 </programlisting>
1396 </refsynopsisdiv>
1397
1398 <refsection><info><title>Description</title></info>
1399
1400 <para>This parameter permits you to override
1401 the text to insert between
1402 the end of an index term and its list of page references.
1403 Typically that might be a comma and a space.
1404 </para>
1405
1406 <para>Because this text may be locale dependent,
1407 this parameter's value is normally taken from a gentext
1408 template named 'term-separator' in the
1409 context 'index' in the stylesheet
1410 locale file for the language
1411 of the current document.
1412 This parameter can be used to override the gentext string,
1413 and would typically be used on the command line.
1414 This parameter would apply to all languages.
1415 </para>
1416
1417 <para>So this text string can be customized in two ways.
1418 You can reset the default gentext string using
1419 the <parameter>local.l10n.xml</parameter> parameter, or you can
1420 fill in the content for this normally empty
1421 override parameter.
1422 The content can be a simple string, or it can be
1423 something more complex such as a call-template.
1424 For fo output, it could be an <tag>fo:leader</tag>
1425 element to provide space of a specific length, or a dot leader.
1426 </para>
1427
1428 </refsection>
1429 </refentry>
1430
1431 <refentry version="5.0" xml:id="xep.index.item.properties">
1432 <refmeta>
1433 <refentrytitle>xep.index.item.properties</refentrytitle>
1434 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
1435 </refmeta>
1436 <refnamediv>
1437 <refname>xep.index.item.properties</refname>
1438 <refpurpose>Properties associated with XEP index-items</refpurpose>
1439 </refnamediv>
1440
1441 <refsynopsisdiv>
1442 <programlisting xml:id="xep.index.item.properties.frag">
1443 &lt;xsl:attribute-set name="xep.index.item.properties" use-attribute-sets="index.page.number.properties"&gt;
1444   &lt;xsl:attribute name="merge-subsequent-page-numbers"&gt;true&lt;/xsl:attribute&gt;
1445   &lt;xsl:attribute name="link-back"&gt;true&lt;/xsl:attribute&gt;
1446 &lt;/xsl:attribute-set&gt;
1447 </programlisting>
1448 </refsynopsisdiv>
1449
1450 <refsection><info><title>Description</title></info>
1451
1452 <para>Properties associated with XEP index-items, which generate
1453 page numbers in an index processed by XEP. For more info see
1454 the XEP documentation section "Indexes" in
1455 <uri xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.renderx.com/reference.html#Indexes">http://www.renderx.com/reference.html#Indexes</uri>.</para>
1456
1457 <para>This attribute-set also adds by default any properties from the
1458 <tag class="attribute">index.page.number.properties</tag>
1459 attribute-set.</para>
1460 </refsection>
1461 </refentry>
1462
1463 <refentry version="5.0" xml:id="toc.section.depth">
1464 <refmeta>
1465 <refentrytitle>toc.section.depth</refentrytitle>
1466 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
1467 </refmeta>
1468 <refnamediv>
1469 <refname>toc.section.depth</refname>
1470 <refpurpose>How deep should recursive <tag>section</tag>s appear
1471 in the TOC?</refpurpose>
1472 </refnamediv>
1473
1474 <refsynopsisdiv>
1475 <programlisting xml:id="toc.section.depth.frag">&lt;xsl:param name="toc.section.depth"&gt;2&lt;/xsl:param&gt;</programlisting>
1476 </refsynopsisdiv>
1477
1478 <refsection><info><title>Description</title></info>
1479
1480 <para>Specifies the depth to which recursive sections should appear in the
1481 TOC.
1482 </para>
1483
1484 </refsection>
1485 </refentry>
1486
1487 <refentry version="5.0" xml:id="toc.max.depth">
1488 <refmeta>
1489 <refentrytitle>toc.max.depth</refentrytitle>
1490 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
1491 </refmeta>
1492 <refnamediv>
1493 <refname>toc.max.depth</refname>
1494 <refpurpose>How many levels should be created for each TOC?</refpurpose>
1495 </refnamediv>
1496
1497 <refsynopsisdiv>
1498 <programlisting xml:id="toc.max.depth.frag">&lt;xsl:param name="toc.max.depth"&gt;8&lt;/xsl:param&gt;</programlisting>
1499 </refsynopsisdiv>
1500
1501 <refsection><info><title>Description</title></info>
1502
1503 <para>Specifies the maximal depth of TOC on all levels.</para>
1504
1505 </refsection>
1506 </refentry>
1507
1508 <refentry version="5.0" xml:id="toc.indent.width">
1509 <refmeta>
1510 <refentrytitle>toc.indent.width</refentrytitle>
1511 <refmiscinfo class="other" otherclass="datatype">float</refmiscinfo>
1512 </refmeta>
1513 <refnamediv>
1514 <refname>toc.indent.width</refname>
1515 <refpurpose>Amount of indentation for TOC entries</refpurpose>
1516 </refnamediv>
1517
1518 <refsynopsisdiv>
1519 <programlisting xml:id="toc.indent.width.frag">
1520 &lt;xsl:param name="toc.indent.width"&gt;24&lt;/xsl:param&gt;
1521 &lt;!-- inconsistant point specification? --&gt;
1522 </programlisting>
1523 </refsynopsisdiv>
1524
1525 <refsection><info><title>Description</title></info>
1526
1527 <para>Specifies, in points, the distance by which each level of the
1528 TOC is indented from its parent.</para>
1529
1530 <para>This value is expressed in points, without
1531 a unit (in other words, it is a bare number). Using a bare number allows the stylesheet
1532 to perform calculations that would otherwise have to be performed by the FO processor
1533 because not all processors support expressions.</para>
1534
1535 </refsection>
1536 </refentry>
1537
1538 <refentry version="5.0" xml:id="toc.line.properties">
1539 <refmeta>
1540 <refentrytitle>toc.line.properties</refentrytitle>
1541 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
1542 </refmeta>
1543 <refnamediv>
1544 <refname>toc.line.properties</refname>
1545 <refpurpose>Properties for lines in ToCs and LoTs</refpurpose>
1546 </refnamediv>
1547
1548 <refsynopsisdiv>
1549 <programlisting xml:id="toc.line.properties.frag">
1550 &lt;xsl:attribute-set name="toc.line.properties"&gt;
1551   &lt;xsl:attribute name="text-align-last"&gt;justify&lt;/xsl:attribute&gt;
1552   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;
1553   &lt;xsl:attribute name="end-indent"&gt;&lt;xsl:value-of select="concat($toc.indent.width, 'pt')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
1554   &lt;xsl:attribute name="last-line-end-indent"&gt;&lt;xsl:value-of select="concat('-', $toc.indent.width, 'pt')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
1555 &lt;/xsl:attribute-set&gt;
1556 </programlisting>
1557 </refsynopsisdiv>
1558
1559 <refsection><info><title>Description</title></info>
1560
1561 <para>Properties which are applied to every line in ToC (or LoT). You can
1562 modify them in order to change appearance of all, or some lines. For
1563 example, in order to make lines for chapters bold, specify the
1564 following in your customization layer:</para>
1565
1566 <programlisting>&lt;xsl:attribute-set name="toc.line.properties"&gt;
1567   &lt;xsl:attribute name="font-weight"&gt;
1568    &lt;xsl:choose&gt;
1569     &lt;xsl:when test="self::chapter"&gt;bold&lt;/xsl:when&gt;
1570     &lt;xsl:otherwise&gt;normal&lt;/xsl:otherwise&gt;
1571    &lt;/xsl:choose&gt;
1572   &lt;/xsl:attribute&gt;
1573 &lt;/xsl:attribute-set&gt;</programlisting>
1574
1575 </refsection>
1576 </refentry>
1577
1578 <refentry version="5.0" xml:id="toc.leader.properties">
1579 <refmeta>
1580 <refentrytitle>toc.leader.properties</refentrytitle>
1581 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
1582 </refmeta>
1583 <refnamediv>
1584 <refname>toc.leader.properties</refname>
1585 <refpurpose>How the leaders (rows of dots) are going to look like in ToC?</refpurpose>
1586 </refnamediv>
1587
1588 <refsynopsisdiv>
1589 <programlisting xml:id="toc.leader.properties.frag">
1590 &lt;xsl:attribute-set name="toc.leader.properties"&gt;
1591   &lt;xsl:attribute name="leader-pattern"&gt;dots&lt;/xsl:attribute&gt;
1592   &lt;xsl:attribute name="leader-pattern-width"&gt;3pt&lt;/xsl:attribute&gt;
1593   &lt;xsl:attribute name="leader-alignment"&gt;reference-area&lt;/xsl:attribute&gt;
1594   &lt;xsl:attribute name="padding-left"&gt;3pt&lt;/xsl:attribute&gt;
1595   &lt;xsl:attribute name="padding-right"&gt;3pt&lt;/xsl:attribute&gt;
1596 &lt;/xsl:attribute-set&gt;
1597 </programlisting>
1598 </refsynopsisdiv>
1599 <refsection><info><title>Description</title></info>
1600 <para>Specify leader pattern, </para>
1601 </refsection>
1602 </refentry>
1603
1604
1605 <refentry version="5.0" xml:id="toc.margin.properties">
1606 <refmeta>
1607 <refentrytitle>toc.margin.properties</refentrytitle>
1608 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
1609 </refmeta>
1610 <refnamediv>
1611 <refname>toc.margin.properties</refname>
1612 <refpurpose>Margin properties used on Tables of Contents</refpurpose>
1613 </refnamediv>
1614
1615 <refsynopsisdiv>
1616 <programlisting xml:id="toc.margin.properties.frag">
1617 &lt;xsl:attribute-set name="toc.margin.properties"&gt;
1618   &lt;xsl:attribute name="space-before.minimum"&gt;0.5em&lt;/xsl:attribute&gt;
1619   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
1620   &lt;xsl:attribute name="space-before.maximum"&gt;2em&lt;/xsl:attribute&gt;
1621   &lt;xsl:attribute name="space-after.minimum"&gt;0.5em&lt;/xsl:attribute&gt;
1622   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;
1623   &lt;xsl:attribute name="space-after.maximum"&gt;2em&lt;/xsl:attribute&gt;
1624 &lt;/xsl:attribute-set&gt;
1625 </programlisting>
1626 </refsynopsisdiv>
1627
1628 <refsection><info><title>Description</title></info>
1629 <para>This attribute set is used on Tables of Contents. These attributes are set
1630 on the wrapper that surrounds the ToC block, not on each individual lines.</para>
1631 </refsection>
1632 </refentry>
1633
1634 <refentry version="5.0" xml:id="bridgehead.in.toc">
1635 <refmeta>
1636 <refentrytitle>bridgehead.in.toc</refentrytitle>
1637 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1638 </refmeta>
1639 <refnamediv>
1640 <refname>bridgehead.in.toc</refname>
1641 <refpurpose>Should bridgehead elements appear in the TOC?</refpurpose>
1642 </refnamediv>
1643
1644 <refsynopsisdiv>
1645 <programlisting xml:id="bridgehead.in.toc.frag">&lt;xsl:param name="bridgehead.in.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1646 </refsynopsisdiv>
1647
1648 <refsection><info><title>Description</title></info>
1649
1650 <para>If non-zero, <tag>bridgehead</tag>s appear in the TOC. Note that
1651 this option is not fully supported and may be removed in a future
1652 version of the stylesheets.
1653 </para>
1654
1655 </refsection>
1656 </refentry>
1657
1658 <refentry version="5.0" xml:id="simplesect.in.toc">
1659 <refmeta>
1660 <refentrytitle>simplesect.in.toc</refentrytitle>
1661 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1662 </refmeta>
1663 <refnamediv>
1664 <refname>simplesect.in.toc</refname>
1665 <refpurpose>Should <tag>simplesect</tag> elements appear in the TOC?</refpurpose>
1666 </refnamediv>
1667
1668 <refsynopsisdiv>
1669 <programlisting xml:id="simplesect.in.toc.frag">&lt;xsl:param name="simplesect.in.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1670 </refsynopsisdiv>
1671
1672 <refsection><info><title>Description</title></info>
1673
1674 <para>If non-zero, <tag>simplesect</tag>s will be included in the TOC.
1675 </para>
1676
1677 </refsection>
1678 </refentry>
1679
1680 <refentry version="5.0" xml:id="generate.section.toc.level">
1681 <refmeta>
1682 <refentrytitle>generate.section.toc.level</refentrytitle>
1683 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
1684 </refmeta>
1685 <refnamediv>
1686 <refname>generate.section.toc.level</refname>
1687 <refpurpose>Control depth of TOC generation in sections</refpurpose>
1688 </refnamediv>
1689
1690 <refsynopsisdiv>
1691 <programlisting xml:id="generate.section.toc.level.frag">
1692 &lt;xsl:param name="generate.section.toc.level" select="0"&gt;&lt;/xsl:param&gt;
1693 </programlisting>
1694 </refsynopsisdiv>
1695
1696 <refsection><info><title>Description</title></info>
1697
1698 <para>The <parameter>generate.section.toc.level</parameter> parameter
1699 controls the depth of <tag>section</tag> in which TOCs will be generated. Note
1700 that this is related to, but not the same as
1701 <parameter>toc.section.depth</parameter>, which controls the depth to
1702 which TOC entries will be generated in a given TOC.</para>
1703 <para>If, for example, <parameter>generate.section.toc.level</parameter>
1704 is <literal>3</literal>, TOCs will be generated in first, second, and third
1705 level sections, but not in fourth level sections.
1706 </para>
1707
1708 </refsection>
1709 </refentry>
1710
1711
1712
1713
1714 </reference>
1715 <reference xml:id="fo_ext"><title>Processor Extensions</title>
1716 <refentry version="5.0" xml:id="arbortext.extensions">
1717 <refmeta>
1718 <refentrytitle>arbortext.extensions</refentrytitle>
1719 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1720 </refmeta>
1721 <refnamediv>
1722 <refname>arbortext.extensions</refname>
1723 <refpurpose>Enable Arbortext extensions?</refpurpose>
1724 </refnamediv>
1725
1726 <refsynopsisdiv>
1727 <programlisting xml:id="arbortext.extensions.frag">&lt;xsl:param name="arbortext.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1728 </refsynopsisdiv>
1729
1730 <refsection><info><title>Description</title></info>
1731
1732 <para>If non-zero,
1733 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.arbortext.com/">Arbortext</link>
1734 extensions will be used.
1735 </para>
1736 <para>This parameter can also affect which graphics file formats
1737 are supported</para>
1738
1739 </refsection>
1740 </refentry>
1741
1742 <refentry version="5.0" xml:id="axf.extensions">
1743 <refmeta>
1744 <refentrytitle>axf.extensions</refentrytitle>
1745 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1746 </refmeta>
1747 <refnamediv>
1748 <refname>axf.extensions</refname>
1749 <refpurpose>Enable XSL Formatter extensions?</refpurpose>
1750 </refnamediv>
1751
1752 <refsynopsisdiv>
1753 <programlisting xml:id="axf.extensions.frag">
1754 &lt;xsl:param name="axf.extensions" select="0"&gt;&lt;/xsl:param&gt;
1755 </programlisting>
1756 </refsynopsisdiv>
1757
1758 <refsection><info><title>Description</title></info>
1759
1760 <para>If non-zero,
1761 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.antennahouse.com/">XSL Formatter</link>
1762 extensions will be used. XSL Formatter extensions consists of PDF bookmarks,
1763 document information and better index processing.</para>
1764
1765 <para>This parameter can also affect which graphics file formats
1766 are supported</para>
1767
1768 </refsection>
1769 </refentry>
1770
1771 <refentry version="5.0" xml:id="fop.extensions">
1772 <refmeta>
1773 <refentrytitle>fop.extensions</refentrytitle>
1774 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1775 </refmeta>
1776 <refnamediv>
1777 <refname>fop.extensions</refname>
1778 <refpurpose>Enable extensions for FOP version 0.20.5 and earlier</refpurpose>
1779 </refnamediv>
1780
1781 <refsynopsisdiv>
1782 <programlisting xml:id="fop.extensions.frag">&lt;xsl:param name="fop.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1783 </refsynopsisdiv>
1784
1785 <refsection><info><title>Description</title></info>
1786
1787 <para>If non-zero, extensions intended for
1788 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://xml.apache.org/fop/">FOP</link>
1789 version 0.20.5 and earlier will be used.
1790 At present, this consists of PDF bookmarks.
1791 </para>
1792
1793 <para>This parameter can also affect which graphics file formats
1794 are supported.</para>
1795
1796 <para>If you are using a version of FOP beyond
1797 version 0.20.5, then use the <parameter>fop1.extensions</parameter> parameter
1798 instead.
1799 </para>
1800 </refsection>
1801 </refentry>
1802
1803 <refentry version="5.0" xml:id="fop1.extensions">
1804 <refmeta>
1805 <refentrytitle>fop1.extensions</refentrytitle>
1806 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1807 </refmeta>
1808 <refnamediv>
1809 <refname>fop1.extensions</refname>
1810 <refpurpose>Enable extensions for FOP version 0.90 and later</refpurpose>
1811 </refnamediv>
1812
1813 <refsynopsisdiv>
1814 <programlisting xml:id="fop1.extensions.frag">&lt;xsl:param name="fop1.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1815 </refsynopsisdiv>
1816
1817 <refsection><info><title>Description</title></info>
1818
1819 <para>If non-zero, extensions for
1820 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://xml.apache.org/fop/">FOP</link>
1821 version 0.90 and later will be used.
1822 </para>
1823
1824 <para>This parameter can also affect which graphics file formats
1825 are supported.</para>
1826
1827 <para>The original <parameter>fop.extensions</parameter> parameter
1828 should still be used for FOP version 0.20.5 and earlier.
1829 </para>
1830 </refsection>
1831 </refentry>
1832
1833 <refentry version="5.0" xml:id="passivetex.extensions">
1834 <refmeta>
1835 <refentrytitle>passivetex.extensions</refentrytitle>
1836 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1837 </refmeta>
1838 <refnamediv>
1839 <refname>passivetex.extensions</refname>
1840 <refpurpose>Enable PassiveTeX extensions?</refpurpose>
1841 </refnamediv>
1842
1843 <refsynopsisdiv>
1844 <programlisting xml:id="passivetex.extensions.frag">&lt;xsl:param name="passivetex.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1845 </refsynopsisdiv>
1846
1847 <refsection><info><title>Description</title></info>
1848
1849 <important><para>The PassiveTeX XSL-FO processor is
1850 no longer supported by DocBook XSL, beginning with version 1.78.</para></important>
1851
1852 <para>PassiveTeX was never a complete implementation of
1853 XSL-FO, and development has ceased. Setting this parameter will
1854 have no effect on the output.</para>
1855
1856 </refsection>
1857 </refentry>
1858
1859 <refentry version="5.0" xml:id="tex.math.in.alt">
1860 <refmeta>
1861 <refentrytitle>tex.math.in.alt</refentrytitle>
1862 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
1863 <refmiscinfo class="other" otherclass="value">plain</refmiscinfo>
1864 <refmiscinfo class="other" otherclass="value">latex</refmiscinfo>
1865 </refmeta>
1866 <refnamediv>
1867 <refname>tex.math.in.alt</refname>
1868 <refpurpose>TeX notation used for equations</refpurpose>
1869 </refnamediv>
1870
1871 <refsynopsisdiv>
1872 <programlisting xml:id="tex.math.in.alt.frag">
1873 &lt;xsl:param name="tex.math.in.alt"&gt;&lt;/xsl:param&gt;
1874 </programlisting>
1875 </refsynopsisdiv>
1876
1877 <refsection><info><title>Description</title></info>
1878
1879 <para>If you want type math directly in TeX notation in equations,
1880 this parameter specifies notation used. Currently are supported two
1881 values -- <literal>plain</literal> and <literal>latex</literal>. Empty
1882 value means that you are not using TeX math at all.</para>
1883
1884 <para>Preferred way for including TeX alternative of math is inside of
1885 <tag>textobject</tag> element. Eg.:</para>
1886
1887 <programlisting>&lt;inlineequation&gt;
1888 &lt;inlinemediaobject&gt;
1889 &lt;imageobject&gt;
1890 &lt;imagedata fileref="eq1.gif"/&gt;
1891 &lt;/imageobject&gt;
1892 &lt;textobject&gt;&lt;phrase&gt;E=mc squared&lt;/phrase&gt;&lt;/textobject&gt;
1893 &lt;textobject role="tex"&gt;&lt;phrase&gt;E=mc^2&lt;/phrase&gt;&lt;/textobject&gt;
1894 &lt;/inlinemediaobject&gt;
1895 &lt;/inlineequation&gt;</programlisting>
1896
1897 <para>If you are using <tag>graphic</tag> element, you can
1898 store TeX inside <tag>alt</tag> element:</para>
1899
1900 <programlisting>&lt;inlineequation&gt;
1901 &lt;alt role="tex"&gt;a^2+b^2=c^2&lt;/alt&gt;
1902 &lt;graphic fileref="a2b2c2.gif"/&gt;
1903 &lt;/inlineequation&gt;</programlisting>
1904
1905 <para>If you want use this feature, you should process your FO with
1906 PassiveTeX, which only supports TeX math notation. When calling
1907 stylsheet, don't forget to specify also
1908 passivetex.extensions=1.</para>
1909
1910 <para>If you want equations in HTML, just process generated file
1911 <filename>tex-math-equations.tex</filename> by TeX or LaTeX. Then run
1912 dvi2bitmap program on result DVI file. You will get images for
1913 equations in your document.</para>
1914
1915 <warning>
1916   <para>This feature is useful for print/PDF output only if you
1917     use the obsolete and now unsupported PassiveTeX XSL-FO
1918     engine.</para>
1919 </warning>
1920
1921 </refsection>
1922
1923 <refsection><info><title>Related Parameters</title></info>
1924   <para><parameter>tex.math.delims</parameter>,
1925     <parameter>passivetex.extensions</parameter>,
1926     <parameter>tex.math.file</parameter></para>
1927 </refsection>
1928
1929 </refentry>
1930
1931 <refentry version="5.0" xml:id="tex.math.delims">
1932 <refmeta>
1933 <refentrytitle>tex.math.delims</refentrytitle>
1934 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1935 </refmeta>
1936 <refnamediv>
1937 <refname>tex.math.delims</refname>
1938 <refpurpose>Should equations output for processing by TeX be
1939 surrounded by math mode delimiters?</refpurpose>
1940 </refnamediv>
1941
1942 <refsynopsisdiv>
1943 <programlisting xml:id="tex.math.delims.frag">
1944 &lt;xsl:param name="tex.math.delims" select="1"&gt;&lt;/xsl:param&gt;
1945 </programlisting>
1946 </refsynopsisdiv>
1947
1948 <refsection><info><title>Description</title></info>
1949
1950 <para>For compatibility with DSSSL based DBTeXMath from Allin Cottrell
1951 you should set this parameter to 0.</para>
1952
1953 <warning>
1954   <para>This feature is useful for print/PDF output only if you
1955   use the obsolete and now unsupported PassiveTeX XSL-FO
1956   engine.</para>
1957 </warning>
1958
1959 </refsection>
1960 <refsection><info><title>Related Parameters</title></info>
1961   <para><parameter>tex.math.in.alt</parameter>,
1962     <parameter>passivetex.extensions</parameter></para>
1963 </refsection>
1964
1965 <refsection><info><title>See Also</title></info>
1966   <para>You can also use the <tag class="xmlpi">dbtex delims</tag> processing
1967     instruction to control whether delimiters are output.</para>
1968 </refsection>
1969
1970
1971 </refentry>
1972
1973 <refentry version="5.0" xml:id="xep.extensions">
1974 <refmeta>
1975 <refentrytitle>xep.extensions</refentrytitle>
1976 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1977 </refmeta>
1978 <refnamediv>
1979 <refname>xep.extensions</refname>
1980 <refpurpose>Enable XEP extensions?</refpurpose>
1981 </refnamediv>
1982
1983 <refsynopsisdiv>
1984 <programlisting xml:id="xep.extensions.frag">&lt;xsl:param name="xep.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1985 </refsynopsisdiv>
1986
1987 <refsection><info><title>Description</title></info>
1988
1989 <para>If non-zero,
1990 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.renderx.com/">XEP</link>
1991 extensions will be used. XEP extensions consists of PDF bookmarks,
1992 document information and better index processing.
1993 </para>
1994
1995 <para>This parameter can also affect which graphics file formats
1996 are supported</para>
1997 </refsection>
1998 </refentry>
1999
2000 </reference>
2001 <reference xml:id="dbk_ext"><title>Stylesheet Extensions</title>
2002 <refentry version="5.0" xml:id="linenumbering.everyNth">
2003 <refmeta>
2004 <refentrytitle>linenumbering.everyNth</refentrytitle>
2005 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
2006 </refmeta>
2007 <refnamediv>
2008 <refname>linenumbering.everyNth</refname>
2009 <refpurpose>Indicate which lines should be numbered</refpurpose>
2010 </refnamediv>
2011
2012 <refsynopsisdiv>
2013 <programlisting xml:id="linenumbering.everyNth.frag">
2014 &lt;xsl:param name="linenumbering.everyNth"&gt;5&lt;/xsl:param&gt;
2015 </programlisting>
2016 </refsynopsisdiv>
2017
2018 <refsection><info><title>Description</title></info>
2019
2020 <para>If line numbering is enabled, everyNth line will be
2021 numbered. Note that numbering is one based, not zero based.
2022 </para>
2023 <para>See also <parameter>linenumbering.extension</parameter>,
2024 <parameter>linenumbering.separator</parameter>,
2025 <parameter>linenumbering.width</parameter> and
2026 <parameter>use.extensions</parameter></para>
2027
2028 </refsection>
2029 </refentry>
2030
2031 <refentry version="5.0" xml:id="linenumbering.extension">
2032 <refmeta>
2033 <refentrytitle>linenumbering.extension</refentrytitle>
2034 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2035 </refmeta>
2036 <refnamediv>
2037 <refname>linenumbering.extension</refname>
2038 <refpurpose>Enable the line numbering extension</refpurpose>
2039 </refnamediv>
2040
2041 <refsynopsisdiv>
2042 <programlisting xml:id="linenumbering.extension.frag">
2043 &lt;xsl:param name="linenumbering.extension" select="1"&gt;&lt;/xsl:param&gt;
2044 </programlisting>
2045 </refsynopsisdiv>
2046
2047 <refsection><info><title>Description</title></info>
2048
2049 <para>If non-zero, verbatim environments (<tag>address</tag>, <tag>literallayout</tag>,
2050 <tag>programlisting</tag>, <tag>screen</tag>, <tag>synopsis</tag>) that specify line numbering will
2051 have line numbers.
2052 </para>
2053
2054 </refsection>
2055 </refentry>
2056
2057 <refentry version="5.0" xml:id="linenumbering.separator">
2058 <refmeta>
2059 <refentrytitle>linenumbering.separator</refentrytitle>
2060 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
2061 </refmeta>
2062 <refnamediv>
2063 <refname>linenumbering.separator</refname>
2064 <refpurpose>Specify a separator between line numbers and lines</refpurpose>
2065 </refnamediv>
2066
2067 <refsynopsisdiv>
2068 <programlisting xml:id="linenumbering.separator.frag">
2069 &lt;xsl:param name="linenumbering.separator"&gt;&lt;xsl:text&gt; &lt;/xsl:text&gt;&lt;/xsl:param&gt;
2070 </programlisting>
2071 </refsynopsisdiv>
2072
2073 <refsection><info><title>Description</title></info>
2074
2075 <para>The separator is inserted between line numbers and lines in the
2076 verbatim environment. The default value is a single white space.
2077  Note the interaction with <parameter>linenumbering.width</parameter>
2078 </para>
2079
2080 </refsection>
2081 </refentry>
2082
2083 <refentry version="5.0" xml:id="linenumbering.width">
2084 <refmeta>
2085 <refentrytitle>linenumbering.width</refentrytitle>
2086 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
2087 </refmeta>
2088 <refnamediv>
2089 <refname>linenumbering.width</refname>
2090 <refpurpose>Indicates the width of line numbers</refpurpose>
2091 </refnamediv>
2092
2093 <refsynopsisdiv>
2094 <programlisting xml:id="linenumbering.width.frag">
2095 &lt;xsl:param name="linenumbering.width"&gt;3&lt;/xsl:param&gt;
2096 </programlisting>
2097 </refsynopsisdiv>
2098
2099 <refsection><info><title>Description</title></info>
2100
2101 <para>If line numbering is enabled, line numbers will appear right
2102 justified in a field "width" characters wide.
2103 </para>
2104
2105 </refsection>
2106 </refentry>
2107
2108 <refentry version="5.0" xml:id="tablecolumns.extension">
2109 <refmeta>
2110 <refentrytitle>tablecolumns.extension</refentrytitle>
2111 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2112 </refmeta>
2113 <refnamediv>
2114 <refname>tablecolumns.extension</refname>
2115 <refpurpose>Enable the table columns extension function</refpurpose>
2116 </refnamediv>
2117
2118 <refsynopsisdiv>
2119 <programlisting xml:id="tablecolumns.extension.frag">
2120 &lt;xsl:param name="tablecolumns.extension" select="1"&gt;&lt;/xsl:param&gt;
2121 </programlisting>
2122 </refsynopsisdiv>
2123
2124 <refsection><info><title>Description</title></info>
2125
2126 <para>The table columns extension function adjusts the widths of table
2127 columns in the HTML result to more accurately reflect the specifications
2128 in the CALS table.
2129 </para>
2130
2131 </refsection>
2132 </refentry>
2133
2134 <refentry version="5.0" xml:id="textinsert.extension">
2135   <refmeta>
2136     <refentrytitle>textinsert.extension</refentrytitle>
2137     <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2138   </refmeta>
2139   <refnamediv>
2140     <refname>textinsert.extension</refname>
2141     <refpurpose>Enables the textinsert extension element</refpurpose>
2142   </refnamediv>
2143   <refsynopsisdiv>
2144     <programlisting xml:id="textinsert.extension.frag">
2145   &lt;xsl:param name="textinsert.extension" select="1"&gt;&lt;/xsl:param&gt;
2146 </programlisting>
2147   </refsynopsisdiv>
2148   <refsection><info><title>Description</title></info>
2149     <para>The textinsert extension element inserts the contents of
2150       a file into the result tree (as text).</para>
2151     <note>
2152       <para>To use the textinsert extension element, you must use
2153         either Saxon or Xalan as your XSLT processor (it doesn&#8217;t
2154         work with xsltproc), along with either the DocBook Saxon
2155         extensions or DocBook Xalan extensions (for more
2156         information about those extensions, see <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="InstallingAProcessor.html#SaxonExtensions">DocBook Saxon Extensions</link> and <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="InstallingAProcessor.html#XalanExtensions">DocBook Xalan Extensions</link>), and you must set both
2157         the <parameter>use.extensions</parameter> and
2158         <parameter>textinsert.extension</parameter> parameters to
2159         <literal>1</literal>.</para>
2160       <para>As an alternative to using the textinsert element,
2161         consider using an Xinclude element with the
2162         <literal>parse="text"</literal> attribute and value
2163         specified, as detailed in <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="ExternalCode.html#XIncludeCode">Using XInclude for text inclusions</link>.</para>
2164     </note>
2165   </refsection>
2166   <refsection><info><title>See Also</title></info>
2167     <para>You can also use the <tag class="xmlpi">dbhtml-include&#160;href</tag> processing
2168       instruction to insert external files &#8212; both files containing
2169       plain text and files with markup content (including HTML
2170       content).</para>
2171   </refsection>
2172   <refsection><info><title>More information</title></info>
2173     <para>For how-to documentation on inserting contents of
2174       external code files and other text files into output, see
2175       <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="ExternalCode.html">External code files</link>.</para>
2176     <para>For guidelines on inserting contents of
2177       HTML files into output, see <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="InsertExtHtml.html">Inserting external HTML code</link>.</para>
2178   </refsection>
2179 </refentry>
2180
2181 <refentry version="5.0" xml:id="textdata.default.encoding">
2182 <refmeta>
2183 <refentrytitle>textdata.default.encoding</refentrytitle>
2184 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
2185 </refmeta>
2186 <refnamediv>
2187 <refname>textdata.default.encoding</refname>
2188 <refpurpose>Default encoding of external text files which are included
2189 using textdata element</refpurpose>
2190 </refnamediv>
2191
2192 <refsynopsisdiv>
2193 <programlisting xml:id="textdata.default.encoding.frag">
2194 &lt;xsl:param name="textdata.default.encoding"&gt;&lt;/xsl:param&gt;
2195 </programlisting>
2196 </refsynopsisdiv>
2197
2198 <refsection><info><title>Description</title></info>
2199
2200 <para>Specifies the encoding of any external text files included using
2201 <tag>textdata</tag> element. This value is used only when you do
2202 not specify encoding by the appropriate attribute
2203 directly on textdata. An empty string is interpreted as the system
2204 default encoding.</para>
2205
2206 </refsection>
2207 </refentry>
2208
2209 <refentry version="5.0" xml:id="use.extensions">
2210 <refmeta>
2211 <refentrytitle>use.extensions</refentrytitle>
2212 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2213 </refmeta>
2214 <refnamediv>
2215 <refname>use.extensions</refname>
2216 <refpurpose>Enable extensions</refpurpose>
2217 </refnamediv>
2218
2219 <refsynopsisdiv>
2220 <programlisting xml:id="use.extensions.frag">
2221 &lt;xsl:param name="use.extensions" select="0"&gt;&lt;/xsl:param&gt;
2222 </programlisting>
2223 </refsynopsisdiv>
2224
2225 <refsection><info><title>Description</title></info>
2226
2227 <para>If non-zero, extensions may be used. Each extension is
2228 further controlled by its own parameter. But if
2229 <parameter>use.extensions</parameter> is zero, no extensions will
2230 be used.
2231 </para>
2232
2233 </refsection>
2234 </refentry>
2235
2236 </reference>
2237 <reference xml:id="labels"><title>Automatic labelling</title>
2238 <refentry version="5.0" xml:id="appendix.autolabel">
2239 <refmeta>
2240 <refentrytitle>appendix.autolabel</refentrytitle>
2241 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
2242 <refmiscinfo class="other" otherclass="value">0<alt>none</alt></refmiscinfo>
2243 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>
2244 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>
2245 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>
2246 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>
2247 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>
2248 </refmeta>
2249 <refnamediv>
2250 <refname>appendix.autolabel</refname>
2251 <refpurpose>Specifies the labeling format for Appendix titles</refpurpose>
2252 </refnamediv>
2253
2254 <refsynopsisdiv>
2255 <programlisting xml:id="appendix.autolabel.frag">
2256 &lt;xsl:param name="appendix.autolabel"&gt;A&lt;/xsl:param&gt;
2257 </programlisting>
2258 </refsynopsisdiv>
2259
2260 <refsection><info><title>Description</title></info>
2261
2262 <para>If non-zero, then appendices will be numbered using the
2263 parameter value as the number format if the value matches one of the
2264 following:
2265 </para>
2266
2267 <variablelist>
2268   <varlistentry>
2269     <term>1 or arabic</term>
2270     <listitem>
2271       <para>Arabic numeration (1, 2, 3 ...).</para>
2272     </listitem>
2273   </varlistentry>
2274   <varlistentry>
2275     <term>A or upperalpha</term>
2276     <listitem>
2277       <para>Uppercase letter numeration (A, B, C ...).</para>
2278     </listitem>
2279   </varlistentry>
2280   <varlistentry>
2281     <term>a or loweralpha</term>
2282     <listitem>
2283       <para>Lowercase letter numeration (a, b, c ...).</para>
2284     </listitem>
2285   </varlistentry>
2286   <varlistentry>
2287     <term>I or upperroman</term>
2288     <listitem>
2289       <para>Uppercase roman numeration (I, II, III ...).</para>
2290     </listitem>
2291   </varlistentry>
2292   <varlistentry>
2293     <term>i or lowerroman</term>
2294     <listitem>
2295       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>
2296     </listitem>
2297   </varlistentry>
2298 </variablelist>
2299
2300 <para>Any nonzero value other than the above will generate
2301 the default number format (upperalpha).
2302 </para>
2303
2304 </refsection>
2305 </refentry>
2306
2307 <refentry version="5.0" xml:id="chapter.autolabel">
2308 <refmeta>
2309 <refentrytitle>chapter.autolabel</refentrytitle>
2310 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
2311 <refmiscinfo class="other" otherclass="value">0<alt>none</alt></refmiscinfo>
2312 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>
2313 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>
2314 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>
2315 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>
2316 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>
2317 </refmeta>
2318 <refnamediv>
2319 <refname>chapter.autolabel</refname>
2320 <refpurpose>Specifies the labeling format for Chapter titles</refpurpose>
2321 </refnamediv>
2322
2323 <refsynopsisdiv>
2324 <programlisting xml:id="chapter.autolabel.frag">
2325 &lt;xsl:param name="chapter.autolabel" select="1"&gt;&lt;/xsl:param&gt;</programlisting>
2326 </refsynopsisdiv>
2327
2328 <refsection><info><title>Description</title></info>
2329
2330 <para>If non-zero, then chapters will be numbered using the parameter
2331 value as the number format if the value matches one of the following:
2332 </para>
2333
2334 <variablelist>
2335   <varlistentry>
2336     <term>1 or arabic</term>
2337     <listitem>
2338       <para>Arabic numeration (1, 2, 3 ...).</para>
2339     </listitem>
2340   </varlistentry>
2341   <varlistentry>
2342     <term>A or upperalpha</term>
2343     <listitem>
2344       <para>Uppercase letter numeration (A, B, C ...).</para>
2345     </listitem>
2346   </varlistentry>
2347   <varlistentry>
2348     <term>a or loweralpha</term>
2349     <listitem>
2350       <para>Lowercase letter numeration (a, b, c ...).</para>
2351     </listitem>
2352   </varlistentry>
2353   <varlistentry>
2354     <term>I or upperroman</term>
2355     <listitem>
2356       <para>Uppercase roman numeration (I, II, III ...).</para>
2357     </listitem>
2358   </varlistentry>
2359   <varlistentry>
2360     <term>i or lowerroman</term>
2361     <listitem>
2362       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>
2363     </listitem>
2364   </varlistentry>
2365 </variablelist>
2366
2367 <para>Any nonzero value other than the above will generate
2368 the default number format (arabic).
2369 </para>
2370
2371 </refsection>
2372 </refentry>
2373
2374 <refentry version="5.0" xml:id="part.autolabel">
2375 <refmeta>
2376 <refentrytitle>part.autolabel</refentrytitle>
2377 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
2378 <refmiscinfo class="other" otherclass="value">0<alt>none</alt></refmiscinfo>
2379 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>
2380 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>
2381 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>
2382 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>
2383 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>
2384 </refmeta>
2385 <refnamediv>
2386 <refname>part.autolabel</refname>
2387 <refpurpose>Specifies the labeling format for Part titles</refpurpose>
2388 </refnamediv>
2389
2390 <refsynopsisdiv>
2391 <programlisting xml:id="part.autolabel.frag">
2392 &lt;xsl:param name="part.autolabel"&gt;I&lt;/xsl:param&gt;
2393 </programlisting>
2394 </refsynopsisdiv>
2395
2396 <refsection><info><title>Description</title></info>
2397
2398 <para>If non-zero, then parts will be numbered using the parameter
2399 value as the number format if the value matches one of the following:
2400 </para>
2401
2402 <variablelist>
2403   <varlistentry>
2404     <term>1 or arabic</term>
2405     <listitem>
2406       <para>Arabic numeration (1, 2, 3 ...).</para>
2407     </listitem>
2408   </varlistentry>
2409   <varlistentry>
2410     <term>A or upperalpha</term>
2411     <listitem>
2412       <para>Uppercase letter numeration (A, B, C ...).</para>
2413     </listitem>
2414   </varlistentry>
2415   <varlistentry>
2416     <term>a or loweralpha</term>
2417     <listitem>
2418       <para>Lowercase letter numeration (a, b, c ...).</para>
2419     </listitem>
2420   </varlistentry>
2421   <varlistentry>
2422     <term>I or upperroman</term>
2423     <listitem>
2424       <para>Uppercase roman numeration (I, II, III ...).</para>
2425     </listitem>
2426   </varlistentry>
2427   <varlistentry>
2428     <term>i or lowerroman</term>
2429     <listitem>
2430       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>
2431     </listitem>
2432   </varlistentry>
2433 </variablelist>
2434
2435 <para>Any nonzero value other than the above will generate
2436 the default number format (upperroman).
2437 </para>
2438
2439
2440 </refsection>
2441 </refentry>
2442
2443 <refentry version="5.0" xml:id="reference.autolabel">
2444 <refmeta>
2445 <refentrytitle>reference.autolabel</refentrytitle>
2446 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
2447 <refmiscinfo class="other" otherclass="value">0<alt>none</alt></refmiscinfo>
2448 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>
2449 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>
2450 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>
2451 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>
2452 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>
2453 </refmeta>
2454 <refnamediv>
2455 <refname>reference.autolabel</refname>
2456 <refpurpose>Specifies the labeling format for Reference titles</refpurpose>
2457 </refnamediv>
2458 <refsynopsisdiv>
2459 <programlisting xml:id="reference.autolabel.frag">
2460   &lt;xsl:param name="reference.autolabel"&gt;I&lt;/xsl:param&gt;
2461 </programlisting>
2462 </refsynopsisdiv>
2463 <refsection><info><title>Description</title></info>
2464 <para>If non-zero, references will be numbered using the parameter
2465   value as the number format if the value matches one of the
2466   following:
2467 </para>
2468 <variablelist>
2469   <varlistentry>
2470     <term>1 or arabic</term>
2471     <listitem>
2472       <para>Arabic numeration (1, 2, 3 ...).</para>
2473     </listitem>
2474   </varlistentry>
2475   <varlistentry>
2476     <term>A or upperalpha</term>
2477     <listitem>
2478       <para>Uppercase letter numeration (A, B, C ...).</para>
2479     </listitem>
2480   </varlistentry>
2481   <varlistentry>
2482     <term>a or loweralpha</term>
2483     <listitem>
2484       <para>Lowercase letter numeration (a, b, c ...).</para>
2485     </listitem>
2486   </varlistentry>
2487   <varlistentry>
2488     <term>I or upperroman</term>
2489     <listitem>
2490       <para>Uppercase roman numeration (I, II, III ...).</para>
2491     </listitem>
2492   </varlistentry>
2493   <varlistentry>
2494     <term>i or lowerroman</term>
2495     <listitem>
2496       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>
2497     </listitem>
2498   </varlistentry>
2499 </variablelist>
2500 <para>Any non-zero value other than the above will generate
2501 the default number format (upperroman).
2502 </para>
2503 </refsection>
2504 </refentry>
2505
2506 <refentry version="5.0" xml:id="preface.autolabel">
2507 <refmeta>
2508 <refentrytitle>preface.autolabel</refentrytitle>
2509 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
2510 <refmiscinfo class="other" otherclass="value">0<alt>none</alt></refmiscinfo>
2511 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>
2512 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>
2513 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>
2514 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>
2515 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>
2516 </refmeta>
2517 <refnamediv>
2518 <refname>preface.autolabel</refname>
2519 <refpurpose>Specifices the labeling format for Preface titles</refpurpose>
2520 </refnamediv>
2521
2522 <refsynopsisdiv>
2523 <programlisting xml:id="preface.autolabel.frag">&lt;xsl:param name="preface.autolabel" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
2524 </refsynopsisdiv>
2525
2526 <refsection><info><title>Description</title></info>
2527
2528 <para>If non-zero then prefaces will be numbered using the parameter
2529 value as the number format if the value matches one of the following:
2530 </para>
2531
2532 <variablelist>
2533   <varlistentry>
2534     <term>1 or arabic</term>
2535     <listitem>
2536       <para>Arabic numeration (1, 2, 3 ...).</para>
2537     </listitem>
2538   </varlistentry>
2539   <varlistentry>
2540     <term>A or upperalpha</term>
2541     <listitem>
2542       <para>Uppercase letter numeration (A, B, C ...).</para>
2543     </listitem>
2544   </varlistentry>
2545   <varlistentry>
2546     <term>a or loweralpha</term>
2547     <listitem>
2548       <para>Lowercase letter numeration (a, b, c ...).</para>
2549     </listitem>
2550   </varlistentry>
2551   <varlistentry>
2552     <term>I or upperroman</term>
2553     <listitem>
2554       <para>Uppercase roman numeration (I, II, III ...).</para>
2555     </listitem>
2556   </varlistentry>
2557   <varlistentry>
2558     <term>i or lowerroman</term>
2559     <listitem>
2560       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>
2561     </listitem>
2562   </varlistentry>
2563 </variablelist>
2564
2565 <para>Any nonzero value other than the above will generate
2566 the default number format (arabic).
2567 </para>
2568
2569
2570 </refsection>
2571 </refentry>
2572
2573 <refentry version="5.0" xml:id="section.autolabel">
2574 <refmeta>
2575 <refentrytitle>section.autolabel</refentrytitle>
2576 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2577 </refmeta>
2578 <refnamediv>
2579 <refname>section.autolabel</refname>
2580 <refpurpose>Are sections enumerated?</refpurpose>
2581 </refnamediv>
2582
2583 <refsynopsisdiv>
2584 <programlisting xml:id="section.autolabel.frag">&lt;xsl:param name="section.autolabel" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
2585 </refsynopsisdiv>
2586
2587 <refsection><info><title>Description</title></info>
2588
2589 <para>If true (non-zero), unlabeled sections will be enumerated.
2590 </para>
2591
2592 </refsection>
2593 </refentry>
2594
2595 <refentry version="5.0" xml:id="section.autolabel.max.depth">
2596 <refmeta>
2597 <refentrytitle>section.autolabel.max.depth</refentrytitle>
2598 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
2599 </refmeta>
2600 <refnamediv>
2601 <refname>section.autolabel.max.depth</refname>
2602 <refpurpose>The deepest level of sections that are numbered.</refpurpose>
2603 </refnamediv>
2604
2605 <refsynopsisdiv>
2606 <programlisting xml:id="section.autolabel.max.depth.frag">
2607 &lt;xsl:param name="section.autolabel.max.depth"&gt;8&lt;/xsl:param&gt;
2608 </programlisting>
2609 </refsynopsisdiv>
2610
2611 <refsection><info><title>Description</title></info>
2612
2613 <para>When section numbering is turned on by the
2614 <parameter>section.autolabel</parameter> parameter, then this
2615 parameter controls the depth of <tag>section</tag> nesting that is
2616 numbered.  Sections nested to a level deeper than this value will not
2617 be numbered.
2618 </para>
2619
2620 </refsection>
2621 </refentry>
2622
2623 <refentry version="5.0" xml:id="section.label.includes.component.label">
2624 <refmeta>
2625 <refentrytitle>section.label.includes.component.label</refentrytitle>
2626 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2627 </refmeta>
2628 <refnamediv>
2629 <refname>section.label.includes.component.label</refname>
2630 <refpurpose>Do section labels include the component label?</refpurpose>
2631 </refnamediv>
2632
2633 <refsynopsisdiv>
2634 <programlisting xml:id="section.label.includes.component.label.frag">&lt;xsl:param name="section.label.includes.component.label" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
2635 </refsynopsisdiv>
2636
2637 <refsection><info><title>Description</title></info>
2638
2639 <para>If non-zero, section labels are prefixed with the label of the
2640 component that contains them.
2641 </para>
2642
2643 </refsection>
2644 </refentry>
2645
2646 <refentry version="5.0" xml:id="label.from.part">
2647 <refmeta>
2648 <refentrytitle>label.from.part</refentrytitle>
2649 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2650 </refmeta>
2651 <refnamediv>
2652 <refname>label.from.part</refname>
2653 <refpurpose>Renumber components in each part?</refpurpose>
2654 </refnamediv>
2655
2656 <refsynopsisdiv>
2657 <programlisting xml:id="label.from.part.frag">
2658 &lt;xsl:param name="label.from.part" select="0"&gt;&lt;/xsl:param&gt;
2659 </programlisting>
2660 </refsynopsisdiv>
2661
2662 <refsection><info><title>Description</title></info>
2663
2664 <para>If <parameter>label.from.part</parameter> is non-zero, then
2665   numbering of components &#8212; <tag>preface</tag>,
2666   <tag>chapter</tag>, <tag>appendix</tag>, and
2667   <tag>reference</tag> (when <tag>reference</tag> occurs at the
2668   component level) &#8212; is re-started within each
2669   <tag>part</tag>.</para>
2670 <para>If <parameter>label.from.part</parameter> is zero (the
2671   default), numbering of components is <emphasis>not</emphasis>
2672   re-started within each <tag>part</tag>; instead, components are
2673   numbered sequentially throughout each <tag>book</tag>,
2674   regardless of whether or not they occur within <tag>part</tag>
2675   instances.</para>
2676
2677 </refsection>
2678 </refentry>
2679
2680 <refentry version="5.0" xml:id="component.label.includes.part.label">
2681 <refmeta>
2682 <refentrytitle>component.label.includes.part.label</refentrytitle>
2683 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2684 </refmeta>
2685 <refnamediv>
2686 <refname>component.label.includes.part.label</refname>
2687 <refpurpose>Do component labels include the part label?</refpurpose>
2688 </refnamediv>
2689
2690 <refsynopsisdiv>
2691 <programlisting xml:id="component.label.includes.part.label.frag">&lt;xsl:param name="component.label.includes.part.label" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
2692 </refsynopsisdiv>
2693
2694 <refsection><info><title>Description</title></info>
2695
2696 <para>If non-zero, number labels for <tag>chapter</tag>,
2697 <tag>appendix</tag>, and other component elements are prefixed with
2698 the label of the part element that contains them.  So you might see
2699 Chapter II.3 instead of Chapter 3.  Also, the labels for formal
2700 elements such as <tag>table</tag> and <tag>figure</tag> will include
2701 the part label.  If there is no part element container, then no prefix
2702 is generated.
2703 </para>
2704 <para>
2705 This feature is most useful when the
2706 <parameter>label.from.part</parameter> parameter is turned on.
2707 In that case, there would be more than one <tag>chapter</tag>
2708 <quote>1</quote>, and the extra part label prefix will identify
2709 each chapter unambiguously.
2710 </para>
2711
2712 </refsection>
2713 </refentry>
2714
2715 </reference>
2716 <reference xml:id="xslt"><title>XSLT Processing</title>
2717 <refentry version="5.0" xml:id="rootid">
2718 <refmeta>
2719 <refentrytitle>rootid</refentrytitle>
2720 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
2721 </refmeta>
2722 <refnamediv>
2723 <refname>rootid</refname>
2724 <refpurpose>Specify the root element to format</refpurpose>
2725 </refnamediv>
2726
2727 <refsynopsisdiv>
2728 <programlisting xml:id="rootid.frag">
2729 &lt;xsl:param name="rootid"&gt;&lt;/xsl:param&gt;</programlisting>
2730 </refsynopsisdiv>
2731
2732 <refsection><info><title>Description</title></info>
2733
2734 <para>If <parameter>rootid</parameter> is not empty, it must be the
2735 value of an ID that occurs in the document being formatted. The entire
2736 document will be loaded and parsed, but formatting will begin at the
2737 element identified, rather than at the root. For example, this allows
2738 you to process only <tag>chapter</tag> 4 of a <tag>book</tag>.</para>
2739 <para>Because the entire document is available to the processor, automatic
2740 numbering, cross references, and other dependencies are correctly
2741 resolved.</para>
2742
2743 </refsection>
2744 </refentry>
2745
2746 </reference>
2747 <reference xml:id="meta"><title>Meta/*Info</title>
2748 <refentry version="5.0" xml:id="make.single.year.ranges">
2749 <refmeta>
2750 <refentrytitle>make.single.year.ranges</refentrytitle>
2751 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2752 </refmeta>
2753 <refnamediv>
2754 <refname>make.single.year.ranges</refname>
2755 <refpurpose>Print single-year ranges (e.g., 1998-1999)</refpurpose>
2756 </refnamediv>
2757
2758 <refsynopsisdiv>
2759 <programlisting xml:id="make.single.year.ranges.frag">
2760 &lt;xsl:param name="make.single.year.ranges" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
2761 </refsynopsisdiv>
2762
2763 <refsection><info><title>Description</title></info>
2764
2765 <para>If non-zero, year ranges that span a single year will be printed
2766 in range notation (1998-1999) instead of discrete notation
2767 (1998, 1999).</para>
2768
2769 </refsection>
2770 </refentry>
2771
2772 <refentry version="5.0" xml:id="make.year.ranges">
2773 <refmeta>
2774 <refentrytitle>make.year.ranges</refentrytitle>
2775 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2776 </refmeta>
2777 <refnamediv>
2778 <refname>make.year.ranges</refname>
2779 <refpurpose>Collate copyright years into ranges?</refpurpose>
2780 </refnamediv>
2781
2782 <refsynopsisdiv>
2783 <programlisting xml:id="make.year.ranges.frag">&lt;xsl:param name="make.year.ranges" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
2784 </refsynopsisdiv>
2785
2786 <refsection><info><title>Description</title></info>
2787
2788 <para>If non-zero, multiple copyright <tag>year</tag> elements will be
2789 collated into ranges.
2790 This works only if each year number is put into a separate
2791 year element.  The copyright element permits multiple
2792 year elements. If a year element contains a dash or
2793 a comma, then that year element will not be merged into
2794 any range.
2795 </para>
2796
2797 </refsection>
2798 </refentry>
2799
2800 <refentry version="5.0" xml:id="author.othername.in.middle">
2801 <refmeta>
2802 <refentrytitle>author.othername.in.middle</refentrytitle>
2803 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2804 </refmeta>
2805 <refnamediv>
2806 <refname>author.othername.in.middle</refname>
2807 <refpurpose>Is <tag>othername</tag> in <tag>author</tag> a
2808 middle name?</refpurpose>
2809 </refnamediv>
2810
2811 <refsynopsisdiv>
2812 <programlisting xml:id="author.othername.in.middle.frag">
2813 &lt;xsl:param name="author.othername.in.middle" select="1"&gt;&lt;/xsl:param&gt;</programlisting>
2814 </refsynopsisdiv>
2815
2816 <refsection><info><title>Description</title></info>
2817
2818 <para>If non-zero, the <tag>othername</tag> of an <tag>author</tag>
2819 appears between the <tag>firstname</tag> and
2820 <tag>surname</tag>.  Otherwise, <tag>othername</tag>
2821 is suppressed.
2822 </para>
2823
2824 </refsection>
2825 </refentry>
2826
2827 </reference>
2828 <reference xml:id="refentry"><title>Reference Pages</title>
2829 <refentry version="5.0" xml:id="funcsynopsis.decoration">
2830 <refmeta>
2831 <refentrytitle>funcsynopsis.decoration</refentrytitle>
2832 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2833 </refmeta>
2834 <refnamediv>
2835 <refname>funcsynopsis.decoration</refname>
2836 <refpurpose>Decorate elements of a <tag>funcsynopsis</tag>?</refpurpose>
2837 </refnamediv>
2838
2839 <refsynopsisdiv>
2840 <programlisting xml:id="funcsynopsis.decoration.frag">
2841 &lt;xsl:param name="funcsynopsis.decoration" select="1"&gt;&lt;/xsl:param&gt;
2842 </programlisting>
2843 </refsynopsisdiv>
2844
2845 <refsection><info><title>Description</title></info>
2846
2847 <para>If non-zero, elements of the <tag>funcsynopsis</tag> will be
2848 decorated (e.g. rendered as bold or italic text). The decoration is controlled by
2849 templates that can be redefined in a customization layer.
2850 </para>
2851
2852 </refsection>
2853 </refentry>
2854
2855 <refentry version="5.0" xml:id="funcsynopsis.style">
2856 <refmeta>
2857 <refentrytitle>funcsynopsis.style</refentrytitle>
2858 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
2859 <refmiscinfo class="other" otherclass="value">ansi</refmiscinfo>
2860 <refmiscinfo class="other" otherclass="value">kr</refmiscinfo>
2861 </refmeta>
2862 <refnamediv>
2863 <refname>funcsynopsis.style</refname>
2864 <refpurpose>What style of <tag>funcsynopsis</tag> should be generated?</refpurpose>
2865 </refnamediv>
2866
2867 <refsynopsisdiv>
2868 <programlisting xml:id="funcsynopsis.style.frag">&lt;xsl:param name="funcsynopsis.style"&gt;kr&lt;/xsl:param&gt;</programlisting>
2869 </refsynopsisdiv>
2870
2871 <refsection><info><title>Description</title></info>
2872
2873 <para>If <parameter>funcsynopsis.style</parameter> is <literal>ansi</literal>,
2874 ANSI-style function synopses are generated for a
2875 <tag>funcsynopsis</tag>, otherwise K&amp;R-style
2876 function synopses are generated.
2877 </para>
2878
2879 </refsection>
2880 </refentry>
2881
2882 <refentry version="5.0" xml:id="function.parens">
2883 <refmeta>
2884 <refentrytitle>function.parens</refentrytitle>
2885 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2886 </refmeta>
2887 <refnamediv>
2888 <refname>function.parens</refname>
2889 <refpurpose>Generate parens after a function?</refpurpose>
2890 </refnamediv>
2891
2892 <refsynopsisdiv>
2893 <programlisting xml:id="function.parens.frag">
2894 &lt;xsl:param name="function.parens" select="0"&gt;&lt;/xsl:param&gt;
2895 </programlisting>
2896 </refsynopsisdiv>
2897
2898 <refsection><info><title>Description</title></info>
2899
2900 <para>If non-zero, the formatting of a <tag>function</tag> element
2901 will include generated parentheses.
2902 </para>
2903
2904 </refsection>
2905 </refentry>
2906
2907 <refentry version="5.0" xml:id="refentry.generate.name">
2908 <refmeta>
2909 <refentrytitle>refentry.generate.name</refentrytitle>
2910 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2911 </refmeta>
2912 <refnamediv>
2913 <refname>refentry.generate.name</refname>
2914 <refpurpose>Output NAME header before <tag>refname</tag>s?</refpurpose>
2915 </refnamediv>
2916
2917 <refsynopsisdiv>
2918 <programlisting xml:id="refentry.generate.name.frag">
2919 &lt;xsl:param name="refentry.generate.name" select="1"&gt;&lt;/xsl:param&gt;
2920 </programlisting>
2921 </refsynopsisdiv>
2922
2923 <refsection><info><title>Description</title></info>
2924
2925 <para>If non-zero, a "NAME" section title is output before the list
2926 of <tag>refname</tag>s. This parameter and
2927 <parameter>refentry.generate.title</parameter> are mutually
2928 exclusive. This means that if you change this parameter to zero, you
2929 should set <parameter>refentry.generate.title</parameter> to non-zero unless
2930 you want get quite strange output.
2931 </para>
2932
2933 </refsection>
2934 </refentry>
2935
2936 <refentry version="5.0" xml:id="refentry.generate.title">
2937 <refmeta>
2938 <refentrytitle>refentry.generate.title</refentrytitle>
2939 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2940 </refmeta>
2941 <refnamediv>
2942 <refname>refentry.generate.title</refname>
2943 <refpurpose>Output title before <tag>refname</tag>s?</refpurpose>
2944 </refnamediv>
2945
2946 <refsynopsisdiv>
2947 <programlisting xml:id="refentry.generate.title.frag">
2948 &lt;xsl:param name="refentry.generate.title" select="0"&gt;&lt;/xsl:param&gt;
2949 </programlisting>
2950 </refsynopsisdiv>
2951
2952 <refsection><info><title>Description</title></info>
2953
2954 <para>If non-zero, the reference page title or first name is
2955 output before the list of <tag>refname</tag>s. This parameter and
2956 <parameter>refentry.generate.name</parameter> are mutually exclusive.
2957 This means that if you change this parameter to non-zero, you
2958 should set <parameter>refentry.generate.name</parameter> to zero unless
2959 you want get quite strange output.</para>
2960
2961
2962 </refsection>
2963 </refentry>
2964
2965 <refentry version="5.0" xml:id="refentry.pagebreak">
2966 <refmeta>
2967 <refentrytitle>refentry.pagebreak</refentrytitle>
2968 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2969 </refmeta>
2970 <refnamediv>
2971 <refname>refentry.pagebreak</refname>
2972 <refpurpose>Start each refentry on a new page</refpurpose>
2973 </refnamediv>
2974
2975 <refsynopsisdiv>
2976 <programlisting xml:id="refentry.pagebreak.frag">&lt;xsl:param name="refentry.pagebreak" select="1"&gt;&lt;/xsl:param&gt;</programlisting>
2977 </refsynopsisdiv>
2978
2979 <refsection><info><title>Description</title></info>
2980
2981 <para>If non-zero (the default), each <tag>refentry</tag>
2982 element will start on a new page.  If zero, a page
2983 break will not be generated between <tag>refentry</tag> elements.
2984 The exception is when the <tag>refentry</tag> elements are children of
2985 a <tag>part</tag> element, in which case the page breaks are always
2986 retained.  That is because a <tag>part</tag> element does not generate
2987 a page-sequence for its children, so each <tag>refentry</tag> must
2988 start its own page-sequence.
2989 </para>
2990
2991 </refsection>
2992 </refentry>
2993
2994 <refentry version="5.0" xml:id="refentry.title.properties">
2995 <refmeta>
2996 <refentrytitle>refentry.title.properties</refentrytitle>
2997 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
2998 </refmeta>
2999 <refnamediv>
3000 <refname>refentry.title.properties</refname>
3001 <refpurpose>Title properties for a refentry title</refpurpose>
3002 </refnamediv>
3003
3004 <refsynopsisdiv>
3005 <programlisting xml:id="refentry.title.properties.frag">
3006 &lt;xsl:attribute-set name="refentry.title.properties"&gt;
3007   &lt;xsl:attribute name="font-family"&gt;
3008     &lt;xsl:value-of select="$title.fontset"&gt;&lt;/xsl:value-of&gt;
3009   &lt;/xsl:attribute&gt;
3010   &lt;xsl:attribute name="font-size"&gt;18pt&lt;/xsl:attribute&gt;
3011   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
3012   &lt;xsl:attribute name="space-after"&gt;1em&lt;/xsl:attribute&gt;
3013   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
3014   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
3015   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
3016   &lt;xsl:attribute name="space-before.optimum"&gt;1.0em&lt;/xsl:attribute&gt;
3017   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
3018   &lt;xsl:attribute name="space-after.optimum"&gt;0.5em&lt;/xsl:attribute&gt;
3019   &lt;xsl:attribute name="space-after.minimum"&gt;0.4em&lt;/xsl:attribute&gt;
3020   &lt;xsl:attribute name="space-after.maximum"&gt;0.6em&lt;/xsl:attribute&gt;
3021   &lt;xsl:attribute name="start-indent"&gt;&lt;xsl:value-of select="$title.margin.left"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
3022 &lt;/xsl:attribute-set&gt;
3023 </programlisting>
3024 </refsynopsisdiv>
3025
3026 <refsection><info><title>Description</title></info>
3027
3028 <para>Formatting properties applied to the title generated for the
3029 <tag>refnamediv</tag> part of output for
3030 <tag>refentry</tag> when the value of the
3031 <parameter>refentry.generate.title</parameter> parameter is
3032 non-zero. The font size is supplied by the appropriate <parameter>section.level<replaceable>X</replaceable>.title.properties</parameter>
3033 attribute-set, computed from the location of the
3034 <tag>refentry</tag> in the section hierarchy.</para>
3035
3036 <note>
3037   <para>This parameter has no effect on the the title generated for
3038   the <tag>refnamediv</tag> part of output for
3039   <tag>refentry</tag> when the value of the
3040   <parameter>refentry.generate.name</parameter> parameter is
3041   non-zero. By default, that title is formatted with the same
3042   properties as the titles for all other first-level children of
3043   <tag>refentry</tag>.</para>
3044 </note>
3045
3046 </refsection>
3047 </refentry>
3048
3049 <refentry version="5.0" xml:id="refentry.xref.manvolnum">
3050 <refmeta>
3051 <refentrytitle>refentry.xref.manvolnum</refentrytitle>
3052 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
3053 </refmeta>
3054 <refnamediv>
3055 <refname>refentry.xref.manvolnum</refname>
3056 <refpurpose>Output <tag>manvolnum</tag> as part of
3057 <tag>refentry</tag> cross-reference?</refpurpose>
3058 </refnamediv>
3059
3060 <refsynopsisdiv>
3061 <programlisting xml:id="refentry.xref.manvolnum.frag">
3062 &lt;xsl:param name="refentry.xref.manvolnum" select="1"&gt;&lt;/xsl:param&gt;
3063 </programlisting>
3064 </refsynopsisdiv>
3065
3066 <refsection><info><title>Description</title></info>
3067
3068 <para>if non-zero, the <tag>manvolnum</tag> is used when cross-referencing
3069 <tag>refentry</tag>s, either with <tag>xref</tag>
3070 or <tag>citerefentry</tag>.
3071 </para>
3072
3073 </refsection>
3074 </refentry>
3075
3076 <refentry version="5.0" xml:id="refclass.suppress">
3077 <refmeta>
3078 <refentrytitle>refclass.suppress</refentrytitle>
3079 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
3080 </refmeta>
3081 <refnamediv>
3082 <refname>refclass.suppress</refname>
3083 <refpurpose>Suppress display of refclass contents?</refpurpose>
3084 </refnamediv>
3085
3086 <refsynopsisdiv>
3087 <programlisting xml:id="refclass.suppress.frag">
3088 &lt;xsl:param name="refclass.suppress" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
3089 </refsynopsisdiv>
3090
3091 <refsection><info><title>Description</title></info>
3092
3093 <para>If the value of <parameter>refclass.suppress</parameter> is
3094 non-zero, then display of <tag>refclass</tag> contents is
3095 suppressed in output.</para>
3096
3097 </refsection>
3098 </refentry>
3099
3100 </reference>
3101 <reference xml:id="tables"><title>Tables</title>
3102 <refentry version="5.0" xml:id="default.table.width">
3103 <refmeta>
3104 <refentrytitle>default.table.width</refentrytitle>
3105 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
3106 </refmeta>
3107 <refnamediv>
3108 <refname>default.table.width</refname>
3109 <refpurpose>The default width of tables</refpurpose>
3110 </refnamediv>
3111 <refsynopsisdiv>
3112 <programlisting xml:id="default.table.width.frag">
3113 &lt;xsl:param name="default.table.width"&gt;&lt;/xsl:param&gt;
3114 </programlisting>
3115 </refsynopsisdiv>
3116 <refsection><info><title>Description</title></info>
3117 <para>If non-zero, this value will be used for the
3118 <literal>width</literal> attribute on <tag>table</tag>s that do not specify an
3119 alternate width (with the <tag class="xmlpi">dbhtml table-width</tag> or
3120 <tag class="xmlpi">dbfo table-width</tag> processing instruction).</para>
3121 </refsection>
3122 </refentry>
3123
3124 <refentry version="5.0" xml:id="nominal.table.width">
3125 <refmeta>
3126 <refentrytitle>nominal.table.width</refentrytitle>
3127 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
3128 </refmeta>
3129 <refnamediv>
3130 <refname>nominal.table.width</refname>
3131 <refpurpose>The (absolute) nominal width of tables</refpurpose>
3132 </refnamediv>
3133
3134 <refsynopsisdiv>
3135 <programlisting xml:id="nominal.table.width.frag">
3136 &lt;xsl:param name="nominal.table.width"&gt;6in&lt;/xsl:param&gt;
3137 </programlisting>
3138 </refsynopsisdiv>
3139
3140 <refsection><info><title>Description</title></info>
3141
3142 <para>In order to convert CALS column widths into HTML column widths, it
3143 is sometimes necessary to have an absolute table width to use for conversion
3144 of mixed absolute and relative widths. This value must be an absolute
3145 length (not a percentage).</para>
3146
3147 </refsection>
3148 </refentry>
3149
3150 <refentry version="5.0" xml:id="default.table.frame">
3151 <refmeta>
3152 <refentrytitle>default.table.frame</refentrytitle>
3153 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
3154 </refmeta>
3155 <refnamediv>
3156 <refname>default.table.frame</refname>
3157 <refpurpose>The default framing of tables</refpurpose>
3158 </refnamediv>
3159
3160 <refsynopsisdiv>
3161 <programlisting xml:id="default.table.frame.frag">
3162 &lt;xsl:param name="default.table.frame"&gt;all&lt;/xsl:param&gt;
3163 </programlisting>
3164 </refsynopsisdiv>
3165
3166 <refsection><info><title>Description</title></info>
3167
3168 <para>This value will be used when there is no frame attribute on the
3169 table. </para>
3170
3171 </refsection>
3172 </refentry>
3173
3174 <refentry version="5.0" xml:id="default.table.rules">
3175 <refmeta>
3176 <refentrytitle>default.table.rules</refentrytitle>
3177 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
3178 </refmeta>
3179 <refnamediv>
3180 <refname>default.table.rules</refname>
3181 <refpurpose>The default column and row rules for tables using HTML markup</refpurpose>
3182 </refnamediv>
3183
3184 <refsynopsisdiv>
3185 <programlisting xml:id="default.table.rules.frag">
3186 &lt;xsl:param name="default.table.rules"&gt;none&lt;/xsl:param&gt;
3187 </programlisting>
3188 </refsynopsisdiv>
3189
3190 <refsection><info><title>Description</title></info>
3191
3192 <para>Tables using HTML markup elements can use an attribute
3193 named <tag class="attribute">rules</tag> on the <tag>table</tag> or
3194 <tag>informaltable</tag> element
3195 to specify whether column and row border rules should be
3196 displayed. This parameter lets you specify a global default
3197 style for all HTML tables that don't otherwise have
3198 that attribute.</para>
3199 <para>These are the supported values:</para>
3200
3201 <variablelist>
3202 <varlistentry><term>all</term>
3203 <listitem>
3204 <para>Rules will appear between all rows and columns.</para>
3205 </listitem>
3206 </varlistentry>
3207
3208 <varlistentry><term>rows</term>
3209 <listitem>
3210 <para>Rules will appear between rows only.</para>
3211 </listitem>
3212 </varlistentry>
3213
3214 <varlistentry><term>cols</term>
3215 <listitem>
3216 <para>Rules will appear between columns only.</para>
3217 </listitem>
3218 </varlistentry>
3219
3220 <varlistentry><term>groups</term>
3221 <listitem>
3222 <para>Rules will appear between row groups (thead, tfoot, tbody).
3223 No support for rules between column groups yet.
3224 </para>
3225 </listitem>
3226 </varlistentry>
3227
3228 <varlistentry><term>none</term>
3229 <listitem>
3230 <para>No rules.  This is the default value.
3231 </para>
3232 </listitem>
3233 </varlistentry>
3234
3235 </variablelist>
3236
3237 <para>The border after the last row and the border after
3238 the last column are not affected by
3239 this setting. Those borders are controlled by
3240 the <tag class="attribute">frame</tag> attribute on the table element.
3241 </para>
3242
3243 </refsection>
3244 </refentry>
3245
3246 <refentry version="5.0" xml:id="table.cell.padding">
3247 <refmeta>
3248 <refentrytitle>table.cell.padding</refentrytitle>
3249 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
3250 </refmeta>
3251 <refnamediv>
3252 <refname>table.cell.padding</refname>
3253 <refpurpose>Specifies the padding of table cells</refpurpose>
3254 </refnamediv>
3255
3256 <refsynopsisdiv>
3257 <programlisting xml:id="table.cell.padding.frag">
3258 &lt;xsl:attribute-set name="table.cell.padding"&gt;
3259   &lt;xsl:attribute name="padding-start"&gt;2pt&lt;/xsl:attribute&gt;
3260   &lt;xsl:attribute name="padding-end"&gt;2pt&lt;/xsl:attribute&gt;
3261   &lt;xsl:attribute name="padding-top"&gt;2pt&lt;/xsl:attribute&gt;
3262   &lt;xsl:attribute name="padding-bottom"&gt;2pt&lt;/xsl:attribute&gt;
3263 &lt;/xsl:attribute-set&gt;
3264 </programlisting>
3265 </refsynopsisdiv>
3266
3267 <refsection><info><title>Description</title></info>
3268
3269 <para>Specifies the padding of table cells.</para>
3270
3271 </refsection>
3272 </refentry>
3273
3274 <refentry version="5.0" xml:id="table.frame.border.thickness">
3275 <refmeta>
3276 <refentrytitle>table.frame.border.thickness</refentrytitle>
3277 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
3278 </refmeta>
3279 <refnamediv>
3280 <refname>table.frame.border.thickness</refname>
3281 <refpurpose>Specifies the thickness of the frame border</refpurpose>
3282 </refnamediv>
3283
3284 <refsynopsisdiv>
3285 <programlisting xml:id="table.frame.border.thickness.frag">
3286 &lt;xsl:param name="table.frame.border.thickness"&gt;
3287   &lt;xsl:choose&gt;
3288     &lt;xsl:when test="contains($stylesheet.result.type,'html')"&gt;1px&lt;/xsl:when&gt;
3289     &lt;xsl:otherwise&gt;0.5pt&lt;/xsl:otherwise&gt;
3290   &lt;/xsl:choose&gt;
3291 &lt;/xsl:param&gt;
3292 </programlisting>
3293 </refsynopsisdiv>
3294
3295 <refsection><info><title>Description</title></info>
3296
3297 <para>Specifies the thickness of the border on the table's frame.</para>
3298
3299 </refsection>
3300 </refentry>
3301
3302 <refentry version="5.0" xml:id="table.frame.border.style">
3303 <refmeta>
3304 <refentrytitle>table.frame.border.style</refentrytitle>
3305 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
3306 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>
3307 <refmiscinfo class="other" otherclass="value">solid</refmiscinfo>
3308 <refmiscinfo class="other" otherclass="value">dotted</refmiscinfo>
3309 <refmiscinfo class="other" otherclass="value">dashed</refmiscinfo>
3310 <refmiscinfo class="other" otherclass="value">double</refmiscinfo>
3311 <refmiscinfo class="other" otherclass="value">groove</refmiscinfo>
3312 <refmiscinfo class="other" otherclass="value">ridge</refmiscinfo>
3313 <refmiscinfo class="other" otherclass="value">inset</refmiscinfo>
3314 <refmiscinfo class="other" otherclass="value">outset</refmiscinfo>
3315 <refmiscinfo class="other" otherclass="value">solid</refmiscinfo>
3316 </refmeta>
3317 <refnamediv>
3318 <refname>table.frame.border.style</refname>
3319 <refpurpose>Specifies the border style of table frames</refpurpose>
3320 </refnamediv>
3321
3322 <refsynopsisdiv>
3323 <programlisting xml:id="table.frame.border.style.frag">
3324 &lt;xsl:param name="table.frame.border.style"&gt;solid&lt;/xsl:param&gt;
3325 </programlisting>
3326 </refsynopsisdiv>
3327
3328 <refsection><info><title>Description</title></info>
3329
3330 <para>Specifies the border style of table frames.</para>
3331
3332 </refsection>
3333 </refentry>
3334
3335 <refentry version="5.0" xml:id="table.frame.border.color">
3336 <refmeta>
3337 <refentrytitle>table.frame.border.color</refentrytitle>
3338 <refmiscinfo class="other" otherclass="datatype">color</refmiscinfo>
3339 </refmeta>
3340 <refnamediv>
3341 <refname>table.frame.border.color</refname>
3342 <refpurpose>Specifies the border color of table frames</refpurpose>
3343 </refnamediv>
3344
3345 <refsynopsisdiv>
3346 <programlisting xml:id="table.frame.border.color.frag">
3347
3348 &lt;xsl:param name="table.frame.border.color"&gt;black&lt;/xsl:param&gt;
3349 </programlisting>
3350 </refsynopsisdiv>
3351
3352 <refsection><info><title>Description</title></info>
3353
3354 <para>Specifies the border color of table frames.</para>
3355
3356 </refsection>
3357 </refentry>
3358
3359 <refentry version="5.0" xml:id="table.cell.border.thickness">
3360 <refmeta>
3361 <refentrytitle>table.cell.border.thickness</refentrytitle>
3362 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
3363 </refmeta>
3364 <refnamediv>
3365 <refname>table.cell.border.thickness</refname>
3366 <refpurpose>Specifies the thickness of table cell borders</refpurpose>
3367 </refnamediv>
3368
3369 <refsynopsisdiv>
3370 <programlisting xml:id="table.cell.border.thickness.frag">
3371 &lt;xsl:param name="table.cell.border.thickness"&gt;
3372   &lt;xsl:choose&gt;
3373     &lt;xsl:when test="contains($stylesheet.result.type,'html')"&gt;1px&lt;/xsl:when&gt;
3374     &lt;xsl:otherwise&gt;0.5pt&lt;/xsl:otherwise&gt;
3375   &lt;/xsl:choose&gt;
3376 &lt;/xsl:param&gt;
3377 </programlisting>
3378 </refsynopsisdiv>
3379
3380 <refsection><info><title>Description</title></info>
3381
3382 <para>If non-zero, specifies the thickness of borders on table
3383 cells. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/CSS21/box.html#border-width-properties">
3384 CSS</link></para>
3385
3386 <note>
3387   <para>To control properties of cell borders in HTML output, you must also turn on the
3388   <parameter>table.borders.with.css</parameter> parameter.</para>
3389 </note>
3390
3391 </refsection>
3392 </refentry>
3393
3394 <refentry version="5.0" xml:id="table.cell.border.style">
3395 <refmeta>
3396 <refentrytitle>table.cell.border.style</refentrytitle>
3397 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
3398 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>
3399 <refmiscinfo class="other" otherclass="value">solid</refmiscinfo>
3400 <refmiscinfo class="other" otherclass="value">dotted</refmiscinfo>
3401 <refmiscinfo class="other" otherclass="value">dashed</refmiscinfo>
3402 <refmiscinfo class="other" otherclass="value">double</refmiscinfo>
3403 <refmiscinfo class="other" otherclass="value">groove</refmiscinfo>
3404 <refmiscinfo class="other" otherclass="value">ridge</refmiscinfo>
3405 <refmiscinfo class="other" otherclass="value">inset</refmiscinfo>
3406 <refmiscinfo class="other" otherclass="value">outset</refmiscinfo>
3407 <refmiscinfo class="other" otherclass="value">solid</refmiscinfo>
3408 </refmeta>
3409 <refnamediv>
3410 <refname>table.cell.border.style</refname>
3411 <refpurpose>Specifies the border style of table cells</refpurpose>
3412 </refnamediv>
3413
3414 <refsynopsisdiv>
3415 <programlisting xml:id="table.cell.border.style.frag">
3416 &lt;xsl:param name="table.cell.border.style"&gt;solid&lt;/xsl:param&gt;
3417 </programlisting>
3418 </refsynopsisdiv>
3419
3420 <refsection><info><title>Description</title></info>
3421
3422 <para>Specifies the border style of table cells.</para>
3423
3424 <note>
3425   <para>To control properties of cell borders in HTML output, you must also turn on the
3426   <parameter>table.borders.with.css</parameter> parameter.</para>
3427 </note>
3428
3429 </refsection>
3430 </refentry>
3431
3432 <refentry version="5.0" xml:id="table.cell.border.color">
3433 <refmeta>
3434 <refentrytitle>table.cell.border.color</refentrytitle>
3435 <refmiscinfo class="other" otherclass="datatype">color</refmiscinfo>
3436 </refmeta>
3437 <refnamediv>
3438 <refname>table.cell.border.color</refname>
3439 <refpurpose>Specifies the border color of table cells</refpurpose>
3440 </refnamediv>
3441
3442 <refsynopsisdiv>
3443 <programlisting xml:id="table.cell.border.color.frag">
3444
3445 &lt;xsl:param name="table.cell.border.color"&gt;black&lt;/xsl:param&gt;
3446 </programlisting>
3447 </refsynopsisdiv>
3448
3449 <refsection><info><title>Description</title></info>
3450
3451 <para>Set the color of table cell borders. If non-zero, the value is used
3452 for the border coloration. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/CSS21/syndata.html#value-def-color">CSS</link>. A
3453 <literal>color</literal> is either a keyword or a numerical RGB specification.
3454 Keywords are aqua, black, blue, fuchsia, gray, green, lime, maroon,
3455 navy, olive, orange, purple, red, silver, teal, white, and
3456 yellow.</para>
3457
3458 <note>
3459   <para>To control properties of cell borders in HTML output, you must also turn on the
3460   <parameter>table.borders.with.css</parameter> parameter.</para>
3461 </note>
3462
3463 </refsection>
3464 </refentry>
3465
3466 <refentry version="5.0" xml:id="table.table.properties">
3467 <refmeta>
3468 <refentrytitle>table.table.properties</refentrytitle>
3469 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
3470 </refmeta>
3471 <refnamediv>
3472 <refname>table.table.properties</refname>
3473 <refpurpose>Properties associated with a table</refpurpose>
3474 </refnamediv>
3475
3476 <refsynopsisdiv>
3477 <programlisting xml:id="table.table.properties.frag">
3478 &lt;xsl:attribute-set name="table.table.properties"&gt;
3479   &lt;xsl:attribute name="border-before-width.conditionality"&gt;retain&lt;/xsl:attribute&gt;
3480   &lt;xsl:attribute name="border-collapse"&gt;collapse&lt;/xsl:attribute&gt;
3481 &lt;/xsl:attribute-set&gt;
3482 </programlisting>
3483 </refsynopsisdiv>
3484
3485 <refsection><info><title>Description</title></info>
3486
3487 <para>The styling for tables. This parameter should really
3488 have been called <literal>table.properties</literal>, but that parameter
3489 name was inadvertently established for the block-level properties
3490 of the table as a whole.
3491 </para>
3492
3493 <para>See also <parameter>table.properties</parameter>.</para>
3494
3495 </refsection>
3496 </refentry>
3497
3498 <refentry version="5.0" xml:id="table.caption.properties">
3499 <refmeta>
3500 <refentrytitle>table.caption.properties</refentrytitle>
3501 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
3502 </refmeta>
3503 <refnamediv>
3504 <refname>table.caption.properties</refname>
3505 <refpurpose>Properties associated with a table caption</refpurpose>
3506 </refnamediv>
3507
3508 <refsynopsisdiv>
3509 <programlisting xml:id="table.caption.properties.frag">
3510 &lt;xsl:attribute-set name="table.caption.properties"&gt;
3511   &lt;xsl:attribute name="keep-together.within-column"&gt;always&lt;/xsl:attribute&gt;
3512 &lt;/xsl:attribute-set&gt;
3513 </programlisting>
3514 </refsynopsisdiv>
3515
3516 <refsection><info><title>Description</title></info>
3517
3518 <para>The styling for table caption element (not the table title).</para>
3519
3520 <para>See also <parameter>table.properties</parameter>.</para>
3521
3522 </refsection>
3523 </refentry>
3524
3525 </reference>
3526 <reference xml:id="links"><title>Linking</title>
3527 <refentry version="5.0" xml:id="current.docid">
3528 <refmeta>
3529 <refentrytitle>current.docid</refentrytitle>
3530 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
3531 </refmeta>
3532 <refnamediv>
3533 <refname>current.docid</refname>
3534 <refpurpose>targetdoc identifier for the document being
3535 processed</refpurpose>
3536 </refnamediv>
3537 <refsynopsisdiv> <programlisting xml:id="current.docid.frag">
3538 &lt;xsl:param name="current.docid"&gt;&lt;/xsl:param&gt;
3539 </programlisting>
3540 </refsynopsisdiv>
3541 <refsection><info><title>Description</title></info>
3542
3543 <para>When olinks between documents are resolved for HTML output, the stylesheet can compute the relative path between the current document and the target document. The stylesheet needs to know the <literal>targetdoc</literal> identifiers for both documents, as they appear in the <parameter>target.database.document</parameter> database file. This parameter passes to the stylesheet
3544 the targetdoc identifier of the current document, since that
3545 identifier does not appear in the document itself. </para>
3546 <para>This parameter can also be used for print output. If an olink's  <literal>targetdoc</literal>  id differs from the <literal>current.docid</literal>, then the stylesheet can append the target document's title to the generated olink text. That identifies to the reader that the link is to a different document, not the current document. See also <parameter>olink.doctitle</parameter> to enable that feature.</para>
3547 </refsection>
3548 </refentry>
3549
3550 <refentry version="5.0" xml:id="activate.external.olinks">
3551 <refmeta>
3552 <refentrytitle>activate.external.olinks</refentrytitle>
3553 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
3554 </refmeta>
3555 <refnamediv>
3556 <refname>activate.external.olinks</refname>
3557 <refpurpose>Make external olinks into active links</refpurpose>
3558 </refnamediv>
3559
3560 <refsynopsisdiv>
3561 <programlisting xml:id="activate.external.olinks.frag">
3562 &lt;xsl:param name="activate.external.olinks" select="1"&gt;&lt;/xsl:param&gt;
3563 </programlisting>
3564 </refsynopsisdiv>
3565
3566 <refsection><info><title>Description</title></info>
3567
3568 <para>If <parameter>activate.external.olinks</parameter> is nonzero
3569 (the default), then any olinks that reference another document
3570 become active links that can be clicked on to follow the link.
3571 If the parameter is set to zero, then external olinks
3572 will have the appropriate link text generated, but the link is
3573 not made active.  Olinks to destinations in
3574 the current document remain active.</para>
3575
3576 <para>To make an external olink active for HTML
3577 outputs, the link text is wrapped in an <tag>a</tag>
3578 element with an <tag>href</tag> attribute. To
3579 make an external olink active for FO outputs, the link text is
3580 wrapped in an <tag>fo:basic-link</tag> element with an
3581 <tag>external-destination</tag> attribute.</para>
3582
3583 <para>This parameter is useful when you need external olinks
3584 to resolve but not be clickable. For example, if documents
3585 in a collection are available independently of each other,
3586 then having active links between them could lead to
3587 unresolved links when a given target document is missing.</para>
3588
3589 <para>The epub stylesheets set this parameter to zero by default
3590 because there is no standard linking mechanism between Epub documents.</para>
3591
3592 <para>If external links are made inactive, you should
3593 consider setting the
3594 stylesheet parameter <parameter>olink.doctitle</parameter>
3595 to <literal>yes</literal>. That will append the external document's
3596 title to the link text, making it easier for the user to
3597 locate the other document.</para>
3598
3599 <para>An olink is considered external when the
3600 <parameter>current.docid</parameter> stylesheet parameter
3601 is set to some value, and the olink's <tag>targetdoc</tag>
3602 attribute has a different value. If the two values
3603 match, then the link is considered internal.  If the
3604 <parameter>current.docid</parameter> parameter is blank, or
3605 the <tag>olink</tag> element does not have a <tag>targetdoc</tag> attribute,
3606 then the link is considered to be internal and will become
3607 an active link.</para>
3608
3609 <para>See also <parameter>olink.doctitle</parameter>,
3610 <parameter>prefer.internal.olink</parameter>.</para>
3611
3612 </refsection>
3613 </refentry>
3614
3615 <refentry version="5.0" xml:id="collect.xref.targets">
3616 <refmeta>
3617 <refentrytitle>collect.xref.targets</refentrytitle>
3618 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
3619 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>
3620 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
3621 <refmiscinfo class="other" otherclass="value">only</refmiscinfo>
3622 </refmeta>
3623 <refnamediv>
3624 <refname>collect.xref.targets</refname>
3625 <refpurpose>Controls whether cross reference data is
3626 collected</refpurpose>
3627 </refnamediv>
3628 <refsynopsisdiv> <programlisting xml:id="collect.xref.targets.frag">
3629 &lt;xsl:param name="collect.xref.targets"&gt;no&lt;/xsl:param&gt;
3630 </programlisting>
3631 </refsynopsisdiv>
3632 <refsection><info><title>Description</title></info>
3633
3634 <para>
3635 In order to resolve olinks efficiently, the stylesheets can
3636 generate an external data file containing information about
3637 all potential cross reference endpoints in a document.
3638 This parameter determines whether the collection process is run when the document is processed by the stylesheet. The default value is  <literal>no</literal>, which means the data file is not generated during processing. The other choices are <literal>yes</literal>, which means the data file is created and the document is processed for output, and <literal>only</literal>, which means the data file is created but the document is not processed for output.
3639 See also <parameter>targets.filename</parameter>.
3640 </para>
3641 </refsection>
3642 </refentry>
3643
3644 <refentry version="5.0" xml:id="insert.olink.page.number">
3645 <refmeta>
3646 <refentrytitle>insert.olink.page.number</refentrytitle>
3647 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
3648 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>
3649 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
3650 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>
3651 </refmeta>
3652 <refnamediv>
3653 <refname>insert.olink.page.number</refname>
3654 <refpurpose>Turns page numbers in olinks on and off</refpurpose>
3655 </refnamediv>
3656
3657 <refsynopsisdiv>
3658 <programlisting xml:id="insert.olink.page.number.frag">
3659 &lt;xsl:param name="insert.olink.page.number"&gt;no&lt;/xsl:param&gt;
3660 </programlisting>
3661 </refsynopsisdiv>
3662
3663 <refsection><info><title>Description</title></info>
3664
3665 <para>The value of this parameter determines if
3666 cross references made between documents with
3667 <tag>olink</tag> will
3668 include page number citations.
3669 In most cases this is only applicable to references in printed output.
3670 </para>
3671 <para>The parameter has three possible values.
3672 </para>
3673 <variablelist>
3674 <varlistentry>
3675 <term>no</term>
3676 <listitem><para>No page number references will be generated for olinks.
3677 </para></listitem>
3678 </varlistentry>
3679 <varlistentry>
3680 <term>yes</term>
3681 <listitem><para>Page number references will be generated
3682 for all <tag>olink</tag> references.
3683 The style of page reference may be changed
3684 if an <tag class="attribute">xrefstyle</tag>
3685 attribute is used.
3686 </para></listitem>
3687 </varlistentry>
3688 <varlistentry>
3689 <term>maybe</term>
3690 <listitem><para>Page number references will not be generated
3691 for an <tag>olink</tag> element unless
3692 it has an
3693 <tag class="attribute">xrefstyle</tag>
3694 attribute whose value specifies a page reference.
3695 </para></listitem>
3696 </varlistentry>
3697 </variablelist>
3698 <para>Olinks that point to targets within the same document
3699 are treated as <tag>xref</tag>s, and controlled by
3700 the <parameter>insert.xref.page.number</parameter> parameter.
3701 </para>
3702
3703 <para>Page number references for olinks to
3704 external documents can only be inserted if the
3705 information exists in the olink database.
3706 This means each olink target element
3707 (<tag>div</tag> or <tag>obj</tag>)
3708 must have a <tag class="attribute">page</tag> attribute
3709 whose value is its page number in the target document.
3710 The XSL stylesheets are not able to extract that information
3711 during processing because pages have not yet been created in
3712 XSLT transformation.  Only the XSL-FO processor knows what
3713 page each element is placed on.
3714 Therefore some postprocessing must take place to populate
3715 page numbers in the olink database.
3716 </para>
3717
3718
3719
3720 </refsection>
3721 </refentry>
3722
3723 <refentry version="5.0" xml:id="insert.olink.pdf.frag">
3724 <refmeta>
3725 <refentrytitle>insert.olink.pdf.frag</refentrytitle>
3726 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
3727 </refmeta>
3728 <refnamediv>
3729 <refname>insert.olink.pdf.frag</refname>
3730 <refpurpose>Add fragment identifiers for links into PDF files</refpurpose>
3731 </refnamediv>
3732
3733 <refsynopsisdiv>
3734 <programlisting xml:id="insert.olink.pdf.frag.frag">
3735 &lt;xsl:param name="insert.olink.pdf.frag" select="0"&gt;&lt;/xsl:param&gt;
3736 </programlisting>
3737 </refsynopsisdiv>
3738
3739 <refsection><info><title>Description</title></info>
3740
3741 <para>The value of this parameter determines whether
3742 the cross reference URIs to PDF documents made with
3743 <tag>olink</tag> will
3744 include fragment identifiers.
3745 </para>
3746
3747 <para>When forming a URI to link to a PDF document,
3748 a fragment identifier (typically a '#' followed by an
3749 id value) appended to the PDF filename can be used by
3750 the PDF viewer to open
3751 the PDF file to a location within the document instead of
3752 the first page.
3753 However, not all PDF files have id
3754 values embedded in them, and not all PDF viewers can
3755 handle fragment identifiers.
3756 </para>
3757
3758 <para>If <parameter>insert.olink.pdf.frag</parameter> is set
3759 to a non-zero value, then any olink targeting a
3760 PDF file will have the fragment identifier appended to the URI.
3761 The URI is formed by concatenating the value of the
3762 <parameter>olink.base.uri</parameter> parameter, the
3763 value of the <tag class="attribute">baseuri</tag>
3764 attribute from the <tag class="element">document</tag>
3765 element in the olink database with the matching
3766 <tag class="attribute">targetdoc</tag> value,
3767 and the value of the <tag class="attribute">href</tag>
3768 attribute for the targeted element in the olink database.
3769 The <tag class="attribute">href</tag> attribute
3770 contains the fragment identifier.
3771 </para>
3772
3773 <para>If <parameter>insert.olink.pdf.frag</parameter> is set
3774 to zero (the default value), then
3775 the <tag class="attribute">href</tag> attribute
3776 from the olink database
3777 is not appended to PDF olinks, so the fragment identifier is left off.
3778 A PDF olink is any olink for which the
3779 <tag class="attribute">baseuri</tag> attribute
3780 from the matching <tag class="element">document</tag>
3781 element in the olink database ends with '.pdf'.
3782 Any other olinks will still have the fragment identifier added.
3783 </para>
3784 </refsection>
3785 </refentry>
3786
3787 <refentry version="5.0" xml:id="olink.base.uri">
3788 <refmeta>
3789 <refentrytitle>olink.base.uri</refentrytitle>
3790 <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo>
3791 </refmeta>
3792 <refnamediv>
3793 <refname>olink.base.uri</refname>
3794 <refpurpose>Base URI used in olink hrefs</refpurpose>
3795 </refnamediv>
3796 <refsynopsisdiv> <programlisting xml:id="olink.base.uri.frag">
3797 &lt;xsl:param name="olink.base.uri"&gt;&lt;/xsl:param&gt;
3798 </programlisting>
3799 </refsynopsisdiv>
3800 <refsection><info><title>Description</title></info>
3801
3802 <para>When cross reference data is collected for resolving olinks, it
3803 may be necessary to prepend a base URI to each target's href. This
3804 parameter lets you set that base URI when cross reference data is
3805 collected. This feature is needed when you want to link to a document
3806 that is processed without chunking. The output filename for such a
3807 document is not known to the XSL stylesheet; the only target
3808 information consists of fragment identifiers such as
3809 <literal>#idref</literal>. To enable the resolution of olinks between
3810 documents, you should pass the name of the HTML output file as the
3811 value of this parameter. Then the hrefs recorded in the cross
3812 reference data collection look like
3813 <literal>outfile.html#idref</literal>, which can be reached as links
3814 from other documents.</para>
3815 </refsection>
3816 </refentry>
3817
3818 <refentry version="5.0" xml:id="olink.debug">
3819 <refmeta>
3820 <refentrytitle>olink.debug</refentrytitle>
3821 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
3822 </refmeta>
3823 <refnamediv>
3824 <refname>olink.debug</refname>
3825 <refpurpose>Turn on debugging messages for olinks</refpurpose>
3826 </refnamediv>
3827
3828 <refsynopsisdiv>
3829 <programlisting xml:id="olink.debug.frag">
3830 &lt;xsl:param name="olink.debug" select="0"&gt;&lt;/xsl:param&gt;
3831 </programlisting>
3832 </refsynopsisdiv>
3833
3834 <refsection><info><title>Description</title></info>
3835
3836 <para>If non-zero, then each olink will generate several
3837 messages about how it is being resolved during processing.
3838 This is useful when an olink does not resolve properly
3839 and the standard error messages are not sufficient to
3840 find the problem.
3841 </para>
3842
3843 <para>You may need to read through the olink XSL templates
3844 to understand the context for some of the debug messages.
3845 </para>
3846
3847 </refsection>
3848 </refentry>
3849
3850 <refentry version="5.0" xml:id="olink.doctitle">
3851 <refmeta>
3852 <refentrytitle>olink.doctitle</refentrytitle>
3853 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
3854 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>
3855 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
3856 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>
3857 </refmeta>
3858 <refnamediv>
3859 <refname>olink.doctitle</refname>
3860 <refpurpose>show the document title for external olinks?</refpurpose>
3861
3862 </refnamediv>
3863 <refsynopsisdiv> <programlisting xml:id="olink.doctitle.frag">
3864 &lt;xsl:param name="olink.doctitle"&gt;no&lt;/xsl:param&gt;
3865 </programlisting>
3866 </refsynopsisdiv>
3867 <refsection><info><title>Description</title></info>
3868
3869 <para>When olinks between documents are resolved, the generated text
3870 may not make it clear that the reference is to another document.
3871 It is possible for the stylesheets to append the other document's
3872 title to external olinks. For this to happen, two parameters must
3873 be set.</para>
3874 <itemizedlist>
3875 <listitem>
3876 <para>This <parameter>olink.doctitle</parameter> parameter
3877 should be set to either <literal>yes</literal> or <literal>maybe</literal>
3878 to enable this feature.
3879 </para>
3880 </listitem>
3881 <listitem>
3882 <para>And you should also set the <parameter>current.docid</parameter>
3883 parameter to the document id for the  document currently
3884 being processed for output.
3885 </para>
3886 </listitem>
3887 </itemizedlist>
3888
3889 <para>
3890 Then if an olink's  <literal>targetdoc</literal> id differs from
3891 the <literal>current.docid</literal> value, the stylesheet knows
3892 that it is a reference to another document and can
3893 append the target document's
3894 title to the generated olink text. </para>
3895
3896 <para>The text for the target document's title is copied from the
3897 olink database from the <tag>ttl</tag> element
3898 of the top-level <tag>div</tag> for that document.
3899 If that <tag>ttl</tag> element is missing or empty,
3900 no title is output.
3901 </para>
3902
3903 <para>The supported values for <parameter>olink.doctitle</parameter> are:
3904 </para>
3905 <variablelist>
3906 <varlistentry>
3907 <term><literal>yes</literal></term>
3908 <listitem>
3909 <para>
3910 Always insert the title to the target document if it is not
3911 the current document.
3912 </para>
3913 </listitem>
3914 </varlistentry>
3915 <varlistentry>
3916 <term><literal>no</literal></term>
3917 <listitem>
3918 <para>
3919 Never insert the title to the target document, even if requested
3920 in an <tag class="attribute">xrefstyle</tag> attribute.
3921 </para>
3922 </listitem>
3923 </varlistentry>
3924 <varlistentry>
3925 <term><literal>maybe</literal></term>
3926 <listitem>
3927 <para>
3928 Only insert the title to the target document, if requested
3929 in an <tag class="attribute">xrefstyle</tag> attribute.
3930 </para>
3931 </listitem>
3932 </varlistentry>
3933 </variablelist>
3934 <para>An <tag class="attribute">xrefstyle</tag> attribute
3935 may override the global setting for individual olinks.
3936 The following values are supported in an
3937 <tag class="attribute">xrefstyle</tag>
3938 attribute using the <literal>select:</literal> syntax:
3939 </para>
3940
3941 <variablelist>
3942 <varlistentry>
3943 <term><literal>docname</literal></term>
3944 <listitem>
3945 <para>
3946 Insert the target document name for this olink using the
3947 <literal>docname</literal> gentext template, but only
3948 if the value of <parameter>olink.doctitle</parameter>
3949 is not <literal>no</literal>.
3950 </para>
3951 </listitem>
3952 </varlistentry>
3953 <varlistentry>
3954 <term><literal>docnamelong</literal></term>
3955 <listitem>
3956 <para>
3957 Insert the target document name for this olink using the
3958 <literal>docnamelong</literal> gentext template, but only
3959 if the value of <parameter>olink.doctitle</parameter>
3960 is not <literal>no</literal>.
3961 </para>
3962 </listitem>
3963 </varlistentry>
3964 <varlistentry>
3965 <term><literal>nodocname</literal></term>
3966 <listitem>
3967 <para>
3968 Omit the target document name even if
3969 the value of <parameter>olink.doctitle</parameter>
3970 is <literal>yes</literal>.
3971 </para>
3972 </listitem>
3973 </varlistentry>
3974 </variablelist>
3975 <para>Another way of inserting the target document name
3976 for a single olink is to employ an
3977 <tag class="attribute">xrefstyle</tag>
3978 attribute using the <literal>template:</literal> syntax.
3979 The <literal>%o</literal> placeholder (the letter o, not zero)
3980 in such a template
3981 will be filled in with the target document's title when it is processed.
3982 This will occur regardless of
3983 the value of <parameter>olink.doctitle</parameter>.
3984 </para>
3985 <para>Note that prior to version 1.66 of the XSL stylesheets,
3986 the allowed values for this parameter were 0 and 1.  Those
3987 values are still supported and mapped to 'no' and 'yes', respectively.
3988 </para>
3989 </refsection>
3990 </refentry>
3991
3992 <refentry version="5.0" xml:id="olink.lang.fallback.sequence">
3993 <refmeta>
3994 <refentrytitle>olink.lang.fallback.sequence</refentrytitle>
3995 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
3996 </refmeta>
3997 <refnamediv>
3998 <refname>olink.lang.fallback.sequence</refname>
3999 <refpurpose>look up translated documents if olink not found?</refpurpose>
4000
4001 </refnamediv>
4002 <refsynopsisdiv> <programlisting xml:id="olink.lang.fallback.sequence.frag">
4003 &lt;xsl:param name="olink.lang.fallback.sequence"&gt;&lt;/xsl:param&gt;
4004 </programlisting>
4005 </refsynopsisdiv>
4006 <refsection><info><title>Description</title></info>
4007
4008
4009 <para>This parameter defines a list of lang values
4010 to search among to resolve olinks.
4011 </para>
4012
4013 <para>Normally an olink tries to resolve to a document in the same
4014 language as the olink itself.  The language of an olink
4015 is determined by its nearest ancestor element with a
4016 <tag class="attribute">lang</tag> attribute, otherwise the
4017 value of the <parameter>l10n.gentext.default.lang</parameter>
4018 parameter.
4019 </para>
4020
4021 <para>An olink database can contain target data for the same
4022 document in multiple languages.  Each set of data has the
4023 same value for the <tag>targetdoc</tag> attribute in
4024 the <tag>document</tag> element in the database, but with a
4025 different <tag>lang</tag> attribute value.
4026 </para>
4027
4028 <para>When an olink is being resolved, the target is first
4029 sought in the document with the same language as the olink.
4030 If no match is found there, then this parameter is consulted
4031 for additional languages to try.</para>
4032
4033 <para>The <parameter>olink.lang.fallback.sequence</parameter>
4034 must be a whitespace separated list of lang values to
4035 try.  The first one with a match in the olink database is used.
4036 The default value is empty.</para>
4037
4038 <para>For example, a document might be written in German
4039 and contain an olink with
4040 <literal>targetdoc="adminguide"</literal>.
4041 When the document is processed, the processor
4042 first looks for a target dataset in the
4043 olink database starting with:</para>
4044
4045 <literallayout><literal>&lt;document targetdoc="adminguide" lang="de"&gt;</literal>.
4046 </literallayout>
4047
4048 <para>If there is no such element, then the
4049 <parameter>olink.lang.fallback.sequence</parameter>
4050 parameter is consulted.
4051 If its value is, for example, <quote>fr en</quote>, then the processor next
4052 looks for <literal>targetdoc="adminguide" lang="fr"</literal>, and
4053 then for <literal>targetdoc="adminguide" lang="en"</literal>.
4054 If there is still no match, it looks for
4055 <literal>targetdoc="adminguide"</literal> with no
4056 lang attribute.
4057 </para>
4058
4059 <para>This parameter is useful when a set of documents is only
4060 partially translated, or is in the process of being translated.
4061 If a target of an olink has not yet been translated, then this
4062 parameter permits the processor to look for the document in
4063 other languages.  This assumes the reader would rather have
4064 a link to a document in a different language than to have
4065 a broken link.
4066 </para>
4067
4068 </refsection>
4069 </refentry>
4070
4071 <refentry version="5.0" xml:id="olink.properties">
4072 <refmeta>
4073 <refentrytitle>olink.properties</refentrytitle>
4074 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4075 </refmeta>
4076 <refnamediv>
4077 <refname>olink.properties</refname>
4078 <refpurpose>Properties associated with the cross-reference
4079 text of an olink.</refpurpose>
4080 </refnamediv>
4081
4082 <refsynopsisdiv>
4083 <programlisting xml:id="olink.properties.frag">
4084 &lt;xsl:attribute-set name="olink.properties"&gt;
4085   &lt;xsl:attribute name="show-destination"&gt;replace&lt;/xsl:attribute&gt;
4086 &lt;/xsl:attribute-set&gt;
4087 </programlisting>
4088 </refsynopsisdiv>
4089
4090 <refsection><info><title>Description</title></info>
4091
4092 <para>This <literal>attribute set</literal> is applied to the
4093 <literal>fo:basic-link</literal> element of an olink. It is not applied to the
4094 optional page number or optional title of the external
4095 document.</para>
4096
4097 </refsection>
4098 </refentry>
4099
4100 <refentry version="5.0" xml:id="prefer.internal.olink">
4101 <refmeta>
4102 <refentrytitle>prefer.internal.olink</refentrytitle>
4103 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
4104 </refmeta>
4105 <refnamediv>
4106 <refname>prefer.internal.olink</refname>
4107 <refpurpose>Prefer a local olink reference to an external reference</refpurpose>
4108 </refnamediv>
4109
4110 <refsynopsisdiv>
4111 <programlisting xml:id="prefer.internal.olink.frag">
4112 &lt;xsl:param name="prefer.internal.olink" select="0"&gt;&lt;/xsl:param&gt;
4113 </programlisting>
4114 </refsynopsisdiv>
4115
4116 <refsection><info><title>Description</title></info>
4117
4118 <para>If you are re-using XML content modules in multiple documents,
4119 you may want to redirect some of your olinks.  This parameter
4120 permits you to redirect an olink to the current document.
4121 </para>
4122
4123 <para>For example: you are writing documentation for a  product,
4124 which includes 3 manuals: a little installation
4125 booklet (booklet.xml), a user
4126 guide (user.xml), and a reference manual (reference.xml).
4127 All 3 documents begin with the same introduction section (intro.xml) that
4128 contains a reference to the customization section (custom.xml) which is
4129 included in both user.xml and reference.xml documents.
4130 </para>
4131
4132 <para>How do you write the link to custom.xml in intro.xml
4133 so that it is interpreted correctly in all 3 documents?</para>
4134 <itemizedlist>
4135 <listitem><para>If you use xref, it will fail in booklet.xml.</para>
4136 </listitem>
4137 <listitem><para>If you use olink (pointing to reference.xml),
4138 the reference in user.xml
4139 will point to the customization section of the reference manual, while it is
4140 actually available in user.xml.</para>
4141 </listitem>
4142 </itemizedlist>
4143
4144 <para>If you set the <parameter>prefer.internal.olink</parameter>
4145 parameter to a non-zero value, then the processor will
4146 first look in the olink database
4147 for the olink's <tag>targetptr</tag> attribute value
4148 in document matching the <parameter>current.docid</parameter>
4149 parameter value.  If it isn't found there, then
4150 it tries the document in the database
4151 with the <tag>targetdoc</tag>
4152 value that matches the olink's <tag>targetdoc</tag>
4153 attribute.
4154 </para>
4155
4156 <para>This feature permits an olink reference to resolve to
4157 the current document if there is an element
4158 with an id matching the olink's <tag>targetptr</tag>
4159 value.  The current document's olink data must be
4160 included in the target database for this to work.</para>
4161
4162 <caution>
4163 <para>There is a potential for incorrect links if
4164 the same <tag>id</tag> attribute value is used for different
4165 content in different documents.
4166 Some of your olinks may be redirected to the current document
4167 when they shouldn't be.  It is not possible to control
4168 individual olink instances.</para>
4169 </caution>
4170
4171 </refsection>
4172 </refentry>
4173
4174 <refentry version="5.0" xml:id="target.database.document">
4175 <refmeta>
4176 <refentrytitle>target.database.document</refentrytitle>
4177 <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo>
4178 </refmeta>
4179 <refnamediv>
4180 <refname>target.database.document</refname>
4181 <refpurpose>Name of master database file for resolving
4182 olinks</refpurpose>
4183 </refnamediv>
4184 <refsynopsisdiv>
4185 <programlisting xml:id="target.database.document.frag">
4186  &lt;xsl:param name="target.database.document"&gt;olinkdb.xml&lt;/xsl:param&gt;
4187 </programlisting>
4188 </refsynopsisdiv>
4189 <refsection><info><title>Description</title></info>
4190
4191 <para>
4192 To resolve olinks between documents, the stylesheets use a master
4193 database document that identifies the target datafiles for all the
4194 documents within the scope of the olinks. This parameter value is the
4195 URI of the master document to be read during processing to resolve
4196 olinks.  The default value is <filename>olinkdb.xml</filename>.</para>
4197
4198 <para>The data structure of the file is defined in the
4199 <filename>targetdatabase.dtd</filename> DTD.  The database file
4200 provides the high level elements to record the identifiers, locations,
4201 and relationships of documents. The cross reference data for
4202 individual documents is generally pulled into the database using
4203 system entity references or XIncludes. See also
4204 <parameter>targets.filename</parameter>.  </para> </refsection>
4205 </refentry>
4206
4207 <refentry version="5.0" xml:id="targets.filename">
4208 <refmeta>
4209 <refentrytitle>targets.filename</refentrytitle>
4210 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
4211 </refmeta>
4212 <refnamediv>
4213 <refname>targets.filename</refname>
4214 <refpurpose>Name of cross reference targets data file</refpurpose>
4215 </refnamediv>
4216 <refsynopsisdiv> <programlisting xml:id="targets.filename.frag">
4217 &lt;xsl:param name="targets.filename"&gt;target.db&lt;/xsl:param&gt;
4218 </programlisting>
4219 </refsynopsisdiv>
4220 <refsection><info><title>Description</title></info>
4221
4222 <para>
4223 In order to resolve olinks efficiently, the stylesheets can
4224 generate an external data file containing information about
4225 all potential cross reference endpoints in a document.
4226 This parameter lets you change the name of the generated
4227 file from the default name <filename>target.db</filename>.
4228 The name must agree with that used in the target database
4229 used to resolve olinks during processing.
4230 See also <parameter>target.database.document</parameter>.
4231 </para>
4232 </refsection>
4233 </refentry>
4234
4235 <refentry version="5.0" xml:id="use.local.olink.style">
4236 <refmeta>
4237 <refentrytitle>use.local.olink.style</refentrytitle>
4238 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
4239 </refmeta>
4240 <refnamediv>
4241 <refname>use.local.olink.style</refname>
4242 <refpurpose>Process olinks using xref style of current
4243 document</refpurpose>
4244 </refnamediv>
4245 <refsynopsisdiv> <programlisting xml:id="use.local.olink.style.frag">
4246 &lt;xsl:param name="use.local.olink.style" select="0"&gt;&lt;/xsl:param&gt; </programlisting>
4247 </refsynopsisdiv>
4248 <refsection><info><title>Description</title></info>
4249
4250 <para>When cross reference data is collected for use by olinks, the data for each potential target includes one field containing a completely assembled cross reference string, as if it were an xref generated in that document. Other fields record the separate title, number, and element name of each target. When an olink is formed to a target from another document, the olink resolves to that preassembled string by default. If the <parameter>use.local.olink.style</parameter> parameter is set to non-zero, then instead the cross
4251 reference string is formed again from the target title, number, and
4252 element name, using the stylesheet processing the targeting document.
4253 Then olinks will match the xref style in the targeting document
4254 rather than in the target document. If  both documents are processed
4255 with the same stylesheet, then the results will be the same.</para>
4256 </refsection>
4257 </refentry>
4258
4259 </reference>
4260 <reference xml:id="xrefs"><title>Cross References</title>
4261 <refentry version="5.0" xml:id="insert.xref.page.number">
4262 <refmeta>
4263 <refentrytitle>insert.xref.page.number</refentrytitle>
4264 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
4265 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>
4266 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
4267 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>
4268 </refmeta>
4269 <refnamediv>
4270 <refname>insert.xref.page.number</refname>
4271 <refpurpose>Turns page numbers in xrefs on and off</refpurpose>
4272 </refnamediv>
4273
4274 <refsynopsisdiv>
4275 <programlisting xml:id="insert.xref.page.number.frag">
4276 &lt;xsl:param name="insert.xref.page.number"&gt;no&lt;/xsl:param&gt;
4277 </programlisting>
4278 </refsynopsisdiv>
4279
4280 <refsection><info><title>Description</title></info>
4281
4282 <para>The value of this parameter determines if
4283 cross references (<tag>xref</tag>s) in
4284 printed output will
4285 include page number citations.
4286 It has three possible values.
4287 </para>
4288 <variablelist>
4289 <varlistentry>
4290 <term>no</term>
4291 <listitem><para>No page number references will be generated.
4292 </para></listitem>
4293 </varlistentry>
4294 <varlistentry>
4295 <term>yes</term>
4296 <listitem><para>Page number references will be generated
4297 for all <tag>xref</tag> elements.
4298 The style of page reference may be changed
4299 if an <tag class="attribute">xrefstyle</tag>
4300 attribute is used.
4301 </para></listitem>
4302 </varlistentry>
4303 <varlistentry>
4304 <term>maybe</term>
4305 <listitem><para>Page number references will not be generated
4306 for an <tag>xref</tag> element unless
4307 it has an
4308 <tag class="attribute">xrefstyle</tag>
4309 attribute whose value specifies a page reference.
4310 </para></listitem>
4311 </varlistentry>
4312 </variablelist>
4313
4314 </refsection>
4315 </refentry>
4316
4317 <refentry version="5.0" xml:id="insert.xref.page.number.para">
4318 <refmeta>
4319 <refentrytitle>insert.xref.page.number.para</refentrytitle>
4320 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
4321 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
4322 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>
4323 </refmeta>
4324 <refnamediv>
4325 <refname>insert.xref.page.number.para</refname>
4326 <refpurpose>Turns page numbers in xrefs to paragraphs on and off</refpurpose>
4327 </refnamediv>
4328
4329 <refsynopsisdiv>
4330 <programlisting xml:id="insert.xref.page.number.para.frag">
4331 &lt;xsl:param name="insert.xref.page.number.para"&gt;yes&lt;/xsl:param&gt;
4332 </programlisting>
4333 </refsynopsisdiv>
4334
4335 <refsection><info><title>Description</title></info>
4336
4337 <para>The value of this parameter determines if
4338 cross references (<tag>xref</tag>s) to paragraphs in
4339 printed output will include page number citations.
4340 </para>
4341 <para>Historically, cross references to paragraphs
4342 included page number citations unconditionally, regardless
4343 of the <parameter>insert.xref.page.number</parameter>
4344 value.</para>
4345 <variablelist>
4346 <varlistentry>
4347 <term>yes</term>
4348 <listitem><para>Page number references will be generated
4349 for paragraphs.</para></listitem>
4350 </varlistentry>
4351 <varlistentry>
4352 <term>maybe</term>
4353 <listitem><para>Whether page number references are generated
4354 for an <tag>xref</tag> element referring to a paragraph will
4355 be controlled by the <parameter>insert.xref.page.number</parameter>
4356 rules.</para></listitem>
4357 </varlistentry>
4358 </variablelist>
4359
4360 </refsection>
4361 </refentry>
4362
4363
4364 <refentry version="5.0" xml:id="xref.properties">
4365 <refmeta>
4366 <refentrytitle>xref.properties</refentrytitle>
4367 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4368 </refmeta>
4369 <refnamediv>
4370 <refname>xref.properties</refname>
4371 <refpurpose>Properties associated with cross-reference text</refpurpose>
4372 </refnamediv>
4373
4374 <refsynopsisdiv>
4375 <programlisting xml:id="xref.properties.frag">
4376 &lt;xsl:attribute-set name="xref.properties"&gt;
4377 &lt;/xsl:attribute-set&gt;
4378 </programlisting>
4379 </refsynopsisdiv>
4380
4381 <refsection><info><title>Description</title></info>
4382
4383 <para>This attribute set is used to set properties
4384 on cross reference text.</para>
4385
4386 </refsection>
4387 </refentry>
4388
4389 <refentry version="5.0" xml:id="xref.label-title.separator">
4390 <refmeta>
4391 <refentrytitle>xref.label-title.separator</refentrytitle>
4392 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
4393 </refmeta>
4394 <refnamediv>
4395 <refname>xref.label-title.separator</refname>
4396 <refpurpose>Punctuation or space separating label from title in xref</refpurpose>
4397 </refnamediv>
4398
4399 <refsynopsisdiv>
4400 <programlisting xml:id="xref.label-title.separator.frag">&lt;xsl:param name="xref.label-title.separator"&gt;: &lt;/xsl:param&gt;</programlisting>
4401 </refsynopsisdiv>
4402
4403 <refsection><info><title>Description</title></info>
4404
4405 <para>
4406 This parameter allows you to control the punctuation of certain
4407 types of generated cross reference text.
4408 When cross reference text is generated for an
4409 <tag class="element">xref</tag> or
4410 <tag class="element">olink</tag> element
4411 using an <tag class="attribute">xrefstyle</tag> attribute
4412 that makes use of the <literal>select:</literal> feature,
4413 and the selected components include both label and title,
4414 then the value of this parameter is inserted between
4415 label and title in the output.
4416 </para>
4417
4418 </refsection>
4419 </refentry>
4420
4421 <refentry version="5.0" xml:id="xref.label-page.separator">
4422 <refmeta>
4423 <refentrytitle>xref.label-page.separator</refentrytitle>
4424 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
4425 </refmeta>
4426 <refnamediv>
4427 <refname>xref.label-page.separator</refname>
4428 <refpurpose>Punctuation or space separating label from page number in xref</refpurpose>
4429 </refnamediv>
4430
4431 <refsynopsisdiv>
4432 <programlisting xml:id="xref.label-page.separator.frag">&lt;xsl:param name="xref.label-page.separator"&gt;&lt;xsl:text&gt; &lt;/xsl:text&gt;&lt;/xsl:param&gt;</programlisting>
4433 </refsynopsisdiv>
4434
4435 <refsection><info><title>Description</title></info>
4436
4437 <para>
4438 This parameter allows you to control the punctuation of certain
4439 types of generated cross reference text.
4440 When cross reference text is generated for an
4441 <tag class="element">xref</tag> or
4442 <tag class="element">olink</tag> element
4443 using an <tag class="attribute">xrefstyle</tag> attribute
4444 that makes use of the <literal>select:</literal> feature,
4445 and the selected components include both label and page
4446 but no title,
4447 then the value of this parameter is inserted between
4448 label and page number in the output.
4449 If a title is included, then other separators are used.
4450 </para>
4451
4452 </refsection>
4453 </refentry>
4454
4455 <refentry version="5.0" xml:id="xref.title-page.separator">
4456 <refmeta>
4457 <refentrytitle>xref.title-page.separator</refentrytitle>
4458 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
4459 </refmeta>
4460 <refnamediv>
4461 <refname>xref.title-page.separator</refname>
4462 <refpurpose>Punctuation or space separating title from page number in xref</refpurpose>
4463 </refnamediv>
4464
4465 <refsynopsisdiv>
4466 <programlisting xml:id="xref.title-page.separator.frag">&lt;xsl:param name="xref.title-page.separator"&gt;&lt;xsl:text&gt; &lt;/xsl:text&gt;&lt;/xsl:param&gt;</programlisting>
4467 </refsynopsisdiv>
4468
4469 <refsection><info><title>Description</title></info>
4470
4471 <para>
4472 This parameter allows you to control the punctuation of certain
4473 types of generated cross reference text.
4474 When cross reference text is generated for an
4475 <tag class="element">xref</tag> or
4476 <tag class="element">olink</tag> element
4477 using an <tag class="attribute">xrefstyle</tag> attribute
4478 that makes use of the <literal>select:</literal> feature,
4479 and the selected components include both title and page number,
4480 then the value of this parameter is inserted between
4481 title and page number in the output.
4482 </para>
4483
4484 </refsection>
4485 </refentry>
4486
4487 <refentry version="5.0" xml:id="insert.link.page.number">
4488 <refmeta>
4489 <refentrytitle>insert.link.page.number</refentrytitle>
4490 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
4491 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>
4492 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
4493 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>
4494 </refmeta>
4495 <refnamediv>
4496 <refname>insert.link.page.number</refname>
4497 <refpurpose>Turns page numbers in link elements on and off</refpurpose>
4498 </refnamediv>
4499
4500 <refsynopsisdiv>
4501 <programlisting xml:id="insert.link.page.number.frag">
4502 &lt;xsl:param name="insert.link.page.number"&gt;no&lt;/xsl:param&gt;
4503 </programlisting>
4504 </refsynopsisdiv>
4505
4506 <refsection><info><title>Description</title></info>
4507
4508 <para>The value of this parameter determines if
4509 cross references using the <tag>link</tag> element in
4510 printed output will
4511 include standard page number citations.
4512 It has three possible values.
4513 </para>
4514 <variablelist>
4515 <varlistentry>
4516 <term>no</term>
4517 <listitem><para>No page number references will be generated.
4518 </para></listitem>
4519 </varlistentry>
4520 <varlistentry>
4521 <term>yes</term>
4522 <listitem><para>Page number references will be generated
4523 for all <tag>link</tag> elements.
4524 The style of page reference may be changed
4525 if an <tag class="attribute">xrefstyle</tag>
4526 attribute is used.
4527 </para></listitem>
4528 </varlistentry>
4529 <varlistentry>
4530 <term>maybe</term>
4531 <listitem><para>Page number references will not be generated
4532 for a <tag>link</tag> element unless
4533 it has an
4534 <tag class="attribute">xrefstyle</tag>
4535 attribute whose value specifies a page reference.
4536 </para></listitem>
4537 </varlistentry>
4538 </variablelist>
4539
4540 <para>Although the <tag>xrefstyle</tag> attribute
4541 can be used to turn the page reference on or off, it cannot be
4542 used to control the formatting of the page number as it
4543 can in <tag>xref</tag>.
4544 In <tag>link</tag> it will always format with
4545 the style established by the
4546 gentext template with <literal>name="page.citation"</literal>
4547 in the <literal>l:context name="xref"</literal>.
4548 </para>
4549 </refsection>
4550 </refentry>
4551
4552 </reference>
4553 <reference xml:id="lists"><title>Lists</title>
4554 <refentry version="5.0" xml:id="compact.list.item.spacing">
4555 <refmeta>
4556 <refentrytitle>compact.list.item.spacing</refentrytitle>
4557 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4558 </refmeta>
4559 <refnamediv>
4560 <refname>compact.list.item.spacing</refname>
4561 <refpurpose>What space do you want between list items (when spacing="compact")?</refpurpose>
4562 </refnamediv>
4563
4564 <refsynopsisdiv>
4565 <programlisting xml:id="compact.list.item.spacing.frag">&lt;xsl:attribute-set name="compact.list.item.spacing"&gt;
4566   &lt;xsl:attribute name="space-before.optimum"&gt;0em&lt;/xsl:attribute&gt;
4567   &lt;xsl:attribute name="space-before.minimum"&gt;0em&lt;/xsl:attribute&gt;
4568   &lt;xsl:attribute name="space-before.maximum"&gt;0.2em&lt;/xsl:attribute&gt;
4569 &lt;/xsl:attribute-set&gt;</programlisting>
4570 </refsynopsisdiv>
4571 <refsection><info><title>Description</title></info>
4572 <para>Specify what spacing you want between each list item when
4573 <tag class="attribute">spacing</tag> is
4574 <quote><literal>compact</literal></quote>.</para>
4575 </refsection>
4576 </refentry>
4577
4578 <refentry version="5.0" xml:id="itemizedlist.properties">
4579 <refmeta>
4580 <refentrytitle>itemizedlist.properties</refentrytitle>
4581 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4582 </refmeta>
4583 <refnamediv>
4584 <refname>itemizedlist.properties</refname>
4585 <refpurpose>Properties that apply to each list-block generated by itemizedlist.</refpurpose>
4586 </refnamediv>
4587
4588 <refsynopsisdiv>
4589 <programlisting xml:id="itemizedlist.properties.frag">&lt;xsl:attribute-set name="itemizedlist.properties" use-attribute-sets="list.block.properties"&gt;
4590 &lt;/xsl:attribute-set&gt;</programlisting>
4591 </refsynopsisdiv>
4592 <refsection><info><title>Description</title></info>
4593 <para>Properties that apply to each fo:list-block generated by itemizedlist.</para>
4594 </refsection>
4595 </refentry>
4596
4597 <refentry version="5.0" xml:id="itemizedlist.label.properties">
4598 <refmeta>
4599 <refentrytitle>itemizedlist.label.properties</refentrytitle>
4600 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4601 </refmeta>
4602 <refnamediv>
4603 <refname>itemizedlist.label.properties</refname>
4604 <refpurpose>Properties that apply to each label inside itemized list.</refpurpose>
4605 </refnamediv>
4606
4607 <refsynopsisdiv>
4608 <programlisting xml:id="itemizedlist.label.properties.frag">&lt;xsl:attribute-set name="itemizedlist.label.properties"&gt;
4609 &lt;/xsl:attribute-set&gt;</programlisting>
4610 </refsynopsisdiv>
4611 <refsection><info><title>Description</title></info>
4612 <para>Properties that apply to each label inside itemized list. E.g.:</para>
4613 <programlisting>&lt;xsl:attribute-set name="itemizedlist.label.properties"&gt;
4614   &lt;xsl:attribute name="text-align"&gt;right&lt;/xsl:attribute&gt;
4615 &lt;/xsl:attribute-set&gt;</programlisting>
4616 </refsection>
4617 </refentry>
4618
4619 <refentry version="5.0" xml:id="itemizedlist.label.width">
4620 <refmeta>
4621 <refentrytitle>itemizedlist.label.width</refentrytitle>
4622 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
4623 </refmeta>
4624 <refnamediv>
4625   <refname>itemizedlist.label.width</refname>
4626 <refpurpose>The default width of the label (bullet) in an itemized list.</refpurpose>
4627 </refnamediv>
4628
4629 <refsynopsisdiv>
4630   <programlisting xml:id="itemizedlist.label.width.frag">
4631     &lt;xsl:param name="itemizedlist.label.width"&gt;1.0em&lt;/xsl:param&gt;
4632   </programlisting>
4633 </refsynopsisdiv>
4634
4635 <refsection><info><title>Description</title></info>
4636 <para>Specifies the default width of the label (usually a bullet or other
4637 symbol) in an itemized list. You can override the default value on any
4638 particular list with the &#8220;dbfo&#8221; processing instruction using the
4639 &#8220;label-width&#8221; pseudoattribute.</para>
4640 </refsection>
4641 </refentry>
4642
4643 <refentry version="5.0" xml:id="list.block.properties">
4644 <refmeta>
4645 <refentrytitle>list.block.properties</refentrytitle>
4646 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4647 </refmeta>
4648 <refnamediv>
4649 <refname>list.block.properties</refname>
4650 <refpurpose>Properties that apply to each list-block generated by list.</refpurpose>
4651 </refnamediv>
4652
4653 <refsynopsisdiv>
4654 <programlisting xml:id="list.block.properties.frag">&lt;xsl:attribute-set name="list.block.properties"&gt;
4655   &lt;xsl:attribute name="provisional-label-separation"&gt;0.2em&lt;/xsl:attribute&gt;
4656   &lt;xsl:attribute name="provisional-distance-between-starts"&gt;1.5em&lt;/xsl:attribute&gt;
4657 &lt;/xsl:attribute-set&gt;</programlisting>
4658 </refsynopsisdiv>
4659 <refsection><info><title>Description</title></info>
4660 <para>Properties that apply to each fo:list-block generated by itemizedlist/orderedlist.</para>
4661 </refsection>
4662 </refentry>
4663
4664 <refentry version="5.0" xml:id="list.block.spacing">
4665 <refmeta>
4666 <refentrytitle>list.block.spacing</refentrytitle>
4667 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4668 </refmeta>
4669 <refnamediv>
4670 <refname>list.block.spacing</refname>
4671 <refpurpose>What spacing do you want before and after lists?</refpurpose>
4672 </refnamediv>
4673
4674 <refsynopsisdiv>
4675 <programlisting xml:id="list.block.spacing.frag">&lt;xsl:attribute-set name="list.block.spacing"&gt;
4676   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
4677   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
4678   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
4679   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;
4680   &lt;xsl:attribute name="space-after.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
4681   &lt;xsl:attribute name="space-after.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
4682 &lt;/xsl:attribute-set&gt;</programlisting>
4683 </refsynopsisdiv>
4684 <refsection><info><title>Description</title></info>
4685 <para>Specify the spacing required before and after a list. It is necessary to specify the space after a list block because lists can come inside of paras.  </para>
4686 <para>This attribute set is not applied to nested lists, so that only the
4687 <parameter>list.item.spacing</parameter> attribute-set is used, which provides
4688 consistent spacing.</para>
4689 </refsection>
4690 </refentry>
4691
4692 <refentry version="5.0" xml:id="list.item.spacing">
4693 <refmeta>
4694 <refentrytitle>list.item.spacing</refentrytitle>
4695 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4696 </refmeta>
4697 <refnamediv>
4698 <refname>list.item.spacing</refname>
4699 <refpurpose>What space do you want between list items?</refpurpose>
4700 </refnamediv>
4701
4702 <refsynopsisdiv>
4703 <programlisting xml:id="list.item.spacing.frag">&lt;xsl:attribute-set name="list.item.spacing"&gt;
4704   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
4705   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
4706   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
4707 &lt;/xsl:attribute-set&gt;</programlisting>
4708 </refsynopsisdiv>
4709 <refsection><info><title>Description</title></info>
4710 <para>Specify what spacing you want before (and optionally after) each list item.</para>
4711 <para>See also <parameter>list.block.spacing</parameter>, which sets
4712 the spacing before and after an entire list.</para>
4713 </refsection>
4714 </refentry>
4715
4716 <refentry version="5.0" xml:id="mark.optional.procedure.steps">
4717 <refmeta>
4718 <refentrytitle>mark.optional.procedure.steps</refentrytitle>
4719 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
4720 </refmeta>
4721 <refnamediv>
4722 <refname>mark.optional.procedure.steps</refname>
4723 <refpurpose>Specifies whether to mark optional procedure steps</refpurpose>
4724 </refnamediv>
4725
4726 <refsynopsisdiv>
4727   <programlisting xml:id="mark.optional.procedure.steps.frag">
4728     &lt;xsl:param name="mark.optional.procedure.steps"&gt;1&lt;/xsl:param&gt;
4729   </programlisting>
4730 </refsynopsisdiv>
4731
4732 <refsection><info><title>Description</title></info>
4733
4734 <para>This parameter specifies whether a procedure step
4735 with attribute <tag>performance</tag> set to <literal>optional</literal>
4736 should be marked.  If set to 1 (the default value), then the
4737 text "(Optional)" appears at the start of the first paragraph.
4738 If set to zero, then no text is generated.</para>
4739
4740 <para>The text can be customized in the gentext element with
4741 key="optional-step".</para>
4742
4743 </refsection>
4744 </refentry>
4745
4746 <refentry version="5.0" xml:id="orderedlist.properties">
4747 <refmeta>
4748 <refentrytitle>orderedlist.properties</refentrytitle>
4749 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4750 </refmeta>
4751 <refnamediv>
4752 <refname>orderedlist.properties</refname>
4753 <refpurpose>Properties that apply to each list-block generated by orderedlist.</refpurpose>
4754 </refnamediv>
4755
4756 <refsynopsisdiv>
4757 <programlisting xml:id="orderedlist.properties.frag">&lt;xsl:attribute-set name="orderedlist.properties" use-attribute-sets="list.block.properties"&gt;
4758   &lt;xsl:attribute name="provisional-distance-between-starts"&gt;2em&lt;/xsl:attribute&gt;
4759 &lt;/xsl:attribute-set&gt;</programlisting>
4760 </refsynopsisdiv>
4761 <refsection><info><title>Description</title></info>
4762 <para>Properties that apply to each fo:list-block generated by orderedlist.</para>
4763 </refsection>
4764 </refentry>
4765
4766 <refentry version="5.0" xml:id="orderedlist.label.properties">
4767 <refmeta>
4768 <refentrytitle>orderedlist.label.properties</refentrytitle>
4769 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4770 </refmeta>
4771 <refnamediv>
4772 <refname>orderedlist.label.properties</refname>
4773 <refpurpose>Properties that apply to each label inside ordered list.</refpurpose>
4774 </refnamediv>
4775
4776 <refsynopsisdiv>
4777 <programlisting xml:id="orderedlist.label.properties.frag">&lt;xsl:attribute-set name="orderedlist.label.properties"&gt;
4778 &lt;/xsl:attribute-set&gt;</programlisting>
4779 </refsynopsisdiv>
4780 <refsection><info><title>Description</title></info>
4781 <para>Properties that apply to each label inside ordered list. E.g.:</para>
4782 <programlisting>&lt;xsl:attribute-set name="orderedlist.label.properties"&gt;
4783   &lt;xsl:attribute name="text-align"&gt;right&lt;/xsl:attribute&gt;
4784 &lt;/xsl:attribute-set&gt;</programlisting>
4785 </refsection>
4786 </refentry>
4787
4788 <refentry version="5.0" xml:id="orderedlist.label.width">
4789 <refmeta>
4790 <refentrytitle>orderedlist.label.width</refentrytitle>
4791 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
4792 </refmeta>
4793 <refnamediv>
4794 <refname>orderedlist.label.width</refname>
4795 <refpurpose>The default width of the label (number) in an ordered list.</refpurpose>
4796 </refnamediv>
4797
4798 <refsynopsisdiv>
4799 <programlisting xml:id="orderedlist.label.width.frag">
4800 &lt;xsl:param name="orderedlist.label.width"&gt;1.2em&lt;/xsl:param&gt;
4801 </programlisting>
4802 </refsynopsisdiv>
4803
4804 <refsection><info><title>Description</title></info>
4805 <para>Specifies the default width of the label (usually a number or
4806 sequence of numbers) in an ordered list. You can override the default
4807 value on any particular list with the &#8220;dbfo&#8221; processing instruction
4808 using the &#8220;label-width&#8221; pseudoattribute.</para>
4809 </refsection>
4810 </refentry>
4811
4812 <refentry version="5.0" xml:id="variablelist.max.termlength">
4813 <refmeta>
4814 <refentrytitle>variablelist.max.termlength</refentrytitle>
4815 <refmiscinfo class="other" otherclass="datatype">number</refmiscinfo>
4816 </refmeta>
4817 <refnamediv>
4818 <refname>variablelist.max.termlength</refname>
4819 <refpurpose>Specifies the longest term in variablelists</refpurpose>
4820 </refnamediv>
4821
4822 <refsynopsisdiv>
4823 <programlisting xml:id="variablelist.max.termlength.frag">
4824 &lt;xsl:param name="variablelist.max.termlength"&gt;24&lt;/xsl:param&gt;
4825 </programlisting>
4826 </refsynopsisdiv>
4827
4828 <refsection><info><title>Description</title></info>
4829
4830 <para>In variablelists, the <tag>listitem</tag>
4831 is indented to leave room for the
4832 <tag>term</tag> elements. That indent may be computed
4833 if it is not specified with a <tag class="attribute">termlength</tag>
4834 attribute on the <tag>variablelist</tag> element.
4835 </para>
4836 <para>
4837 The computation counts characters in the
4838 <tag>term</tag> elements in the list
4839 to find the longest term.  However, some terms are very long
4840 and would produce extreme indents.  This parameter lets you
4841 set a maximum character count.  Any terms longer than the maximum
4842 would line wrap.  The default value is 24.
4843 </para>
4844 <para>
4845 The character counts are converted to physical widths
4846 by multiplying by 0.50em. There will be some variability
4847 in how many actual characters fit in the space
4848 since some characters are wider than others.
4849 </para>
4850
4851 </refsection>
4852 </refentry>
4853
4854 <refentry version="5.0" xml:id="variablelist.term.separator">
4855 <refmeta>
4856 <refentrytitle>variablelist.term.separator</refentrytitle>
4857 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
4858 </refmeta>
4859 <refnamediv>
4860 <refname>variablelist.term.separator</refname>
4861 <refpurpose>Text to separate <tag>term</tag>s within a multi-term
4862 <tag>varlistentry</tag></refpurpose>
4863 </refnamediv>
4864
4865 <refsynopsisdiv>
4866 <programlisting xml:id="variablelist.term.separator.frag">
4867 &lt;xsl:param name="variablelist.term.separator"&gt;, &lt;/xsl:param&gt;</programlisting>
4868 </refsynopsisdiv>
4869
4870 <refsection><info><title>Description</title></info>
4871
4872 <para>When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
4873 elements, the string specified in the value of the
4874 <parameter>variablelist.term.separator</parameter> parameter is placed
4875 after each <tag>term</tag> except the last.</para>
4876
4877 <note>
4878   <para>To generate a line break between multiple <tag>term</tag>s in
4879   a <tag>varlistentry</tag>, set a non-zero value for the
4880   <parameter>variablelist.term.break.after</parameter> parameter. If
4881   you do so, you may also want to set the value of the
4882   <parameter>variablelist.term.separator</parameter> parameter to an
4883   empty string (to suppress rendering of the default comma and space
4884   after each <tag>term</tag>).</para>
4885 </note>
4886
4887 </refsection>
4888 </refentry>
4889
4890 <refentry version="5.0" xml:id="variablelist.term.properties">
4891 <refmeta>
4892 <refentrytitle>variablelist.term.properties</refentrytitle>
4893 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4894 </refmeta>
4895 <refnamediv>
4896 <refname>variablelist.term.properties</refname>
4897 <refpurpose>To add properties to the term elements in a variablelist.</refpurpose>
4898 </refnamediv>
4899
4900 <refsynopsisdiv>
4901 <programlisting xml:id="variablelist.term.properties.frag">
4902 &lt;xsl:attribute-set name="variablelist.term.properties"&gt;
4903 &lt;/xsl:attribute-set&gt;
4904 </programlisting>
4905 </refsynopsisdiv>
4906 <refsection><info><title>Description</title></info>
4907 <para>These properties are added to the block containing a
4908 term in a variablelist.
4909 Use this attribute-set to set
4910 font properties or alignment, for example.</para>
4911
4912 </refsection>
4913 </refentry>
4914
4915 <refentry version="5.0" xml:id="variablelist.term.break.after">
4916 <refmeta>
4917 <refentrytitle>variablelist.term.break.after</refentrytitle>
4918 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
4919 </refmeta>
4920 <refnamediv>
4921 <refname>variablelist.term.break.after</refname>
4922 <refpurpose>Generate line break after each <tag>term</tag> within a
4923 multi-term <tag>varlistentry</tag>?</refpurpose>
4924 </refnamediv>
4925
4926 <refsynopsisdiv>
4927 <programlisting xml:id="variablelist.term.break.after.frag">
4928 &lt;xsl:param name="variablelist.term.break.after"&gt;0&lt;/xsl:param&gt;</programlisting>
4929 </refsynopsisdiv>
4930
4931 <refsection><info><title>Description</title></info>
4932
4933 <para>Set a non-zero value for the
4934 <parameter>variablelist.term.break.after</parameter> parameter to
4935 generate a line break between <tag>term</tag>s in a
4936 multi-term <tag>varlistentry</tag>.</para>
4937
4938 <note>
4939 <para>If you set a non-zero value for
4940 <parameter>variablelist.term.break.after</parameter>, you may also
4941 want to set the value of the
4942 <parameter>variablelist.term.separator</parameter> parameter to an
4943 empty string (to suppress rendering of the default comma and space
4944 after each <tag>term</tag>).</para>
4945 </note>
4946
4947 </refsection>
4948 </refentry>
4949
4950 </reference>
4951 <reference xml:id="qa"><title>QAndASet</title>
4952 <refentry version="5.0" xml:id="qandadiv.autolabel">
4953 <refmeta>
4954 <refentrytitle>qandadiv.autolabel</refentrytitle>
4955 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
4956 </refmeta>
4957 <refnamediv>
4958 <refname>qandadiv.autolabel</refname>
4959 <refpurpose>Are divisions in QAndASets enumerated?</refpurpose>
4960 </refnamediv>
4961
4962 <refsynopsisdiv>
4963 <programlisting xml:id="qandadiv.autolabel.frag">&lt;xsl:param name="qandadiv.autolabel" select="1"&gt;&lt;/xsl:param&gt;</programlisting>
4964 </refsynopsisdiv>
4965
4966 <refsection><info><title>Description</title></info>
4967
4968 <para>If non-zero, unlabeled qandadivs will be enumerated.
4969 </para>
4970
4971 </refsection>
4972 </refentry>
4973
4974 <refentry version="5.0" xml:id="qanda.inherit.numeration">
4975 <refmeta>
4976 <refentrytitle>qanda.inherit.numeration</refentrytitle>
4977 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
4978 </refmeta>
4979 <refnamediv>
4980 <refname>qanda.inherit.numeration</refname>
4981 <refpurpose>Does enumeration of QandASet components inherit the numeration of parent elements?</refpurpose>
4982 </refnamediv>
4983
4984 <refsynopsisdiv>
4985 <programlisting xml:id="qanda.inherit.numeration.frag">
4986 &lt;xsl:param name="qanda.inherit.numeration" select="1"&gt;&lt;/xsl:param&gt;
4987 </programlisting>
4988 </refsynopsisdiv>
4989
4990 <refsection><info><title>Description</title></info>
4991
4992 <para>If non-zero, numbered <tag>qandadiv</tag> elements and
4993 <tag>question</tag> and <tag>answer</tag> inherit the enumeration of
4994 the ancestors of the <tag>qandaset</tag>.
4995 </para>
4996
4997 </refsection>
4998 </refentry>
4999
5000 <refentry version="5.0" xml:id="qanda.defaultlabel">
5001 <refmeta>
5002 <refentrytitle>qanda.defaultlabel</refentrytitle>
5003 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
5004 <refmiscinfo class="other" otherclass="value">number</refmiscinfo>
5005 <refmiscinfo class="other" otherclass="value">qanda</refmiscinfo>
5006 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>
5007 </refmeta>
5008 <refnamediv>
5009 <refname>qanda.defaultlabel</refname>
5010 <refpurpose>Sets the default for defaultlabel on QandASet.</refpurpose>
5011 </refnamediv>
5012
5013 <refsynopsisdiv>
5014 <programlisting xml:id="qanda.defaultlabel.frag">
5015 &lt;xsl:param name="qanda.defaultlabel"&gt;number&lt;/xsl:param&gt;
5016 </programlisting>
5017 </refsynopsisdiv>
5018
5019 <refsection><info><title>Description</title></info>
5020
5021 <para>If no <literal>defaultlabel</literal> attribute is specified on
5022 a <tag>qandaset</tag>, this value is used. It is generally one of the legal
5023 values for the defaultlabel attribute (<literal>none</literal>,
5024 <literal>number</literal> or
5025 <literal>qanda</literal>), or one of the additional stylesheet-specific values
5026 (<literal>qnumber</literal> or <literal>qnumberanda</literal>).
5027 The default value is 'number'.
5028 </para>
5029 <para>The values are rendered as follows:</para>
5030 <variablelist>
5031 <varlistentry><term><literal>qanda</literal></term>
5032 <listitem>
5033 <para><tag>question</tag>s are labeled "Q:" and
5034 <tag>answer</tag>s are labeled "A:". </para>
5035 </listitem>
5036 </varlistentry>
5037
5038 <varlistentry><term><literal>number</literal></term>
5039 <listitem>
5040 <para>The questions are enumerated and the answers
5041 are not labeled. </para>
5042 </listitem>
5043 </varlistentry>
5044
5045 <varlistentry><term><literal>qnumber</literal></term>
5046 <listitem>
5047 <para>The questions are labeled "Q:" followed by a number, and answers are not
5048 labeled.
5049 When sections are numbered, adding a label
5050 to the number distinguishes the question numbers
5051 from the section numbers.
5052 This value is not allowed in the
5053 <tag class="attribute">defaultlabel</tag> attribute
5054 of a <tag>qandaset</tag> element.</para>
5055 </listitem>
5056 </varlistentry>
5057
5058 <varlistentry><term><literal>qnumberanda</literal></term>
5059 <listitem>
5060 <para>The questions are labeled "Q:" followed by a number, and
5061 the answers are labeled "A:".
5062 When sections are numbered, adding a label
5063 to the number distinguishes the question numbers
5064 from the section numbers.
5065 This value is not allowed in the
5066 <tag class="attribute">defaultlabel</tag> attribute
5067 of a <tag>qandaset</tag> element.</para>
5068 </listitem>
5069 </varlistentry>
5070
5071 <varlistentry><term><literal>none</literal></term>
5072 <listitem>
5073 <para>No distinguishing label precedes Questions or Answers.
5074 </para>
5075 </listitem>
5076 </varlistentry>
5077 </variablelist>
5078
5079 </refsection>
5080 </refentry>
5081
5082 <refentry version="5.0" xml:id="qanda.in.toc">
5083 <refmeta>
5084 <refentrytitle>qanda.in.toc</refentrytitle>
5085 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5086 </refmeta>
5087 <refnamediv>
5088 <refname>qanda.in.toc</refname>
5089 <refpurpose>Should qandaentry questions appear in
5090 the document table of contents?</refpurpose>
5091 </refnamediv>
5092
5093 <refsynopsisdiv>
5094 <programlisting xml:id="qanda.in.toc.frag">&lt;xsl:param name="qanda.in.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
5095 </refsynopsisdiv>
5096
5097 <refsection><info><title>Description</title></info>
5098
5099 <para>If true (non-zero), then the generated table of contents
5100 for a document will include <tag>qandaset</tag> titles,
5101 <tag>qandadiv</tag> titles,
5102 and <tag>question</tag> elements.  The default value (zero) excludes
5103 them from the TOC.
5104 </para>
5105 <para>This parameter does not affect any tables of contents
5106 that may be generated inside a qandaset or qandadiv.
5107 </para>
5108
5109 </refsection>
5110 </refentry>
5111
5112 <refentry version="5.0" xml:id="qanda.nested.in.toc">
5113 <refmeta>
5114 <refentrytitle>qanda.nested.in.toc</refentrytitle>
5115 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5116 </refmeta>
5117 <refnamediv>
5118 <refname>qanda.nested.in.toc</refname>
5119 <refpurpose>Should nested answer/qandaentry instances appear in TOC?</refpurpose>
5120 </refnamediv>
5121
5122 <refsynopsisdiv>
5123 <programlisting xml:id="qanda.nested.in.toc.frag">
5124 &lt;xsl:param name="qanda.nested.in.toc" select="0"&gt;&lt;/xsl:param&gt;
5125 </programlisting>
5126 </refsynopsisdiv>
5127
5128 <refsection><info><title>Description</title></info>
5129
5130 <para>If non-zero, instances of <tag>qandaentry</tag>
5131 that are children of <tag>answer</tag> elements are shown in
5132 the TOC.</para>
5133
5134 </refsection>
5135 </refentry>
5136
5137 </reference>
5138 <reference xml:id="biblio"><title>Bibliography</title>
5139 <refentry version="5.0" xml:id="bibliography.style">
5140 <refmeta>
5141 <refentrytitle>bibliography.style</refentrytitle>
5142 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
5143 <refmiscinfo class="other" otherclass="value">normal</refmiscinfo>
5144 <refmiscinfo class="other" otherclass="value">iso690</refmiscinfo>
5145 </refmeta>
5146 <refnamediv>
5147 <refname>bibliography.style</refname>
5148 <refpurpose>Style used for formatting of biblioentries.</refpurpose>
5149 </refnamediv>
5150
5151 <refsynopsisdiv>
5152 <programlisting xml:id="bibliography.style.frag">
5153 &lt;xsl:param name="bibliography.style"&gt;normal&lt;/xsl:param&gt;
5154 </programlisting>
5155 </refsynopsisdiv>
5156
5157 <refsection><info><title>Description</title></info>
5158
5159 <para>Currently only <literal>normal</literal> and
5160 <literal>iso690</literal> styles are supported.</para>
5161
5162 <para>In order to use ISO690 style to the full extent you might need
5163 to use additional markup described on <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://wiki.docbook.org/topic/ISO690Bibliography">the
5164 following WiKi page</link>.</para>
5165
5166 </refsection>
5167 </refentry>
5168
5169 <refentry version="5.0" xml:id="biblioentry.item.separator">
5170 <refmeta>
5171 <refentrytitle>biblioentry.item.separator</refentrytitle>
5172 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
5173 </refmeta>
5174 <refnamediv>
5175 <refname>biblioentry.item.separator</refname>
5176 <refpurpose>Text to separate bibliography entries</refpurpose>
5177 </refnamediv>
5178
5179 <refsynopsisdiv>
5180 <programlisting xml:id="biblioentry.item.separator.frag">&lt;xsl:param name="biblioentry.item.separator"&gt;. &lt;/xsl:param&gt;</programlisting>
5181 </refsynopsisdiv>
5182
5183 <refsection><info><title>Description</title></info>
5184
5185 <para>Text to separate bibliography entries
5186 </para>
5187
5188 </refsection>
5189 </refentry>
5190
5191 <refentry version="5.0" xml:id="bibliography.collection">
5192 <refmeta>
5193 <refentrytitle>bibliography.collection</refentrytitle>
5194 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
5195 </refmeta>
5196 <refnamediv>
5197 <refname>bibliography.collection</refname>
5198 <refpurpose>Name of the bibliography collection file</refpurpose>
5199 </refnamediv>
5200
5201 <refsynopsisdiv>
5202 <programlisting xml:id="bibliography.collection.frag">
5203 &lt;xsl:param name="bibliography.collection"&gt;http://docbook.sourceforge.net/release/bibliography/bibliography.xml&lt;/xsl:param&gt;
5204
5205 </programlisting>
5206 </refsynopsisdiv>
5207
5208 <refsection><info><title>Description</title></info>
5209
5210 <para>Maintaining bibliography entries across a set of documents is tedious, time
5211 consuming, and error prone. It makes much more sense, usually, to store all of
5212 the bibliography entries in a single place and simply <quote>extract</quote>
5213 the ones you need in each document.</para>
5214
5215 <para>That's the purpose of the
5216 <parameter>bibliography.collection</parameter> parameter. To setup a global
5217 bibliography <quote>database</quote>, follow these steps:</para>
5218
5219 <para>First, create a stand-alone bibliography document that contains all of
5220 the documents that you wish to reference. Make sure that each bibliography
5221 entry (whether you use <tag>biblioentry</tag> or <tag>bibliomixed</tag>)
5222 has an ID.</para>
5223
5224 <para>My global bibliography, <filename>~/bibliography.xml</filename> begins
5225 like this:</para>
5226
5227 <informalexample>
5228 <programlisting>&lt;!DOCTYPE bibliography
5229   PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
5230   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"&gt;
5231 &lt;bibliography&gt;&lt;title&gt;References&lt;/title&gt;
5232
5233 &lt;bibliomixed id="xml-rec"&gt;&lt;abbrev&gt;XML 1.0&lt;/abbrev&gt;Tim Bray,
5234 Jean Paoli, C. M. Sperberg-McQueen, and Eve Maler, editors.
5235 &lt;citetitle&gt;&lt;ulink url="http://www.w3.org/TR/REC-xml"&gt;Extensible Markup
5236 Language (XML) 1.0 Second Edition&lt;/ulink&gt;&lt;/citetitle&gt;.
5237 World Wide Web Consortium, 2000.
5238 &lt;/bibliomixed&gt;
5239
5240 &lt;bibliomixed id="xml-names"&gt;&lt;abbrev&gt;Namespaces&lt;/abbrev&gt;Tim Bray,
5241 Dave Hollander,
5242 and Andrew Layman, editors.
5243 &lt;citetitle&gt;&lt;ulink url="http://www.w3.org/TR/REC-xml-names/"&gt;Namespaces in
5244 XML&lt;/ulink&gt;&lt;/citetitle&gt;.
5245 World Wide Web Consortium, 1999.
5246 &lt;/bibliomixed&gt;
5247
5248 &lt;!-- ... --&gt;
5249 &lt;/bibliography&gt;
5250 </programlisting>
5251 </informalexample>
5252
5253 <para>When you create a bibliography in your document, simply
5254 provide <emphasis>empty</emphasis> <tag>bibliomixed</tag>
5255 entries for each document that you wish to cite. Make sure that these
5256 elements have the same ID as the corresponding <quote>real</quote>
5257 entry in your global bibliography.</para>
5258
5259 <para>For example:</para>
5260
5261 <informalexample>
5262 <programlisting>&lt;bibliography&gt;&lt;title&gt;Bibliography&lt;/title&gt;
5263
5264 &lt;bibliomixed id="xml-rec"/&gt;
5265 &lt;bibliomixed id="xml-names"/&gt;
5266 &lt;bibliomixed id="DKnuth86"&gt;Donald E. Knuth. &lt;citetitle&gt;Computers and
5267 Typesetting: Volume B, TeX: The Program&lt;/citetitle&gt;. Addison-Wesley,
5268 1986.  ISBN 0-201-13437-3.
5269 &lt;/bibliomixed&gt;
5270 &lt;bibliomixed id="relaxng"/&gt;
5271
5272 &lt;/bibliography&gt;</programlisting>
5273 </informalexample>
5274
5275 <para>Note that it's perfectly acceptable to mix entries from your
5276 global bibliography with <quote>normal</quote> entries. You can use
5277 <tag>xref</tag> or other elements to cross-reference your
5278 bibliography entries in exactly the same way you do now.</para>
5279
5280 <para>Finally, when you are ready to format your document, simply set the
5281 <parameter>bibliography.collection</parameter> parameter (in either a
5282 customization layer or directly through your processor's interface) to
5283 point to your global bibliography.</para>
5284
5285 <para>A relative path in the parameter is interpreted in one
5286 of two ways:</para>
5287 <orderedlist numeration="loweralpha">
5288   <listitem>
5289     <para>If your document contains no links to empty bibliographic elements,
5290     then the path is relative to the file containing
5291     the first <tag>bibliomixed</tag> element in the document.</para>
5292   </listitem>
5293   <listitem>
5294     <para>If your document does contain links to empty bibliographic elements,
5295     then the path is relative to the file containing
5296     the first such link element in the document.</para>
5297   </listitem>
5298 </orderedlist>
5299 <para>Once the collection file is opened by the first instance described
5300 above, it stays open for the current document
5301 and the relative path is not reinterpreted again.</para>
5302
5303 <para>The stylesheets will format the bibliography in your document as if
5304 all of the entries referenced appeared there literally.</para>
5305
5306 </refsection>
5307 </refentry>
5308
5309 <refentry version="5.0" xml:id="bibliography.numbered">
5310 <refmeta>
5311 <refentrytitle>bibliography.numbered</refentrytitle>
5312 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5313 </refmeta>
5314 <refnamediv>
5315 <refname>bibliography.numbered</refname>
5316 <refpurpose>Should bibliography entries be numbered?</refpurpose>
5317 </refnamediv>
5318
5319 <refsynopsisdiv>
5320 <programlisting xml:id="bibliography.numbered.frag">
5321 &lt;xsl:param name="bibliography.numbered" select="0"&gt;&lt;/xsl:param&gt;
5322 </programlisting>
5323 </refsynopsisdiv>
5324
5325 <refsection><info><title>Description</title></info>
5326
5327 <para>If non-zero bibliography entries will be numbered</para>
5328
5329 </refsection>
5330 </refentry>
5331
5332 <refentry version="5.0" xml:id="biblioentry.properties">
5333 <refmeta>
5334   <refentrytitle>biblioentry.properties</refentrytitle>
5335   <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
5336 </refmeta>
5337 <refnamediv>
5338 <refname>biblioentry.properties</refname>
5339 <refpurpose>To set the style for biblioentry.</refpurpose>
5340 </refnamediv>
5341
5342 <refsynopsisdiv>
5343 <programlisting xml:id="biblioentry.properties.frag">&lt;xsl:attribute-set name="biblioentry.properties" use-attribute-sets="normal.para.spacing"&gt;
5344   &lt;xsl:attribute name="start-indent"&gt;0.5in&lt;/xsl:attribute&gt;
5345   &lt;xsl:attribute name="text-indent"&gt;-0.5in&lt;/xsl:attribute&gt;
5346 &lt;/xsl:attribute-set&gt;
5347 </programlisting>
5348 </refsynopsisdiv>
5349 <refsection><info><title>Description</title></info>
5350 <para>How do you want biblioentry styled? </para>
5351 <para>Set the font-size, weight, space-above and space-below, indents, etc. to the style required</para>
5352
5353 </refsection>
5354 </refentry>
5355
5356 </reference>
5357 <reference xml:id="glossary"><title>Glossary</title>
5358 <refentry version="5.0" xml:id="glossterm.auto.link">
5359 <refmeta>
5360 <refentrytitle>glossterm.auto.link</refentrytitle>
5361 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5362 </refmeta>
5363 <refnamediv>
5364 <refname>glossterm.auto.link</refname>
5365 <refpurpose>Generate links from glossterm to glossentry automatically?</refpurpose>
5366 </refnamediv>
5367
5368 <refsynopsisdiv>
5369 <programlisting xml:id="glossterm.auto.link.frag">
5370 &lt;xsl:param name="glossterm.auto.link" select="0"&gt;&lt;/xsl:param&gt;
5371 </programlisting>
5372 </refsynopsisdiv>
5373
5374 <refsection><info><title>Description</title></info>
5375
5376 <para>If non-zero, links from inline <tag>glossterm</tag>s to the corresponding
5377 <tag>glossentry</tag> elements in a <tag>glossary</tag> or <tag>glosslist</tag>
5378 will be automatically generated. This is useful when your glossterms are consistent
5379 and you don't want to add links manually.</para>
5380
5381 <para>The automatic link generation feature is not used on <tag>glossterm</tag> elements
5382 that have a <tag class="attribute">linkend</tag> attribute.</para>
5383
5384 </refsection>
5385 </refentry>
5386
5387 <refentry version="5.0" xml:id="firstterm.only.link">
5388 <refmeta>
5389 <refentrytitle>firstterm.only.link</refentrytitle>
5390 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5391 </refmeta>
5392 <refnamediv>
5393 <refname>firstterm.only.link</refname>
5394 <refpurpose>Does automatic glossterm linking only apply to firstterms?</refpurpose>
5395 </refnamediv>
5396
5397 <refsynopsisdiv>
5398 <programlisting xml:id="firstterm.only.link.frag">
5399 &lt;xsl:param name="firstterm.only.link" select="0"&gt;&lt;/xsl:param&gt;
5400 </programlisting>
5401 </refsynopsisdiv>
5402
5403 <refsection><info><title>Description</title></info>
5404
5405 <para>If non-zero, only <tag>firstterm</tag>s will be automatically linked
5406 to the glossary. If glossary linking is not enabled, this parameter
5407 has no effect.</para>
5408
5409 </refsection>
5410 </refentry>
5411
5412 <refentry version="5.0" xml:id="glossary.collection">
5413 <refmeta>
5414 <refentrytitle>glossary.collection</refentrytitle>
5415 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
5416 </refmeta>
5417 <refnamediv>
5418 <refname>glossary.collection</refname>
5419 <refpurpose>Name of the glossary collection file</refpurpose>
5420 </refnamediv>
5421
5422 <refsynopsisdiv>
5423 <programlisting xml:id="glossary.collection.frag">
5424 &lt;xsl:param name="glossary.collection"&gt;&lt;/xsl:param&gt;
5425 </programlisting>
5426 </refsynopsisdiv>
5427
5428 <refsection><info><title>Description</title></info>
5429
5430 <para>Glossaries maintained independently across a set of documents
5431 are likely to become inconsistent unless considerable effort is
5432 expended to keep them in sync. It makes much more sense, usually, to
5433 store all of the glossary entries in a single place and simply
5434 <quote>extract</quote> the ones you need in each document.</para>
5435
5436 <para>That's the purpose of the
5437 <parameter>glossary.collection</parameter> parameter. To setup a global
5438 glossary <quote>database</quote>, follow these steps:</para>
5439
5440 <refsection><info><title>Setting Up the Glossary Database</title></info>
5441
5442 <para>First, create a stand-alone glossary document that contains all of
5443 the entries that you wish to reference. Make sure that each glossary
5444 entry has an ID.</para>
5445
5446 <para>Here's an example glossary:</para>
5447
5448 <informalexample>
5449 <programlisting>
5450 &lt;?xml version="1.0" encoding="utf-8"?&gt;
5451 &lt;!DOCTYPE glossary
5452   PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
5453   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"&gt;
5454 &lt;glossary&gt;
5455 &lt;glossaryinfo&gt;
5456 &lt;editor&gt;&lt;firstname&gt;Eric&lt;/firstname&gt;&lt;surname&gt;Raymond&lt;/surname&gt;&lt;/editor&gt;
5457 &lt;title&gt;Jargon File 4.2.3 (abridged)&lt;/title&gt;
5458 &lt;releaseinfo&gt;Just some test data&lt;/releaseinfo&gt;
5459 &lt;/glossaryinfo&gt;
5460
5461 &lt;glossdiv&gt;&lt;title&gt;0&lt;/title&gt;
5462
5463 &lt;glossentry&gt;
5464 &lt;glossterm&gt;0&lt;/glossterm&gt;
5465 &lt;glossdef&gt;
5466 &lt;para&gt;Numeric zero, as opposed to the letter `O' (the 15th letter of
5467 the English alphabet). In their unmodified forms they look a lot
5468 alike, and various kluges invented to make them visually distinct have
5469 compounded the confusion. If your zero is center-dotted and letter-O
5470 is not, or if letter-O looks almost rectangular but zero looks more
5471 like an American football stood on end (or the reverse), you're
5472 probably looking at a modern character display (though the dotted zero
5473 seems to have originated as an option on IBM 3270 controllers). If
5474 your zero is slashed but letter-O is not, you're probably looking at
5475 an old-style ASCII graphic set descended from the default typewheel on
5476 the venerable ASR-33 Teletype (Scandinavians, for whom /O is a letter,
5477 curse this arrangement). (Interestingly, the slashed zero long
5478 predates computers; Florian Cajori's monumental "A History of
5479 Mathematical Notations" notes that it was used in the twelfth and
5480 thirteenth centuries.) If letter-O has a slash across it and the zero
5481 does not, your display is tuned for a very old convention used at IBM
5482 and a few other early mainframe makers (Scandinavians curse &lt;emphasis&gt;this&lt;/emphasis&gt;
5483 arrangement even more, because it means two of their letters collide).
5484 Some Burroughs/Unisys equipment displays a zero with a &lt;emphasis&gt;reversed&lt;/emphasis&gt;
5485 slash. Old CDC computers rendered letter O as an unbroken oval and 0
5486 as an oval broken at upper right and lower left. And yet another
5487 convention common on early line printers left zero unornamented but
5488 added a tail or hook to the letter-O so that it resembled an inverted
5489 Q or cursive capital letter-O (this was endorsed by a draft ANSI
5490 standard for how to draw ASCII characters, but the final standard
5491 changed the distinguisher to a tick-mark in the upper-left corner).
5492 Are we sufficiently confused yet?&lt;/para&gt;
5493 &lt;/glossdef&gt;
5494 &lt;/glossentry&gt;
5495
5496 &lt;glossentry&gt;
5497 &lt;glossterm&gt;1TBS&lt;/glossterm&gt;
5498 &lt;glossdef&gt;
5499 &lt;para role="accidence"&gt;
5500 &lt;phrase role="pronounce"&gt;&lt;/phrase&gt;
5501 &lt;phrase role="partsofspeach"&gt;n&lt;/phrase&gt;
5502 &lt;/para&gt;
5503 &lt;para&gt;The "One True Brace Style"&lt;/para&gt;
5504 &lt;glossseealso&gt;indent style&lt;/glossseealso&gt;
5505 &lt;/glossdef&gt;
5506 &lt;/glossentry&gt;
5507
5508 &lt;!-- ... --&gt;
5509
5510 &lt;/glossdiv&gt;
5511
5512 &lt;!-- ... --&gt;
5513
5514 &lt;/glossary&gt;</programlisting>
5515 </informalexample>
5516
5517 </refsection>
5518
5519 <refsection><info><title>Marking Up Glossary Terms</title></info>
5520
5521 <para>That takes care of the glossary database, now you have to get the entries
5522 into your document. Unlike bibliography entries, which can be empty, creating
5523 <quote>placeholder</quote> glossary entries would be very tedious. So instead,
5524 support for <parameter>glossary.collection</parameter> relies on implicit linking.</para>
5525
5526 <para>In your source document, simply use <tag>firstterm</tag> and
5527 <tag>glossterm</tag> to identify the terms you wish to have included
5528 in the glossary. The stylesheets assume that you will either set the
5529 <tag class="attribute">baseform</tag> attribute correctly, or that the
5530 content of the element exactly matches a term in your glossary.</para>
5531
5532 <para>If you're using a <parameter>glossary.collection</parameter>, don't
5533 make explicit links on the terms in your document.</para>
5534
5535 <para>So, in your document, you might write things like this:</para>
5536
5537 <informalexample>
5538 <programlisting>&lt;para&gt;This is dummy text, without any real meaning.
5539 The point is simply to reference glossary terms like &lt;glossterm&gt;0&lt;/glossterm&gt;
5540 and the &lt;firstterm baseform="1TBS"&gt;One True Brace Style (1TBS)&lt;/firstterm&gt;.
5541 The &lt;glossterm&gt;1TBS&lt;/glossterm&gt;, as you can probably imagine, is a nearly
5542 religious issue.&lt;/para&gt;</programlisting>
5543 </informalexample>
5544
5545 <para>If you set the <parameter>firstterm.only.link</parameter> parameter,
5546 only the terms marked with <tag>firstterm</tag> will be links.
5547 Otherwise, all the terms will be linked.</para>
5548
5549 </refsection>
5550
5551 <refsection><info><title>Marking Up the Glossary</title></info>
5552
5553 <para>The glossary itself has to be identified for the stylesheets. For lack
5554 of a better choice, the <tag class="attribute">role</tag> is used.
5555 To identify the glossary as the target for automatic processing, set
5556 the role to <quote><literal>auto</literal></quote>. The title of this
5557 glossary (and any other information from the <tag>glossaryinfo</tag>
5558 that's rendered by your stylesheet) will be displayed, but the entries will
5559 come from the database.
5560 </para>
5561
5562 <para>Unfortunately, the glossary can't be empty, so you must put in
5563 at least one <tag>glossentry</tag>. The content of this entry
5564 is irrelevant, it will not be rendered:</para>
5565
5566 <informalexample>
5567 <programlisting>&lt;glossary role="auto"&gt;
5568 &lt;glossentry&gt;
5569 &lt;glossterm&gt;Irrelevant&lt;/glossterm&gt;
5570 &lt;glossdef&gt;
5571 &lt;para&gt;If you can see this, the document was processed incorrectly. Use
5572 the &lt;parameter&gt;glossary.collection&lt;/parameter&gt; parameter.&lt;/para&gt;
5573 &lt;/glossdef&gt;
5574 &lt;/glossentry&gt;
5575 &lt;/glossary&gt;</programlisting>
5576 </informalexample>
5577
5578 <para>What about glossary divisions? If your glossary database has glossary
5579 divisions <emphasis>and</emphasis> your automatic glossary contains at least
5580 one <tag>glossdiv</tag>, the automic glossary will have divisions.
5581 If the <tag>glossdiv</tag> is missing from either location, no divisions
5582 will be rendered.</para>
5583
5584 <para>Glossary entries (and divisions, if appropriate) in the glossary will
5585 occur in precisely the order they occur in your database.</para>
5586
5587 </refsection>
5588
5589 <refsection><info><title>Formatting the Document</title></info>
5590
5591 <para>Finally, when you are ready to format your document, simply set the
5592 <parameter>glossary.collection</parameter> parameter (in either a
5593 customization layer or directly through your processor's interface) to
5594 point to your global glossary.</para>
5595
5596 <para>A relative path in the parameter is interpreted in one
5597 of two ways:</para>
5598 <orderedlist numeration="loweralpha">
5599   <listitem>
5600     <para>If the parameter <literal>glossterm.auto.link</literal>
5601     is set to zero, then the path is relative to the file containing
5602     the empty <tag>glossary</tag> element in the document.</para>
5603   </listitem>
5604   <listitem>
5605     <para>If the parameter <literal>glossterm.auto.link</literal>
5606     is set to non-zero, then the path is relative to the file containing
5607     the first inline <tag>glossterm</tag> or
5608     <tag>firstterm</tag> in the document to be linked.</para>
5609   </listitem>
5610 </orderedlist>
5611 <para>Once the collection file is opened by the first instance described
5612 above, it stays open for the current document
5613 and the relative path is not reinterpreted again.</para>
5614
5615 <para>The stylesheets will format the glossary in your document as if
5616 all of the entries implicilty referenced appeared there literally.</para>
5617 </refsection>
5618
5619 <refsection><info><title>Limitations</title></info>
5620
5621 <para>Glossary cross-references <emphasis>within the glossary</emphasis> are
5622 not supported. For example, this <emphasis>will not</emphasis> work:</para>
5623
5624 <informalexample>
5625 <programlisting>&lt;glossentry&gt;
5626 &lt;glossterm&gt;gloss-1&lt;/glossterm&gt;
5627 &lt;glossdef&gt;&lt;para&gt;A description that references &lt;glossterm&gt;gloss-2&lt;/glossterm&gt;.&lt;/para&gt;
5628 &lt;glossseealso&gt;gloss-2&lt;/glossseealso&gt;
5629 &lt;/glossdef&gt;
5630 &lt;/glossentry&gt;</programlisting>
5631 </informalexample>
5632
5633 <para>If you put glossary cross-references in your glossary that way,
5634 you'll get the cryptic error: <computeroutput>Warning:
5635 glossary.collection specified, but there are 0 automatic
5636 glossaries</computeroutput>.</para>
5637
5638 <para>Instead, you must do two things:</para>
5639
5640 <orderedlist>
5641 <listitem>
5642 <para>Markup your glossary using <tag>glossseealso</tag>:</para>
5643
5644 <informalexample>
5645 <programlisting>&lt;glossentry&gt;
5646 &lt;glossterm&gt;gloss-1&lt;/glossterm&gt;
5647 &lt;glossdef&gt;&lt;para&gt;A description that references &lt;glossterm&gt;gloss-2&lt;/glossterm&gt;.&lt;/para&gt;
5648 &lt;glossseealso&gt;gloss-2&lt;/glossseealso&gt;
5649 &lt;/glossdef&gt;
5650 &lt;/glossentry&gt;</programlisting>
5651 </informalexample>
5652 </listitem>
5653
5654 <listitem>
5655 <para>Make sure there is at least one <tag>glossterm</tag> reference to
5656 <glossterm>gloss-2</glossterm> <emphasis>in your document</emphasis>. The
5657 easiest way to do that is probably within a <tag>remark</tag> in your
5658 automatic glossary:</para>
5659
5660 <informalexample>
5661 <programlisting>&lt;glossary role="auto"&gt;
5662 &lt;remark&gt;Make sure there's a reference to &lt;glossterm&gt;gloss-2&lt;/glossterm&gt;.&lt;/remark&gt;
5663 &lt;glossentry&gt;
5664 &lt;glossterm&gt;Irrelevant&lt;/glossterm&gt;
5665 &lt;glossdef&gt;
5666 &lt;para&gt;If you can see this, the document was processed incorrectly. Use
5667 the &lt;parameter&gt;glossary.collection&lt;/parameter&gt; parameter.&lt;/para&gt;
5668 &lt;/glossdef&gt;
5669 &lt;/glossentry&gt;
5670 &lt;/glossary&gt;</programlisting>
5671 </informalexample>
5672 </listitem>
5673 </orderedlist>
5674 </refsection>
5675
5676 </refsection>
5677 </refentry>
5678
5679 <refentry version="5.0" xml:id="glossary.as.blocks">
5680 <refmeta>
5681 <refentrytitle>glossary.as.blocks</refentrytitle>
5682 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5683 </refmeta>
5684 <refnamediv>
5685 <refname>glossary.as.blocks</refname>
5686 <refpurpose>Present glossarys using blocks instead of lists?</refpurpose>
5687 </refnamediv>
5688
5689 <refsynopsisdiv>
5690 <programlisting xml:id="glossary.as.blocks.frag">
5691 &lt;xsl:param name="glossary.as.blocks" select="0"&gt;&lt;/xsl:param&gt;
5692 </programlisting>
5693 </refsynopsisdiv>
5694
5695 <refsection><info><title>Description</title></info>
5696
5697 <para>If non-zero, <tag>glossary</tag>s will be formatted as
5698 blocks.</para>
5699
5700 <para>If you have long <tag>glossterm</tag>s, proper list
5701 markup in the FO case may produce unattractive lists. By setting this
5702 parameter, you can force the stylesheets to produce block markup
5703 instead of proper lists.</para>
5704
5705 <para>You can override this setting with a processing instruction as the
5706 child of <tag>glossary</tag>: <tag class="xmlpi">dbfo
5707 glossary-presentation="blocks"</tag> or <tag class="xmlpi">dbfo
5708 glossary-presentation="list"</tag></para>
5709
5710 </refsection>
5711 </refentry>
5712
5713 <refentry version="5.0" xml:id="glosslist.as.blocks">
5714 <refmeta>
5715 <refentrytitle>glosslist.as.blocks</refentrytitle>
5716 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5717 </refmeta>
5718 <refnamediv>
5719 <refname>glosslist.as.blocks</refname>
5720 <refpurpose>Use blocks for glosslists?</refpurpose>
5721 </refnamediv>
5722
5723 <refsynopsisdiv>
5724 <programlisting xml:id="glosslist.as.blocks.frag">
5725 &lt;xsl:param name="glosslist.as.blocks" select="0"&gt;&lt;/xsl:param&gt;
5726 </programlisting>
5727 </refsynopsisdiv>
5728
5729 <refsection><info><title>Description</title></info>
5730
5731 <para>See <parameter>glossary.as.blocks</parameter>.</para>
5732
5733 </refsection>
5734 </refentry>
5735
5736 <refentry version="5.0" xml:id="glossentry.list.item.properties">
5737 <refmeta>
5738 <refentrytitle>glossentry.list.item.properties</refentrytitle>
5739 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
5740 </refmeta>
5741 <refnamediv>
5742 <refname>glossentry.list.item.properties</refname>
5743 <refpurpose>To add properties to each glossentry in a list.</refpurpose>
5744 </refnamediv>
5745
5746 <refsynopsisdiv>
5747 <programlisting xml:id="glossentry.list.item.properties.frag">&lt;xsl:attribute-set name="glossentry.list.item.properties"&gt;
5748   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
5749   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
5750   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
5751 &lt;/xsl:attribute-set&gt;
5752 </programlisting>
5753 </refsynopsisdiv>
5754 <refsection><info><title>Description</title></info>
5755 <para>These properties are added to the fo:list-item containing a
5756 glossentry in a glossary when the <parameter>glossary.as.blocks</parameter> parameter
5757 is zero.
5758 Use this attribute-set to set
5759 spacing between entries, for example.</para>
5760
5761 </refsection>
5762 </refentry>
5763
5764 <refentry version="5.0" xml:id="glossterm.block.properties">
5765 <refmeta>
5766 <refentrytitle>glossterm.block.properties</refentrytitle>
5767 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
5768 </refmeta>
5769 <refnamediv>
5770 <refname>glossterm.block.properties</refname>
5771 <refpurpose>To add properties to the block of a glossentry's glossterm.</refpurpose>
5772 </refnamediv>
5773
5774 <refsynopsisdiv>
5775 <programlisting xml:id="glossterm.block.properties.frag">&lt;xsl:attribute-set name="glossterm.block.properties"&gt;
5776   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
5777   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
5778   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
5779   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
5780   &lt;xsl:attribute name="keep-together.within-column"&gt;always&lt;/xsl:attribute&gt;
5781 &lt;/xsl:attribute-set&gt;
5782 </programlisting>
5783 </refsynopsisdiv>
5784 <refsection><info><title>Description</title></info>
5785 <para>These properties are added to the block containing a
5786 glossary term in a glossary when the <parameter>glossary.as.blocks</parameter> parameter
5787 is non-zero.
5788 Use this attribute-set to set the space above and below,
5789 font properties,
5790 and any indent for the glossary term.</para>
5791
5792 </refsection>
5793 </refentry>
5794
5795 <refentry version="5.0" xml:id="glossdef.block.properties">
5796 <refmeta>
5797 <refentrytitle>glossdef.block.properties</refentrytitle>
5798 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
5799 </refmeta>
5800 <refnamediv>
5801 <refname>glossdef.block.properties</refname>
5802 <refpurpose>To add properties to the block of a glossary definition.</refpurpose>
5803 </refnamediv>
5804
5805 <refsynopsisdiv>
5806 <programlisting xml:id="glossdef.block.properties.frag">&lt;xsl:attribute-set name="glossdef.block.properties"&gt;
5807   &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;.25in&lt;/xsl:attribute&gt;
5808 &lt;/xsl:attribute-set&gt;
5809 </programlisting>
5810 </refsynopsisdiv>
5811 <refsection><info><title>Description</title></info>
5812 <para>These properties are added to the block containing a
5813 glossary definition in a glossary when
5814 the <parameter>glossary.as.blocks</parameter> parameter
5815 is non-zero.
5816 Use this attribute-set to set the space above and below,
5817 any font properties,
5818 and any indent for the glossary definition.</para>
5819
5820 </refsection>
5821 </refentry>
5822
5823 <refentry version="5.0" xml:id="glossterm.list.properties">
5824 <refmeta>
5825 <refentrytitle>glossterm.list.properties</refentrytitle>
5826 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
5827 </refmeta>
5828 <refnamediv>
5829 <refname>glossterm.list.properties</refname>
5830 <refpurpose>To add properties to the glossterm in a list.</refpurpose>
5831 </refnamediv>
5832
5833 <refsynopsisdiv>
5834 <programlisting xml:id="glossterm.list.properties.frag">
5835 &lt;xsl:attribute-set name="glossterm.list.properties"&gt;
5836 &lt;/xsl:attribute-set&gt;
5837 </programlisting>
5838 </refsynopsisdiv>
5839 <refsection><info><title>Description</title></info>
5840 <para>These properties are added to the block containing a
5841 glossary term in a glossary when the <parameter>glossary.as.blocks</parameter> parameter
5842 is zero.
5843 Use this attribute-set to set
5844 font properties, for example.</para>
5845
5846 </refsection>
5847 </refentry>
5848
5849 <refentry version="5.0" xml:id="glossdef.list.properties">
5850 <refmeta>
5851 <refentrytitle>glossdef.list.properties</refentrytitle>
5852 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
5853 </refmeta>
5854 <refnamediv>
5855 <refname>glossdef.list.properties</refname>
5856 <refpurpose>To add properties to the glossary definition in a list.</refpurpose>
5857 </refnamediv>
5858
5859 <refsynopsisdiv>
5860 <programlisting xml:id="glossdef.list.properties.frag">
5861 &lt;xsl:attribute-set name="glossdef.list.properties"&gt;
5862 &lt;/xsl:attribute-set&gt;
5863 </programlisting>
5864 </refsynopsisdiv>
5865 <refsection><info><title>Description</title></info>
5866 <para>These properties are added to the block containing a
5867 glossary definition in a glossary when
5868 the <parameter>glossary.as.blocks</parameter> parameter
5869 is zero.
5870 Use this attribute-set to set font properties, for example.</para>
5871
5872 </refsection>
5873 </refentry>
5874
5875 <refentry version="5.0" xml:id="glossterm.width">
5876 <refmeta>
5877 <refentrytitle>glossterm.width</refentrytitle>
5878 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
5879 </refmeta>
5880 <refnamediv>
5881 <refname>glossterm.width</refname>
5882 <refpurpose>Width of glossterm in list presentation mode</refpurpose>
5883 </refnamediv>
5884
5885 <refsynopsisdiv>
5886 <programlisting xml:id="glossterm.width.frag">
5887 &lt;xsl:param name="glossterm.width"&gt;2in&lt;/xsl:param&gt;
5888 </programlisting>
5889 </refsynopsisdiv>
5890
5891 <refsection><info><title>Description</title></info>
5892
5893 <para>This parameter specifies the width reserved for glossary terms when
5894 a list presentation is used.</para>
5895
5896 </refsection>
5897 </refentry>
5898
5899 <refentry version="5.0" xml:id="glossterm.separation">
5900 <refmeta>
5901 <refentrytitle>glossterm.separation</refentrytitle>
5902 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
5903 </refmeta>
5904 <refnamediv>
5905 <refname>glossterm.separation</refname>
5906 <refpurpose>Separation between glossary terms and descriptions in list mode</refpurpose>
5907 </refnamediv>
5908
5909 <refsynopsisdiv>
5910 <programlisting xml:id="glossterm.separation.frag">
5911 &lt;xsl:param name="glossterm.separation"&gt;0.25in&lt;/xsl:param&gt;
5912 </programlisting>
5913 </refsynopsisdiv>
5914
5915 <refsection><info><title>Description</title></info>
5916
5917 <para>Specifies the miminum horizontal
5918 separation between glossary terms and descriptions when
5919 they are presented side-by-side using lists
5920 when the <parameter>glossary.as.blocks</parameter>
5921 is zero.</para>
5922
5923 </refsection>
5924 </refentry>
5925
5926 <refentry version="5.0" xml:id="glossentry.show.acronym">
5927 <refmeta>
5928 <refentrytitle>glossentry.show.acronym</refentrytitle>
5929 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
5930 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>
5931 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
5932 <refmiscinfo class="other" otherclass="value">primary</refmiscinfo>
5933 </refmeta>
5934 <refnamediv>
5935 <refname>glossentry.show.acronym</refname>
5936 <refpurpose>Display <tag>glossentry</tag> acronyms?</refpurpose>
5937 </refnamediv>
5938
5939 <refsynopsisdiv>
5940 <programlisting xml:id="glossentry.show.acronym.frag">
5941 &lt;xsl:param name="glossentry.show.acronym"&gt;no&lt;/xsl:param&gt;
5942 </programlisting>
5943 </refsynopsisdiv>
5944
5945 <refsection><info><title>Description</title></info>
5946
5947 <para>A setting of <quote>yes</quote> means they should be displayed;
5948 <quote>no</quote> means they shouldn't. If <quote>primary</quote> is used,
5949 then they are shown as the primary text for the entry.</para>
5950
5951 <note>
5952 <para>This setting controls both <tag>acronym</tag> and
5953 <tag>abbrev</tag> elements in the <tag>glossentry</tag>.</para>
5954 </note>
5955
5956 </refsection>
5957 </refentry>
5958
5959 <refentry version="5.0" xml:id="glossary.sort">
5960 <refmeta>
5961 <refentrytitle>glossary.sort</refentrytitle>
5962 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5963 </refmeta>
5964 <refnamediv>
5965 <refname>glossary.sort</refname>
5966 <refpurpose>Sort glossentry elements?</refpurpose>
5967 </refnamediv>
5968
5969 <refsynopsisdiv>
5970 <programlisting xml:id="glossary.sort.frag">
5971 &lt;xsl:param name="glossary.sort" select="0"&gt;&lt;/xsl:param&gt;
5972 </programlisting>
5973 </refsynopsisdiv>
5974
5975 <refsection><info><title>Description</title></info>
5976
5977 <para>If non-zero, then the glossentry elements within a
5978 glossary, glossdiv, or glosslist are sorted on the glossterm, using
5979 the current lang setting.  If zero (the default), then
5980 glossentry elements are not sorted and are presented
5981 in document order.
5982 </para>
5983
5984 </refsection>
5985 </refentry>
5986
5987 </reference>
5988 <reference xml:id="misc"><title>Miscellaneous</title>
5989 <refentry version="5.0" xml:id="formal.procedures">
5990 <refmeta>
5991 <refentrytitle>formal.procedures</refentrytitle>
5992 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5993 </refmeta>
5994 <refnamediv>
5995 <refname>formal.procedures</refname>
5996 <refpurpose>Selects formal or informal procedures</refpurpose>
5997 </refnamediv>
5998
5999 <refsynopsisdiv>
6000 <programlisting xml:id="formal.procedures.frag">
6001 &lt;xsl:param name="formal.procedures" select="1"&gt;&lt;/xsl:param&gt;
6002 </programlisting>
6003 </refsynopsisdiv>
6004
6005 <refsection><info><title>Description</title></info>
6006
6007 <para>Formal procedures are numbered and always have a title.
6008 </para>
6009
6010 </refsection>
6011 </refentry>
6012
6013 <refentry version="5.0" xml:id="formal.title.placement">
6014 <refmeta>
6015 <refentrytitle>formal.title.placement</refentrytitle>
6016 <refmiscinfo class="other" otherclass="datatype">table</refmiscinfo>
6017 </refmeta>
6018 <refnamediv>
6019 <refname>formal.title.placement</refname>
6020 <refpurpose>Specifies where formal object titles should occur</refpurpose>
6021 </refnamediv>
6022
6023 <refsynopsisdiv>
6024 <programlisting xml:id="formal.title.placement.frag">
6025 &lt;xsl:param name="formal.title.placement"&gt;
6026 figure before
6027 example before
6028 equation before
6029 table before
6030 procedure before
6031 task before
6032 &lt;/xsl:param&gt;
6033 </programlisting>
6034 </refsynopsisdiv>
6035
6036 <refsection><info><title>Description</title></info>
6037
6038 <para>Specifies where formal object titles should occur. For each formal object
6039 type (<tag>figure</tag>,
6040 <tag>example</tag>,
6041 <tag>equation</tag>,
6042 <tag>table</tag>, and <tag>procedure</tag>)
6043 you can specify either the keyword
6044 <quote><literal>before</literal></quote> or
6045 <quote><literal>after</literal></quote>.</para>
6046
6047 </refsection>
6048 </refentry>
6049
6050 <refentry version="5.0" xml:id="runinhead.default.title.end.punct">
6051 <refmeta>
6052 <refentrytitle>runinhead.default.title.end.punct</refentrytitle>
6053 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6054 </refmeta>
6055 <refnamediv>
6056 <refname>runinhead.default.title.end.punct</refname>
6057 <refpurpose>Default punctuation character on a run-in-head</refpurpose>
6058 </refnamediv>
6059
6060 <refsynopsisdiv>
6061 <programlisting xml:id="runinhead.default.title.end.punct.frag">&lt;xsl:param name="runinhead.default.title.end.punct"&gt;.&lt;/xsl:param&gt;
6062 </programlisting>
6063 </refsynopsisdiv>
6064
6065 <refsection><info><title>Description</title></info>
6066
6067 <para>If non-zero, For a <tag>formalpara</tag>, use the specified
6068 string as the separator between the title and following text. The period is the default value.</para>
6069
6070 </refsection>
6071 </refentry>
6072
6073 <refentry version="5.0" xml:id="runinhead.title.end.punct">
6074 <refmeta>
6075 <refentrytitle>runinhead.title.end.punct</refentrytitle>
6076 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6077 </refmeta>
6078 <refnamediv>
6079 <refname>runinhead.title.end.punct</refname>
6080 <refpurpose>Characters that count as punctuation on a run-in-head</refpurpose>
6081 </refnamediv>
6082
6083 <refsynopsisdiv>
6084 <programlisting xml:id="runinhead.title.end.punct.frag">
6085 &lt;xsl:param name="runinhead.title.end.punct"&gt;.!?:&lt;/xsl:param&gt;
6086 </programlisting>
6087 </refsynopsisdiv>
6088
6089 <refsection><info><title>Description</title></info>
6090
6091 <para>Specify which characters are to be counted as punctuation. These
6092 characters are checked for a match with the last character of the
6093 title. If no match is found, the
6094 <parameter>runinhead.default.title.end.punct</parameter> contents are
6095 inserted. This is to avoid duplicated punctuation in the output.
6096 </para>
6097
6098 </refsection>
6099 </refentry>
6100
6101 <refentry version="5.0" xml:id="show.comments">
6102 <refmeta>
6103 <refentrytitle>show.comments</refentrytitle>
6104 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6105 </refmeta>
6106 <refnamediv>
6107 <refname>show.comments</refname>
6108 <refpurpose>Display <tag>remark</tag> elements?</refpurpose>
6109 </refnamediv>
6110
6111 <refsynopsisdiv>
6112 <programlisting xml:id="show.comments.frag">
6113 &lt;xsl:param name="show.comments" select="1"&gt;&lt;/xsl:param&gt;
6114 </programlisting>
6115 </refsynopsisdiv>
6116
6117 <refsection><info><title>Description</title></info>
6118
6119 <para>If non-zero, comments will be displayed, otherwise they
6120 are suppressed.  Comments here refers to the <tag>remark</tag> element
6121 (which was called <literal>comment</literal> prior to DocBook
6122 4.0), not XML comments (&lt;-- like this --&gt;) which are
6123 unavailable.
6124 </para>
6125
6126 </refsection>
6127 </refentry>
6128
6129 <refentry version="5.0" xml:id="punct.honorific">
6130 <refmeta>
6131 <refentrytitle>punct.honorific</refentrytitle>
6132 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6133 </refmeta>
6134 <refnamediv>
6135 <refname>punct.honorific</refname>
6136 <refpurpose>Punctuation after an honorific in a personal name.</refpurpose>
6137 </refnamediv>
6138
6139 <refsynopsisdiv>
6140 <programlisting xml:id="punct.honorific.frag">
6141 &lt;xsl:param name="punct.honorific"&gt;.&lt;/xsl:param&gt;
6142 </programlisting>
6143 </refsynopsisdiv>
6144
6145 <refsection><info><title>Description</title></info>
6146
6147 <para>This parameter specifies the punctuation that should be added after an
6148 honorific in a personal name.</para>
6149
6150 </refsection>
6151 </refentry>
6152
6153 <refentry version="5.0" xml:id="segmentedlist.as.table">
6154 <refmeta>
6155 <refentrytitle>segmentedlist.as.table</refentrytitle>
6156 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6157 </refmeta>
6158 <refnamediv>
6159 <refname>segmentedlist.as.table</refname>
6160 <refpurpose>Format segmented lists as tables?</refpurpose>
6161 </refnamediv>
6162
6163 <refsynopsisdiv>
6164 <programlisting xml:id="segmentedlist.as.table.frag">
6165 &lt;xsl:param name="segmentedlist.as.table" select="0"&gt;&lt;/xsl:param&gt;
6166 </programlisting>
6167 </refsynopsisdiv>
6168
6169 <refsection><info><title>Description</title></info>
6170
6171 <para>If non-zero, <tag>segmentedlist</tag>s will be formatted as
6172 tables.</para>
6173
6174 </refsection>
6175 </refentry>
6176
6177 <refentry version="5.0" xml:id="variablelist.as.blocks">
6178 <refmeta>
6179 <refentrytitle>variablelist.as.blocks</refentrytitle>
6180 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6181 </refmeta>
6182 <refnamediv>
6183 <refname>variablelist.as.blocks</refname>
6184 <refpurpose>Format <tag>variablelist</tag>s lists as blocks?</refpurpose>
6185 </refnamediv>
6186
6187 <refsynopsisdiv>
6188 <programlisting xml:id="variablelist.as.blocks.frag">
6189 &lt;xsl:param name="variablelist.as.blocks" select="0"&gt;&lt;/xsl:param&gt;
6190 </programlisting>
6191 </refsynopsisdiv>
6192
6193 <refsection><info><title>Description</title></info>
6194
6195 <para>If non-zero, <tag>variablelist</tag>s will be formatted as
6196 blocks.</para>
6197
6198 <para>If you have long terms, proper list markup in the FO case may produce
6199 unattractive lists. By setting this parameter, you can force the stylesheets
6200 to produce block markup instead of proper lists.</para>
6201
6202 <para>You can override this setting with a processing instruction as the
6203 child of <tag>variablelist</tag>: <tag class="xmlpi">dbfo
6204 list-presentation="blocks"</tag> or <tag class="xmlpi">dbfo
6205 list-presentation="list"</tag>.</para>
6206
6207 <para>When using <literal>list-presentation="list"</literal>,
6208 you can also control the amount of space used for the <tag>term</tag>s with
6209 the <tag class="xmlpi">dbfo term-width=".25in"</tag> processing instruction,
6210 the <tag class="attribute">termlength</tag> attribute on <tag>variablelist</tag>,
6211 or allow the stylesheets to attempt to calculate the amount of space to leave based on the
6212 number of letters in the longest term.
6213 </para>
6214
6215 <programlisting>  &lt;variablelist&gt;
6216         &lt;?dbfo list-presentation="list"?&gt;
6217         &lt;?dbfo term-width="1.5in"?&gt;
6218         &lt;?dbhtml list-presentation="table"?&gt;
6219         &lt;?dbhtml term-width="1.5in"?&gt;
6220         &lt;varlistentry&gt;
6221           &lt;term&gt;list&lt;/term&gt;
6222           &lt;listitem&gt;
6223                 &lt;para&gt;
6224                   Formatted as a list even if variablelist.as.blocks is set to 1.
6225                 &lt;/para&gt;
6226           &lt;/listitem&gt;
6227         &lt;/varlistentry&gt;
6228   &lt;/variablelist&gt;</programlisting>
6229
6230
6231 </refsection>
6232
6233 </refentry>
6234
6235 <refentry version="5.0" xml:id="blockquote.properties">
6236 <refmeta>
6237   <refentrytitle>blockquote.properties</refentrytitle>
6238   <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
6239 </refmeta>
6240 <refnamediv>
6241 <refname>blockquote.properties</refname>
6242 <refpurpose>To set the style for block quotations.</refpurpose>
6243 </refnamediv>
6244
6245 <refsynopsisdiv>
6246 <programlisting xml:id="blockquote.properties.frag">
6247 &lt;xsl:attribute-set name="blockquote.properties"&gt;
6248 &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;0.5in&lt;/xsl:attribute&gt;
6249 &lt;xsl:attribute name="margin-{$direction.align.end}"&gt;0.5in&lt;/xsl:attribute&gt;
6250 &lt;xsl:attribute name="space-after.minimum"&gt;0.5em&lt;/xsl:attribute&gt;
6251 &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;
6252 &lt;xsl:attribute name="space-after.maximum"&gt;2em&lt;/xsl:attribute&gt;
6253 &lt;/xsl:attribute-set&gt;
6254 </programlisting>
6255 </refsynopsisdiv>
6256
6257 <refsection><info><title>Description</title></info>
6258
6259 <para>The <parameter>blockquote.properties</parameter> attribute set specifies
6260 the formating properties of block quotations.</para>
6261
6262 </refsection>
6263 </refentry>
6264
6265 <refentry version="5.0" xml:id="ulink.show">
6266 <refmeta>
6267 <refentrytitle>ulink.show</refentrytitle>
6268 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6269 </refmeta>
6270 <refnamediv>
6271 <refname>ulink.show</refname>
6272 <refpurpose>Display URLs after <tag>ulink</tag>s?</refpurpose>
6273 </refnamediv>
6274
6275 <refsynopsisdiv>
6276 <programlisting xml:id="ulink.show.frag">
6277 &lt;xsl:param name="ulink.show" select="1"&gt;&lt;/xsl:param&gt;
6278 </programlisting>
6279 </refsynopsisdiv>
6280
6281 <refsection><info><title>Description</title></info>
6282
6283 <para>If non-zero, the URL of each <tag>ulink</tag> will
6284 appear after the text of the link. If the text of the link and the URL
6285 are identical, the URL is suppressed. </para>
6286
6287 <para>See also <parameter>ulink.footnotes</parameter>.</para>
6288
6289 <note><para>DocBook 5 does not have an <tag>ulink</tag> element. When processing
6290 DocBoook 5 documents, <parameter>ulink.show</parameter> applies to all inline
6291 elements that are marked up with <tag class="attribute">xlink:href</tag> attributes
6292 that point to external resources.</para>
6293 </note>
6294
6295 </refsection>
6296 </refentry>
6297
6298 <refentry version="5.0" xml:id="ulink.footnotes">
6299 <refmeta>
6300 <refentrytitle>ulink.footnotes</refentrytitle>
6301 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6302 </refmeta>
6303 <refnamediv>
6304 <refname>ulink.footnotes</refname>
6305 <refpurpose>Generate footnotes for <tag>ulink</tag>s?</refpurpose>
6306 </refnamediv>
6307
6308 <refsynopsisdiv>
6309 <programlisting xml:id="ulink.footnotes.frag">
6310 &lt;xsl:param name="ulink.footnotes" select="0"&gt;&lt;/xsl:param&gt;
6311 </programlisting>
6312 </refsynopsisdiv>
6313
6314 <refsection><info><title>Description</title></info>
6315
6316 <para>If non-zero, and if <parameter>ulink.show</parameter> also is non-zero,
6317 the URL of each <tag>ulink</tag> will appear as a footnote.</para>
6318
6319 <note><para>DocBook 5 does not have an <tag>ulink</tag> element. When processing
6320 DocBoook 5 documents, <parameter>ulink.footnotes</parameter> applies to all inline
6321 elements that are marked up with <tag class="attribute">xlink:href</tag> attributes
6322 that point to external resources.</para>
6323 </note>
6324
6325 </refsection>
6326 </refentry>
6327
6328 <refentry version="5.0" xml:id="ulink.hyphenate">
6329 <refmeta>
6330 <refentrytitle>ulink.hyphenate</refentrytitle>
6331 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6332 </refmeta>
6333 <refnamediv>
6334 <refname>ulink.hyphenate</refname>
6335 <refpurpose>Allow URLs to be automatically hyphenated</refpurpose>
6336 </refnamediv>
6337
6338 <refsynopsisdiv>
6339 <programlisting xml:id="ulink.hyphenate.frag">
6340 &lt;xsl:param name="ulink.hyphenate"&gt;&lt;/xsl:param&gt;
6341 </programlisting>
6342 </refsynopsisdiv>
6343
6344 <refsection><info><title>Description</title></info>
6345
6346 <para>If not empty, the specified character (or more generally,
6347 content) is added to URLs after every character included in the string
6348 in the <parameter>ulink.hyphenate.chars</parameter> parameter (default
6349 is <quote>/</quote>) to enable hyphenation of ulinks. If the character
6350 in this parameter is a Unicode soft hyphen (0x00AD) or Unicode
6351 zero-width space (0x200B), some FO processors will be able to
6352 reasonably hyphenate long URLs.</para>
6353
6354 <para>Note that this hyphenation process is only applied when the
6355 ulink element is empty and the url attribute is reused as the link
6356 text.  It is not applied if the ulink has literal text content. The
6357 same applies in in DocBook 5, where ulink was replaced with link with
6358 an xlink:href attribute.</para>
6359
6360 </refsection>
6361 </refentry>
6362
6363 <refentry version="5.0" xml:id="ulink.hyphenate.chars">
6364 <refmeta>
6365 <refentrytitle>ulink.hyphenate.chars</refentrytitle>
6366 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6367 </refmeta>
6368 <refnamediv>
6369 <refname>ulink.hyphenate.chars</refname>
6370 <refpurpose>List of characters to allow ulink URLs to be automatically
6371 hyphenated on</refpurpose>
6372 </refnamediv>
6373
6374 <refsynopsisdiv>
6375 <programlisting xml:id="ulink.hyphenate.chars.frag">
6376 &lt;xsl:param name="ulink.hyphenate.chars"&gt;/&lt;/xsl:param&gt;
6377 </programlisting>
6378 </refsynopsisdiv>
6379
6380 <refsection><info><title>Description</title></info>
6381
6382 <para>If the <parameter>ulink.hyphenate</parameter> parameter is not
6383 empty, then hyphenation of ulinks is turned on, and any character
6384 contained in this parameter is treated as an allowable hyphenation
6385 point. This and <parameter>ulink.hyphenate</parameter> work together,
6386 one is pointless without the other being set to a non-empty value</para>
6387
6388 <para>The default value is <quote>/</quote>, but the parameter could
6389 be customized to contain other URL characters, as for example:</para>
6390 <programlisting>
6391 &lt;xsl:param name="ulink.hyphenate.chars"&gt;:/@&amp;?.#&lt;/xsl:param&gt;
6392 </programlisting>
6393
6394 </refsection>
6395 </refentry>
6396
6397 <refentry version="5.0" xml:id="shade.verbatim">
6398 <refmeta>
6399 <refentrytitle>shade.verbatim</refentrytitle>
6400 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6401 </refmeta>
6402 <refnamediv>
6403 <refname>shade.verbatim</refname>
6404 <refpurpose>Should verbatim environments be shaded?</refpurpose>
6405 </refnamediv>
6406
6407 <refsynopsisdiv>
6408 <programlisting xml:id="shade.verbatim.frag">&lt;xsl:param name="shade.verbatim" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
6409 </refsynopsisdiv>
6410
6411 <refsection><info><title>Description</title></info>
6412
6413 <para>In the FO stylesheet, if this parameter is non-zero then the
6414 <property>shade.verbatim.style</property> properties will be applied
6415 to verbatim environments.</para>
6416
6417 <para>In the HTML stylesheet, this parameter is now deprecated. Use
6418 CSS instead.</para>
6419
6420 </refsection>
6421 </refentry>
6422
6423 <refentry version="5.0" xml:id="shade.verbatim.style">
6424 <refmeta>
6425 <refentrytitle>shade.verbatim.style</refentrytitle>
6426 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
6427 </refmeta>
6428 <refnamediv>
6429 <refname>shade.verbatim.style</refname>
6430 <refpurpose>Properties that specify the style of shaded verbatim listings</refpurpose>
6431 </refnamediv>
6432
6433 <refsynopsisdiv>
6434 <programlisting xml:id="shade.verbatim.style.frag">
6435
6436 &lt;xsl:attribute-set name="shade.verbatim.style"&gt;
6437   &lt;xsl:attribute name="background-color"&gt;#E0E0E0&lt;/xsl:attribute&gt;
6438 &lt;/xsl:attribute-set&gt;
6439 </programlisting>
6440 </refsynopsisdiv>
6441
6442 <refsection><info><title>Description</title></info>
6443
6444 <para>Properties that specify the style of shaded verbatim listings. The
6445 parameters specified (the border and background color) are added to
6446 the styling of the xsl-fo output. A border might be specified as "thin
6447 black solid" for example. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/2004/WD-xsl11-20041216/#border">xsl-fo</link></para>
6448
6449 </refsection>
6450 </refentry>
6451
6452 <refentry version="5.0" xml:id="hyphenate.verbatim">
6453 <refmeta>
6454 <refentrytitle>hyphenate.verbatim</refentrytitle>
6455 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6456 </refmeta>
6457 <refnamediv>
6458 <refname>hyphenate.verbatim</refname>
6459 <refpurpose>Should verbatim environments be hyphenated on space characters?</refpurpose>
6460 </refnamediv>
6461
6462 <refsynopsisdiv>
6463 <programlisting xml:id="hyphenate.verbatim.frag">&lt;xsl:param name="hyphenate.verbatim" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
6464 </refsynopsisdiv>
6465
6466 <refsection><info><title>Description</title></info>
6467
6468 <para>If the lines of program listing are too long to fit into one
6469 line it is quite common to split them at space and indicite by hook
6470 arrow that code continues on the next line. You can turn on this
6471 behaviour for <tag>programlisting</tag>,
6472 <tag>screen</tag> and <tag>synopsis</tag> elements by
6473 using this parameter.</para>
6474
6475 <para>Note that you must also enable line wrapping for verbatim environments and
6476 select appropriate hyphenation character (e.g. hook arrow). This can
6477 be done using <parameter>monospace.verbatim.properties</parameter>
6478 attribute set:</para>
6479
6480 <programlisting>&lt;xsl:attribute-set name="monospace.verbatim.properties"
6481                    use-attribute-sets="verbatim.properties monospace.properties"&gt;
6482   &lt;xsl:attribute name="wrap-option"&gt;wrap&lt;/xsl:attribute&gt;
6483   &lt;xsl:attribute name="hyphenation-character"&gt;&amp;#x25BA;&lt;/xsl:attribute&gt;
6484 &lt;/xsl:attribute-set&gt;</programlisting>
6485
6486 <para>For a list of arrows available in Unicode see <uri xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.unicode.org/charts/PDF/U2190.pdf">http://www.unicode.org/charts/PDF/U2190.pdf</uri> and <uri xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.unicode.org/charts/PDF/U2900.pdf">http://www.unicode.org/charts/PDF/U2900.pdf</uri> and make sure that
6487 selected character is available in the font you are using for verbatim
6488 environments.</para>
6489
6490 </refsection>
6491 </refentry>
6492
6493 <refentry version="5.0" xml:id="hyphenate.verbatim.characters">
6494 <refmeta>
6495 <refentrytitle>hyphenate.verbatim.characters</refentrytitle>
6496 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6497 </refmeta>
6498 <refnamediv>
6499 <refname>hyphenate.verbatim.characters</refname>
6500 <refpurpose>List of characters after which a line break can occur in listings</refpurpose>
6501 </refnamediv>
6502
6503 <refsynopsisdiv>
6504 <programlisting xml:id="hyphenate.verbatim.characters.frag">
6505 &lt;xsl:param name="hyphenate.verbatim.characters"&gt;&lt;/xsl:param&gt;
6506 </programlisting>
6507 </refsynopsisdiv>
6508
6509 <refsection><info><title>Description</title></info>
6510
6511 <para>If you enable <parameter>hyphenate.verbatim</parameter> line
6512 breaks are allowed only on space characters. If this is not enough for
6513 your document, you can specify list of additional characters after
6514 which line break is allowed in this parameter.</para>
6515
6516 </refsection>
6517 </refentry>
6518
6519 <refentry version="5.0" xml:id="use.svg">
6520 <refmeta>
6521 <refentrytitle>use.svg</refentrytitle>
6522 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6523 </refmeta>
6524 <refnamediv>
6525 <refname>use.svg</refname>
6526 <refpurpose>Allow SVG in the result tree?</refpurpose>
6527 </refnamediv>
6528
6529 <refsynopsisdiv>
6530 <programlisting xml:id="use.svg.frag">
6531 &lt;xsl:param name="use.svg" select="1"&gt;&lt;/xsl:param&gt;
6532 </programlisting>
6533 </refsynopsisdiv>
6534
6535 <refsection><info><title>Description</title></info>
6536
6537 <para>If non-zero, SVG will be considered an acceptable image format. SVG
6538 is passed through to the result tree, so correct rendering of the resulting
6539 diagram depends on the formatter (FO processor or web browser) that is used
6540 to process the output from the stylesheet.</para>
6541
6542 </refsection>
6543 </refentry>
6544
6545 <refentry version="5.0" xml:id="use.role.as.xrefstyle">
6546 <refmeta>
6547 <refentrytitle>use.role.as.xrefstyle</refentrytitle>
6548 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6549 </refmeta>
6550 <refnamediv>
6551 <refname>use.role.as.xrefstyle</refname>
6552 <refpurpose>Use <tag class="attribute">role</tag> attribute for
6553 <tag class="attribute">xrefstyle</tag> on <tag>xref</tag>?</refpurpose>
6554 </refnamediv>
6555
6556 <refsynopsisdiv>
6557 <programlisting xml:id="use.role.as.xrefstyle.frag">
6558 &lt;xsl:param name="use.role.as.xrefstyle" select="1"&gt;&lt;/xsl:param&gt;
6559 </programlisting>
6560 </refsynopsisdiv>
6561
6562 <refsection><info><title>Description</title></info>
6563
6564 <para>In DocBook documents that conform to a schema older than V4.3, this parameter allows
6565 <tag class="attribute">role</tag> to serve the purpose of specifying the cross reference style.</para>
6566
6567 <para>If non-zero, the <tag class="attribute">role</tag> attribute on
6568 <tag>xref</tag> will be used to select the cross reference style.
6569 In DocBook V4.3, the <tag class="attribute">xrefstyle</tag> attribute was added for this purpose.
6570 If the <tag class="attribute">xrefstyle</tag> attribute is present,
6571 <tag class="attribute">role</tag> will be ignored, regardless of the setting
6572 of this parameter.</para>
6573
6574 </refsection>
6575
6576 <refsection><info><title>Example</title></info>
6577
6578 <para>The following small stylesheet shows how to configure the
6579 stylesheets to make use of the cross reference style:</para>
6580
6581 <programlisting>&lt;?xml version="1.0"?&gt;
6582 &lt;xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
6583                 version="1.0"&gt;
6584
6585 &lt;xsl:import href="../xsl/html/docbook.xsl"/&gt;
6586
6587 &lt;xsl:output method="html"/&gt;
6588
6589 &lt;xsl:param name="local.l10n.xml" select="document('')"/&gt;
6590 &lt;l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0"&gt;
6591   &lt;l:l10n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" language="en"&gt;
6592    &lt;l:context name="xref"&gt;
6593       &lt;l:template name="chapter" style="title" text="Chapter %n, %t"/&gt;
6594       &lt;l:template name="chapter" text="Chapter %n"/&gt;
6595     &lt;/l:context&gt;
6596   &lt;/l:l10n&gt;
6597 &lt;/l:i18n&gt;
6598
6599 &lt;/xsl:stylesheet&gt;</programlisting>
6600
6601 <para>With this stylesheet, the cross references in the following document:</para>
6602
6603 <programlisting>&lt;?xml version="1.0" encoding="utf-8"?&gt;
6604 &lt;!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
6605                   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"&gt;
6606 &lt;book id="book"&gt;&lt;title&gt;Book&lt;/title&gt;
6607
6608 &lt;preface&gt;
6609 &lt;title&gt;Preface&lt;/title&gt;
6610
6611 &lt;para&gt;Normal: &lt;xref linkend="ch1"/&gt;.&lt;/para&gt;
6612 &lt;para&gt;Title: &lt;xref xrefstyle="title" linkend="ch1"/&gt;.&lt;/para&gt;
6613
6614 &lt;/preface&gt;
6615
6616 &lt;chapter id="ch1"&gt;
6617 &lt;title&gt;First Chapter&lt;/title&gt;
6618
6619 &lt;para&gt;Irrelevant.&lt;/para&gt;
6620
6621 &lt;/chapter&gt;
6622 &lt;/book&gt;</programlisting>
6623
6624 <para>will appear as:</para>
6625
6626 <informalexample>
6627 <para>Normal: Chapter 1.</para>
6628 <para>Title: Chapter 1, <emphasis>First Chapter</emphasis>.</para>
6629 </informalexample>
6630 </refsection>
6631
6632 </refentry>
6633
6634 <refentry version="5.0" xml:id="menuchoice.separator">
6635 <refmeta>
6636 <refentrytitle>menuchoice.separator</refentrytitle>
6637 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6638 </refmeta>
6639 <refnamediv>
6640 <refname>menuchoice.separator</refname>
6641 <refpurpose>Separator between items of a <tag>menuchoice</tag>
6642 other than <tag>guimenuitem</tag> and
6643 <tag>guisubmenu</tag></refpurpose>
6644 </refnamediv>
6645
6646 <refsynopsisdiv>
6647 <programlisting xml:id="menuchoice.separator.frag">
6648 &lt;xsl:param name="menuchoice.separator"&gt;+&lt;/xsl:param&gt;
6649 </programlisting>
6650 </refsynopsisdiv>
6651
6652 <refsection><info><title>Description</title></info>
6653
6654 <para>Separator used to connect items of a <tag>menuchoice</tag> other
6655 than <tag>guimenuitem</tag> and <tag>guisubmenu</tag>. The latter
6656 elements are linked with <parameter>menuchoice.menu.separator</parameter>.
6657 </para>
6658
6659 </refsection>
6660 </refentry>
6661
6662 <refentry version="5.0" xml:id="menuchoice.menu.separator">
6663 <refmeta>
6664 <refentrytitle>menuchoice.menu.separator</refentrytitle>
6665 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6666 </refmeta>
6667 <refnamediv>
6668 <refname>menuchoice.menu.separator</refname>
6669 <refpurpose>Separator between items of a <tag>menuchoice</tag>
6670 with <tag>guimenuitem</tag> or
6671 <tag>guisubmenu</tag></refpurpose>
6672 </refnamediv>
6673
6674 <refsynopsisdiv>
6675 <programlisting xml:id="menuchoice.menu.separator.frag">
6676 &lt;xsl:param name="menuchoice.menu.separator"&gt; &#8594; &lt;/xsl:param&gt;
6677 </programlisting>
6678 </refsynopsisdiv>
6679
6680 <refsection><info><title>Description</title></info>
6681
6682 <para>Separator used to connect items of a <tag>menuchoice</tag> with
6683 <tag>guimenuitem</tag> or <tag>guisubmenu</tag>. Other elements
6684 are linked with <parameter>menuchoice.separator</parameter>.
6685 </para>
6686 <para>The default value is &amp;#x2192;, which is the
6687 &amp;rarr; (right arrow) character entity.
6688 The current FOP (0.20.5) requires setting the font-family
6689 explicitly.
6690 </para>
6691 <para>The default value also includes spaces around the arrow,
6692 which will allow a line to break.  Replace the spaces with
6693 &amp;#xA0; (nonbreaking space) if you don't want those
6694 spaces to break.
6695 </para>
6696
6697 </refsection>
6698 </refentry>
6699
6700 <refentry version="5.0" xml:id="default.float.class">
6701 <refmeta>
6702 <refentrytitle>default.float.class</refentrytitle>
6703 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6704 </refmeta>
6705 <refnamediv>
6706 <refname>default.float.class</refname>
6707 <refpurpose>Specifies the default float class</refpurpose>
6708 </refnamediv>
6709
6710 <refsynopsisdiv>
6711 <programlisting xml:id="default.float.class.frag">
6712 &lt;xsl:param name="default.float.class"&gt;
6713   &lt;xsl:choose&gt;
6714     &lt;xsl:when test="contains($stylesheet.result.type,'html')"&gt;left&lt;/xsl:when&gt;
6715     &lt;xsl:otherwise&gt;before&lt;/xsl:otherwise&gt;
6716   &lt;/xsl:choose&gt;
6717 &lt;/xsl:param&gt;
6718 </programlisting>
6719 </refsynopsisdiv>
6720
6721 <refsection><info><title>Description</title></info>
6722
6723 <para>Selects the direction in which a float should be placed. for
6724 xsl-fo this is before, for html it is left. For Western texts, the
6725 before direction is the top of the page.</para>
6726
6727 </refsection>
6728 </refentry>
6729
6730 <refentry version="5.0" xml:id="footnote.number.format">
6731 <refmeta>
6732 <refentrytitle>footnote.number.format</refentrytitle>
6733 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
6734 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>
6735 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>
6736 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>
6737 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>
6738 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>
6739 </refmeta>
6740 <refnamediv>
6741 <refname>footnote.number.format</refname>
6742 <refpurpose>Identifies the format used for footnote numbers</refpurpose>
6743 </refnamediv>
6744
6745 <refsynopsisdiv>
6746 <programlisting xml:id="footnote.number.format.frag">
6747 &lt;xsl:param name="footnote.number.format"&gt;1&lt;/xsl:param&gt;
6748 </programlisting>
6749 </refsynopsisdiv>
6750
6751 <refsection><info><title>Description</title></info>
6752
6753 <para>The <parameter>footnote.number.format</parameter> specifies the format
6754 to use for footnote numeration (1, i, I, a, or A).</para>
6755
6756 </refsection>
6757 </refentry>
6758
6759 <refentry version="5.0" xml:id="table.footnote.number.format">
6760 <refmeta>
6761 <refentrytitle>table.footnote.number.format</refentrytitle>
6762 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
6763 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>
6764 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>
6765 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>
6766 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>
6767 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>
6768 </refmeta>
6769 <refnamediv>
6770 <refname>table.footnote.number.format</refname>
6771 <refpurpose>Identifies the format used for footnote numbers in tables</refpurpose>
6772 </refnamediv>
6773
6774 <refsynopsisdiv>
6775 <programlisting xml:id="table.footnote.number.format.frag">
6776 &lt;xsl:param name="table.footnote.number.format"&gt;a&lt;/xsl:param&gt;
6777 </programlisting>
6778 </refsynopsisdiv>
6779
6780 <refsection><info><title>Description</title></info>
6781
6782 <para>The <parameter>table.footnote.number.format</parameter> specifies the format
6783 to use for footnote numeration (1, i, I, a, or A) in tables.</para>
6784
6785 </refsection>
6786 </refentry>
6787
6788 <refentry version="5.0" xml:id="footnote.number.symbols">
6789 <refmeta>
6790 <refentrytitle>footnote.number.symbols</refentrytitle>
6791 <refmiscinfo class="other" otherclass="datatype"/>
6792 </refmeta>
6793 <refnamediv>
6794 <refname>footnote.number.symbols</refname>
6795 <refpurpose>Special characters to use as footnote markers</refpurpose>
6796 </refnamediv>
6797
6798 <refsynopsisdiv>
6799 <programlisting xml:id="footnote.number.symbols.frag">
6800 &lt;xsl:param name="footnote.number.symbols"&gt;&lt;/xsl:param&gt;
6801 </programlisting>
6802 </refsynopsisdiv>
6803
6804 <refsection><info><title>Description</title></info>
6805
6806 <para>If <parameter>footnote.number.symbols</parameter> is not the empty string,
6807 footnotes will use the characters it contains as footnote symbols. For example,
6808 <quote>*&amp;#x2020;&amp;#x2021;&amp;#x25CA;&amp;#x2720;</quote> will identify
6809 footnotes with <quote>*</quote>, <quote>&#8224;</quote>, <quote>&#8225;</quote>,
6810 <quote>&#9674;</quote>, and <quote>&#10016;</quote>. If there are more footnotes
6811 than symbols, the stylesheets will fall back to numbered footnotes using
6812 <parameter>footnote.number.format</parameter>.</para>
6813
6814 <para>The use of symbols for footnotes depends on the ability of your
6815 processor (or browser) to render the symbols you select. Not all systems are
6816 capable of displaying the full range of Unicode characters. If the quoted characters
6817 in the preceding paragraph are not displayed properly, that's a good indicator
6818 that you may have trouble using those symbols for footnotes.</para>
6819
6820 </refsection>
6821 </refentry>
6822
6823 <refentry version="5.0" xml:id="table.footnote.number.symbols">
6824 <refmeta>
6825 <refentrytitle>table.footnote.number.symbols</refentrytitle>
6826 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6827 </refmeta>
6828 <refnamediv>
6829 <refname>table.footnote.number.symbols</refname>
6830 <refpurpose>Special characters to use a footnote markers in tables</refpurpose>
6831 </refnamediv>
6832
6833 <refsynopsisdiv>
6834 <programlisting xml:id="table.footnote.number.symbols.frag">
6835 &lt;xsl:param name="table.footnote.number.symbols"&gt;&lt;/xsl:param&gt;
6836 </programlisting>
6837 </refsynopsisdiv>
6838
6839 <refsection><info><title>Description</title></info>
6840
6841 <para>If <parameter>table.footnote.number.symbols</parameter> is not the empty string,
6842 table footnotes will use the characters it contains as footnote symbols. For example,
6843 <quote>*&amp;#x2020;&amp;#x2021;&amp;#x25CA;&amp;#x2720;</quote> will identify
6844 footnotes with <quote>*</quote>, <quote>&#8224;</quote>, <quote>&#8225;</quote>,
6845 <quote>&#9674;</quote>, and <quote>&#10016;</quote>. If there are more footnotes
6846 than symbols, the stylesheets will fall back to numbered footnotes using
6847 <parameter>table.footnote.number.format</parameter>.</para>
6848
6849 <para>The use of symbols for footnotes depends on the ability of your
6850 processor (or browser) to render the symbols you select. Not all systems are
6851 capable of displaying the full range of Unicode characters. If the quoted characters
6852 in the preceding paragraph are not displayed properly, that's a good indicator
6853 that you may have trouble using those symbols for footnotes.</para>
6854
6855 </refsection>
6856 </refentry>
6857
6858 <refentry version="5.0" xml:id="footnote.properties">
6859 <refmeta>
6860 <refentrytitle>footnote.properties</refentrytitle>
6861 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
6862 </refmeta>
6863 <refnamediv>
6864 <refname>footnote.properties</refname>
6865 <refpurpose>Properties applied to each footnote body
6866 </refpurpose>
6867 </refnamediv>
6868
6869 <refsynopsisdiv>
6870 <programlisting xml:id="footnote.properties.frag">
6871 &lt;xsl:attribute-set name="footnote.properties"&gt;
6872   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
6873   &lt;xsl:attribute name="font-size"&gt;&lt;xsl:value-of select="$footnote.font.size"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
6874   &lt;xsl:attribute name="font-weight"&gt;normal&lt;/xsl:attribute&gt;
6875   &lt;xsl:attribute name="font-style"&gt;normal&lt;/xsl:attribute&gt;
6876   &lt;xsl:attribute name="text-align"&gt;&lt;xsl:value-of select="$alignment"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
6877   &lt;xsl:attribute name="start-indent"&gt;0pt&lt;/xsl:attribute&gt;
6878   &lt;xsl:attribute name="end-indent"&gt;0pt&lt;/xsl:attribute&gt;
6879   &lt;xsl:attribute name="text-indent"&gt;0pt&lt;/xsl:attribute&gt;
6880   &lt;xsl:attribute name="hyphenate"&gt;&lt;xsl:value-of select="$hyphenate"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
6881   &lt;xsl:attribute name="wrap-option"&gt;wrap&lt;/xsl:attribute&gt;
6882   &lt;xsl:attribute name="linefeed-treatment"&gt;treat-as-space&lt;/xsl:attribute&gt;
6883 &lt;/xsl:attribute-set&gt;
6884 </programlisting>
6885 </refsynopsisdiv>
6886
6887 <refsection><info><title>Description</title></info>
6888
6889 <para>This attribute set is applied to the footnote-block
6890 for each footnote.
6891 It can be used to set the
6892 font-size, font-family, and other inheritable properties that will be
6893 applied to all footnotes.</para>
6894
6895 </refsection>
6896 </refentry>
6897
6898 <refentry version="5.0" xml:id="table.footnote.properties">
6899 <refmeta>
6900 <refentrytitle>table.footnote.properties</refentrytitle>
6901 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
6902 </refmeta>
6903 <refnamediv>
6904 <refname>table.footnote.properties</refname>
6905 <refpurpose>Properties applied to each table footnote body
6906 </refpurpose>
6907 </refnamediv>
6908
6909 <refsynopsisdiv>
6910 <programlisting xml:id="table.footnote.properties.frag">
6911 &lt;xsl:attribute-set name="table.footnote.properties"&gt;
6912   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
6913   &lt;xsl:attribute name="font-size"&gt;&lt;xsl:value-of select="$footnote.font.size"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
6914   &lt;xsl:attribute name="font-weight"&gt;normal&lt;/xsl:attribute&gt;
6915   &lt;xsl:attribute name="font-style"&gt;normal&lt;/xsl:attribute&gt;
6916   &lt;xsl:attribute name="space-before"&gt;2pt&lt;/xsl:attribute&gt;
6917   &lt;xsl:attribute name="text-align"&gt;&lt;xsl:value-of select="$alignment"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
6918 &lt;/xsl:attribute-set&gt;
6919 </programlisting>
6920 </refsynopsisdiv>
6921
6922 <refsection><info><title>Description</title></info>
6923
6924 <para>This attribute set is applied to the footnote-block
6925 for each table footnote.
6926 It can be used to set the
6927 font-size, font-family, and other inheritable properties that will be
6928 applied to all table footnotes.</para>
6929
6930 </refsection>
6931 </refentry>
6932
6933 <refentry version="5.0" xml:id="footnote.mark.properties">
6934 <refmeta>
6935 <refentrytitle>footnote.mark.properties</refentrytitle>
6936 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
6937 </refmeta>
6938 <refnamediv>
6939 <refname>footnote.mark.properties</refname>
6940 <refpurpose>Properties applied to each footnote mark
6941 </refpurpose>
6942 </refnamediv>
6943
6944 <refsynopsisdiv>
6945 <programlisting xml:id="footnote.mark.properties.frag">
6946 &lt;xsl:attribute-set name="footnote.mark.properties"&gt;
6947   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
6948   &lt;xsl:attribute name="font-size"&gt;75%&lt;/xsl:attribute&gt;
6949   &lt;xsl:attribute name="font-weight"&gt;normal&lt;/xsl:attribute&gt;
6950   &lt;xsl:attribute name="font-style"&gt;normal&lt;/xsl:attribute&gt;
6951 &lt;/xsl:attribute-set&gt;
6952 </programlisting>
6953 </refsynopsisdiv>
6954
6955 <refsection><info><title>Description</title></info>
6956
6957 <para>This attribute set is applied to the footnote mark used
6958 for each footnote.
6959 It should contain only inline properties.
6960 </para>
6961
6962 <para>The property to make the mark a superscript is contained in the
6963 footnote template itself, because the current version of FOP reports
6964 an error if baseline-shift is used.
6965 </para>
6966
6967 </refsection>
6968 </refentry>
6969
6970 <refentry version="5.0" xml:id="footnote.sep.leader.properties">
6971 <refmeta>
6972 <refentrytitle>footnote.sep.leader.properties</refentrytitle>
6973 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
6974 </refmeta>
6975 <refnamediv>
6976 <refname>footnote.sep.leader.properties</refname>
6977 <refpurpose>Properties associated with footnote separators</refpurpose>
6978 </refnamediv>
6979
6980 <refsynopsisdiv>
6981 <programlisting xml:id="footnote.sep.leader.properties.frag">
6982 &lt;xsl:attribute-set name="footnote.sep.leader.properties"&gt;
6983   &lt;xsl:attribute name="color"&gt;black&lt;/xsl:attribute&gt;
6984   &lt;xsl:attribute name="leader-pattern"&gt;rule&lt;/xsl:attribute&gt;
6985   &lt;xsl:attribute name="leader-length"&gt;1in&lt;/xsl:attribute&gt;
6986 &lt;/xsl:attribute-set&gt;
6987 </programlisting>
6988 </refsynopsisdiv>
6989
6990 <refsection><info><title>Description</title></info>
6991
6992 <para>The styling for the rule line that separates the
6993 footnotes from the body text.
6994 These are properties applied to the fo:leader used as
6995 the separator.
6996 </para>
6997 <para>If you want to do more than just set properties on
6998 the leader element, then you can customize the template
6999 named <literal>footnote.separator</literal> in
7000 <filename>fo/pagesetup.xsl</filename>.</para>
7001
7002 </refsection>
7003 </refentry>
7004
7005 <refentry version="5.0" xml:id="xref.with.number.and.title">
7006 <refmeta>
7007 <refentrytitle>xref.with.number.and.title</refentrytitle>
7008 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7009 </refmeta>
7010 <refnamediv>
7011 <refname>xref.with.number.and.title</refname>
7012 <refpurpose>Use number and title in cross references</refpurpose>
7013 </refnamediv>
7014
7015 <refsynopsisdiv>
7016 <programlisting xml:id="xref.with.number.and.title.frag">
7017 &lt;xsl:param name="xref.with.number.and.title" select="1"&gt;&lt;/xsl:param&gt;
7018 </programlisting>
7019 </refsynopsisdiv>
7020
7021 <refsection><info><title>Description</title></info>
7022
7023 <para>A cross reference may include the number (for example, the number of
7024 an example or figure) and the <tag>title</tag> which is a required child of some
7025 targets. This parameter inserts both the relevant number as well as
7026 the title into the link. </para>
7027
7028 </refsection>
7029 </refentry>
7030
7031 <refentry version="5.0" xml:id="superscript.properties">
7032 <refmeta>
7033 <refentrytitle>superscript.properties</refentrytitle>
7034 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
7035 </refmeta>
7036 <refnamediv>
7037 <refname>superscript.properties</refname>
7038 <refpurpose>Properties associated with superscripts</refpurpose>
7039 </refnamediv>
7040
7041 <refsynopsisdiv>
7042 <programlisting xml:id="superscript.properties.frag">
7043 &lt;xsl:attribute-set name="superscript.properties"&gt;
7044   &lt;xsl:attribute name="font-size"&gt;75%&lt;/xsl:attribute&gt;
7045 &lt;/xsl:attribute-set&gt;
7046 </programlisting>
7047 </refsynopsisdiv>
7048
7049 <refsection><info><title>Description</title></info>
7050
7051 <para>Specifies styling properties for superscripts.</para>
7052
7053 </refsection>
7054 </refentry>
7055
7056 <refentry version="5.0" xml:id="subscript.properties">
7057 <refmeta>
7058 <refentrytitle>subscript.properties</refentrytitle>
7059 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
7060 </refmeta>
7061 <refnamediv>
7062 <refname>subscript.properties</refname>
7063 <refpurpose>Properties associated with subscripts</refpurpose>
7064 </refnamediv>
7065
7066 <refsynopsisdiv>
7067 <programlisting xml:id="subscript.properties.frag">
7068 &lt;xsl:attribute-set name="subscript.properties"&gt;
7069   &lt;xsl:attribute name="font-size"&gt;75%&lt;/xsl:attribute&gt;
7070 &lt;/xsl:attribute-set&gt;
7071 </programlisting>
7072 </refsynopsisdiv>
7073
7074 <refsection><info><title>Description</title></info>
7075
7076 <para>Specifies styling properties for subscripts.</para>
7077
7078 </refsection>
7079 </refentry>
7080
7081 <refentry version="5.0" xml:id="pgwide.properties">
7082 <refmeta>
7083 <refentrytitle>pgwide.properties</refentrytitle>
7084 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
7085 </refmeta>
7086 <refnamediv>
7087 <refname>pgwide.properties</refname>
7088 <refpurpose>Properties to make a figure or table page wide.
7089 </refpurpose>
7090 </refnamediv>
7091
7092 <refsynopsisdiv>
7093 <programlisting xml:id="pgwide.properties.frag">
7094 &lt;xsl:attribute-set name="pgwide.properties"&gt;
7095   &lt;xsl:attribute name="start-indent"&gt;0pt&lt;/xsl:attribute&gt;
7096 &lt;/xsl:attribute-set&gt;
7097 </programlisting>
7098 </refsynopsisdiv>
7099
7100 <refsection><info><title>Description</title></info>
7101
7102 <para>This attribute set is used to set the properties
7103 that make a figure or table "page wide" in fo output.
7104 It comes into effect when an attribute <literal>pgwide="1"</literal>
7105 is used.
7106 </para>
7107
7108 <para>
7109 By default, it sets <parameter>start-indent</parameter>
7110 to <literal>0pt</literal>.
7111 In a stylesheet that sets the parameter
7112 <parameter>body.start.indent</parameter>
7113 to a non-zero value in order to indent body text,
7114 this attribute set can be used to outdent pgwide
7115 figures to the start margin.
7116 </para>
7117
7118 <para>If a document uses a multi-column page layout,
7119 then this attribute set could try setting <parameter>span</parameter>
7120 to a value of <literal>all</literal>.  However, this may
7121 not work with some processors because a span property must be on an
7122 fo:block that is a direct child of fo:flow.  It may work in
7123 some processors anyway.
7124 </para>
7125
7126 </refsection>
7127 </refentry>
7128
7129 <refentry version="5.0" xml:id="highlight.source">
7130 <refmeta>
7131 <refentrytitle>highlight.source</refentrytitle>
7132 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7133 </refmeta>
7134 <refnamediv>
7135 <refname>highlight.source</refname>
7136 <refpurpose>Should the content of <tag>programlisting</tag>
7137 be syntactically highlighted?</refpurpose>
7138 </refnamediv>
7139
7140 <refsynopsisdiv>
7141 <programlisting xml:id="highlight.source.frag">
7142 &lt;xsl:param name="highlight.source" select="0"&gt;&lt;/xsl:param&gt;
7143 </programlisting>
7144 </refsynopsisdiv>
7145
7146 <refsection><info><title>Description</title></info>
7147
7148 <para>When this parameter is non-zero, the stylesheets will try to do syntax highlighting of the
7149 content of <tag>programlisting</tag> elements. You specify the language for each programlisting
7150 by using the <tag class="attribute">language</tag> attribute. The <parameter>highlight.default.language</parameter>
7151 parameter can be used to specify the language for programlistings without a <tag class="attribute">language</tag>
7152 attribute. Syntax highlighting also works for <tag>screen</tag> and <tag>synopsis</tag> elements.</para>
7153
7154 <para>The actual highlighting work is done by the XSLTHL extension module. This is an external Java library that has to be
7155 downloaded separately (see below).</para>
7156
7157 <itemizedlist>
7158 <para>In order to use this extension, you must</para>
7159
7160 <listitem><para>add <filename>xslthl-2.x.x.jar</filename> to your Java classpath. The latest version is available
7161 from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://sourceforge.net/projects/xslthl">the XSLT syntax highlighting project</link>
7162 at SourceForge.</para>
7163 </listitem>
7164 <listitem>
7165 <para>use a customization layer in which you import one of the following stylesheet modules:
7166 <itemizedlist>
7167   <listitem>
7168     <para><filename>html/highlight.xsl</filename>
7169     </para>
7170   </listitem>
7171 <listitem>
7172     <para><filename>xhtml/highlight.xsl</filename>
7173     </para>
7174   </listitem>
7175 <listitem>
7176     <para><filename>xhtml-1_1/highlight.xsl</filename>
7177     </para>
7178   </listitem>
7179 <listitem>
7180     <para><filename>fo/highlight.xsl</filename>
7181     </para>
7182 </listitem>
7183 </itemizedlist>
7184 </para>
7185 </listitem>
7186 <listitem><para>let either the <literal>xslthl.config</literal> Java system property or the
7187 <parameter>highlight.xslthl.config</parameter> parameter point to the configuration file for syntax
7188 highlighting (using URL syntax). DocBook XSL comes with a ready-to-use configuration file,
7189 <filename>highlighting/xslthl-config.xml</filename>.</para>
7190 </listitem>
7191 </itemizedlist>
7192
7193 <para>The extension works with Saxon 6.5.x and Xalan-J. (Saxon 8.5 or later is also supported, but since it is
7194 an XSLT 2.0 processor it is not guaranteed to work with DocBook XSL in all circumstances.)</para>
7195
7196 <para>The following is an example of a Saxon 6 command adapted for syntax highlighting, to be used on Windows:</para>
7197
7198 <informalexample>
7199 <para><command>java -cp c:/Java/saxon.jar;c:/Java/xslthl-2.0.1.jar
7200 -Dxslthl.config=file:///c:/docbook-xsl/highlighting/xslthl-config.xml com.icl.saxon.StyleSheet
7201 -o test.html test.xml myhtml.xsl</command></para>
7202 </informalexample>
7203
7204 </refsection>
7205 </refentry>
7206
7207 <refentry version="5.0" xml:id="highlight.xslthl.config">
7208 <refmeta>
7209 <refentrytitle>highlight.xslthl.config</refentrytitle>
7210 <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo>
7211 </refmeta>
7212 <refnamediv>
7213 <refname>highlight.xslthl.config</refname>
7214 <refpurpose>Location of XSLTHL configuration file</refpurpose>
7215 </refnamediv>
7216
7217 <refsynopsisdiv>
7218 <programlisting xml:id="highlight.xslthl.config.frag">
7219 &lt;xsl:param name="highlight.xslthl.config"&gt;&lt;/xsl:param&gt;
7220 </programlisting>
7221 </refsynopsisdiv>
7222
7223 <refsection><info><title>Description</title></info>
7224
7225 <para>This location has precedence over the corresponding Java property.</para>
7226
7227 <para>Please note that usually you have to specify location as URL not
7228 just as a simple path on the local
7229 filesystem. E.g. <filename>file:///home/user/xslthl/my-xslthl-config.xml</filename>.</para>
7230
7231
7232
7233 </refsection>
7234 </refentry>
7235
7236 <refentry version="5.0" xml:id="highlight.default.language">
7237 <refmeta>
7238 <refentrytitle>highlight.default.language</refentrytitle>
7239 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
7240 </refmeta>
7241 <refnamediv>
7242 <refname>highlight.default.language</refname>
7243 <refpurpose>Default language of programlisting</refpurpose>
7244 </refnamediv>
7245
7246 <refsynopsisdiv>
7247 <programlisting xml:id="highlight.default.language.frag">
7248 &lt;xsl:param name="highlight.default.language"&gt;&lt;/xsl:param&gt;
7249 </programlisting>
7250 </refsynopsisdiv>
7251
7252 <refsection><info><title>Description</title></info>
7253
7254 <para>This language is used when there is no language attribute on programlisting.</para>
7255
7256 </refsection>
7257 </refentry>
7258
7259 <refentry version="5.0" xml:id="email.delimiters.enabled">
7260 <refmeta>
7261 <refentrytitle>email.delimiters.enabled</refentrytitle>
7262 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7263 </refmeta>
7264 <refnamediv>
7265 <refname>email.delimiters.enabled</refname>
7266 <refpurpose>Generate delimiters around email addresses?</refpurpose>
7267 </refnamediv>
7268
7269 <refsynopsisdiv>
7270 <programlisting xml:id="email.delimiters.enabled.frag">
7271 &lt;xsl:param name="email.delimiters.enabled" select="1"&gt;&lt;/xsl:param&gt;
7272 </programlisting>
7273 </refsynopsisdiv>
7274
7275 <refsection><info><title>Description</title></info>
7276
7277 <para>If non-zero, delimiters
7278
7279 <footnote><para>For delimiters, the
7280 stylesheets are currently hard-coded to output angle
7281 brackets.</para></footnote>
7282
7283 are generated around e-mail addresses
7284 (the output of the <tag>email</tag> element).</para>
7285
7286 </refsection>
7287 </refentry>
7288
7289 <refentry version="5.0" xml:id="email.mailto.enabled">
7290 <refmeta>
7291 <refentrytitle>email.mailto.enabled</refentrytitle>
7292 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7293 </refmeta>
7294 <refnamediv>
7295 <refname>email.mailto.enabled</refname>
7296 <refpurpose>Generate mailto: links for email addresses?</refpurpose>
7297 </refnamediv>
7298
7299 <refsynopsisdiv>
7300 <programlisting xml:id="email.mailto.enabled.frag">
7301 &lt;xsl:param name="email.mailto.enabled" select="0"&gt;&lt;/xsl:param&gt;
7302 </programlisting>
7303 </refsynopsisdiv>
7304
7305 <refsection><info><title>Description</title></info>
7306
7307 <para>If non-zero the generated output for the <tag>email</tag> element
7308 will be a clickable mailto: link that brings up the default mail client
7309 on the system.</para>
7310
7311 </refsection>
7312 </refentry>
7313
7314 <refentry version="5.0" xml:id="section.container.element">
7315 <refmeta>
7316 <refentrytitle>section.container.element</refentrytitle>
7317 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
7318 <refmiscinfo class="other" otherclass="value">block</refmiscinfo>
7319 <refmiscinfo class="other" otherclass="value">wrapper</refmiscinfo>
7320 </refmeta>
7321 <refnamediv>
7322 <refname>section.container.element</refname>
7323 <refpurpose>Select XSL-FO element name to contain sections</refpurpose>
7324 </refnamediv>
7325
7326 <refsynopsisdiv>
7327 <programlisting xml:id="section.container.element.frag">
7328 &lt;xsl:param name="section.container.element"&gt;block&lt;/xsl:param&gt;
7329 </programlisting>
7330 </refsynopsisdiv>
7331
7332 <refsection><info><title>Description</title></info>
7333
7334 <para>Selects the element name for outer container of
7335 each section. The choices are <literal>block</literal> (default)
7336 or <literal>wrapper</literal>.
7337 The <literal>fo:</literal> namespace prefix is added
7338 by the stylesheet to form the full element name.
7339 </para>
7340
7341 <para>This element receives the section <literal>id</literal>
7342 attribute and the appropriate section level attribute-set.
7343 </para>
7344
7345 <para>Changing this parameter to <literal>wrapper</literal>
7346 is only necessary when producing multi-column output
7347 that contains page-wide spans.  Using <literal>fo:wrapper</literal>
7348 avoids the nesting of <literal>fo:block</literal>
7349 elements that prevents spans from working (the standard says
7350 a span must be on a block that is a direct child of
7351 <literal>fo:flow</literal>).
7352 </para>
7353
7354 <para>If set to <literal>wrapper</literal>, the
7355 section attribute-sets only support properties
7356 that are inheritable.  That's because there is no
7357 block to apply them to.  Properties such as
7358 font-family are inheritable, but properties such as
7359 border are not.
7360 </para>
7361
7362 <para>Only some XSL-FO processors need to use this parameter.
7363 The Antenna House processor, for example, will handle
7364 spans in nested blocks without changing the element name.
7365 The RenderX XEP product and FOP follow the XSL-FO standard
7366 and need to use <literal>wrapper</literal>.
7367 </para>
7368
7369 </refsection>
7370 </refentry>
7371
7372 <refentry version="5.0" xml:id="monospace.verbatim.font.width">
7373 <refmeta>
7374 <refentrytitle>monospace.verbatim.font.width</refentrytitle>
7375 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7376 </refmeta>
7377 <refnamediv>
7378 <refname>monospace.verbatim.font.width</refname>
7379 <refpurpose>Width of a single monospace font character</refpurpose>
7380 </refnamediv>
7381
7382 <refsynopsisdiv>
7383 <programlisting xml:id="monospace.verbatim.font.width.frag">
7384 &lt;xsl:param name="monospace.verbatim.font.width"&gt;0.60em&lt;/xsl:param&gt;
7385 </programlisting>
7386 </refsynopsisdiv>
7387
7388 <refsection><info><title>Description</title></info>
7389
7390 <para>Specifies with em units the width of a single character
7391 of the monospace font. The default value is <literal>0.6em</literal>.</para>
7392
7393 <para>This parameter is only used when a <tag>screen</tag>
7394 or <tag>programlisting</tag> element has a
7395 <tag class="attribute">width</tag> attribute, which is
7396 expressed as a plain integer to indicate the maximum character count
7397 of each line.
7398 To convert this character count to an actual maximum width
7399 measurement, the width of the font characters must be provided.
7400 Different monospace fonts have different character width,
7401 so this parameter should be adjusted to fit the
7402 monospace font being used.
7403 </para>
7404
7405 </refsection>
7406 </refentry>
7407
7408 <refentry version="5.0" xml:id="exsl.node.set.available">
7409 <refmeta>
7410 <refentrytitle>exsl.node.set.available</refentrytitle>
7411 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7412 </refmeta>
7413 <refnamediv>
7414 <refname>exsl.node.set.available</refname>
7415 <refpurpose>Is the test function-available('exsl:node-set') true?</refpurpose>
7416 </refnamediv>
7417
7418 <refsynopsisdiv>
7419 <programlisting xml:id="exsl.node.set.available.frag">&lt;xsl:param name="exsl.node.set.available"&gt;
7420   &lt;xsl:choose&gt;
7421     &lt;xsl:when exsl:foo="" test="function-available('exsl:node-set') or                        contains(system-property('xsl:vendor'),                          'Apache Software Foundation')"&gt;1&lt;/xsl:when&gt;
7422     &lt;xsl:otherwise&gt;0&lt;/xsl:otherwise&gt;
7423   &lt;/xsl:choose&gt;
7424 &lt;/xsl:param&gt;
7425 </programlisting>
7426 </refsynopsisdiv>
7427
7428 <refsection><info><title>Description</title></info>
7429
7430 <para>If non-zero,
7431 then the exsl:node-set() function is available to be used in
7432 the stylesheet.
7433 If zero, then the function is not available.
7434 This param automatically detects the presence of
7435 the function and does not normally need to be set manually.</para>
7436
7437 <para>This param was created to handle a long-standing
7438 bug in the Xalan processor that fails to detect the
7439 function even though it is available.</para>
7440
7441 </refsection>
7442 </refentry>
7443
7444 <refentry version="5.0" xml:id="show.bookmarks">
7445 <refmeta>
7446 <refentrytitle>show.bookmarks</refentrytitle>
7447 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7448 </refmeta>
7449 <refnamediv>
7450 <refname>show.bookmarks</refname>
7451 <refpurpose>Display bookmarks in PDF output</refpurpose>
7452 </refnamediv>
7453
7454 <refsynopsisdiv>
7455 <programlisting xml:id="show.bookmarks.frag">
7456 &lt;xsl:param name="show.bookmarks" select="1"&gt;&lt;/xsl:param&gt;
7457 </programlisting>
7458 </refsynopsisdiv>
7459
7460 <refsection><info><title>Description</title></info>
7461
7462 <para>If non-zero (default), then bookmarks are generated in PDF
7463 output.  If set to zero, bookmarks are turned off.
7464 </para>
7465 <para>See also <parameter>xsl1.1.bookmarks</parameter>.</para>
7466
7467 </refsection>
7468 </refentry>
7469
7470 <refentry version="5.0" xml:id="bookmarks.collapse">
7471 <refmeta>
7472 <refentrytitle>bookmarks.collapse</refentrytitle>
7473 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7474 </refmeta>
7475 <refnamediv>
7476 <refname>bookmarks.collapse</refname>
7477 <refpurpose>Specifies the initial state of bookmarks</refpurpose>
7478 </refnamediv>
7479
7480 <refsynopsisdiv>
7481 <programlisting xml:id="bookmarks.collapse.frag">
7482 &lt;xsl:param name="bookmarks.collapse" select="1"&gt;&lt;/xsl:param&gt;
7483 </programlisting>
7484 </refsynopsisdiv>
7485
7486 <refsection><info><title>Description</title></info>
7487
7488 <para>If non-zero, the bookmark tree is collapsed so that only the
7489 top-level bookmarks are displayed initially. Otherwise, the whole tree
7490 of bookmarks is displayed.</para>
7491
7492 <para>This parameter currently works with FOP 0.93 or later.</para>
7493
7494 </refsection>
7495 </refentry>
7496
7497 <refentry version="5.0" xml:id="xsl1.1.bookmarks">
7498 <refmeta>
7499 <refentrytitle>xsl1.1.bookmarks</refentrytitle>
7500 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7501 </refmeta>
7502 <refnamediv>
7503 <refname>xsl1.1.bookmarks</refname>
7504 <refpurpose>Use standard XSL 1.1 bookmark elements</refpurpose>
7505 </refnamediv>
7506
7507 <refsynopsisdiv>
7508 <programlisting xml:id="xsl1.1.bookmarks.frag">&lt;xsl:param name="xsl1.1.bookmarks"&gt;
7509   &lt;xsl:choose&gt;
7510     &lt;xsl:when test="$fop1.extensions != 0"&gt;1&lt;/xsl:when&gt;
7511     &lt;xsl:when test="$xep.extensions != 0"&gt;1&lt;/xsl:when&gt;
7512     &lt;xsl:when test="$axf.extensions != 0"&gt;1&lt;/xsl:when&gt;
7513     &lt;xsl:otherwise&gt;0&lt;/xsl:otherwise&gt;
7514   &lt;/xsl:choose&gt;&lt;/xsl:param&gt;</programlisting>
7515 </refsynopsisdiv>
7516
7517 <refsection><info><title>Description</title></info>
7518
7519 <para>If non-zero (default),
7520 the stylesheet uses the
7521 <tag>fo:bookmark-tree</tag>
7522 and
7523 <tag>fo:bookmark</tag> elements that are
7524 standard in XSL 1.1, instead of each XSL-FO processor's proprietary
7525 bookmark elements.
7526 If zero, then the stylesheet uses the proprietary bookmark elements that
7527 predate XSL 1.1.
7528 </para>
7529
7530 </refsection>
7531 </refentry>
7532
7533 <refentry version="5.0" xml:id="generate.consistent.ids">
7534 <refmeta>
7535 <refentrytitle>generate.consistent.ids</refentrytitle>
7536 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7537 </refmeta>
7538 <refnamediv>
7539 <refname>generate.consistent.ids</refname>
7540 <refpurpose>Generate consistent id values if document is unchanged</refpurpose>
7541 </refnamediv>
7542
7543 <refsynopsisdiv>
7544 <programlisting xml:id="generate.consistent.ids.frag">
7545 &lt;xsl:param name="generate.consistent.ids" select="0"&gt;&lt;/xsl:param&gt;
7546 </programlisting>
7547 </refsynopsisdiv>
7548
7549 <refsection><info><title>Description</title></info>
7550
7551 <para>When the stylesheet assigns an id value to an output element,
7552 the generate-id() function may be used.  That function may not
7553 produce consistent values between runs.  Version control
7554 systems may misidentify the changing id values as changes
7555 to the document.</para>
7556
7557 <para>If you set this parameter's value to 1, then the
7558 template named <literal>object.id</literal> will replace
7559 the use of the function generate-id() with
7560 <literal>&lt;xsl:number level="multiple" count="*"/&gt;</literal>.
7561 This counts preceding elements to generate a unique number for
7562 the id value.</para>
7563
7564 <caution>
7565 <para>This param does not associate permanent unique id values
7566 with particular elements.
7567 The id values are consistent only as long as the document
7568 structure does not change.
7569 If the document structure changes, then the counting
7570 of elements changes, and all id values after
7571 the first such change may be different, even when there is
7572 no change to the element itself or its output.
7573 </para>
7574 </caution>
7575
7576 <para>The default value of this parameter is zero, so generate-id() is used
7577 by default.</para>
7578
7579 </refsection>
7580 </refentry>
7581
7582 <refentry version="5.0" xml:id="base.dir">
7583 <refmeta>
7584 <refentrytitle>base.dir</refentrytitle>
7585 <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo>
7586 </refmeta>
7587 <refnamediv>
7588 <refname>base.dir</refname>
7589 <refpurpose>The base directory of chunks</refpurpose>
7590 </refnamediv>
7591
7592 <refsynopsisdiv>
7593 <programlisting xml:id="base.dir.frag">
7594 &lt;xsl:param name="base.dir"&gt;&lt;/xsl:param&gt;
7595 </programlisting>
7596 </refsynopsisdiv>
7597
7598 <refsection><info><title>Description</title></info>
7599
7600 <para>If specified, the <parameter>base.dir</parameter> parameter identifies
7601 the output directory for chunks. (If not specified, the output directory
7602 is system dependent.)</para>
7603
7604 <para>Starting with version 1.77 of the stylesheets,
7605 the param's value will have a trailing slash added if it does
7606 not already have one.</para>
7607
7608 <caution><para>Do not use <parameter>base.dir</parameter>
7609 to add a filename prefix string to chunked  files.
7610 Instead, use the <parameter>chunked.filename.prefix</parameter>
7611 parameter.</para></caution>
7612
7613 </refsection>
7614 </refentry>
7615
7616 <refentry version="5.0" xml:id="chunk.quietly">
7617 <refmeta>
7618 <refentrytitle>chunk.quietly</refentrytitle>
7619 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7620 </refmeta>
7621 <refnamediv>
7622 <refname>chunk.quietly</refname>
7623 <refpurpose>Omit the chunked filename messages.</refpurpose>
7624 </refnamediv>
7625
7626 <refsynopsisdiv>
7627 <programlisting xml:id="chunk.quietly.frag">
7628 &lt;xsl:param name="chunk.quietly" select="0"&gt;&lt;/xsl:param&gt;
7629 </programlisting>
7630 </refsynopsisdiv>
7631
7632 <refsection><info><title>Description</title></info>
7633
7634 <para>If zero (the default), the XSL processor emits a message naming
7635 each separate chunk filename as it is being output.
7636 If nonzero, then the messages are suppressed.
7637 </para>
7638
7639 </refsection>
7640 </refentry>
7641
7642 </reference>
7643 <reference xml:id="graphics"><title>Graphics</title>
7644 <refentry version="5.0" xml:id="graphic.default.extension">
7645 <refmeta>
7646 <refentrytitle>graphic.default.extension</refentrytitle>
7647 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
7648 </refmeta>
7649 <refnamediv>
7650 <refname>graphic.default.extension</refname>
7651 <refpurpose>Default extension for graphic filenames</refpurpose>
7652 </refnamediv>
7653
7654 <refsynopsisdiv>
7655 <programlisting xml:id="graphic.default.extension.frag">&lt;xsl:param name="graphic.default.extension"&gt;&lt;/xsl:param&gt;</programlisting>
7656 </refsynopsisdiv>
7657
7658 <refsection><info><title>Description</title></info>
7659
7660 <para>If a <tag>graphic</tag> or <tag>mediaobject</tag>
7661 includes a reference to a filename that does not include an extension,
7662 and the <tag class="attribute">format</tag> attribute is
7663 <emphasis>unspecified</emphasis>, the default extension will be used.
7664 </para>
7665
7666 </refsection>
7667 </refentry>
7668
7669 <refentry version="5.0" xml:id="default.image.width">
7670 <refmeta>
7671 <refentrytitle>default.image.width</refentrytitle>
7672 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7673 </refmeta>
7674 <refnamediv>
7675 <refname>default.image.width</refname>
7676 <refpurpose>The default width of images</refpurpose>
7677 </refnamediv>
7678
7679 <refsynopsisdiv>
7680 <programlisting xml:id="default.image.width.frag">
7681 &lt;xsl:param name="default.image.width"&gt;&lt;/xsl:param&gt;
7682 </programlisting>
7683 </refsynopsisdiv>
7684
7685 <refsection><info><title>Description</title></info>
7686
7687 <para>If specified, this value will be used for the
7688 <tag class="attribute">width</tag> attribute on images that do not specify any
7689 <emphasis xmlns:xlink="http://www.w3.org/1999/xlink" xlink:title="DocBook 5: The Definitive Guide" xlink:href="http://docbook.org/tdg5/en/html/imagedata.html#viewport.area">viewport dimensions</emphasis>.</para>
7690
7691 </refsection>
7692 </refentry>
7693
7694 <refentry version="5.0" xml:id="preferred.mediaobject.role">
7695 <refmeta>
7696 <refentrytitle>preferred.mediaobject.role</refentrytitle>
7697 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
7698 </refmeta>
7699 <refnamediv>
7700 <refname>preferred.mediaobject.role</refname>
7701 <refpurpose>Select which mediaobject to use based on
7702 this value of an object's <tag class="attribute">role</tag> attribute.
7703 </refpurpose>
7704 </refnamediv>
7705
7706 <refsynopsisdiv>
7707 <programlisting xml:id="preferred.mediaobject.role.frag">
7708 &lt;xsl:param name="preferred.mediaobject.role"&gt;&lt;/xsl:param&gt;
7709 </programlisting>
7710 </refsynopsisdiv>
7711
7712 <refsection><info><title>Description</title></info>
7713
7714 <para>A mediaobject may contain several objects such as imageobjects.
7715 If the parameter <parameter>use.role.for.mediaobject</parameter> is
7716 non-zero, then the <literal>role</literal> attribute on
7717 <tag>imageobject</tag>s and other objects within a
7718 <tag>mediaobject</tag> container will be used to select which object
7719 will be used.  If one of the objects has a role value that matches the
7720 <parameter>preferred.mediaobject.role</parameter> parameter, then it
7721 has first priority for selection.  If more than one has such a role
7722 value, the first one is used.
7723 </para>
7724 <para>
7725 See the <parameter>use.role.for.mediaobject</parameter> parameter
7726 for the sequence of selection.</para>
7727 </refsection>
7728 </refentry>
7729
7730 <refentry version="5.0" xml:id="use.role.for.mediaobject">
7731 <refmeta>
7732 <refentrytitle>use.role.for.mediaobject</refentrytitle>
7733 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7734 </refmeta>
7735 <refnamediv>
7736 <refname>use.role.for.mediaobject</refname>
7737 <refpurpose>Use <tag class="attribute">role</tag> attribute
7738 value for selecting which of several objects within a mediaobject to use.
7739 </refpurpose>
7740 </refnamediv>
7741
7742 <refsynopsisdiv>
7743 <programlisting xml:id="use.role.for.mediaobject.frag">
7744 &lt;xsl:param name="use.role.for.mediaobject" select="1"&gt;&lt;/xsl:param&gt;
7745 </programlisting>
7746 </refsynopsisdiv>
7747
7748 <refsection><info><title>Description</title></info>
7749
7750 <para>If non-zero, the <tag class="attribute">role</tag> attribute on
7751 <tag>imageobject</tag>s or other objects within a <tag>mediaobject</tag> container will be used to select which object will be
7752 used.
7753 </para>
7754 <para>
7755 The order of selection when then parameter is non-zero is:
7756 </para>
7757 <orderedlist>
7758 <listitem>
7759     <para>If the stylesheet parameter <parameter>preferred.mediaobject.role</parameter> has a value, then the object whose role equals that value is selected.</para>
7760 </listitem>
7761 <listitem>
7762 <para>Else if an object's role attribute has a value of
7763 <literal>html</literal> for HTML processing or
7764 <literal>fo</literal> for FO output, then the first
7765 of such objects is selected.
7766 </para>
7767 </listitem>
7768 <listitem>
7769 <para>Else the first suitable object is selected.</para>
7770 </listitem>
7771 </orderedlist>
7772 <para>
7773 If the value of
7774 <parameter>use.role.for.mediaobject</parameter>
7775 is zero, then role attributes are not considered
7776 and the first suitable object
7777 with or without a role value is used.
7778 </para>
7779 </refsection>
7780 </refentry>
7781
7782 <refentry version="5.0" xml:id="ignore.image.scaling">
7783 <refmeta>
7784 <refentrytitle>ignore.image.scaling</refentrytitle>
7785 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7786 </refmeta>
7787 <refnamediv>
7788 <refname>ignore.image.scaling</refname>
7789 <refpurpose>Tell the stylesheets to ignore the author's image scaling attributes</refpurpose>
7790 </refnamediv>
7791
7792 <refsynopsisdiv>
7793 <programlisting xml:id="ignore.image.scaling.frag">
7794 &lt;xsl:param name="ignore.image.scaling" select="0"&gt;&lt;/xsl:param&gt;
7795 </programlisting>
7796 </refsynopsisdiv>
7797
7798 <refsection><info><title>Description</title></info>
7799
7800 <para>If non-zero, the scaling attributes on graphics and media objects are
7801 ignored.</para>
7802
7803 </refsection>
7804 </refentry>
7805
7806 <refentry version="5.0" xml:id="img.src.path">
7807 <refmeta>
7808 <refentrytitle>img.src.path</refentrytitle>
7809 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
7810 </refmeta>
7811 <refnamediv>
7812 <refname>img.src.path</refname>
7813 <refpurpose>Path to HTML/FO image files</refpurpose>
7814 </refnamediv>
7815
7816 <refsynopsisdiv>
7817 <programlisting xml:id="img.src.path.frag">&lt;xsl:param name="img.src.path"&gt;&lt;/xsl:param&gt;</programlisting>
7818 </refsynopsisdiv>
7819
7820 <refsection><info><title>Description</title></info>
7821
7822 <para>Add a path prefix to the value of the <tag class="attribute">fileref</tag>
7823 attribute of <tag>graphic</tag>, <tag>inlinegraphic</tag>, and <tag>imagedata</tag> elements. The resulting
7824 compound path is used in the output as the value of the <tag class="attribute">src</tag>
7825 attribute of <tag class="element">img</tag> (HTML) or <tag class="element">external-graphic</tag> (FO).
7826 </para>
7827
7828 <para>
7829 The path given by <literal>img.src.path</literal> could be relative to the directory where the HTML/FO
7830 files are created, or it could be an absolute URI.
7831 The default value is empty.
7832 Be sure to include a trailing slash if needed.
7833 </para>
7834
7835 <para>This prefix is not applied to any filerefs that start
7836 with "/" or contain "//:".
7837 </para>
7838
7839 </refsection>
7840 </refentry>
7841
7842 <refentry version="5.0" xml:id="keep.relative.image.uris">
7843 <refmeta>
7844 <refentrytitle>keep.relative.image.uris</refentrytitle>
7845 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7846 </refmeta>
7847 <refnamediv>
7848 <refname>keep.relative.image.uris</refname>
7849 <refpurpose>Should image URIs be resolved against xml:base?</refpurpose>
7850 </refnamediv>
7851
7852 <refsynopsisdiv>
7853 <programlisting xml:id="keep.relative.image.uris.frag">
7854
7855 &lt;xsl:param name="keep.relative.image.uris" select="0"&gt;&lt;/xsl:param&gt;
7856 </programlisting>
7857 </refsynopsisdiv>
7858
7859 <refsection><info><title>Description</title></info>
7860
7861 <para>If non-zero, relative URIs (in, for example
7862 <literal>fileref</literal> attributes) will be used in the generated
7863 output. Otherwise, the URIs will be made absolute with respect to the
7864 base URI.</para>
7865
7866 <para>Note that the stylesheets calculate (and use) the absolute form
7867 for some purposes, this only applies to the resulting output.</para>
7868
7869 </refsection>
7870 </refentry>
7871
7872 </reference>
7873 <reference xml:id="general"><title>Pagination and General Styles</title>
7874 <partintro xml:id="margins_partintro">
7875 <section xml:id="margins_intro"><title>Understanding XSL FO Margins</title>
7876
7877 <para>To make sense of the parameters in this section, it's useful to
7878 consider <xref linkend="fig.pagemodel"/>.</para>
7879
7880 <figure xml:id="fig.pagemodel">
7881   <title>Page Model</title>
7882   <mediaobject xml:id="fo-pageregions-image">
7883     <imageobject role="html">
7884       <imagedata fileref="page.png"/>
7885     </imageobject>
7886     <imageobject role="fo">
7887       <imagedata fileref="fo/page.png"/>
7888     </imageobject>
7889     <textobject><phrase>Figure showing page margins</phrase></textobject>
7890     <textobject>
7891       <para>This figure shows the physical page with the various FO page regions
7892       identified.</para>
7893     </textobject>
7894   </mediaobject>
7895 </figure>
7896
7897 <para>First, let's consider the regions on the page.</para>
7898
7899 <para>The white region is the physical page. Its dimensions are determined by
7900 the <parameter>page.height</parameter> and <parameter>page.width</parameter>
7901 parameters.</para>
7902
7903 <para>The yellow region is the region-body. The size and placement of
7904 the region body is constrained by the dimensions labelled in the
7905 figure.</para>
7906
7907 <para>The pink region at the top of the page is the region-before. The
7908 darker area inside the region-before is the header text. In XSL, the default
7909 display alignment for a region is <literal>before</literal>, but the
7910 DocBook stylesheets still explicitly make it <literal>before</literal>. That's
7911 why the darker area is at the top.</para>
7912
7913 <para>The pink region at the bottom of the page is the region-after.
7914 The darker area is the footer text. In XSL, the default display
7915 alignment for a region is <literal>before</literal>,
7916 but the DocBook stylesheets explicitly make it
7917 <literal>after</literal>. That's why the darker area is at the bottom.</para>
7918
7919 <para>The dimensions in the figure are:</para>
7920
7921 <orderedlist numeration="upperalpha">
7922 <listitem><para>The page-master margin-top.
7923 </para></listitem>
7924 <listitem><para>The region-before extent.
7925 </para></listitem>
7926 <listitem><para>The region-body margin-top.
7927 </para></listitem>
7928 <listitem><para>The region-after extent.
7929 </para></listitem>
7930 <listitem><para>The page-master margin-bottom.
7931 </para></listitem>
7932 <listitem><para>The region-body margin-bottom.
7933 </para></listitem>
7934 <listitem><para>The sum of the page-master margin-left and the
7935 region-body margin-left. In DocBook, the region-body margin-left is
7936 zero by default, so this is simply the page-master margin-left.
7937 </para></listitem>
7938 <listitem><para>The sum of the page-master margin-right and the
7939 region-body margin-right. In DocBook, the region-body margin-right is
7940 zero by default, so this is simply the page-master margin-right.
7941 </para></listitem>
7942 </orderedlist>
7943
7944 </section>
7945 </partintro>
7946
7947 <refentry version="5.0" xml:id="page.height">
7948 <refmeta>
7949 <refentrytitle>page.height</refentrytitle>
7950 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7951 </refmeta>
7952 <refnamediv>
7953 <refname>page.height</refname>
7954 <refpurpose>The height of the physical page</refpurpose>
7955 </refnamediv>
7956
7957 <refsynopsisdiv>
7958 <programlisting xml:id="page.height.frag">&lt;xsl:param name="page.height"&gt;
7959   &lt;xsl:choose&gt;
7960     &lt;xsl:when test="$page.orientation = 'portrait'"&gt;
7961       &lt;xsl:value-of select="$page.height.portrait"&gt;&lt;/xsl:value-of&gt;
7962     &lt;/xsl:when&gt;
7963     &lt;xsl:otherwise&gt;
7964       &lt;xsl:value-of select="$page.width.portrait"&gt;&lt;/xsl:value-of&gt;
7965     &lt;/xsl:otherwise&gt;
7966   &lt;/xsl:choose&gt;
7967 &lt;/xsl:param&gt;</programlisting>
7968 </refsynopsisdiv>
7969
7970 <refsection><info><title>Description</title></info>
7971
7972 <para>The page height is generally calculated from the
7973 <parameter>paper.type</parameter> and
7974 <parameter>page.orientation</parameter> parameters.
7975 </para>
7976
7977 </refsection>
7978 </refentry>
7979
7980 <refentry version="5.0" xml:id="page.height.portrait">
7981 <refmeta>
7982 <refentrytitle>page.height.portrait</refentrytitle>
7983 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7984 </refmeta>
7985 <refnamediv>
7986 <refname>page.height.portrait</refname>
7987 <refpurpose>Specify the physical size of the long edge of the page</refpurpose>
7988 </refnamediv>
7989
7990 <refsynopsisdiv>
7991 <programlisting xml:id="page.height.portrait.frag">&lt;xsl:param name="page.height.portrait"&gt;
7992   &lt;xsl:choose&gt;
7993     &lt;xsl:when test="$paper.type = 'A4landscape'"&gt;210mm&lt;/xsl:when&gt;
7994     &lt;xsl:when test="$paper.type = 'USletter'"&gt;11in&lt;/xsl:when&gt;
7995     &lt;xsl:when test="$paper.type = 'USlandscape'"&gt;8.5in&lt;/xsl:when&gt;
7996     &lt;xsl:when test="$paper.type = 'USlegal'"&gt;14in&lt;/xsl:when&gt;
7997     &lt;xsl:when test="$paper.type = 'USlegallandscape'"&gt;8.5in&lt;/xsl:when&gt;
7998     &lt;xsl:when test="$paper.type = '4A0'"&gt;2378mm&lt;/xsl:when&gt;
7999     &lt;xsl:when test="$paper.type = '2A0'"&gt;1682mm&lt;/xsl:when&gt;
8000     &lt;xsl:when test="$paper.type = 'A0'"&gt;1189mm&lt;/xsl:when&gt;
8001     &lt;xsl:when test="$paper.type = 'A1'"&gt;841mm&lt;/xsl:when&gt;
8002     &lt;xsl:when test="$paper.type = 'A2'"&gt;594mm&lt;/xsl:when&gt;
8003     &lt;xsl:when test="$paper.type = 'A3'"&gt;420mm&lt;/xsl:when&gt;
8004     &lt;xsl:when test="$paper.type = 'A4'"&gt;297mm&lt;/xsl:when&gt;
8005     &lt;xsl:when test="$paper.type = 'A5'"&gt;210mm&lt;/xsl:when&gt;
8006     &lt;xsl:when test="$paper.type = 'A6'"&gt;148mm&lt;/xsl:when&gt;
8007     &lt;xsl:when test="$paper.type = 'A7'"&gt;105mm&lt;/xsl:when&gt;
8008     &lt;xsl:when test="$paper.type = 'A8'"&gt;74mm&lt;/xsl:when&gt;
8009     &lt;xsl:when test="$paper.type = 'A9'"&gt;52mm&lt;/xsl:when&gt;
8010     &lt;xsl:when test="$paper.type = 'A10'"&gt;37mm&lt;/xsl:when&gt;
8011     &lt;xsl:when test="$paper.type = 'B0'"&gt;1414mm&lt;/xsl:when&gt;
8012     &lt;xsl:when test="$paper.type = 'B1'"&gt;1000mm&lt;/xsl:when&gt;
8013     &lt;xsl:when test="$paper.type = 'B2'"&gt;707mm&lt;/xsl:when&gt;
8014     &lt;xsl:when test="$paper.type = 'B3'"&gt;500mm&lt;/xsl:when&gt;
8015     &lt;xsl:when test="$paper.type = 'B4'"&gt;353mm&lt;/xsl:when&gt;
8016     &lt;xsl:when test="$paper.type = 'B5'"&gt;250mm&lt;/xsl:when&gt;
8017     &lt;xsl:when test="$paper.type = 'B6'"&gt;176mm&lt;/xsl:when&gt;
8018     &lt;xsl:when test="$paper.type = 'B7'"&gt;125mm&lt;/xsl:when&gt;
8019     &lt;xsl:when test="$paper.type = 'B8'"&gt;88mm&lt;/xsl:when&gt;
8020     &lt;xsl:when test="$paper.type = 'B9'"&gt;62mm&lt;/xsl:when&gt;
8021     &lt;xsl:when test="$paper.type = 'B10'"&gt;44mm&lt;/xsl:when&gt;
8022     &lt;xsl:when test="$paper.type = 'C0'"&gt;1297mm&lt;/xsl:when&gt;
8023     &lt;xsl:when test="$paper.type = 'C1'"&gt;917mm&lt;/xsl:when&gt;
8024     &lt;xsl:when test="$paper.type = 'C2'"&gt;648mm&lt;/xsl:when&gt;
8025     &lt;xsl:when test="$paper.type = 'C3'"&gt;458mm&lt;/xsl:when&gt;
8026     &lt;xsl:when test="$paper.type = 'C4'"&gt;324mm&lt;/xsl:when&gt;
8027     &lt;xsl:when test="$paper.type = 'C5'"&gt;229mm&lt;/xsl:when&gt;
8028     &lt;xsl:when test="$paper.type = 'C6'"&gt;162mm&lt;/xsl:when&gt;
8029     &lt;xsl:when test="$paper.type = 'C7'"&gt;114mm&lt;/xsl:when&gt;
8030     &lt;xsl:when test="$paper.type = 'C8'"&gt;81mm&lt;/xsl:when&gt;
8031     &lt;xsl:when test="$paper.type = 'C9'"&gt;57mm&lt;/xsl:when&gt;
8032     &lt;xsl:when test="$paper.type = 'C10'"&gt;40mm&lt;/xsl:when&gt;
8033     &lt;xsl:otherwise&gt;11in&lt;/xsl:otherwise&gt;
8034   &lt;/xsl:choose&gt;
8035 &lt;/xsl:param&gt;</programlisting>
8036 </refsynopsisdiv>
8037
8038 <refsection><info><title>Description</title></info>
8039
8040 <para>The portrait page height is the length of the long
8041 edge of the physical page.
8042 </para>
8043
8044 </refsection>
8045 </refentry>
8046
8047 <refentry version="5.0" xml:id="page.margin.bottom">
8048 <refmeta>
8049 <refentrytitle>page.margin.bottom</refentrytitle>
8050 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8051 </refmeta>
8052 <refnamediv>
8053 <refname>page.margin.bottom</refname>
8054 <refpurpose>The bottom margin of the page</refpurpose>
8055 </refnamediv>
8056
8057 <refsynopsisdiv>
8058 <programlisting xml:id="page.margin.bottom.frag">
8059 &lt;xsl:param name="page.margin.bottom"&gt;0.5in&lt;/xsl:param&gt;
8060 </programlisting>
8061 </refsynopsisdiv>
8062
8063 <refsection><info><title>Description</title></info>
8064
8065 <para>The bottom page margin is the distance from the bottom of the region-after
8066 to the physical bottom of the page.
8067 </para>
8068
8069 </refsection>
8070 </refentry>
8071
8072 <refentry version="5.0" xml:id="page.margin.inner">
8073 <refmeta>
8074 <refentrytitle>page.margin.inner</refentrytitle>
8075 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8076 </refmeta>
8077 <refnamediv>
8078 <refname>page.margin.inner</refname>
8079 <refpurpose>The inner page margin</refpurpose>
8080 </refnamediv>
8081
8082 <refsynopsisdiv>
8083 <programlisting xml:id="page.margin.inner.frag">&lt;xsl:param name="page.margin.inner"&gt;
8084   &lt;xsl:choose&gt;
8085     &lt;xsl:when test="$double.sided != 0"&gt;1.25in&lt;/xsl:when&gt;
8086     &lt;xsl:otherwise&gt;1in&lt;/xsl:otherwise&gt;
8087   &lt;/xsl:choose&gt;
8088 &lt;/xsl:param&gt;</programlisting>
8089 </refsynopsisdiv>
8090
8091 <refsection><info><title>Description</title></info>
8092
8093 <para>The inner page margin is the distance from bound edge of the
8094 page to the first column of text. </para>
8095
8096 <para>The inner page margin is the distance from bound edge of the
8097 page to the outer edge of the first column of text.</para>
8098
8099 <para>In left-to-right text direction,
8100 this is the left margin of recto (front side) pages.
8101 For single-sided output, it is the left margin
8102 of all pages.</para>
8103
8104 <para>In right-to-left text direction,
8105 this is the right margin of recto pages.
8106 For single-sided output, this is the
8107 right margin of all pages.</para>
8108
8109 <note>
8110 <para>Current versions (at least as of version 4.13)
8111 of the XEP XSL-FO processor do not
8112 correctly handle these margin settings for documents
8113 with right-to-left text direction.
8114 The workaround in that situation is to reverse
8115 the values for <parameter>page.margin.inner</parameter>
8116 and <parameter>page.margin.outer</parameter>, until
8117 this bug is fixed by RenderX.  It does not affect documents
8118 with left-to-right text direction.</para>
8119 </note>
8120
8121 <para>See also <parameter>writing.mode</parameter>.</para>
8122
8123 </refsection>
8124 </refentry>
8125
8126 <refentry version="5.0" xml:id="page.margin.outer">
8127 <refmeta>
8128 <refentrytitle>page.margin.outer</refentrytitle>
8129 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8130 </refmeta>
8131 <refnamediv>
8132 <refname>page.margin.outer</refname>
8133 <refpurpose>The outer page margin</refpurpose>
8134 </refnamediv>
8135
8136 <refsynopsisdiv>
8137 <programlisting xml:id="page.margin.outer.frag">&lt;xsl:param name="page.margin.outer"&gt;
8138   &lt;xsl:choose&gt;
8139     &lt;xsl:when test="$double.sided != 0"&gt;0.75in&lt;/xsl:when&gt;
8140     &lt;xsl:otherwise&gt;1in&lt;/xsl:otherwise&gt;
8141   &lt;/xsl:choose&gt;
8142 &lt;/xsl:param&gt;</programlisting>
8143 </refsynopsisdiv>
8144
8145 <refsection><info><title>Description</title></info>
8146
8147 <para>The outer page margin is the distance from non-bound edge of the
8148 page to the outer edge of the last column of text.</para>
8149
8150 <para>In left-to-right text direction,
8151 this is the right margin of recto (front side) pages.
8152 For single-sided output, it is the right margin
8153 of all pages.</para>
8154
8155 <para>In right-to-left text direction,
8156 this is the left margin of recto pages.
8157 For single-sided output, this is the
8158 left margin of all pages.</para>
8159
8160 <note>
8161 <para>Current versions (at least as of version 4.13)
8162 of the XEP XSL-FO processor do not
8163 correctly handle these margin settings for documents
8164 with right-to-left text direction.
8165 The workaround in that situation is to reverse
8166 the values for <parameter>page.margin.inner</parameter>
8167 and <parameter>page.margin.outer</parameter>, until
8168 this bug is fixed by RenderX.  It does not affect documents
8169 with left-to-right text direction.</para>
8170 </note>
8171
8172 <para>See also <parameter>writing.mode</parameter>.</para>
8173
8174 </refsection>
8175 </refentry>
8176
8177 <refentry version="5.0" xml:id="page.margin.top">
8178 <refmeta>
8179 <refentrytitle>page.margin.top</refentrytitle>
8180 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8181 </refmeta>
8182 <refnamediv>
8183 <refname>page.margin.top</refname>
8184 <refpurpose>The top margin of the page</refpurpose>
8185 </refnamediv>
8186
8187 <refsynopsisdiv>
8188 <programlisting xml:id="page.margin.top.frag">
8189 &lt;xsl:param name="page.margin.top"&gt;0.5in&lt;/xsl:param&gt;
8190 </programlisting>
8191 </refsynopsisdiv>
8192
8193 <refsection><info><title>Description</title></info>
8194
8195 <para>The top page margin is the distance from the physical top of the
8196 page to the top of the region-before.</para>
8197
8198 </refsection>
8199 </refentry>
8200
8201 <refentry version="5.0" xml:id="page.orientation">
8202 <refmeta>
8203 <refentrytitle>page.orientation</refentrytitle>
8204 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
8205 <refmiscinfo class="other" otherclass="value">portrait</refmiscinfo>
8206 <refmiscinfo class="other" otherclass="value">landscape</refmiscinfo>
8207 </refmeta>
8208 <refnamediv>
8209 <refname>page.orientation</refname>
8210 <refpurpose>Select the page orientation</refpurpose>
8211 </refnamediv>
8212
8213 <refsynopsisdiv>
8214 <programlisting xml:id="page.orientation.frag">
8215 &lt;xsl:param name="page.orientation"&gt;portrait&lt;/xsl:param&gt;
8216 </programlisting>
8217 </refsynopsisdiv>
8218
8219 <refsection><info><title>Description</title></info>
8220
8221 <para> Select one from portrait or landscape.
8222 In portrait orientation, the short edge is horizontal; in
8223 landscape orientation, it is vertical.
8224 </para>
8225
8226 </refsection>
8227 </refentry>
8228
8229 <refentry version="5.0" xml:id="page.width">
8230 <refmeta>
8231 <refentrytitle>page.width</refentrytitle>
8232 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8233 </refmeta>
8234 <refnamediv>
8235 <refname>page.width</refname>
8236 <refpurpose>The width of the physical page</refpurpose>
8237 </refnamediv>
8238
8239 <refsynopsisdiv>
8240 <programlisting xml:id="page.width.frag">&lt;xsl:param name="page.width"&gt;
8241   &lt;xsl:choose&gt;
8242     &lt;xsl:when test="$page.orientation = 'portrait'"&gt;
8243       &lt;xsl:value-of select="$page.width.portrait"&gt;&lt;/xsl:value-of&gt;
8244     &lt;/xsl:when&gt;
8245     &lt;xsl:otherwise&gt;
8246       &lt;xsl:value-of select="$page.height.portrait"&gt;&lt;/xsl:value-of&gt;
8247     &lt;/xsl:otherwise&gt;
8248   &lt;/xsl:choose&gt;
8249 &lt;/xsl:param&gt;</programlisting>
8250 </refsynopsisdiv>
8251
8252 <refsection><info><title>Description</title></info>
8253
8254 <para>The page width is generally calculated from the
8255 <parameter>paper.type</parameter> and
8256 <parameter>page.orientation</parameter> parameters.</para>
8257
8258 </refsection>
8259 </refentry>
8260
8261 <refentry version="5.0" xml:id="page.width.portrait">
8262 <refmeta>
8263 <refentrytitle>page.width.portrait</refentrytitle>
8264 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8265 </refmeta>
8266 <refnamediv>
8267 <refname>page.width.portrait</refname>
8268 <refpurpose>Specify the physical size of the short edge of the page</refpurpose>
8269 </refnamediv>
8270
8271 <refsynopsisdiv>
8272 <programlisting xml:id="page.width.portrait.frag">&lt;xsl:param name="page.width.portrait"&gt;
8273   &lt;xsl:choose&gt;
8274     &lt;xsl:when test="$paper.type = 'USletter'"&gt;8.5in&lt;/xsl:when&gt;
8275     &lt;xsl:when test="$paper.type = 'USlandscape'"&gt;11in&lt;/xsl:when&gt;
8276     &lt;xsl:when test="$paper.type = 'USlegal'"&gt;8.5in&lt;/xsl:when&gt;
8277     &lt;xsl:when test="$paper.type = 'USlegallandscape'"&gt;14in&lt;/xsl:when&gt;
8278     &lt;xsl:when test="$paper.type = '4A0'"&gt;1682mm&lt;/xsl:when&gt;
8279     &lt;xsl:when test="$paper.type = '2A0'"&gt;1189mm&lt;/xsl:when&gt;
8280     &lt;xsl:when test="$paper.type = 'A0'"&gt;841mm&lt;/xsl:when&gt;
8281     &lt;xsl:when test="$paper.type = 'A1'"&gt;594mm&lt;/xsl:when&gt;
8282     &lt;xsl:when test="$paper.type = 'A2'"&gt;420mm&lt;/xsl:when&gt;
8283     &lt;xsl:when test="$paper.type = 'A3'"&gt;297mm&lt;/xsl:when&gt;
8284     &lt;xsl:when test="$paper.type = 'A4'"&gt;210mm&lt;/xsl:when&gt;
8285     &lt;xsl:when test="$paper.type = 'A5'"&gt;148mm&lt;/xsl:when&gt;
8286     &lt;xsl:when test="$paper.type = 'A6'"&gt;105mm&lt;/xsl:when&gt;
8287     &lt;xsl:when test="$paper.type = 'A7'"&gt;74mm&lt;/xsl:when&gt;
8288     &lt;xsl:when test="$paper.type = 'A8'"&gt;52mm&lt;/xsl:when&gt;
8289     &lt;xsl:when test="$paper.type = 'A9'"&gt;37mm&lt;/xsl:when&gt;
8290     &lt;xsl:when test="$paper.type = 'A10'"&gt;26mm&lt;/xsl:when&gt;
8291     &lt;xsl:when test="$paper.type = 'B0'"&gt;1000mm&lt;/xsl:when&gt;
8292     &lt;xsl:when test="$paper.type = 'B1'"&gt;707mm&lt;/xsl:when&gt;
8293     &lt;xsl:when test="$paper.type = 'B2'"&gt;500mm&lt;/xsl:when&gt;
8294     &lt;xsl:when test="$paper.type = 'B3'"&gt;353mm&lt;/xsl:when&gt;
8295     &lt;xsl:when test="$paper.type = 'B4'"&gt;250mm&lt;/xsl:when&gt;
8296     &lt;xsl:when test="$paper.type = 'B5'"&gt;176mm&lt;/xsl:when&gt;
8297     &lt;xsl:when test="$paper.type = 'B6'"&gt;125mm&lt;/xsl:when&gt;
8298     &lt;xsl:when test="$paper.type = 'B7'"&gt;88mm&lt;/xsl:when&gt;
8299     &lt;xsl:when test="$paper.type = 'B8'"&gt;62mm&lt;/xsl:when&gt;
8300     &lt;xsl:when test="$paper.type = 'B9'"&gt;44mm&lt;/xsl:when&gt;
8301     &lt;xsl:when test="$paper.type = 'B10'"&gt;31mm&lt;/xsl:when&gt;
8302     &lt;xsl:when test="$paper.type = 'C0'"&gt;917mm&lt;/xsl:when&gt;
8303     &lt;xsl:when test="$paper.type = 'C1'"&gt;648mm&lt;/xsl:when&gt;
8304     &lt;xsl:when test="$paper.type = 'C2'"&gt;458mm&lt;/xsl:when&gt;
8305     &lt;xsl:when test="$paper.type = 'C3'"&gt;324mm&lt;/xsl:when&gt;
8306     &lt;xsl:when test="$paper.type = 'C4'"&gt;229mm&lt;/xsl:when&gt;
8307     &lt;xsl:when test="$paper.type = 'C5'"&gt;162mm&lt;/xsl:when&gt;
8308     &lt;xsl:when test="$paper.type = 'C6'"&gt;114mm&lt;/xsl:when&gt;
8309     &lt;xsl:when test="$paper.type = 'C7'"&gt;81mm&lt;/xsl:when&gt;
8310     &lt;xsl:when test="$paper.type = 'C8'"&gt;57mm&lt;/xsl:when&gt;
8311     &lt;xsl:when test="$paper.type = 'C9'"&gt;40mm&lt;/xsl:when&gt;
8312     &lt;xsl:when test="$paper.type = 'C10'"&gt;28mm&lt;/xsl:when&gt;
8313     &lt;xsl:otherwise&gt;8.5in&lt;/xsl:otherwise&gt;
8314   &lt;/xsl:choose&gt;
8315 &lt;/xsl:param&gt;</programlisting>
8316 </refsynopsisdiv>
8317
8318 <refsection><info><title>Description</title></info>
8319
8320 <para>The portrait page width is the length of the short
8321 edge of the physical page.
8322 </para>
8323
8324 </refsection>
8325 </refentry>
8326
8327 <refentry version="5.0" xml:id="paper.type">
8328 <refmeta>
8329 <refentrytitle>paper.type</refentrytitle>
8330 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
8331 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>
8332 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>
8333 <refmiscinfo class="other" otherclass="value">USletter<alt>8.5x11in</alt></refmiscinfo>
8334 <refmiscinfo class="other" otherclass="value">USlandscape<alt>11x8.5in</alt></refmiscinfo>
8335 <refmiscinfo class="other" otherclass="value">USlegal<alt>8.5inx14in</alt></refmiscinfo>
8336 <refmiscinfo class="other" otherclass="value">USlegallandscape<alt>14inx8.5in</alt></refmiscinfo>
8337 <refmiscinfo class="other" otherclass="value">4A0<alt>2378x1682mm</alt></refmiscinfo>
8338 <refmiscinfo class="other" otherclass="value">2A0<alt>1682x1189mm</alt></refmiscinfo>
8339 <refmiscinfo class="other" otherclass="value">A0<alt>1189x841mm</alt></refmiscinfo>
8340 <refmiscinfo class="other" otherclass="value">A1<alt>841x594mm</alt></refmiscinfo>
8341 <refmiscinfo class="other" otherclass="value">A2<alt>594x420mm</alt></refmiscinfo>
8342 <refmiscinfo class="other" otherclass="value">A3<alt>420x297mm</alt></refmiscinfo>
8343 <refmiscinfo class="other" otherclass="value">A4<alt>297x210mm</alt></refmiscinfo>
8344 <refmiscinfo class="other" otherclass="value">A5<alt>210x148mm</alt></refmiscinfo>
8345 <refmiscinfo class="other" otherclass="value">A6<alt>148x105mm</alt></refmiscinfo>
8346 <refmiscinfo class="other" otherclass="value">A7<alt>105x74mm</alt></refmiscinfo>
8347 <refmiscinfo class="other" otherclass="value">A8<alt>74x52mm</alt></refmiscinfo>
8348 <refmiscinfo class="other" otherclass="value">A9<alt>52x37mm</alt></refmiscinfo>
8349 <refmiscinfo class="other" otherclass="value">A10<alt>37x26mm</alt></refmiscinfo>
8350 <refmiscinfo class="other" otherclass="value">B0<alt>1414x1000mm</alt></refmiscinfo>
8351 <refmiscinfo class="other" otherclass="value">B1<alt>1000x707mm</alt></refmiscinfo>
8352 <refmiscinfo class="other" otherclass="value">B2<alt>707x500mm</alt></refmiscinfo>
8353 <refmiscinfo class="other" otherclass="value">B3<alt>500x353mm</alt></refmiscinfo>
8354 <refmiscinfo class="other" otherclass="value">B4<alt>353x250mm</alt></refmiscinfo>
8355 <refmiscinfo class="other" otherclass="value">B5<alt>250x176mm</alt></refmiscinfo>
8356 <refmiscinfo class="other" otherclass="value">B6<alt>176x125mm</alt></refmiscinfo>
8357 <refmiscinfo class="other" otherclass="value">B7<alt>125x88mm</alt></refmiscinfo>
8358 <refmiscinfo class="other" otherclass="value">B8<alt>88x62mm</alt></refmiscinfo>
8359 <refmiscinfo class="other" otherclass="value">B9<alt>62x44mm</alt></refmiscinfo>
8360 <refmiscinfo class="other" otherclass="value">B10<alt>44x31mm</alt></refmiscinfo>
8361 <refmiscinfo class="other" otherclass="value">C0<alt>1297x917mm</alt></refmiscinfo>
8362 <refmiscinfo class="other" otherclass="value">C1<alt>917x648mm</alt></refmiscinfo>
8363 <refmiscinfo class="other" otherclass="value">C2<alt>648x458mm</alt></refmiscinfo>
8364 <refmiscinfo class="other" otherclass="value">C3<alt>458x324mm</alt></refmiscinfo>
8365 <refmiscinfo class="other" otherclass="value">C4<alt>324x229mm</alt></refmiscinfo>
8366 <refmiscinfo class="other" otherclass="value">C5<alt>229x162mm</alt></refmiscinfo>
8367 <refmiscinfo class="other" otherclass="value">C6<alt>162x114mm</alt></refmiscinfo>
8368 <refmiscinfo class="other" otherclass="value">C7<alt>114x81mm</alt></refmiscinfo>
8369 <refmiscinfo class="other" otherclass="value">C8<alt>81x57mm</alt></refmiscinfo>
8370 <refmiscinfo class="other" otherclass="value">C9<alt>57x40mm</alt></refmiscinfo>
8371 <refmiscinfo class="other" otherclass="value">C10<alt>40x28mm</alt></refmiscinfo>
8372 </refmeta>
8373 <refnamediv>
8374 <refname>paper.type</refname>
8375 <refpurpose>Select the paper type</refpurpose>
8376 </refnamediv>
8377
8378 <refsynopsisdiv>
8379 <programlisting xml:id="paper.type.frag">
8380 &lt;xsl:param name="paper.type"&gt;USletter&lt;/xsl:param&gt;
8381 </programlisting>
8382 </refsynopsisdiv>
8383
8384 <refsection><info><title>Description</title></info>
8385
8386 <para>The paper type is a convenient way to specify the paper size.
8387 The list of known paper sizes includes USletter and most of the A,
8388 B, and C sizes. See <parameter>page.width.portrait</parameter>, for example.
8389
8390
8391 </para>
8392
8393 </refsection>
8394 </refentry>
8395
8396 <refentry version="5.0" xml:id="double.sided">
8397 <refmeta>
8398 <refentrytitle>double.sided</refentrytitle>
8399 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
8400 </refmeta>
8401 <refnamediv>
8402 <refname>double.sided</refname>
8403 <refpurpose>Is the document to be printed double sided?</refpurpose>
8404 </refnamediv>
8405
8406 <refsynopsisdiv>
8407 <programlisting xml:id="double.sided.frag">
8408 &lt;xsl:param name="double.sided" select="0"&gt;&lt;/xsl:param&gt;
8409 </programlisting>
8410 </refsynopsisdiv>
8411
8412 <refsection><info><title>Description</title></info>
8413
8414 <para>This parameter is useful when printing a document
8415 on both sides of the paper.</para>
8416
8417 <para>if set to non-zero, documents are formatted using different page-masters
8418 for odd and even pages.  These can differ by using a slightly wider margin
8419 on the binding edge of the page, and alternating left-right
8420 positions of header or footer elements.
8421 </para>
8422
8423 <para>If set to zero (the default), then only the 'odd' page masters
8424 are used for both even and odd numbered pages.</para>
8425
8426 <para>See also <parameter>force.blank.pages</parameter>,
8427 <parameter>page.margin.inner</parameter> and
8428 <parameter>page.margin.outer</parameter>.</para>
8429
8430 </refsection>
8431 </refentry>
8432
8433 <refentry version="5.0" xml:id="force.blank.pages">
8434 <refmeta>
8435 <refentrytitle>force.blank.pages</refentrytitle>
8436 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
8437 </refmeta>
8438 <refnamediv>
8439 <refname>force.blank.pages</refname>
8440 <refpurpose>Generate blank page to end on even page number</refpurpose>
8441 </refnamediv>
8442
8443 <refsynopsisdiv>
8444 <programlisting xml:id="force.blank.pages.frag">
8445 &lt;xsl:param name="force.blank.pages" select="1"&gt;&lt;/xsl:param&gt;
8446 </programlisting>
8447 </refsynopsisdiv>
8448
8449 <refsection><info><title>Description</title></info>
8450
8451 <para>If non-zero (the default), then each page sequence will be forced to
8452 end on an even-numbered page, by inserting a blank page
8453 if necessary. This will force the next page sequence to start
8454 on an odd-numbered page, which is a standard convention
8455 for printed and bound books.</para>
8456
8457 <para>If zero, then such blank pages will not be inserted.
8458 Chapters will start on the next available page,
8459 regardless of whether it is an even or odd number.
8460 This is useful when publishing online where blank
8461 pages are not needed.
8462 </para>
8463
8464 <para>This param is independent of the
8465 <parameter>double.sided</parameter> parameter, which
8466 just triggers the use of even and odd page sequence
8467 masters that differ in their header and footer placement.
8468 So you can combine the two params for alternating
8469 headers/footers and no blank pages.
8470 </para>
8471
8472 </refsection>
8473 </refentry>
8474
8475 <refentry version="5.0" xml:id="body.margin.bottom">
8476 <refmeta>
8477 <refentrytitle>body.margin.bottom</refentrytitle>
8478 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8479 </refmeta>
8480 <refnamediv>
8481 <refname>body.margin.bottom</refname>
8482 <refpurpose>The bottom margin of the body text</refpurpose>
8483 </refnamediv>
8484
8485 <refsynopsisdiv>
8486 <programlisting xml:id="body.margin.bottom.frag">
8487 &lt;xsl:param name="body.margin.bottom"&gt;0.5in&lt;/xsl:param&gt;
8488 </programlisting>
8489 </refsynopsisdiv>
8490
8491 <refsection><info><title>Description</title></info>
8492
8493 <para>The body bottom margin is the distance from the last line of text
8494 in the page body to the bottom of the region-after.
8495 </para>
8496
8497 </refsection>
8498 </refentry>
8499
8500 <refentry version="5.0" xml:id="body.margin.top">
8501 <refmeta>
8502 <refentrytitle>body.margin.top</refentrytitle>
8503 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8504 </refmeta>
8505 <refnamediv>
8506 <refname>body.margin.top</refname>
8507 <refpurpose>To specify the size of the top margin of a page</refpurpose>
8508 </refnamediv>
8509
8510 <refsynopsisdiv>
8511 <programlisting xml:id="body.margin.top.frag">
8512 &lt;xsl:param name="body.margin.top"&gt;0.5in&lt;/xsl:param&gt;
8513 </programlisting>
8514 </refsynopsisdiv>
8515
8516 <refsection><info><title>Description</title></info>
8517
8518 <para>The body top margin is the distance from the top of the
8519 region-before to the first line of text in the page body.</para>
8520
8521 </refsection>
8522 </refentry>
8523
8524 <refentry version="5.0" xml:id="body.margin.inner">
8525 <refmeta>
8526 <refentrytitle>body.margin.inner</refentrytitle>
8527 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8528 </refmeta>
8529 <refnamediv>
8530 <refname>body.margin.inner</refname>
8531 <refpurpose>Specify the size of the inner margin of the body region</refpurpose>
8532 </refnamediv>
8533
8534 <refsynopsisdiv>
8535 <programlisting xml:id="body.margin.inner.frag">
8536 &lt;xsl:param name="body.margin.inner"&gt;0in&lt;/xsl:param&gt;
8537 </programlisting>
8538 </refsynopsisdiv>
8539
8540 <refsection><info><title>Description</title></info>
8541
8542 <para>The inner body margin is the extra inner side
8543 (binding side) margin taken from the body
8544 region in addition to the inner page margin.
8545 It makes room for a side region for text content whose width is
8546 specified by the <parameter>region.inner.extent</parameter>
8547 parameter.</para>
8548
8549 <para>For double-sided output,
8550 this side region
8551 is <literal>fo:region-start</literal> on a odd-numbered page,
8552 and <literal>fo:region-end</literal> on an even-numbered page.</para>
8553
8554 <para>For single-sided output,
8555 this side region
8556 is <literal>fo:region-start</literal> for all pages.</para>
8557
8558 <para>This correspondence applies to all languages,
8559 both left-to-right and right-to-left writing modes.</para>
8560
8561 <para>The default value is zero.</para>
8562
8563 <para>See also
8564 <parameter>region.inner.extent</parameter>,
8565 <parameter>region.outer.extent</parameter>,
8566 <parameter>body.margin.outer</parameter>,
8567 <parameter>side.region.precedence</parameter>.
8568 </para>
8569 </refsection>
8570 </refentry>
8571
8572 <refentry version="5.0" xml:id="body.margin.outer">
8573 <refmeta>
8574 <refentrytitle>body.margin.outer</refentrytitle>
8575 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8576 </refmeta>
8577 <refnamediv>
8578 <refname>body.margin.outer</refname>
8579 <refpurpose>Specify the size of the outer margin of the body region</refpurpose>
8580 </refnamediv>
8581
8582 <refsynopsisdiv>
8583 <programlisting xml:id="body.margin.outer.frag">
8584 &lt;xsl:param name="body.margin.outer"&gt;0in&lt;/xsl:param&gt;
8585 </programlisting>
8586 </refsynopsisdiv>
8587
8588 <refsection><info><title>Description</title></info>
8589
8590 <para>The outer body margin is the extra outer side
8591 (opposite the binding side) margin taken
8592 from the body
8593 region in addition to the outer page margin.
8594 It makes room for a side region for text content whose width is
8595 specified by the <parameter>region.outer.extent</parameter>
8596 parameter.</para>
8597
8598 <para>For double-sided output,
8599 this side region
8600 is <literal>fo:region-end</literal> on a odd-numbered page,
8601 and <literal>fo:region-start</literal> on an even-numbered page.</para>
8602
8603 <para>For single-sided output,
8604 this side region
8605 is <literal>fo:region-end</literal> for all pages.</para>
8606
8607 <para>This correspondence applies to all languages,
8608 both left-to-right and right-to-left writing modes.</para>
8609
8610 <para>The default value is zero.</para>
8611
8612 <para>See also
8613 <parameter>region.inner.extent</parameter>,
8614 <parameter>region.outer.extent</parameter>,
8615 <parameter>body.margin.inner</parameter>,
8616 <parameter>side.region.precedence</parameter>.
8617 </para>
8618 </refsection>
8619 </refentry>
8620
8621 <refentry version="5.0" xml:id="body.start.indent">
8622 <refmeta>
8623 <refentrytitle>body.start.indent</refentrytitle>
8624 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8625 </refmeta>
8626 <refnamediv>
8627 <refname>body.start.indent</refname>
8628 <refpurpose>The start-indent for the body text</refpurpose>
8629 </refnamediv>
8630
8631 <refsynopsisdiv>
8632 <programlisting xml:id="body.start.indent.frag">
8633 &lt;xsl:param name="body.start.indent"&gt;
8634   &lt;xsl:choose&gt;
8635     &lt;xsl:when test="$fop.extensions != 0"&gt;0pt&lt;/xsl:when&gt;
8636     &lt;xsl:when test="$passivetex.extensions != 0"&gt;0pt&lt;/xsl:when&gt;
8637     &lt;xsl:otherwise&gt;4pc&lt;/xsl:otherwise&gt;
8638   &lt;/xsl:choose&gt;
8639 &lt;/xsl:param&gt;
8640 </programlisting>
8641 </refsynopsisdiv>
8642
8643 <refsection><info><title>Description</title></info>
8644
8645 <para>This parameter provides
8646 the means of indenting the body text relative to
8647 section titles.
8648 For left-to-right text direction, it indents the left side.
8649 For right-to-left text direction, it indents the right side.
8650 It is used in place of the
8651 <parameter>title.margin.left</parameter> for
8652 all XSL-FO processors except FOP 0.25.
8653 It enables support for side floats to appear
8654 in the indented margin area.
8655 </para>
8656 <para>This start-indent property is added to the fo:flow
8657 for certain page sequences.  Which page-sequences it is
8658 applied to is determined by the template named
8659 <literal>set.flow.properties</literal>.
8660 By default, that template adds it to the flow
8661 for page-sequences using the <quote>body</quote>
8662 master-reference, as well as appendixes and prefaces.
8663 </para>
8664 <para>If this parameter is used, section titles should have
8665 a start-indent value of 0pt if they are to be
8666 outdented relative to the body text.
8667 </para>
8668
8669 <para>If you are using FOP, then set this parameter to a zero
8670 width value and set the <parameter>title.margin.left</parameter>
8671 parameter to the negative value of the desired indent.
8672 </para>
8673
8674 <para>See also <parameter>body.end.indent</parameter> and
8675 <parameter>title.margin.left</parameter>.
8676 </para>
8677
8678 </refsection>
8679 </refentry>
8680
8681 <refentry version="5.0" xml:id="body.end.indent">
8682 <refmeta>
8683 <refentrytitle>body.end.indent</refentrytitle>
8684 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8685 </refmeta>
8686 <refnamediv>
8687 <refname>body.end.indent</refname>
8688 <refpurpose>The end-indent for the body text</refpurpose>
8689 </refnamediv>
8690
8691 <refsynopsisdiv>
8692 <programlisting xml:id="body.end.indent.frag">
8693 &lt;xsl:param name="body.end.indent"&gt;0pt&lt;/xsl:param&gt;
8694 </programlisting>
8695 </refsynopsisdiv>
8696
8697 <refsection><info><title>Description</title></info>
8698
8699 <para>This end-indent property is added to the fo:flow
8700 for certain page sequences.  Which page-sequences it is
8701 applied to is determined by the template named
8702 <literal>set.flow.properties</literal>.
8703 By default, that template adds it to the flow
8704 for page-sequences using the <quote>body</quote>
8705 master-reference, as well as appendixes and prefaces.
8706 </para>
8707
8708 <para>See also <parameter>body.start.indent</parameter>.
8709 </para>
8710
8711 </refsection>
8712 </refentry>
8713
8714 <refentry version="5.0" xml:id="alignment">
8715 <refmeta>
8716 <refentrytitle>alignment</refentrytitle>
8717   <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
8718   <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>
8719   <refmiscinfo class="other" otherclass="value">left</refmiscinfo>
8720   <refmiscinfo class="other" otherclass="value">start</refmiscinfo>
8721   <refmiscinfo class="other" otherclass="value">right</refmiscinfo>
8722   <refmiscinfo class="other" otherclass="value">end</refmiscinfo>
8723   <refmiscinfo class="other" otherclass="value">center</refmiscinfo>
8724   <refmiscinfo class="other" otherclass="value">justify</refmiscinfo>
8725 </refmeta>
8726 <refnamediv>
8727 <refname>alignment</refname>
8728 <refpurpose>Specify the default text alignment</refpurpose>
8729 </refnamediv>
8730
8731 <refsynopsisdiv>
8732 <programlisting xml:id="alignment.frag">&lt;xsl:param name="alignment"&gt;justify&lt;/xsl:param&gt;</programlisting>
8733 </refsynopsisdiv>
8734
8735 <refsection><info><title>Description</title></info>
8736
8737 <para>The default text alignment is used for most body text.
8738 Allowed values are
8739 <literal>left</literal>,
8740 <literal>right</literal>,
8741 <literal>start</literal>,
8742 <literal>end</literal>,
8743 <literal>center</literal>,
8744 <literal>justify</literal>.
8745 The default value is <literal>justify</literal>.
8746 </para>
8747
8748 </refsection>
8749 </refentry>
8750
8751 <refentry version="5.0" xml:id="hyphenate">
8752 <refmeta>
8753 <refentrytitle>hyphenate</refentrytitle>
8754 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
8755 <refmiscinfo class="other" otherclass="list-type">closed</refmiscinfo>
8756 <refmiscinfo class="other" otherclass="value">true</refmiscinfo>
8757 <refmiscinfo class="other" otherclass="value">false</refmiscinfo>
8758 </refmeta>
8759 <refnamediv>
8760 <refname>hyphenate</refname>
8761 <refpurpose>Specify hyphenation behavior</refpurpose>
8762 </refnamediv>
8763
8764 <refsynopsisdiv>
8765 <programlisting xml:id="hyphenate.frag">&lt;xsl:param name="hyphenate"&gt;true&lt;/xsl:param&gt;</programlisting>
8766 </refsynopsisdiv>
8767
8768 <refsection><info><title>Description</title></info>
8769
8770 <para>If true, words may be hyphenated. Otherwise, they may not.</para>
8771 <para>See also <parameter>ulink.hyphenate.chars</parameter> </para>
8772
8773 </refsection>
8774 </refentry>
8775
8776 <refentry version="5.0" xml:id="line-height">
8777 <refmeta>
8778 <refentrytitle>line-height</refentrytitle>
8779 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
8780 </refmeta>
8781 <refnamediv>
8782 <refname>line-height</refname>
8783 <refpurpose>Specify the line-height property</refpurpose>
8784 </refnamediv>
8785
8786 <refsynopsisdiv>
8787 <programlisting xml:id="line-height.frag">
8788 &lt;xsl:param name="line-height"&gt;normal&lt;/xsl:param&gt;
8789 </programlisting>
8790 </refsynopsisdiv>
8791
8792 <refsection><info><title>Description</title></info>
8793
8794 <para>Sets the line-height property.</para>
8795
8796 </refsection>
8797 </refentry>
8798
8799 <refentry version="5.0" xml:id="column.count.back">
8800 <refmeta>
8801 <refentrytitle>column.count.back</refentrytitle>
8802 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
8803 </refmeta>
8804 <refnamediv>
8805 <refname>column.count.back</refname>
8806 <refpurpose>Number of columns on back matter pages</refpurpose>
8807 </refnamediv>
8808
8809 <refsynopsisdiv>
8810 <programlisting xml:id="column.count.back.frag">
8811 &lt;xsl:param name="column.count.back" select="1"&gt;&lt;/xsl:param&gt;
8812 </programlisting>
8813 </refsynopsisdiv>
8814
8815 <refsection><info><title>Description</title></info>
8816
8817 <para>Number of columns on back matter (appendix, glossary, etc.) pages.</para>
8818
8819 </refsection>
8820 </refentry>
8821
8822 <refentry version="5.0" xml:id="column.count.body">
8823 <refmeta>
8824 <refentrytitle>column.count.body</refentrytitle>
8825 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
8826 </refmeta>
8827 <refnamediv>
8828 <refname>column.count.body</refname>
8829 <refpurpose>Number of columns on body pages</refpurpose>
8830 </refnamediv>
8831
8832 <refsynopsisdiv>
8833 <programlisting xml:id="column.count.body.frag">
8834 &lt;xsl:param name="column.count.body" select="1"&gt;&lt;/xsl:param&gt;
8835 </programlisting>
8836 </refsynopsisdiv>
8837
8838 <refsection><info><title>Description</title></info>
8839
8840 <para>Number of columns on body pages.</para>
8841
8842 </refsection>
8843 </refentry>
8844
8845 <refentry version="5.0" xml:id="column.count.front">
8846 <refmeta>
8847 <refentrytitle>column.count.front</refentrytitle>
8848 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
8849 </refmeta>
8850 <refnamediv>
8851 <refname>column.count.front</refname>
8852 <refpurpose>Number of columns on front matter pages</refpurpose>
8853 </refnamediv>
8854
8855 <refsynopsisdiv>
8856 <programlisting xml:id="column.count.front.frag">
8857 &lt;xsl:param name="column.count.front" select="1"&gt;&lt;/xsl:param&gt;
8858 </programlisting>
8859 </refsynopsisdiv>
8860
8861 <refsection><info><title>Description</title></info>
8862
8863 <para>Number of columns on front matter (dedication, preface, etc.) pages.</para>
8864
8865 </refsection>
8866 </refentry>
8867
8868 <refentry version="5.0" xml:id="column.count.index">
8869 <refmeta>
8870 <refentrytitle>column.count.index</refentrytitle>
8871 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
8872 </refmeta>
8873 <refnamediv>
8874 <refname>column.count.index</refname>
8875 <refpurpose>Number of columns on index pages</refpurpose>
8876 </refnamediv>
8877
8878 <refsynopsisdiv>
8879 <programlisting xml:id="column.count.index.frag">
8880 &lt;xsl:param name="column.count.index"&gt;2&lt;/xsl:param&gt;
8881 </programlisting>
8882 </refsynopsisdiv>
8883
8884 <refsection><info><title>Description</title></info>
8885
8886 <para>Number of columns on index pages.</para>
8887
8888 </refsection>
8889 </refentry>
8890
8891 <refentry version="5.0" xml:id="column.count.lot">
8892 <refmeta>
8893 <refentrytitle>column.count.lot</refentrytitle>
8894 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
8895 </refmeta>
8896 <refnamediv>
8897 <refname>column.count.lot</refname>
8898 <refpurpose>Number of columns on a 'List-of-Titles' page</refpurpose>
8899 </refnamediv>
8900
8901 <refsynopsisdiv>
8902 <programlisting xml:id="column.count.lot.frag">
8903 &lt;xsl:param name="column.count.lot" select="1"&gt;&lt;/xsl:param&gt;
8904 </programlisting>
8905 </refsynopsisdiv>
8906
8907 <refsection><info><title>Description</title></info>
8908
8909 <para>Number of columns on a page sequence containing the Table of Contents,
8910 List of Figures, etc.</para>
8911
8912 </refsection>
8913 </refentry>
8914
8915 <refentry version="5.0" xml:id="column.count.titlepage">
8916 <refmeta>
8917 <refentrytitle>column.count.titlepage</refentrytitle>
8918 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
8919 </refmeta>
8920 <refnamediv>
8921 <refname>column.count.titlepage</refname>
8922 <refpurpose>Number of columns on a title page</refpurpose>
8923 </refnamediv>
8924
8925 <refsynopsisdiv>
8926 <programlisting xml:id="column.count.titlepage.frag">
8927 &lt;xsl:param name="column.count.titlepage" select="1"&gt;&lt;/xsl:param&gt;
8928 </programlisting>
8929 </refsynopsisdiv>
8930
8931 <refsection><info><title>Description</title></info>
8932
8933 <para>Number of columns on a title page</para>
8934
8935 </refsection>
8936 </refentry>
8937
8938 <refentry version="5.0" xml:id="column.gap.back">
8939 <refmeta>
8940 <refentrytitle>column.gap.back</refentrytitle>
8941 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8942 </refmeta>
8943 <refnamediv>
8944 <refname>column.gap.back</refname>
8945 <refpurpose>Gap between columns in back matter</refpurpose>
8946 </refnamediv>
8947
8948 <refsynopsisdiv>
8949 <programlisting xml:id="column.gap.back.frag">
8950 &lt;xsl:param name="column.gap.back"&gt;12pt&lt;/xsl:param&gt;
8951 </programlisting>
8952 </refsynopsisdiv>
8953
8954 <refsection><info><title>Description</title></info>
8955
8956 <para>Specifies the gap between columns in back matter (if
8957 <parameter>column.count.back</parameter> is greater than one).</para>
8958
8959 </refsection>
8960 </refentry>
8961
8962 <refentry version="5.0" xml:id="column.gap.body">
8963 <refmeta>
8964 <refentrytitle>column.gap.body</refentrytitle>
8965 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8966 </refmeta>
8967 <refnamediv>
8968 <refname>column.gap.body</refname>
8969 <refpurpose>Gap between columns in the body</refpurpose>
8970 </refnamediv>
8971
8972 <refsynopsisdiv>
8973 <programlisting xml:id="column.gap.body.frag">
8974 &lt;xsl:param name="column.gap.body"&gt;12pt&lt;/xsl:param&gt;
8975 </programlisting>
8976 </refsynopsisdiv>
8977
8978 <refsection><info><title>Description</title></info>
8979
8980 <para>Specifies the gap between columns in body matter (if
8981 <parameter>column.count.body</parameter> is greater than one).</para>
8982
8983 </refsection>
8984 </refentry>
8985
8986 <refentry version="5.0" xml:id="column.gap.front">
8987 <refmeta>
8988 <refentrytitle>column.gap.front</refentrytitle>
8989 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8990 </refmeta>
8991 <refnamediv>
8992 <refname>column.gap.front</refname>
8993 <refpurpose>Gap between columns in the front matter</refpurpose>
8994 </refnamediv>
8995
8996 <refsynopsisdiv>
8997 <programlisting xml:id="column.gap.front.frag">
8998 &lt;xsl:param name="column.gap.front"&gt;12pt&lt;/xsl:param&gt;
8999 </programlisting>
9000 </refsynopsisdiv>
9001
9002 <refsection><info><title>Description</title></info>
9003
9004 <para>Specifies the gap between columns in front matter (if
9005 <parameter>column.count.front</parameter> is greater than one).</para>
9006
9007 </refsection>
9008 </refentry>
9009
9010 <refentry version="5.0" xml:id="column.gap.index">
9011 <refmeta>
9012 <refentrytitle>column.gap.index</refentrytitle>
9013 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9014 </refmeta>
9015 <refnamediv>
9016 <refname>column.gap.index</refname>
9017 <refpurpose>Gap between columns in the index</refpurpose>
9018 </refnamediv>
9019
9020 <refsynopsisdiv>
9021 <programlisting xml:id="column.gap.index.frag">
9022 &lt;xsl:param name="column.gap.index"&gt;12pt&lt;/xsl:param&gt;
9023 </programlisting>
9024 </refsynopsisdiv>
9025
9026 <refsection><info><title>Description</title></info>
9027
9028 <para>Specifies the gap between columns in indexes (if
9029 <parameter>column.count.index</parameter> is greater than one).</para>
9030
9031 </refsection>
9032 </refentry>
9033
9034 <refentry version="5.0" xml:id="column.gap.lot">
9035 <refmeta>
9036 <refentrytitle>column.gap.lot</refentrytitle>
9037 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9038 </refmeta>
9039 <refnamediv>
9040 <refname>column.gap.lot</refname>
9041 <refpurpose>Gap between columns on a 'List-of-Titles' page</refpurpose>
9042 </refnamediv>
9043
9044 <refsynopsisdiv>
9045 <programlisting xml:id="column.gap.lot.frag">
9046 &lt;xsl:param name="column.gap.lot"&gt;12pt&lt;/xsl:param&gt;
9047 </programlisting>
9048 </refsynopsisdiv>
9049
9050 <refsection><info><title>Description</title></info>
9051
9052 <para>Specifies the gap between columns on 'List-of-Titles' pages (if
9053 <parameter>column.count.lot</parameter> is greater than one).</para>
9054
9055 </refsection>
9056 </refentry>
9057
9058 <refentry version="5.0" xml:id="column.gap.titlepage">
9059 <refmeta>
9060 <refentrytitle>column.gap.titlepage</refentrytitle>
9061 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9062 </refmeta>
9063 <refnamediv>
9064 <refname>column.gap.titlepage</refname>
9065 <refpurpose>Gap between columns on title pages</refpurpose>
9066 </refnamediv>
9067
9068 <refsynopsisdiv>
9069 <programlisting xml:id="column.gap.titlepage.frag">
9070 &lt;xsl:param name="column.gap.titlepage"&gt;12pt&lt;/xsl:param&gt;
9071 </programlisting>
9072 </refsynopsisdiv>
9073
9074 <refsection><info><title>Description</title></info>
9075
9076 <para>Specifies the gap between columns on title pages (if
9077 <parameter>column.count.titlepage</parameter> is greater than one).</para>
9078
9079
9080 </refsection>
9081 </refentry>
9082
9083 <refentry version="5.0" xml:id="region.after.extent">
9084 <refmeta>
9085 <refentrytitle>region.after.extent</refentrytitle>
9086 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9087 </refmeta>
9088 <refnamediv>
9089 <refname>region.after.extent</refname>
9090 <refpurpose>Specifies the height of the footer.</refpurpose>
9091 </refnamediv>
9092
9093 <refsynopsisdiv>
9094 <programlisting xml:id="region.after.extent.frag">
9095 &lt;xsl:param name="region.after.extent"&gt;0.4in&lt;/xsl:param&gt;
9096 </programlisting>
9097 </refsynopsisdiv>
9098
9099 <refsection><info><title>Description</title></info>
9100
9101 <para>The region after extent is the height of the area where footers
9102 are printed.
9103 </para>
9104
9105 </refsection>
9106 </refentry>
9107
9108 <refentry version="5.0" xml:id="region.before.extent">
9109 <refmeta>
9110 <refentrytitle>region.before.extent</refentrytitle>
9111 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9112 </refmeta>
9113 <refnamediv>
9114 <refname>region.before.extent</refname>
9115 <refpurpose>Specifies the height of the header</refpurpose>
9116 </refnamediv>
9117
9118 <refsynopsisdiv>
9119 <programlisting xml:id="region.before.extent.frag">
9120 &lt;xsl:param name="region.before.extent"&gt;0.4in&lt;/xsl:param&gt;
9121 </programlisting>
9122 </refsynopsisdiv>
9123
9124 <refsection><info><title>Description</title></info>
9125
9126 <para>The region before extent is the height of the area where headers
9127 are printed.
9128 </para>
9129
9130 </refsection>
9131 </refentry>
9132
9133 <refentry version="5.0" xml:id="region.inner.extent">
9134 <refmeta>
9135 <refentrytitle>region.inner.extent</refentrytitle>
9136 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9137 </refmeta>
9138 <refnamediv>
9139 <refname>region.inner.extent</refname>
9140 <refpurpose>Specifies the width of the inner side region</refpurpose>
9141 </refnamediv>
9142
9143 <refsynopsisdiv>
9144 <programlisting xml:id="region.inner.extent.frag">
9145 &lt;xsl:param name="region.inner.extent"&gt;0in&lt;/xsl:param&gt;
9146 </programlisting>
9147 </refsynopsisdiv>
9148
9149 <refsection><info><title>Description</title></info>
9150
9151 <para>The region inner extent is the width of the optional
9152 text area next to the inner side (binding side) of the
9153 body region.  </para>
9154
9155 <para>For double-sided output, this side region
9156 is <literal>fo:region-start</literal> on a odd-numbered page,
9157 and <literal>fo:region-end</literal> on an even-numbered page.</para>
9158
9159 <para>For single-sided output, this side region
9160 is <literal>fo:region-start</literal> for all pages.</para>
9161
9162 <para>This correspondence applies to all languages,
9163 both left-to-right and right-to-left writing modes.</para>
9164
9165 <para>The default value of this parameter is zero.  If you enlarge this extent,
9166 be sure to also enlarge the <parameter>body.margin.inner</parameter>
9167 parameter to make room for its content, otherwise any text in
9168 the side region may overlap with the body text.</para>
9169
9170 <para>See also
9171 <parameter>region.outer.extent</parameter>,
9172 <parameter>body.margin.inner</parameter>,
9173 <parameter>body.margin.outer</parameter>,
9174 <parameter>side.region.precedence</parameter>.
9175 </para>
9176
9177 </refsection>
9178 </refentry>
9179
9180 <refentry version="5.0" xml:id="region.outer.extent">
9181 <refmeta>
9182 <refentrytitle>region.outer.extent</refentrytitle>
9183 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9184 </refmeta>
9185 <refnamediv>
9186 <refname>region.outer.extent</refname>
9187 <refpurpose>Specifies the width of the outer side region</refpurpose>
9188 </refnamediv>
9189
9190 <refsynopsisdiv>
9191 <programlisting xml:id="region.outer.extent.frag">
9192 &lt;xsl:param name="region.outer.extent"&gt;0in&lt;/xsl:param&gt;
9193 </programlisting>
9194 </refsynopsisdiv>
9195
9196 <refsection><info><title>Description</title></info>
9197
9198 <para>The region outer extent is the width of the optional
9199 text area next to the outer side (opposite the binding side) of the
9200 body region.  </para>
9201
9202 <para>For double-sided output, this side region
9203 is <literal>fo:region-end</literal> on a odd-numbered page,
9204 and <literal>fo:region-start</literal> on an even-numbered page.</para>
9205
9206 <para>For single-sided output, this side region
9207 is <literal>fo:region-end</literal> for all pages.</para>
9208
9209 <para>This correspondence applies to all languages,
9210 both left-to-right and right-to-left writing modes.</para>
9211
9212 <para>The default value of this parameter is zero.  If you enlarge this extent,
9213 be sure to also enlarge the <parameter>body.margin.outer</parameter>
9214 parameter to make room for its content, otherwise any text in
9215 the side region may overlap with the body text.</para>
9216
9217 <para>See also
9218 <parameter>region.inner.extent</parameter>,
9219 <parameter>body.margin.inner</parameter>,
9220 <parameter>body.margin.outer</parameter>,
9221 <parameter>side.region.precedence</parameter>.
9222 </para>
9223 </refsection>
9224 </refentry>
9225
9226 <refentry version="5.0" xml:id="default.units">
9227 <refmeta>
9228 <refentrytitle>default.units</refentrytitle>
9229 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
9230 <refmiscinfo class="other" otherclass="value">cm</refmiscinfo>
9231 <refmiscinfo class="other" otherclass="value">mm</refmiscinfo>
9232 <refmiscinfo class="other" otherclass="value">in</refmiscinfo>
9233 <refmiscinfo class="other" otherclass="value">pt</refmiscinfo>
9234 <refmiscinfo class="other" otherclass="value">pc</refmiscinfo>
9235 <refmiscinfo class="other" otherclass="value">px</refmiscinfo>
9236 <refmiscinfo class="other" otherclass="value">em</refmiscinfo>
9237 </refmeta>
9238 <refnamediv>
9239 <refname>default.units</refname>
9240 <refpurpose>Default units for an unqualified dimension</refpurpose>
9241 </refnamediv>
9242
9243 <refsynopsisdiv>
9244 <programlisting xml:id="default.units.frag">
9245 &lt;xsl:param name="default.units"&gt;pt&lt;/xsl:param&gt;
9246 </programlisting>
9247 </refsynopsisdiv>
9248
9249 <refsection><info><title>Description</title></info>
9250
9251 <para>If an unqualified dimension is encountered (for example, in a
9252 graphic width), the <parameter>default.units</parameter> will be used for the
9253 units. Unqualified dimensions are not allowed in XSL Formatting Objects.
9254 </para>
9255
9256 </refsection>
9257 </refentry>
9258
9259 <refentry version="5.0" xml:id="normal.para.spacing">
9260 <refmeta>
9261 <refentrytitle>normal.para.spacing</refentrytitle>
9262 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9263 </refmeta>
9264 <refnamediv>
9265 <refname>normal.para.spacing</refname>
9266 <refpurpose>What space do you want between normal paragraphs</refpurpose>
9267 </refnamediv>
9268
9269 <refsynopsisdiv>
9270 <programlisting xml:id="normal.para.spacing.frag">&lt;xsl:attribute-set name="normal.para.spacing"&gt;
9271   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
9272   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
9273   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
9274 &lt;/xsl:attribute-set&gt;</programlisting>
9275 </refsynopsisdiv>
9276 <refsection><info><title>Description</title></info>
9277 <para>Specify the spacing required between normal paragraphs as well as
9278 the following block-level elements:
9279 </para>
9280 <literallayout>ackno
9281 acknowledgements
9282 cmdsynopsis
9283 glosslist
9284 sidebar
9285 simpara
9286 simplelist
9287 </literallayout>
9288 <para>To customize the spacing, you need to reset all three attributes.</para>
9289
9290 <para>To specify properties on just <tag>para</tag> elements without
9291 affecting these other elements,
9292 use the
9293 <link linkend="para.properties">para.properties</link>
9294 attribute-set. </para>
9295 </refsection>
9296 </refentry>
9297
9298 <refentry version="5.0" xml:id="para.properties">
9299 <refmeta>
9300 <refentrytitle>para.properties</refentrytitle>
9301 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9302 </refmeta>
9303 <refnamediv>
9304 <refname>para.properties</refname>
9305 <refpurpose>Properties to apply to para elements</refpurpose>
9306 </refnamediv>
9307
9308 <refsynopsisdiv>
9309 <programlisting xml:id="para.properties.frag">&lt;xsl:attribute-set name="para.properties" use-attribute-sets="normal.para.spacing"&gt;
9310 &lt;/xsl:attribute-set&gt;</programlisting>
9311 </refsynopsisdiv>
9312 <refsection><info><title>Description</title></info>
9313 <para>Specify properties to apply to the fo:block of a para element,
9314 such as <literal>text-indent</literal>.
9315 Although the default attribute-set is empty, it uses the attribute-set
9316 named <literal>normal.para.spacing</literal> to add vertical space before
9317 each para. The <literal>para.properties</literal> attribute-set can override those
9318 spacing properties for para only.</para>
9319 <para>See also
9320 <link linkend="normal.para.spacing">normal.para.spacing</link>.
9321 </para>
9322 </refsection>
9323 </refentry>
9324
9325 <refentry version="5.0" xml:id="body.font.master">
9326 <refmeta>
9327 <refentrytitle>body.font.master</refentrytitle>
9328   <refmiscinfo class="other" otherclass="datatype">number</refmiscinfo>
9329 </refmeta>
9330 <refnamediv>
9331 <refname>body.font.master</refname>
9332 <refpurpose>Specifies the default point size for body text</refpurpose>
9333 </refnamediv>
9334
9335 <refsynopsisdiv>
9336 <programlisting xml:id="body.font.master.frag">
9337 &lt;xsl:param name="body.font.master"&gt;10&lt;/xsl:param&gt;
9338 </programlisting>
9339 </refsynopsisdiv>
9340
9341 <refsection><info><title>Description</title></info>
9342
9343 <para>The body font size is specified in two parameters
9344 (<parameter>body.font.master</parameter> and <parameter>body.font.size</parameter>)
9345 so that math can be performed on the font size by XSLT.
9346 </para>
9347
9348 </refsection>
9349 </refentry>
9350
9351 <refentry version="5.0" xml:id="body.font.size">
9352 <refmeta>
9353 <refentrytitle>body.font.size</refentrytitle>
9354 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9355 </refmeta>
9356 <refnamediv>
9357 <refname>body.font.size</refname>
9358 <refpurpose>Specifies the default font size for body text</refpurpose>
9359 </refnamediv>
9360
9361 <refsynopsisdiv>
9362 <programlisting xml:id="body.font.size.frag">
9363 &lt;xsl:param name="body.font.size"&gt;
9364  &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;&lt;xsl:text&gt;pt&lt;/xsl:text&gt;
9365 &lt;/xsl:param&gt;</programlisting>
9366 </refsynopsisdiv>
9367
9368 <refsection><info><title>Description</title></info>
9369
9370 <para>The body font size is specified in two parameters
9371 (<parameter>body.font.master</parameter> and <parameter>body.font.size</parameter>)
9372 so that math can be performed on the font size by XSLT.
9373 </para>
9374
9375 </refsection>
9376 </refentry>
9377
9378 <refentry version="5.0" xml:id="footnote.font.size">
9379 <refmeta>
9380 <refentrytitle>footnote.font.size</refentrytitle>
9381 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9382 </refmeta>
9383 <refnamediv>
9384 <refname>footnote.font.size</refname>
9385 <refpurpose>The font size for footnotes</refpurpose>
9386 </refnamediv>
9387
9388 <refsynopsisdiv>
9389 <programlisting xml:id="footnote.font.size.frag">&lt;xsl:param name="footnote.font.size"&gt;
9390  &lt;xsl:value-of select="$body.font.master * 0.8"&gt;&lt;/xsl:value-of&gt;&lt;xsl:text&gt;pt&lt;/xsl:text&gt;
9391 &lt;/xsl:param&gt;</programlisting>
9392 </refsynopsisdiv>
9393
9394 <refsection><info><title>Description</title></info>
9395
9396 <para>The footnote font size is used for...footnotes!
9397 </para>
9398
9399 </refsection>
9400 </refentry>
9401
9402 <refentry version="5.0" xml:id="title.margin.left">
9403 <refmeta>
9404 <refentrytitle>title.margin.left</refentrytitle>
9405 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9406 </refmeta>
9407 <refnamediv>
9408 <refname>title.margin.left</refname>
9409 <refpurpose>Adjust the left margin for titles</refpurpose>
9410 </refnamediv>
9411
9412 <refsynopsisdiv>
9413 <programlisting xml:id="title.margin.left.frag">
9414 &lt;xsl:param name="title.margin.left"&gt;
9415   &lt;xsl:choose&gt;
9416     &lt;xsl:when test="$fop.extensions != 0"&gt;-4pc&lt;/xsl:when&gt;
9417     &lt;xsl:when test="$passivetex.extensions != 0"&gt;0pt&lt;/xsl:when&gt;
9418     &lt;xsl:otherwise&gt;0pt&lt;/xsl:otherwise&gt;
9419   &lt;/xsl:choose&gt;
9420 &lt;/xsl:param&gt;
9421 </programlisting>
9422 </refsynopsisdiv>
9423
9424 <refsection><info><title>Description</title></info>
9425
9426 <para>This parameter provides
9427 the means of adjusting the left margin for titles
9428 when the XSL-FO processor being used is
9429 an old version of FOP (0.25 and earlier).
9430 It is only useful when the <parameter>fop.extensions</parameter>
9431 is nonzero.</para>
9432
9433 <para>The left margin of the body region
9434 is calculated to include this space,
9435 and titles are outdented to the left outside
9436 the body region by this amount,
9437 effectively leaving titles at the intended left margin
9438 and the body text indented.
9439 Currently this method is only used for old FOP because
9440 it cannot properly use the <parameter>body.start.indent</parameter>
9441 parameter.
9442 </para>
9443 <para>
9444 The default value when the <parameter>fop.extensions</parameter>
9445 parameter is nonzero is -4pc, which means the
9446 body text is indented 4 picas relative to
9447 the titles.
9448 The default value when the <parameter>fop.extensions</parameter>
9449 parameter equals zero is 0pt, and
9450 the body indent should instead be specified
9451 using the <parameter>body.start.indent</parameter>
9452 parameter.
9453 </para>
9454 <para>
9455 If you set the value to zero, be sure to still include
9456 a unit indicator such as <literal>0pt</literal>, or
9457 the FO processor will report errors.
9458 </para>
9459
9460 </refsection>
9461 </refentry>
9462
9463 <refentry version="5.0" xml:id="draft.mode">
9464 <refmeta>
9465 <refentrytitle>draft.mode</refentrytitle>
9466 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
9467 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>
9468 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
9469 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>
9470 </refmeta>
9471 <refnamediv>
9472 <refname>draft.mode</refname>
9473 <refpurpose>Select draft mode</refpurpose>
9474 </refnamediv>
9475
9476 <refsynopsisdiv>
9477 <programlisting xml:id="draft.mode.frag">
9478 &lt;xsl:param name="draft.mode"&gt;no&lt;/xsl:param&gt;
9479 </programlisting>
9480 </refsynopsisdiv>
9481
9482 <refsection><info><title>Description</title></info>
9483
9484 <para>Selects draft mode. If <parameter>draft.mode</parameter> is
9485 <quote><literal>yes</literal></quote>, the entire document will be treated
9486 as a draft. If it is <quote><literal>no</literal></quote>, the entire document
9487 will be treated as a final copy. If it is <quote><literal>maybe</literal></quote>,
9488 individual sections will be treated as draft or final independently, depending
9489 on how their <literal>status</literal> attribute is set.
9490 </para>
9491
9492 </refsection>
9493 </refentry>
9494
9495 <refentry version="5.0" xml:id="draft.watermark.image">
9496 <refmeta>
9497 <refentrytitle>draft.watermark.image</refentrytitle>
9498 <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo>
9499 </refmeta>
9500 <refnamediv>
9501 <refname>draft.watermark.image</refname>
9502 <refpurpose>The URI of the image to be used for draft watermarks</refpurpose>
9503 </refnamediv>
9504
9505 <refsynopsisdiv>
9506 <programlisting xml:id="draft.watermark.image.frag">
9507 &lt;xsl:param name="draft.watermark.image"&gt;images/draft.png&lt;/xsl:param&gt;
9508 </programlisting>
9509 </refsynopsisdiv>
9510
9511 <refsection><info><title>Description</title></info>
9512
9513 <para>The image to be used for draft watermarks.</para>
9514
9515 </refsection>
9516 </refentry>
9517
9518 <refentry version="5.0" xml:id="headers.on.blank.pages">
9519 <refmeta>
9520 <refentrytitle>headers.on.blank.pages</refentrytitle>
9521 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
9522 </refmeta>
9523 <refnamediv>
9524 <refname>headers.on.blank.pages</refname>
9525 <refpurpose>Put headers on blank pages?</refpurpose>
9526 </refnamediv>
9527
9528 <refsynopsisdiv>
9529 <programlisting xml:id="headers.on.blank.pages.frag">
9530 &lt;xsl:param name="headers.on.blank.pages" select="1"&gt;&lt;/xsl:param&gt;
9531 </programlisting>
9532 </refsynopsisdiv>
9533
9534 <refsection><info><title>Description</title></info>
9535
9536 <para>If non-zero, headers will be placed on blank pages.</para>
9537
9538 </refsection>
9539 </refentry>
9540
9541 <refentry version="5.0" xml:id="footers.on.blank.pages">
9542 <refmeta>
9543 <refentrytitle>footers.on.blank.pages</refentrytitle>
9544 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
9545 </refmeta>
9546 <refnamediv>
9547 <refname>footers.on.blank.pages</refname>
9548 <refpurpose>Put footers on blank pages?</refpurpose>
9549 </refnamediv>
9550
9551 <refsynopsisdiv>
9552 <programlisting xml:id="footers.on.blank.pages.frag">
9553 &lt;xsl:param name="footers.on.blank.pages" select="1"&gt;&lt;/xsl:param&gt;
9554 </programlisting>
9555 </refsynopsisdiv>
9556
9557 <refsection><info><title>Description</title></info>
9558
9559 <para>If non-zero, footers will be placed on blank pages.</para>
9560
9561 </refsection>
9562 </refentry>
9563
9564 <refentry version="5.0" xml:id="header.rule">
9565 <refmeta>
9566 <refentrytitle>header.rule</refentrytitle>
9567 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
9568 </refmeta>
9569 <refnamediv>
9570 <refname>header.rule</refname>
9571 <refpurpose>Rule under headers?</refpurpose>
9572 </refnamediv>
9573
9574 <refsynopsisdiv>
9575 <programlisting xml:id="header.rule.frag">
9576 &lt;xsl:param name="header.rule" select="1"&gt;&lt;/xsl:param&gt;
9577 </programlisting>
9578 </refsynopsisdiv>
9579
9580 <refsection><info><title>Description</title></info>
9581
9582 <para>If non-zero, a rule will be drawn below the page headers.</para>
9583
9584 </refsection>
9585 </refentry>
9586
9587 <refentry version="5.0" xml:id="footer.rule">
9588 <refmeta>
9589 <refentrytitle>footer.rule</refentrytitle>
9590 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
9591 </refmeta>
9592 <refnamediv>
9593 <refname>footer.rule</refname>
9594 <refpurpose>Rule over footers?</refpurpose>
9595 </refnamediv>
9596
9597 <refsynopsisdiv>
9598 <programlisting xml:id="footer.rule.frag">
9599 &lt;xsl:param name="footer.rule" select="1"&gt;&lt;/xsl:param&gt;
9600 </programlisting>
9601 </refsynopsisdiv>
9602
9603 <refsection><info><title>Description</title></info>
9604
9605 <para>If non-zero, a rule will be drawn above the page footers.</para>
9606
9607 </refsection>
9608 </refentry>
9609
9610 <refentry version="5.0" xml:id="header.column.widths">
9611 <refmeta>
9612 <refentrytitle>header.column.widths</refentrytitle>
9613 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
9614 </refmeta>
9615 <refnamediv>
9616 <refname>header.column.widths</refname>
9617 <refpurpose>Specify relative widths of header areas</refpurpose>
9618 </refnamediv>
9619
9620 <refsynopsisdiv><programlisting xml:id="header.column.widths.frag">
9621 &lt;xsl:param name="header.column.widths"&gt;1 1 1&lt;/xsl:param&gt;
9622 </programlisting></refsynopsisdiv>
9623
9624 <refsection><info><title>Description</title></info>
9625
9626 <para>Page headers in print output use a three column table
9627 to position text at the left, center, and right side of
9628 the header on the page.
9629 This parameter lets you specify the relative sizes of the
9630 three columns.  The default value is
9631 "1 1 1".</para>
9632
9633 <para>The parameter value must be three numbers, separated
9634 by white space. The first number represents the relative
9635 width of the inside header for
9636 double-sided output.  The second number is the relative
9637 width of the center header.  The third number is the
9638 relative width of the outside header for
9639 double-sided output.
9640 </para>
9641 <para>For single-sided output, the first number is the
9642 relative width of left header for left-to-right
9643 text direction, or the right header for right-to-left
9644 text direction.
9645 The third number is the
9646 relative width of right header for left-to-right
9647 text direction, or the left header for right-to-left
9648 text direction.</para>
9649
9650 <para>The numbers are used to specify the column widths
9651 for the table that makes up the header area.
9652 In the FO output, this looks like:
9653 </para>
9654
9655 <programlisting>
9656 &lt;fo:table-column column-number="1"
9657     column-width="proportional-column-width(1)"/&gt;
9658 </programlisting>
9659
9660 <para>
9661 The <literal>proportional-column-width()</literal>
9662 function computes a column width by dividing its
9663 argument by the total of the arguments for all the columns, and
9664 then multiplying the result by the width of the whole table
9665 (assuming all the column specs use the function).
9666 Its argument can be any positive integer or floating point number.
9667 Zero is an acceptable value, although some FO processors
9668 may warn about it, in which case using a very small number might
9669 be more satisfactory.
9670 </para>
9671
9672 <para>For example, the value "1 2 1" means the center
9673 header should have twice the width of the other areas.
9674 A value of "0 0 1" means the entire header area
9675 is reserved for the right (or outside) header text.
9676 Note that to keep the center area centered on
9677 the page, the left and right values must be
9678 the same. A specification like "1 2 3" means the
9679 center area is no longer centered on the page
9680 since the right area is three times the width of the left area.
9681 </para>
9682
9683 </refsection>
9684 </refentry>
9685
9686 <refentry version="5.0" xml:id="footer.column.widths">
9687 <refmeta>
9688 <refentrytitle>footer.column.widths</refentrytitle>
9689 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
9690 </refmeta>
9691 <refnamediv>
9692 <refname>footer.column.widths</refname>
9693 <refpurpose>Specify relative widths of footer areas</refpurpose>
9694 </refnamediv>
9695
9696 <refsynopsisdiv><programlisting xml:id="footer.column.widths.frag">
9697 &lt;xsl:param name="footer.column.widths"&gt;1 1 1&lt;/xsl:param&gt;
9698 </programlisting></refsynopsisdiv>
9699
9700 <refsection><info><title>Description</title></info>
9701
9702 <para>Page footers in print output use a three column table
9703 to position text at the left, center, and right side of
9704 the footer on the page.
9705 This parameter lets you specify the relative sizes of the
9706 three columns.  The default value is
9707 "1 1 1".</para>
9708
9709 <para>The parameter value must be three numbers, separated
9710 by white space. The first number represents the relative
9711 width of the inside footer for
9712 double-sided output.  The second number is the relative
9713 width of the center footer.  The third number is the
9714 relative width of the outside footer for
9715 double-sided output.
9716 </para>
9717 <para>For single-sided output, the first number is the
9718 relative width of left footer for left-to-right
9719 text direction, or the right footer for right-to-left
9720 text direction.
9721 The third number is the
9722 relative width of right footer for left-to-right
9723 text direction, or the left footer for right-to-left
9724 text direction.</para>
9725
9726 <para>The numbers are used to specify the column widths
9727 for the table that makes up the footer area.
9728 In the FO output, this looks like:
9729 </para>
9730
9731 <programlisting>
9732 &lt;fo:table-column column-number="1"
9733     column-width="proportional-column-width(1)"/&gt;
9734 </programlisting>
9735
9736 <para>
9737 The <literal>proportional-column-width()</literal>
9738 function computes a column width by dividing its
9739 argument by the total of the arguments for all the columns, and
9740 then multiplying the result by the width of the whole table
9741 (assuming all the column specs use the function).
9742 Its argument can be any positive integer or floating point number.
9743 Zero is an acceptable value, although some FO processors
9744 may warn about it, in which case using a very small number might
9745 be more satisfactory.
9746 </para>
9747
9748 <para>For example, the value "1 2 1" means the center
9749 footer should have twice the width of the other areas.
9750 A value of "0 0 1" means the entire footer area
9751 is reserved for the right (or outside) footer text.
9752 Note that to keep the center area centered on
9753 the page, the left and right values must be
9754 the same. A specification like "1 2 3" means the
9755 center area is no longer centered on the page
9756 since the right area is three times the width of the left area.
9757 </para>
9758
9759 </refsection>
9760 </refentry>
9761
9762 <refentry version="5.0" xml:id="header.table.properties">
9763 <refmeta>
9764 <refentrytitle>header.table.properties</refentrytitle>
9765 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9766 </refmeta>
9767 <refnamediv>
9768 <refname>header.table.properties</refname>
9769 <refpurpose>Apply properties to the header layout table</refpurpose>
9770 </refnamediv>
9771
9772 <refsynopsisdiv>
9773 <programlisting xml:id="header.table.properties.frag">
9774 &lt;xsl:attribute-set name="header.table.properties"&gt;
9775   &lt;xsl:attribute name="table-layout"&gt;fixed&lt;/xsl:attribute&gt;
9776   &lt;xsl:attribute name="width"&gt;100%&lt;/xsl:attribute&gt;
9777 &lt;/xsl:attribute-set&gt;
9778 </programlisting>
9779 </refsynopsisdiv>
9780
9781 <refsection><info><title>Description</title></info>
9782
9783 <para>Properties applied to the table that lays out the page header.</para>
9784
9785 </refsection>
9786 </refentry>
9787
9788 <refentry version="5.0" xml:id="header.table.height">
9789 <refmeta>
9790 <refentrytitle>header.table.height</refentrytitle>
9791 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9792 </refmeta>
9793 <refnamediv>
9794 <refname>header.table.height</refname>
9795 <refpurpose>Specify the minimum height of the table containing the running page headers</refpurpose>
9796 </refnamediv>
9797
9798 <refsynopsisdiv><programlisting xml:id="header.table.height.frag">
9799 &lt;xsl:param name="header.table.height"&gt;14pt&lt;/xsl:param&gt;
9800 </programlisting></refsynopsisdiv>
9801
9802 <refsection><info><title>Description</title></info>
9803
9804 <para>Page headers in print output use a three column table
9805 to position text at the left, center, and right side of
9806 the header on the page.
9807 This parameter lets you specify the minimum height
9808 of the single row in the table.
9809 Since this specifies only the minimum height,
9810 the table should automatically grow to fit taller content.
9811 The default value is "14pt".</para>
9812
9813 </refsection>
9814 </refentry>
9815
9816 <refentry version="5.0" xml:id="footer.table.properties">
9817 <refmeta>
9818 <refentrytitle>footer.table.properties</refentrytitle>
9819 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9820 </refmeta>
9821 <refnamediv>
9822 <refname>footer.table.properties</refname>
9823 <refpurpose>Apply properties to the footer layout table</refpurpose>
9824 </refnamediv>
9825
9826 <refsynopsisdiv>
9827 <programlisting xml:id="footer.table.properties.frag">
9828 &lt;xsl:attribute-set name="footer.table.properties"&gt;
9829   &lt;xsl:attribute name="table-layout"&gt;fixed&lt;/xsl:attribute&gt;
9830   &lt;xsl:attribute name="width"&gt;100%&lt;/xsl:attribute&gt;
9831 &lt;/xsl:attribute-set&gt;
9832 </programlisting>
9833 </refsynopsisdiv>
9834
9835 <refsection><info><title>Description</title></info>
9836
9837 <para>Properties applied to the table that lays out the page footer.</para>
9838
9839 </refsection>
9840 </refentry>
9841
9842 <refentry version="5.0" xml:id="footer.table.height">
9843 <refmeta>
9844 <refentrytitle>footer.table.height</refentrytitle>
9845 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9846 </refmeta>
9847 <refnamediv>
9848 <refname>footer.table.height</refname>
9849 <refpurpose>Specify the minimum height of the table containing the running page footers</refpurpose>
9850 </refnamediv>
9851
9852 <refsynopsisdiv><programlisting xml:id="footer.table.height.frag">
9853 &lt;xsl:param name="footer.table.height"&gt;14pt&lt;/xsl:param&gt;
9854 </programlisting></refsynopsisdiv>
9855
9856 <refsection><info><title>Description</title></info>
9857
9858 <para>Page footers in print output use a three column table
9859 to position text at the left, center, and right side of
9860 the footer on the page.
9861 This parameter lets you specify the minimum height
9862 of the single row in the table.
9863 Since this specifies only the minimum height,
9864 the table should automatically grow to fit taller content.
9865 The default value is "14pt".</para>
9866
9867 </refsection>
9868 </refentry>
9869
9870 <refentry version="5.0" xml:id="header.content.properties">
9871 <refmeta>
9872 <refentrytitle>header.content.properties</refentrytitle>
9873 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9874 </refmeta>
9875 <refnamediv>
9876 <refname>header.content.properties</refname>
9877 <refpurpose>Properties of page header content</refpurpose>
9878 </refnamediv>
9879
9880 <refsynopsisdiv>
9881 <programlisting xml:id="header.content.properties.frag">
9882 &lt;xsl:attribute-set name="header.content.properties"&gt;
9883   &lt;xsl:attribute name="font-family"&gt;
9884     &lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;
9885   &lt;/xsl:attribute&gt;
9886   &lt;xsl:attribute name="margin-left"&gt;
9887     &lt;xsl:value-of select="$title.margin.left"&gt;&lt;/xsl:value-of&gt;
9888   &lt;/xsl:attribute&gt;
9889 &lt;/xsl:attribute-set&gt;
9890 </programlisting>
9891 </refsynopsisdiv>
9892
9893 <refsection><info><title>Description</title></info>
9894
9895 <para>Properties of page header content.</para>
9896
9897 </refsection>
9898 </refentry>
9899
9900 <refentry version="5.0" xml:id="footer.content.properties">
9901 <refmeta>
9902 <refentrytitle>footer.content.properties</refentrytitle>
9903 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9904 </refmeta>
9905 <refnamediv>
9906 <refname>footer.content.properties</refname>
9907 <refpurpose>Properties of page footer content</refpurpose>
9908 </refnamediv>
9909
9910 <refsynopsisdiv>
9911 <programlisting xml:id="footer.content.properties.frag">
9912 &lt;xsl:attribute-set name="footer.content.properties"&gt;
9913   &lt;xsl:attribute name="font-family"&gt;
9914     &lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;
9915   &lt;/xsl:attribute&gt;
9916   &lt;xsl:attribute name="margin-left"&gt;
9917     &lt;xsl:value-of select="$title.margin.left"&gt;&lt;/xsl:value-of&gt;
9918   &lt;/xsl:attribute&gt;
9919 &lt;/xsl:attribute-set&gt;
9920 </programlisting>
9921 </refsynopsisdiv>
9922
9923 <refsection><info><title>Description</title></info>
9924
9925 <para>Properties of page footer content.</para>
9926
9927 </refsection>
9928 </refentry>
9929
9930 <refentry version="5.0" xml:id="marker.section.level">
9931 <refmeta>
9932 <refentrytitle>marker.section.level</refentrytitle>
9933 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
9934 </refmeta>
9935 <refnamediv>
9936 <refname>marker.section.level</refname>
9937 <refpurpose>Control depth of sections shown in running headers or footers</refpurpose>
9938 </refnamediv>
9939
9940 <refsynopsisdiv>
9941 <programlisting xml:id="marker.section.level.frag">
9942 &lt;xsl:param name="marker.section.level"&gt;2&lt;/xsl:param&gt;
9943 </programlisting>
9944 </refsynopsisdiv>
9945
9946 <refsection><info><title>Description</title></info>
9947
9948 <para>The <parameter>marker.section.level</parameter> parameter
9949 controls the depth of section levels that may be displayed
9950 in running headers and footers.  For example, if the value
9951 is 2 (the default), then titles from <tag>sect1</tag> and
9952 <tag>sect2</tag> or equivalent <tag>section</tag>
9953 elements are candidates for use in running headers and
9954 footers.
9955 </para>
9956 <para>Each candidate title is marked in the FO output with a
9957 <tag>&lt;fo:marker marker-class-name="section.head.marker"&gt;</tag>
9958 element.
9959 </para>
9960 <para>In order for such titles to appear in headers
9961 or footers, the <literal>header.content</literal>
9962 or <literal>footer.content</literal> template
9963 must be customized to retrieve the marker using
9964 an output element such as:
9965 </para>
9966 <programlisting>
9967 &lt;fo:retrieve-marker retrieve-class-name="section.head.marker"
9968                        retrieve-position="first-including-carryover"
9969                        retrieve-boundary="page-sequence"/&gt;
9970 </programlisting>
9971
9972
9973 </refsection>
9974 </refentry>
9975
9976 <refentry version="5.0" xml:id="side.region.precedence">
9977 <refmeta>
9978 <refentrytitle>side.region.precedence</refentrytitle>
9979 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
9980 </refmeta>
9981 <refnamediv>
9982 <refname>side.region.precedence</refname>
9983 <refpurpose>Determines side region page layout precedence</refpurpose>
9984 </refnamediv>
9985 <refsynopsisdiv> <programlisting xml:id="side.region.precedence.frag">
9986 &lt;xsl:param name="side.region.precedence"&gt;false&lt;/xsl:param&gt;
9987 </programlisting>
9988 </refsynopsisdiv>
9989 <refsection><info><title>Description</title></info>
9990
9991 <para>If optional side regions on a page
9992 are established using parameters such as
9993 <parameter>body.margin.inner</parameter>,
9994 <parameter>region.inner.extent</parameter>, etc., then this
9995 parameter determines what happens at the corners where the
9996 side regions meet the header and footer regions.</para>
9997
9998 <para>If the value of this parameter is <literal>true</literal>,
9999 then the side regions have precedence and extend higher
10000 and lower, while the header and footer regions are narrower
10001 and fit inside the side regions.</para>
10002
10003 <para>If the value of this parameter is <literal>false</literal>
10004 (the default value), then the header and footer regions
10005 have precedence and extend over and below the side regions.
10006 Any value other than <literal>true</literal> or
10007 <literal>false</literal> is taken to be <literal>false</literal>.</para>
10008
10009 <para>If you need to set precedence separately for
10010 individual regions, then you can set four
10011 parameters that are normally internal to the stylesheet.
10012 These four parameters are normally set based
10013 on the value from <parameter>side.region.precedence</parameter>:</para>
10014
10015 <programlisting>region.before.precedence
10016 region.after.precedence
10017 region.start.precedence
10018 region.end.precedence</programlisting>
10019
10020 <para>See also
10021 <parameter>region.inner.extent</parameter>,
10022 <parameter>region.outer.extent</parameter>,
10023 <parameter>body.margin.inner</parameter>,
10024 <parameter>body.margin.outer</parameter>.
10025 </para>
10026 </refsection> </refentry>
10027
10028 <refentry version="5.0" xml:id="region.inner.properties">
10029 <refmeta>
10030 <refentrytitle>region.inner.properties</refentrytitle>
10031 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10032 </refmeta>
10033 <refnamediv>
10034 <refname>region.inner.properties</refname>
10035 <refpurpose>Properties of running inner side region</refpurpose>
10036 </refnamediv>
10037
10038 <refsynopsisdiv>
10039 <programlisting xml:id="region.inner.properties.frag">
10040 &lt;xsl:attribute-set name="region.inner.properties"&gt;
10041   &lt;xsl:attribute name="border-width"&gt;0&lt;/xsl:attribute&gt;
10042   &lt;xsl:attribute name="padding"&gt;0&lt;/xsl:attribute&gt;
10043   &lt;xsl:attribute name="reference-orientation"&gt;90&lt;/xsl:attribute&gt;
10044 &lt;/xsl:attribute-set&gt;
10045 </programlisting>
10046 </refsynopsisdiv>
10047
10048 <refsection><info><title>Description</title></info>
10049
10050 <para>The FO stylesheet supports optional side regions
10051 similar to the header and footer regions.
10052 Any attributes declared in this attribute-set
10053 are applied to the region element in the page master
10054 on the inner side (binding side) of the page.
10055 This corresponds to <literal>&lt;fo:regin-start&gt;</literal>
10056 on odd-numbered pages and <literal>&lt;fo:region-end&gt;</literal>
10057 on even-numbered pages.
10058 For single-sided output, it always corresponds to
10059 <literal>&lt;fo:regin-start&gt;</literal>.</para>
10060
10061 <para>You can customize the template named
10062 <literal>inner.region.content</literal> to specify
10063 the content of the inner side region.</para>
10064
10065 <para>See also
10066 <parameter>inner.region.content.properties</parameter>,
10067 <parameter>page.margin.inner</parameter>,
10068 <parameter>body.margin.inner</parameter>,
10069 and the corresponding <literal>outer</literal>
10070 parameters.</para>
10071
10072 </refsection>
10073 </refentry>
10074
10075 <refentry version="5.0" xml:id="region.outer.properties">
10076 <refmeta>
10077 <refentrytitle>region.outer.properties</refentrytitle>
10078 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10079 </refmeta>
10080 <refnamediv>
10081 <refname>region.outer.properties</refname>
10082 <refpurpose>Properties of running outer side region</refpurpose>
10083 </refnamediv>
10084
10085 <refsynopsisdiv>
10086 <programlisting xml:id="region.outer.properties.frag">
10087 &lt;xsl:attribute-set name="region.outer.properties"&gt;
10088   &lt;xsl:attribute name="border-width"&gt;0&lt;/xsl:attribute&gt;
10089   &lt;xsl:attribute name="padding"&gt;0&lt;/xsl:attribute&gt;
10090   &lt;xsl:attribute name="reference-orientation"&gt;90&lt;/xsl:attribute&gt;
10091 &lt;/xsl:attribute-set&gt;
10092 </programlisting>
10093 </refsynopsisdiv>
10094
10095 <refsection><info><title>Description</title></info>
10096
10097 <para>The FO stylesheet supports optional side regions
10098 similar to the header and footer regions.
10099 Any attributes declared in this attribute-set
10100 are applied to the region element in the page master
10101 on the outer side (opposite the binding side) of the page.
10102 This corresponds to <literal>&lt;fo:regin-start&gt;</literal>
10103 on odd-numbered pages and <literal>&lt;fo:region-end&gt;</literal>
10104 on even-numbered pages.
10105 For single-sided output, it always corresponds to
10106 <literal>&lt;fo:regin-start&gt;</literal>.</para>
10107
10108 <para>You can customize the template named
10109 <literal>outer.region.content</literal> to specify
10110 the content of the outer side region.</para>
10111
10112 <para>See also
10113 <parameter>outer.region.content.properties</parameter>,
10114 <parameter>page.margin.outer</parameter>,
10115 <parameter>body.margin.outer</parameter>,
10116 and the corresponding <literal>inner</literal>
10117 parameters.</para>
10118
10119 </refsection>
10120 </refentry>
10121
10122 <refentry version="5.0" xml:id="inner.region.content.properties">
10123 <refmeta>
10124 <refentrytitle>inner.region.content.properties</refentrytitle>
10125 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10126 </refmeta>
10127 <refnamediv>
10128 <refname>inner.region.content.properties</refname>
10129 <refpurpose>Properties of running inner side content</refpurpose>
10130 </refnamediv>
10131
10132 <refsynopsisdiv>
10133 <programlisting xml:id="inner.region.content.properties.frag">
10134 &lt;xsl:attribute-set name="inner.region.content.properties"&gt;
10135 &lt;/xsl:attribute-set&gt;
10136 </programlisting>
10137 </refsynopsisdiv>
10138
10139 <refsection><info><title>Description</title></info>
10140
10141 <para>The FO stylesheet supports optional side regions
10142 similar to the header and footer regions.
10143 Any attributes declared in this attribute-set
10144 are applied to the fo:block in the side region
10145 on the inner side (binding side) of the page.
10146 This corresponds to the <literal>start</literal>
10147 region on odd-numbered pages and the <literal>end</literal>
10148 region on even-numbered pages.
10149 For single-sided output, it always corresponds to
10150 the <literal>start</literal> region.</para>
10151
10152 <para>You can customize the template named
10153 <literal>inner.region.content</literal> to specify
10154 the content of the inner side region.</para>
10155
10156 <para>See also
10157 <parameter>region.inner.properties</parameter>,
10158 <parameter>page.margin.inner</parameter>,
10159 <parameter>body.margin.inner</parameter>,
10160 and the corresponding <literal>outer</literal>
10161 parameters.</para>
10162
10163 </refsection>
10164 </refentry>
10165
10166 <refentry version="5.0" xml:id="outer.region.content.properties">
10167 <refmeta>
10168 <refentrytitle>outer.region.content.properties</refentrytitle>
10169 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10170 </refmeta>
10171 <refnamediv>
10172 <refname>outer.region.content.properties</refname>
10173 <refpurpose>Properties of running outer side content</refpurpose>
10174 </refnamediv>
10175
10176 <refsynopsisdiv>
10177 <programlisting xml:id="outer.region.content.properties.frag">
10178 &lt;xsl:attribute-set name="outer.region.content.properties"&gt;
10179 &lt;/xsl:attribute-set&gt;
10180 </programlisting>
10181 </refsynopsisdiv>
10182
10183 <refsection><info><title>Description</title></info>
10184
10185 <para>The FO stylesheet supports optional side regions
10186 similar to the header and footer regions.
10187 Any attributes declared in this attribute-set
10188 are applied to the fo:block in the side region
10189 on the outer side (opposite the binding side) of the page.
10190 This corresponds to the <literal>start</literal>
10191 region on odd-numbered pages and the <literal>end</literal>
10192 region on even-numbered pages.
10193 For single-sided output, it always corresponds to
10194 the <literal>start</literal> region.</para>
10195
10196 <para>You can customize the template named
10197 <literal>outer.region.content</literal> to specify
10198 the content of the outer side region.</para>
10199
10200 <para>See also
10201 <parameter>region.outer.properties</parameter>,
10202 <parameter>page.margin.outer</parameter>,
10203 <parameter>body.margin.outer</parameter>,
10204 and the corresponding <literal>inner</literal>
10205 parameters.</para>
10206 </refsection>
10207 </refentry>
10208
10209 </reference>
10210 <reference xml:id="fonts"><title>Font Families</title>
10211 <refentry version="5.0" xml:id="body.font.family">
10212 <refmeta>
10213 <refentrytitle>body.font.family</refentrytitle>
10214 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
10215 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>
10216 <refmiscinfo class="other" otherclass="value">serif</refmiscinfo>
10217 <refmiscinfo class="other" otherclass="value">sans-serif</refmiscinfo>
10218 <refmiscinfo class="other" otherclass="value">monospace</refmiscinfo>
10219 </refmeta>
10220 <refnamediv>
10221 <refname>body.font.family</refname>
10222 <refpurpose>The default font family for body text</refpurpose>
10223 </refnamediv>
10224
10225 <refsynopsisdiv>
10226 <programlisting xml:id="body.font.family.frag">
10227 &lt;xsl:param name="body.font.family"&gt;serif&lt;/xsl:param&gt;
10228 </programlisting>
10229 </refsynopsisdiv>
10230
10231 <refsection><info><title>Description</title></info>
10232
10233 <para>The body font family is the default font used for text in the page body.</para>
10234 <para>If more than one font is required, enter the font names,
10235 separated by a comma, e.g.</para>
10236 <literallayout>
10237   &lt;xsl:param name="body.font.family"&gt;Arial, SimSun, serif&lt;/xsl:param&gt;
10238
10239 </literallayout>
10240
10241 </refsection>
10242 </refentry>
10243
10244 <refentry version="5.0" xml:id="dingbat.font.family">
10245 <refmeta>
10246 <refentrytitle>dingbat.font.family</refentrytitle>
10247 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
10248 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>
10249 <refmiscinfo class="other" otherclass="value">serif</refmiscinfo>
10250 <refmiscinfo class="other" otherclass="value">sans-serif</refmiscinfo>
10251 <refmiscinfo class="other" otherclass="value">monospace</refmiscinfo>
10252 </refmeta>
10253 <refnamediv>
10254 <refname>dingbat.font.family</refname>
10255 <refpurpose>The font family for copyright, quotes, and other symbols</refpurpose>
10256 </refnamediv>
10257
10258 <refsynopsisdiv>
10259 <programlisting xml:id="dingbat.font.family.frag">
10260 &lt;xsl:param name="dingbat.font.family"&gt;serif&lt;/xsl:param&gt;
10261 </programlisting>
10262 </refsynopsisdiv>
10263
10264 <refsection><info><title>Description</title></info>
10265
10266 <para>The dingbat font family is used for dingbats. If it is defined
10267 as the empty string, no font change is effected around dingbats.
10268 </para>
10269
10270 </refsection>
10271 </refentry>
10272
10273 <refentry version="5.0" xml:id="monospace.font.family">
10274 <refmeta>
10275 <refentrytitle>monospace.font.family</refentrytitle>
10276 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
10277 </refmeta>
10278 <refnamediv>
10279 <refname>monospace.font.family</refname>
10280 <refpurpose>The default font family for monospace environments</refpurpose>
10281 </refnamediv>
10282
10283 <refsynopsisdiv>
10284 <programlisting xml:id="monospace.font.family.frag">
10285 &lt;xsl:param name="monospace.font.family"&gt;monospace&lt;/xsl:param&gt;
10286 </programlisting>
10287 </refsynopsisdiv>
10288
10289 <refsection><info><title>Description</title></info>
10290
10291 <para>The monospace font family is used for verbatim environments
10292 (program listings, screens, etc.).
10293 </para>
10294 <para>If more than one font is required, enter the font names,
10295 separated by a comma, e.g.</para>
10296 <literallayout>
10297   &lt;xsl:param name="body.font.family"&gt;Arial, SimSun, serif&lt;/xsl:param&gt;
10298
10299 </literallayout>
10300 </refsection>
10301 </refentry>
10302
10303 <refentry version="5.0" xml:id="sans.font.family">
10304 <refmeta>
10305 <refentrytitle>sans.font.family</refentrytitle>
10306 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
10307 </refmeta>
10308 <refnamediv>
10309 <refname>sans.font.family</refname>
10310 <refpurpose>The default sans-serif font family</refpurpose>
10311 </refnamediv>
10312
10313 <refsynopsisdiv>
10314 <programlisting xml:id="sans.font.family.frag">
10315 &lt;xsl:param name="sans.font.family"&gt;sans-serif&lt;/xsl:param&gt;
10316 </programlisting>
10317 </refsynopsisdiv>
10318
10319 <refsection><info><title>Description</title></info>
10320
10321 <para>The default sans-serif font family. At the present, this isn't
10322 actually used by the stylesheets.
10323 </para>
10324
10325 </refsection>
10326 </refentry>
10327
10328 <refentry version="5.0" xml:id="title.font.family">
10329 <refmeta>
10330 <refentrytitle>title.font.family</refentrytitle>
10331 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
10332 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>
10333 <refmiscinfo class="other" otherclass="value">serif</refmiscinfo>
10334 <refmiscinfo class="other" otherclass="value">sans-serif</refmiscinfo>
10335 <refmiscinfo class="other" otherclass="value">monospace</refmiscinfo>
10336 </refmeta>
10337 <refnamediv>
10338 <refname>title.font.family</refname>
10339 <refpurpose>The default font family for titles</refpurpose>
10340 </refnamediv>
10341
10342 <refsynopsisdiv>
10343 <programlisting xml:id="title.font.family.frag">
10344 &lt;xsl:param name="title.font.family"&gt;sans-serif&lt;/xsl:param&gt;
10345 </programlisting>
10346 </refsynopsisdiv>
10347
10348 <refsection><info><title>Description</title></info>
10349
10350 <para>The title font family is used for titles (chapter, section, figure,
10351 etc.)
10352 </para>
10353 <para>If more than one font is required, enter the font names,
10354 separated by a comma, e.g.</para>
10355 <literallayout>
10356   &lt;xsl:param name="body.font.family"&gt;Arial, SimSun, serif&lt;/xsl:param&gt;
10357
10358 </literallayout>
10359 </refsection>
10360 </refentry>
10361
10362 <refentry version="5.0" xml:id="symbol.font.family">
10363 <refmeta>
10364 <refentrytitle>symbol.font.family</refentrytitle>
10365 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
10366 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>
10367 <refmiscinfo class="other" otherclass="value">serif</refmiscinfo>
10368 <refmiscinfo class="other" otherclass="value">sans-serif</refmiscinfo>
10369 <refmiscinfo class="other" otherclass="value">monospace</refmiscinfo>
10370 </refmeta>
10371 <refnamediv>
10372 <refname>symbol.font.family</refname>
10373 <refpurpose>The font families to be searched for symbols outside
10374     of the body font</refpurpose>
10375 </refnamediv>
10376
10377 <refsynopsisdiv>
10378 <programlisting xml:id="symbol.font.family.frag">
10379 &lt;xsl:param name="symbol.font.family"&gt;Symbol,ZapfDingbats&lt;/xsl:param&gt;
10380 </programlisting>
10381 </refsynopsisdiv>
10382
10383 <refsection><info><title>Description</title></info>
10384
10385 <para>A typical body or title font does not contain all
10386 the character glyphs that DocBook supports.  This parameter
10387 specifies additional fonts that should be searched for
10388 special characters not in the normal font.
10389 These symbol font names are automatically appended
10390 to the body or title font family name when fonts
10391 are specified in a
10392 <tag class="attribute">font-family</tag>
10393 property in the FO output.
10394 </para>
10395 <para>The symbol font names should be entered as a
10396 comma-separated list.  The default value is
10397 <literal>Symbol,ZapfDingbats</literal>.
10398 </para>
10399
10400 </refsection>
10401 </refentry>
10402
10403 </reference>
10404 <reference xml:id="propsets"><title>Property Sets</title>
10405 <refentry version="5.0" xml:id="formal.object.properties">
10406 <refmeta>
10407 <refentrytitle>formal.object.properties</refentrytitle>
10408 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10409 </refmeta>
10410 <refnamediv>
10411 <refname>formal.object.properties</refname>
10412 <refpurpose>Properties associated with a formal object such as a figure, or other component that has a title</refpurpose>
10413 </refnamediv>
10414
10415 <refsynopsisdiv>
10416 <programlisting xml:id="formal.object.properties.frag">
10417 &lt;xsl:attribute-set name="formal.object.properties"&gt;
10418   &lt;xsl:attribute name="space-before.minimum"&gt;0.5em&lt;/xsl:attribute&gt;
10419   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
10420   &lt;xsl:attribute name="space-before.maximum"&gt;2em&lt;/xsl:attribute&gt;
10421   &lt;xsl:attribute name="space-after.minimum"&gt;0.5em&lt;/xsl:attribute&gt;
10422   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;
10423   &lt;xsl:attribute name="space-after.maximum"&gt;2em&lt;/xsl:attribute&gt;
10424   &lt;xsl:attribute name="keep-together.within-column"&gt;always&lt;/xsl:attribute&gt;
10425 &lt;/xsl:attribute-set&gt;
10426 </programlisting>
10427 </refsynopsisdiv>
10428
10429 <refsection><info><title>Description</title></info>
10430
10431 <para>The styling for formal objects in docbook. Specify the spacing
10432 before and after the object.</para>
10433
10434 </refsection>
10435 </refentry>
10436
10437 <refentry version="5.0" xml:id="formal.title.properties">
10438 <refmeta>
10439 <refentrytitle>formal.title.properties</refentrytitle>
10440 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10441 </refmeta>
10442 <refnamediv>
10443 <refname>formal.title.properties</refname>
10444 <refpurpose>Style the title element of formal object such as a figure.</refpurpose>
10445 </refnamediv>
10446
10447 <refsynopsisdiv>
10448 <programlisting xml:id="formal.title.properties.frag">
10449 &lt;xsl:attribute-set name="formal.title.properties" use-attribute-sets="normal.para.spacing"&gt;
10450   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
10451   &lt;xsl:attribute name="font-size"&gt;
10452     &lt;xsl:value-of select="$body.font.master * 1.2"&gt;&lt;/xsl:value-of&gt;
10453     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
10454   &lt;/xsl:attribute&gt;
10455   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
10456   &lt;xsl:attribute name="space-after.minimum"&gt;0.4em&lt;/xsl:attribute&gt;
10457   &lt;xsl:attribute name="space-after.optimum"&gt;0.6em&lt;/xsl:attribute&gt;
10458   &lt;xsl:attribute name="space-after.maximum"&gt;0.8em&lt;/xsl:attribute&gt;
10459 &lt;/xsl:attribute-set&gt;
10460 </programlisting>
10461 </refsynopsisdiv>
10462 <refsection><info><title>Description</title></info>
10463 <para>Specify how the title should be styled. Specify the font size and weight of the title of the formal object.</para>
10464 </refsection>
10465 </refentry>
10466
10467 <refentry version="5.0" xml:id="informal.object.properties">
10468 <refmeta>
10469 <refentrytitle>informal.object.properties</refentrytitle>
10470 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10471 </refmeta>
10472 <refnamediv>
10473 <refname>informal.object.properties</refname>
10474 <refpurpose>Properties associated with an informal (untitled) object, such as an informalfigure</refpurpose>
10475 </refnamediv>
10476
10477 <refsynopsisdiv>
10478 <programlisting xml:id="informal.object.properties.frag">&lt;xsl:attribute-set name="informal.object.properties"&gt;
10479   &lt;xsl:attribute name="space-before.minimum"&gt;0.5em&lt;/xsl:attribute&gt;
10480   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
10481   &lt;xsl:attribute name="space-before.maximum"&gt;2em&lt;/xsl:attribute&gt;
10482   &lt;xsl:attribute name="space-after.minimum"&gt;0.5em&lt;/xsl:attribute&gt;
10483   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;
10484   &lt;xsl:attribute name="space-after.maximum"&gt;2em&lt;/xsl:attribute&gt;
10485 &lt;/xsl:attribute-set&gt;</programlisting>
10486 </refsynopsisdiv>
10487 <refsection><info><title>Description</title></info>
10488 <para>The styling for informal objects in docbook. Specify the spacing before and after the object.</para>
10489 </refsection>
10490 </refentry>
10491
10492 <refentry version="5.0" xml:id="monospace.properties">
10493 <refmeta>
10494 <refentrytitle>monospace.properties</refentrytitle>
10495 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10496 </refmeta>
10497 <refnamediv>
10498 <refname>monospace.properties</refname>
10499 <refpurpose>Properties of monospaced content</refpurpose>
10500 </refnamediv>
10501
10502 <refsynopsisdiv>
10503 <programlisting xml:id="monospace.properties.frag">
10504 &lt;xsl:attribute-set name="monospace.properties"&gt;
10505   &lt;xsl:attribute name="font-family"&gt;
10506     &lt;xsl:value-of select="$monospace.font.family"&gt;&lt;/xsl:value-of&gt;
10507   &lt;/xsl:attribute&gt;
10508 &lt;/xsl:attribute-set&gt;
10509 </programlisting>
10510 </refsynopsisdiv>
10511
10512 <refsection><info><title>Description</title></info>
10513
10514 <para>Specifies the font name for monospaced output. This property set
10515 used to set the font-size as well, but that doesn't work very well
10516 when different fonts are used (as they are in titles and paragraphs,
10517 for example).</para>
10518
10519 <para>If you want to set the font-size in a customization layer, it's
10520 probably going to be more appropriate to set font-size-adjust, if your
10521 formatter supports it.</para>
10522
10523 </refsection>
10524 </refentry>
10525
10526 <refentry version="5.0" xml:id="verbatim.properties">
10527 <refmeta>
10528 <refentrytitle>verbatim.properties</refentrytitle>
10529 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10530 </refmeta>
10531 <refnamediv>
10532 <refname>verbatim.properties</refname>
10533 <refpurpose>Properties associated with verbatim text</refpurpose>
10534 </refnamediv>
10535
10536 <refsynopsisdiv>
10537 <programlisting xml:id="verbatim.properties.frag">
10538 &lt;xsl:attribute-set name="verbatim.properties"&gt;
10539   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
10540   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
10541   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
10542   &lt;xsl:attribute name="space-after.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
10543   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;
10544   &lt;xsl:attribute name="space-after.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
10545   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
10546   &lt;xsl:attribute name="wrap-option"&gt;no-wrap&lt;/xsl:attribute&gt;
10547   &lt;xsl:attribute name="white-space-collapse"&gt;false&lt;/xsl:attribute&gt;
10548   &lt;xsl:attribute name="white-space-treatment"&gt;preserve&lt;/xsl:attribute&gt;
10549   &lt;xsl:attribute name="linefeed-treatment"&gt;preserve&lt;/xsl:attribute&gt;
10550   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;
10551 &lt;/xsl:attribute-set&gt;</programlisting>
10552 </refsynopsisdiv>
10553
10554 <refsection><info><title>Description</title></info>
10555 <para>This attribute set is used on all verbatim environments.</para>
10556 </refsection>
10557
10558 </refentry>
10559
10560 <refentry version="5.0" xml:id="monospace.verbatim.properties">
10561 <refmeta>
10562 <refentrytitle>monospace.verbatim.properties</refentrytitle>
10563 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10564 </refmeta>
10565 <refnamediv>
10566 <refname>monospace.verbatim.properties</refname>
10567 <refpurpose>What font and size do you want for monospaced content?</refpurpose>
10568 </refnamediv>
10569
10570 <refsynopsisdiv>
10571 <programlisting xml:id="monospace.verbatim.properties.frag">
10572 &lt;xsl:attribute-set name="monospace.verbatim.properties" use-attribute-sets="verbatim.properties monospace.properties"&gt;
10573   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;
10574   &lt;xsl:attribute name="wrap-option"&gt;no-wrap&lt;/xsl:attribute&gt;
10575 &lt;/xsl:attribute-set&gt;
10576 </programlisting>
10577 </refsynopsisdiv>
10578 <refsection><info><title>Description</title></info>
10579 <para>Specify the font name and size you want for monospaced output</para>
10580 </refsection>
10581 </refentry>
10582
10583 <refentry version="5.0" xml:id="sidebar.properties">
10584 <refmeta>
10585 <refentrytitle>sidebar.properties</refentrytitle>
10586 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10587 </refmeta>
10588 <refnamediv>
10589 <refname>sidebar.properties</refname>
10590 <refpurpose>Attribute set for sidebar properties</refpurpose>
10591 </refnamediv>
10592
10593 <refsynopsisdiv>
10594 <programlisting xml:id="sidebar.properties.frag">
10595 &lt;xsl:attribute-set name="sidebar.properties" use-attribute-sets="formal.object.properties"&gt;
10596   &lt;xsl:attribute name="border-style"&gt;solid&lt;/xsl:attribute&gt;
10597   &lt;xsl:attribute name="border-width"&gt;1pt&lt;/xsl:attribute&gt;
10598   &lt;xsl:attribute name="border-color"&gt;black&lt;/xsl:attribute&gt;
10599   &lt;xsl:attribute name="background-color"&gt;#DDDDDD&lt;/xsl:attribute&gt;
10600   &lt;xsl:attribute name="padding-start"&gt;12pt&lt;/xsl:attribute&gt;
10601   &lt;xsl:attribute name="padding-end"&gt;12pt&lt;/xsl:attribute&gt;
10602   &lt;xsl:attribute name="padding-top"&gt;6pt&lt;/xsl:attribute&gt;
10603   &lt;xsl:attribute name="padding-bottom"&gt;6pt&lt;/xsl:attribute&gt;
10604   &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;0pt&lt;/xsl:attribute&gt;
10605   &lt;xsl:attribute name="margin-{$direction.align.end}"&gt;0pt&lt;/xsl:attribute&gt;
10606 &lt;!--
10607   &lt;xsl:attribute name="margin-top"&gt;6pt&lt;/xsl:attribute&gt;
10608   &lt;xsl:attribute name="margin-bottom"&gt;6pt&lt;/xsl:attribute&gt;
10609 --&gt;
10610 &lt;/xsl:attribute-set&gt;
10611 </programlisting>
10612 </refsynopsisdiv>
10613
10614 <refsection><info><title>Description</title></info>
10615
10616 <para>The styling for sidebars.</para>
10617
10618 </refsection>
10619 </refentry>
10620
10621 <refentry version="5.0" xml:id="sidebar.title.properties">
10622 <refmeta>
10623 <refentrytitle>sidebar.title.properties</refentrytitle>
10624 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10625 </refmeta>
10626 <refnamediv>
10627 <refname>sidebar.title.properties</refname>
10628 <refpurpose>Attribute set for sidebar titles</refpurpose>
10629 </refnamediv>
10630
10631 <refsynopsisdiv>
10632 <programlisting xml:id="sidebar.title.properties.frag">
10633 &lt;xsl:attribute-set name="sidebar.title.properties"&gt;
10634   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
10635   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
10636   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;
10637   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
10638 &lt;/xsl:attribute-set&gt;
10639 </programlisting>
10640 </refsynopsisdiv>
10641
10642 <refsection><info><title>Description</title></info>
10643
10644 <para>The styling for sidebars titles.</para>
10645
10646 </refsection>
10647 </refentry>
10648
10649 <refentry version="5.0" xml:id="sidebar.float.type">
10650 <refmeta>
10651 <refentrytitle>sidebar.float.type</refentrytitle>
10652 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
10653 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>
10654 <refmiscinfo class="other" otherclass="value">before</refmiscinfo>
10655 <refmiscinfo class="other" otherclass="value">left</refmiscinfo>
10656 <refmiscinfo class="other" otherclass="value">start</refmiscinfo>
10657 <refmiscinfo class="other" otherclass="value">right</refmiscinfo>
10658 <refmiscinfo class="other" otherclass="value">end</refmiscinfo>
10659 <refmiscinfo class="other" otherclass="value">inside</refmiscinfo>
10660 <refmiscinfo class="other" otherclass="value">outside</refmiscinfo>
10661 </refmeta>
10662 <refnamediv>
10663 <refname>sidebar.float.type</refname>
10664 <refpurpose>Select type of float for sidebar elements</refpurpose>
10665 </refnamediv>
10666
10667 <refsynopsisdiv>
10668 <programlisting xml:id="sidebar.float.type.frag">
10669 &lt;xsl:param name="sidebar.float.type"&gt;none&lt;/xsl:param&gt;
10670 </programlisting>
10671 </refsynopsisdiv>
10672
10673 <refsection><info><title>Description</title></info>
10674
10675 <para>Selects the type of float for sidebar elements.
10676 </para>
10677 <itemizedlist>
10678 <listitem>
10679 <para>If <parameter>sidebar.float.type</parameter> is
10680 <quote><literal>none</literal></quote>, then
10681 no float is used.
10682 </para>
10683 </listitem>
10684 <listitem>
10685 <para>If <parameter>sidebar.float.type</parameter> is
10686 <quote><literal>before</literal></quote>, then
10687 the float appears at the top of the page.  On some processors,
10688 that may be the next page rather than the current page.
10689 </para>
10690 </listitem>
10691
10692 <listitem>
10693 <para>If <parameter>sidebar.float.type</parameter> is
10694 <quote><literal>left</literal></quote>,
10695 then a left side float is used.
10696 </para>
10697 </listitem>
10698
10699 <listitem>
10700 <para>If <parameter>sidebar.float.type</parameter> is
10701 <quote><literal>start</literal></quote>,
10702 then when the text direction is left-to-right a left side float is used.
10703 When the text direction is right-to-left, a right side float is used.
10704 </para>
10705 </listitem>
10706
10707 <listitem>
10708 <para>If <parameter>sidebar.float.type</parameter> is
10709 <quote><literal>right</literal></quote>,
10710 then a right side float is used.
10711 </para>
10712 </listitem>
10713
10714 <listitem>
10715 <para>If <parameter>sidebar.float.type</parameter> is
10716 <quote><literal>end</literal></quote>,
10717 then when the text direction is left-to-right a right side float is used.
10718 When the text direction is right-to-left, a left side float is used.
10719 </para>
10720 </listitem>
10721
10722 <listitem>
10723 <para>If your XSL-FO processor supports floats positioned on the
10724 <quote><literal>inside</literal></quote> or
10725 <quote><literal>outside</literal></quote>
10726 of double-sided pages, then you have those two
10727 options for side floats as well.
10728 </para>
10729 </listitem>
10730 </itemizedlist>
10731
10732 </refsection>
10733 </refentry>
10734
10735 <refentry version="5.0" xml:id="sidebar.float.width">
10736 <refmeta>
10737 <refentrytitle>sidebar.float.width</refentrytitle>
10738 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
10739 </refmeta>
10740 <refnamediv>
10741 <refname>sidebar.float.width</refname>
10742 <refpurpose>Set the default width for sidebars</refpurpose>
10743 </refnamediv>
10744
10745 <refsynopsisdiv>
10746 <programlisting xml:id="sidebar.float.width.frag">
10747 &lt;xsl:param name="sidebar.float.width"&gt;1in&lt;/xsl:param&gt;
10748 </programlisting>
10749 </refsynopsisdiv>
10750
10751 <refsection><info><title>Description</title></info>
10752
10753 <para>Sets the default width for sidebars when used as a side float.
10754 The width determines the degree to which the sidebar block intrudes into
10755 the text area.
10756 </para>
10757 <para>If <parameter>sidebar.float.type</parameter> is
10758 <quote><literal>before</literal></quote> or
10759 <quote><literal>none</literal></quote>, then
10760 this parameter is ignored.
10761 </para>
10762
10763 </refsection>
10764 </refentry>
10765
10766 <refentry version="5.0" xml:id="margin.note.properties">
10767 <refmeta>
10768 <refentrytitle>margin.note.properties</refentrytitle>
10769 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10770 </refmeta>
10771 <refnamediv>
10772 <refname>margin.note.properties</refname>
10773 <refpurpose>Attribute set for margin.note properties</refpurpose>
10774 </refnamediv>
10775
10776 <refsynopsisdiv>
10777 <programlisting xml:id="margin.note.properties.frag">
10778 &lt;xsl:attribute-set name="margin.note.properties"&gt;
10779   &lt;xsl:attribute name="font-size"&gt;90%&lt;/xsl:attribute&gt;
10780   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;
10781 &lt;/xsl:attribute-set&gt;
10782 </programlisting>
10783 </refsynopsisdiv>
10784
10785 <refsection><info><title>Description</title></info>
10786
10787 <para>The styling for margin notes.
10788 By default, margin notes are not implemented for any
10789 element. A stylesheet customization is needed to make
10790 use of this attribute-set.</para>
10791
10792 <para>You can use a template named <quote>floater</quote>
10793 to create the customization.
10794 That template can create side floats by specifying the
10795 content and characteristics as template parameters.
10796 </para>
10797
10798 <para>For example:</para>
10799 <programlisting>&lt;xsl:template match="para[@role='marginnote']"&gt;
10800   &lt;xsl:call-template name="floater"&gt;
10801     &lt;xsl:with-param name="position"&gt;
10802       &lt;xsl:value-of select="$margin.note.float.type"/&gt;
10803     &lt;/xsl:with-param&gt;
10804     &lt;xsl:with-param name="width"&gt;
10805       &lt;xsl:value-of select="$margin.note.width"/&gt;
10806     &lt;/xsl:with-param&gt;
10807     &lt;xsl:with-param name="content"&gt;
10808       &lt;xsl:apply-imports/&gt;
10809     &lt;/xsl:with-param&gt;
10810   &lt;/xsl:call-template&gt;
10811 &lt;/xsl:template&gt;</programlisting>
10812
10813 </refsection>
10814 </refentry>
10815
10816 <refentry version="5.0" xml:id="margin.note.title.properties">
10817 <refmeta>
10818 <refentrytitle>margin.note.title.properties</refentrytitle>
10819 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10820 </refmeta>
10821 <refnamediv>
10822 <refname>margin.note.title.properties</refname>
10823 <refpurpose>Attribute set for margin note titles</refpurpose>
10824 </refnamediv>
10825
10826 <refsynopsisdiv>
10827 <programlisting xml:id="margin.note.title.properties.frag">
10828 &lt;xsl:attribute-set name="margin.note.title.properties"&gt;
10829   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
10830   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
10831   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;
10832   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
10833 &lt;/xsl:attribute-set&gt;
10834 </programlisting>
10835 </refsynopsisdiv>
10836
10837 <refsection><info><title>Description</title></info>
10838
10839 <para>The styling for margin note titles.</para>
10840
10841 </refsection>
10842 </refentry>
10843
10844 <refentry version="5.0" xml:id="margin.note.float.type">
10845 <refmeta>
10846 <refentrytitle>margin.note.float.type</refentrytitle>
10847 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
10848 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>
10849 <refmiscinfo class="other" otherclass="value">before</refmiscinfo>
10850 <refmiscinfo class="other" otherclass="value">left</refmiscinfo>
10851 <refmiscinfo class="other" otherclass="value">start</refmiscinfo>
10852 <refmiscinfo class="other" otherclass="value">right</refmiscinfo>
10853 <refmiscinfo class="other" otherclass="value">end</refmiscinfo>
10854 <refmiscinfo class="other" otherclass="value">inside</refmiscinfo>
10855 <refmiscinfo class="other" otherclass="value">outside</refmiscinfo>
10856 </refmeta>
10857 <refnamediv>
10858 <refname>margin.note.float.type</refname>
10859 <refpurpose>Select type of float for margin note customizations</refpurpose>
10860 </refnamediv>
10861
10862 <refsynopsisdiv>
10863 <programlisting xml:id="margin.note.float.type.frag">
10864 &lt;xsl:param name="margin.note.float.type"&gt;none&lt;/xsl:param&gt;
10865 </programlisting>
10866 </refsynopsisdiv>
10867
10868 <refsection><info><title>Description</title></info>
10869
10870 <para>Selects the type of float for margin notes.
10871 DocBook does not define a margin note element, so this
10872 feature must be implemented as a customization of the stylesheet.
10873 See <parameter>margin.note.properties</parameter> for
10874 an example.
10875 </para>
10876 <itemizedlist>
10877 <listitem>
10878 <para>If <parameter>margin.note.float.type</parameter> is
10879 <quote><literal>none</literal></quote>, then
10880 no float is used.
10881 </para>
10882 </listitem>
10883 <listitem>
10884 <para>If <parameter>margin.note.float.type</parameter> is
10885 <quote><literal>before</literal></quote>, then
10886 the float appears at the top of the page.  On some processors,
10887 that may be the next page rather than the current page.
10888 </para>
10889 </listitem>
10890 <listitem>
10891 <para>If <parameter>margin.note.float.type</parameter> is
10892 <quote><literal>left</literal></quote> or
10893 <quote><literal>start</literal></quote>, then
10894 a left side float is used.
10895 </para>
10896 </listitem>
10897 <listitem>
10898 <para>If <parameter>margin.note.float.type</parameter> is
10899 <quote><literal>right</literal></quote> or
10900 <quote><literal>end</literal></quote>, then
10901 a right side float is used.
10902 </para>
10903 </listitem>
10904 <listitem>
10905 <para>If your XSL-FO processor supports floats positioned on the
10906 <quote><literal>inside</literal></quote> or
10907 <quote><literal>outside</literal></quote>
10908 of double-sided pages, then you have those two
10909 options for side floats as well.
10910 </para>
10911 </listitem>
10912 </itemizedlist>
10913
10914 </refsection>
10915 </refentry>
10916
10917 <refentry version="5.0" xml:id="margin.note.width">
10918 <refmeta>
10919 <refentrytitle>margin.note.width</refentrytitle>
10920 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
10921 </refmeta>
10922 <refnamediv>
10923 <refname>margin.note.width</refname>
10924 <refpurpose>Set the default width for margin notes</refpurpose>
10925 </refnamediv>
10926
10927 <refsynopsisdiv>
10928 <programlisting xml:id="margin.note.width.frag">
10929 &lt;xsl:param name="margin.note.width"&gt;1in&lt;/xsl:param&gt;
10930 </programlisting>
10931 </refsynopsisdiv>
10932
10933 <refsection><info><title>Description</title></info>
10934
10935 <para>Sets the default width for margin notes when used as a side
10936 float.  The width determines the degree to which the margin note block
10937 intrudes into the text area.
10938 </para>
10939 <para>If <parameter>margin.note.float.type</parameter> is
10940 <quote><literal>before</literal></quote> or
10941 <quote><literal>none</literal></quote>, then
10942 this parameter is ignored.
10943 </para>
10944
10945 </refsection>
10946 </refentry>
10947
10948 <refentry version="5.0" xml:id="component.title.properties">
10949 <refmeta>
10950 <refentrytitle>component.title.properties</refentrytitle>
10951 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10952 </refmeta>
10953 <refnamediv>
10954 <refname>component.title.properties</refname>
10955 <refpurpose>Properties for component titles</refpurpose>
10956 </refnamediv>
10957
10958 <refsynopsisdiv>
10959 <programlisting xml:id="component.title.properties.frag">
10960 &lt;xsl:attribute-set name="component.title.properties"&gt;
10961   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
10962   &lt;xsl:attribute name="space-before.optimum"&gt;&lt;xsl:value-of select="concat($body.font.master, 'pt')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
10963   &lt;xsl:attribute name="space-before.minimum"&gt;&lt;xsl:value-of select="concat($body.font.master, 'pt * 0.8')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
10964   &lt;xsl:attribute name="space-before.maximum"&gt;&lt;xsl:value-of select="concat($body.font.master, 'pt * 1.2')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
10965   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
10966   &lt;xsl:attribute name="text-align"&gt;
10967     &lt;xsl:choose&gt;
10968       &lt;xsl:when test="((parent::article | parent::articleinfo | parent::info/parent::article) and not(ancestor::book) and not(self::bibliography))         or (parent::slides | parent::slidesinfo)"&gt;center&lt;/xsl:when&gt;
10969       &lt;xsl:otherwise&gt;start&lt;/xsl:otherwise&gt;
10970     &lt;/xsl:choose&gt;
10971   &lt;/xsl:attribute&gt;
10972   &lt;xsl:attribute name="start-indent"&gt;&lt;xsl:value-of select="$title.margin.left"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
10973 &lt;/xsl:attribute-set&gt;
10974 </programlisting>
10975 </refsynopsisdiv>
10976
10977 <refsection><info><title>Description</title></info>
10978
10979 <para>The properties common to all component titles.</para>
10980
10981 </refsection>
10982 </refentry>
10983
10984 <refentry version="5.0" xml:id="component.titlepage.properties">
10985 <refmeta>
10986 <refentrytitle>component.titlepage.properties</refentrytitle>
10987 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10988 </refmeta>
10989 <refnamediv>
10990 <refname>component.titlepage.properties</refname>
10991 <refpurpose>Properties for component titlepages</refpurpose>
10992 </refnamediv>
10993
10994 <refsynopsisdiv>
10995 <programlisting xml:id="component.titlepage.properties.frag">
10996 &lt;xsl:attribute-set name="component.titlepage.properties"&gt;
10997 &lt;/xsl:attribute-set&gt;
10998 </programlisting>
10999 </refsynopsisdiv>
11000
11001 <refsection><info><title>Description</title></info>
11002
11003 <para>The properties that are applied to the outer block containing
11004 all the component title page information.
11005 Its main use is to set a <literal>span="all"</literal>
11006 property on the block that is a direct child of the flow.</para>
11007
11008 <para>This attribute-set also applies to index titlepages. It is empty by default.</para>
11009
11010 </refsection>
11011 </refentry>
11012
11013 <refentry version="5.0" xml:id="section.title.properties">
11014 <refmeta>
11015 <refentrytitle>section.title.properties</refentrytitle>
11016 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11017 </refmeta>
11018 <refnamediv>
11019 <refname>section.title.properties</refname>
11020 <refpurpose>Properties for section titles</refpurpose>
11021 </refnamediv>
11022
11023 <refsynopsisdiv>
11024 <programlisting xml:id="section.title.properties.frag">
11025 &lt;xsl:attribute-set name="section.title.properties"&gt;
11026   &lt;xsl:attribute name="font-family"&gt;
11027     &lt;xsl:value-of select="$title.fontset"&gt;&lt;/xsl:value-of&gt;
11028   &lt;/xsl:attribute&gt;
11029   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
11030   &lt;!-- font size is calculated dynamically by section.heading template --&gt;
11031   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
11032   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
11033   &lt;xsl:attribute name="space-before.optimum"&gt;1.0em&lt;/xsl:attribute&gt;
11034   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
11035   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;
11036   &lt;xsl:attribute name="start-indent"&gt;&lt;xsl:value-of select="$title.margin.left"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
11037 &lt;/xsl:attribute-set&gt;
11038 </programlisting>
11039 </refsynopsisdiv>
11040
11041 <refsection><info><title>Description</title></info>
11042
11043 <para>The properties common to all section titles.</para>
11044
11045 </refsection>
11046 </refentry>
11047
11048 <refentry version="5.0" xml:id="section.title.level1.properties">
11049 <refmeta>
11050 <refentrytitle>section.title.level1.properties</refentrytitle>
11051 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11052 </refmeta>
11053 <refnamediv>
11054 <refname>section.title.level1.properties</refname>
11055 <refpurpose>Properties for level-1 section titles</refpurpose>
11056 </refnamediv>
11057
11058 <refsynopsisdiv>
11059 <programlisting xml:id="section.title.level1.properties.frag">
11060 &lt;xsl:attribute-set name="section.title.level1.properties"&gt;
11061   &lt;xsl:attribute name="font-size"&gt;
11062     &lt;xsl:value-of select="$body.font.master * 2.0736"&gt;&lt;/xsl:value-of&gt;
11063     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
11064   &lt;/xsl:attribute&gt;
11065 &lt;/xsl:attribute-set&gt;
11066 </programlisting>
11067 </refsynopsisdiv>
11068
11069 <refsection><info><title>Description</title></info>
11070
11071 <para>The properties of level-1 section titles.</para>
11072
11073 </refsection>
11074 </refentry>
11075
11076
11077 <refentry version="5.0" xml:id="section.title.level2.properties">
11078 <refmeta>
11079 <refentrytitle>section.title.level2.properties</refentrytitle>
11080 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11081 </refmeta>
11082 <refnamediv>
11083 <refname>section.title.level2.properties</refname>
11084 <refpurpose>Properties for level-2 section titles</refpurpose>
11085 </refnamediv>
11086
11087 <refsynopsisdiv>
11088 <programlisting xml:id="section.title.level2.properties.frag">
11089 &lt;xsl:attribute-set name="section.title.level2.properties"&gt;
11090   &lt;xsl:attribute name="font-size"&gt;
11091     &lt;xsl:value-of select="$body.font.master * 1.728"&gt;&lt;/xsl:value-of&gt;
11092     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
11093   &lt;/xsl:attribute&gt;
11094 &lt;/xsl:attribute-set&gt;
11095 </programlisting>
11096 </refsynopsisdiv>
11097
11098 <refsection><info><title>Description</title></info>
11099
11100 <para>The properties of level-2 section titles.</para>
11101
11102 </refsection>
11103 </refentry>
11104
11105 <refentry version="5.0" xml:id="section.title.level3.properties">
11106 <refmeta>
11107 <refentrytitle>section.title.level3.properties</refentrytitle>
11108 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11109 </refmeta>
11110 <refnamediv>
11111 <refname>section.title.level3.properties</refname>
11112 <refpurpose>Properties for level-3 section titles</refpurpose>
11113 </refnamediv>
11114
11115 <refsynopsisdiv>
11116 <programlisting xml:id="section.title.level3.properties.frag">
11117 &lt;xsl:attribute-set name="section.title.level3.properties"&gt;
11118   &lt;xsl:attribute name="font-size"&gt;
11119     &lt;xsl:value-of select="$body.font.master * 1.44"&gt;&lt;/xsl:value-of&gt;
11120     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
11121   &lt;/xsl:attribute&gt;
11122 &lt;/xsl:attribute-set&gt;
11123 </programlisting>
11124 </refsynopsisdiv>
11125
11126 <refsection><info><title>Description</title></info>
11127
11128 <para>The properties of level-3 section titles.</para>
11129
11130 </refsection>
11131 </refentry>
11132
11133 <refentry version="5.0" xml:id="section.title.level4.properties">
11134 <refmeta>
11135 <refentrytitle>section.title.level4.properties</refentrytitle>
11136 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11137 </refmeta>
11138 <refnamediv>
11139 <refname>section.title.level4.properties</refname>
11140 <refpurpose>Properties for level-4 section titles</refpurpose>
11141 </refnamediv>
11142
11143 <refsynopsisdiv>
11144 <programlisting xml:id="section.title.level4.properties.frag">
11145 &lt;xsl:attribute-set name="section.title.level4.properties"&gt;
11146   &lt;xsl:attribute name="font-size"&gt;
11147     &lt;xsl:value-of select="$body.font.master * 1.2"&gt;&lt;/xsl:value-of&gt;
11148     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
11149   &lt;/xsl:attribute&gt;
11150 &lt;/xsl:attribute-set&gt;
11151 </programlisting>
11152 </refsynopsisdiv>
11153
11154 <refsection><info><title>Description</title></info>
11155
11156 <para>The properties of level-4 section titles.</para>
11157
11158 </refsection>
11159 </refentry>
11160
11161 <refentry version="5.0" xml:id="section.title.level5.properties">
11162 <refmeta>
11163 <refentrytitle>section.title.level5.properties</refentrytitle>
11164 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11165 </refmeta>
11166 <refnamediv>
11167 <refname>section.title.level5.properties</refname>
11168 <refpurpose>Properties for level-5 section titles</refpurpose>
11169 </refnamediv>
11170
11171 <refsynopsisdiv>
11172 <programlisting xml:id="section.title.level5.properties.frag">
11173 &lt;xsl:attribute-set name="section.title.level5.properties"&gt;
11174   &lt;xsl:attribute name="font-size"&gt;
11175     &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;
11176     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
11177   &lt;/xsl:attribute&gt;
11178 &lt;/xsl:attribute-set&gt;
11179 </programlisting>
11180 </refsynopsisdiv>
11181
11182 <refsection><info><title>Description</title></info>
11183
11184 <para>The properties of level-5 section titles.</para>
11185
11186 </refsection>
11187 </refentry>
11188
11189 <refentry version="5.0" xml:id="section.title.level6.properties">
11190 <refmeta>
11191 <refentrytitle>section.title.level6.properties</refentrytitle>
11192 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11193 </refmeta>
11194 <refnamediv>
11195 <refname>section.title.level6.properties</refname>
11196 <refpurpose>Properties for level-6 section titles</refpurpose>
11197 </refnamediv>
11198
11199 <refsynopsisdiv>
11200 <programlisting xml:id="section.title.level6.properties.frag">
11201 &lt;xsl:attribute-set name="section.title.level6.properties"&gt;
11202   &lt;xsl:attribute name="font-size"&gt;
11203     &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;
11204     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
11205   &lt;/xsl:attribute&gt;
11206 &lt;/xsl:attribute-set&gt;
11207 </programlisting>
11208 </refsynopsisdiv>
11209
11210 <refsection><info><title>Description</title></info>
11211
11212 <para>The properties of level-6 section titles. This property set is actually
11213 used for all titles below level 5.</para>
11214
11215 </refsection>
11216 </refentry>
11217
11218 <refentry version="5.0" xml:id="section.properties">
11219 <refmeta>
11220 <refentrytitle>section.properties</refentrytitle>
11221 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11222 </refmeta>
11223 <refnamediv>
11224 <refname>section.properties</refname>
11225 <refpurpose>Properties for all section levels</refpurpose>
11226 </refnamediv>
11227
11228 <refsynopsisdiv>
11229 <programlisting xml:id="section.properties.frag">
11230 &lt;xsl:attribute-set name="section.properties"&gt;
11231 &lt;/xsl:attribute-set&gt;
11232 </programlisting>
11233 </refsynopsisdiv>
11234
11235 <refsection><info><title>Description</title></info>
11236
11237 <para>The properties that apply to the containing
11238 block of all section levels, and therefore apply to
11239 the whole section.
11240 This attribute set is inherited by the
11241 more specific attribute sets such as
11242 <tag>section.level1.properties</tag>.
11243 The default is empty.
11244 </para>
11245
11246 </refsection>
11247 </refentry>
11248
11249 <refentry version="5.0" xml:id="section.level1.properties">
11250 <refmeta>
11251 <refentrytitle>section.level1.properties</refentrytitle>
11252 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11253 </refmeta>
11254 <refnamediv>
11255 <refname>section.level1.properties</refname>
11256 <refpurpose>Properties for level-1 sections</refpurpose>
11257 </refnamediv>
11258
11259 <refsynopsisdiv>
11260 <programlisting xml:id="section.level1.properties.frag">
11261 &lt;xsl:attribute-set name="section.level1.properties" use-attribute-sets="section.properties"&gt;
11262 &lt;/xsl:attribute-set&gt;
11263 </programlisting>
11264 </refsynopsisdiv>
11265
11266 <refsection><info><title>Description</title></info>
11267
11268 <para>The properties that apply to the containing
11269 block of a level-1 section, and therefore apply to
11270 the whole section.  This includes <tag>sect1</tag>
11271 elements and <tag>section</tag> elements at level 1.
11272 </para>
11273
11274 <para>For example, you could start each level-1 section on
11275 a new page by using:</para>
11276 <programlisting>&lt;xsl:attribute-set name="section.level1.properties"&gt;
11277   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;
11278 &lt;/xsl:attribute-set&gt;
11279 </programlisting>
11280
11281 <para>This attribute set inherits attributes from the
11282 general <tag>section.properties</tag> attribute set.
11283 </para>
11284
11285 </refsection>
11286 </refentry>
11287
11288 <refentry version="5.0" xml:id="section.level2.properties">
11289 <refmeta>
11290 <refentrytitle>section.level2.properties</refentrytitle>
11291 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11292 </refmeta>
11293 <refnamediv>
11294 <refname>section.level2.properties</refname>
11295 <refpurpose>Properties for level-2 sections</refpurpose>
11296 </refnamediv>
11297
11298 <refsynopsisdiv>
11299 <programlisting xml:id="section.level2.properties.frag">
11300 &lt;xsl:attribute-set name="section.level2.properties" use-attribute-sets="section.properties"&gt;
11301 &lt;/xsl:attribute-set&gt;
11302 </programlisting>
11303 </refsynopsisdiv>
11304
11305 <refsection><info><title>Description</title></info>
11306
11307 <para>The properties that apply to the containing
11308 block of a level-2 section, and therefore apply to
11309 the whole section.  This includes <tag>sect2</tag>
11310 elements and <tag>section</tag> elements at level 2.
11311 </para>
11312
11313 <para>For example, you could start each level-2 section on
11314 a new page by using:</para>
11315 <programlisting>&lt;xsl:attribute-set name="section.level2.properties"&gt;
11316   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;
11317 &lt;/xsl:attribute-set&gt;
11318 </programlisting>
11319
11320 <para>This attribute set inherits attributes from the
11321 general <tag>section.properties</tag> attribute set.
11322 </para>
11323
11324 </refsection>
11325 </refentry>
11326
11327 <refentry version="5.0" xml:id="section.level3.properties">
11328 <refmeta>
11329 <refentrytitle>section.level3.properties</refentrytitle>
11330 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11331 </refmeta>
11332 <refnamediv>
11333 <refname>section.level3.properties</refname>
11334 <refpurpose>Properties for level-3 sections</refpurpose>
11335 </refnamediv>
11336
11337 <refsynopsisdiv>
11338 <programlisting xml:id="section.level3.properties.frag">
11339 &lt;xsl:attribute-set name="section.level3.properties" use-attribute-sets="section.properties"&gt;
11340 &lt;/xsl:attribute-set&gt;
11341 </programlisting>
11342 </refsynopsisdiv>
11343
11344 <refsection><info><title>Description</title></info>
11345
11346 <para>The properties that apply to the containing
11347 block of a level-3 section, and therefore apply to
11348 the whole section.  This includes <tag>sect3</tag>
11349 elements and <tag>section</tag> elements at level 3.
11350 </para>
11351
11352 <para>For example, you could start each level-3 section on
11353 a new page by using:</para>
11354 <programlisting>&lt;xsl:attribute-set name="section.level3.properties"&gt;
11355   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;
11356 &lt;/xsl:attribute-set&gt;
11357 </programlisting>
11358
11359 <para>This attribute set inherits attributes from the
11360 general <tag>section.properties</tag> attribute set.
11361 </para>
11362
11363 </refsection>
11364 </refentry>
11365
11366 <refentry version="5.0" xml:id="section.level4.properties">
11367 <refmeta>
11368 <refentrytitle>section.level4.properties</refentrytitle>
11369 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11370 </refmeta>
11371 <refnamediv>
11372 <refname>section.level4.properties</refname>
11373 <refpurpose>Properties for level-4 sections</refpurpose>
11374 </refnamediv>
11375
11376 <refsynopsisdiv>
11377 <programlisting xml:id="section.level4.properties.frag">
11378 &lt;xsl:attribute-set name="section.level4.properties" use-attribute-sets="section.properties"&gt;
11379 &lt;/xsl:attribute-set&gt;
11380 </programlisting>
11381 </refsynopsisdiv>
11382
11383 <refsection><info><title>Description</title></info>
11384
11385 <para>The properties that apply to the containing
11386 block of a level-4 section, and therefore apply to
11387 the whole section.  This includes <tag>sect4</tag>
11388 elements and <tag>section</tag> elements at level 4.
11389 </para>
11390
11391 <para>For example, you could start each level-4 section on
11392 a new page by using:</para>
11393 <programlisting>&lt;xsl:attribute-set name="section.level4.properties"&gt;
11394   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;
11395 &lt;/xsl:attribute-set&gt;
11396 </programlisting>
11397
11398 <para>This attribute set inherits attributes from the
11399 general <tag>section.properties</tag> attribute set.
11400 </para>
11401
11402 </refsection>
11403 </refentry>
11404
11405 <refentry version="5.0" xml:id="section.level5.properties">
11406 <refmeta>
11407 <refentrytitle>section.level5.properties</refentrytitle>
11408 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11409 </refmeta>
11410 <refnamediv>
11411 <refname>section.level5.properties</refname>
11412 <refpurpose>Properties for level-5 sections</refpurpose>
11413 </refnamediv>
11414
11415 <refsynopsisdiv>
11416 <programlisting xml:id="section.level5.properties.frag">
11417 &lt;xsl:attribute-set name="section.level5.properties" use-attribute-sets="section.properties"&gt;
11418 &lt;/xsl:attribute-set&gt;
11419 </programlisting>
11420 </refsynopsisdiv>
11421
11422 <refsection><info><title>Description</title></info>
11423
11424 <para>The properties that apply to the containing
11425 block of a level-5 section, and therefore apply to
11426 the whole section.  This includes <tag>sect5</tag>
11427 elements and <tag>section</tag> elements at level 5.
11428 </para>
11429
11430 <para>For example, you could start each level-5 section on
11431 a new page by using:</para>
11432 <programlisting>&lt;xsl:attribute-set name="section.level5.properties"&gt;
11433   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;
11434 &lt;/xsl:attribute-set&gt;
11435 </programlisting>
11436
11437 <para>This attribute set inherits attributes from the
11438 general <tag>section.properties</tag> attribute set.
11439 </para>
11440
11441 </refsection>
11442 </refentry>
11443
11444 <refentry version="5.0" xml:id="section.level6.properties">
11445 <refmeta>
11446 <refentrytitle>section.level6.properties</refentrytitle>
11447 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11448 </refmeta>
11449 <refnamediv>
11450 <refname>section.level6.properties</refname>
11451 <refpurpose>Properties for level-6 sections</refpurpose>
11452 </refnamediv>
11453
11454 <refsynopsisdiv>
11455 <programlisting xml:id="section.level6.properties.frag">
11456 &lt;xsl:attribute-set name="section.level6.properties" use-attribute-sets="section.properties"&gt;
11457 &lt;/xsl:attribute-set&gt;
11458 </programlisting>
11459 </refsynopsisdiv>
11460
11461 <refsection><info><title>Description</title></info>
11462
11463 <para>The properties that apply to the containing
11464 block of a level 6 or lower section, and therefore apply to
11465 the whole section.  This includes
11466 <tag>section</tag> elements at level 6 and lower.
11467 </para>
11468
11469 <para>For example, you could start each level-6 section on
11470 a new page by using:</para>
11471 <programlisting>&lt;xsl:attribute-set name="section.level6.properties"&gt;
11472   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;
11473 &lt;/xsl:attribute-set&gt;
11474 </programlisting>
11475
11476 <para>This attribute set inherits attributes from the
11477 general <tag>section.properties</tag> attribute set.
11478 </para>
11479
11480 </refsection>
11481 </refentry>
11482
11483 <refentry version="5.0" xml:id="figure.properties">
11484 <refmeta>
11485 <refentrytitle>figure.properties</refentrytitle>
11486 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11487 </refmeta>
11488 <refnamediv>
11489 <refname>figure.properties</refname>
11490 <refpurpose>Properties associated with a figure</refpurpose>
11491 </refnamediv>
11492
11493 <refsynopsisdiv>
11494 <programlisting xml:id="figure.properties.frag">
11495 &lt;xsl:attribute-set name="figure.properties" use-attribute-sets="formal.object.properties"&gt;&lt;/xsl:attribute-set&gt;
11496 </programlisting>
11497 </refsynopsisdiv>
11498
11499 <refsection><info><title>Description</title></info>
11500
11501 <para>The styling for figures.</para>
11502
11503 </refsection>
11504 </refentry>
11505
11506 <refentry version="5.0" xml:id="example.properties">
11507 <refmeta>
11508 <refentrytitle>example.properties</refentrytitle>
11509 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11510 </refmeta>
11511 <refnamediv>
11512 <refname>example.properties</refname>
11513 <refpurpose>Properties associated with a example</refpurpose>
11514 </refnamediv>
11515
11516 <refsynopsisdiv>
11517 <programlisting xml:id="example.properties.frag">
11518 &lt;xsl:attribute-set name="example.properties" use-attribute-sets="formal.object.properties"&gt;
11519     &lt;xsl:attribute name="keep-together.within-column"&gt;auto&lt;/xsl:attribute&gt;
11520 &lt;/xsl:attribute-set&gt;
11521 </programlisting>
11522 </refsynopsisdiv>
11523
11524 <refsection><info><title>Description</title></info>
11525
11526 <para>The styling for examples.</para>
11527
11528 </refsection>
11529 </refentry>
11530
11531 <refentry version="5.0" xml:id="equation.properties">
11532 <refmeta>
11533 <refentrytitle>equation.properties</refentrytitle>
11534 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11535 </refmeta>
11536 <refnamediv>
11537 <refname>equation.properties</refname>
11538 <refpurpose>Properties associated with a equation</refpurpose>
11539 </refnamediv>
11540
11541 <refsynopsisdiv>
11542 <programlisting xml:id="equation.properties.frag">
11543 &lt;xsl:attribute-set name="equation.properties" use-attribute-sets="formal.object.properties"&gt;&lt;/xsl:attribute-set&gt;
11544 </programlisting>
11545 </refsynopsisdiv>
11546
11547 <refsection><info><title>Description</title></info>
11548
11549 <para>The styling for equations.</para>
11550
11551 </refsection>
11552 </refentry>
11553
11554 <refentry version="5.0" xml:id="equation.number.properties">
11555 <refmeta>
11556 <refentrytitle>equation.number.properties</refentrytitle>
11557 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11558 </refmeta>
11559 <refnamediv>
11560 <refname>equation.number.properties</refname>
11561 <refpurpose>Properties that apply to the <tag>fo:table-cell</tag> containing the number
11562 of an <tag>equation</tag> that does not have a title.</refpurpose>
11563 </refnamediv>
11564
11565 <refsynopsisdiv>
11566 <programlisting xml:id="equation.number.properties.frag">&lt;xsl:attribute-set name="equation.number.properties"&gt;
11567   &lt;xsl:attribute name="text-align"&gt;end&lt;/xsl:attribute&gt;
11568   &lt;xsl:attribute name="display-align"&gt;center&lt;/xsl:attribute&gt;
11569 &lt;/xsl:attribute-set&gt;</programlisting>
11570 </refsynopsisdiv>
11571 <refsection><info><title>Description</title></info>
11572 <para>Properties that apply to the fo:table-cell containing the number
11573 of an equation when it has no title. The number in an equation with a
11574 title is formatted along with the title, and this attribute-set does not apply.</para>
11575 </refsection>
11576 </refentry>
11577
11578 <refentry version="5.0" xml:id="table.properties">
11579 <refmeta>
11580 <refentrytitle>table.properties</refentrytitle>
11581 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11582 </refmeta>
11583 <refnamediv>
11584 <refname>table.properties</refname>
11585 <refpurpose>Properties associated with the block surrounding a table</refpurpose>
11586 </refnamediv>
11587
11588 <refsynopsisdiv>
11589 <programlisting xml:id="table.properties.frag">
11590 &lt;xsl:attribute-set name="table.properties" use-attribute-sets="formal.object.properties"&gt;
11591   &lt;xsl:attribute name="keep-together.within-column"&gt;auto&lt;/xsl:attribute&gt;
11592 &lt;/xsl:attribute-set&gt;
11593 </programlisting>
11594 </refsynopsisdiv>
11595
11596 <refsection><info><title>Description</title></info>
11597
11598 <para>Block styling properties for tables. This parameter should really
11599 have been called <literal>table.block.properties</literal> or something
11600 like that, but we&#8217;re leaving it to avoid backwards-compatibility
11601 problems.</para>
11602
11603 <para>See also <parameter>table.table.properties</parameter>.</para>
11604
11605 </refsection>
11606 </refentry>
11607
11608 <refentry version="5.0" xml:id="task.properties">
11609 <refmeta>
11610 <refentrytitle>task.properties</refentrytitle>
11611 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11612 </refmeta>
11613 <refnamediv>
11614 <refname>task.properties</refname>
11615 <refpurpose>Properties associated with a task</refpurpose>
11616 </refnamediv>
11617
11618 <refsynopsisdiv>
11619 <programlisting xml:id="task.properties.frag">
11620 &lt;xsl:attribute-set name="task.properties" use-attribute-sets="formal.object.properties"&gt;
11621     &lt;xsl:attribute name="keep-together.within-column"&gt;auto&lt;/xsl:attribute&gt;
11622 &lt;/xsl:attribute-set&gt;
11623 </programlisting>
11624 </refsynopsisdiv>
11625
11626 <refsection><info><title>Description</title></info>
11627
11628 <para>Properties to style the entire block containing a task element.</para>
11629
11630 </refsection>
11631 </refentry>
11632
11633 <refentry version="5.0" xml:id="informalfigure.properties">
11634 <refmeta>
11635 <refentrytitle>informalfigure.properties</refentrytitle>
11636 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11637 </refmeta>
11638 <refnamediv>
11639 <refname>informalfigure.properties</refname>
11640 <refpurpose>Properties associated with an informalfigure</refpurpose>
11641 </refnamediv>
11642
11643 <refsynopsisdiv>
11644 <programlisting xml:id="informalfigure.properties.frag">
11645 &lt;xsl:attribute-set name="informalfigure.properties" use-attribute-sets="informal.object.properties"&gt;&lt;/xsl:attribute-set&gt;
11646 </programlisting>
11647 </refsynopsisdiv>
11648
11649 <refsection><info><title>Description</title></info>
11650
11651 <para>The styling for informalfigures.</para>
11652
11653 </refsection>
11654 </refentry>
11655
11656 <refentry version="5.0" xml:id="informalexample.properties">
11657 <refmeta>
11658 <refentrytitle>informalexample.properties</refentrytitle>
11659 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11660 </refmeta>
11661 <refnamediv>
11662 <refname>informalexample.properties</refname>
11663 <refpurpose>Properties associated with an informalexample</refpurpose>
11664 </refnamediv>
11665
11666 <refsynopsisdiv>
11667 <programlisting xml:id="informalexample.properties.frag">
11668 &lt;xsl:attribute-set name="informalexample.properties" use-attribute-sets="informal.object.properties"&gt;&lt;/xsl:attribute-set&gt;
11669 </programlisting>
11670 </refsynopsisdiv>
11671
11672 <refsection><info><title>Description</title></info>
11673
11674 <para>The styling for informalexamples.</para>
11675
11676 </refsection>
11677 </refentry>
11678
11679 <refentry version="5.0" xml:id="informalequation.properties">
11680 <refmeta>
11681 <refentrytitle>informalequation.properties</refentrytitle>
11682 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11683 </refmeta>
11684 <refnamediv>
11685 <refname>informalequation.properties</refname>
11686 <refpurpose>Properties associated with an informalequation</refpurpose>
11687 </refnamediv>
11688
11689 <refsynopsisdiv>
11690 <programlisting xml:id="informalequation.properties.frag">
11691 &lt;xsl:attribute-set name="informalequation.properties" use-attribute-sets="informal.object.properties"&gt;&lt;/xsl:attribute-set&gt;
11692 </programlisting>
11693 </refsynopsisdiv>
11694
11695 <refsection><info><title>Description</title></info>
11696
11697 <para>The styling for informalequations.</para>
11698
11699 </refsection>
11700 </refentry>
11701
11702 <refentry version="5.0" xml:id="informaltable.properties">
11703 <refmeta>
11704 <refentrytitle>informaltable.properties</refentrytitle>
11705 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11706 </refmeta>
11707 <refnamediv>
11708 <refname>informaltable.properties</refname>
11709 <refpurpose>Properties associated with the block surrounding an informaltable</refpurpose>
11710 </refnamediv>
11711
11712 <refsynopsisdiv>
11713 <programlisting xml:id="informaltable.properties.frag">
11714 &lt;xsl:attribute-set name="informaltable.properties" use-attribute-sets="informal.object.properties"&gt;&lt;/xsl:attribute-set&gt;
11715 </programlisting>
11716 </refsynopsisdiv>
11717
11718 <refsection><info><title>Description</title></info>
11719
11720 <para>Block styling properties for informaltables. This parameter should really
11721 have been called <literal>informaltable.block.properties</literal> or something
11722 like that, but we&#8217;re leaving it to avoid backwards-compatibility
11723 problems.</para>
11724
11725 <para>See also <parameter>table.table.properties</parameter>.</para>
11726
11727 </refsection>
11728 </refentry>
11729
11730 <refentry version="5.0" xml:id="procedure.properties">
11731 <refmeta>
11732 <refentrytitle>procedure.properties</refentrytitle>
11733 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11734 </refmeta>
11735 <refnamediv>
11736 <refname>procedure.properties</refname>
11737 <refpurpose>Properties associated with a procedure</refpurpose>
11738 </refnamediv>
11739
11740 <refsynopsisdiv>
11741 <programlisting xml:id="procedure.properties.frag">
11742 &lt;xsl:attribute-set name="procedure.properties" use-attribute-sets="formal.object.properties"&gt;
11743   &lt;xsl:attribute name="keep-together.within-column"&gt;auto&lt;/xsl:attribute&gt;
11744 &lt;/xsl:attribute-set&gt;
11745 </programlisting>
11746 </refsynopsisdiv>
11747
11748 <refsection><info><title>Description</title></info>
11749
11750 <para>The styling for procedures.</para>
11751
11752 </refsection>
11753 </refentry>
11754
11755 <refentry version="5.0" xml:id="root.properties">
11756 <refmeta>
11757 <refentrytitle>root.properties</refentrytitle>
11758 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11759 </refmeta>
11760 <refnamediv>
11761 <refname>root.properties</refname>
11762 <refpurpose>The properties of the fo:root element</refpurpose>
11763 </refnamediv>
11764
11765 <refsynopsisdiv>
11766 <programlisting xml:id="root.properties.frag">
11767 &lt;xsl:attribute-set name="root.properties"&gt;
11768   &lt;xsl:attribute name="font-family"&gt;
11769     &lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;
11770   &lt;/xsl:attribute&gt;
11771   &lt;xsl:attribute name="font-size"&gt;
11772     &lt;xsl:value-of select="$body.font.size"&gt;&lt;/xsl:value-of&gt;
11773   &lt;/xsl:attribute&gt;
11774   &lt;xsl:attribute name="text-align"&gt;
11775     &lt;xsl:value-of select="$alignment"&gt;&lt;/xsl:value-of&gt;
11776   &lt;/xsl:attribute&gt;
11777   &lt;xsl:attribute name="line-height"&gt;
11778     &lt;xsl:value-of select="$line-height"&gt;&lt;/xsl:value-of&gt;
11779   &lt;/xsl:attribute&gt;
11780   &lt;xsl:attribute name="font-selection-strategy"&gt;character-by-character&lt;/xsl:attribute&gt;
11781   &lt;xsl:attribute name="line-height-shift-adjustment"&gt;disregard-shifts&lt;/xsl:attribute&gt;
11782   &lt;xsl:attribute name="writing-mode"&gt;
11783     &lt;xsl:value-of select="$direction.mode"&gt;&lt;/xsl:value-of&gt;
11784   &lt;/xsl:attribute&gt;
11785 &lt;/xsl:attribute-set&gt;
11786 </programlisting>
11787 </refsynopsisdiv>
11788
11789 <refsection><info><title>Description</title></info>
11790
11791 <para>This property set is used on the <tag>fo:root</tag> element of
11792 an FO file. It defines a set of default, global parameters.</para>
11793
11794 </refsection>
11795 </refentry>
11796
11797 <refentry version="5.0" xml:id="qanda.title.properties">
11798 <refmeta>
11799 <refentrytitle>qanda.title.properties</refentrytitle>
11800 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11801 </refmeta>
11802 <refnamediv>
11803 <refname>qanda.title.properties</refname>
11804 <refpurpose>Properties for qanda set titles</refpurpose>
11805 </refnamediv>
11806
11807 <refsynopsisdiv>
11808 <programlisting xml:id="qanda.title.properties.frag">
11809 &lt;xsl:attribute-set name="qanda.title.properties"&gt;
11810   &lt;xsl:attribute name="font-family"&gt;
11811     &lt;xsl:value-of select="$title.fontset"&gt;&lt;/xsl:value-of&gt;
11812   &lt;/xsl:attribute&gt;
11813   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
11814   &lt;!-- font size is calculated dynamically by qanda.heading template --&gt;
11815   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
11816   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
11817   &lt;xsl:attribute name="space-before.optimum"&gt;1.0em&lt;/xsl:attribute&gt;
11818   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
11819 &lt;/xsl:attribute-set&gt;
11820 </programlisting>
11821 </refsynopsisdiv>
11822
11823 <refsection><info><title>Description</title></info>
11824
11825 <para>The properties common to all qanda set titles.</para>
11826
11827 </refsection>
11828 </refentry>
11829
11830 <refentry version="5.0" xml:id="qanda.title.level1.properties">
11831 <refmeta>
11832 <refentrytitle>qanda.title.level1.properties</refentrytitle>
11833 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11834 </refmeta>
11835 <refnamediv>
11836 <refname>qanda.title.level1.properties</refname>
11837 <refpurpose>Properties for level-1 qanda set titles</refpurpose>
11838 </refnamediv>
11839
11840 <refsynopsisdiv>
11841 <programlisting xml:id="qanda.title.level1.properties.frag">
11842 &lt;xsl:attribute-set name="qanda.title.level1.properties"&gt;
11843   &lt;xsl:attribute name="font-size"&gt;
11844     &lt;xsl:value-of select="$body.font.master * 2.0736"&gt;&lt;/xsl:value-of&gt;
11845     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
11846   &lt;/xsl:attribute&gt;
11847 &lt;/xsl:attribute-set&gt;
11848 </programlisting>
11849 </refsynopsisdiv>
11850
11851 <refsection><info><title>Description</title></info>
11852
11853 <para>The properties of level-1 qanda set titles.</para>
11854
11855 </refsection>
11856 </refentry>
11857
11858 <refentry version="5.0" xml:id="qanda.title.level2.properties">
11859 <refmeta>
11860 <refentrytitle>qanda.title.level2.properties</refentrytitle>
11861 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11862 </refmeta>
11863 <refnamediv>
11864 <refname>qanda.title.level2.properties</refname>
11865 <refpurpose>Properties for level-2 qanda set titles</refpurpose>
11866 </refnamediv>
11867
11868 <refsynopsisdiv>
11869 <programlisting xml:id="qanda.title.level2.properties.frag">
11870 &lt;xsl:attribute-set name="qanda.title.level2.properties"&gt;
11871   &lt;xsl:attribute name="font-size"&gt;
11872     &lt;xsl:value-of select="$body.font.master * 1.728"&gt;&lt;/xsl:value-of&gt;
11873     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
11874   &lt;/xsl:attribute&gt;
11875 &lt;/xsl:attribute-set&gt;
11876 </programlisting>
11877 </refsynopsisdiv>
11878
11879 <refsection><info><title>Description</title></info>
11880
11881 <para>The properties of level-2 qanda set titles.</para>
11882
11883 </refsection>
11884 </refentry>
11885
11886 <refentry version="5.0" xml:id="qanda.title.level3.properties">
11887 <refmeta>
11888 <refentrytitle>qanda.title.level3.properties</refentrytitle>
11889 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11890 </refmeta>
11891 <refnamediv>
11892 <refname>qanda.title.level3.properties</refname>
11893 <refpurpose>Properties for level-3 qanda set titles</refpurpose>
11894 </refnamediv>
11895
11896 <refsynopsisdiv>
11897 <programlisting xml:id="qanda.title.level3.properties.frag">
11898 &lt;xsl:attribute-set name="qanda.title.level3.properties"&gt;
11899   &lt;xsl:attribute name="font-size"&gt;
11900     &lt;xsl:value-of select="$body.font.master * 1.44"&gt;&lt;/xsl:value-of&gt;
11901     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
11902   &lt;/xsl:attribute&gt;
11903 &lt;/xsl:attribute-set&gt;
11904 </programlisting>
11905 </refsynopsisdiv>
11906
11907 <refsection><info><title>Description</title></info>
11908
11909 <para>The properties of level-3 qanda set titles.</para>
11910
11911 </refsection>
11912 </refentry>
11913
11914 <refentry version="5.0" xml:id="qanda.title.level4.properties">
11915 <refmeta>
11916 <refentrytitle>qanda.title.level4.properties</refentrytitle>
11917 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11918 </refmeta>
11919 <refnamediv>
11920 <refname>qanda.title.level4.properties</refname>
11921 <refpurpose>Properties for level-4 qanda set titles</refpurpose>
11922 </refnamediv>
11923
11924 <refsynopsisdiv>
11925 <programlisting xml:id="qanda.title.level4.properties.frag">
11926 &lt;xsl:attribute-set name="qanda.title.level4.properties"&gt;
11927   &lt;xsl:attribute name="font-size"&gt;
11928     &lt;xsl:value-of select="$body.font.master * 1.2"&gt;&lt;/xsl:value-of&gt;
11929     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
11930   &lt;/xsl:attribute&gt;
11931 &lt;/xsl:attribute-set&gt;
11932 </programlisting>
11933 </refsynopsisdiv>
11934
11935 <refsection><info><title>Description</title></info>
11936
11937 <para>The properties of level-4 qanda set titles.</para>
11938
11939 </refsection>
11940 </refentry>
11941
11942 <refentry version="5.0" xml:id="qanda.title.level5.properties">
11943 <refmeta>
11944 <refentrytitle>qanda.title.level5.properties</refentrytitle>
11945 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11946 </refmeta>
11947 <refnamediv>
11948 <refname>qanda.title.level5.properties</refname>
11949 <refpurpose>Properties for level-5 qanda set titles</refpurpose>
11950 </refnamediv>
11951
11952 <refsynopsisdiv>
11953 <programlisting xml:id="qanda.title.level5.properties.frag">
11954 &lt;xsl:attribute-set name="qanda.title.level5.properties"&gt;
11955   &lt;xsl:attribute name="font-size"&gt;
11956     &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;
11957     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
11958   &lt;/xsl:attribute&gt;
11959 &lt;/xsl:attribute-set&gt;
11960 </programlisting>
11961 </refsynopsisdiv>
11962
11963 <refsection><info><title>Description</title></info>
11964
11965 <para>The properties of level-5 qanda set titles.</para>
11966
11967 </refsection>
11968 </refentry>
11969
11970 <refentry version="5.0" xml:id="qanda.title.level6.properties">
11971 <refmeta>
11972 <refentrytitle>qanda.title.level6.properties</refentrytitle>
11973 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11974 </refmeta>
11975 <refnamediv>
11976 <refname>qanda.title.level6.properties</refname>
11977 <refpurpose>Properties for level-6 qanda set titles</refpurpose>
11978 </refnamediv>
11979
11980 <refsynopsisdiv>
11981 <programlisting xml:id="qanda.title.level6.properties.frag">
11982 &lt;xsl:attribute-set name="qanda.title.level6.properties"&gt;
11983   &lt;xsl:attribute name="font-size"&gt;
11984     &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;
11985     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
11986   &lt;/xsl:attribute&gt;
11987 &lt;/xsl:attribute-set&gt;
11988 </programlisting>
11989 </refsynopsisdiv>
11990
11991 <refsection><info><title>Description</title></info>
11992
11993 <para>The properties of level-6 qanda set titles.
11994 This property set is actually
11995 used for all titles below level 5.</para>
11996
11997 </refsection>
11998 </refentry>
11999
12000 <refentry version="5.0" xml:id="article.appendix.title.properties">
12001 <refmeta>
12002 <refentrytitle>article.appendix.title.properties</refentrytitle>
12003 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
12004 </refmeta>
12005 <refnamediv>
12006 <refname>article.appendix.title.properties</refname>
12007 <refpurpose>Properties for appendix titles that appear in an article</refpurpose>
12008 </refnamediv>
12009
12010 <refsynopsisdiv>
12011 <programlisting xml:id="article.appendix.title.properties.frag">
12012 &lt;xsl:attribute-set name="article.appendix.title.properties" use-attribute-sets="section.title.properties                          section.title.level1.properties"&gt;
12013 &lt;/xsl:attribute-set&gt;
12014 </programlisting>
12015 </refsynopsisdiv>
12016
12017 <refsection><info><title>Description</title></info>
12018
12019 <para>The properties for the title of an appendix that
12020 appears inside an article.  The default is to use
12021 the properties of sect1 titles.</para>
12022
12023 </refsection>
12024 </refentry>
12025
12026 <refentry version="5.0" xml:id="abstract.properties">
12027 <refmeta>
12028 <refentrytitle>abstract.properties</refentrytitle>
12029 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
12030 </refmeta>
12031 <refnamediv>
12032 <refname>abstract.properties</refname>
12033 <refpurpose>Properties associated with the block surrounding an abstract</refpurpose>
12034 </refnamediv>
12035
12036 <refsynopsisdiv>
12037 <programlisting xml:id="abstract.properties.frag">
12038 &lt;xsl:attribute-set name="abstract.properties"&gt;
12039   &lt;xsl:attribute name="start-indent"&gt;0.0in&lt;/xsl:attribute&gt;
12040   &lt;xsl:attribute name="end-indent"&gt;0.0in&lt;/xsl:attribute&gt;
12041 &lt;/xsl:attribute-set&gt;
12042 </programlisting>
12043 </refsynopsisdiv>
12044
12045 <refsection><info><title>Description</title></info>
12046
12047 <para>Block styling properties for abstract.</para>
12048
12049 <para>See also <parameter>abstract.title.properties</parameter>.</para>
12050
12051 </refsection>
12052 </refentry>
12053
12054 <refentry version="5.0" xml:id="abstract.title.properties">
12055 <refmeta>
12056 <refentrytitle>abstract.title.properties</refentrytitle>
12057 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
12058 </refmeta>
12059 <refnamediv>
12060 <refname>abstract.title.properties</refname>
12061 <refpurpose>Properties for abstract titles</refpurpose>
12062 </refnamediv>
12063
12064 <refsynopsisdiv>
12065 <programlisting xml:id="abstract.title.properties.frag">
12066 &lt;xsl:attribute-set name="abstract.title.properties"&gt;
12067   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$title.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
12068   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
12069   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
12070   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
12071   &lt;xsl:attribute name="space-before.optimum"&gt;&lt;xsl:value-of select="concat($body.font.master, 'pt')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
12072   &lt;xsl:attribute name="space-before.minimum"&gt;&lt;xsl:value-of select="concat($body.font.master, 'pt * 0.8')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
12073   &lt;xsl:attribute name="space-before.maximum"&gt;&lt;xsl:value-of select="concat($body.font.master, 'pt * 1.2')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
12074   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
12075   &lt;xsl:attribute name="text-align"&gt;center&lt;/xsl:attribute&gt;
12076 &lt;/xsl:attribute-set&gt;
12077 </programlisting>
12078 </refsynopsisdiv>
12079
12080 <refsection><info><title>Description</title></info>
12081
12082 <para>The properties for abstract titles.</para>
12083
12084 <para>See also <parameter>abstract.properties</parameter>.</para>
12085
12086 </refsection>
12087 </refentry>
12088
12089 <refentry version="5.0" xml:id="index.page.number.properties">
12090 <refmeta>
12091 <refentrytitle>index.page.number.properties</refentrytitle>
12092 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
12093 </refmeta>
12094 <refnamediv>
12095 <refname>index.page.number.properties</refname>
12096 <refpurpose>Properties associated with index page numbers</refpurpose>
12097 </refnamediv>
12098
12099 <refsynopsisdiv>
12100 <programlisting xml:id="index.page.number.properties.frag">
12101 &lt;xsl:attribute-set name="index.page.number.properties"&gt;
12102 &lt;/xsl:attribute-set&gt;
12103 </programlisting>
12104 </refsynopsisdiv>
12105
12106 <refsection><info><title>Description</title></info>
12107
12108 <para>Properties associated with page numbers in indexes.
12109 Changing color to indicate the page number is a link is
12110 one possibility.
12111 </para>
12112
12113 </refsection>
12114 </refentry>
12115
12116 <refentry version="5.0" xml:id="revhistory.table.properties">
12117 <refmeta>
12118 <refentrytitle>revhistory.table.properties</refentrytitle>
12119 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
12120 </refmeta>
12121 <refnamediv>
12122 <refname>revhistory.table.properties</refname>
12123 <refpurpose>The properties of table used for formatting revhistory</refpurpose>
12124 </refnamediv>
12125
12126 <refsynopsisdiv>
12127 <programlisting xml:id="revhistory.table.properties.frag">
12128 &lt;xsl:attribute-set name="revhistory.table.properties"&gt;
12129 &lt;/xsl:attribute-set&gt;
12130 </programlisting>
12131 </refsynopsisdiv>
12132
12133 <refsection><info><title>Description</title></info>
12134
12135 <para>This property set defines appearance of revhistory table.</para>
12136
12137 </refsection>
12138 </refentry>
12139
12140 <refentry version="5.0" xml:id="revhistory.table.cell.properties">
12141 <refmeta>
12142 <refentrytitle>revhistory.table.cell.properties</refentrytitle>
12143 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
12144 </refmeta>
12145 <refnamediv>
12146 <refname>revhistory.table.cell.properties</refname>
12147 <refpurpose>The properties of table cells used for formatting revhistory</refpurpose>
12148 </refnamediv>
12149
12150 <refsynopsisdiv>
12151 <programlisting xml:id="revhistory.table.cell.properties.frag">
12152 &lt;xsl:attribute-set name="revhistory.table.cell.properties"&gt;
12153 &lt;/xsl:attribute-set&gt;
12154 </programlisting>
12155 </refsynopsisdiv>
12156
12157 <refsection><info><title>Description</title></info>
12158
12159 <para>This property set defines appearance of individual cells in revhistory table.</para>
12160
12161 </refsection>
12162 </refentry>
12163
12164 <refentry version="5.0" xml:id="revhistory.title.properties">
12165 <refmeta>
12166 <refentrytitle>revhistory.title.properties</refentrytitle>
12167 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
12168 </refmeta>
12169 <refnamediv>
12170 <refname>revhistory.title.properties</refname>
12171 <refpurpose>The properties of revhistory title</refpurpose>
12172 </refnamediv>
12173
12174 <refsynopsisdiv>
12175 <programlisting xml:id="revhistory.title.properties.frag">
12176 &lt;xsl:attribute-set name="revhistory.title.properties"&gt;
12177 &lt;/xsl:attribute-set&gt;
12178 </programlisting>
12179 </refsynopsisdiv>
12180
12181 <refsection><info><title>Description</title></info>
12182
12183 <para>This property set defines appearance of revhistory title.</para>
12184
12185 </refsection>
12186 </refentry>
12187
12188 </reference>
12189 <reference xml:id="profiling"><title>Profiling</title>
12190 <partintro xml:id="profiling_partintro">
12191 <para>The following parameters can be used for attribute-based
12192 profiling of your document. For more information about profiling, see
12193 <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="Profiling.html">Profiling (conditional text)</link>.</para>
12194 </partintro>
12195 <refentry version="5.0" xml:id="profile.arch">
12196 <refmeta>
12197 <refentrytitle>profile.arch</refentrytitle>
12198 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12199 </refmeta>
12200 <refnamediv>
12201 <refname>profile.arch</refname>
12202 <refpurpose>Target profile for <tag class="attribute">arch</tag>
12203 attribute</refpurpose>
12204 </refnamediv>
12205
12206 <refsynopsisdiv>
12207 <programlisting xml:id="profile.arch.frag">
12208 &lt;xsl:param name="profile.arch"&gt;&lt;/xsl:param&gt;
12209 </programlisting>
12210 </refsynopsisdiv>
12211
12212
12213 <refsection><info><title>Description</title></info>
12214
12215 <para>The value of this parameter specifies profiles which should be
12216 included in the output. You can specify multiple profiles by
12217 separating them by semicolon. You can change separator character by
12218 <parameter>profile.separator</parameter>
12219 parameter.</para>
12220
12221 <para>This parameter has effect only when you are using profiling
12222 stylesheets (<filename>profile-docbook.xsl</filename>,
12223 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12224 ones (<filename>docbook.xsl</filename>,
12225 <filename>chunk.xsl</filename>, &#8230;).</para>
12226
12227 </refsection>
12228 </refentry>
12229
12230 <refentry version="5.0" xml:id="profile.audience">
12231 <refmeta>
12232 <refentrytitle>profile.audience</refentrytitle>
12233 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12234 </refmeta>
12235 <refnamediv>
12236 <refname>profile.audience</refname>
12237 <refpurpose>Target profile for <tag class="attribute">audience</tag>
12238 attribute</refpurpose>
12239 </refnamediv>
12240
12241 <refsynopsisdiv>
12242 <programlisting xml:id="profile.audience.frag">
12243 &lt;xsl:param name="profile.audience"&gt;&lt;/xsl:param&gt;
12244 </programlisting>
12245 </refsynopsisdiv>
12246
12247 <refsection><info><title>Description</title></info>
12248
12249 <para>Value of this parameter specifies profiles which should be
12250 included in the output. You can specify multiple profiles by
12251 separating them by semicolon. You can change separator character by
12252 <parameter>profile.separator</parameter>
12253 parameter.</para>
12254
12255 <para>This parameter has effect only when you are using profiling
12256 stylesheets (<filename>profile-docbook.xsl</filename>,
12257 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12258 ones (<filename>docbook.xsl</filename>,
12259 <filename>chunk.xsl</filename>, &#8230;).</para>
12260
12261 </refsection>
12262 </refentry>
12263
12264 <refentry version="5.0" xml:id="profile.condition">
12265 <refmeta>
12266 <refentrytitle>profile.condition</refentrytitle>
12267 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12268 </refmeta>
12269 <refnamediv>
12270 <refname>profile.condition</refname>
12271 <refpurpose>Target profile for <tag class="attribute">condition</tag>
12272 attribute</refpurpose>
12273 </refnamediv>
12274
12275 <refsynopsisdiv>
12276 <programlisting xml:id="profile.condition.frag">
12277 &lt;xsl:param name="profile.condition"&gt;&lt;/xsl:param&gt;
12278 </programlisting>
12279 </refsynopsisdiv>
12280
12281 <refsection><info><title>Description</title></info>
12282
12283 <para>The value of this parameter specifies profiles which should be
12284 included in the output. You can specify multiple profiles by
12285 separating them by semicolon. You can change separator character by
12286 <parameter>profile.separator</parameter>
12287 parameter.</para>
12288
12289 <para>This parameter has effect only when you are using profiling
12290 stylesheets (<filename>profile-docbook.xsl</filename>,
12291 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12292 ones (<filename>docbook.xsl</filename>,
12293 <filename>chunk.xsl</filename>, &#8230;).</para>
12294
12295 </refsection>
12296 </refentry>
12297
12298 <refentry version="5.0" xml:id="profile.conformance">
12299 <refmeta>
12300 <refentrytitle>profile.conformance</refentrytitle>
12301 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12302 </refmeta>
12303 <refnamediv>
12304 <refname>profile.conformance</refname>
12305 <refpurpose>Target profile for <tag class="attribute">conformance</tag>
12306 attribute</refpurpose>
12307 </refnamediv>
12308
12309 <refsynopsisdiv>
12310 <programlisting xml:id="profile.conformance.frag">
12311 &lt;xsl:param name="profile.conformance"&gt;&lt;/xsl:param&gt;
12312 </programlisting>
12313 </refsynopsisdiv>
12314
12315 <refsection><info><title>Description</title></info>
12316
12317 <para>The value of this parameter specifies profiles which should be
12318 included in the output. You can specify multiple profiles by
12319 separating them by semicolon. You can change separator character by
12320 <parameter>profile.separator</parameter>
12321 parameter.</para>
12322
12323 <para>This parameter has effect only when you are using profiling
12324 stylesheets (<filename>profile-docbook.xsl</filename>,
12325 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12326 ones (<filename>docbook.xsl</filename>,
12327 <filename>chunk.xsl</filename>, &#8230;).</para>
12328
12329 </refsection>
12330 </refentry>
12331
12332 <refentry version="5.0" xml:id="profile.lang">
12333 <refmeta>
12334 <refentrytitle>profile.lang</refentrytitle>
12335 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12336 </refmeta>
12337 <refnamediv>
12338 <refname>profile.lang</refname>
12339 <refpurpose>Target profile for <tag class="attribute">lang</tag>
12340 attribute</refpurpose>
12341 </refnamediv>
12342
12343 <refsynopsisdiv>
12344 <programlisting xml:id="profile.lang.frag">
12345 &lt;xsl:param name="profile.lang"&gt;&lt;/xsl:param&gt;
12346 </programlisting>
12347 </refsynopsisdiv>
12348
12349 <refsection><info><title>Description</title></info>
12350
12351 <para>The value of this parameter specifies profiles which should be
12352 included in the output. You can specify multiple profiles by
12353 separating them by semicolon. You can change separator character by
12354 <parameter>profile.separator</parameter>
12355 parameter.</para>
12356
12357 <para>This parameter has effect only when you are using profiling
12358 stylesheets (<filename>profile-docbook.xsl</filename>,
12359 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12360 ones (<filename>docbook.xsl</filename>,
12361 <filename>chunk.xsl</filename>, &#8230;).</para>
12362
12363 </refsection>
12364 </refentry>
12365
12366 <refentry version="5.0" xml:id="profile.os">
12367 <refmeta>
12368 <refentrytitle>profile.os</refentrytitle>
12369 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12370 </refmeta>
12371 <refnamediv>
12372 <refname>profile.os</refname>
12373 <refpurpose>Target profile for <tag class="attribute">os</tag>
12374 attribute</refpurpose>
12375 </refnamediv>
12376
12377 <refsynopsisdiv>
12378 <programlisting xml:id="profile.os.frag">
12379 &lt;xsl:param name="profile.os"&gt;&lt;/xsl:param&gt;
12380 </programlisting>
12381 </refsynopsisdiv>
12382
12383 <refsection><info><title>Description</title></info>
12384
12385 <para>The value of this parameter specifies profiles which should be
12386 included in the output. You can specify multiple profiles by
12387 separating them by semicolon. You can change separator character by
12388 <parameter>profile.separator</parameter>
12389 parameter.</para>
12390
12391 <para>This parameter has effect only when you are using profiling
12392 stylesheets (<filename>profile-docbook.xsl</filename>,
12393 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12394 ones (<filename>docbook.xsl</filename>,
12395 <filename>chunk.xsl</filename>, &#8230;).</para>
12396
12397 </refsection>
12398 </refentry>
12399
12400 <refentry version="5.0" xml:id="profile.outputformat">
12401 <refmeta>
12402 <refentrytitle>profile.outputformat</refentrytitle>
12403 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12404 </refmeta>
12405 <refnamediv>
12406     <refname>profile.outputformat</refname>
12407     <refpurpose>Target profile for <tag class="attribute">outputformat</tag> attribute</refpurpose>
12408   </refnamediv>
12409
12410 <refsynopsisdiv>
12411 <programlisting xml:id="profile.outputformat.frag">
12412 &lt;xsl:param name="profile.outputformat"&gt;&lt;/xsl:param&gt;
12413 </programlisting>
12414 </refsynopsisdiv>
12415
12416 <refsection><info><title>Description</title></info>
12417
12418 <para>The value of this parameter specifies profiles which should be
12419 included in the output. You can specify multiple profiles by
12420 separating them by semicolon. You can change separator character by
12421 <parameter>profile.separator</parameter>
12422 parameter.</para>
12423
12424 <para>This parameter has effect only when you are using profiling
12425 stylesheets (<filename>profile-docbook.xsl</filename>,
12426 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12427 ones (<filename>docbook.xsl</filename>,
12428 <filename>chunk.xsl</filename>, &#8230;).</para>
12429
12430 </refsection>
12431 </refentry>
12432
12433 <refentry version="5.0" xml:id="profile.revision">
12434 <refmeta>
12435 <refentrytitle>profile.revision</refentrytitle>
12436 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12437 </refmeta>
12438 <refnamediv>
12439 <refname>profile.revision</refname>
12440 <refpurpose>Target profile for <tag class="attribute">revision</tag>
12441 attribute</refpurpose>
12442 </refnamediv>
12443
12444 <refsynopsisdiv>
12445 <programlisting xml:id="profile.revision.frag">
12446 &lt;xsl:param name="profile.revision"&gt;&lt;/xsl:param&gt;
12447 </programlisting>
12448 </refsynopsisdiv>
12449
12450 <refsection><info><title>Description</title></info>
12451
12452 <para>The value of this parameter specifies profiles which should be
12453 included in the output. You can specify multiple profiles by
12454 separating them by semicolon. You can change separator character by
12455 <parameter>profile.separator</parameter>
12456 parameter.</para>
12457
12458 <para>This parameter has effect only when you are using profiling
12459 stylesheets (<filename>profile-docbook.xsl</filename>,
12460 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12461 ones (<filename>docbook.xsl</filename>,
12462 <filename>chunk.xsl</filename>, &#8230;).</para>
12463
12464 </refsection>
12465 </refentry>
12466
12467 <refentry version="5.0" xml:id="profile.revisionflag">
12468 <refmeta>
12469 <refentrytitle>profile.revisionflag</refentrytitle>
12470 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12471 </refmeta>
12472 <refnamediv>
12473 <refname>profile.revisionflag</refname>
12474 <refpurpose>Target profile for <tag class="attribute">revisionflag</tag>
12475 attribute</refpurpose>
12476 </refnamediv>
12477
12478 <refsynopsisdiv>
12479 <programlisting xml:id="profile.revisionflag.frag">
12480 &lt;xsl:param name="profile.revisionflag"&gt;&lt;/xsl:param&gt;
12481 </programlisting>
12482 </refsynopsisdiv>
12483
12484 <refsection><info><title>Description</title></info>
12485
12486 <para>The value of this parameter specifies profiles which should be
12487 included in the output. You can specify multiple profiles by
12488 separating them by semicolon. You can change separator character by
12489 <parameter>profile.separator</parameter>
12490 parameter.</para>
12491
12492 <para>This parameter has effect only when you are using profiling
12493 stylesheets (<filename>profile-docbook.xsl</filename>,
12494 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12495 ones (<filename>docbook.xsl</filename>,
12496 <filename>chunk.xsl</filename>, &#8230;).</para>
12497
12498 </refsection>
12499 </refentry>
12500
12501 <refentry version="5.0" xml:id="profile.role">
12502 <refmeta>
12503 <refentrytitle>profile.role</refentrytitle>
12504 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12505 </refmeta>
12506 <refnamediv>
12507 <refname>profile.role</refname>
12508 <refpurpose>Target profile for <tag class="attribute">role</tag>
12509 attribute</refpurpose>
12510 </refnamediv>
12511
12512 <refsynopsisdiv>
12513 <programlisting xml:id="profile.role.frag">
12514 &lt;xsl:param name="profile.role"&gt;&lt;/xsl:param&gt;
12515 </programlisting>
12516 </refsynopsisdiv>
12517
12518 <refsection><info><title>Description</title></info>
12519
12520 <para>The value of this parameter specifies profiles which should be
12521 included in the output. You can specify multiple profiles by
12522 separating them by semicolon. You can change separator character by
12523 <parameter>profile.separator</parameter>
12524 parameter.</para>
12525
12526 <para>This parameter has effect only when you are using profiling
12527 stylesheets (<filename>profile-docbook.xsl</filename>,
12528 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12529 ones (<filename>docbook.xsl</filename>,
12530 <filename>chunk.xsl</filename>, &#8230;).</para>
12531
12532 <warning>
12533 <para>Note that <tag class="attribute">role</tag> is often
12534 used for other purposes than profiling. For example it is commonly
12535 used to get emphasize in bold font:</para>
12536
12537 <programlisting>&lt;emphasis role="bold"&gt;very important&lt;/emphasis&gt;</programlisting>
12538
12539 <para>If you are using <tag class="attribute">role</tag> for
12540 these purposes do not forget to add values like <literal>bold</literal> to
12541 value of this parameter. If you forgot you will get document with
12542 small pieces missing which are very hard to track.</para>
12543
12544 <para>For this reason it is not recommended to use <tag class="attribute">role</tag> attribute for profiling. You should
12545 rather use profiling specific attributes like <tag class="attribute">userlevel</tag>, <tag class="attribute">os</tag>, <tag class="attribute">arch</tag>, <tag class="attribute">condition</tag>, etc.</para>
12546 </warning>
12547
12548 </refsection>
12549 </refentry>
12550
12551 <refentry version="5.0" xml:id="profile.security">
12552 <refmeta>
12553 <refentrytitle>profile.security</refentrytitle>
12554 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12555 </refmeta>
12556 <refnamediv>
12557 <refname>profile.security</refname>
12558 <refpurpose>Target profile for <tag class="attribute">security</tag>
12559 attribute</refpurpose>
12560 </refnamediv>
12561
12562 <refsynopsisdiv>
12563 <programlisting xml:id="profile.security.frag">
12564 &lt;xsl:param name="profile.security"&gt;&lt;/xsl:param&gt;
12565 </programlisting>
12566 </refsynopsisdiv>
12567
12568 <refsection><info><title>Description</title></info>
12569
12570 <para>The value of this parameter specifies profiles which should be
12571 included in the output. You can specify multiple profiles by
12572 separating them by semicolon. You can change separator character by
12573 <parameter>profile.separator</parameter>
12574 parameter.</para>
12575
12576 <para>This parameter has effect only when you are using profiling
12577 stylesheets (<filename>profile-docbook.xsl</filename>,
12578 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12579 ones (<filename>docbook.xsl</filename>,
12580 <filename>chunk.xsl</filename>, &#8230;).</para>
12581
12582 </refsection>
12583 </refentry>
12584
12585 <refentry version="5.0" xml:id="profile.status">
12586 <refmeta>
12587 <refentrytitle>profile.status</refentrytitle>
12588 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12589 </refmeta>
12590 <refnamediv>
12591 <refname>profile.status</refname>
12592 <refpurpose>Target profile for <tag class="attribute">status</tag>
12593 attribute</refpurpose>
12594 </refnamediv>
12595
12596 <refsynopsisdiv>
12597 <programlisting xml:id="profile.status.frag">
12598 &lt;xsl:param name="profile.status"&gt;&lt;/xsl:param&gt;
12599 </programlisting>
12600 </refsynopsisdiv>
12601
12602 <refsection><info><title>Description</title></info>
12603
12604 <para>The value of this parameter specifies profiles which should be
12605 included in the output. You can specify multiple profiles by
12606 separating them by semicolon. You can change separator character by
12607 <parameter>profile.separator</parameter>
12608 parameter.</para>
12609
12610 <para>This parameter has effect only when you are using profiling
12611 stylesheets (<filename>profile-docbook.xsl</filename>,
12612 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12613 ones (<filename>docbook.xsl</filename>,
12614 <filename>chunk.xsl</filename>, &#8230;).</para>
12615
12616 </refsection>
12617 </refentry>
12618
12619 <refentry version="5.0" xml:id="profile.userlevel">
12620 <refmeta>
12621 <refentrytitle>profile.userlevel</refentrytitle>
12622 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12623 </refmeta>
12624 <refnamediv>
12625 <refname>profile.userlevel</refname>
12626 <refpurpose>Target profile for <tag class="attribute">userlevel</tag>
12627 attribute</refpurpose>
12628 </refnamediv>
12629
12630 <refsynopsisdiv>
12631 <programlisting xml:id="profile.userlevel.frag">
12632 &lt;xsl:param name="profile.userlevel"&gt;&lt;/xsl:param&gt;
12633 </programlisting>
12634 </refsynopsisdiv>
12635
12636 <refsection><info><title>Description</title></info>
12637
12638 <para>The value of this parameter specifies profiles which should be
12639 included in the output. You can specify multiple profiles by
12640 separating them by semicolon. You can change separator character by
12641 <parameter>profile.separator</parameter>
12642 parameter.</para>
12643
12644 <para>This parameter has effect only when you are using profiling
12645 stylesheets (<filename>profile-docbook.xsl</filename>,
12646 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12647 ones (<filename>docbook.xsl</filename>,
12648 <filename>chunk.xsl</filename>, &#8230;).</para>
12649
12650 </refsection>
12651 </refentry>
12652
12653 <refentry version="5.0" xml:id="profile.vendor">
12654 <refmeta>
12655 <refentrytitle>profile.vendor</refentrytitle>
12656 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12657 </refmeta>
12658 <refnamediv>
12659 <refname>profile.vendor</refname>
12660 <refpurpose>Target profile for <tag class="attribute">vendor</tag>
12661 attribute</refpurpose>
12662 </refnamediv>
12663
12664 <refsynopsisdiv>
12665 <programlisting xml:id="profile.vendor.frag">
12666 &lt;xsl:param name="profile.vendor"&gt;&lt;/xsl:param&gt;
12667 </programlisting>
12668 </refsynopsisdiv>
12669
12670 <refsection><info><title>Description</title></info>
12671
12672 <para>The value of this parameter specifies profiles which should be
12673 included in the output. You can specify multiple profiles by
12674 separating them by semicolon. You can change separator character by
12675 <parameter>profile.separator</parameter>
12676 parameter.</para>
12677
12678 <para>This parameter has effect only when you are using profiling
12679 stylesheets (<filename>profile-docbook.xsl</filename>,
12680 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12681 ones (<filename>docbook.xsl</filename>,
12682 <filename>chunk.xsl</filename>, &#8230;).</para>
12683
12684 </refsection>
12685 </refentry>
12686
12687 <refentry version="5.0" xml:id="profile.wordsize">
12688 <refmeta>
12689 <refentrytitle>profile.wordsize</refentrytitle>
12690 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12691 </refmeta>
12692 <refnamediv>
12693 <refname>profile.wordsize</refname>
12694 <refpurpose>Target profile for <tag class="attribute">wordsize</tag>
12695 attribute</refpurpose>
12696 </refnamediv>
12697
12698 <refsynopsisdiv>
12699 <programlisting xml:id="profile.wordsize.frag">
12700 &lt;xsl:param name="profile.wordsize"&gt;&lt;/xsl:param&gt;
12701 </programlisting>
12702 </refsynopsisdiv>
12703
12704 <refsection><info><title>Description</title></info>
12705
12706 <para>The value of this parameter specifies profiles which should be
12707 included in the output. You can specify multiple profiles by
12708 separating them by semicolon. You can change separator character by
12709 <parameter>profile.separator</parameter>
12710 parameter.</para>
12711
12712 <para>This parameter has effect only when you are using profiling
12713 stylesheets (<filename>profile-docbook.xsl</filename>,
12714 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12715 ones (<filename>docbook.xsl</filename>,
12716 <filename>chunk.xsl</filename>, &#8230;).</para>
12717
12718 </refsection>
12719 </refentry>
12720
12721 <refentry version="5.0" xml:id="profile.attribute">
12722 <refmeta>
12723 <refentrytitle>profile.attribute</refentrytitle>
12724 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12725 </refmeta>
12726 <refnamediv>
12727 <refname>profile.attribute</refname>
12728 <refpurpose>Name of user-specified profiling attribute</refpurpose>
12729 </refnamediv>
12730
12731 <refsynopsisdiv>
12732 <programlisting xml:id="profile.attribute.frag">
12733 &lt;xsl:param name="profile.attribute"&gt;&lt;/xsl:param&gt;
12734 </programlisting>
12735 </refsynopsisdiv>
12736
12737 <refsection><info><title>Description</title></info>
12738
12739 <para>This parameter is used in conjuction with
12740 <parameter>profile.value</parameter>.</para>
12741
12742 <para>This parameter has effect only when you are using profiling
12743 stylesheets (<filename>profile-docbook.xsl</filename>,
12744 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12745 ones (<filename>docbook.xsl</filename>,
12746 <filename>chunk.xsl</filename>, &#8230;).</para>
12747
12748 </refsection>
12749 </refentry>
12750
12751 <refentry version="5.0" xml:id="profile.value">
12752 <refmeta>
12753 <refentrytitle>profile.value</refentrytitle>
12754 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12755 </refmeta>
12756 <refnamediv>
12757 <refname>profile.value</refname>
12758 <refpurpose>Target profile for user-specified attribute</refpurpose>
12759 </refnamediv>
12760
12761 <refsynopsisdiv>
12762 <programlisting xml:id="profile.value.frag">
12763 &lt;xsl:param name="profile.value"&gt;&lt;/xsl:param&gt;
12764 </programlisting>
12765 </refsynopsisdiv>
12766
12767 <refsection><info><title>Description</title></info>
12768
12769 <para>When you are using this parameter you must also specify name of
12770 profiling attribute with parameter
12771 <parameter>profile.attribute</parameter>.</para>
12772
12773 <para>The value of this parameter specifies profiles which should be
12774 included in the output. You can specify multiple profiles by
12775 separating them by semicolon. You can change separator character by
12776 <parameter>profile.separator</parameter>
12777 parameter.</para>
12778
12779 <para>This parameter has effect only when you are using profiling
12780 stylesheets (<filename>profile-docbook.xsl</filename>,
12781 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
12782 ones (<filename>docbook.xsl</filename>,
12783 <filename>chunk.xsl</filename>, &#8230;).</para>
12784
12785 </refsection>
12786 </refentry>
12787
12788 <refentry version="5.0" xml:id="profile.separator">
12789 <refmeta>
12790 <refentrytitle>profile.separator</refentrytitle>
12791 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12792 </refmeta>
12793 <refnamediv>
12794 <refname>profile.separator</refname>
12795 <refpurpose>Separator character for compound profile values</refpurpose>
12796 </refnamediv>
12797
12798 <refsynopsisdiv>
12799 <programlisting xml:id="profile.separator.frag">
12800 &lt;xsl:param name="profile.separator"&gt;;&lt;/xsl:param&gt;
12801 </programlisting>
12802 </refsynopsisdiv>
12803
12804 <refsection><info><title>Description</title></info>
12805
12806 <para>Separator character used for compound profile values. See <parameter>profile.arch</parameter></para>
12807
12808 </refsection>
12809 </refentry>
12810
12811 </reference>
12812 <reference xml:id="l10n"><title>Localization</title>
12813 <refentry version="5.0" xml:id="l10n.gentext.language">
12814 <refmeta>
12815 <refentrytitle>l10n.gentext.language</refentrytitle>
12816 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12817 </refmeta>
12818 <refnamediv>
12819 <refname>l10n.gentext.language</refname>
12820 <refpurpose>Sets the gentext language</refpurpose>
12821 </refnamediv>
12822
12823 <refsynopsisdiv>
12824 <programlisting xml:id="l10n.gentext.language.frag">
12825 &lt;xsl:param name="l10n.gentext.language"&gt;&lt;/xsl:param&gt;
12826 </programlisting>
12827 </refsynopsisdiv>
12828
12829 <refsection><info><title>Description</title></info>
12830
12831 <para>If this parameter is set to any value other than the empty string, its
12832 value will be used as the value for the language when generating text. Setting
12833 <parameter>l10n.gentext.language</parameter> overrides any settings within the
12834 document being formatted.</para>
12835
12836 <para>It's much more likely that you might want to set the
12837 <parameter>l10n.gentext.default.language</parameter> parameter.</para>
12838
12839 </refsection>
12840 </refentry>
12841
12842 <refentry version="5.0" xml:id="l10n.gentext.default.language">
12843   <refmeta>
12844     <refentrytitle>l10n.gentext.default.language</refentrytitle>
12845     <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12846   </refmeta>
12847   <refnamediv>
12848     <refname>l10n.gentext.default.language</refname>
12849     <refpurpose>Sets the default language for generated text</refpurpose>
12850   </refnamediv>
12851
12852   <refsynopsisdiv>
12853 <programlisting xml:id="l10n.gentext.default.language.frag">
12854 &lt;xsl:param name="l10n.gentext.default.language"&gt;en&lt;/xsl:param&gt;
12855 </programlisting>
12856 </refsynopsisdiv>
12857
12858 <refsection><info><title>Description</title></info>
12859
12860 <para>The value of the <parameter>l10n.gentext.default.language</parameter>
12861 parameter is used as the language for generated text if no setting is provided
12862 in the source document.</para>
12863
12864 </refsection>
12865 </refentry>
12866
12867 <refentry version="5.0" xml:id="l10n.gentext.use.xref.language">
12868 <refmeta>
12869 <refentrytitle>l10n.gentext.use.xref.language</refentrytitle>
12870 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
12871 </refmeta>
12872 <refnamediv>
12873 <refname>l10n.gentext.use.xref.language</refname>
12874 <refpurpose>Use the language of target when generating cross-reference text?</refpurpose>
12875 </refnamediv>
12876
12877 <refsynopsisdiv>
12878 <programlisting xml:id="l10n.gentext.use.xref.language.frag">
12879 &lt;xsl:param name="l10n.gentext.use.xref.language" select="0"&gt;&lt;/xsl:param&gt;
12880 </programlisting>
12881 </refsynopsisdiv>
12882
12883 <refsection><info><title>Description</title></info>
12884
12885 <para>If non-zero, the language of the target will be used when
12886 generating cross reference text. Usually, the <quote>current</quote>
12887 language is used when generating text (that is, the language of the
12888 element that contains the cross-reference element). But setting this parameter
12889 allows the language of the element <emphasis>pointed to</emphasis> to control
12890 the generated text.</para>
12891
12892 <para>Consider the following example:</para>
12893
12894 <informalexample>
12895 <programlisting>&lt;para lang="en"&gt;See also &lt;xref linkend="chap3"/&gt;.&lt;/para&gt;
12896 </programlisting>
12897 </informalexample>
12898
12899 <para>Suppose that Chapter 3 happens to be written in German.
12900 If <parameter>l10n.gentext.use.xref.language</parameter> is non-zero, the
12901 resulting text will be something like this:</para>
12902
12903 <blockquote>
12904 <para>See also Kapital 3.</para>
12905 </blockquote>
12906
12907 <para>Where the more traditional rendering would be:</para>
12908
12909 <blockquote>
12910 <para>See also Chapter 3.</para>
12911 </blockquote>
12912
12913 </refsection>
12914 </refentry>
12915
12916 <refentry version="5.0" xml:id="l10n.lang.value.rfc.compliant">
12917 <refmeta>
12918 <refentrytitle>l10n.lang.value.rfc.compliant</refentrytitle>
12919 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
12920 </refmeta>
12921 <refnamediv>
12922 <refname>l10n.lang.value.rfc.compliant</refname>
12923 <refpurpose>Make value of lang attribute RFC compliant?</refpurpose>
12924 </refnamediv>
12925
12926 <refsynopsisdiv>
12927 <programlisting xml:id="l10n.lang.value.rfc.compliant.frag">
12928 &lt;xsl:param name="l10n.lang.value.rfc.compliant" select="1"&gt;&lt;/xsl:param&gt;
12929 </programlisting>
12930 </refsynopsisdiv>
12931
12932 <refsection><info><title>Description</title></info>
12933
12934 <para>If non-zero, ensure that the values for all <tag class="attribute">lang</tag> attributes in HTML output are RFC
12935 compliant<footnote><para>Section 8.1.1, <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/REC-html40/struct/dirlang.html#h-8.1.1">Language Codes</link>, in the HTML 4.0 Recommendation states that:
12936
12937 <blockquote><para>[RFC1766] defines and explains the language codes
12938 that must be used in HTML documents.</para>
12939 <para>Briefly, language codes consist of a primary code and a possibly
12940 empty series of subcodes:
12941
12942 <literallayout class="monospaced">language-code = primary-code ( "-" subcode )*</literallayout>
12943 </para>
12944 <para>And in RFC 1766, <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.ietf.org/rfc/rfc1766.txt">Tags for the Identification
12945 of Languages</link>, the EBNF for "language tag" is given as:
12946
12947 <literallayout class="monospaced">Language-Tag = Primary-tag *( "-" Subtag )
12948 Primary-tag = 1*8ALPHA
12949 Subtag = 1*8ALPHA</literallayout>
12950 </para>
12951 </blockquote>
12952 </para></footnote>.
12953
12954 by taking any underscore characters in any <tag class="attribute">lang</tag> values found in source documents, and
12955 replacing them with hyphen characters in output HTML files. For
12956 example, <literal>zh_CN</literal> in a source document becomes
12957 <literal>zh-CN</literal> in the HTML output form that source.
12958
12959 <note>
12960 <para>This parameter does not cause any case change in <tag class="attribute">lang</tag> values, because RFC 1766
12961 explicitly states that all "language tags" (as it calls them) "are
12962 to be treated as case insensitive".</para>
12963 </note>
12964 </para>
12965
12966 </refsection>
12967 </refentry>
12968
12969 <refentry version="5.0" xml:id="writing.mode">
12970 <refmeta>
12971 <refentrytitle>writing.mode</refentrytitle>
12972 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
12973 </refmeta>
12974 <refnamediv>
12975 <refname>writing.mode</refname>
12976 <refpurpose>Direction of text flow based on locale</refpurpose>
12977 </refnamediv>
12978
12979 <refsynopsisdiv>
12980 <programlisting xml:id="writing.mode.frag">
12981 &lt;xsl:param name="writing.mode"&gt;
12982   &lt;xsl:call-template name="gentext"&gt;
12983     &lt;xsl:with-param name="key"&gt;writing-mode&lt;/xsl:with-param&gt;
12984     &lt;xsl:with-param name="lang"&gt;
12985       &lt;xsl:call-template name="l10n.language"&gt;
12986         &lt;xsl:with-param name="target" select="/*[1]"&gt;&lt;/xsl:with-param&gt;
12987       &lt;/xsl:call-template&gt;
12988     &lt;/xsl:with-param&gt;
12989   &lt;/xsl:call-template&gt;
12990 &lt;/xsl:param&gt;
12991 </programlisting>
12992 </refsynopsisdiv>
12993
12994 <refsection><info><title>Description</title></info>
12995
12996 <para>Sets direction of text flow and text alignment based on locale.
12997 The value is normally taken from the gentext file for the
12998 lang attribute of the document's root element, using the
12999 key name 'writing-mode' to look it up in the gentext file.
13000 But this param can also be
13001 set on the command line to override that gentext value.
13002 </para>
13003 <para>Accepted values are:
13004 <variablelist>
13005   <varlistentry>
13006     <term>lr-tb</term>
13007     <listitem>
13008       <para>Left-to-right text flow in each line, lines stack top to bottom.</para>
13009     </listitem>
13010   </varlistentry>
13011   <varlistentry>
13012     <term>rl-tb</term>
13013     <listitem>
13014       <para>Right-to-left text flow in each line, lines stack top to bottom.</para>
13015     </listitem>
13016   </varlistentry>
13017   <varlistentry>
13018     <term>tb-rl</term>
13019     <listitem>
13020       <para>Top-to-bottom text flow in each vertical line, lines stack right to left.
13021       Supported by only a few XSL-FO processors. Not supported in HTML output.</para>
13022     </listitem>
13023   </varlistentry>
13024   <varlistentry>
13025     <term>lr</term>
13026     <listitem>
13027       <para>Shorthand for lr-tb.</para>
13028     </listitem>
13029   </varlistentry>
13030   <varlistentry>
13031     <term>rl</term>
13032     <listitem>
13033       <para>Shorthand for rl-tb.</para>
13034     </listitem>
13035   </varlistentry>
13036   <varlistentry>
13037     <term>tb</term>
13038     <listitem>
13039       <para>Shorthand for tb-rl.</para>
13040     </listitem>
13041   </varlistentry>
13042 </variablelist>
13043 </para>
13044
13045 </refsection>
13046 </refentry>
13047
13048 </reference>
13049 <reference xml:id="ebnf"><title>EBNF</title>
13050 <refentry version="5.0" xml:id="ebnf.assignment">
13051 <refmeta>
13052 <refentrytitle>ebnf.assignment</refentrytitle>
13053 <refmiscinfo class="other" otherclass="datatype">rtf</refmiscinfo>
13054 </refmeta>
13055 <refnamediv>
13056 <refname>ebnf.assignment</refname>
13057 <refpurpose>The EBNF production assignment operator</refpurpose>
13058 </refnamediv>
13059
13060 <refsynopsisdiv>
13061 <programlisting xml:id="ebnf.assignment.frag">
13062
13063 &lt;xsl:param name="ebnf.assignment"&gt;
13064   &lt;fo:inline font-family="{$monospace.font.family}"&gt;
13065     &lt;xsl:text&gt;::=&lt;/xsl:text&gt;
13066   &lt;/fo:inline&gt;
13067 &lt;/xsl:param&gt;
13068 </programlisting>
13069 </refsynopsisdiv>
13070
13071 <refsection><info><title>Description</title></info>
13072
13073 <para>The <parameter>ebnf.assignment</parameter> parameter determines what
13074 text is used to show <quote>assignment</quote> in <tag>production</tag>s
13075 in <tag>productionset</tag>s.</para>
13076
13077 <para>While <quote><literal>::=</literal></quote> is common, so are several
13078 other operators.</para>
13079
13080 </refsection>
13081 </refentry>
13082
13083 <refentry version="5.0" xml:id="ebnf.statement.terminator">
13084 <refmeta>
13085 <refentrytitle>ebnf.statement.terminator</refentrytitle>
13086 <refmiscinfo class="other" otherclass="datatype">rtf</refmiscinfo>
13087 </refmeta>
13088 <refnamediv>
13089 <refname>ebnf.statement.terminator</refname>
13090 <refpurpose>Punctuation that ends an EBNF statement.</refpurpose>
13091 </refnamediv>
13092
13093 <refsynopsisdiv>
13094 <programlisting xml:id="ebnf.statement.terminator.frag">
13095
13096 &lt;xsl:param name="ebnf.statement.terminator"&gt;&lt;/xsl:param&gt;
13097 </programlisting>
13098 </refsynopsisdiv>
13099
13100 <refsection><info><title>Description</title></info>
13101
13102 <para>The <parameter>ebnf.statement.terminator</parameter> parameter determines what
13103 text is used to terminate each <tag>production</tag>
13104 in <tag>productionset</tag>.</para>
13105
13106 <para>Some notations end each statement with a period.</para>
13107
13108 </refsection>
13109 </refentry>
13110
13111 </reference>
13112 <reference xml:id="prepress"><title>Prepress</title>
13113 <refentry version="5.0" xml:id="crop.marks">
13114 <refmeta>
13115 <refentrytitle>crop.marks</refentrytitle>
13116 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
13117 </refmeta>
13118 <refnamediv>
13119 <refname>crop.marks</refname>
13120 <refpurpose>Output crop marks?</refpurpose>
13121 </refnamediv>
13122
13123 <refsynopsisdiv>
13124 <programlisting xml:id="crop.marks.frag">
13125 &lt;xsl:param name="crop.marks" select="0"&gt;&lt;/xsl:param&gt;
13126 </programlisting>
13127 </refsynopsisdiv>
13128
13129 <refsection><info><title>Description</title></info>
13130
13131 <para>If non-zero, crop marks will be added to each page. Currently this
13132 works only with XEP if you have <parameter>xep.extensions</parameter> set.</para>
13133
13134 </refsection>
13135 </refentry>
13136
13137 <refentry version="5.0" xml:id="crop.mark.width">
13138 <refmeta>
13139 <refentrytitle>crop.mark.width</refentrytitle>
13140 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
13141 </refmeta>
13142 <refnamediv>
13143 <refname>crop.mark.width</refname>
13144 <refpurpose>Width of crop marks.</refpurpose>
13145 </refnamediv>
13146
13147 <refsynopsisdiv>
13148 <programlisting xml:id="crop.mark.width.frag">
13149 &lt;xsl:param name="crop.mark.width"&gt;0.5pt&lt;/xsl:param&gt;
13150 </programlisting>
13151 </refsynopsisdiv>
13152
13153 <refsection><info><title>Description</title></info>
13154
13155 <para>Width of crop marks. Crop marks are controlled by
13156 <parameter>crop.marks</parameter> parameter.</para>
13157
13158 </refsection>
13159 </refentry>
13160
13161 <refentry version="5.0" xml:id="crop.mark.offset">
13162 <refmeta>
13163 <refentrytitle>crop.mark.offset</refentrytitle>
13164 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
13165 </refmeta>
13166 <refnamediv>
13167 <refname>crop.mark.offset</refname>
13168 <refpurpose>Length of crop marks.</refpurpose>
13169 </refnamediv>
13170
13171 <refsynopsisdiv>
13172 <programlisting xml:id="crop.mark.offset.frag">
13173 &lt;xsl:param name="crop.mark.offset"&gt;24pt&lt;/xsl:param&gt;
13174 </programlisting>
13175 </refsynopsisdiv>
13176
13177 <refsection><info><title>Description</title></info>
13178
13179 <para>Length of crop marks. Crop marks are controlled by
13180 <parameter>crop.marks</parameter> parameter.</para>
13181
13182 </refsection>
13183 </refentry>
13184
13185 <refentry version="5.0" xml:id="crop.mark.bleed">
13186 <refmeta>
13187 <refentrytitle>crop.mark.bleed</refentrytitle>
13188 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
13189 </refmeta>
13190 <refnamediv>
13191 <refname>crop.mark.bleed</refname>
13192 <refpurpose>Length of invisible part of crop marks.</refpurpose>
13193 </refnamediv>
13194
13195 <refsynopsisdiv>
13196 <programlisting xml:id="crop.mark.bleed.frag">
13197 &lt;xsl:param name="crop.mark.bleed"&gt;6pt&lt;/xsl:param&gt;
13198 </programlisting>
13199 </refsynopsisdiv>
13200
13201 <refsection><info><title>Description</title></info>
13202
13203 <para>Length of invisible part of crop marks. Crop marks are controlled by
13204 <parameter>crop.marks</parameter> parameter.</para>
13205
13206 </refsection>
13207 </refentry>
13208
13209 </reference>
13210 <reference xml:id="publishers"><title>DocBook Publishers</title>
13211 <refentry version="5.0" xml:id="publishers.properties">
13212 <refmeta>
13213 <refentrytitle>publishers.properties</refentrytitle>
13214 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
13215 </refmeta>
13216 <refnamediv>
13217 <refname>publishers.properties</refname>
13218 <refpurpose>Properties shared with the DocBook Publishers
13219 elements drama, poetry, and dialogue. </refpurpose>
13220 </refnamediv>
13221
13222 <refsynopsisdiv>
13223 <programlisting xml:id="publishers.properties.frag">
13224 &lt;xsl:attribute-set name="publishers.properties"&gt;
13225   &lt;xsl:attribute name="space-before"&gt;1em&lt;/xsl:attribute&gt;
13226   &lt;xsl:attribute name="space-after"&gt;1em&lt;/xsl:attribute&gt;
13227   &lt;xsl:attribute name="keep-together.within-column"&gt;auto&lt;/xsl:attribute&gt;
13228 &lt;/xsl:attribute-set&gt;
13229 </programlisting>
13230 </refsynopsisdiv>
13231
13232 <refsection><info><title>Description</title></info>
13233
13234 <para>This <literal>attribute set</literal> is used for common
13235 properties shared by the DocBook Publishers elements
13236 <tag>dialogue</tag>,
13237 <tag>drama</tag>, and <tag>poetry</tag>.
13238 It is imported into each of the individual
13239 attribute sets for those elements.
13240 </para>
13241
13242 </refsection>
13243 </refentry>
13244
13245 <refentry version="5.0" xml:id="dialogue.properties">
13246 <refmeta>
13247 <refentrytitle>dialogue.properties</refentrytitle>
13248 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
13249 </refmeta>
13250 <refnamediv>
13251 <refname>dialogue.properties</refname>
13252 <refpurpose>Properties applied to the DocBook Publishers dialogue element</refpurpose>
13253 </refnamediv>
13254
13255 <refsynopsisdiv>
13256 <programlisting xml:id="dialogue.properties.frag">
13257 &lt;xsl:attribute-set name="dialogue.properties" use-attribute-sets="publishers.properties"&gt;&lt;/xsl:attribute-set&gt;
13258 </programlisting>
13259 </refsynopsisdiv>
13260
13261 <refsection><info><title>Description</title></info>
13262
13263 <para>This <literal>attribute set</literal> is applied to the output
13264 block for the DocBook Publishers <tag>dialogue</tag> element.
13265 By default, it imports the attributes defined in the
13266 <tag>publishers.properties</tag> attribute-set.
13267 </para>
13268
13269 </refsection>
13270 </refentry>
13271
13272 <refentry version="5.0" xml:id="drama.properties">
13273 <refmeta>
13274 <refentrytitle>drama.properties</refentrytitle>
13275 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
13276 </refmeta>
13277 <refnamediv>
13278 <refname>drama.properties</refname>
13279 <refpurpose>Properties applied to the DocBook Publishers drama element</refpurpose>
13280 </refnamediv>
13281
13282 <refsynopsisdiv>
13283 <programlisting xml:id="drama.properties.frag">
13284 &lt;xsl:attribute-set name="drama.properties" use-attribute-sets="publishers.properties"&gt;&lt;/xsl:attribute-set&gt;
13285 </programlisting>
13286 </refsynopsisdiv>
13287
13288 <refsection><info><title>Description</title></info>
13289
13290 <para>This <literal>attribute set</literal> is applied to the output
13291 block for the DocBook Publishers <tag>drama</tag> element.
13292 By default, it imports the attributes defined in the
13293 <tag>publishers.properties</tag> attribute-set.
13294 </para>
13295
13296 </refsection>
13297 </refentry>
13298
13299 <refentry version="5.0" xml:id="poetry.properties">
13300 <refmeta>
13301 <refentrytitle>poetry.properties</refentrytitle>
13302 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
13303 </refmeta>
13304 <refnamediv>
13305 <refname>poetry.properties</refname>
13306 <refpurpose>Properties applied to the DocBook Publishers drama element</refpurpose>
13307 </refnamediv>
13308
13309 <refsynopsisdiv>
13310 <programlisting xml:id="poetry.properties.frag">
13311 &lt;xsl:attribute-set name="poetry.properties" use-attribute-sets="publishers.properties"&gt;&lt;/xsl:attribute-set&gt;
13312 </programlisting>
13313 </refsynopsisdiv>
13314
13315 <refsection><info><title>Description</title></info>
13316
13317 <para>This <literal>attribute set</literal> is applied to the output
13318 block for the DocBook Publishers <tag>poetry</tag> element.
13319 By default, it imports the attributes defined in the
13320 <tag>publishers.properties</tag> attribute-set.
13321 </para>
13322
13323 </refsection>
13324 </refentry>
13325
13326 <refentry version="5.0" xml:id="line.properties">
13327 <refmeta>
13328 <refentrytitle>line.properties</refentrytitle>
13329 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
13330 </refmeta>
13331 <refnamediv>
13332 <refname>line.properties</refname>
13333 <refpurpose>Properties applied to the DocBook Publishers
13334 line element. </refpurpose>
13335 </refnamediv>
13336
13337 <refsynopsisdiv>
13338 <programlisting xml:id="line.properties.frag">
13339 &lt;xsl:attribute-set name="line.properties"&gt;&lt;/xsl:attribute-set&gt;
13340 </programlisting>
13341 </refsynopsisdiv>
13342
13343 <refsection><info><title>Description</title></info>
13344
13345 <para>This <literal>attribute set</literal> is applied
13346 to the <tag>block</tag> that contains the output of a
13347 <tag>line</tag> element from DocBook Publishers.
13348 </para>
13349
13350 </refsection>
13351 </refentry>
13352
13353 <refentry version="5.0" xml:id="linegroup.properties">
13354 <refmeta>
13355 <refentrytitle>linegroup.properties</refentrytitle>
13356 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
13357 </refmeta>
13358 <refnamediv>
13359 <refname>linegroup.properties</refname>
13360 <refpurpose>Properties applied to the DocBook Publishers
13361 linegroup element</refpurpose>
13362 </refnamediv>
13363
13364 <refsynopsisdiv>
13365 <programlisting xml:id="linegroup.properties.frag">
13366 &lt;xsl:attribute-set name="linegroup.properties"&gt;
13367   &lt;xsl:attribute name="provisional-distance-between-starts"&gt;20%&lt;/xsl:attribute&gt;
13368   &lt;xsl:attribute name="provisional-label-separation"&gt;.3em&lt;/xsl:attribute&gt;
13369   &lt;xsl:attribute name="space-before"&gt;.5em&lt;/xsl:attribute&gt;
13370 &lt;/xsl:attribute-set&gt;
13371 </programlisting>
13372 </refsynopsisdiv>
13373
13374 <refsection><info><title>Description</title></info>
13375
13376 <para>This <literal>attribute set</literal> is applied
13377 to the <tag>list-block</tag> that contains the output of a
13378 <tag>linegroup</tag> element from DocBook Publishers.
13379 </para>
13380
13381 </refsection>
13382 </refentry>
13383
13384 <refentry version="5.0" xml:id="speaker.properties">
13385 <refmeta>
13386 <refentrytitle>speaker.properties</refentrytitle>
13387 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
13388 </refmeta>
13389 <refnamediv>
13390 <refname>speaker.properties</refname>
13391 <refpurpose>Properties applied to the DocBook Publishers
13392 speaker element</refpurpose>
13393 </refnamediv>
13394
13395 <refsynopsisdiv>
13396 <programlisting xml:id="speaker.properties.frag">
13397 &lt;xsl:attribute-set name="speaker.properties"&gt;&lt;/xsl:attribute-set&gt;
13398 </programlisting>
13399 </refsynopsisdiv>
13400
13401 <refsection><info><title>Description</title></info>
13402
13403 <para>This <literal>attribute set</literal> is applied
13404 to the <tag>block</tag> that contains the output of a
13405 <tag>speaker</tag> element from DocBook Publishers.
13406 </para>
13407
13408 </refsection>
13409 </refentry>
13410
13411 <refentry version="5.0" xml:id="stagedir.properties">
13412 <refmeta>
13413 <refentrytitle>stagedir.properties</refentrytitle>
13414 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
13415 </refmeta>
13416 <refnamediv>
13417 <refname>stagedir.properties</refname>
13418 <refpurpose>To add properties to the outer block of stage direction.</refpurpose>
13419 </refnamediv>
13420
13421 <refsynopsisdiv>
13422 <programlisting xml:id="stagedir.properties.frag">
13423 &lt;xsl:attribute-set name="stagedir.properties"&gt;
13424   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
13425   &lt;xsl:attribute name="font-style"&gt;italic&lt;/xsl:attribute&gt;
13426   &lt;xsl:attribute name="space-before"&gt;1em&lt;/xsl:attribute&gt;
13427   &lt;xsl:attribute name="space-after"&gt;1em&lt;/xsl:attribute&gt;
13428 &lt;/xsl:attribute-set&gt;
13429 </programlisting>
13430 </refsynopsisdiv>
13431
13432 <refsection><info><title>Description</title></info>
13433
13434 <para>These properties are added to the outer block containing the
13435 entire stagedir.
13436 Use this attribute-set to set the space above and below,
13437 and any indent for the whole stagedir.</para>
13438 </refsection>
13439
13440 </refentry>
13441
13442 <refentry version="5.0" xml:id="inlinestagedir.properties">
13443 <refmeta>
13444 <refentrytitle>inlinestagedir.properties</refentrytitle>
13445 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
13446 </refmeta>
13447 <refnamediv>
13448 <refname>inlinestagedir.properties</refname>
13449 <refpurpose>Properties applied to the DocBook Publishers
13450 inlinestagedir element. </refpurpose>
13451 </refnamediv>
13452
13453 <refsynopsisdiv>
13454 <programlisting xml:id="inlinestagedir.properties.frag">
13455 &lt;xsl:attribute-set name="inlinestagedir.properties"&gt;
13456   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
13457   &lt;xsl:attribute name="font-style"&gt;italic&lt;/xsl:attribute&gt;
13458 &lt;/xsl:attribute-set&gt;
13459 </programlisting>
13460 </refsynopsisdiv>
13461
13462 <refsection><info><title>Description</title></info>
13463
13464 <para>This <literal>attribute set</literal> is applied
13465 to the <tag>fo:inline</tag> that contains the output of a
13466 <tag>inlinestagedir</tag> element from DocBook Publishers.
13467 </para>
13468
13469 <para>The XSL template that matches on <tag>inlinestagedir</tag>
13470 also adds square brackets around the text.</para>
13471
13472 </refsection>
13473 </refentry>
13474
13475
13476 </reference>
13477 <appendix xml:id="stylesheet"><title>The Stylesheet</title>
13478
13479 <para>The <filename>param.xsl</filename> stylesheet is just a wrapper
13480 around all these parameters.</para>
13481
13482 <programlisting xml:id="top">
13483 &lt;xsl:stylesheet exclude-result-prefixes="src" version="1.0"&gt;
13484
13485 &lt;!-- This file is generated from param.xweb --&gt;
13486
13487 &lt;!-- ********************************************************************
13488      $Id: param.xweb 9996 2015-10-01 16:35:10Z bobstayton $
13489      ********************************************************************
13490
13491      This file is part of the XSL DocBook Stylesheet distribution.
13492      See ../README or http://docbook.sf.net/release/xsl/current/ for
13493      copyright and other information.
13494
13495      ******************************************************************** --&gt;
13496
13497 &lt;src:fragref linkend="abstract.properties.frag"&gt;&lt;/src:fragref&gt;
13498 &lt;src:fragref linkend="abstract.title.properties.frag"&gt;&lt;/src:fragref&gt;
13499 &lt;src:fragref linkend="activate.external.olinks.frag"&gt;&lt;/src:fragref&gt;
13500 &lt;src:fragref linkend="admon.graphics.extension.frag"&gt;&lt;/src:fragref&gt;
13501 &lt;src:fragref linkend="admon.graphics.frag"&gt;&lt;/src:fragref&gt;
13502 &lt;src:fragref linkend="admon.graphics.path.frag"&gt;&lt;/src:fragref&gt;
13503 &lt;src:fragref linkend="admon.textlabel.frag"&gt;&lt;/src:fragref&gt;
13504 &lt;src:fragref linkend="admonition.properties.frag"&gt;&lt;/src:fragref&gt;
13505 &lt;src:fragref linkend="admonition.title.properties.frag"&gt;&lt;/src:fragref&gt;
13506 &lt;src:fragref linkend="base.dir.frag"&gt;&lt;/src:fragref&gt;
13507 &lt;src:fragref linkend="graphical.admonition.properties.frag"&gt;&lt;/src:fragref&gt;
13508 &lt;src:fragref linkend="nongraphical.admonition.properties.frag"&gt;&lt;/src:fragref&gt;
13509 &lt;src:fragref linkend="alignment.frag"&gt;&lt;/src:fragref&gt;
13510 &lt;src:fragref linkend="appendix.autolabel.frag"&gt;&lt;/src:fragref&gt;
13511 &lt;src:fragref linkend="arbortext.extensions.frag"&gt;&lt;/src:fragref&gt;
13512 &lt;src:fragref linkend="article.appendix.title.properties.frag"&gt;&lt;/src:fragref&gt;
13513 &lt;src:fragref linkend="author.othername.in.middle.frag"&gt;&lt;/src:fragref&gt;
13514 &lt;src:fragref linkend="autotoc.label.separator.frag"&gt;&lt;/src:fragref&gt;
13515 &lt;src:fragref linkend="axf.extensions.frag"&gt;&lt;/src:fragref&gt;
13516 &lt;src:fragref linkend="biblioentry.item.separator.frag"&gt;&lt;/src:fragref&gt;
13517 &lt;src:fragref linkend="biblioentry.properties.frag"&gt;&lt;/src:fragref&gt;
13518 &lt;src:fragref linkend="bibliography.collection.frag"&gt;&lt;/src:fragref&gt;
13519 &lt;src:fragref linkend="bibliography.numbered.frag"&gt;&lt;/src:fragref&gt;
13520 &lt;src:fragref linkend="bibliography.style.frag"&gt;&lt;/src:fragref&gt;
13521 &lt;src:fragref linkend="blockquote.properties.frag"&gt;&lt;/src:fragref&gt;
13522 &lt;src:fragref linkend="body.font.family.frag"&gt;&lt;/src:fragref&gt;
13523 &lt;src:fragref linkend="body.font.master.frag"&gt;&lt;/src:fragref&gt;
13524 &lt;src:fragref linkend="body.font.size.frag"&gt;&lt;/src:fragref&gt;
13525 &lt;src:fragref linkend="body.margin.bottom.frag"&gt;&lt;/src:fragref&gt;
13526 &lt;src:fragref linkend="body.margin.top.frag"&gt;&lt;/src:fragref&gt;
13527 &lt;src:fragref linkend="body.start.indent.frag"&gt;&lt;/src:fragref&gt;
13528 &lt;src:fragref linkend="body.end.indent.frag"&gt;&lt;/src:fragref&gt;
13529 &lt;src:fragref linkend="bookmarks.collapse.frag"&gt;&lt;/src:fragref&gt;
13530 &lt;src:fragref linkend="bridgehead.in.toc.frag"&gt;&lt;/src:fragref&gt;
13531 &lt;src:fragref linkend="calloutlist.properties.frag"&gt;&lt;/src:fragref&gt;
13532 &lt;src:fragref linkend="callout.properties.frag"&gt;&lt;/src:fragref&gt;
13533 &lt;src:fragref linkend="callout.defaultcolumn.frag"&gt;&lt;/src:fragref&gt;
13534 &lt;src:fragref linkend="callout.graphics.extension.frag"&gt;&lt;/src:fragref&gt;
13535 &lt;src:fragref linkend="callout.graphics.frag"&gt;&lt;/src:fragref&gt;
13536 &lt;src:fragref linkend="callout.icon.size.frag"&gt;&lt;/src:fragref&gt;
13537 &lt;src:fragref linkend="callout.graphics.number.limit.frag"&gt;&lt;/src:fragref&gt;
13538 &lt;src:fragref linkend="callout.graphics.path.frag"&gt;&lt;/src:fragref&gt;
13539 &lt;src:fragref linkend="callout.unicode.font.frag"&gt;&lt;/src:fragref&gt;
13540 &lt;src:fragref linkend="callout.unicode.frag"&gt;&lt;/src:fragref&gt;
13541 &lt;src:fragref linkend="callout.unicode.number.limit.frag"&gt;&lt;/src:fragref&gt;
13542 &lt;src:fragref linkend="callout.unicode.start.character.frag"&gt;&lt;/src:fragref&gt;
13543 &lt;src:fragref linkend="callouts.extension.frag"&gt;&lt;/src:fragref&gt;
13544 &lt;src:fragref linkend="chapter.autolabel.frag"&gt;&lt;/src:fragref&gt;
13545 &lt;src:fragref linkend="chunk.quietly.frag"&gt;&lt;/src:fragref&gt;
13546 &lt;src:fragref linkend="collect.xref.targets.frag"&gt;&lt;/src:fragref&gt;
13547 &lt;src:fragref linkend="column.count.back.frag"&gt;&lt;/src:fragref&gt;
13548 &lt;src:fragref linkend="column.count.body.frag"&gt;&lt;/src:fragref&gt;
13549 &lt;src:fragref linkend="column.count.front.frag"&gt;&lt;/src:fragref&gt;
13550 &lt;src:fragref linkend="column.count.index.frag"&gt;&lt;/src:fragref&gt;
13551 &lt;src:fragref linkend="column.count.lot.frag"&gt;&lt;/src:fragref&gt;
13552 &lt;src:fragref linkend="column.count.titlepage.frag"&gt;&lt;/src:fragref&gt;
13553 &lt;src:fragref linkend="column.gap.back.frag"&gt;&lt;/src:fragref&gt;
13554 &lt;src:fragref linkend="column.gap.body.frag"&gt;&lt;/src:fragref&gt;
13555 &lt;src:fragref linkend="column.gap.front.frag"&gt;&lt;/src:fragref&gt;
13556 &lt;src:fragref linkend="column.gap.index.frag"&gt;&lt;/src:fragref&gt;
13557 &lt;src:fragref linkend="column.gap.lot.frag"&gt;&lt;/src:fragref&gt;
13558 &lt;src:fragref linkend="column.gap.titlepage.frag"&gt;&lt;/src:fragref&gt;
13559 &lt;src:fragref linkend="compact.list.item.spacing.frag"&gt;&lt;/src:fragref&gt;
13560 &lt;src:fragref linkend="component.label.includes.part.label.frag"&gt;&lt;/src:fragref&gt;
13561 &lt;src:fragref linkend="component.title.properties.frag"&gt;&lt;/src:fragref&gt;
13562 &lt;src:fragref linkend="component.titlepage.properties.frag"&gt;&lt;/src:fragref&gt;
13563 &lt;src:fragref linkend="crop.marks.frag"&gt;&lt;/src:fragref&gt;
13564 &lt;src:fragref linkend="crop.mark.width.frag"&gt;&lt;/src:fragref&gt;
13565 &lt;src:fragref linkend="crop.mark.offset.frag"&gt;&lt;/src:fragref&gt;
13566 &lt;src:fragref linkend="crop.mark.bleed.frag"&gt;&lt;/src:fragref&gt;
13567 &lt;src:fragref linkend="current.docid.frag"&gt;&lt;/src:fragref&gt;
13568 &lt;src:fragref linkend="default.float.class.frag"&gt;&lt;/src:fragref&gt;
13569 &lt;src:fragref linkend="default.image.width.frag"&gt;&lt;/src:fragref&gt;
13570 &lt;src:fragref linkend="default.table.width.frag"&gt;&lt;/src:fragref&gt;
13571 &lt;src:fragref linkend="default.table.frame.frag"&gt;&lt;/src:fragref&gt;
13572 &lt;src:fragref linkend="default.table.rules.frag"&gt;&lt;/src:fragref&gt;
13573 &lt;src:fragref linkend="default.units.frag"&gt;&lt;/src:fragref&gt;
13574 &lt;src:fragref linkend="dingbat.font.family.frag"&gt;&lt;/src:fragref&gt;
13575 &lt;src:fragref linkend="double.sided.frag"&gt;&lt;/src:fragref&gt;
13576 &lt;src:fragref linkend="draft.mode.frag"&gt;&lt;/src:fragref&gt;
13577 &lt;src:fragref linkend="draft.watermark.image.frag"&gt;&lt;/src:fragref&gt;
13578 &lt;src:fragref linkend="ebnf.assignment.frag"&gt;&lt;/src:fragref&gt;
13579 &lt;src:fragref linkend="ebnf.statement.terminator.frag"&gt;&lt;/src:fragref&gt;
13580 &lt;src:fragref linkend="email.delimiters.enabled.frag"&gt;&lt;/src:fragref&gt;
13581 &lt;src:fragref linkend="email.mailto.enabled.frag"&gt;&lt;/src:fragref&gt;
13582 &lt;src:fragref linkend="equation.properties.frag"&gt;&lt;/src:fragref&gt;
13583 &lt;src:fragref linkend="equation.number.properties.frag"&gt;&lt;/src:fragref&gt;
13584 &lt;src:fragref linkend="example.properties.frag"&gt;&lt;/src:fragref&gt;
13585 &lt;src:fragref linkend="exsl.node.set.available.frag"&gt;&lt;/src:fragref&gt;
13586 &lt;src:fragref linkend="figure.properties.frag"&gt;&lt;/src:fragref&gt;
13587 &lt;src:fragref linkend="firstterm.only.link.frag"&gt;&lt;/src:fragref&gt;
13588 &lt;src:fragref linkend="footer.content.properties.frag"&gt;&lt;/src:fragref&gt;
13589 &lt;src:fragref linkend="footer.rule.frag"&gt;&lt;/src:fragref&gt;
13590 &lt;src:fragref linkend="footer.column.widths.frag"&gt;&lt;/src:fragref&gt;
13591 &lt;src:fragref linkend="footer.table.height.frag"&gt;&lt;/src:fragref&gt;
13592 &lt;src:fragref linkend="footer.table.properties.frag"&gt;&lt;/src:fragref&gt;
13593 &lt;src:fragref linkend="footers.on.blank.pages.frag"&gt;&lt;/src:fragref&gt;
13594 &lt;src:fragref linkend="footnote.font.size.frag"&gt;&lt;/src:fragref&gt;
13595 &lt;src:fragref linkend="footnote.number.format.frag"&gt;&lt;/src:fragref&gt;
13596 &lt;src:fragref linkend="footnote.number.symbols.frag"&gt;&lt;/src:fragref&gt;
13597 &lt;src:fragref linkend="footnote.mark.properties.frag"&gt;&lt;/src:fragref&gt;
13598 &lt;src:fragref linkend="footnote.properties.frag"&gt;&lt;/src:fragref&gt;
13599 &lt;src:fragref linkend="footnote.sep.leader.properties.frag"&gt;&lt;/src:fragref&gt;
13600 &lt;src:fragref linkend="fop.extensions.frag"&gt;&lt;/src:fragref&gt;
13601 &lt;src:fragref linkend="fop1.extensions.frag"&gt;&lt;/src:fragref&gt;
13602 &lt;src:fragref linkend="force.blank.pages.frag"&gt;&lt;/src:fragref&gt;
13603 &lt;src:fragref linkend="formal.object.properties.frag"&gt;&lt;/src:fragref&gt;
13604 &lt;src:fragref linkend="formal.procedures.frag"&gt;&lt;/src:fragref&gt;
13605 &lt;src:fragref linkend="formal.title.placement.frag"&gt;&lt;/src:fragref&gt;
13606 &lt;src:fragref linkend="formal.title.properties.frag"&gt;&lt;/src:fragref&gt;
13607 &lt;src:fragref linkend="funcsynopsis.decoration.frag"&gt;&lt;/src:fragref&gt;
13608 &lt;src:fragref linkend="funcsynopsis.style.frag"&gt;&lt;/src:fragref&gt;
13609 &lt;src:fragref linkend="function.parens.frag"&gt;&lt;/src:fragref&gt;
13610 &lt;src:fragref linkend="generate.consistent.ids.frag"&gt;&lt;/src:fragref&gt;
13611 &lt;src:fragref linkend="generate.index.frag"&gt;&lt;/src:fragref&gt;
13612 &lt;src:fragref linkend="generate.section.toc.level.frag"&gt;&lt;/src:fragref&gt;
13613 &lt;src:fragref linkend="generate.toc.frag"&gt;&lt;/src:fragref&gt;
13614 &lt;src:fragref linkend="glossary.as.blocks.frag"&gt;&lt;/src:fragref&gt;
13615 &lt;src:fragref linkend="glossary.collection.frag"&gt;&lt;/src:fragref&gt;
13616 &lt;src:fragref linkend="glossary.sort.frag"&gt;&lt;/src:fragref&gt;
13617 &lt;src:fragref linkend="glossentry.show.acronym.frag"&gt;&lt;/src:fragref&gt;
13618 &lt;src:fragref linkend="glosslist.as.blocks.frag"&gt;&lt;/src:fragref&gt;
13619 &lt;src:fragref linkend="glossterm.auto.link.frag"&gt;&lt;/src:fragref&gt;
13620 &lt;src:fragref linkend="glossterm.separation.frag"&gt;&lt;/src:fragref&gt;
13621 &lt;src:fragref linkend="glossterm.width.frag"&gt;&lt;/src:fragref&gt;
13622 &lt;src:fragref linkend="glossentry.list.item.properties.frag"&gt;&lt;/src:fragref&gt;
13623 &lt;src:fragref linkend="glossterm.list.properties.frag"&gt;&lt;/src:fragref&gt;
13624 &lt;src:fragref linkend="glossterm.block.properties.frag"&gt;&lt;/src:fragref&gt;
13625 &lt;src:fragref linkend="glossdef.list.properties.frag"&gt;&lt;/src:fragref&gt;
13626 &lt;src:fragref linkend="glossdef.block.properties.frag"&gt;&lt;/src:fragref&gt;
13627 &lt;src:fragref linkend="graphic.default.extension.frag"&gt;&lt;/src:fragref&gt;
13628 &lt;src:fragref linkend="header.content.properties.frag"&gt;&lt;/src:fragref&gt;
13629 &lt;src:fragref linkend="header.rule.frag"&gt;&lt;/src:fragref&gt;
13630 &lt;src:fragref linkend="header.column.widths.frag"&gt;&lt;/src:fragref&gt;
13631 &lt;src:fragref linkend="header.table.height.frag"&gt;&lt;/src:fragref&gt;
13632 &lt;src:fragref linkend="header.table.properties.frag"&gt;&lt;/src:fragref&gt;
13633 &lt;src:fragref linkend="headers.on.blank.pages.frag"&gt;&lt;/src:fragref&gt;
13634 &lt;src:fragref linkend="highlight.default.language.frag"&gt;&lt;/src:fragref&gt;
13635 &lt;src:fragref linkend="highlight.source.frag"&gt;&lt;/src:fragref&gt;
13636 &lt;src:fragref linkend="highlight.xslthl.config.frag"&gt;&lt;/src:fragref&gt;
13637 &lt;src:fragref linkend="hyphenate.frag"&gt;&lt;/src:fragref&gt;
13638 &lt;src:fragref linkend="hyphenate.verbatim.frag"&gt;&lt;/src:fragref&gt;
13639 &lt;src:fragref linkend="hyphenate.verbatim.characters.frag"&gt;&lt;/src:fragref&gt;
13640 &lt;src:fragref linkend="ignore.image.scaling.frag"&gt;&lt;/src:fragref&gt;
13641 &lt;src:fragref linkend="img.src.path.frag"&gt;&lt;/src:fragref&gt;
13642 &lt;src:fragref linkend="index.method.frag"&gt;&lt;/src:fragref&gt;
13643 &lt;src:fragref linkend="index.on.role.frag"&gt;&lt;/src:fragref&gt;
13644 &lt;src:fragref linkend="index.on.type.frag"&gt;&lt;/src:fragref&gt;
13645 &lt;src:fragref linkend="index.page.number.properties.frag"&gt;&lt;/src:fragref&gt;
13646 &lt;src:fragref linkend="informalequation.properties.frag"&gt;&lt;/src:fragref&gt;
13647 &lt;src:fragref linkend="informalexample.properties.frag"&gt;&lt;/src:fragref&gt;
13648 &lt;src:fragref linkend="informalfigure.properties.frag"&gt;&lt;/src:fragref&gt;
13649 &lt;src:fragref linkend="informal.object.properties.frag"&gt;&lt;/src:fragref&gt;
13650 &lt;src:fragref linkend="informaltable.properties.frag"&gt;&lt;/src:fragref&gt;
13651 &lt;src:fragref linkend="index.preferred.page.properties.frag"&gt;&lt;/src:fragref&gt;
13652 &lt;src:fragref linkend="index.div.title.properties.frag"&gt;&lt;/src:fragref&gt;
13653 &lt;src:fragref linkend="index.entry.properties.frag"&gt;&lt;/src:fragref&gt;
13654 &lt;src:fragref linkend="index.number.separator.frag"&gt;&lt;/src:fragref&gt;
13655 &lt;src:fragref linkend="index.range.separator.frag"&gt;&lt;/src:fragref&gt;
13656 &lt;src:fragref linkend="index.term.separator.frag"&gt;&lt;/src:fragref&gt;
13657 &lt;src:fragref linkend="insert.link.page.number.frag"&gt;&lt;/src:fragref&gt;
13658 &lt;src:fragref linkend="insert.xref.page.number.frag"&gt;&lt;/src:fragref&gt;
13659 &lt;src:fragref linkend="insert.xref.page.number.para.frag"&gt;&lt;/src:fragref&gt;
13660 &lt;src:fragref linkend="itemizedlist.properties.frag"&gt;&lt;/src:fragref&gt;
13661 &lt;src:fragref linkend="itemizedlist.label.properties.frag"&gt;&lt;/src:fragref&gt;
13662 &lt;src:fragref linkend="itemizedlist.label.width.frag"&gt;&lt;/src:fragref&gt;
13663 &lt;src:fragref linkend="keep.relative.image.uris.frag"&gt;&lt;/src:fragref&gt;
13664 &lt;src:fragref linkend="l10n.gentext.default.language.frag"&gt;&lt;/src:fragref&gt;
13665 &lt;src:fragref linkend="l10n.gentext.language.frag"&gt;&lt;/src:fragref&gt;
13666 &lt;src:fragref linkend="l10n.gentext.use.xref.language.frag"&gt;&lt;/src:fragref&gt;
13667 &lt;src:fragref linkend="l10n.lang.value.rfc.compliant.frag"&gt;&lt;/src:fragref&gt;
13668 &lt;src:fragref linkend="label.from.part.frag"&gt;&lt;/src:fragref&gt;
13669 &lt;src:fragref linkend="line-height.frag"&gt;&lt;/src:fragref&gt;
13670 &lt;src:fragref linkend="linenumbering.everyNth.frag"&gt;&lt;/src:fragref&gt;
13671 &lt;src:fragref linkend="linenumbering.extension.frag"&gt;&lt;/src:fragref&gt;
13672 &lt;src:fragref linkend="linenumbering.separator.frag"&gt;&lt;/src:fragref&gt;
13673 &lt;src:fragref linkend="linenumbering.width.frag"&gt;&lt;/src:fragref&gt;
13674 &lt;src:fragref linkend="list.block.properties.frag"&gt;&lt;/src:fragref&gt;
13675 &lt;src:fragref linkend="list.block.spacing.frag"&gt;&lt;/src:fragref&gt;
13676 &lt;src:fragref linkend="list.item.spacing.frag"&gt;&lt;/src:fragref&gt;
13677 &lt;src:fragref linkend="make.index.markup.frag"&gt;&lt;/src:fragref&gt;
13678 &lt;src:fragref linkend="make.single.year.ranges.frag"&gt;&lt;/src:fragref&gt;
13679 &lt;src:fragref linkend="make.year.ranges.frag"&gt;&lt;/src:fragref&gt;
13680 &lt;src:fragref linkend="margin.note.properties.frag"&gt;&lt;/src:fragref&gt;
13681 &lt;src:fragref linkend="margin.note.title.properties.frag"&gt;&lt;/src:fragref&gt;
13682 &lt;src:fragref linkend="margin.note.float.type.frag"&gt;&lt;/src:fragref&gt;
13683 &lt;src:fragref linkend="margin.note.width.frag"&gt;&lt;/src:fragref&gt;
13684 &lt;src:fragref linkend="marker.section.level.frag"&gt;&lt;/src:fragref&gt;
13685 &lt;src:fragref linkend="menuchoice.menu.separator.frag"&gt;&lt;/src:fragref&gt;
13686 &lt;src:fragref linkend="menuchoice.separator.frag"&gt;&lt;/src:fragref&gt;
13687 &lt;src:fragref linkend="monospace.font.family.frag"&gt;&lt;/src:fragref&gt;
13688 &lt;src:fragref linkend="monospace.properties.frag"&gt;&lt;/src:fragref&gt;
13689 &lt;src:fragref linkend="monospace.verbatim.properties.frag"&gt;&lt;/src:fragref&gt;
13690 &lt;src:fragref linkend="monospace.verbatim.font.width.frag"&gt;&lt;/src:fragref&gt;
13691 &lt;src:fragref linkend="nominal.table.width.frag"&gt;&lt;/src:fragref&gt;
13692 &lt;src:fragref linkend="normal.para.spacing.frag"&gt;&lt;/src:fragref&gt;
13693 &lt;src:fragref linkend="olink.doctitle.frag"&gt;&lt;/src:fragref&gt;
13694 &lt;src:fragref linkend="olink.base.uri.frag"&gt;&lt;/src:fragref&gt;
13695 &lt;src:fragref linkend="olink.debug.frag"&gt;&lt;/src:fragref&gt;
13696 &lt;src:fragref linkend="olink.properties.frag"&gt;&lt;/src:fragref&gt;
13697 &lt;src:fragref linkend="olink.lang.fallback.sequence.frag"&gt;&lt;/src:fragref&gt;
13698 &lt;src:fragref linkend="orderedlist.properties.frag"&gt;&lt;/src:fragref&gt;
13699 &lt;src:fragref linkend="orderedlist.label.properties.frag"&gt;&lt;/src:fragref&gt;
13700 &lt;src:fragref linkend="orderedlist.label.width.frag"&gt;&lt;/src:fragref&gt;
13701 &lt;src:fragref linkend="prefer.internal.olink.frag"&gt;&lt;/src:fragref&gt;
13702 &lt;src:fragref linkend="insert.olink.page.number.frag"&gt;&lt;/src:fragref&gt;
13703 &lt;src:fragref linkend="insert.olink.pdf.frag.frag"&gt;&lt;/src:fragref&gt;
13704 &lt;src:fragref linkend="page.height.frag"&gt;&lt;/src:fragref&gt;
13705 &lt;src:fragref linkend="page.height.portrait.frag"&gt;&lt;/src:fragref&gt;
13706 &lt;src:fragref linkend="page.margin.bottom.frag"&gt;&lt;/src:fragref&gt;
13707 &lt;src:fragref linkend="page.margin.inner.frag"&gt;&lt;/src:fragref&gt;
13708 &lt;src:fragref linkend="page.margin.outer.frag"&gt;&lt;/src:fragref&gt;
13709 &lt;src:fragref linkend="page.margin.top.frag"&gt;&lt;/src:fragref&gt;
13710 &lt;src:fragref linkend="page.orientation.frag"&gt;&lt;/src:fragref&gt;
13711 &lt;src:fragref linkend="page.width.frag"&gt;&lt;/src:fragref&gt;
13712 &lt;src:fragref linkend="page.width.portrait.frag"&gt;&lt;/src:fragref&gt;
13713 &lt;src:fragref linkend="paper.type.frag"&gt;&lt;/src:fragref&gt;
13714 &lt;src:fragref linkend="part.autolabel.frag"&gt;&lt;/src:fragref&gt;
13715 &lt;src:fragref linkend="passivetex.extensions.frag"&gt;&lt;/src:fragref&gt;
13716 &lt;src:fragref linkend="pgwide.properties.frag"&gt;&lt;/src:fragref&gt;
13717 &lt;src:fragref linkend="preface.autolabel.frag"&gt;&lt;/src:fragref&gt;
13718 &lt;src:fragref linkend="preferred.mediaobject.role.frag"&gt;&lt;/src:fragref&gt;
13719 &lt;src:fragref linkend="procedure.properties.frag"&gt;&lt;/src:fragref&gt;
13720 &lt;src:fragref linkend="process.empty.source.toc.frag"&gt;&lt;/src:fragref&gt;
13721 &lt;src:fragref linkend="process.source.toc.frag"&gt;&lt;/src:fragref&gt;
13722 &lt;src:fragref linkend="profile.arch.frag"&gt;&lt;/src:fragref&gt;
13723 &lt;src:fragref linkend="profile.audience.frag"&gt;&lt;/src:fragref&gt;
13724 &lt;src:fragref linkend="profile.attribute.frag"&gt;&lt;/src:fragref&gt;
13725 &lt;src:fragref linkend="profile.condition.frag"&gt;&lt;/src:fragref&gt;
13726 &lt;src:fragref linkend="profile.conformance.frag"&gt;&lt;/src:fragref&gt;
13727 &lt;src:fragref linkend="profile.lang.frag"&gt;&lt;/src:fragref&gt;
13728 &lt;src:fragref linkend="profile.os.frag"&gt;&lt;/src:fragref&gt;
13729 &lt;src:fragref linkend="profile.outputformat.frag"&gt;&lt;/src:fragref&gt;
13730 &lt;src:fragref linkend="profile.revision.frag"&gt;&lt;/src:fragref&gt;
13731 &lt;src:fragref linkend="profile.revisionflag.frag"&gt;&lt;/src:fragref&gt;
13732 &lt;src:fragref linkend="profile.role.frag"&gt;&lt;/src:fragref&gt;
13733 &lt;src:fragref linkend="profile.security.frag"&gt;&lt;/src:fragref&gt;
13734 &lt;src:fragref linkend="profile.separator.frag"&gt;&lt;/src:fragref&gt;
13735 &lt;src:fragref linkend="profile.status.frag"&gt;&lt;/src:fragref&gt;
13736 &lt;src:fragref linkend="profile.userlevel.frag"&gt;&lt;/src:fragref&gt;
13737 &lt;src:fragref linkend="profile.value.frag"&gt;&lt;/src:fragref&gt;
13738 &lt;src:fragref linkend="profile.vendor.frag"&gt;&lt;/src:fragref&gt;
13739 &lt;src:fragref linkend="profile.wordsize.frag"&gt;&lt;/src:fragref&gt;
13740 &lt;src:fragref linkend="punct.honorific.frag"&gt;&lt;/src:fragref&gt;
13741 &lt;src:fragref linkend="qanda.defaultlabel.frag"&gt;&lt;/src:fragref&gt;
13742 &lt;src:fragref linkend="qanda.in.toc.frag"&gt;&lt;/src:fragref&gt;
13743 &lt;src:fragref linkend="qanda.nested.in.toc.frag"&gt;&lt;/src:fragref&gt;
13744 &lt;src:fragref linkend="qanda.inherit.numeration.frag"&gt;&lt;/src:fragref&gt;
13745 &lt;src:fragref linkend="qandadiv.autolabel.frag"&gt;&lt;/src:fragref&gt;
13746 &lt;src:fragref linkend="qanda.title.level1.properties.frag"&gt;&lt;/src:fragref&gt;
13747 &lt;src:fragref linkend="qanda.title.level2.properties.frag"&gt;&lt;/src:fragref&gt;
13748 &lt;src:fragref linkend="qanda.title.level3.properties.frag"&gt;&lt;/src:fragref&gt;
13749 &lt;src:fragref linkend="qanda.title.level4.properties.frag"&gt;&lt;/src:fragref&gt;
13750 &lt;src:fragref linkend="qanda.title.level5.properties.frag"&gt;&lt;/src:fragref&gt;
13751 &lt;src:fragref linkend="qanda.title.level6.properties.frag"&gt;&lt;/src:fragref&gt;
13752 &lt;src:fragref linkend="qanda.title.properties.frag"&gt;&lt;/src:fragref&gt;
13753 &lt;src:fragref linkend="refentry.generate.name.frag"&gt;&lt;/src:fragref&gt;
13754 &lt;src:fragref linkend="refentry.generate.title.frag"&gt;&lt;/src:fragref&gt;
13755 &lt;src:fragref linkend="refentry.pagebreak.frag"&gt;&lt;/src:fragref&gt;
13756 &lt;src:fragref linkend="refentry.title.properties.frag"&gt;&lt;/src:fragref&gt;
13757 &lt;src:fragref linkend="refentry.xref.manvolnum.frag"&gt;&lt;/src:fragref&gt;
13758 &lt;src:fragref linkend="reference.autolabel.frag"&gt;&lt;/src:fragref&gt;
13759 &lt;src:fragref linkend="refclass.suppress.frag"&gt;&lt;/src:fragref&gt;
13760 &lt;src:fragref linkend="region.after.extent.frag"&gt;&lt;/src:fragref&gt;
13761 &lt;src:fragref linkend="region.before.extent.frag"&gt;&lt;/src:fragref&gt;
13762 &lt;src:fragref linkend="revhistory.table.properties.frag"&gt;&lt;/src:fragref&gt;
13763 &lt;src:fragref linkend="revhistory.table.cell.properties.frag"&gt;&lt;/src:fragref&gt;
13764 &lt;src:fragref linkend="revhistory.title.properties.frag"&gt;&lt;/src:fragref&gt;
13765 &lt;src:fragref linkend="root.properties.frag"&gt;&lt;/src:fragref&gt;
13766 &lt;src:fragref linkend="rootid.frag"&gt;&lt;/src:fragref&gt;
13767 &lt;src:fragref linkend="runinhead.default.title.end.punct.frag"&gt;&lt;/src:fragref&gt;
13768 &lt;src:fragref linkend="runinhead.title.end.punct.frag"&gt;&lt;/src:fragref&gt;
13769 &lt;src:fragref linkend="sans.font.family.frag"&gt;&lt;/src:fragref&gt;
13770 &lt;src:fragref linkend="section.autolabel.frag"&gt;&lt;/src:fragref&gt;
13771 &lt;src:fragref linkend="section.autolabel.max.depth.frag"&gt;&lt;/src:fragref&gt;
13772 &lt;src:fragref linkend="section.container.element.frag"&gt;&lt;/src:fragref&gt;
13773 &lt;src:fragref linkend="section.label.includes.component.label.frag"&gt;&lt;/src:fragref&gt;
13774 &lt;src:fragref linkend="section.title.level1.properties.frag"&gt;&lt;/src:fragref&gt;
13775 &lt;src:fragref linkend="section.title.level2.properties.frag"&gt;&lt;/src:fragref&gt;
13776 &lt;src:fragref linkend="section.title.level3.properties.frag"&gt;&lt;/src:fragref&gt;
13777 &lt;src:fragref linkend="section.title.level4.properties.frag"&gt;&lt;/src:fragref&gt;
13778 &lt;src:fragref linkend="section.title.level5.properties.frag"&gt;&lt;/src:fragref&gt;
13779 &lt;src:fragref linkend="section.title.level6.properties.frag"&gt;&lt;/src:fragref&gt;
13780 &lt;src:fragref linkend="section.title.properties.frag"&gt;&lt;/src:fragref&gt;
13781 &lt;src:fragref linkend="section.level1.properties.frag"&gt;&lt;/src:fragref&gt;
13782 &lt;src:fragref linkend="section.level2.properties.frag"&gt;&lt;/src:fragref&gt;
13783 &lt;src:fragref linkend="section.level3.properties.frag"&gt;&lt;/src:fragref&gt;
13784 &lt;src:fragref linkend="section.level4.properties.frag"&gt;&lt;/src:fragref&gt;
13785 &lt;src:fragref linkend="section.level5.properties.frag"&gt;&lt;/src:fragref&gt;
13786 &lt;src:fragref linkend="section.level6.properties.frag"&gt;&lt;/src:fragref&gt;
13787 &lt;src:fragref linkend="section.properties.frag"&gt;&lt;/src:fragref&gt;
13788 &lt;src:fragref linkend="segmentedlist.as.table.frag"&gt;&lt;/src:fragref&gt;
13789 &lt;src:fragref linkend="shade.verbatim.frag"&gt;&lt;/src:fragref&gt;
13790 &lt;src:fragref linkend="shade.verbatim.style.frag"&gt;&lt;/src:fragref&gt;
13791 &lt;src:fragref linkend="show.comments.frag"&gt;&lt;/src:fragref&gt;
13792 &lt;src:fragref linkend="sidebar.properties.frag"&gt;&lt;/src:fragref&gt;
13793 &lt;src:fragref linkend="sidebar.title.properties.frag"&gt;&lt;/src:fragref&gt;
13794 &lt;src:fragref linkend="sidebar.float.type.frag"&gt;&lt;/src:fragref&gt;
13795 &lt;src:fragref linkend="sidebar.float.width.frag"&gt;&lt;/src:fragref&gt;
13796 &lt;src:fragref linkend="simplesect.in.toc.frag"&gt;&lt;/src:fragref&gt;
13797 &lt;src:fragref linkend="subscript.properties.frag"&gt;&lt;/src:fragref&gt;
13798 &lt;src:fragref linkend="superscript.properties.frag"&gt;&lt;/src:fragref&gt;
13799 &lt;src:fragref linkend="symbol.font.family.frag"&gt;&lt;/src:fragref&gt;
13800 &lt;src:fragref linkend="table.cell.border.color.frag"&gt;&lt;/src:fragref&gt;
13801 &lt;src:fragref linkend="table.cell.border.style.frag"&gt;&lt;/src:fragref&gt;
13802 &lt;src:fragref linkend="table.cell.border.thickness.frag"&gt;&lt;/src:fragref&gt;
13803 &lt;src:fragref linkend="table.cell.padding.frag"&gt;&lt;/src:fragref&gt;
13804 &lt;src:fragref linkend="table.footnote.number.format.frag"&gt;&lt;/src:fragref&gt;
13805 &lt;src:fragref linkend="table.footnote.number.symbols.frag"&gt;&lt;/src:fragref&gt;
13806 &lt;src:fragref linkend="table.footnote.properties.frag"&gt;&lt;/src:fragref&gt;
13807 &lt;src:fragref linkend="table.frame.border.color.frag"&gt;&lt;/src:fragref&gt;
13808 &lt;src:fragref linkend="table.frame.border.style.frag"&gt;&lt;/src:fragref&gt;
13809 &lt;src:fragref linkend="table.frame.border.thickness.frag"&gt;&lt;/src:fragref&gt;
13810 &lt;src:fragref linkend="table.properties.frag"&gt;&lt;/src:fragref&gt;
13811 &lt;src:fragref linkend="tablecolumns.extension.frag"&gt;&lt;/src:fragref&gt;
13812 &lt;src:fragref linkend="table.table.properties.frag"&gt;&lt;/src:fragref&gt;
13813 &lt;src:fragref linkend="table.caption.properties.frag"&gt;&lt;/src:fragref&gt;
13814 &lt;src:fragref linkend="target.database.document.frag"&gt;&lt;/src:fragref&gt;
13815 &lt;src:fragref linkend="targets.filename.frag"&gt;&lt;/src:fragref&gt;
13816 &lt;src:fragref linkend="task.properties.frag"&gt;&lt;/src:fragref&gt;
13817 &lt;src:fragref linkend="textdata.default.encoding.frag"&gt;&lt;/src:fragref&gt;
13818 &lt;src:fragref linkend="tex.math.delims.frag"&gt;&lt;/src:fragref&gt;
13819 &lt;src:fragref linkend="tex.math.in.alt.frag"&gt;&lt;/src:fragref&gt;
13820 &lt;src:fragref linkend="textinsert.extension.frag"&gt;&lt;/src:fragref&gt;
13821 &lt;src:fragref linkend="title.font.family.frag"&gt;&lt;/src:fragref&gt;
13822 &lt;src:fragref linkend="title.margin.left.frag"&gt;&lt;/src:fragref&gt;
13823 &lt;src:fragref linkend="toc.indent.width.frag"&gt;&lt;/src:fragref&gt;
13824 &lt;src:fragref linkend="toc.line.properties.frag"&gt;&lt;/src:fragref&gt;
13825 &lt;src:fragref linkend="toc.leader.properties.frag"&gt;&lt;/src:fragref&gt;
13826 &lt;src:fragref linkend="toc.margin.properties.frag"&gt;&lt;/src:fragref&gt;
13827 &lt;src:fragref linkend="toc.max.depth.frag"&gt;&lt;/src:fragref&gt;
13828 &lt;src:fragref linkend="toc.section.depth.frag"&gt;&lt;/src:fragref&gt;
13829 &lt;src:fragref linkend="ulink.footnotes.frag"&gt;&lt;/src:fragref&gt;
13830 &lt;src:fragref linkend="ulink.hyphenate.frag"&gt;&lt;/src:fragref&gt;
13831 &lt;src:fragref linkend="ulink.hyphenate.chars.frag"&gt;&lt;/src:fragref&gt;
13832 &lt;src:fragref linkend="ulink.show.frag"&gt;&lt;/src:fragref&gt;
13833 &lt;src:fragref linkend="use.extensions.frag"&gt;&lt;/src:fragref&gt;
13834 &lt;src:fragref linkend="use.local.olink.style.frag"&gt;&lt;/src:fragref&gt;
13835 &lt;src:fragref linkend="use.role.as.xrefstyle.frag"&gt;&lt;/src:fragref&gt;
13836 &lt;src:fragref linkend="use.role.for.mediaobject.frag"&gt;&lt;/src:fragref&gt;
13837 &lt;src:fragref linkend="use.svg.frag"&gt;&lt;/src:fragref&gt;
13838 &lt;src:fragref linkend="variablelist.as.blocks.frag"&gt;&lt;/src:fragref&gt;
13839 &lt;src:fragref linkend="variablelist.max.termlength.frag"&gt;&lt;/src:fragref&gt;
13840 &lt;src:fragref linkend="variablelist.term.separator.frag"&gt;&lt;/src:fragref&gt;
13841 &lt;src:fragref linkend="variablelist.term.properties.frag"&gt;&lt;/src:fragref&gt;
13842 &lt;src:fragref linkend="variablelist.term.break.after.frag"&gt;&lt;/src:fragref&gt;
13843 &lt;src:fragref linkend="verbatim.properties.frag"&gt;&lt;/src:fragref&gt;
13844 &lt;src:fragref linkend="writing.mode.frag"&gt;&lt;/src:fragref&gt;
13845 &lt;src:fragref linkend="xep.extensions.frag"&gt;&lt;/src:fragref&gt;
13846 &lt;src:fragref linkend="xep.index.item.properties.frag"&gt;&lt;/src:fragref&gt;
13847 &lt;src:fragref linkend="xref.label-page.separator.frag"&gt;&lt;/src:fragref&gt;
13848 &lt;src:fragref linkend="xref.label-title.separator.frag"&gt;&lt;/src:fragref&gt;
13849 &lt;src:fragref linkend="xref.properties.frag"&gt;&lt;/src:fragref&gt;
13850 &lt;src:fragref linkend="xref.title-page.separator.frag"&gt;&lt;/src:fragref&gt;
13851 &lt;src:fragref linkend="xref.with.number.and.title.frag"&gt;&lt;/src:fragref&gt;
13852 &lt;src:fragref linkend="region.inner.extent.frag"&gt;&lt;/src:fragref&gt;
13853 &lt;src:fragref linkend="region.outer.extent.frag"&gt;&lt;/src:fragref&gt;
13854 &lt;src:fragref linkend="body.margin.inner.frag"&gt;&lt;/src:fragref&gt;
13855 &lt;src:fragref linkend="body.margin.outer.frag"&gt;&lt;/src:fragref&gt;
13856 &lt;src:fragref linkend="side.region.precedence.frag"&gt;&lt;/src:fragref&gt;
13857 &lt;src:fragref linkend="inner.region.content.properties.frag"&gt;&lt;/src:fragref&gt;
13858 &lt;src:fragref linkend="outer.region.content.properties.frag"&gt;&lt;/src:fragref&gt;
13859 &lt;src:fragref linkend="region.inner.properties.frag"&gt;&lt;/src:fragref&gt;
13860 &lt;src:fragref linkend="region.outer.properties.frag"&gt;&lt;/src:fragref&gt;
13861 &lt;src:fragref linkend="para.properties.frag"&gt;&lt;/src:fragref&gt;
13862 &lt;src:fragref linkend="mark.optional.procedure.steps.frag"&gt;&lt;/src:fragref&gt;
13863 &lt;src:fragref linkend="xsl1.1.bookmarks.frag"&gt;&lt;/src:fragref&gt;
13864 &lt;src:fragref linkend="show.bookmarks.frag"&gt;&lt;/src:fragref&gt;
13865 &lt;src:fragref linkend="autolink.index.see.frag"&gt;&lt;/src:fragref&gt;
13866 &lt;src:fragref linkend="publishers.properties.frag"&gt;&lt;/src:fragref&gt;
13867 &lt;src:fragref linkend="drama.properties.frag"&gt;&lt;/src:fragref&gt;
13868 &lt;src:fragref linkend="poetry.properties.frag"&gt;&lt;/src:fragref&gt;
13869 &lt;src:fragref linkend="stagedir.properties.frag"&gt;&lt;/src:fragref&gt;
13870 &lt;src:fragref linkend="linegroup.properties.frag"&gt;&lt;/src:fragref&gt;
13871 &lt;src:fragref linkend="speaker.properties.frag"&gt;&lt;/src:fragref&gt;
13872 &lt;src:fragref linkend="line.properties.frag"&gt;&lt;/src:fragref&gt;
13873 &lt;src:fragref linkend="inlinestagedir.properties.frag"&gt;&lt;/src:fragref&gt;
13874 &lt;src:fragref linkend="dialogue.properties.frag"&gt;&lt;/src:fragref&gt;
13875
13876 &lt;/xsl:stylesheet&gt;
13877 </programlisting>
13878
13879 </appendix>
13880 </book>