]> git.stg.codes - stg.git/blob - doc/xslt/fo/param.xml
Ticket 37. The changePolicy() parameter added in the struct
[stg.git] / doc / xslt / 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 8543 2009-12-02 06:05:24Z 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   <holder>Norman Walsh</holder>
25 </copyright>
26 <abstract>
27   <para>This is reference documentation for all user-configurable
28   parameters in the DocBook XSL FO stylesheets (for generating
29   XSL-FO output destined for final print/PDF output).</para>
30 </abstract>
31 </info>
32 <reference xml:id="admons"><title>Admonitions</title>
33 <refentry version="5.0" xml:id="admon.graphics">
34 <refmeta>
35 <refentrytitle>admon.graphics</refentrytitle>
36 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
37 </refmeta>
38 <refnamediv>
39 <refname>admon.graphics</refname>
40 <refpurpose>Use graphics in admonitions?</refpurpose>
41 </refnamediv>
42
43 <refsynopsisdiv>
44 <programlisting xml:id="admon.graphics.frag">
45 &lt;xsl:param name="admon.graphics" select="0"&gt;&lt;/xsl:param&gt;
46 </programlisting>
47 </refsynopsisdiv>
48
49 <refsection><info><title>Description</title></info>
50
51 <para>If true (non-zero), admonitions are presented in an alternate style that uses
52 a graphic.  Default graphics are provided in the distribution.
53 </para>
54
55 </refsection>
56 </refentry>
57
58 <refentry version="5.0" xml:id="admon.graphics.extension">
59 <refmeta>
60 <refentrytitle>admon.graphics.extension</refentrytitle>
61 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
62 </refmeta>
63 <refnamediv>
64 <refname>admon.graphics.extension</refname>
65 <refpurpose>Filename extension for admonition graphics</refpurpose>
66 </refnamediv>
67
68 <refsynopsisdiv>
69 <programlisting xml:id="admon.graphics.extension.frag">
70 &lt;xsl:param name="admon.graphics.extension"&gt;.png&lt;/xsl:param&gt;
71 </programlisting>
72 </refsynopsisdiv>
73
74 <refsection><info><title>Description</title></info>
75
76 <para>Sets the filename extension to use on admonition graphics.</para>
77
78 </refsection>
79 </refentry>
80
81 <refentry version="5.0" xml:id="admon.graphics.path">
82 <refmeta>
83 <refentrytitle>admon.graphics.path</refentrytitle>
84 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
85 </refmeta>
86 <refnamediv>
87 <refname>admon.graphics.path</refname>
88 <refpurpose>Path to admonition graphics</refpurpose>
89 </refnamediv>
90
91 <refsynopsisdiv>
92 <programlisting xml:id="admon.graphics.path.frag">&lt;xsl:param name="admon.graphics.path"&gt;images/&lt;/xsl:param&gt;</programlisting>
93 </refsynopsisdiv>
94
95 <refsection><info><title>Description</title></info>
96
97 <para>Sets the path to the directory containing the admonition graphics
98 (caution.png, important.png etc). This location is normally relative
99 to the output html directory. See <parameter>base.dir</parameter></para>
100
101 </refsection>
102 </refentry>
103
104 <refentry version="5.0" xml:id="admon.textlabel">
105 <refmeta>
106 <refentrytitle>admon.textlabel</refentrytitle>
107 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
108 </refmeta>
109 <refnamediv>
110 <refname>admon.textlabel</refname>
111 <refpurpose>Use text label in admonitions?</refpurpose>
112 </refnamediv>
113
114 <refsynopsisdiv>
115 <programlisting xml:id="admon.textlabel.frag">
116 &lt;xsl:param name="admon.textlabel" select="1"&gt;&lt;/xsl:param&gt;
117 </programlisting>
118 </refsynopsisdiv>
119
120 <refsection><info><title>Description</title></info>
121
122 <para>If true (non-zero), admonitions are presented with a generated
123 text label such as Note or Warning in the appropriate language.
124 If zero, such labels are turned off, but any title child
125 of the admonition element are still output.
126 The default value is 1.
127 </para>
128
129 </refsection>
130 </refentry>
131
132 <refentry version="5.0" xml:id="admonition.title.properties">
133
134 <refmeta>
135   <refentrytitle>admonition.title.properties</refentrytitle>
136   <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
137 </refmeta>
138 <refnamediv>
139 <refname>admonition.title.properties</refname>
140 <refpurpose>To set the style for admonitions titles.</refpurpose>
141 </refnamediv>
142
143 <refsynopsisdiv>
144 <programlisting xml:id="admonition.title.properties.frag">
145 &lt;xsl:attribute-set name="admonition.title.properties"&gt;
146   &lt;xsl:attribute name="font-size"&gt;14pt&lt;/xsl:attribute&gt;
147   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
148   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
149   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
150 &lt;/xsl:attribute-set&gt;
151 </programlisting>
152 </refsynopsisdiv>
153 <refsection><info><title>Description</title></info>
154 <para>How do you want admonitions titles styled? </para>
155 <para>Set the font-size, weight etc to the style required.</para>
156
157 </refsection>
158 </refentry>
159
160 <refentry version="5.0" xml:id="admonition.properties">
161 <refmeta>
162   <refentrytitle>admonition.properties</refentrytitle>
163   <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
164 </refmeta>  
165 <refnamediv>
166 <refname>admonition.properties</refname>
167 <refpurpose>To set the style for admonitions.</refpurpose>
168 </refnamediv>
169
170 <refsynopsisdiv>
171 <programlisting xml:id="admonition.properties.frag">&lt;xsl:attribute-set name="admonition.properties"&gt;&lt;/xsl:attribute-set&gt;
172 </programlisting>
173 </refsynopsisdiv>
174 <refsection><info><title>Description</title></info>
175 <para>How do you want admonitions styled? </para>
176 <para>Set the font-size, weight, etc. to the style required</para>
177
178 </refsection>
179 </refentry>
180
181 <refentry version="5.0" xml:id="graphical.admonition.properties">
182 <refmeta>
183 <refentrytitle>graphical.admonition.properties</refentrytitle>
184 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
185 </refmeta>
186 <refnamediv>
187 <refname>graphical.admonition.properties</refname>
188 <refpurpose>To add properties to the outer block of a graphical admonition.</refpurpose>
189 </refnamediv>
190
191 <refsynopsisdiv>
192 <programlisting xml:id="graphical.admonition.properties.frag">&lt;xsl:attribute-set name="graphical.admonition.properties"&gt;
193   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
194   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
195   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
196   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;
197   &lt;xsl:attribute name="space-after.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
198   &lt;xsl:attribute name="space-after.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
199 &lt;/xsl:attribute-set&gt;
200 </programlisting>
201 </refsynopsisdiv>
202 <refsection><info><title>Description</title></info>
203 <para>These properties are added to the outer block containing the
204 entire graphical admonition, including its title.
205 It is used when the parameter
206 <parameter>admon.graphics</parameter> is set to nonzero.
207 Use this attribute-set to set the space above and below,
208 and any indent for the whole admonition.</para>
209
210 <para>In addition to these properties, a graphical admonition
211 also applies the <parameter>admonition.title.properties</parameter>
212 attribute-set to the title, and applies the
213 <parameter>admonition.properties</parameter> attribute-set
214 to the rest of the content.</para>
215
216 </refsection>
217 </refentry>
218
219 <refentry version="5.0" xml:id="nongraphical.admonition.properties">
220 <refmeta>
221 <refentrytitle>nongraphical.admonition.properties</refentrytitle>
222 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
223 </refmeta>
224 <refnamediv>
225 <refname>nongraphical.admonition.properties</refname>
226 <refpurpose>To add properties to the outer block of a nongraphical admonition.</refpurpose>
227 </refnamediv>
228
229 <refsynopsisdiv>
230 <programlisting xml:id="nongraphical.admonition.properties.frag">&lt;xsl:attribute-set name="nongraphical.admonition.properties"&gt;
231   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
232   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
233   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
234   &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;0.25in&lt;/xsl:attribute&gt;
235   &lt;xsl:attribute name="margin-{$direction.align.end}"&gt;0.25in&lt;/xsl:attribute&gt;
236 &lt;/xsl:attribute-set&gt;
237 </programlisting>
238 </refsynopsisdiv>
239 <refsection><info><title>Description</title></info>
240 <para>These properties are added to the outer block containing the
241 entire nongraphical admonition, including its title.
242 It is used when the parameter
243 <parameter>admon.graphics</parameter> is set to zero.
244 Use this attribute-set to set the space above and below,
245 and any indent for the whole admonition.</para>
246
247 <para>In addition to these properties, a nongraphical admonition
248 also applies the <parameter>admonition.title.properties</parameter>
249 attribute-set to the title, and the
250 <parameter>admonition.properties</parameter> attribute-set
251 to the rest of the content.</para>
252
253 </refsection>
254 </refentry>
255
256 </reference>
257 <reference xml:id="callouts"><title>Callouts</title>
258 <refentry version="5.0" xml:id="callout.defaultcolumn">
259 <refmeta>
260 <refentrytitle>callout.defaultcolumn</refentrytitle>
261 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
262 </refmeta>
263 <refnamediv>
264 <refname>callout.defaultcolumn</refname>
265 <refpurpose>Indicates what column callouts appear in by default</refpurpose>
266 </refnamediv>
267
268 <refsynopsisdiv>
269 <programlisting xml:id="callout.defaultcolumn.frag">
270 &lt;xsl:param name="callout.defaultcolumn"&gt;60&lt;/xsl:param&gt;
271 </programlisting>
272 </refsynopsisdiv>
273
274 <refsection><info><title>Description</title></info>
275
276 <para>If a callout does not identify a column (for example, if it uses
277 the <literal>linerange</literal> <tag class="attribute">unit</tag>),
278 it will appear in the default column.
279 </para>
280
281 </refsection>
282 </refentry>
283
284 <refentry version="5.0" xml:id="callout.graphics">
285 <refmeta>
286 <refentrytitle>callout.graphics</refentrytitle>
287 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
288 </refmeta>
289 <refnamediv>
290 <refname>callout.graphics</refname>
291 <refpurpose>Use graphics for callouts?</refpurpose>
292 </refnamediv>
293
294 <refsynopsisdiv>
295 <programlisting xml:id="callout.graphics.frag">
296 &lt;xsl:param name="callout.graphics" select="1"&gt;&lt;/xsl:param&gt;
297 </programlisting>
298 </refsynopsisdiv>
299
300 <refsection><info><title>Description</title></info>
301
302 <para>If non-zero, callouts are presented with graphics (e.g., reverse-video
303 circled numbers instead of "(1)", "(2)", etc.).
304 Default graphics are provided in the distribution.
305 </para>
306
307 </refsection>
308 </refentry>
309
310 <refentry version="5.0" xml:id="callout.graphics.extension">
311 <refmeta>
312 <refentrytitle>callout.graphics.extension</refentrytitle>
313 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
314 </refmeta>
315 <refnamediv>
316 <refname>callout.graphics.extension</refname>
317 <refpurpose>Filename extension for callout graphics</refpurpose>
318 </refnamediv>
319
320 <refsynopsisdiv>
321 <programlisting xml:id="callout.graphics.extension.frag">
322
323 &lt;xsl:param name="callout.graphics.extension"&gt;.svg&lt;/xsl:param&gt;
324 </programlisting>
325 </refsynopsisdiv>
326
327 <refsection><info><title>Description</title></info>
328 <para>Sets the filename extension to use on callout graphics. </para>
329
330 <itemizedlist>
331 <para>The Docbook XSL distribution provides callout graphics in the following formats:</para>
332 <listitem><para>SVG (extension: <filename class="extension">.svg</filename>)</para></listitem>
333 <listitem><para>PNG (extension: <filename class="extension">.png</filename>)</para></listitem>
334 <listitem><para>GIF (extension: <filename class="extension">.gif</filename>)</para></listitem>
335 </itemizedlist>
336 </refsection>
337 </refentry>
338
339 <refentry version="5.0" xml:id="callout.graphics.number.limit">
340 <refmeta>
341 <refentrytitle>callout.graphics.number.limit</refentrytitle>
342 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
343 </refmeta>
344 <refnamediv>
345 <refname>callout.graphics.number.limit</refname>
346 <refpurpose>Number of the largest callout graphic</refpurpose>
347 </refnamediv>
348
349 <refsynopsisdiv>
350 <programlisting xml:id="callout.graphics.number.limit.frag">
351
352 &lt;xsl:param name="callout.graphics.number.limit"&gt;30&lt;/xsl:param&gt;
353 </programlisting>
354 </refsynopsisdiv>
355
356 <refsection><info><title>Description</title></info>
357
358 <para>If <parameter>callout.graphics</parameter> is non-zero, graphics
359 are used to represent callout numbers instead of plain text. The value
360 of <parameter>callout.graphics.number.limit</parameter> is the largest
361 number for which a graphic exists. If the callout number exceeds this
362 limit, the default presentation "(plain text instead of a graphic)"
363 will  be used.
364 </para>
365
366 </refsection>
367 </refentry>
368
369 <refentry version="5.0" xml:id="callout.graphics.path">
370 <refmeta>
371 <refentrytitle>callout.graphics.path</refentrytitle>
372 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
373 </refmeta>
374 <refnamediv>
375 <refname>callout.graphics.path</refname>
376 <refpurpose>Path to callout graphics</refpurpose>
377 </refnamediv>
378
379 <refsynopsisdiv>
380 <programlisting xml:id="callout.graphics.path.frag">
381 &lt;xsl:param name="callout.graphics.path"&gt;images/callouts/&lt;/xsl:param&gt;
382 </programlisting>
383 </refsynopsisdiv>
384
385 <refsection><info><title>Description</title></info>
386
387 <para>Sets the path to the directory holding the callout graphics. his
388 location is normally relative to the output html directory. see
389 base.dir. Always terminate the directory with / since the graphic file
390 is appended to this string, hence needs the separator.
391 </para>
392
393 </refsection>
394 </refentry>
395
396 <refentry version="5.0" xml:id="callout.icon.size">
397 <refmeta>
398 <refentrytitle>callout.icon.size</refentrytitle>
399 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
400 </refmeta>
401 <refnamediv>
402 <refname>callout.icon.size</refname>
403 <refpurpose>Specifies the size of callout marker icons</refpurpose>
404 </refnamediv>
405
406 <refsynopsisdiv>
407 <programlisting xml:id="callout.icon.size.frag">
408 &lt;xsl:param name="callout.icon.size"&gt;7pt&lt;/xsl:param&gt;
409 </programlisting>
410 </refsynopsisdiv>
411
412 <refsection><info><title>Description</title></info>
413
414 <para>Specifies the size of the callout marker icons.
415 The default size is 7 points.</para>
416
417 </refsection>
418 </refentry>
419
420 <refentry version="5.0" xml:id="callout.unicode">
421 <refmeta>
422 <refentrytitle>callout.unicode</refentrytitle>
423 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
424 </refmeta>
425 <refnamediv>
426 <refname>callout.unicode</refname>
427 <refpurpose>Use Unicode characters rather than images for callouts.</refpurpose>
428 </refnamediv>
429
430 <refsynopsisdiv>
431 <programlisting xml:id="callout.unicode.frag">&lt;xsl:param name="callout.unicode" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
432 </refsynopsisdiv>
433
434 <refsection><info><title>Description</title></info>
435
436 <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.
437 </para>
438
439 </refsection>
440 </refentry>
441
442 <refentry version="5.0" xml:id="callout.unicode.font">
443 <refmeta>
444 <refentrytitle>callout.unicode.font</refentrytitle>
445 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
446 </refmeta>
447 <refnamediv>
448 <refname>callout.unicode.font</refname>
449 <refpurpose>Specify a font for Unicode glyphs</refpurpose>
450 </refnamediv>
451
452 <refsynopsisdiv>
453 <programlisting xml:id="callout.unicode.font.frag">
454 &lt;xsl:param name="callout.unicode.font"&gt;ZapfDingbats&lt;/xsl:param&gt;
455 </programlisting>
456 </refsynopsisdiv>
457
458 <refsection><info><title>Description</title></info>
459
460 <para>The name of the font to specify around Unicode callout glyphs.
461 If set to the empty string, no font change will occur.
462 </para>
463
464 </refsection>
465 </refentry>
466
467 <refentry version="5.0" xml:id="callout.unicode.number.limit">
468 <refmeta>
469 <refentrytitle>callout.unicode.number.limit</refentrytitle>
470 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
471 </refmeta>
472 <refnamediv>
473 <refname>callout.unicode.number.limit</refname>
474 <refpurpose>Number of the largest unicode callout character</refpurpose>
475 </refnamediv>
476
477 <refsynopsisdiv>
478 <programlisting xml:id="callout.unicode.number.limit.frag">
479 &lt;xsl:param name="callout.unicode.number.limit"&gt;10&lt;/xsl:param&gt;
480 </programlisting>
481 </refsynopsisdiv>
482
483 <refsection><info><title>Description</title></info>
484
485 <para>If <parameter>callout.unicode</parameter>
486 is non-zero, unicode characters are used to represent
487 callout numbers. The value of
488 <parameter>callout.unicode.number.limit</parameter>
489 is
490 the largest number for which a unicode character exists. If the callout number
491 exceeds this limit, the default presentation "(nnn)" will always
492 be used.
493 </para>
494
495 </refsection>
496 </refentry>
497
498 <refentry version="5.0" xml:id="callout.unicode.start.character">
499 <refmeta>
500 <refentrytitle>callout.unicode.start.character</refentrytitle>
501 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
502 </refmeta>
503 <refnamediv>
504 <refname>callout.unicode.start.character</refname>
505 <refpurpose>First Unicode character to use, decimal value.</refpurpose>
506 </refnamediv>
507
508 <refsynopsisdiv>
509 <programlisting xml:id="callout.unicode.start.character.frag">
510 &lt;xsl:param name="callout.unicode.start.character"&gt;10102&lt;/xsl:param&gt;
511 </programlisting>
512 </refsynopsisdiv>
513
514 <refsection><info><title>Description</title></info>
515
516 <para>If <parameter>callout.graphics</parameter> is zero and <parameter>callout.unicode</parameter>
517 is non-zero, unicode characters are used to represent
518 callout numbers. The value of
519 <parameter>callout.unicode.start.character</parameter>
520 is the decimal unicode value used for callout number one. Currently, 
521 only 10102 is supported in the stylesheets for this parameter. 
522 </para>
523
524 </refsection>
525 </refentry>
526
527 <refentry version="5.0" xml:id="callouts.extension">
528 <refmeta>
529 <refentrytitle>callouts.extension</refentrytitle>
530 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
531 </refmeta>
532 <refnamediv>
533 <refname>callouts.extension</refname>
534 <refpurpose>Enable the callout extension</refpurpose>
535 </refnamediv>
536
537 <refsynopsisdiv>
538 <programlisting xml:id="callouts.extension.frag">
539 &lt;xsl:param name="callouts.extension" select="1"&gt;&lt;/xsl:param&gt;
540 </programlisting>
541 </refsynopsisdiv>
542
543 <refsection><info><title>Description</title></info>
544
545 <para>The callouts extension processes <tag>areaset</tag>
546 elements in <tag>programlistingco</tag> and other text-based
547 callout elements.
548 </para>
549
550 </refsection>
551 </refentry>
552
553 </reference>
554 <reference xml:id="toc_index"><title>ToC/LoT/Index Generation</title>
555 <refentry version="5.0" xml:id="autotoc.label.separator">
556 <refmeta>
557 <refentrytitle>autotoc.label.separator</refentrytitle>
558 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
559 </refmeta>
560 <refnamediv>
561 <refname>autotoc.label.separator</refname>
562 <refpurpose>Separator between labels and titles in the ToC</refpurpose>
563 </refnamediv>
564
565 <refsynopsisdiv>
566 <programlisting xml:id="autotoc.label.separator.frag">
567 &lt;xsl:param name="autotoc.label.separator"&gt;. &lt;/xsl:param&gt;
568 </programlisting>
569 </refsynopsisdiv>
570
571 <refsection><info><title>Description</title></info>
572
573 <para>String used to separate labels and titles in a table of contents.</para>
574
575 </refsection>
576 </refentry>
577
578 <refentry version="5.0" xml:id="process.empty.source.toc">
579 <refmeta>
580 <refentrytitle>process.empty.source.toc</refentrytitle>
581 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
582 </refmeta>
583 <refnamediv>
584 <refname>process.empty.source.toc</refname>
585 <refpurpose>Generate automated TOC if <tag>toc</tag> element occurs in a source document?</refpurpose>
586 </refnamediv>
587
588 <refsynopsisdiv>
589 <programlisting xml:id="process.empty.source.toc.frag">&lt;xsl:param name="process.empty.source.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
590 </refsynopsisdiv>
591
592 <refsection><info><title>Description</title></info>
593
594 <para>Specifies that if an empty <tag>toc</tag> element is found in a
595 source document, an automated TOC is generated at this point in the
596 document.
597 <note>
598   <para>Depending on what the value of the
599   <parameter>generate.toc</parameter> parameter is, setting this
600   parameter to <literal>1</literal> could result in generation of
601   duplicate automated TOCs. So the
602   <parameter>process.empty.source.toc</parameter> is primarily useful
603   as an "override": by placing an empty <tag>toc</tag> in your
604   document and setting this parameter to <literal>1</literal>, you can
605   force a TOC to be generated even if <tag>generate.toc</tag>
606   says not to.</para>
607 </note>
608 </para>
609
610 </refsection>
611 </refentry>
612
613 <refentry version="5.0" xml:id="process.source.toc">
614 <refmeta>
615 <refentrytitle>process.source.toc</refentrytitle>
616 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
617 </refmeta>
618 <refnamediv>
619 <refname>process.source.toc</refname>
620 <refpurpose>Process a non-empty <tag>toc</tag> element if it occurs in a source document?</refpurpose>
621 </refnamediv>
622
623 <refsynopsisdiv>
624 <programlisting xml:id="process.source.toc.frag">&lt;xsl:param name="process.source.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
625 </refsynopsisdiv>
626
627 <refsection><info><title>Description</title></info>
628
629 <para>Specifies that the contents of a non-empty "hard-coded"
630 <tag>toc</tag> element in a source document are processed to
631 generate a TOC in output.
632 <note>
633   <para>This parameter has no effect on automated generation of
634   TOCs. An automated TOC may still be generated along with the
635   "hard-coded" TOC. To suppress automated TOC generation, adjust the
636   value of the <parameter>generate.toc</parameter> paramameter.</para>
637
638   <para>The <tag>process.source.toc</tag> parameter also has
639   no effect if the <tag>toc</tag> element is empty; handling
640   for empty <tag>toc</tag> is controlled by the
641   <parameter>process.empty.source.toc</parameter> parameter.</para>
642 </note>
643 </para>
644
645 </refsection>
646 </refentry>
647
648 <refentry version="5.0" xml:id="generate.toc">
649 <refmeta>
650 <refentrytitle>generate.toc</refentrytitle>
651 <refmiscinfo class="other" otherclass="datatype">table</refmiscinfo>
652 </refmeta>
653 <refnamediv>
654 <refname>generate.toc</refname>
655 <refpurpose>Control generation of ToCs and LoTs</refpurpose>
656 </refnamediv>
657
658 <refsynopsisdiv>
659 <programlisting xml:id="generate.toc.frag">
660
661 &lt;xsl:param name="generate.toc"&gt;
662 /appendix toc,title
663 article/appendix  nop
664 /article  toc,title
665 book      toc,title,figure,table,example,equation
666 /chapter  toc,title
667 part      toc,title
668 /preface  toc,title
669 reference toc,title
670 /sect1    toc
671 /sect2    toc
672 /sect3    toc
673 /sect4    toc
674 /sect5    toc
675 /section  toc
676 set       toc,title
677 &lt;/xsl:param&gt;
678 </programlisting>
679 </refsynopsisdiv>
680
681 <refsection><info><title>Description</title></info>
682
683 <para>This parameter has a structured value. It is a table of space-delimited
684 path/value pairs. Each path identifies some element in the source document
685 using a restricted subset of XPath (only the implicit child axis, no wildcards,
686 no predicates). Paths can be either relative or absolute.</para>
687
688 <para>When processing a particular element, the stylesheets consult this table to
689 determine if a ToC (or LoT(s)) should be generated.</para>
690
691 <para>For example, consider the entry:</para>
692
693 <screen>book toc,figure</screen>
694
695 <para>This indicates that whenever a <tag>book</tag> is formatted, a
696 Table Of Contents and a List of Figures should be generated. Similarly,</para>
697
698 <screen>/chapter toc</screen>
699
700 <para>indicates that whenever a document <emphasis>that has a root
701 of</emphasis> <tag>chapter</tag> is formatted, a Table of
702 Contents should be generated. The entry <literal>chapter</literal> would match
703 all chapters, but <literal>/chapter</literal> matches only <tag>chapter</tag>
704 document elements.</para>
705
706 <para>Generally, the longest match wins. So, for example, if you want to distinguish
707 articles in books from articles in parts, you could use these two entries:</para>
708
709 <screen>book/article toc,figure
710 part/article toc</screen>
711
712 <para>Note that an article in a part can never match a <literal>book/article</literal>,
713 so if you want nothing to be generated for articles in parts, you can simply leave
714 that rule out.</para>
715
716 <para>If you want to leave the rule in, to make it explicit that you're turning
717 something off, use the value <quote>nop</quote>. For example, the following
718 entry disables ToCs and LoTs for articles:</para>
719
720 <screen>article nop</screen>
721
722 <para>Do not simply leave the word <quote>article</quote> in the file
723 without a matching value. That'd be just begging the silly little
724 path/value parser to get confused.</para>
725
726 <para>Section ToCs are further controlled by the
727 <parameter>generate.section.toc.level</parameter> parameter.
728 For a given section level to have a ToC, it must have both an entry in 
729 <parameter>generate.toc</parameter> and be within the range enabled by
730 <parameter>generate.section.toc.level</parameter>.</para>
731 </refsection>
732 </refentry>
733
734 <refentry version="5.0" xml:id="generate.index">
735 <refmeta>
736 <refentrytitle>generate.index</refentrytitle>
737 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
738 </refmeta>
739 <refnamediv>
740 <refname>generate.index</refname>
741 <refpurpose>Do you want an index?</refpurpose>
742 </refnamediv>
743
744 <refsynopsisdiv>
745 <programlisting xml:id="generate.index.frag">&lt;xsl:param name="generate.index" select="1"&gt;&lt;/xsl:param&gt;</programlisting>
746 </refsynopsisdiv>
747
748 <refsection><info><title>Description</title></info>
749
750 <para>Specify if an index should be generated. </para>
751
752 </refsection>
753 </refentry>
754
755 <refentry version="5.0" xml:id="make.index.markup">
756 <refmeta>
757 <refentrytitle>make.index.markup</refentrytitle>
758 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
759 </refmeta>
760 <refnamediv>
761 <refname>make.index.markup</refname>
762 <refpurpose>Generate XML index markup in the index?</refpurpose>
763 </refnamediv>
764
765 <refsynopsisdiv>
766 <programlisting xml:id="make.index.markup.frag">
767 &lt;xsl:param name="make.index.markup" select="0"&gt;&lt;/xsl:param&gt;
768 </programlisting>
769 </refsynopsisdiv>
770
771 <refsection><info><title>Description</title></info>
772
773 <para>This parameter enables a very neat trick for getting properly
774 merged, collated back-of-the-book indexes. G. Ken Holman suggested
775 this trick at Extreme Markup Languages 2002 and I'm indebted to him
776 for it.</para>
777
778 <para>Jeni Tennison's excellent code in
779 <filename>autoidx.xsl</filename> does a great job of merging and
780 sorting <tag>indexterm</tag>s in the document and building a
781 back-of-the-book index. However, there's one thing that it cannot
782 reasonably be expected to do: merge page numbers into ranges. (I would
783 not have thought that it could collate and suppress duplicate page
784 numbers, but in fact it appears to manage that task somehow.)</para>
785
786 <para>Ken's trick is to produce a document in which the index at the
787 back of the book is <quote>displayed</quote> in XML. Because the index
788 is generated by the FO processor, all of the page numbers have been resolved.
789 It's a bit hard to explain, but what it boils down to is that instead of having
790 an index at the back of the book that looks like this:</para>
791
792 <blockquote>
793 <formalpara><info><title>A</title></info>
794 <para>ap1, 1, 2, 3</para>
795 </formalpara>
796 </blockquote>
797
798 <para>you get one that looks like this:</para>
799
800 <blockquote>
801 <programlisting>&lt;indexdiv&gt;A&lt;/indexdiv&gt;
802 &lt;indexentry&gt;
803 &lt;primaryie&gt;ap1&lt;/primaryie&gt;,
804 &lt;phrase role="pageno"&gt;1&lt;/phrase&gt;,
805 &lt;phrase role="pageno"&gt;2&lt;/phrase&gt;,
806 &lt;phrase role="pageno"&gt;3&lt;/phrase&gt;
807 &lt;/indexentry&gt;</programlisting>
808 </blockquote>
809
810 <para>After building a PDF file with this sort of odd-looking index, you can
811 extract the text from the PDF file and the result is a proper index expressed in
812 XML.</para>
813
814 <para>Now you have data that's amenable to processing and a simple Perl script
815 (such as <filename>fo/pdf2index</filename>) can
816 merge page ranges and generate a proper index.</para>
817
818 <para>Finally, reformat your original document using this literal index instead of
819 an automatically generated one and <quote>bingo</quote>!</para>
820
821 </refsection>
822 </refentry>
823
824 <refentry version="5.0" xml:id="index.method">
825 <refmeta>
826 <refentrytitle>index.method</refentrytitle>
827 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
828 <refmiscinfo class="other" otherclass="value">basic</refmiscinfo>
829 <refmiscinfo class="other" otherclass="value">kosek</refmiscinfo>
830 <refmiscinfo class="other" otherclass="value">kimber</refmiscinfo>
831 </refmeta>
832 <refnamediv>
833 <refname>index.method</refname>
834 <refpurpose>Select method used to group index entries in an index</refpurpose>
835 </refnamediv>
836
837 <refsynopsisdiv>
838 <programlisting xml:id="index.method.frag">
839 &lt;xsl:param name="index.method"&gt;basic&lt;/xsl:param&gt;
840 </programlisting>
841 </refsynopsisdiv>
842
843 <refsection><info><title>Description</title></info>
844
845 <para>This parameter lets you select which method to use for sorting and grouping
846  index entries in an index.
847 Indexes in Latin-based languages that have accented characters typically
848 sort together accented words and unaccented words.
849 Thus <quote>&#193;</quote> (U+00C1 LATIN CAPITAL LETTER A WITH ACUTE) would sort together
850 with <quote>A</quote> (U+0041 LATIN CAPITAL LETTER A), so both would appear in the <quote>A</quote>
851 section of the index.
852 Languages using other alphabets (such as Russian,  which is written in the Cyrillic alphabet)
853 and languages using ideographic chararacters (such as Japanese)
854 require grouping specific to the languages and alphabets.
855 </para>
856
857 <para>The default indexing method is limited.
858 It can group accented characters in Latin-based languages only.
859 It cannot handle non-Latin alphabets or ideographic languages.
860 The other indexing methods require extensions of one type or
861 another, and do not work with
862 all XSLT processors, which is why they are not used by default.</para>
863
864 <para>The three choices for indexing method are:</para>
865 <variablelist>
866 <varlistentry>
867 <term><literal>basic</literal></term>
868 <listitem>
869 <para>
870 (default)  Sort and groups words based only on the Latin alphabet.
871 Words with accented Latin letters will group and sort with
872 their respective primary letter, but
873 words in non-Latin alphabets will be
874 put in the <quote>Symbols</quote> section of the index.
875 </para>
876 </listitem>
877 </varlistentry>
878 <varlistentry>
879 <term><literal>kosek</literal></term>
880 <listitem>
881 <para>
882 This method sorts and groups words based on letter groups configured in
883 the DocBook locale file for the given language.
884 See, for example, the French locale file <filename>common/fr.xml</filename>.
885 This method requires that the XSLT processor
886 supports the EXSLT extensions (most do).
887 It also requires support for using 
888 user-defined functions in xsl:key (xsltproc does not).
889 </para>
890 <para>This method is suitable for any language for which you can
891 list all the individual characters that should appear
892 in each letter group in an index.
893 It is probably not practical to use it for ideographic languages
894 such as Chinese that have hundreds or thousands of characters.
895 </para>
896
897 <para>To use the kosek method, you must:</para>
898
899 <orderedlist>
900 <listitem>
901 <para>Use a processor that supports its extensions, such as
902 Saxon 6 or Xalan (xsltproc and Saxon 8 do not).
903 </para>
904 </listitem>
905 <listitem>
906 <para>Set the index.method parameter's value to <quote>kosek</quote>.
907 </para>
908 </listitem>
909 <listitem>
910 <para>Import the appropriate index extensions stylesheet module
911 <filename>fo/autoidx-kosek.xsl</filename> or 
912 <filename>html/autoidx-kosek.xsl</filename> into your
913 customization.
914 </para>
915 </listitem>
916 </orderedlist>
917
918 </listitem>
919 </varlistentry>
920 <varlistentry>
921 <term><literal>kimber</literal></term>
922 <listitem>
923 <para>
924 This method uses extensions to the Saxon processor to implement
925 sophisticated indexing processes. It uses its own 
926 configuration file, which can include information for any number of
927 languages. Each language's configuration can group
928 words using one of two processes. In the
929 enumerated process similar to that used in the kosek method,
930 you indicate the groupings character-by-character.
931 In the between-key process, you specify the
932 break-points in the sort order that should start a new group.
933 The latter configuration is useful for ideographic languages
934 such as Chinese, Japanese, and Korean.
935 You can also define your own collation algorithms and how you
936 want mixed Latin-alphabet words sorted.</para>
937 <itemizedlist>
938 <listitem>
939 <para>For a whitepaper describing the extensions, see:
940 <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>.
941 </para>
942 </listitem>
943 <listitem>
944 <para>To download the extension library, see
945 <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>.
946 </para>
947 </listitem>
948 </itemizedlist>
949
950 <para>To use the kimber method, you must:</para>
951
952 <orderedlist>
953 <listitem>
954 <para>Use Saxon (version 6 or 8) as your XSLT processor.
955 </para>
956 </listitem>
957 <listitem>
958 <para>Install and configure the Innodata Isogen library, using
959 the documentation that comes with it.
960 </para>
961 </listitem>
962 <listitem>
963 <para>Set the index.method parameter's value to <quote>kimber</quote>.
964 </para>
965 </listitem>
966 <listitem>
967 <para>Import the appropriate index extensions stylesheet module
968 <filename>fo/autoidx-kimber.xsl</filename> or 
969 <filename>html/autoidx-kimber.xsl</filename> into your
970 customization.
971 </para>
972 </listitem>
973 </orderedlist>
974
975 </listitem>
976 </varlistentry>
977 </variablelist>
978
979 </refsection>
980 </refentry>
981
982 <refentry version="5.0" xml:id="index.on.type">
983 <refmeta>
984 <refentrytitle>index.on.type</refentrytitle>
985 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
986 </refmeta>
987 <refnamediv>
988 <refname>index.on.type</refname>
989 <refpurpose>Select indexterms based on <tag class="attribute">type</tag>
990 attribute value</refpurpose>
991 </refnamediv>
992
993 <refsynopsisdiv>
994 <programlisting xml:id="index.on.type.frag">
995 &lt;xsl:param name="index.on.type" select="0"&gt;&lt;/xsl:param&gt;
996 </programlisting>
997 </refsynopsisdiv>
998
999 <refsection><info><title>Description</title></info>
1000
1001 <para>
1002 If non-zero, 
1003 then an <tag>index</tag> element that has a
1004 <tag class="attribute">type</tag> attribute
1005 value will contain only those <tag>indexterm</tag>
1006 elements with a matching <tag class="attribute">type</tag> attribute value.
1007 If an <tag>index</tag> has no <tag class="attribute">type</tag>
1008 attribute or it is blank, then the index will contain
1009 all <tag>indexterm</tag>s in the current scope.
1010 </para>
1011
1012 <para>
1013 If <literal>index.on.type</literal> is zero, then the
1014 <tag class="attribute">type</tag> attribute has no effect
1015 on selecting indexterms for an index.
1016 </para>
1017
1018 <para>For those using DocBook version 4.2 or earlier,
1019 the <tag class="attribute">type</tag> attribute is not available
1020 for index terms.  However, you can achieve the same
1021 effect by using the <tag class="attribute">role</tag> attribute
1022 in the same manner on <tag>indexterm</tag>
1023 and <tag>index</tag>, and setting the stylesheet parameter 
1024 <parameter>index.on.role</parameter> to a nonzero value.
1025 </para>
1026
1027 </refsection>
1028 </refentry>
1029
1030 <refentry version="5.0" xml:id="index.on.role">
1031 <refmeta>
1032 <refentrytitle>index.on.role</refentrytitle>
1033 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1034 </refmeta>
1035 <refnamediv>
1036 <refname>index.on.role</refname>
1037 <refpurpose>Select indexterms based on <tag class="attribute">role</tag> value</refpurpose>
1038 </refnamediv>
1039
1040 <refsynopsisdiv>
1041 <programlisting xml:id="index.on.role.frag">
1042 &lt;xsl:param name="index.on.role" select="0"&gt;&lt;/xsl:param&gt;
1043 </programlisting>
1044 </refsynopsisdiv>
1045
1046 <refsection><info><title>Description</title></info>
1047
1048 <para>
1049 If non-zero, 
1050 then an <tag>index</tag> element that has a
1051 <tag class="attribute">role</tag> attribute
1052 value will contain only those <tag>indexterm</tag>
1053 elements with a matching role value.
1054 If an <tag>index</tag> has no <tag class="attribute">role</tag>
1055 attribute or it is blank, then the index will contain
1056 all <tag>indexterm</tag>s in the current scope.
1057 </para>
1058 <para>
1059 If <literal>index.on.role</literal> is zero, then the
1060 <tag class="attribute">role</tag> attribute has no effect
1061 on selecting indexterms for an index.
1062 </para>
1063
1064 <para>If you are using DocBook version 4.3 or later, you should
1065 use the <tag class="attribute">type</tag> attribute instead of <tag class="attribute">role</tag>
1066 on <tag>indexterm</tag> and <tag>index</tag>,
1067 and set the <parameter>index.on.type</parameter> to a nonzero
1068 value.
1069 </para>
1070
1071 </refsection>
1072 </refentry>
1073
1074 <refentry version="5.0" xml:id="index.preferred.page.properties">
1075 <refmeta>
1076 <refentrytitle>index.preferred.page.properties</refentrytitle>
1077 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
1078 </refmeta>
1079 <refnamediv>
1080 <refname>index.preferred.page.properties</refname>
1081 <refpurpose>Properties used to emphasize page number references for
1082 significant index terms</refpurpose>
1083 </refnamediv>
1084
1085 <refsynopsisdiv>
1086 <programlisting xml:id="index.preferred.page.properties.frag">
1087 &lt;xsl:attribute-set name="index.preferred.page.properties"&gt;
1088   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
1089 &lt;/xsl:attribute-set&gt;
1090 </programlisting>
1091 </refsynopsisdiv>
1092
1093 <refsection><info><title>Description</title></info>
1094
1095 <para>Properties used to emphasize page number references for
1096 significant index terms (<tag class="attribute">significance</tag>=<tag class="attvalue">preferred</tag>). Currently works only with
1097 XEP.</para>
1098
1099 </refsection>
1100 </refentry>
1101
1102 <refentry version="5.0" xml:id="index.entry.properties">
1103 <refmeta>
1104 <refentrytitle>index.entry.properties</refentrytitle>
1105 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
1106 </refmeta>
1107 <refnamediv>
1108 <refname>index.entry.properties</refname>
1109 <refpurpose>Properties applied to the formatted entries
1110 in an index</refpurpose>
1111 </refnamediv>
1112
1113 <refsynopsisdiv>
1114 <programlisting xml:id="index.entry.properties.frag">
1115 &lt;xsl:attribute-set name="index.entry.properties"&gt;
1116   &lt;xsl:attribute name="start-indent"&gt;0pt&lt;/xsl:attribute&gt;
1117 &lt;/xsl:attribute-set&gt;
1118 </programlisting>
1119 </refsynopsisdiv>
1120
1121 <refsection><info><title>Description</title></info>
1122
1123 <para>This attribute set is applied to the block containing
1124 the entries in a letter division in an index.  It can be used to set the
1125 font-size, font-family, and other inheritable properties that will be
1126 applied to all index entries.</para>
1127
1128 </refsection>
1129 </refentry>
1130
1131 <refentry version="5.0" xml:id="index.div.title.properties">
1132 <refmeta>
1133 <refentrytitle>index.div.title.properties</refentrytitle>
1134 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
1135 </refmeta>
1136 <refnamediv>
1137 <refname>index.div.title.properties</refname>
1138 <refpurpose>Properties associated with the letter headings in an
1139 index</refpurpose>
1140 </refnamediv>
1141
1142 <refsynopsisdiv>
1143 <programlisting xml:id="index.div.title.properties.frag">
1144 &lt;xsl:attribute-set name="index.div.title.properties"&gt;
1145   &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;0pt&lt;/xsl:attribute&gt;
1146   &lt;xsl:attribute name="font-size"&gt;14.4pt&lt;/xsl:attribute&gt;
1147   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$title.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
1148   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
1149   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
1150   &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;
1151   &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;
1152   &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;
1153   &lt;xsl:attribute name="start-indent"&gt;0pt&lt;/xsl:attribute&gt;
1154 &lt;/xsl:attribute-set&gt;
1155 </programlisting>
1156 </refsynopsisdiv>
1157
1158 <refsection><info><title>Description</title></info>
1159
1160 <para>This attribute set is used on the letter headings that separate
1161 the divisions in an index.</para>
1162
1163 </refsection>
1164 </refentry>
1165
1166 <refentry version="5.0" xml:id="index.number.separator">
1167 <refmeta>
1168 <refentrytitle>index.number.separator</refentrytitle>
1169 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
1170 </refmeta>
1171 <refnamediv>
1172 <refname>index.number.separator</refname>
1173 <refpurpose>Override for punctuation separating page numbers in index</refpurpose>
1174 </refnamediv>
1175
1176 <refsynopsisdiv>
1177 <programlisting xml:id="index.number.separator.frag">
1178 &lt;xsl:param name="index.number.separator"&gt;&lt;/xsl:param&gt;
1179 </programlisting>
1180 </refsynopsisdiv>
1181
1182 <refsection><info><title>Description</title></info>
1183
1184 <para>This parameter permits you to override the text to insert between
1185 page references in a formatted index entry.  Typically 
1186 that would be a comma and a space.
1187 </para>
1188
1189 <para>Because this text may be locale dependent,
1190 this parameter's value is normally taken from a gentext
1191 template named 'number-separator' in the
1192 context 'index' in the stylesheet
1193 locale file for the language
1194 of the current document.
1195 This parameter can be used to override the gentext string,
1196 and would typically be used on the command line.
1197 This parameter would apply to all languages.
1198 </para>
1199
1200 <para>So this text string can be customized in two ways.
1201 You can reset the default gentext string using
1202 the <parameter>local.l10n.xml</parameter> parameter, or you can
1203 override the gentext with the content of this parameter.
1204 The content can be a simple string, or it can be
1205 something more complex such as a call-template.
1206 </para>
1207
1208 <para>In HTML index output, section title references are used instead of
1209 page number references.  This punctuation appears between
1210 such section titles in an HTML index.
1211 </para>
1212
1213 </refsection>
1214 </refentry>
1215
1216 <refentry version="5.0" xml:id="index.range.separator">
1217 <refmeta>
1218 <refentrytitle>index.range.separator</refentrytitle>
1219 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
1220 </refmeta>
1221 <refnamediv>
1222 <refname>index.range.separator</refname>
1223 <refpurpose>Override for punctuation separating the two numbers
1224 in a page range in index</refpurpose>
1225 </refnamediv>
1226
1227 <refsynopsisdiv>
1228 <programlisting xml:id="index.range.separator.frag">
1229 &lt;xsl:param name="index.range.separator"&gt;&lt;/xsl:param&gt;
1230 </programlisting>
1231 </refsynopsisdiv>
1232
1233 <refsection><info><title>Description</title></info>
1234
1235 <para>This parameter permits you
1236 to override the text to insert between
1237 the two numbers of a page range in an index.
1238 This parameter is only used by those XSL-FO processors
1239 that support an extension for generating such page ranges
1240 (such as XEP).</para>
1241
1242 <para>Because this text may be locale dependent,
1243 this parameter's value is normally taken from a gentext
1244 template named 'range-separator' in the
1245 context 'index' in the stylesheet
1246 locale file for the language
1247 of the current document.
1248 This parameter can be used to override the gentext string,
1249 and would typically be used on the command line.
1250 This parameter would apply to all languages.
1251 </para>
1252
1253 <para>So this text string can be customized in two ways.
1254 You can reset the default gentext string using
1255 the <parameter>local.l10n.xml</parameter> parameter, or you can
1256 override the gentext with the content of this parameter.
1257 The content can be a simple string, or it can be
1258 something more complex such as a call-template.
1259 </para>
1260
1261 <para>In HTML index output, section title references are used instead of
1262 page number references. So there are no page ranges
1263 and this parameter has no effect.
1264 </para>
1265
1266 </refsection>
1267 </refentry>
1268
1269 <refentry version="5.0" xml:id="index.term.separator">
1270 <refmeta>
1271 <refentrytitle>index.term.separator</refentrytitle>
1272 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
1273 </refmeta>
1274 <refnamediv>
1275 <refname>index.term.separator</refname>
1276 <refpurpose>Override for punctuation separating an index term 
1277 from its list of page references in an index</refpurpose>
1278 </refnamediv>
1279
1280 <refsynopsisdiv>
1281 <programlisting xml:id="index.term.separator.frag">
1282 &lt;xsl:param name="index.term.separator"&gt;&lt;/xsl:param&gt;
1283 </programlisting>
1284 </refsynopsisdiv>
1285
1286 <refsection><info><title>Description</title></info>
1287
1288 <para>This parameter permits you to override
1289 the text to insert between
1290 the end of an index term and its list of page references.
1291 Typically that might be a comma and a space.
1292 </para>
1293
1294 <para>Because this text may be locale dependent,
1295 this parameter's value is normally taken from a gentext
1296 template named 'term-separator' in the
1297 context 'index' in the stylesheet
1298 locale file for the language
1299 of the current document.
1300 This parameter can be used to override the gentext string,
1301 and would typically be used on the command line.
1302 This parameter would apply to all languages.
1303 </para>
1304
1305 <para>So this text string can be customized in two ways.
1306 You can reset the default gentext string using
1307 the <parameter>local.l10n.xml</parameter> parameter, or you can
1308 fill in the content for this normally empty 
1309 override parameter.
1310 The content can be a simple string, or it can be
1311 something more complex such as a call-template.
1312 For fo output, it could be an <tag>fo:leader</tag>
1313 element to provide space of a specific length, or a dot leader.
1314 </para>
1315
1316 </refsection>
1317 </refentry>
1318
1319 <refentry version="5.0" xml:id="xep.index.item.properties">
1320 <refmeta>
1321 <refentrytitle>xep.index.item.properties</refentrytitle>
1322 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
1323 </refmeta>
1324 <refnamediv>
1325 <refname>xep.index.item.properties</refname>
1326 <refpurpose>Properties associated with XEP index-items</refpurpose>
1327 </refnamediv>
1328
1329 <refsynopsisdiv>
1330 <programlisting xml:id="xep.index.item.properties.frag">
1331 &lt;xsl:attribute-set name="xep.index.item.properties" use-attribute-sets="index.page.number.properties"&gt;
1332   &lt;xsl:attribute name="merge-subsequent-page-numbers"&gt;true&lt;/xsl:attribute&gt;
1333   &lt;xsl:attribute name="link-back"&gt;true&lt;/xsl:attribute&gt;
1334 &lt;/xsl:attribute-set&gt;
1335 </programlisting>
1336 </refsynopsisdiv>
1337
1338 <refsection><info><title>Description</title></info>
1339
1340 <para>Properties associated with XEP index-items, which generate
1341 page numbers in an index processed by XEP. For more info see
1342 the XEP documentation section "Indexes" in
1343 <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>
1344
1345 <para>This attribute-set also adds by default any properties from the
1346 <tag class="attribute">index.page.number.properties</tag>
1347 attribute-set.</para>
1348 </refsection>
1349 </refentry>
1350
1351 <refentry version="5.0" xml:id="toc.section.depth">
1352 <refmeta>
1353 <refentrytitle>toc.section.depth</refentrytitle>
1354 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
1355 </refmeta>
1356 <refnamediv>
1357 <refname>toc.section.depth</refname>
1358 <refpurpose>How deep should recursive <tag>section</tag>s appear
1359 in the TOC?</refpurpose>
1360 </refnamediv>
1361
1362 <refsynopsisdiv>
1363 <programlisting xml:id="toc.section.depth.frag">&lt;xsl:param name="toc.section.depth"&gt;2&lt;/xsl:param&gt;</programlisting>
1364 </refsynopsisdiv>
1365
1366 <refsection><info><title>Description</title></info>
1367
1368 <para>Specifies the depth to which recursive sections should appear in the
1369 TOC.
1370 </para>
1371
1372 </refsection>
1373 </refentry>
1374
1375 <refentry version="5.0" xml:id="toc.max.depth">
1376 <refmeta>
1377 <refentrytitle>toc.max.depth</refentrytitle>
1378 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
1379 </refmeta>
1380 <refnamediv>
1381 <refname>toc.max.depth</refname>
1382 <refpurpose>How many levels should be created for each TOC?</refpurpose>
1383 </refnamediv>
1384
1385 <refsynopsisdiv>
1386 <programlisting xml:id="toc.max.depth.frag">&lt;xsl:param name="toc.max.depth"&gt;8&lt;/xsl:param&gt;</programlisting>
1387 </refsynopsisdiv>
1388
1389 <refsection><info><title>Description</title></info>
1390
1391 <para>Specifies the maximal depth of TOC on all levels.</para>
1392
1393 </refsection>
1394 </refentry>
1395
1396 <refentry version="5.0" xml:id="toc.indent.width">
1397 <refmeta>
1398 <refentrytitle>toc.indent.width</refentrytitle>
1399 <refmiscinfo class="other" otherclass="datatype">float</refmiscinfo>
1400 </refmeta>
1401 <refnamediv>
1402 <refname>toc.indent.width</refname>
1403 <refpurpose>Amount of indentation for TOC entries</refpurpose>
1404 </refnamediv>
1405
1406 <refsynopsisdiv>
1407 <programlisting xml:id="toc.indent.width.frag">
1408 &lt;xsl:param name="toc.indent.width"&gt;24&lt;/xsl:param&gt;
1409 &lt;!-- inconsistant point specification? --&gt;
1410 </programlisting>
1411 </refsynopsisdiv>
1412
1413 <refsection><info><title>Description</title></info>
1414
1415 <para>Specifies, in points, the distance by which each level of the
1416 TOC is indented from its parent.</para>
1417
1418 <para>This value is expressed in points, without
1419 a unit (in other words, it is a bare number). Using a bare number allows the stylesheet
1420 to perform calculations that would otherwise have to be performed by the FO processor
1421 because not all processors support expressions.</para>
1422
1423 </refsection>
1424 </refentry>
1425
1426 <refentry version="5.0" xml:id="toc.line.properties">
1427 <refmeta>
1428 <refentrytitle>toc.line.properties</refentrytitle>
1429 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
1430 </refmeta>
1431 <refnamediv>
1432 <refname>toc.line.properties</refname>
1433 <refpurpose>Properties for lines in ToCs and LoTs</refpurpose>
1434 </refnamediv>
1435
1436 <refsynopsisdiv>
1437 <programlisting xml:id="toc.line.properties.frag">
1438 &lt;xsl:attribute-set name="toc.line.properties"&gt;
1439   &lt;xsl:attribute name="text-align-last"&gt;justify&lt;/xsl:attribute&gt;
1440   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;
1441   &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;
1442   &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;
1443 &lt;/xsl:attribute-set&gt;
1444 </programlisting>
1445 </refsynopsisdiv>
1446
1447 <refsection><info><title>Description</title></info>
1448
1449 <para>Properties which are applied to every line in ToC (or LoT). You can
1450 modify them in order to change appearance of all, or some lines. For
1451 example, in order to make lines for chapters bold, specify the
1452 following in your customization layer:</para>
1453
1454 <programlisting>&lt;xsl:attribute-set name="toc.line.properties"&gt;
1455   &lt;xsl:attribute name="font-weight"&gt;
1456    &lt;xsl:choose&gt;
1457     &lt;xsl:when test="self::chapter"&gt;bold&lt;/xsl:when&gt;
1458     &lt;xsl:otherwise&gt;normal&lt;/xsl:otherwise&gt;
1459    &lt;/xsl:choose&gt;
1460   &lt;/xsl:attribute&gt;
1461 &lt;/xsl:attribute-set&gt;</programlisting>
1462
1463 </refsection>
1464 </refentry>
1465
1466 <refentry version="5.0" xml:id="toc.margin.properties">
1467 <refmeta>
1468 <refentrytitle>toc.margin.properties</refentrytitle>
1469 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
1470 </refmeta>
1471 <refnamediv>
1472 <refname>toc.margin.properties</refname>
1473 <refpurpose>Margin properties used on Tables of Contents</refpurpose>
1474 </refnamediv>
1475
1476 <refsynopsisdiv>
1477 <programlisting xml:id="toc.margin.properties.frag">
1478 &lt;xsl:attribute-set name="toc.margin.properties"&gt;
1479   &lt;xsl:attribute name="space-before.minimum"&gt;0.5em&lt;/xsl:attribute&gt;
1480   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
1481   &lt;xsl:attribute name="space-before.maximum"&gt;2em&lt;/xsl:attribute&gt;
1482   &lt;xsl:attribute name="space-after.minimum"&gt;0.5em&lt;/xsl:attribute&gt;
1483   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;
1484   &lt;xsl:attribute name="space-after.maximum"&gt;2em&lt;/xsl:attribute&gt;
1485 &lt;/xsl:attribute-set&gt;
1486 </programlisting>
1487 </refsynopsisdiv>
1488
1489 <refsection><info><title>Description</title></info>
1490 <para>This attribute set is used on Tables of Contents. These attributes are set
1491 on the wrapper that surrounds the ToC block, not on each individual lines.</para>
1492 </refsection>
1493 </refentry>
1494
1495 <refentry version="5.0" xml:id="bridgehead.in.toc">
1496 <refmeta>
1497 <refentrytitle>bridgehead.in.toc</refentrytitle>
1498 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1499 </refmeta>
1500 <refnamediv>
1501 <refname>bridgehead.in.toc</refname>
1502 <refpurpose>Should bridgehead elements appear in the TOC?</refpurpose>
1503 </refnamediv>
1504
1505 <refsynopsisdiv>
1506 <programlisting xml:id="bridgehead.in.toc.frag">&lt;xsl:param name="bridgehead.in.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1507 </refsynopsisdiv>
1508
1509 <refsection><info><title>Description</title></info>
1510
1511 <para>If non-zero, <tag>bridgehead</tag>s appear in the TOC. Note that
1512 this option is not fully supported and may be removed in a future
1513 version of the stylesheets.
1514 </para>
1515
1516 </refsection>
1517 </refentry>
1518
1519 <refentry version="5.0" xml:id="simplesect.in.toc">
1520 <refmeta>
1521 <refentrytitle>simplesect.in.toc</refentrytitle>
1522 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1523 </refmeta>
1524 <refnamediv>
1525 <refname>simplesect.in.toc</refname>
1526 <refpurpose>Should <tag>simplesect</tag> elements appear in the TOC?</refpurpose>
1527 </refnamediv>
1528
1529 <refsynopsisdiv>
1530 <programlisting xml:id="simplesect.in.toc.frag">&lt;xsl:param name="simplesect.in.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1531 </refsynopsisdiv>
1532
1533 <refsection><info><title>Description</title></info>
1534
1535 <para>If non-zero, <tag>simplesect</tag>s will be included in the TOC.
1536 </para>
1537
1538 </refsection>
1539 </refentry>
1540
1541 <refentry version="5.0" xml:id="generate.section.toc.level">
1542 <refmeta>
1543 <refentrytitle>generate.section.toc.level</refentrytitle>
1544 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
1545 </refmeta>
1546 <refnamediv>
1547 <refname>generate.section.toc.level</refname>
1548 <refpurpose>Control depth of TOC generation in sections</refpurpose>
1549 </refnamediv>
1550
1551 <refsynopsisdiv>
1552 <programlisting xml:id="generate.section.toc.level.frag">
1553 &lt;xsl:param name="generate.section.toc.level" select="0"&gt;&lt;/xsl:param&gt;
1554 </programlisting>
1555 </refsynopsisdiv>
1556
1557 <refsection><info><title>Description</title></info>
1558
1559 <para>The <parameter>generate.section.toc.level</parameter> parameter
1560 controls the depth of <tag>section</tag> in which TOCs will be generated. Note
1561 that this is related to, but not the same as
1562 <parameter>toc.section.depth</parameter>, which controls the depth to
1563 which TOC entries will be generated in a given TOC.</para>
1564 <para>If, for example, <parameter>generate.section.toc.level</parameter>
1565 is <literal>3</literal>, TOCs will be generated in first, second, and third
1566 level sections, but not in fourth level sections.
1567 </para>
1568
1569 </refsection>
1570 </refentry>
1571
1572
1573
1574
1575 </reference>
1576 <reference xml:id="fo_ext"><title>Processor Extensions</title>
1577 <refentry version="5.0" xml:id="arbortext.extensions">
1578 <refmeta>
1579 <refentrytitle>arbortext.extensions</refentrytitle>
1580 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1581 </refmeta>
1582 <refnamediv>
1583 <refname>arbortext.extensions</refname>
1584 <refpurpose>Enable Arbortext extensions?</refpurpose>
1585 </refnamediv>
1586
1587 <refsynopsisdiv>
1588 <programlisting xml:id="arbortext.extensions.frag">&lt;xsl:param name="arbortext.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1589 </refsynopsisdiv>
1590
1591 <refsection><info><title>Description</title></info>
1592
1593 <para>If non-zero,
1594 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.arbortext.com/">Arbortext</link>
1595 extensions will be used.
1596 </para>
1597 <para>This parameter can also affect which graphics file formats
1598 are supported</para>
1599
1600 </refsection>
1601 </refentry>
1602
1603 <refentry version="5.0" xml:id="axf.extensions">
1604 <refmeta>
1605 <refentrytitle>axf.extensions</refentrytitle>
1606 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1607 </refmeta>
1608 <refnamediv>
1609 <refname>axf.extensions</refname>
1610 <refpurpose>Enable XSL Formatter extensions?</refpurpose>
1611 </refnamediv>
1612
1613 <refsynopsisdiv>
1614 <programlisting xml:id="axf.extensions.frag">
1615 &lt;xsl:param name="axf.extensions" select="0"&gt;&lt;/xsl:param&gt;
1616 </programlisting>
1617 </refsynopsisdiv>
1618
1619 <refsection><info><title>Description</title></info>
1620
1621 <para>If non-zero,
1622 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.antennahouse.com/">XSL Formatter</link>
1623 extensions will be used. XSL Formatter extensions consists of PDF bookmarks,
1624 document information and better index processing.</para>
1625
1626 <para>This parameter can also affect which graphics file formats
1627 are supported</para>
1628
1629 </refsection>
1630 </refentry>
1631
1632 <refentry version="5.0" xml:id="fop.extensions">
1633 <refmeta>
1634 <refentrytitle>fop.extensions</refentrytitle>
1635 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1636 </refmeta>
1637 <refnamediv>
1638 <refname>fop.extensions</refname>
1639 <refpurpose>Enable extensions for FOP version 0.20.5 and earlier</refpurpose>
1640 </refnamediv>
1641
1642 <refsynopsisdiv>
1643 <programlisting xml:id="fop.extensions.frag">&lt;xsl:param name="fop.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1644 </refsynopsisdiv>
1645
1646 <refsection><info><title>Description</title></info>
1647
1648 <para>If non-zero, extensions intended for
1649 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://xml.apache.org/fop/">FOP</link>
1650 version 0.20.5 and earlier will be used.
1651 At present, this consists of PDF bookmarks.
1652 </para>
1653
1654 <para>This parameter can also affect which graphics file formats
1655 are supported.</para>
1656
1657 <para>If you are using a version of FOP beyond
1658 version 0.20.5, then use the <parameter>fop1.extensions</parameter> parameter
1659 instead.
1660 </para>
1661 </refsection>
1662 </refentry>
1663
1664 <refentry version="5.0" xml:id="fop1.extensions">
1665 <refmeta>
1666 <refentrytitle>fop1.extensions</refentrytitle>
1667 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1668 </refmeta>
1669 <refnamediv>
1670 <refname>fop1.extensions</refname>
1671 <refpurpose>Enable extensions for FOP version 0.90 and later</refpurpose>
1672 </refnamediv>
1673
1674 <refsynopsisdiv>
1675 <programlisting xml:id="fop1.extensions.frag">&lt;xsl:param name="fop1.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1676 </refsynopsisdiv>
1677
1678 <refsection><info><title>Description</title></info>
1679
1680 <para>If non-zero, extensions for 
1681 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://xml.apache.org/fop/">FOP</link>
1682 version 0.90 and later will be used.
1683 </para>
1684
1685 <para>This parameter can also affect which graphics file formats
1686 are supported.</para>
1687
1688 <para>The original <parameter>fop.extensions</parameter> parameter
1689 should still be used for FOP version 0.20.5 and earlier.
1690 </para>
1691 </refsection>
1692 </refentry>
1693
1694 <refentry version="5.0" xml:id="passivetex.extensions">
1695 <refmeta>
1696 <refentrytitle>passivetex.extensions</refentrytitle>
1697 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1698 </refmeta>
1699 <refnamediv>
1700 <refname>passivetex.extensions</refname>
1701 <refpurpose>Enable PassiveTeX extensions?</refpurpose>
1702 </refnamediv>
1703
1704 <refsynopsisdiv>
1705 <programlisting xml:id="passivetex.extensions.frag">&lt;xsl:param name="passivetex.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1706 </refsynopsisdiv>
1707
1708 <refsection><info><title>Description</title></info>
1709
1710 <para>If non-zero,
1711 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.tei-c.org.uk/Software/passivetex/">PassiveTeX</link>
1712 extensions will be used. At present, this consists of PDF bookmarks
1713 and sorted index terms.
1714 </para>
1715
1716 <para>This parameter can also affect which graphics file formats
1717 are supported</para>
1718
1719 <note>
1720   <para>PassiveTeX is incomplete and development has ceased. In most cases, 
1721 another XSL-FO engine is probably a better choice.</para>
1722 </note>
1723
1724 </refsection>
1725 </refentry>
1726
1727 <refentry version="5.0" xml:id="tex.math.in.alt">
1728 <refmeta>
1729 <refentrytitle>tex.math.in.alt</refentrytitle>
1730 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
1731 <refmiscinfo class="other" otherclass="value">plain</refmiscinfo>
1732 <refmiscinfo class="other" otherclass="value">latex</refmiscinfo>
1733 </refmeta>
1734 <refnamediv>
1735 <refname>tex.math.in.alt</refname>
1736 <refpurpose>TeX notation used for equations</refpurpose>
1737 </refnamediv>
1738
1739 <refsynopsisdiv>
1740 <programlisting xml:id="tex.math.in.alt.frag">
1741 &lt;xsl:param name="tex.math.in.alt"&gt;&lt;/xsl:param&gt;
1742 </programlisting>
1743 </refsynopsisdiv>
1744
1745 <refsection><info><title>Description</title></info>
1746
1747 <para>If you want type math directly in TeX notation in equations,
1748 this parameter specifies notation used. Currently are supported two
1749 values -- <literal>plain</literal> and <literal>latex</literal>. Empty
1750 value means that you are not using TeX math at all.</para>
1751
1752 <para>Preferred way for including TeX alternative of math is inside of
1753 <tag>textobject</tag> element. Eg.:</para>
1754
1755 <programlisting>&lt;inlineequation&gt;
1756 &lt;inlinemediaobject&gt;
1757 &lt;imageobject&gt;
1758 &lt;imagedata fileref="eq1.gif"/&gt;
1759 &lt;/imageobject&gt;
1760 &lt;textobject&gt;&lt;phrase&gt;E=mc squared&lt;/phrase&gt;&lt;/textobject&gt;
1761 &lt;textobject role="tex"&gt;&lt;phrase&gt;E=mc^2&lt;/phrase&gt;&lt;/textobject&gt;
1762 &lt;/inlinemediaobject&gt;
1763 &lt;/inlineequation&gt;</programlisting>
1764
1765 <para>If you are using <tag>graphic</tag> element, you can
1766 store TeX inside <tag>alt</tag> element:</para>
1767
1768 <programlisting>&lt;inlineequation&gt;
1769 &lt;alt role="tex"&gt;a^2+b^2=c^2&lt;/alt&gt;
1770 &lt;graphic fileref="a2b2c2.gif"/&gt;  
1771 &lt;/inlineequation&gt;</programlisting>
1772
1773 <para>If you want use this feature, you should process your FO with
1774 PassiveTeX, which only supports TeX math notation. When calling
1775 stylsheet, don't forget to specify also
1776 passivetex.extensions=1.</para>
1777
1778 <para>If you want equations in HTML, just process generated file
1779 <filename>tex-math-equations.tex</filename> by TeX or LaTeX. Then run
1780 dvi2bitmap program on result DVI file. You will get images for
1781 equations in your document.</para>
1782
1783 <warning>
1784   <para>This feature is useful for print/PDF output only if you
1785     use the obsolete and now unsupported PassiveTeX XSL-FO
1786     engine.</para>
1787 </warning>
1788
1789 </refsection>
1790
1791 <refsection><info><title>Related Parameters</title></info>
1792   <para><parameter>tex.math.delims</parameter>,
1793     <parameter>passivetex.extensions</parameter>,
1794     <parameter>tex.math.file</parameter></para>
1795 </refsection>
1796
1797 </refentry>
1798
1799 <refentry version="5.0" xml:id="tex.math.delims">
1800 <refmeta>
1801 <refentrytitle>tex.math.delims</refentrytitle>
1802 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1803 </refmeta>
1804 <refnamediv>
1805 <refname>tex.math.delims</refname>
1806 <refpurpose>Should equations output for processing by TeX be
1807 surrounded by math mode delimiters?</refpurpose>
1808 </refnamediv> 
1809
1810 <refsynopsisdiv>
1811 <programlisting xml:id="tex.math.delims.frag">
1812 &lt;xsl:param name="tex.math.delims" select="1"&gt;&lt;/xsl:param&gt;
1813 </programlisting>
1814 </refsynopsisdiv>
1815
1816 <refsection><info><title>Description</title></info>
1817
1818 <para>For compatibility with DSSSL based DBTeXMath from Allin Cottrell
1819 you should set this parameter to 0.</para>
1820
1821 <warning>
1822   <para>This feature is useful for print/PDF output only if you
1823   use the obsolete and now unsupported PassiveTeX XSL-FO
1824   engine.</para>
1825 </warning>
1826
1827 </refsection>
1828 <refsection><info><title>Related Parameters</title></info>
1829   <para><parameter>tex.math.in.alt</parameter>,
1830     <parameter>passivetex.extensions</parameter></para>
1831 </refsection>
1832
1833 <refsection><info><title>See Also</title></info>
1834   <para>You can also use the <tag class="xmlpi">dbtex delims</tag> processing
1835     instruction to control whether delimiters are output.</para>
1836 </refsection>
1837
1838
1839 </refentry>
1840
1841 <refentry version="5.0" xml:id="xep.extensions">
1842 <refmeta>
1843 <refentrytitle>xep.extensions</refentrytitle>
1844 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1845 </refmeta>
1846 <refnamediv>
1847 <refname>xep.extensions</refname>
1848 <refpurpose>Enable XEP extensions?</refpurpose>
1849 </refnamediv>
1850
1851 <refsynopsisdiv>
1852 <programlisting xml:id="xep.extensions.frag">&lt;xsl:param name="xep.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1853 </refsynopsisdiv>
1854
1855 <refsection><info><title>Description</title></info>
1856
1857 <para>If non-zero,
1858 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.renderx.com/">XEP</link>
1859 extensions will be used. XEP extensions consists of PDF bookmarks,
1860 document information and better index processing.
1861 </para>
1862
1863 <para>This parameter can also affect which graphics file formats
1864 are supported</para>
1865 </refsection>
1866 </refentry>
1867
1868 </reference>
1869 <reference xml:id="dbk_ext"><title>Stylesheet Extensions</title>
1870 <refentry version="5.0" xml:id="linenumbering.everyNth">
1871 <refmeta>
1872 <refentrytitle>linenumbering.everyNth</refentrytitle>
1873 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
1874 </refmeta>
1875 <refnamediv>
1876 <refname>linenumbering.everyNth</refname>
1877 <refpurpose>Indicate which lines should be numbered</refpurpose>
1878 </refnamediv>
1879
1880 <refsynopsisdiv>
1881 <programlisting xml:id="linenumbering.everyNth.frag">
1882 &lt;xsl:param name="linenumbering.everyNth"&gt;5&lt;/xsl:param&gt;
1883 </programlisting>
1884 </refsynopsisdiv>
1885
1886 <refsection><info><title>Description</title></info>
1887
1888 <para>If line numbering is enabled, everyNth line will be
1889 numbered. Note that numbering is one based, not zero based.
1890 </para>
1891
1892 </refsection>
1893 </refentry>
1894
1895 <refentry version="5.0" xml:id="linenumbering.extension">
1896 <refmeta>
1897 <refentrytitle>linenumbering.extension</refentrytitle>
1898 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1899 </refmeta>
1900 <refnamediv>
1901 <refname>linenumbering.extension</refname>
1902 <refpurpose>Enable the line numbering extension</refpurpose>
1903 </refnamediv>
1904
1905 <refsynopsisdiv>
1906 <programlisting xml:id="linenumbering.extension.frag">
1907 &lt;xsl:param name="linenumbering.extension" select="1"&gt;&lt;/xsl:param&gt;
1908 </programlisting>
1909 </refsynopsisdiv>
1910
1911 <refsection><info><title>Description</title></info>
1912
1913 <para>If non-zero, verbatim environments (<tag>address</tag>, <tag>literallayout</tag>,
1914 <tag>programlisting</tag>, <tag>screen</tag>, <tag>synopsis</tag>) that specify line numbering will
1915 have line numbers.
1916 </para>
1917
1918 </refsection>
1919 </refentry>
1920
1921 <refentry version="5.0" xml:id="linenumbering.separator">
1922 <refmeta>
1923 <refentrytitle>linenumbering.separator</refentrytitle>
1924 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
1925 </refmeta>
1926 <refnamediv>
1927 <refname>linenumbering.separator</refname>
1928 <refpurpose>Specify a separator between line numbers and lines</refpurpose>
1929 </refnamediv>
1930
1931 <refsynopsisdiv>
1932 <programlisting xml:id="linenumbering.separator.frag">
1933 &lt;xsl:param name="linenumbering.separator"&gt;&lt;xsl:text&gt; &lt;/xsl:text&gt;&lt;/xsl:param&gt;
1934 </programlisting>
1935 </refsynopsisdiv>
1936
1937 <refsection><info><title>Description</title></info>
1938
1939 <para>The separator is inserted between line numbers and lines in the
1940 verbatim environment. The default value is a single white space.
1941  Note the interaction with <parameter>linenumbering.width</parameter>
1942 </para>
1943
1944 </refsection>
1945 </refentry>
1946
1947 <refentry version="5.0" xml:id="linenumbering.width">
1948 <refmeta>
1949 <refentrytitle>linenumbering.width</refentrytitle>
1950 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
1951 </refmeta>
1952 <refnamediv>
1953 <refname>linenumbering.width</refname>
1954 <refpurpose>Indicates the width of line numbers</refpurpose>
1955 </refnamediv>
1956
1957 <refsynopsisdiv>
1958 <programlisting xml:id="linenumbering.width.frag">
1959 &lt;xsl:param name="linenumbering.width"&gt;3&lt;/xsl:param&gt;
1960 </programlisting>
1961 </refsynopsisdiv>
1962
1963 <refsection><info><title>Description</title></info>
1964
1965 <para>If line numbering is enabled, line numbers will appear right
1966 justified in a field "width" characters wide.
1967 </para>
1968
1969 </refsection>
1970 </refentry>
1971
1972 <refentry version="5.0" xml:id="tablecolumns.extension">
1973 <refmeta>
1974 <refentrytitle>tablecolumns.extension</refentrytitle>
1975 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1976 </refmeta>
1977 <refnamediv>
1978 <refname>tablecolumns.extension</refname>
1979 <refpurpose>Enable the table columns extension function</refpurpose>
1980 </refnamediv>
1981
1982 <refsynopsisdiv>
1983 <programlisting xml:id="tablecolumns.extension.frag">
1984 &lt;xsl:param name="tablecolumns.extension" select="1"&gt;&lt;/xsl:param&gt;
1985 </programlisting>
1986 </refsynopsisdiv>
1987
1988 <refsection><info><title>Description</title></info>
1989
1990 <para>The table columns extension function adjusts the widths of table
1991 columns in the HTML result to more accurately reflect the specifications
1992 in the CALS table.
1993 </para>
1994
1995 </refsection>
1996 </refentry>
1997
1998 <refentry version="5.0" xml:id="textinsert.extension">
1999   <refmeta>
2000     <refentrytitle>textinsert.extension</refentrytitle>
2001     <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2002   </refmeta>
2003   <refnamediv>
2004     <refname>textinsert.extension</refname>
2005     <refpurpose>Enables the textinsert extension element</refpurpose>
2006   </refnamediv>
2007   <refsynopsisdiv>
2008     <programlisting xml:id="textinsert.extension.frag">
2009   &lt;xsl:param name="textinsert.extension" select="1"&gt;&lt;/xsl:param&gt;
2010 </programlisting>
2011   </refsynopsisdiv>
2012   <refsection><info><title>Description</title></info>
2013     <para>The textinsert extension element inserts the contents of
2014       a file into the result tree (as text).</para>
2015     <note>
2016       <para>To use the textinsert extension element, you must use
2017         either Saxon or Xalan as your XSLT processor (it doesn&#8217;t
2018         work with xsltproc), along with either the DocBook Saxon
2019         extensions or DocBook Xalan extensions (for more
2020         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
2021         the <parameter>use.extensions</parameter> and
2022         <parameter>textinsert.extension</parameter> parameters to
2023         <literal>1</literal>.</para>
2024       <para>As an alternative to using the textinsert element,
2025         consider using an Xinclude element with the
2026         <literal>parse="text"</literal> attribute and value
2027         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>
2028     </note>
2029   </refsection>
2030   <refsection><info><title>See Also</title></info>
2031     <para>You can also use the <tag class="xmlpi">dbhtml-include&#160;href</tag> processing
2032       instruction to insert external files &#8212; both files containing
2033       plain text and files with markup content (including HTML
2034       content).</para>
2035   </refsection>
2036   <refsection><info><title>More information</title></info>
2037     <para>For how-to documentation on inserting contents of
2038       external code files and other text files into output, see
2039       <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="ExternalCode.html">External code files</link>.</para>
2040     <para>For guidelines on inserting contents of
2041       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>
2042   </refsection>
2043 </refentry>
2044
2045 <refentry version="5.0" xml:id="textdata.default.encoding">
2046 <refmeta>
2047 <refentrytitle>textdata.default.encoding</refentrytitle>
2048 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
2049 </refmeta>
2050 <refnamediv>
2051 <refname>textdata.default.encoding</refname>
2052 <refpurpose>Default encoding of external text files which are included
2053 using textdata element</refpurpose>
2054 </refnamediv>
2055
2056 <refsynopsisdiv>
2057 <programlisting xml:id="textdata.default.encoding.frag">
2058 &lt;xsl:param name="textdata.default.encoding"&gt;&lt;/xsl:param&gt;
2059 </programlisting>
2060 </refsynopsisdiv>
2061
2062 <refsection><info><title>Description</title></info>
2063
2064 <para>Specifies the encoding of any external text files included using
2065 <tag>textdata</tag> element. This value is used only when you do
2066 not specify encoding by the appropriate attribute 
2067 directly on textdata. An empty string is interpreted as the system
2068 default encoding.</para>
2069
2070 </refsection>
2071 </refentry>
2072
2073 <refentry version="5.0" xml:id="use.extensions">
2074 <refmeta>
2075 <refentrytitle>use.extensions</refentrytitle>
2076 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2077 </refmeta>
2078 <refnamediv>
2079 <refname>use.extensions</refname>
2080 <refpurpose>Enable extensions</refpurpose>
2081 </refnamediv>
2082
2083 <refsynopsisdiv>
2084 <programlisting xml:id="use.extensions.frag">
2085 &lt;xsl:param name="use.extensions" select="0"&gt;&lt;/xsl:param&gt;
2086 </programlisting>
2087 </refsynopsisdiv>
2088
2089 <refsection><info><title>Description</title></info>
2090
2091 <para>If non-zero, extensions may be used. Each extension is
2092 further controlled by its own parameter. But if
2093 <parameter>use.extensions</parameter> is zero, no extensions will
2094 be used.
2095 </para>
2096
2097 </refsection>
2098 </refentry>
2099
2100 </reference>
2101 <reference xml:id="labels"><title>Automatic labelling</title>
2102 <refentry version="5.0" xml:id="appendix.autolabel">
2103 <refmeta>
2104 <refentrytitle>appendix.autolabel</refentrytitle>
2105 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
2106 <refmiscinfo class="other" otherclass="value">0<alt>none</alt></refmiscinfo>
2107 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>
2108 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>
2109 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>
2110 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>
2111 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>
2112 </refmeta>
2113 <refnamediv>
2114 <refname>appendix.autolabel</refname>
2115 <refpurpose>Specifies the labeling format for Appendix titles</refpurpose>
2116 </refnamediv>
2117
2118 <refsynopsisdiv>
2119 <programlisting xml:id="appendix.autolabel.frag">
2120 &lt;xsl:param name="appendix.autolabel"&gt;A&lt;/xsl:param&gt;
2121 </programlisting>
2122 </refsynopsisdiv>
2123
2124 <refsection><info><title>Description</title></info>
2125
2126 <para>If non-zero, then appendices will be numbered using the
2127 parameter value as the number format if the value matches one of the
2128 following:
2129 </para>
2130
2131 <variablelist>
2132   <varlistentry>
2133     <term>1 or arabic</term>
2134     <listitem>
2135       <para>Arabic numeration (1, 2, 3 ...).</para>
2136     </listitem>
2137   </varlistentry>
2138   <varlistentry>
2139     <term>A or upperalpha</term>
2140     <listitem>
2141       <para>Uppercase letter numeration (A, B, C ...).</para>
2142     </listitem>
2143   </varlistentry>
2144   <varlistentry>
2145     <term>a or loweralpha</term>
2146     <listitem>
2147       <para>Lowercase letter numeration (a, b, c ...).</para>
2148     </listitem>
2149   </varlistentry>
2150   <varlistentry>
2151     <term>I or upperroman</term>
2152     <listitem>
2153       <para>Uppercase roman numeration (I, II, III ...).</para>
2154     </listitem>
2155   </varlistentry>
2156   <varlistentry>
2157     <term>i or lowerroman</term>
2158     <listitem>
2159       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>
2160     </listitem>
2161   </varlistentry>
2162 </variablelist>
2163
2164 <para>Any nonzero value other than the above will generate
2165 the default number format (upperalpha).
2166 </para>
2167
2168 </refsection>
2169 </refentry>
2170
2171 <refentry version="5.0" xml:id="chapter.autolabel">
2172 <refmeta>
2173 <refentrytitle>chapter.autolabel</refentrytitle>
2174 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
2175 <refmiscinfo class="other" otherclass="value">0<alt>none</alt></refmiscinfo>
2176 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>
2177 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>
2178 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>
2179 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>
2180 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>
2181 </refmeta>
2182 <refnamediv>
2183 <refname>chapter.autolabel</refname>
2184 <refpurpose>Specifies the labeling format for Chapter titles</refpurpose>
2185 </refnamediv>
2186
2187 <refsynopsisdiv>
2188 <programlisting xml:id="chapter.autolabel.frag">
2189 &lt;xsl:param name="chapter.autolabel" select="1"&gt;&lt;/xsl:param&gt;</programlisting>
2190 </refsynopsisdiv>
2191
2192 <refsection><info><title>Description</title></info>
2193
2194 <para>If non-zero, then chapters will be numbered using the parameter
2195 value as the number format if the value matches one of the following:
2196 </para>
2197
2198 <variablelist>
2199   <varlistentry>
2200     <term>1 or arabic</term>
2201     <listitem>
2202       <para>Arabic numeration (1, 2, 3 ...).</para>
2203     </listitem>
2204   </varlistentry>
2205   <varlistentry>
2206     <term>A or upperalpha</term>
2207     <listitem>
2208       <para>Uppercase letter numeration (A, B, C ...).</para>
2209     </listitem>
2210   </varlistentry>
2211   <varlistentry>
2212     <term>a or loweralpha</term>
2213     <listitem>
2214       <para>Lowercase letter numeration (a, b, c ...).</para>
2215     </listitem>
2216   </varlistentry>
2217   <varlistentry>
2218     <term>I or upperroman</term>
2219     <listitem>
2220       <para>Uppercase roman numeration (I, II, III ...).</para>
2221     </listitem>
2222   </varlistentry>
2223   <varlistentry>
2224     <term>i or lowerroman</term>
2225     <listitem>
2226       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>
2227     </listitem>
2228   </varlistentry>
2229 </variablelist>
2230
2231 <para>Any nonzero value other than the above will generate
2232 the default number format (arabic).
2233 </para>
2234
2235 </refsection>
2236 </refentry>
2237
2238 <refentry version="5.0" xml:id="part.autolabel">
2239 <refmeta>
2240 <refentrytitle>part.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>part.autolabel</refname>
2251 <refpurpose>Specifies the labeling format for Part titles</refpurpose>
2252 </refnamediv>
2253
2254 <refsynopsisdiv>
2255 <programlisting xml:id="part.autolabel.frag">
2256 &lt;xsl:param name="part.autolabel"&gt;I&lt;/xsl:param&gt;
2257 </programlisting>
2258 </refsynopsisdiv>
2259
2260 <refsection><info><title>Description</title></info>
2261
2262 <para>If non-zero, then parts will be numbered using the parameter
2263 value as the number format if the value matches one of the following:
2264 </para>
2265
2266 <variablelist>
2267   <varlistentry>
2268     <term>1 or arabic</term>
2269     <listitem>
2270       <para>Arabic numeration (1, 2, 3 ...).</para>
2271     </listitem>
2272   </varlistentry>
2273   <varlistentry>
2274     <term>A or upperalpha</term>
2275     <listitem>
2276       <para>Uppercase letter numeration (A, B, C ...).</para>
2277     </listitem>
2278   </varlistentry>
2279   <varlistentry>
2280     <term>a or loweralpha</term>
2281     <listitem>
2282       <para>Lowercase letter numeration (a, b, c ...).</para>
2283     </listitem>
2284   </varlistentry>
2285   <varlistentry>
2286     <term>I or upperroman</term>
2287     <listitem>
2288       <para>Uppercase roman numeration (I, II, III ...).</para>
2289     </listitem>
2290   </varlistentry>
2291   <varlistentry>
2292     <term>i or lowerroman</term>
2293     <listitem>
2294       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>
2295     </listitem>
2296   </varlistentry>
2297 </variablelist>
2298
2299 <para>Any nonzero value other than the above will generate
2300 the default number format (upperroman).
2301 </para>
2302
2303
2304 </refsection>
2305 </refentry>
2306
2307 <refentry version="5.0" xml:id="reference.autolabel">
2308 <refmeta>
2309 <refentrytitle>reference.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>reference.autolabel</refname>
2320 <refpurpose>Specifies the labeling format for Reference titles</refpurpose>
2321 </refnamediv>
2322 <refsynopsisdiv>
2323 <programlisting xml:id="reference.autolabel.frag">
2324   &lt;xsl:param name="reference.autolabel"&gt;I&lt;/xsl:param&gt;
2325 </programlisting>
2326 </refsynopsisdiv>
2327 <refsection><info><title>Description</title></info>
2328 <para>If non-zero, references will be numbered using the parameter
2329   value as the number format if the value matches one of the
2330   following:
2331 </para>
2332 <variablelist>
2333   <varlistentry>
2334     <term>1 or arabic</term>
2335     <listitem>
2336       <para>Arabic numeration (1, 2, 3 ...).</para>
2337     </listitem>
2338   </varlistentry>
2339   <varlistentry>
2340     <term>A or upperalpha</term>
2341     <listitem>
2342       <para>Uppercase letter numeration (A, B, C ...).</para>
2343     </listitem>
2344   </varlistentry>
2345   <varlistentry>
2346     <term>a or loweralpha</term>
2347     <listitem>
2348       <para>Lowercase letter numeration (a, b, c ...).</para>
2349     </listitem>
2350   </varlistentry>
2351   <varlistentry>
2352     <term>I or upperroman</term>
2353     <listitem>
2354       <para>Uppercase roman numeration (I, II, III ...).</para>
2355     </listitem>
2356   </varlistentry>
2357   <varlistentry>
2358     <term>i or lowerroman</term>
2359     <listitem>
2360       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>
2361     </listitem>
2362   </varlistentry>
2363 </variablelist>
2364 <para>Any non-zero value other than the above will generate
2365 the default number format (upperroman).
2366 </para>
2367 </refsection>
2368 </refentry>
2369
2370 <refentry version="5.0" xml:id="preface.autolabel">
2371 <refmeta>
2372 <refentrytitle>preface.autolabel</refentrytitle>
2373 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
2374 <refmiscinfo class="other" otherclass="value">0<alt>none</alt></refmiscinfo>
2375 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>
2376 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>
2377 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>
2378 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>
2379 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>
2380 </refmeta>
2381 <refnamediv>
2382 <refname>preface.autolabel</refname>
2383 <refpurpose>Specifices the labeling format for Preface titles</refpurpose>
2384 </refnamediv>
2385
2386 <refsynopsisdiv>
2387 <programlisting xml:id="preface.autolabel.frag">&lt;xsl:param name="preface.autolabel" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
2388 </refsynopsisdiv>
2389
2390 <refsection><info><title>Description</title></info>
2391
2392 <para>If non-zero then prefaces will be numbered using the parameter
2393 value as the number format if the value matches one of the following:
2394 </para>
2395
2396 <variablelist>
2397   <varlistentry>
2398     <term>1 or arabic</term>
2399     <listitem>
2400       <para>Arabic numeration (1, 2, 3 ...).</para>
2401     </listitem>
2402   </varlistentry>
2403   <varlistentry>
2404     <term>A or upperalpha</term>
2405     <listitem>
2406       <para>Uppercase letter numeration (A, B, C ...).</para>
2407     </listitem>
2408   </varlistentry>
2409   <varlistentry>
2410     <term>a or loweralpha</term>
2411     <listitem>
2412       <para>Lowercase letter numeration (a, b, c ...).</para>
2413     </listitem>
2414   </varlistentry>
2415   <varlistentry>
2416     <term>I or upperroman</term>
2417     <listitem>
2418       <para>Uppercase roman numeration (I, II, III ...).</para>
2419     </listitem>
2420   </varlistentry>
2421   <varlistentry>
2422     <term>i or lowerroman</term>
2423     <listitem>
2424       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>
2425     </listitem>
2426   </varlistentry>
2427 </variablelist>
2428
2429 <para>Any nonzero value other than the above will generate
2430 the default number format (arabic).
2431 </para>
2432
2433
2434 </refsection>
2435 </refentry>
2436
2437 <refentry version="5.0" xml:id="section.autolabel">
2438 <refmeta>
2439 <refentrytitle>section.autolabel</refentrytitle>
2440 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2441 </refmeta>
2442 <refnamediv>
2443 <refname>section.autolabel</refname>
2444 <refpurpose>Are sections enumerated?</refpurpose>
2445 </refnamediv>
2446
2447 <refsynopsisdiv>
2448 <programlisting xml:id="section.autolabel.frag">&lt;xsl:param name="section.autolabel" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
2449 </refsynopsisdiv>
2450
2451 <refsection><info><title>Description</title></info>
2452
2453 <para>If true (non-zero), unlabeled sections will be enumerated.
2454 </para>
2455
2456 </refsection>
2457 </refentry>
2458
2459 <refentry version="5.0" xml:id="section.autolabel.max.depth">
2460 <refmeta>
2461 <refentrytitle>section.autolabel.max.depth</refentrytitle>
2462 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
2463 </refmeta>
2464 <refnamediv>
2465 <refname>section.autolabel.max.depth</refname>
2466 <refpurpose>The deepest level of sections that are numbered.</refpurpose>
2467 </refnamediv>
2468
2469 <refsynopsisdiv>
2470 <programlisting xml:id="section.autolabel.max.depth.frag">
2471 &lt;xsl:param name="section.autolabel.max.depth"&gt;8&lt;/xsl:param&gt;
2472 </programlisting>
2473 </refsynopsisdiv>
2474
2475 <refsection><info><title>Description</title></info>
2476
2477 <para>When section numbering is turned on by the
2478 <parameter>section.autolabel</parameter> parameter, then this
2479 parameter controls the depth of <tag>section</tag> nesting that is
2480 numbered.  Sections nested to a level deeper than this value will not
2481 be numbered.
2482 </para>
2483
2484 </refsection>
2485 </refentry>
2486
2487 <refentry version="5.0" xml:id="section.label.includes.component.label">
2488 <refmeta>
2489 <refentrytitle>section.label.includes.component.label</refentrytitle>
2490 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2491 </refmeta>
2492 <refnamediv>
2493 <refname>section.label.includes.component.label</refname>
2494 <refpurpose>Do section labels include the component label?</refpurpose>
2495 </refnamediv>
2496
2497 <refsynopsisdiv>
2498 <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>
2499 </refsynopsisdiv>
2500
2501 <refsection><info><title>Description</title></info>
2502
2503 <para>If non-zero, section labels are prefixed with the label of the
2504 component that contains them.
2505 </para>
2506
2507 </refsection>
2508 </refentry>
2509
2510 <refentry version="5.0" xml:id="label.from.part">
2511 <refmeta>
2512 <refentrytitle>label.from.part</refentrytitle>
2513 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2514 </refmeta>
2515 <refnamediv>
2516 <refname>label.from.part</refname>
2517 <refpurpose>Renumber components in each part?</refpurpose>
2518 </refnamediv>
2519
2520 <refsynopsisdiv>
2521 <programlisting xml:id="label.from.part.frag">
2522 &lt;xsl:param name="label.from.part" select="0"&gt;&lt;/xsl:param&gt;
2523 </programlisting>
2524 </refsynopsisdiv>
2525
2526 <refsection><info><title>Description</title></info>
2527
2528 <para>If <parameter>label.from.part</parameter> is non-zero, then
2529   numbering of components &#8212; <tag>preface</tag>,
2530   <tag>chapter</tag>, <tag>appendix</tag>, and
2531   <tag>reference</tag> (when <tag>reference</tag> occurs at the
2532   component level) &#8212; is re-started within each
2533   <tag>part</tag>.</para>
2534 <para>If <parameter>label.from.part</parameter> is zero (the
2535   default), numbering of components is <emphasis>not</emphasis>
2536   re-started within each <tag>part</tag>; instead, components are
2537   numbered sequentially throughout each <tag>book</tag>,
2538   regardless of whether or not they occur within <tag>part</tag>
2539   instances.</para>
2540
2541 </refsection>
2542 </refentry>
2543
2544 <refentry version="5.0" xml:id="component.label.includes.part.label">
2545 <refmeta>
2546 <refentrytitle>component.label.includes.part.label</refentrytitle>
2547 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2548 </refmeta>
2549 <refnamediv>
2550 <refname>component.label.includes.part.label</refname>
2551 <refpurpose>Do component labels include the part label?</refpurpose>
2552 </refnamediv>
2553
2554 <refsynopsisdiv>
2555 <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>
2556 </refsynopsisdiv>
2557
2558 <refsection><info><title>Description</title></info>
2559
2560 <para>If non-zero, number labels for <tag>chapter</tag>,
2561 <tag>appendix</tag>, and other component elements are prefixed with
2562 the label of the part element that contains them.  So you might see
2563 Chapter II.3 instead of Chapter 3.  Also, the labels for formal
2564 elements such as <tag>table</tag> and <tag>figure</tag> will include
2565 the part label.  If there is no part element container, then no prefix
2566 is generated.
2567 </para>
2568 <para>
2569 This feature is most useful when the
2570 <parameter>label.from.part</parameter> parameter is turned on.
2571 In that case, there would be more than one <tag>chapter</tag>
2572 <quote>1</quote>, and the extra part label prefix will identify
2573 each chapter unambiguously.
2574 </para>
2575
2576 </refsection>
2577 </refentry>
2578
2579 </reference>
2580 <reference xml:id="xslt"><title>XSLT Processing</title>
2581 <refentry version="5.0" xml:id="rootid">
2582 <refmeta>
2583 <refentrytitle>rootid</refentrytitle>
2584 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
2585 </refmeta>
2586 <refnamediv>
2587 <refname>rootid</refname>
2588 <refpurpose>Specify the root element to format</refpurpose>
2589 </refnamediv>
2590
2591 <refsynopsisdiv>
2592 <programlisting xml:id="rootid.frag">
2593 &lt;xsl:param name="rootid"&gt;&lt;/xsl:param&gt;</programlisting>
2594 </refsynopsisdiv>
2595
2596 <refsection><info><title>Description</title></info>
2597
2598 <para>If <parameter>rootid</parameter> is not empty, it must be the
2599 value of an ID that occurs in the document being formatted. The entire
2600 document will be loaded and parsed, but formatting will begin at the
2601 element identified, rather than at the root. For example, this allows
2602 you to process only <tag>chapter</tag> 4 of a <tag>book</tag>.</para>
2603 <para>Because the entire document is available to the processor, automatic
2604 numbering, cross references, and other dependencies are correctly
2605 resolved.</para>
2606
2607 </refsection>
2608 </refentry>
2609
2610 </reference>
2611 <reference xml:id="meta"><title>Meta/*Info</title>
2612 <refentry version="5.0" xml:id="make.single.year.ranges">
2613 <refmeta>
2614 <refentrytitle>make.single.year.ranges</refentrytitle>
2615 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2616 </refmeta>
2617 <refnamediv>
2618 <refname>make.single.year.ranges</refname>
2619 <refpurpose>Print single-year ranges (e.g., 1998-1999)</refpurpose>
2620 </refnamediv>
2621
2622 <refsynopsisdiv>
2623 <programlisting xml:id="make.single.year.ranges.frag">
2624 &lt;xsl:param name="make.single.year.ranges" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
2625 </refsynopsisdiv>
2626
2627 <refsection><info><title>Description</title></info>
2628
2629 <para>If non-zero, year ranges that span a single year will be printed
2630 in range notation (1998-1999) instead of discrete notation
2631 (1998, 1999).</para>
2632
2633 </refsection>
2634 </refentry>
2635
2636 <refentry version="5.0" xml:id="make.year.ranges">
2637 <refmeta>
2638 <refentrytitle>make.year.ranges</refentrytitle>
2639 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2640 </refmeta>
2641 <refnamediv>
2642 <refname>make.year.ranges</refname>
2643 <refpurpose>Collate copyright years into ranges?</refpurpose>
2644 </refnamediv>
2645
2646 <refsynopsisdiv>
2647 <programlisting xml:id="make.year.ranges.frag">&lt;xsl:param name="make.year.ranges" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
2648 </refsynopsisdiv>
2649
2650 <refsection><info><title>Description</title></info>
2651
2652 <para>If non-zero, multiple copyright <tag>year</tag> elements will be
2653 collated into ranges.
2654 This works only if each year number is put into a separate
2655 year element.  The copyright element permits multiple
2656 year elements. If a year element contains a dash or
2657 a comma, then that year element will not be merged into
2658 any range.
2659 </para>
2660
2661 </refsection>
2662 </refentry>
2663
2664 <refentry version="5.0" xml:id="author.othername.in.middle">
2665 <refmeta>
2666 <refentrytitle>author.othername.in.middle</refentrytitle>
2667 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2668 </refmeta>
2669 <refnamediv>
2670 <refname>author.othername.in.middle</refname>
2671 <refpurpose>Is <tag>othername</tag> in <tag>author</tag> a
2672 middle name?</refpurpose>
2673 </refnamediv>
2674
2675 <refsynopsisdiv>
2676 <programlisting xml:id="author.othername.in.middle.frag">
2677 &lt;xsl:param name="author.othername.in.middle" select="1"&gt;&lt;/xsl:param&gt;</programlisting>
2678 </refsynopsisdiv>
2679
2680 <refsection><info><title>Description</title></info>
2681
2682 <para>If non-zero, the <tag>othername</tag> of an <tag>author</tag>
2683 appears between the <tag>firstname</tag> and
2684 <tag>surname</tag>.  Otherwise, <tag>othername</tag>
2685 is suppressed.
2686 </para>
2687
2688 </refsection>
2689 </refentry>
2690
2691 </reference>
2692 <reference xml:id="refentry"><title>Reference Pages</title>
2693 <refentry version="5.0" xml:id="funcsynopsis.decoration">
2694 <refmeta>
2695 <refentrytitle>funcsynopsis.decoration</refentrytitle>
2696 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2697 </refmeta>
2698 <refnamediv>
2699 <refname>funcsynopsis.decoration</refname>
2700 <refpurpose>Decorate elements of a <tag>funcsynopsis</tag>?</refpurpose>
2701 </refnamediv>
2702
2703 <refsynopsisdiv>
2704 <programlisting xml:id="funcsynopsis.decoration.frag">
2705 &lt;xsl:param name="funcsynopsis.decoration" select="1"&gt;&lt;/xsl:param&gt;
2706 </programlisting>
2707 </refsynopsisdiv>
2708
2709 <refsection><info><title>Description</title></info>
2710
2711 <para>If non-zero, elements of the <tag>funcsynopsis</tag> will be
2712 decorated (e.g. rendered as bold or italic text). The decoration is controlled by
2713 templates that can be redefined in a customization layer.
2714 </para>
2715
2716 </refsection>
2717 </refentry>
2718
2719 <refentry version="5.0" xml:id="funcsynopsis.style">
2720 <refmeta>
2721 <refentrytitle>funcsynopsis.style</refentrytitle>
2722 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
2723 <refmiscinfo class="other" otherclass="value">ansi</refmiscinfo>
2724 <refmiscinfo class="other" otherclass="value">kr</refmiscinfo>
2725 </refmeta>
2726 <refnamediv>
2727 <refname>funcsynopsis.style</refname>
2728 <refpurpose>What style of <tag>funcsynopsis</tag> should be generated?</refpurpose>
2729 </refnamediv>
2730
2731 <refsynopsisdiv>
2732 <programlisting xml:id="funcsynopsis.style.frag">&lt;xsl:param name="funcsynopsis.style"&gt;kr&lt;/xsl:param&gt;</programlisting>
2733 </refsynopsisdiv>
2734
2735 <refsection><info><title>Description</title></info>
2736
2737 <para>If <parameter>funcsynopsis.style</parameter> is <literal>ansi</literal>,
2738 ANSI-style function synopses are generated for a
2739 <tag>funcsynopsis</tag>, otherwise K&amp;R-style
2740 function synopses are generated.
2741 </para>
2742
2743 </refsection>
2744 </refentry>
2745
2746 <refentry version="5.0" xml:id="function.parens">
2747 <refmeta>
2748 <refentrytitle>function.parens</refentrytitle>
2749 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2750 </refmeta>
2751 <refnamediv>
2752 <refname>function.parens</refname>
2753 <refpurpose>Generate parens after a function?</refpurpose>
2754 </refnamediv>
2755
2756 <refsynopsisdiv>
2757 <programlisting xml:id="function.parens.frag">
2758 &lt;xsl:param name="function.parens" select="0"&gt;&lt;/xsl:param&gt;
2759 </programlisting>
2760 </refsynopsisdiv>
2761
2762 <refsection><info><title>Description</title></info>
2763
2764 <para>If non-zero, the formatting of a <tag>function</tag> element
2765 will include generated parentheses.
2766 </para>
2767
2768 </refsection>
2769 </refentry>
2770
2771 <refentry version="5.0" xml:id="refentry.generate.name">
2772 <refmeta>
2773 <refentrytitle>refentry.generate.name</refentrytitle>
2774 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2775 </refmeta>
2776 <refnamediv>
2777 <refname>refentry.generate.name</refname>
2778 <refpurpose>Output NAME header before <tag>refname</tag>s?</refpurpose>
2779 </refnamediv>
2780
2781 <refsynopsisdiv>
2782 <programlisting xml:id="refentry.generate.name.frag">
2783 &lt;xsl:param name="refentry.generate.name" select="1"&gt;&lt;/xsl:param&gt;
2784 </programlisting>
2785 </refsynopsisdiv>
2786
2787 <refsection><info><title>Description</title></info>
2788
2789 <para>If non-zero, a "NAME" section title is output before the list
2790 of <tag>refname</tag>s. This parameter and
2791 <parameter>refentry.generate.title</parameter> are mutually
2792 exclusive. This means that if you change this parameter to zero, you
2793 should set <parameter>refentry.generate.title</parameter> to non-zero unless
2794 you want get quite strange output.
2795 </para>
2796
2797 </refsection>
2798 </refentry>
2799
2800 <refentry version="5.0" xml:id="refentry.generate.title">
2801 <refmeta>
2802 <refentrytitle>refentry.generate.title</refentrytitle>
2803 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2804 </refmeta>
2805 <refnamediv>
2806 <refname>refentry.generate.title</refname>
2807 <refpurpose>Output title before <tag>refname</tag>s?</refpurpose>
2808 </refnamediv>
2809
2810 <refsynopsisdiv>
2811 <programlisting xml:id="refentry.generate.title.frag">
2812 &lt;xsl:param name="refentry.generate.title" select="0"&gt;&lt;/xsl:param&gt;
2813 </programlisting>
2814 </refsynopsisdiv>
2815
2816 <refsection><info><title>Description</title></info>
2817
2818 <para>If non-zero, the reference page title or first name is
2819 output before the list of <tag>refname</tag>s. This parameter and
2820 <parameter>refentry.generate.name</parameter> are mutually exclusive.
2821 This means that if you change this parameter to non-zero, you
2822 should set <parameter>refentry.generate.name</parameter> to zero unless
2823 you want get quite strange output.</para>
2824
2825
2826 </refsection>
2827 </refentry>
2828
2829 <refentry version="5.0" xml:id="refentry.pagebreak">
2830 <refmeta>
2831 <refentrytitle>refentry.pagebreak</refentrytitle>
2832 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2833 </refmeta>
2834 <refnamediv>
2835 <refname>refentry.pagebreak</refname>
2836 <refpurpose>Start each refentry on a new page</refpurpose>
2837 </refnamediv>
2838
2839 <refsynopsisdiv>
2840 <programlisting xml:id="refentry.pagebreak.frag">&lt;xsl:param name="refentry.pagebreak" select="1"&gt;&lt;/xsl:param&gt;</programlisting>
2841 </refsynopsisdiv>
2842
2843 <refsection><info><title>Description</title></info>
2844
2845 <para>If non-zero (the default), each <tag>refentry</tag>
2846 element will start on a new page.  If zero, a page
2847 break will not be generated between <tag>refentry</tag> elements.
2848 The exception is when the <tag>refentry</tag> elements are children of
2849 a <tag>part</tag> element, in which case the page breaks are always
2850 retained.  That is because a <tag>part</tag> element does not generate
2851 a page-sequence for its children, so each <tag>refentry</tag> must
2852 start its own page-sequence.
2853 </para>
2854
2855 </refsection>
2856 </refentry>
2857
2858 <refentry version="5.0" xml:id="refentry.title.properties">
2859 <refmeta>
2860 <refentrytitle>refentry.title.properties</refentrytitle>
2861 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
2862 </refmeta>
2863 <refnamediv>
2864 <refname>refentry.title.properties</refname>
2865 <refpurpose>Title properties for a refentry title</refpurpose>
2866 </refnamediv>
2867
2868 <refsynopsisdiv>
2869 <programlisting xml:id="refentry.title.properties.frag">
2870 &lt;xsl:attribute-set name="refentry.title.properties"&gt;
2871   &lt;xsl:attribute name="font-family"&gt;
2872     &lt;xsl:value-of select="$title.font.family"&gt;&lt;/xsl:value-of&gt;
2873   &lt;/xsl:attribute&gt;
2874   &lt;xsl:attribute name="font-size"&gt;18pt&lt;/xsl:attribute&gt;
2875   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
2876   &lt;xsl:attribute name="space-after"&gt;1em&lt;/xsl:attribute&gt;
2877   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
2878   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
2879   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
2880   &lt;xsl:attribute name="space-before.optimum"&gt;1.0em&lt;/xsl:attribute&gt;
2881   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
2882   &lt;xsl:attribute name="space-after.optimum"&gt;0.5em&lt;/xsl:attribute&gt;
2883   &lt;xsl:attribute name="space-after.minimum"&gt;0.4em&lt;/xsl:attribute&gt;
2884   &lt;xsl:attribute name="space-after.maximum"&gt;0.6em&lt;/xsl:attribute&gt;
2885   &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;
2886 &lt;/xsl:attribute-set&gt;
2887 </programlisting>
2888 </refsynopsisdiv>
2889
2890 <refsection><info><title>Description</title></info>
2891
2892 <para>Formatting properties applied to the title generated for the
2893 <tag>refnamediv</tag> part of output for
2894 <tag>refentry</tag> when the value of the
2895 <parameter>refentry.generate.title</parameter> parameter is
2896 non-zero. The font size is supplied by the appropriate <parameter>section.level<replaceable>X</replaceable>.title.properties</parameter>
2897 attribute-set, computed from the location of the
2898 <tag>refentry</tag> in the section hierarchy.</para>
2899
2900 <note>
2901   <para>This parameter has no effect on the the title generated for
2902   the <tag>refnamediv</tag> part of output for
2903   <tag>refentry</tag> when the value of the
2904   <parameter>refentry.generate.name</parameter> parameter is
2905   non-zero. By default, that title is formatted with the same
2906   properties as the titles for all other first-level children of
2907   <tag>refentry</tag>.</para>
2908 </note>
2909
2910 </refsection>
2911 </refentry>
2912
2913 <refentry version="5.0" xml:id="refentry.xref.manvolnum">
2914 <refmeta>
2915 <refentrytitle>refentry.xref.manvolnum</refentrytitle>
2916 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2917 </refmeta>
2918 <refnamediv>
2919 <refname>refentry.xref.manvolnum</refname>
2920 <refpurpose>Output <tag>manvolnum</tag> as part of 
2921 <tag>refentry</tag> cross-reference?</refpurpose>
2922 </refnamediv>
2923
2924 <refsynopsisdiv>
2925 <programlisting xml:id="refentry.xref.manvolnum.frag">
2926 &lt;xsl:param name="refentry.xref.manvolnum" select="1"&gt;&lt;/xsl:param&gt;
2927 </programlisting>
2928 </refsynopsisdiv>
2929
2930 <refsection><info><title>Description</title></info>
2931
2932 <para>if non-zero, the <tag>manvolnum</tag> is used when cross-referencing
2933 <tag>refentry</tag>s, either with <tag>xref</tag>
2934 or <tag>citerefentry</tag>.
2935 </para>
2936
2937 </refsection>
2938 </refentry>
2939
2940 <refentry version="5.0" xml:id="refclass.suppress">
2941 <refmeta>
2942 <refentrytitle>refclass.suppress</refentrytitle>
2943 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2944 </refmeta>
2945 <refnamediv>
2946 <refname>refclass.suppress</refname>
2947 <refpurpose>Suppress display of refclass contents?</refpurpose>
2948 </refnamediv>
2949
2950 <refsynopsisdiv>
2951 <programlisting xml:id="refclass.suppress.frag">
2952 &lt;xsl:param name="refclass.suppress" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
2953 </refsynopsisdiv>
2954
2955 <refsection><info><title>Description</title></info>
2956
2957 <para>If the value of <parameter>refclass.suppress</parameter> is
2958 non-zero, then display of <tag>refclass</tag> contents is
2959 suppressed in output.</para>
2960
2961 </refsection>
2962 </refentry>
2963
2964 </reference>
2965 <reference xml:id="tables"><title>Tables</title>
2966 <refentry version="5.0" xml:id="default.table.width">
2967 <refmeta>
2968 <refentrytitle>default.table.width</refentrytitle>
2969 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
2970 </refmeta>
2971 <refnamediv>
2972 <refname>default.table.width</refname>
2973 <refpurpose>The default width of tables</refpurpose>
2974 </refnamediv>
2975 <refsynopsisdiv>
2976 <programlisting xml:id="default.table.width.frag">
2977 &lt;xsl:param name="default.table.width"&gt;&lt;/xsl:param&gt;
2978 </programlisting>
2979 </refsynopsisdiv>
2980 <refsection><info><title>Description</title></info>
2981 <para>If non-zero, this value will be used for the
2982 <literal>width</literal> attribute on <tag>table</tag>s that do not specify an
2983 alternate width (with the <tag class="xmlpi">dbhtml table-width</tag> or 
2984 <tag class="xmlpi">dbfo table-width</tag> processing instruction).</para>
2985 </refsection>
2986 </refentry>
2987
2988 <refentry version="5.0" xml:id="nominal.table.width">
2989 <refmeta>
2990 <refentrytitle>nominal.table.width</refentrytitle>
2991 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
2992 </refmeta>
2993 <refnamediv>
2994 <refname>nominal.table.width</refname>
2995 <refpurpose>The (absolute) nominal width of tables</refpurpose>
2996 </refnamediv>
2997
2998 <refsynopsisdiv>
2999 <programlisting xml:id="nominal.table.width.frag">
3000 &lt;xsl:param name="nominal.table.width"&gt;6in&lt;/xsl:param&gt;
3001 </programlisting>
3002 </refsynopsisdiv>
3003
3004 <refsection><info><title>Description</title></info>
3005
3006 <para>In order to convert CALS column widths into HTML column widths, it
3007 is sometimes necessary to have an absolute table width to use for conversion
3008 of mixed absolute and relative widths. This value must be an absolute
3009 length (not a percentage).</para>
3010
3011 </refsection>
3012 </refentry>
3013
3014 <refentry version="5.0" xml:id="default.table.frame">
3015 <refmeta>
3016 <refentrytitle>default.table.frame</refentrytitle>
3017 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
3018 </refmeta>
3019 <refnamediv>
3020 <refname>default.table.frame</refname>
3021 <refpurpose>The default framing of tables</refpurpose>
3022 </refnamediv>
3023
3024 <refsynopsisdiv>
3025 <programlisting xml:id="default.table.frame.frag">
3026 &lt;xsl:param name="default.table.frame"&gt;all&lt;/xsl:param&gt;
3027 </programlisting>
3028 </refsynopsisdiv>
3029
3030 <refsection><info><title>Description</title></info>
3031
3032 <para>This value will be used when there is no frame attribute on the
3033 table. </para>
3034
3035 </refsection>
3036 </refentry>
3037
3038 <refentry version="5.0" xml:id="default.table.rules">
3039 <refmeta>
3040 <refentrytitle>default.table.rules</refentrytitle>
3041 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
3042 </refmeta>
3043 <refnamediv>
3044 <refname>default.table.rules</refname>
3045 <refpurpose>The default column and row rules for tables using HTML markup</refpurpose>
3046 </refnamediv>
3047
3048 <refsynopsisdiv>
3049 <programlisting xml:id="default.table.rules.frag">
3050 &lt;xsl:param name="default.table.rules"&gt;none&lt;/xsl:param&gt;
3051 </programlisting>
3052 </refsynopsisdiv>
3053
3054 <refsection><info><title>Description</title></info>
3055
3056 <para>Tables using HTML markup elements can use an attribute
3057 named <tag class="attribute">rules</tag> on the <tag>table</tag> or
3058 <tag>informaltable</tag> element
3059 to specify whether column and row border rules should be 
3060 displayed. This parameter lets you specify a global default
3061 style for all HTML tables that don't otherwise have
3062 that attribute.</para>
3063 <para>These are the supported values:</para>
3064
3065 <variablelist>
3066 <varlistentry><term>all</term>
3067 <listitem>
3068 <para>Rules will appear between all rows and columns.</para>
3069 </listitem>
3070 </varlistentry>
3071
3072 <varlistentry><term>rows</term>
3073 <listitem>
3074 <para>Rules will appear between rows only.</para>
3075 </listitem>
3076 </varlistentry>
3077
3078 <varlistentry><term>cols</term>
3079 <listitem>
3080 <para>Rules will appear between columns only.</para>
3081 </listitem>
3082 </varlistentry>
3083
3084 <varlistentry><term>groups</term>
3085 <listitem>
3086 <para>Rules will appear between row groups (thead, tfoot, tbody).
3087 No support for rules between column groups yet.
3088 </para>
3089 </listitem>
3090 </varlistentry>
3091
3092 <varlistentry><term>none</term>
3093 <listitem>
3094 <para>No rules.  This is the default value.
3095 </para>
3096 </listitem>
3097 </varlistentry>
3098
3099 </variablelist>
3100
3101 <para>The border after the last row and the border after
3102 the last column are not affected by
3103 this setting. Those borders are controlled by
3104 the <tag class="attribute">frame</tag> attribute on the table element.
3105 </para>
3106
3107 </refsection>
3108 </refentry>
3109
3110 <refentry version="5.0" xml:id="table.cell.padding">
3111 <refmeta>
3112 <refentrytitle>table.cell.padding</refentrytitle>
3113 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
3114 </refmeta>
3115 <refnamediv>
3116 <refname>table.cell.padding</refname>
3117 <refpurpose>Specifies the padding of table cells</refpurpose>
3118 </refnamediv>
3119
3120 <refsynopsisdiv>
3121 <programlisting xml:id="table.cell.padding.frag">
3122 &lt;xsl:attribute-set name="table.cell.padding"&gt;
3123   &lt;xsl:attribute name="padding-start"&gt;2pt&lt;/xsl:attribute&gt;
3124   &lt;xsl:attribute name="padding-end"&gt;2pt&lt;/xsl:attribute&gt;
3125   &lt;xsl:attribute name="padding-top"&gt;2pt&lt;/xsl:attribute&gt;
3126   &lt;xsl:attribute name="padding-bottom"&gt;2pt&lt;/xsl:attribute&gt;
3127 &lt;/xsl:attribute-set&gt;
3128 </programlisting>
3129 </refsynopsisdiv>
3130
3131 <refsection><info><title>Description</title></info>
3132
3133 <para>Specifies the padding of table cells.</para>
3134
3135 </refsection>
3136 </refentry>
3137
3138 <refentry version="5.0" xml:id="table.frame.border.thickness">
3139 <refmeta>
3140 <refentrytitle>table.frame.border.thickness</refentrytitle>
3141 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
3142 </refmeta>
3143 <refnamediv>
3144 <refname>table.frame.border.thickness</refname>
3145 <refpurpose>Specifies the thickness of the frame border</refpurpose>
3146 </refnamediv>
3147
3148 <refsynopsisdiv>
3149 <programlisting xml:id="table.frame.border.thickness.frag">
3150 &lt;xsl:param name="table.frame.border.thickness"&gt;0.5pt&lt;/xsl:param&gt;
3151 </programlisting>
3152 </refsynopsisdiv>
3153
3154 <refsection><info><title>Description</title></info>
3155
3156 <para>Specifies the thickness of the border on the table's frame.</para>
3157
3158 </refsection>
3159 </refentry>
3160
3161 <refentry version="5.0" xml:id="table.frame.border.style">
3162 <refmeta>
3163 <refentrytitle>table.frame.border.style</refentrytitle>
3164 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
3165 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>
3166 <refmiscinfo class="other" otherclass="value">solid</refmiscinfo>
3167 <refmiscinfo class="other" otherclass="value">dotted</refmiscinfo>
3168 <refmiscinfo class="other" otherclass="value">dashed</refmiscinfo>
3169 <refmiscinfo class="other" otherclass="value">double</refmiscinfo>
3170 <refmiscinfo class="other" otherclass="value">groove</refmiscinfo>                       
3171 <refmiscinfo class="other" otherclass="value">ridge</refmiscinfo>
3172 <refmiscinfo class="other" otherclass="value">inset</refmiscinfo>
3173 <refmiscinfo class="other" otherclass="value">outset</refmiscinfo>          
3174 <refmiscinfo class="other" otherclass="value">solid</refmiscinfo>
3175 </refmeta>
3176 <refnamediv>
3177 <refname>table.frame.border.style</refname>
3178 <refpurpose>Specifies the border style of table frames</refpurpose>
3179 </refnamediv>
3180
3181 <refsynopsisdiv>
3182 <programlisting xml:id="table.frame.border.style.frag">
3183 &lt;xsl:param name="table.frame.border.style"&gt;solid&lt;/xsl:param&gt;
3184 </programlisting>
3185 </refsynopsisdiv>
3186
3187 <refsection><info><title>Description</title></info>
3188
3189 <para>Specifies the border style of table frames.</para>
3190
3191 </refsection>
3192 </refentry>
3193
3194 <refentry version="5.0" xml:id="table.frame.border.color">
3195 <refmeta>
3196 <refentrytitle>table.frame.border.color</refentrytitle>
3197 <refmiscinfo class="other" otherclass="datatype">color</refmiscinfo>
3198 </refmeta>
3199 <refnamediv>
3200 <refname>table.frame.border.color</refname>
3201 <refpurpose>Specifies the border color of table frames</refpurpose>
3202 </refnamediv>
3203
3204 <refsynopsisdiv>
3205 <programlisting xml:id="table.frame.border.color.frag">
3206
3207 &lt;xsl:param name="table.frame.border.color"&gt;black&lt;/xsl:param&gt;
3208 </programlisting>
3209 </refsynopsisdiv>
3210
3211 <refsection><info><title>Description</title></info>
3212
3213 <para>Specifies the border color of table frames.</para>
3214
3215 </refsection>
3216 </refentry>
3217
3218 <refentry version="5.0" xml:id="table.cell.border.thickness">
3219 <refmeta>
3220 <refentrytitle>table.cell.border.thickness</refentrytitle>
3221 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
3222 </refmeta>
3223 <refnamediv>
3224 <refname>table.cell.border.thickness</refname>
3225 <refpurpose>Specifies the thickness of table cell borders</refpurpose>
3226 </refnamediv>
3227
3228 <refsynopsisdiv>
3229 <programlisting xml:id="table.cell.border.thickness.frag">
3230 &lt;xsl:param name="table.cell.border.thickness"&gt;0.5pt&lt;/xsl:param&gt;
3231 </programlisting>
3232 </refsynopsisdiv>
3233
3234 <refsection><info><title>Description</title></info>
3235
3236 <para>If non-zero, specifies the thickness of borders on table
3237 cells. The units are points. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/CSS21/box.html#border-width-properties">
3238 CSS</link></para>
3239
3240 <note>
3241   <para>To control properties of cell borders in HTML output, you must also turn on the 
3242   <parameter>table.borders.with.css</parameter> parameter.</para>
3243 </note>
3244
3245 </refsection>
3246 </refentry>
3247
3248 <refentry version="5.0" xml:id="table.cell.border.style">
3249 <refmeta>
3250 <refentrytitle>table.cell.border.style</refentrytitle>
3251 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
3252 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>
3253 <refmiscinfo class="other" otherclass="value">solid</refmiscinfo>
3254 <refmiscinfo class="other" otherclass="value">dotted</refmiscinfo>
3255 <refmiscinfo class="other" otherclass="value">dashed</refmiscinfo>
3256 <refmiscinfo class="other" otherclass="value">double</refmiscinfo>
3257 <refmiscinfo class="other" otherclass="value">groove</refmiscinfo>                       
3258 <refmiscinfo class="other" otherclass="value">ridge</refmiscinfo>
3259 <refmiscinfo class="other" otherclass="value">inset</refmiscinfo>
3260 <refmiscinfo class="other" otherclass="value">outset</refmiscinfo>          
3261 <refmiscinfo class="other" otherclass="value">solid</refmiscinfo>
3262 </refmeta>
3263 <refnamediv>
3264 <refname>table.cell.border.style</refname>
3265 <refpurpose>Specifies the border style of table cells</refpurpose>
3266 </refnamediv>
3267
3268 <refsynopsisdiv>
3269 <programlisting xml:id="table.cell.border.style.frag">
3270 &lt;xsl:param name="table.cell.border.style"&gt;solid&lt;/xsl:param&gt;
3271 </programlisting>
3272 </refsynopsisdiv>
3273
3274 <refsection><info><title>Description</title></info>
3275
3276 <para>Specifies the border style of table cells.</para>
3277
3278 <note>
3279   <para>To control properties of cell borders in HTML output, you must also turn on the 
3280   <parameter>table.borders.with.css</parameter> parameter.</para>
3281 </note>
3282
3283 </refsection>
3284 </refentry>
3285
3286 <refentry version="5.0" xml:id="table.cell.border.color">
3287 <refmeta>
3288 <refentrytitle>table.cell.border.color</refentrytitle>
3289 <refmiscinfo class="other" otherclass="datatype">color</refmiscinfo>
3290 </refmeta>
3291 <refnamediv>
3292 <refname>table.cell.border.color</refname>
3293 <refpurpose>Specifies the border color of table cells</refpurpose>
3294 </refnamediv>
3295
3296 <refsynopsisdiv>
3297 <programlisting xml:id="table.cell.border.color.frag">
3298
3299 &lt;xsl:param name="table.cell.border.color"&gt;black&lt;/xsl:param&gt;
3300 </programlisting>
3301 </refsynopsisdiv>
3302
3303 <refsection><info><title>Description</title></info>
3304
3305 <para>Set the color of table cell borders. If non-zero, the value is used
3306 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
3307 <literal>color</literal> is either a keyword or a numerical RGB specification.
3308 Keywords are aqua, black, blue, fuchsia, gray, green, lime, maroon,
3309 navy, olive, orange, purple, red, silver, teal, white, and
3310 yellow.</para>
3311
3312 <note>
3313   <para>To control properties of cell borders in HTML output, you must also turn on the 
3314   <parameter>table.borders.with.css</parameter> parameter.</para>
3315 </note>
3316
3317 </refsection>
3318 </refentry>
3319
3320 <refentry version="5.0" xml:id="table.table.properties">
3321 <refmeta>
3322 <refentrytitle>table.table.properties</refentrytitle>
3323 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
3324 </refmeta>
3325 <refnamediv>
3326 <refname>table.table.properties</refname>
3327 <refpurpose>Properties associated with a table</refpurpose>
3328 </refnamediv>
3329
3330 <refsynopsisdiv>
3331 <programlisting xml:id="table.table.properties.frag">
3332 &lt;xsl:attribute-set name="table.table.properties"&gt;
3333   &lt;xsl:attribute name="border-before-width.conditionality"&gt;retain&lt;/xsl:attribute&gt;
3334   &lt;xsl:attribute name="border-collapse"&gt;collapse&lt;/xsl:attribute&gt;
3335 &lt;/xsl:attribute-set&gt;
3336 </programlisting>
3337 </refsynopsisdiv>
3338
3339 <refsection><info><title>Description</title></info>
3340
3341 <para>The styling for tables. This parameter should really
3342 have been called <literal>table.properties</literal>, but that parameter
3343 name was inadvertently established for the block-level properties
3344 of the table as a whole.
3345 </para>
3346
3347 <para>See also <parameter>table.properties</parameter>.</para>
3348
3349 </refsection>
3350 </refentry>
3351
3352 </reference>
3353 <reference xml:id="links"><title>Linking</title>
3354 <refentry version="5.0" xml:id="current.docid"> 
3355 <refmeta> 
3356 <refentrytitle>current.docid</refentrytitle> 
3357 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo> 
3358 </refmeta> 
3359 <refnamediv> 
3360 <refname>current.docid</refname> 
3361 <refpurpose>targetdoc identifier for the document being
3362 processed</refpurpose> 
3363 </refnamediv> 
3364 <refsynopsisdiv> <programlisting xml:id="current.docid.frag">
3365 &lt;xsl:param name="current.docid"&gt;&lt;/xsl:param&gt;
3366 </programlisting> 
3367 </refsynopsisdiv> 
3368 <refsection><info><title>Description</title></info> 
3369  
3370 <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
3371 the targetdoc identifier of the current document, since that
3372 identifier does not appear in the document itself. </para>
3373 <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> 
3374 </refsection> 
3375 </refentry>
3376
3377 <refentry version="5.0" xml:id="collect.xref.targets"> 
3378 <refmeta> 
3379 <refentrytitle>collect.xref.targets</refentrytitle> 
3380 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
3381 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>
3382 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
3383 <refmiscinfo class="other" otherclass="value">only</refmiscinfo>
3384 </refmeta> 
3385 <refnamediv> 
3386 <refname>collect.xref.targets</refname> 
3387 <refpurpose>Controls whether cross reference data is
3388 collected</refpurpose> 
3389 </refnamediv> 
3390 <refsynopsisdiv> <programlisting xml:id="collect.xref.targets.frag">
3391 &lt;xsl:param name="collect.xref.targets"&gt;no&lt;/xsl:param&gt;
3392 </programlisting> 
3393 </refsynopsisdiv> 
3394 <refsection><info><title>Description</title></info> 
3395  
3396 <para>
3397 In order to resolve olinks efficiently, the stylesheets can
3398 generate an external data file containing information about
3399 all potential cross reference endpoints in a document.
3400 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.
3401 See also <parameter>targets.filename</parameter>.
3402 </para> 
3403 </refsection> 
3404 </refentry>
3405
3406 <refentry version="5.0" xml:id="insert.olink.page.number">
3407 <refmeta>
3408 <refentrytitle>insert.olink.page.number</refentrytitle>
3409 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
3410 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>
3411 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
3412 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>
3413 </refmeta>
3414 <refnamediv>
3415 <refname>insert.olink.page.number</refname>
3416 <refpurpose>Turns page numbers in olinks on and off</refpurpose>
3417 </refnamediv>
3418
3419 <refsynopsisdiv>
3420 <programlisting xml:id="insert.olink.page.number.frag">
3421 &lt;xsl:param name="insert.olink.page.number"&gt;no&lt;/xsl:param&gt;
3422 </programlisting>
3423 </refsynopsisdiv>
3424
3425 <refsection><info><title>Description</title></info>
3426
3427 <para>The value of this parameter determines if
3428 cross references made between documents with
3429 <tag>olink</tag> will 
3430 include page number citations.
3431 In most cases this is only applicable to references in printed output.
3432 </para>
3433 <para>The parameter has three possible values.
3434 </para>
3435 <variablelist>
3436 <varlistentry>
3437 <term>no</term>
3438 <listitem><para>No page number references will be generated for olinks.
3439 </para></listitem>
3440 </varlistentry>
3441 <varlistentry>
3442 <term>yes</term>
3443 <listitem><para>Page number references will be generated
3444 for all <tag>olink</tag> references.
3445 The style of page reference may be changed
3446 if an <tag class="attribute">xrefstyle</tag>
3447 attribute is used.
3448 </para></listitem>
3449 </varlistentry>
3450 <varlistentry>
3451 <term>maybe</term>
3452 <listitem><para>Page number references will not be generated
3453 for an <tag>olink</tag> element unless 
3454 it has an
3455 <tag class="attribute">xrefstyle</tag>
3456 attribute whose value specifies a page reference.
3457 </para></listitem>
3458 </varlistentry>
3459 </variablelist>
3460 <para>Olinks that point to targets within the same document
3461 are treated as <tag>xref</tag>s, and controlled by
3462 the <parameter>insert.xref.page.number</parameter> parameter.
3463 </para>
3464
3465 <para>Page number references for olinks to
3466 external documents can only be inserted if the 
3467 information exists in the olink database. 
3468 This means each olink target element 
3469 (<tag>div</tag> or <tag>obj</tag>)
3470 must have a <tag class="attribute">page</tag> attribute
3471 whose value is its page number in the target document.
3472 The XSL stylesheets are not able to extract that information
3473 during processing because pages have not yet been created in
3474 XSLT transformation.  Only the XSL-FO processor knows what
3475 page each element is placed on.
3476 Therefore some postprocessing must take place to populate
3477 page numbers in the olink database.
3478 </para>
3479
3480
3481
3482 </refsection>
3483 </refentry>
3484
3485 <refentry version="5.0" xml:id="insert.olink.pdf.frag">
3486 <refmeta>
3487 <refentrytitle>insert.olink.pdf.frag</refentrytitle>
3488 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
3489 </refmeta>
3490 <refnamediv>
3491 <refname>insert.olink.pdf.frag</refname>
3492 <refpurpose>Add fragment identifiers for links into PDF files</refpurpose>
3493 </refnamediv>
3494
3495 <refsynopsisdiv>
3496 <programlisting xml:id="insert.olink.pdf.frag.frag">
3497 &lt;xsl:param name="insert.olink.pdf.frag" select="0"&gt;&lt;/xsl:param&gt;
3498 </programlisting>
3499 </refsynopsisdiv>
3500
3501 <refsection><info><title>Description</title></info>
3502
3503 <para>The value of this parameter determines whether
3504 the cross reference URIs to PDF documents made with
3505 <tag>olink</tag> will 
3506 include fragment identifiers.
3507 </para>
3508
3509 <para>When forming a URI to link to a PDF document,
3510 a fragment identifier (typically a '#' followed by an
3511 id value) appended to the PDF filename can be used by
3512 the PDF viewer to open
3513 the PDF file to a location within the document instead of
3514 the first page.
3515 However, not all PDF files have id
3516 values embedded in them, and not all PDF viewers can
3517 handle fragment identifiers. 
3518 </para>
3519
3520 <para>If <parameter>insert.olink.pdf.frag</parameter> is set
3521 to a non-zero value, then any olink targeting a
3522 PDF file will have the fragment identifier appended to the URI.
3523 The URI is formed by concatenating the value of the
3524 <parameter>olink.base.uri</parameter> parameter, the
3525 value of the <tag class="attribute">baseuri</tag>
3526 attribute from the <tag class="element">document</tag>
3527 element in the olink database with the matching
3528 <tag class="attribute">targetdoc</tag> value,
3529 and the value of the <tag class="attribute">href</tag>
3530 attribute for the targeted element in the olink database.
3531 The <tag class="attribute">href</tag> attribute
3532 contains the fragment identifier.
3533 </para>
3534
3535 <para>If <parameter>insert.olink.pdf.frag</parameter> is set
3536 to zero (the default value), then 
3537 the <tag class="attribute">href</tag> attribute
3538 from the olink database
3539 is not appended to PDF olinks, so the fragment identifier is left off.
3540 A PDF olink is any olink for which the
3541 <tag class="attribute">baseuri</tag> attribute
3542 from the matching <tag class="element">document</tag>
3543 element in the olink database ends with '.pdf'.
3544 Any other olinks will still have the fragment identifier added.
3545 </para>
3546 </refsection>
3547 </refentry>
3548
3549 <refentry version="5.0" xml:id="olink.base.uri"> 
3550 <refmeta> 
3551 <refentrytitle>olink.base.uri</refentrytitle> 
3552 <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo> 
3553 </refmeta> 
3554 <refnamediv> 
3555 <refname>olink.base.uri</refname> 
3556 <refpurpose>Base URI used in olink hrefs</refpurpose> 
3557 </refnamediv> 
3558 <refsynopsisdiv> <programlisting xml:id="olink.base.uri.frag">
3559 &lt;xsl:param name="olink.base.uri"&gt;&lt;/xsl:param&gt;
3560 </programlisting> 
3561 </refsynopsisdiv> 
3562 <refsection><info><title>Description</title></info> 
3563  
3564 <para>When cross reference data is collected for resolving olinks, it
3565 may be necessary to prepend a base URI to each target's href. This
3566 parameter lets you set that base URI when cross reference data is
3567 collected. This feature is needed when you want to link to a document
3568 that is processed without chunking. The output filename for such a
3569 document is not known to the XSL stylesheet; the only target
3570 information consists of fragment identifiers such as
3571 <literal>#idref</literal>. To enable the resolution of olinks between
3572 documents, you should pass the name of the HTML output file as the
3573 value of this parameter. Then the hrefs recorded in the cross
3574 reference data collection look like
3575 <literal>outfile.html#idref</literal>, which can be reached as links
3576 from other documents.</para>
3577 </refsection> 
3578 </refentry>
3579
3580 <refentry version="5.0" xml:id="olink.debug">
3581 <refmeta>
3582 <refentrytitle>olink.debug</refentrytitle>
3583 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
3584 </refmeta>
3585 <refnamediv>
3586 <refname>olink.debug</refname>
3587 <refpurpose>Turn on debugging messages for olinks</refpurpose>
3588 </refnamediv>
3589
3590 <refsynopsisdiv>
3591 <programlisting xml:id="olink.debug.frag">
3592 &lt;xsl:param name="olink.debug" select="0"&gt;&lt;/xsl:param&gt;
3593 </programlisting>
3594 </refsynopsisdiv>
3595
3596 <refsection><info><title>Description</title></info>
3597
3598 <para>If non-zero, then each olink will generate several
3599 messages about how it is being resolved during processing.
3600 This is useful when an olink does not resolve properly
3601 and the standard error messages are not sufficient to
3602 find the problem. 
3603 </para>
3604
3605 <para>You may need to read through the olink XSL templates
3606 to understand the context for some of the debug messages.
3607 </para>
3608
3609 </refsection>
3610 </refentry>
3611
3612 <refentry version="5.0" xml:id="olink.doctitle"> 
3613 <refmeta> 
3614 <refentrytitle>olink.doctitle</refentrytitle> 
3615 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
3616 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>
3617 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
3618 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>
3619 </refmeta> 
3620 <refnamediv> 
3621 <refname>olink.doctitle</refname> 
3622 <refpurpose>show the document title for external olinks?</refpurpose>
3623
3624 </refnamediv> 
3625 <refsynopsisdiv> <programlisting xml:id="olink.doctitle.frag">
3626 &lt;xsl:param name="olink.doctitle"&gt;no&lt;/xsl:param&gt; 
3627 </programlisting> 
3628 </refsynopsisdiv> 
3629 <refsection><info><title>Description</title></info> 
3630  
3631 <para>When olinks between documents are resolved, the generated text
3632 may not make it clear that the reference is to another document.
3633 It is possible for the stylesheets to append the other document's
3634 title to external olinks. For this to happen, two parameters must
3635 be set.</para>
3636 <itemizedlist>
3637 <listitem>
3638 <para>This <parameter>olink.doctitle</parameter> parameter
3639 should be set to either <literal>yes</literal> or <literal>maybe</literal>
3640 to enable this feature.
3641 </para>
3642 </listitem>
3643 <listitem>
3644 <para>And you should also set the <parameter>current.docid</parameter>
3645 parameter to the document id for the  document currently
3646 being processed for output.
3647 </para>
3648 </listitem>
3649 </itemizedlist>
3650
3651 <para>
3652 Then if an olink's  <literal>targetdoc</literal> id differs from
3653 the <literal>current.docid</literal> value, the stylesheet knows
3654 that it is a reference to another document and can
3655 append the target document's
3656 title to the generated olink text. </para> 
3657
3658 <para>The text for the target document's title is copied from the
3659 olink database from the <tag>ttl</tag> element
3660 of the top-level <tag>div</tag> for that document.
3661 If that <tag>ttl</tag> element is missing or empty,
3662 no title is output.
3663 </para>
3664
3665 <para>The supported values for <parameter>olink.doctitle</parameter> are:
3666 </para>
3667 <variablelist>
3668 <varlistentry>
3669 <term><literal>yes</literal></term>
3670 <listitem>
3671 <para>
3672 Always insert the title to the target document if it is not
3673 the current document.
3674 </para>
3675 </listitem>
3676 </varlistentry>
3677 <varlistentry>
3678 <term><literal>no</literal></term>
3679 <listitem>
3680 <para>
3681 Never insert the title to the target document, even if requested
3682 in an <tag class="attribute">xrefstyle</tag> attribute.
3683 </para>
3684 </listitem>
3685 </varlistentry>
3686 <varlistentry>
3687 <term><literal>maybe</literal></term>
3688 <listitem>
3689 <para>
3690 Only insert the title to the target document, if requested
3691 in an <tag class="attribute">xrefstyle</tag> attribute.
3692 </para>
3693 </listitem>
3694 </varlistentry>
3695 </variablelist>
3696 <para>An <tag class="attribute">xrefstyle</tag> attribute
3697 may override the global setting for individual olinks.
3698 The following values are supported in an
3699 <tag class="attribute">xrefstyle</tag>
3700 attribute using the <literal>select:</literal> syntax:
3701 </para>
3702
3703 <variablelist>
3704 <varlistentry>
3705 <term><literal>docname</literal></term>
3706 <listitem>
3707 <para>
3708 Insert the target document name for this olink using the
3709 <literal>docname</literal> gentext template, but only
3710 if the value of <parameter>olink.doctitle</parameter>
3711 is not <literal>no</literal>.
3712 </para>
3713 </listitem>
3714 </varlistentry>
3715 <varlistentry>
3716 <term><literal>docnamelong</literal></term>
3717 <listitem>
3718 <para>
3719 Insert the target document name for this olink using the
3720 <literal>docnamelong</literal> gentext template, but only
3721 if the value of <parameter>olink.doctitle</parameter>
3722 is not <literal>no</literal>.
3723 </para>
3724 </listitem>
3725 </varlistentry>
3726 <varlistentry>
3727 <term><literal>nodocname</literal></term>
3728 <listitem>
3729 <para>
3730 Omit the target document name even if
3731 the value of <parameter>olink.doctitle</parameter>
3732 is <literal>yes</literal>.
3733 </para>
3734 </listitem>
3735 </varlistentry>
3736 </variablelist>
3737 <para>Another way of inserting the target document name 
3738 for a single olink is to employ an
3739 <tag class="attribute">xrefstyle</tag>
3740 attribute using the <literal>template:</literal> syntax.
3741 The <literal>%o</literal> placeholder (the letter o, not zero)
3742 in such a template
3743 will be filled in with the target document's title when it is processed.
3744 This will occur regardless of 
3745 the value of <parameter>olink.doctitle</parameter>.
3746 </para>
3747 <para>Note that prior to version 1.66 of the XSL stylesheets,
3748 the allowed values for this parameter were 0 and 1.  Those
3749 values are still supported and mapped to 'no' and 'yes', respectively.
3750 </para>
3751 </refsection> 
3752 </refentry>
3753
3754 <refentry version="5.0" xml:id="olink.lang.fallback.sequence"> 
3755 <refmeta> 
3756 <refentrytitle>olink.lang.fallback.sequence</refentrytitle> 
3757 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo> 
3758 </refmeta> 
3759 <refnamediv> 
3760 <refname>olink.lang.fallback.sequence</refname> 
3761 <refpurpose>look up translated documents if olink not found?</refpurpose>
3762
3763 </refnamediv> 
3764 <refsynopsisdiv> <programlisting xml:id="olink.lang.fallback.sequence.frag">
3765 &lt;xsl:param name="olink.lang.fallback.sequence"&gt;&lt;/xsl:param&gt;
3766 </programlisting> 
3767 </refsynopsisdiv> 
3768 <refsection><info><title>Description</title></info> 
3769  
3770
3771 <para>This parameter defines a list of lang values
3772 to search among to resolve olinks.
3773 </para>
3774
3775 <para>Normally an olink tries to resolve to a document in the same
3776 language as the olink itself.  The language of an olink
3777 is determined by its nearest ancestor element with a
3778 <tag class="attribute">lang</tag> attribute, otherwise the
3779 value of the <parameter>l10n.gentext.default.lang</parameter>
3780 parameter.
3781 </para>
3782
3783 <para>An olink database can contain target data for the same
3784 document in multiple languages.  Each set of data has the
3785 same value for the <tag>targetdoc</tag> attribute in
3786 the <tag>document</tag> element in the database, but with a 
3787 different <tag>lang</tag> attribute value.
3788 </para>
3789
3790 <para>When an olink is being resolved, the target is first
3791 sought in the document with the same language as the olink.
3792 If no match is found there, then this parameter is consulted
3793 for additional languages to try.</para>
3794
3795 <para>The <parameter>olink.lang.fallback.sequence</parameter>
3796 must be a whitespace separated list of lang values to
3797 try.  The first one with a match in the olink database is used.
3798 The default value is empty.</para>
3799
3800 <para>For example, a document might be written in German
3801 and contain an olink with
3802 <literal>targetdoc="adminguide"</literal>.
3803 When the document is processed, the processor
3804 first looks for a target dataset in the
3805 olink database starting with:</para>
3806
3807 <literallayout><literal>&lt;document targetdoc="adminguide" lang="de"&gt;</literal>.
3808 </literallayout>
3809
3810 <para>If there is no such element, then the
3811 <parameter>olink.lang.fallback.sequence</parameter> 
3812 parameter is consulted.
3813 If its value is, for example, <quote>fr en</quote>, then the processor next
3814 looks for <literal>targetdoc="adminguide" lang="fr"</literal>, and
3815 then for <literal>targetdoc="adminguide" lang="en"</literal>.
3816 If there is still no match, it looks for
3817 <literal>targetdoc="adminguide"</literal> with no
3818 lang attribute.
3819 </para>
3820
3821 <para>This parameter is useful when a set of documents is only
3822 partially translated, or is in the process of being translated.  
3823 If a target of an olink has not yet been translated, then this
3824 parameter permits the processor to look for the document in
3825 other languages.  This assumes the reader would rather have
3826 a link to a document in a different language than to have
3827 a broken link.
3828 </para>
3829
3830 </refsection> 
3831 </refentry>
3832
3833 <refentry version="5.0" xml:id="olink.properties">
3834 <refmeta>
3835 <refentrytitle>olink.properties</refentrytitle>
3836 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
3837 </refmeta>
3838 <refnamediv>
3839 <refname>olink.properties</refname>
3840 <refpurpose>Properties associated with the cross-reference 
3841 text of an olink.</refpurpose>
3842 </refnamediv>
3843
3844 <refsynopsisdiv>
3845 <programlisting xml:id="olink.properties.frag">
3846 &lt;xsl:attribute-set name="olink.properties"&gt;
3847   &lt;xsl:attribute name="show-destination"&gt;replace&lt;/xsl:attribute&gt;
3848 &lt;/xsl:attribute-set&gt;
3849 </programlisting>
3850 </refsynopsisdiv>
3851
3852 <refsection><info><title>Description</title></info>
3853
3854 <para>This <literal>attribute set</literal> is applied to the
3855 <literal>fo:basic-link</literal> element of an olink. It is not applied to the
3856 optional page number or optional title of the external
3857 document.</para>
3858
3859 </refsection>
3860 </refentry>
3861
3862 <refentry version="5.0" xml:id="prefer.internal.olink">
3863 <refmeta>
3864 <refentrytitle>prefer.internal.olink</refentrytitle>
3865 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
3866 </refmeta>
3867 <refnamediv>
3868 <refname>prefer.internal.olink</refname>
3869 <refpurpose>Prefer a local olink reference to an external reference</refpurpose>
3870 </refnamediv>
3871
3872 <refsynopsisdiv>
3873 <programlisting xml:id="prefer.internal.olink.frag">
3874 &lt;xsl:param name="prefer.internal.olink" select="0"&gt;&lt;/xsl:param&gt;
3875 </programlisting>
3876 </refsynopsisdiv>
3877
3878 <refsection><info><title>Description</title></info>
3879
3880 <para>If you are re-using XML content modules in multiple documents,
3881 you may want to redirect some of your olinks.  This parameter
3882 permits you to redirect an olink to the current document.
3883 </para>
3884
3885 <para>For example: you are writing documentation for a  product, 
3886 which includes 3 manuals: a little installation
3887 booklet (booklet.xml), a user 
3888 guide (user.xml), and a reference manual (reference.xml).
3889 All 3 documents begin with the same introduction section (intro.xml) that 
3890 contains a reference to the customization section (custom.xml) which is 
3891 included in both user.xml and reference.xml documents.
3892 </para>
3893
3894 <para>How do you write the link to custom.xml in intro.xml
3895 so that it is interpreted correctly in all 3 documents?</para>
3896 <itemizedlist>
3897 <listitem><para>If you use xref, it will fail in user.xml.</para>
3898 </listitem>
3899 <listitem><para>If you use olink (pointing to reference.xml),
3900 the reference in user.xml  
3901 will point to the customization section of the reference manual, while it is 
3902 actually available in user.xml.</para>
3903 </listitem>
3904 </itemizedlist>
3905
3906 <para>If you set the <parameter>prefer.internal.olink</parameter>
3907 parameter to a non-zero value, then the processor will
3908 first look in the olink database
3909 for the olink's <tag>targetptr</tag> attribute value
3910 in document matching the <parameter>current.docid</parameter>
3911 parameter value.  If it isn't found there, then
3912 it tries the document in the database
3913 with the <tag>targetdoc</tag>
3914 value that matches the olink's <tag>targetdoc</tag>
3915 attribute.
3916 </para>
3917
3918 <para>This feature permits an olink reference to resolve to
3919 the current document if there is an element
3920 with an id matching the olink's <tag>targetptr</tag>
3921 value.  The current document's olink data must be
3922 included in the target database for this to work.</para>
3923
3924 <caution>
3925 <para>There is a potential for incorrect links if
3926 the same <tag>id</tag> attribute value is used for different
3927 content in different documents.
3928 Some of your olinks may be redirected to the current document
3929 when they shouldn't be.  It is not possible to control
3930 individual olink instances.</para>
3931 </caution>
3932
3933 </refsection>
3934 </refentry>
3935
3936 <refentry version="5.0" xml:id="target.database.document"> 
3937 <refmeta> 
3938 <refentrytitle>target.database.document</refentrytitle> 
3939 <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo> 
3940 </refmeta> 
3941 <refnamediv> 
3942 <refname>target.database.document</refname> 
3943 <refpurpose>Name of master database file for resolving
3944 olinks</refpurpose> 
3945 </refnamediv> 
3946 <refsynopsisdiv> 
3947 <programlisting xml:id="target.database.document.frag">
3948  &lt;xsl:param name="target.database.document"&gt;olinkdb.xml&lt;/xsl:param&gt;
3949 </programlisting> 
3950 </refsynopsisdiv> 
3951 <refsection><info><title>Description</title></info>
3952  
3953 <para>
3954 To resolve olinks between documents, the stylesheets use a master
3955 database document that identifies the target datafiles for all the
3956 documents within the scope of the olinks. This parameter value is the
3957 URI of the master document to be read during processing to resolve
3958 olinks.  The default value is <filename>olinkdb.xml</filename>.</para>
3959
3960 <para>The data structure of the file is defined in the
3961 <filename>targetdatabase.dtd</filename> DTD.  The database file
3962 provides the high level elements to record the identifiers, locations,
3963 and relationships of documents. The cross reference data for
3964 individual documents is generally pulled into the database using
3965 system entity references or XIncludes. See also
3966 <parameter>targets.filename</parameter>.  </para> </refsection>
3967 </refentry>
3968
3969 <refentry version="5.0" xml:id="targets.filename"> 
3970 <refmeta> 
3971 <refentrytitle>targets.filename</refentrytitle> 
3972 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo> 
3973 </refmeta> 
3974 <refnamediv> 
3975 <refname>targets.filename</refname> 
3976 <refpurpose>Name of cross reference targets data file</refpurpose> 
3977 </refnamediv> 
3978 <refsynopsisdiv> <programlisting xml:id="targets.filename.frag">
3979 &lt;xsl:param name="targets.filename"&gt;target.db&lt;/xsl:param&gt;
3980 </programlisting> 
3981 </refsynopsisdiv> 
3982 <refsection><info><title>Description</title></info>
3983  
3984 <para>
3985 In order to resolve olinks efficiently, the stylesheets can
3986 generate an external data file containing information about
3987 all potential cross reference endpoints in a document.
3988 This parameter lets you change the name of the generated
3989 file from the default name <filename>target.db</filename>.
3990 The name must agree with that used in the target database
3991 used to resolve olinks during processing.
3992 See also <parameter>target.database.document</parameter>.
3993 </para> 
3994 </refsection> 
3995 </refentry>
3996
3997 <refentry version="5.0" xml:id="use.local.olink.style"> 
3998 <refmeta> 
3999 <refentrytitle>use.local.olink.style</refentrytitle> 
4000 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> 
4001 </refmeta> 
4002 <refnamediv> 
4003 <refname>use.local.olink.style</refname> 
4004 <refpurpose>Process olinks using xref style of current
4005 document</refpurpose> 
4006 </refnamediv> 
4007 <refsynopsisdiv> <programlisting xml:id="use.local.olink.style.frag">
4008 &lt;xsl:param name="use.local.olink.style" select="0"&gt;&lt;/xsl:param&gt; </programlisting> 
4009 </refsynopsisdiv> 
4010 <refsection><info><title>Description</title></info> 
4011  
4012 <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
4013 reference string is formed again from the target title, number, and
4014 element name, using the stylesheet processing the targeting document.
4015 Then olinks will match the xref style in the targeting document
4016 rather than in the target document. If  both documents are processed
4017 with the same stylesheet, then the results will be the same.</para> 
4018 </refsection> 
4019 </refentry>
4020
4021 </reference>
4022 <reference xml:id="xrefs"><title>Cross References</title>
4023 <refentry version="5.0" xml:id="insert.xref.page.number">
4024 <refmeta>
4025 <refentrytitle>insert.xref.page.number</refentrytitle>
4026 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
4027 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>
4028 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
4029 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>
4030 </refmeta>
4031 <refnamediv>
4032 <refname>insert.xref.page.number</refname>
4033 <refpurpose>Turns page numbers in xrefs on and off</refpurpose>
4034 </refnamediv>
4035
4036 <refsynopsisdiv>
4037 <programlisting xml:id="insert.xref.page.number.frag">
4038 &lt;xsl:param name="insert.xref.page.number"&gt;no&lt;/xsl:param&gt;
4039 </programlisting>
4040 </refsynopsisdiv>
4041
4042 <refsection><info><title>Description</title></info>
4043
4044 <para>The value of this parameter determines if
4045 cross references (<tag>xref</tag>s) in
4046 printed output will
4047 include page number citations.
4048 It has three possible values.
4049 </para>
4050 <variablelist>
4051 <varlistentry>
4052 <term>no</term>
4053 <listitem><para>No page number references will be generated.
4054 </para></listitem>
4055 </varlistentry>
4056 <varlistentry>
4057 <term>yes</term>
4058 <listitem><para>Page number references will be generated
4059 for all <tag>xref</tag> elements.
4060 The style of page reference may be changed
4061 if an <tag class="attribute">xrefstyle</tag>
4062 attribute is used.
4063 </para></listitem>
4064 </varlistentry>
4065 <varlistentry>
4066 <term>maybe</term>
4067 <listitem><para>Page number references will not be generated
4068 for an <tag>xref</tag> element unless 
4069 it has an
4070 <tag class="attribute">xrefstyle</tag>
4071 attribute whose value specifies a page reference.
4072 </para></listitem>
4073 </varlistentry>
4074 </variablelist>
4075
4076 </refsection>
4077 </refentry>
4078
4079 <refentry version="5.0" xml:id="xref.properties">
4080 <refmeta>
4081 <refentrytitle>xref.properties</refentrytitle>
4082 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4083 </refmeta>
4084 <refnamediv>
4085 <refname>xref.properties</refname>
4086 <refpurpose>Properties associated with cross-reference text</refpurpose>
4087 </refnamediv>
4088
4089 <refsynopsisdiv>
4090 <programlisting xml:id="xref.properties.frag">
4091 &lt;xsl:attribute-set name="xref.properties"&gt;
4092 &lt;/xsl:attribute-set&gt;
4093 </programlisting>
4094 </refsynopsisdiv>
4095
4096 <refsection><info><title>Description</title></info>
4097
4098 <para>This attribute set is used to set properties
4099 on cross reference text.</para>
4100
4101 </refsection>
4102 </refentry>
4103
4104 <refentry version="5.0" xml:id="xref.label-title.separator">
4105 <refmeta>
4106 <refentrytitle>xref.label-title.separator</refentrytitle>
4107 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
4108 </refmeta>
4109 <refnamediv>
4110 <refname>xref.label-title.separator</refname>
4111 <refpurpose>Punctuation or space separating label from title in xref</refpurpose>
4112 </refnamediv>
4113
4114 <refsynopsisdiv>
4115 <programlisting xml:id="xref.label-title.separator.frag">&lt;xsl:param name="xref.label-title.separator"&gt;: &lt;/xsl:param&gt;</programlisting>
4116 </refsynopsisdiv>
4117
4118 <refsection><info><title>Description</title></info>
4119
4120 <para>
4121 This parameter allows you to control the punctuation of certain
4122 types of generated cross reference text.
4123 When cross reference text is generated for an 
4124 <tag class="element">xref</tag> or 
4125 <tag class="element">olink</tag> element
4126 using an <tag class="attribute">xrefstyle</tag> attribute
4127 that makes use of the <literal>select:</literal> feature,
4128 and the selected components include both label and title,
4129 then the value of this parameter is inserted between
4130 label and title in the output.  
4131 </para>
4132
4133 </refsection>
4134 </refentry>
4135
4136 <refentry version="5.0" xml:id="xref.label-page.separator">
4137 <refmeta>
4138 <refentrytitle>xref.label-page.separator</refentrytitle>
4139 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
4140 </refmeta>
4141 <refnamediv>
4142 <refname>xref.label-page.separator</refname>
4143 <refpurpose>Punctuation or space separating label from page number in xref</refpurpose>
4144 </refnamediv>
4145
4146 <refsynopsisdiv>
4147 <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>
4148 </refsynopsisdiv>
4149
4150 <refsection><info><title>Description</title></info>
4151
4152 <para>
4153 This parameter allows you to control the punctuation of certain
4154 types of generated cross reference text.
4155 When cross reference text is generated for an 
4156 <tag class="element">xref</tag> or 
4157 <tag class="element">olink</tag> element
4158 using an <tag class="attribute">xrefstyle</tag> attribute
4159 that makes use of the <literal>select:</literal> feature,
4160 and the selected components include both label and page
4161 but no title,
4162 then the value of this parameter is inserted between
4163 label and page number in the output.  
4164 If a title is included, then other separators are used.
4165 </para>
4166
4167 </refsection>
4168 </refentry>
4169
4170 <refentry version="5.0" xml:id="xref.title-page.separator">
4171 <refmeta>
4172 <refentrytitle>xref.title-page.separator</refentrytitle>
4173 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
4174 </refmeta>
4175 <refnamediv>
4176 <refname>xref.title-page.separator</refname>
4177 <refpurpose>Punctuation or space separating title from page number in xref</refpurpose>
4178 </refnamediv>
4179
4180 <refsynopsisdiv>
4181 <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>
4182 </refsynopsisdiv>
4183
4184 <refsection><info><title>Description</title></info>
4185
4186 <para>
4187 This parameter allows you to control the punctuation of certain
4188 types of generated cross reference text.
4189 When cross reference text is generated for an 
4190 <tag class="element">xref</tag> or 
4191 <tag class="element">olink</tag> element
4192 using an <tag class="attribute">xrefstyle</tag> attribute
4193 that makes use of the <literal>select:</literal> feature,
4194 and the selected components include both title and page number,
4195 then the value of this parameter is inserted between
4196 title and page number in the output.  
4197 </para>
4198
4199 </refsection>
4200 </refentry>
4201
4202 <refentry version="5.0" xml:id="insert.link.page.number">
4203 <refmeta>
4204 <refentrytitle>insert.link.page.number</refentrytitle>
4205 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
4206 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>
4207 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
4208 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>
4209 </refmeta>
4210 <refnamediv>
4211 <refname>insert.link.page.number</refname>
4212 <refpurpose>Turns page numbers in link elements on and off</refpurpose>
4213 </refnamediv>
4214
4215 <refsynopsisdiv>
4216 <programlisting xml:id="insert.link.page.number.frag">
4217 &lt;xsl:param name="insert.link.page.number"&gt;no&lt;/xsl:param&gt;
4218 </programlisting>
4219 </refsynopsisdiv>
4220
4221 <refsection><info><title>Description</title></info>
4222
4223 <para>The value of this parameter determines if
4224 cross references using the <tag>link</tag> element in
4225 printed output will
4226 include standard page number citations.
4227 It has three possible values.
4228 </para>
4229 <variablelist>
4230 <varlistentry>
4231 <term>no</term>
4232 <listitem><para>No page number references will be generated.
4233 </para></listitem>
4234 </varlistentry>
4235 <varlistentry>
4236 <term>yes</term>
4237 <listitem><para>Page number references will be generated
4238 for all <tag>link</tag> elements.
4239 The style of page reference may be changed
4240 if an <tag class="attribute">xrefstyle</tag>
4241 attribute is used.
4242 </para></listitem>
4243 </varlistentry>
4244 <varlistentry>
4245 <term>maybe</term>
4246 <listitem><para>Page number references will not be generated
4247 for a <tag>link</tag> element unless 
4248 it has an
4249 <tag class="attribute">xrefstyle</tag>
4250 attribute whose value specifies a page reference.
4251 </para></listitem>
4252 </varlistentry>
4253 </variablelist>
4254
4255 <para>Although the <tag>xrefstyle</tag> attribute
4256 can be used to turn the page reference on or off, it cannot be
4257 used to control the formatting of the page number as it
4258 can in <tag>xref</tag>.
4259 In <tag>link</tag> it will always format with
4260 the style established by the
4261 gentext template with <literal>name="page.citation"</literal>
4262 in the <literal>l:context name="xref"</literal>.
4263 </para>
4264 </refsection>
4265 </refentry>
4266
4267 </reference>
4268 <reference xml:id="lists"><title>Lists</title>
4269 <refentry version="5.0" xml:id="compact.list.item.spacing">
4270 <refmeta>
4271 <refentrytitle>compact.list.item.spacing</refentrytitle>
4272 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4273 </refmeta>  
4274 <refnamediv>
4275 <refname>compact.list.item.spacing</refname>
4276 <refpurpose>What space do you want between list items (when spacing="compact")?</refpurpose>
4277 </refnamediv>
4278
4279 <refsynopsisdiv>
4280 <programlisting xml:id="compact.list.item.spacing.frag">&lt;xsl:attribute-set name="compact.list.item.spacing"&gt;
4281   &lt;xsl:attribute name="space-before.optimum"&gt;0em&lt;/xsl:attribute&gt;
4282   &lt;xsl:attribute name="space-before.minimum"&gt;0em&lt;/xsl:attribute&gt;
4283   &lt;xsl:attribute name="space-before.maximum"&gt;0.2em&lt;/xsl:attribute&gt;
4284 &lt;/xsl:attribute-set&gt;</programlisting>
4285 </refsynopsisdiv>
4286 <refsection><info><title>Description</title></info>
4287 <para>Specify what spacing you want between each list item when
4288 <tag class="attribute">spacing</tag> is
4289 <quote><literal>compact</literal></quote>.</para>
4290 </refsection>
4291 </refentry>
4292
4293 <refentry version="5.0" xml:id="itemizedlist.properties">
4294 <refmeta>
4295 <refentrytitle>itemizedlist.properties</refentrytitle>
4296 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4297 </refmeta>
4298 <refnamediv>
4299 <refname>itemizedlist.properties</refname>
4300 <refpurpose>Properties that apply to each list-block generated by itemizedlist.</refpurpose>
4301 </refnamediv>
4302
4303 <refsynopsisdiv>
4304 <programlisting xml:id="itemizedlist.properties.frag">&lt;xsl:attribute-set name="itemizedlist.properties" use-attribute-sets="list.block.properties"&gt;
4305 &lt;/xsl:attribute-set&gt;</programlisting>
4306 </refsynopsisdiv>
4307 <refsection><info><title>Description</title></info>
4308 <para>Properties that apply to each fo:list-block generated by itemizedlist.</para>
4309 </refsection>
4310 </refentry>
4311
4312 <refentry version="5.0" xml:id="itemizedlist.label.properties">
4313 <refmeta>
4314 <refentrytitle>itemizedlist.label.properties</refentrytitle>
4315 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4316 </refmeta>
4317 <refnamediv>
4318 <refname>itemizedlist.label.properties</refname>
4319 <refpurpose>Properties that apply to each label inside itemized list.</refpurpose>
4320 </refnamediv>
4321
4322 <refsynopsisdiv>
4323 <programlisting xml:id="itemizedlist.label.properties.frag">&lt;xsl:attribute-set name="itemizedlist.label.properties"&gt;
4324 &lt;/xsl:attribute-set&gt;</programlisting>
4325 </refsynopsisdiv>
4326 <refsection><info><title>Description</title></info>
4327 <para>Properties that apply to each label inside itemized list. E.g.:</para>
4328 <programlisting>&lt;xsl:attribute-set name="itemizedlist.label.properties"&gt;
4329   &lt;xsl:attribute name="text-align"&gt;right&lt;/xsl:attribute&gt;
4330 &lt;/xsl:attribute-set&gt;</programlisting>
4331 </refsection>
4332 </refentry>
4333
4334 <refentry version="5.0" xml:id="itemizedlist.label.width">
4335 <refmeta>
4336 <refentrytitle>itemizedlist.label.width</refentrytitle>
4337 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
4338 </refmeta>
4339 <refnamediv>
4340   <refname>itemizedlist.label.width</refname>
4341 <refpurpose>The default width of the label (bullet) in an itemized list.</refpurpose>
4342 </refnamediv>
4343
4344 <refsynopsisdiv>
4345   <programlisting xml:id="itemizedlist.label.width.frag">
4346     &lt;xsl:param name="itemizedlist.label.width"&gt;1.0em&lt;/xsl:param&gt;
4347   </programlisting>
4348 </refsynopsisdiv>
4349
4350 <refsection><info><title>Description</title></info>
4351 <para>Specifies the default width of the label (usually a bullet or other
4352 symbol) in an itemized list. You can override the default value on any
4353 particular list with the &#8220;dbfo&#8221; processing instruction using the
4354 &#8220;label-width&#8221; pseudoattribute.</para>
4355 </refsection>
4356 </refentry>
4357
4358 <refentry version="5.0" xml:id="list.block.properties">
4359 <refmeta>
4360 <refentrytitle>list.block.properties</refentrytitle>
4361 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4362 </refmeta>
4363 <refnamediv>
4364 <refname>list.block.properties</refname>
4365 <refpurpose>Properties that apply to each list-block generated by list.</refpurpose>
4366 </refnamediv>
4367
4368 <refsynopsisdiv>
4369 <programlisting xml:id="list.block.properties.frag">&lt;xsl:attribute-set name="list.block.properties"&gt;
4370   &lt;xsl:attribute name="provisional-label-separation"&gt;0.2em&lt;/xsl:attribute&gt;
4371   &lt;xsl:attribute name="provisional-distance-between-starts"&gt;1.5em&lt;/xsl:attribute&gt;
4372 &lt;/xsl:attribute-set&gt;</programlisting>
4373 </refsynopsisdiv>
4374 <refsection><info><title>Description</title></info>
4375 <para>Properties that apply to each fo:list-block generated by itemizedlist/orderedlist.</para>
4376 </refsection>
4377 </refentry>
4378
4379 <refentry version="5.0" xml:id="list.block.spacing">
4380 <refmeta>
4381 <refentrytitle>list.block.spacing</refentrytitle>
4382 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4383 </refmeta>
4384 <refnamediv>
4385 <refname>list.block.spacing</refname>
4386 <refpurpose>What spacing do you want before and after lists?</refpurpose>
4387 </refnamediv>
4388
4389 <refsynopsisdiv>
4390 <programlisting xml:id="list.block.spacing.frag">&lt;xsl:attribute-set name="list.block.spacing"&gt;
4391   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
4392   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
4393   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
4394   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;
4395   &lt;xsl:attribute name="space-after.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
4396   &lt;xsl:attribute name="space-after.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
4397 &lt;/xsl:attribute-set&gt;</programlisting>
4398 </refsynopsisdiv>
4399 <refsection><info><title>Description</title></info>
4400 <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>
4401 </refsection>
4402 </refentry>
4403
4404 <refentry version="5.0" xml:id="list.item.spacing">
4405 <refmeta>
4406 <refentrytitle>list.item.spacing</refentrytitle>
4407 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4408 </refmeta>
4409 <refnamediv>
4410 <refname>list.item.spacing</refname>
4411 <refpurpose>What space do you want between list items?</refpurpose>
4412 </refnamediv>
4413
4414 <refsynopsisdiv>
4415 <programlisting xml:id="list.item.spacing.frag">&lt;xsl:attribute-set name="list.item.spacing"&gt;
4416   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
4417   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
4418   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
4419 &lt;/xsl:attribute-set&gt;</programlisting>
4420 </refsynopsisdiv>
4421 <refsection><info><title>Description</title></info>
4422 <para>Specify what spacing you want between each list item.</para>
4423 </refsection>
4424 </refentry>
4425
4426 <refentry version="5.0" xml:id="orderedlist.properties">
4427 <refmeta>
4428 <refentrytitle>orderedlist.properties</refentrytitle>
4429 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4430 </refmeta>
4431 <refnamediv>
4432 <refname>orderedlist.properties</refname>
4433 <refpurpose>Properties that apply to each list-block generated by orderedlist.</refpurpose>
4434 </refnamediv>
4435
4436 <refsynopsisdiv>
4437 <programlisting xml:id="orderedlist.properties.frag">&lt;xsl:attribute-set name="orderedlist.properties" use-attribute-sets="list.block.properties"&gt;
4438   &lt;xsl:attribute name="provisional-distance-between-starts"&gt;2em&lt;/xsl:attribute&gt;
4439 &lt;/xsl:attribute-set&gt;</programlisting>
4440 </refsynopsisdiv>
4441 <refsection><info><title>Description</title></info>
4442 <para>Properties that apply to each fo:list-block generated by orderedlist.</para>
4443 </refsection>
4444 </refentry>
4445
4446 <refentry version="5.0" xml:id="orderedlist.label.properties">
4447 <refmeta>
4448 <refentrytitle>orderedlist.label.properties</refentrytitle>
4449 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4450 </refmeta>
4451 <refnamediv>
4452 <refname>orderedlist.label.properties</refname>
4453 <refpurpose>Properties that apply to each label inside ordered list.</refpurpose>
4454 </refnamediv>
4455
4456 <refsynopsisdiv>
4457 <programlisting xml:id="orderedlist.label.properties.frag">&lt;xsl:attribute-set name="orderedlist.label.properties"&gt;
4458 &lt;/xsl:attribute-set&gt;</programlisting>
4459 </refsynopsisdiv>
4460 <refsection><info><title>Description</title></info>
4461 <para>Properties that apply to each label inside ordered list. E.g.:</para>
4462 <programlisting>&lt;xsl:attribute-set name="orderedlist.label.properties"&gt;
4463   &lt;xsl:attribute name="text-align"&gt;right&lt;/xsl:attribute&gt;
4464 &lt;/xsl:attribute-set&gt;</programlisting>
4465 </refsection>
4466 </refentry>
4467
4468 <refentry version="5.0" xml:id="orderedlist.label.width">
4469 <refmeta>
4470 <refentrytitle>orderedlist.label.width</refentrytitle>
4471 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
4472 </refmeta>
4473 <refnamediv>
4474 <refname>orderedlist.label.width</refname>
4475 <refpurpose>The default width of the label (number) in an ordered list.</refpurpose>
4476 </refnamediv>
4477
4478 <refsynopsisdiv>
4479 <programlisting xml:id="orderedlist.label.width.frag">
4480 &lt;xsl:param name="orderedlist.label.width"&gt;1.2em&lt;/xsl:param&gt;
4481 </programlisting>
4482 </refsynopsisdiv>
4483
4484 <refsection><info><title>Description</title></info>
4485 <para>Specifies the default width of the label (usually a number or
4486 sequence of numbers) in an ordered list. You can override the default
4487 value on any particular list with the &#8220;dbfo&#8221; processing instruction
4488 using the &#8220;label-width&#8221; pseudoattribute.</para>
4489 </refsection>
4490 </refentry>
4491
4492 <refentry version="5.0" xml:id="variablelist.max.termlength">
4493 <refmeta>
4494 <refentrytitle>variablelist.max.termlength</refentrytitle>
4495 <refmiscinfo class="other" otherclass="datatype">number</refmiscinfo>
4496 </refmeta>
4497 <refnamediv>
4498 <refname>variablelist.max.termlength</refname>
4499 <refpurpose>Specifies the longest term in variablelists</refpurpose>
4500 </refnamediv>
4501
4502 <refsynopsisdiv>
4503 <programlisting xml:id="variablelist.max.termlength.frag">
4504 &lt;xsl:param name="variablelist.max.termlength"&gt;24&lt;/xsl:param&gt;
4505 </programlisting>
4506 </refsynopsisdiv>
4507
4508 <refsection><info><title>Description</title></info>
4509
4510 <para>In variablelists, the <tag>listitem</tag>
4511 is indented to leave room for the 
4512 <tag>term</tag> elements. That indent may be computed
4513 if it is not specified with a <tag class="attribute">termlength</tag>
4514 attribute on the <tag>variablelist</tag> element.
4515 </para>
4516 <para>
4517 The computation counts characters in the 
4518 <tag>term</tag> elements in the list
4519 to find the longest term.  However, some terms are very long
4520 and would produce extreme indents.  This parameter lets you
4521 set a maximum character count.  Any terms longer than the maximum
4522 would line wrap.  The default value is 24.
4523 </para>
4524 <para>
4525 The character counts are converted to physical widths
4526 by multiplying by 0.50em. There will be some variability
4527 in how many actual characters fit in the space
4528 since some characters are wider than others.
4529 </para>
4530
4531 </refsection>
4532 </refentry>
4533
4534 <refentry version="5.0" xml:id="variablelist.term.separator">
4535 <refmeta>
4536 <refentrytitle>variablelist.term.separator</refentrytitle>
4537 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
4538 </refmeta>
4539 <refnamediv>
4540 <refname>variablelist.term.separator</refname>
4541 <refpurpose>Text to separate <tag>term</tag>s within a multi-term
4542 <tag>varlistentry</tag></refpurpose>
4543 </refnamediv>
4544
4545 <refsynopsisdiv>
4546 <programlisting xml:id="variablelist.term.separator.frag">
4547 &lt;xsl:param name="variablelist.term.separator"&gt;, &lt;/xsl:param&gt;</programlisting>
4548 </refsynopsisdiv>
4549
4550 <refsection><info><title>Description</title></info>
4551
4552 <para>When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
4553 elements, the string specified in the value of the
4554 <parameter>variablelist.term.separator</parameter> parameter is placed
4555 after each <tag>term</tag> except the last.</para>
4556
4557 <note>
4558   <para>To generate a line break between multiple <tag>term</tag>s in
4559   a <tag>varlistentry</tag>, set a non-zero value for the
4560   <parameter>variablelist.term.break.after</parameter> parameter. If
4561   you do so, you may also want to set the value of the
4562   <parameter>variablelist.term.separator</parameter> parameter to an
4563   empty string (to suppress rendering of the default comma and space
4564   after each <tag>term</tag>).</para>
4565 </note>
4566
4567 </refsection>
4568 </refentry>
4569
4570 <refentry version="5.0" xml:id="variablelist.term.properties">
4571 <refmeta>
4572 <refentrytitle>variablelist.term.properties</refentrytitle>
4573 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4574 </refmeta>
4575 <refnamediv>
4576 <refname>variablelist.term.properties</refname>
4577 <refpurpose>To add properties to the term elements in a variablelist.</refpurpose>
4578 </refnamediv>
4579
4580 <refsynopsisdiv>
4581 <programlisting xml:id="variablelist.term.properties.frag">
4582 &lt;xsl:attribute-set name="variablelist.term.properties"&gt;
4583 &lt;/xsl:attribute-set&gt;
4584 </programlisting>
4585 </refsynopsisdiv>
4586 <refsection><info><title>Description</title></info>
4587 <para>These properties are added to the block containing a
4588 term in a variablelist.
4589 Use this attribute-set to set
4590 font properties or alignment, for example.</para>
4591
4592 </refsection>
4593 </refentry>
4594
4595 <refentry version="5.0" xml:id="variablelist.term.break.after">
4596 <refmeta>
4597 <refentrytitle>variablelist.term.break.after</refentrytitle>
4598 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
4599 </refmeta>
4600 <refnamediv>
4601 <refname>variablelist.term.break.after</refname>
4602 <refpurpose>Generate line break after each <tag>term</tag> within a
4603 multi-term <tag>varlistentry</tag>?</refpurpose>
4604 </refnamediv>
4605
4606 <refsynopsisdiv>
4607 <programlisting xml:id="variablelist.term.break.after.frag">
4608 &lt;xsl:param name="variablelist.term.break.after"&gt;0&lt;/xsl:param&gt;</programlisting>
4609 </refsynopsisdiv>
4610
4611 <refsection><info><title>Description</title></info>
4612
4613 <para>Set a non-zero value for the
4614 <parameter>variablelist.term.break.after</parameter> parameter to
4615 generate a line break between <tag>term</tag>s in a
4616 multi-term <tag>varlistentry</tag>.</para>
4617
4618 <note>
4619 <para>If you set a non-zero value for
4620 <parameter>variablelist.term.break.after</parameter>, you may also
4621 want to set the value of the
4622 <parameter>variablelist.term.separator</parameter> parameter to an
4623 empty string (to suppress rendering of the default comma and space
4624 after each <tag>term</tag>).</para>
4625 </note>
4626
4627 </refsection>
4628 </refentry>
4629
4630 </reference>
4631 <reference xml:id="qa"><title>QAndASet</title>
4632 <refentry version="5.0" xml:id="qandadiv.autolabel">
4633 <refmeta>
4634 <refentrytitle>qandadiv.autolabel</refentrytitle>
4635 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
4636 </refmeta>
4637 <refnamediv>
4638 <refname>qandadiv.autolabel</refname>
4639 <refpurpose>Are divisions in QAndASets enumerated?</refpurpose>
4640 </refnamediv>
4641
4642 <refsynopsisdiv>
4643 <programlisting xml:id="qandadiv.autolabel.frag">&lt;xsl:param name="qandadiv.autolabel" select="1"&gt;&lt;/xsl:param&gt;</programlisting>
4644 </refsynopsisdiv>
4645
4646 <refsection><info><title>Description</title></info>
4647
4648 <para>If non-zero, unlabeled qandadivs will be enumerated.
4649 </para>
4650
4651 </refsection>
4652 </refentry>
4653
4654 <refentry version="5.0" xml:id="qanda.inherit.numeration">
4655 <refmeta>
4656 <refentrytitle>qanda.inherit.numeration</refentrytitle>
4657 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
4658 </refmeta>
4659 <refnamediv>
4660 <refname>qanda.inherit.numeration</refname>
4661 <refpurpose>Does enumeration of QandASet components inherit the numeration of parent elements?</refpurpose>
4662 </refnamediv>
4663
4664 <refsynopsisdiv>
4665 <programlisting xml:id="qanda.inherit.numeration.frag">
4666 &lt;xsl:param name="qanda.inherit.numeration" select="1"&gt;&lt;/xsl:param&gt;
4667 </programlisting>
4668 </refsynopsisdiv>
4669
4670 <refsection><info><title>Description</title></info>
4671
4672 <para>If non-zero, numbered <tag>qandadiv</tag> elements and
4673 <tag>question</tag> and <tag>answer</tag> inherit the enumeration of
4674 the ancestors of the <tag>qandaset</tag>.
4675 </para>
4676
4677 </refsection>
4678 </refentry>
4679
4680 <refentry version="5.0" xml:id="qanda.defaultlabel">
4681 <refmeta>
4682 <refentrytitle>qanda.defaultlabel</refentrytitle>
4683 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
4684 <refmiscinfo class="other" otherclass="value">number</refmiscinfo>
4685 <refmiscinfo class="other" otherclass="value">qanda</refmiscinfo> 
4686 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>
4687 </refmeta>
4688 <refnamediv>
4689 <refname>qanda.defaultlabel</refname>
4690 <refpurpose>Sets the default for defaultlabel on QandASet.</refpurpose>
4691 </refnamediv>
4692
4693 <refsynopsisdiv>
4694 <programlisting xml:id="qanda.defaultlabel.frag">
4695 &lt;xsl:param name="qanda.defaultlabel"&gt;number&lt;/xsl:param&gt;
4696 </programlisting>
4697 </refsynopsisdiv>
4698
4699 <refsection><info><title>Description</title></info>
4700
4701 <para>If no <literal>defaultlabel</literal> attribute is specified on
4702 a <tag>qandaset</tag>, this value is used. It is generally one of the legal
4703 values for the defaultlabel attribute (<literal>none</literal>, 
4704 <literal>number</literal> or
4705 <literal>qanda</literal>), or one of the additional stylesheet-specific values
4706 (<literal>qnumber</literal> or <literal>qnumberanda</literal>).
4707 The default value is 'number'.
4708 </para>
4709 <para>The values are rendered as follows:</para>
4710 <variablelist>
4711 <varlistentry><term><literal>qanda</literal></term>
4712 <listitem>
4713 <para><tag>question</tag>s are labeled "Q:" and
4714 <tag>answer</tag>s are labeled "A:". </para>
4715 </listitem>
4716 </varlistentry>
4717
4718 <varlistentry><term><literal>number</literal></term>
4719 <listitem>
4720 <para>The questions are enumerated and the answers
4721 are not labeled. </para>
4722 </listitem>
4723 </varlistentry>
4724
4725 <varlistentry><term><literal>qnumber</literal></term>
4726 <listitem>
4727 <para>The questions are labeled "Q:" followed by a number, and answers are not 
4728 labeled. 
4729 When sections are numbered, adding a label
4730 to the number distinguishes the question numbers
4731 from the section numbers.
4732 This value is not allowed in the
4733 <tag class="attribute">defaultlabel</tag> attribute
4734 of a <tag>qandaset</tag> element.</para>
4735 </listitem>
4736 </varlistentry>
4737
4738 <varlistentry><term><literal>qnumberanda</literal></term>
4739 <listitem>
4740 <para>The questions are labeled "Q:" followed by a number, and
4741 the answers are labeled "A:". 
4742 When sections are numbered, adding a label
4743 to the number distinguishes the question numbers
4744 from the section numbers.
4745 This value is not allowed in the
4746 <tag class="attribute">defaultlabel</tag> attribute
4747 of a <tag>qandaset</tag> element.</para>
4748 </listitem>
4749 </varlistentry>
4750
4751 <varlistentry><term><literal>none</literal></term>
4752 <listitem>
4753 <para>No distinguishing label precedes Questions or Answers. 
4754 </para>
4755 </listitem>
4756 </varlistentry>
4757 </variablelist>
4758
4759 </refsection>
4760 </refentry>
4761
4762 <refentry version="5.0" xml:id="qanda.in.toc">
4763 <refmeta>
4764 <refentrytitle>qanda.in.toc</refentrytitle>
4765 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
4766 </refmeta>
4767 <refnamediv>
4768 <refname>qanda.in.toc</refname>
4769 <refpurpose>Should qandaentry questions appear in 
4770 the document table of contents?</refpurpose>
4771 </refnamediv>
4772
4773 <refsynopsisdiv>
4774 <programlisting xml:id="qanda.in.toc.frag">&lt;xsl:param name="qanda.in.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
4775 </refsynopsisdiv>
4776
4777 <refsection><info><title>Description</title></info>
4778
4779 <para>If true (non-zero), then the generated table of contents
4780 for a document will include <tag>qandaset</tag> titles, 
4781 <tag>qandadiv</tag> titles,
4782 and <tag>question</tag> elements.  The default value (zero) excludes
4783 them from the TOC.
4784 </para>
4785 <para>This parameter does not affect any tables of contents
4786 that may be generated inside a qandaset or qandadiv.
4787 </para>
4788
4789 </refsection>
4790 </refentry>
4791
4792 <refentry version="5.0" xml:id="qanda.nested.in.toc">
4793 <refmeta>
4794 <refentrytitle>qanda.nested.in.toc</refentrytitle>
4795 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
4796 </refmeta>
4797 <refnamediv>
4798 <refname>qanda.nested.in.toc</refname>
4799 <refpurpose>Should nested answer/qandaentry instances appear in TOC?</refpurpose>
4800 </refnamediv>
4801
4802 <refsynopsisdiv>
4803 <programlisting xml:id="qanda.nested.in.toc.frag">
4804 &lt;xsl:param name="qanda.nested.in.toc" select="0"&gt;&lt;/xsl:param&gt;
4805 </programlisting>
4806 </refsynopsisdiv>
4807
4808 <refsection><info><title>Description</title></info>
4809
4810 <para>If non-zero, instances of <tag>qandaentry</tag>
4811 that are children of <tag>answer</tag> elements are shown in
4812 the TOC.</para>
4813
4814 </refsection>
4815 </refentry>
4816
4817 </reference>
4818 <reference xml:id="biblio"><title>Bibliography</title>
4819 <refentry version="5.0" xml:id="bibliography.style">
4820 <refmeta>
4821 <refentrytitle>bibliography.style</refentrytitle>
4822 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
4823 <refmiscinfo class="other" otherclass="value">normal</refmiscinfo>
4824 <refmiscinfo class="other" otherclass="value">iso690</refmiscinfo>
4825 </refmeta>
4826 <refnamediv>
4827 <refname>bibliography.style</refname>
4828 <refpurpose>Style used for formatting of biblioentries.</refpurpose>
4829 </refnamediv>
4830
4831 <refsynopsisdiv>
4832 <programlisting xml:id="bibliography.style.frag">
4833 &lt;xsl:param name="bibliography.style"&gt;normal&lt;/xsl:param&gt;
4834 </programlisting>
4835 </refsynopsisdiv>
4836
4837 <refsection><info><title>Description</title></info>
4838
4839 <para>Currently only <literal>normal</literal> and
4840 <literal>iso690</literal> styles are supported.</para>
4841
4842 <para>In order to use ISO690 style to the full extent you might need
4843 to use additional markup described on <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://wiki.docbook.org/topic/ISO690Bibliography">the
4844 following WiKi page</link>.</para>
4845
4846 </refsection>
4847 </refentry>
4848
4849 <refentry version="5.0" xml:id="biblioentry.item.separator">
4850 <refmeta>
4851 <refentrytitle>biblioentry.item.separator</refentrytitle>
4852 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
4853 </refmeta>
4854 <refnamediv>
4855 <refname>biblioentry.item.separator</refname>
4856 <refpurpose>Text to separate bibliography entries</refpurpose>
4857 </refnamediv>
4858
4859 <refsynopsisdiv>
4860 <programlisting xml:id="biblioentry.item.separator.frag">&lt;xsl:param name="biblioentry.item.separator"&gt;. &lt;/xsl:param&gt;</programlisting>
4861 </refsynopsisdiv>
4862
4863 <refsection><info><title>Description</title></info>
4864
4865 <para>Text to separate bibliography entries
4866 </para>
4867
4868 </refsection>
4869 </refentry>
4870
4871 <refentry version="5.0" xml:id="bibliography.collection">
4872 <refmeta>
4873 <refentrytitle>bibliography.collection</refentrytitle>
4874 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
4875 </refmeta>
4876 <refnamediv>
4877 <refname>bibliography.collection</refname>
4878 <refpurpose>Name of the bibliography collection file</refpurpose>
4879 </refnamediv>
4880
4881 <refsynopsisdiv>
4882 <programlisting xml:id="bibliography.collection.frag">
4883 &lt;xsl:param name="bibliography.collection"&gt;http://docbook.sourceforge.net/release/bibliography/bibliography.xml&lt;/xsl:param&gt;
4884
4885 </programlisting>
4886 </refsynopsisdiv>
4887
4888 <refsection><info><title>Description</title></info>
4889
4890 <para>Maintaining bibliography entries across a set of documents is tedious, time
4891 consuming, and error prone. It makes much more sense, usually, to store all of
4892 the bibliography entries in a single place and simply <quote>extract</quote>
4893 the ones you need in each document.</para>
4894
4895 <para>That's the purpose of the
4896 <parameter>bibliography.collection</parameter> parameter. To setup a global
4897 bibliography <quote>database</quote>, follow these steps:</para>
4898
4899 <para>First, create a stand-alone bibliography document that contains all of
4900 the documents that you wish to reference. Make sure that each bibliography
4901 entry (whether you use <tag>biblioentry</tag> or <tag>bibliomixed</tag>)
4902 has an ID.</para>
4903
4904 <para>My global bibliography, <filename>~/bibliography.xml</filename> begins
4905 like this:</para>
4906
4907 <informalexample>
4908 <programlisting>&lt;!DOCTYPE bibliography
4909   PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
4910   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"&gt;
4911 &lt;bibliography&gt;&lt;title&gt;References&lt;/title&gt;
4912
4913 &lt;bibliomixed id="xml-rec"&gt;&lt;abbrev&gt;XML 1.0&lt;/abbrev&gt;Tim Bray,
4914 Jean Paoli, C. M. Sperberg-McQueen, and Eve Maler, editors.
4915 &lt;citetitle&gt;&lt;ulink url="http://www.w3.org/TR/REC-xml"&gt;Extensible Markup
4916 Language (XML) 1.0 Second Edition&lt;/ulink&gt;&lt;/citetitle&gt;.
4917 World Wide Web Consortium, 2000.
4918 &lt;/bibliomixed&gt;
4919
4920 &lt;bibliomixed id="xml-names"&gt;&lt;abbrev&gt;Namespaces&lt;/abbrev&gt;Tim Bray,
4921 Dave Hollander,
4922 and Andrew Layman, editors.
4923 &lt;citetitle&gt;&lt;ulink url="http://www.w3.org/TR/REC-xml-names/"&gt;Namespaces in
4924 XML&lt;/ulink&gt;&lt;/citetitle&gt;.
4925 World Wide Web Consortium, 1999.
4926 &lt;/bibliomixed&gt;
4927
4928 &lt;!-- ... --&gt;
4929 &lt;/bibliography&gt;
4930 </programlisting>
4931 </informalexample>
4932
4933 <para>When you create a bibliography in your document, simply
4934 provide <emphasis>empty</emphasis> <tag>bibliomixed</tag>
4935 entries for each document that you wish to cite. Make sure that these
4936 elements have the same ID as the corresponding <quote>real</quote>
4937 entry in your global bibliography.</para>
4938
4939 <para>For example:</para>
4940
4941 <informalexample>
4942 <programlisting>&lt;bibliography&gt;&lt;title&gt;Bibliography&lt;/title&gt;
4943
4944 &lt;bibliomixed id="xml-rec"/&gt;
4945 &lt;bibliomixed id="xml-names"/&gt;
4946 &lt;bibliomixed id="DKnuth86"&gt;Donald E. Knuth. &lt;citetitle&gt;Computers and
4947 Typesetting: Volume B, TeX: The Program&lt;/citetitle&gt;. Addison-Wesley,
4948 1986.  ISBN 0-201-13437-3.
4949 &lt;/bibliomixed&gt;
4950 &lt;bibliomixed id="relaxng"/&gt;
4951
4952 &lt;/bibliography&gt;</programlisting>
4953 </informalexample>
4954
4955 <para>Note that it's perfectly acceptable to mix entries from your
4956 global bibliography with <quote>normal</quote> entries. You can use
4957 <tag>xref</tag> or other elements to cross-reference your
4958 bibliography entries in exactly the same way you do now.</para>
4959
4960 <para>Finally, when you are ready to format your document, simply set the
4961 <parameter>bibliography.collection</parameter> parameter (in either a
4962 customization layer or directly through your processor's interface) to
4963 point to your global bibliography.</para>
4964
4965 <para>The stylesheets will format the bibliography in your document as if
4966 all of the entries referenced appeared there literally.</para>
4967
4968 </refsection>
4969 </refentry>
4970
4971 <refentry version="5.0" xml:id="bibliography.numbered">
4972 <refmeta>
4973 <refentrytitle>bibliography.numbered</refentrytitle>
4974 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
4975 </refmeta>
4976 <refnamediv>
4977 <refname>bibliography.numbered</refname>
4978 <refpurpose>Should bibliography entries be numbered?</refpurpose>
4979 </refnamediv>
4980
4981 <refsynopsisdiv>
4982 <programlisting xml:id="bibliography.numbered.frag">
4983 &lt;xsl:param name="bibliography.numbered" select="0"&gt;&lt;/xsl:param&gt;
4984 </programlisting>
4985 </refsynopsisdiv>
4986
4987 <refsection><info><title>Description</title></info>
4988
4989 <para>If non-zero bibliography entries will be numbered</para>
4990
4991 </refsection>
4992 </refentry>
4993
4994 <refentry version="5.0" xml:id="biblioentry.properties">
4995 <refmeta>
4996   <refentrytitle>biblioentry.properties</refentrytitle>
4997   <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
4998 </refmeta>
4999 <refnamediv>
5000 <refname>biblioentry.properties</refname>
5001 <refpurpose>To set the style for biblioentry.</refpurpose>
5002 </refnamediv>
5003
5004 <refsynopsisdiv>
5005 <programlisting xml:id="biblioentry.properties.frag">&lt;xsl:attribute-set name="biblioentry.properties" use-attribute-sets="normal.para.spacing"&gt;
5006   &lt;xsl:attribute name="start-indent"&gt;0.5in&lt;/xsl:attribute&gt;
5007   &lt;xsl:attribute name="text-indent"&gt;-0.5in&lt;/xsl:attribute&gt;
5008 &lt;/xsl:attribute-set&gt;
5009 </programlisting>
5010 </refsynopsisdiv>
5011 <refsection><info><title>Description</title></info>
5012 <para>How do you want biblioentry styled? </para>
5013 <para>Set the font-size, weight, space-above and space-below, indents, etc. to the style required</para>
5014
5015 </refsection>
5016 </refentry>
5017
5018 </reference>
5019 <reference xml:id="glossary"><title>Glossary</title>
5020 <refentry version="5.0" xml:id="glossterm.auto.link">
5021 <refmeta>
5022 <refentrytitle>glossterm.auto.link</refentrytitle>
5023 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5024 </refmeta>
5025 <refnamediv>
5026 <refname>glossterm.auto.link</refname>
5027 <refpurpose>Generate links from glossterm to glossentry automatically?</refpurpose>
5028 </refnamediv>
5029
5030 <refsynopsisdiv>
5031 <programlisting xml:id="glossterm.auto.link.frag">
5032 &lt;xsl:param name="glossterm.auto.link" select="0"&gt;&lt;/xsl:param&gt;
5033 </programlisting>
5034 </refsynopsisdiv>
5035
5036 <refsection><info><title>Description</title></info>
5037
5038 <para>If non-zero, links from inline <tag>glossterm</tag>s to the corresponding 
5039 <tag>glossentry</tag> elements in a <tag>glossary</tag> or <tag>glosslist</tag> 
5040 will be automatically generated. This is useful when your glossterms are consistent 
5041 and you don't want to add links manually.</para>
5042
5043 <para>The automatic link generation feature is not used on <tag>glossterm</tag> elements
5044 that have a <tag class="attribute">linkend</tag> attribute.</para>
5045
5046 </refsection>
5047 </refentry>
5048
5049 <refentry version="5.0" xml:id="firstterm.only.link">
5050 <refmeta>
5051 <refentrytitle>firstterm.only.link</refentrytitle>
5052 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5053 </refmeta>
5054 <refnamediv>
5055 <refname>firstterm.only.link</refname>
5056 <refpurpose>Does automatic glossterm linking only apply to firstterms?</refpurpose>
5057 </refnamediv>
5058
5059 <refsynopsisdiv>
5060 <programlisting xml:id="firstterm.only.link.frag">
5061 &lt;xsl:param name="firstterm.only.link" select="0"&gt;&lt;/xsl:param&gt;
5062 </programlisting>
5063 </refsynopsisdiv>
5064
5065 <refsection><info><title>Description</title></info>
5066
5067 <para>If non-zero, only <tag>firstterm</tag>s will be automatically linked
5068 to the glossary. If glossary linking is not enabled, this parameter
5069 has no effect.</para>
5070
5071 </refsection>
5072 </refentry>
5073
5074 <refentry version="5.0" xml:id="glossary.collection">
5075 <refmeta>
5076 <refentrytitle>glossary.collection</refentrytitle>
5077 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
5078 </refmeta>
5079 <refnamediv>
5080 <refname>glossary.collection</refname>
5081 <refpurpose>Name of the glossary collection file</refpurpose>
5082 </refnamediv>
5083
5084 <refsynopsisdiv>
5085 <programlisting xml:id="glossary.collection.frag">
5086 &lt;xsl:param name="glossary.collection"&gt;&lt;/xsl:param&gt;
5087 </programlisting>
5088 </refsynopsisdiv>
5089
5090 <refsection><info><title>Description</title></info>
5091
5092 <para>Glossaries maintained independently across a set of documents
5093 are likely to become inconsistent unless considerable effort is
5094 expended to keep them in sync. It makes much more sense, usually, to
5095 store all of the glossary entries in a single place and simply
5096 <quote>extract</quote> the ones you need in each document.</para>
5097
5098 <para>That's the purpose of the
5099 <parameter>glossary.collection</parameter> parameter. To setup a global
5100 glossary <quote>database</quote>, follow these steps:</para>
5101
5102 <refsection><info><title>Setting Up the Glossary Database</title></info>
5103
5104 <para>First, create a stand-alone glossary document that contains all of
5105 the entries that you wish to reference. Make sure that each glossary
5106 entry has an ID.</para>
5107
5108 <para>Here's an example glossary:</para>
5109
5110 <informalexample>
5111 <programlisting>
5112 &lt;?xml version="1.0" encoding="utf-8"?&gt;
5113 &lt;!DOCTYPE glossary
5114   PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
5115   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"&gt;
5116 &lt;glossary&gt;
5117 &lt;glossaryinfo&gt;
5118 &lt;editor&gt;&lt;firstname&gt;Eric&lt;/firstname&gt;&lt;surname&gt;Raymond&lt;/surname&gt;&lt;/editor&gt;
5119 &lt;title&gt;Jargon File 4.2.3 (abridged)&lt;/title&gt;
5120 &lt;releaseinfo&gt;Just some test data&lt;/releaseinfo&gt;
5121 &lt;/glossaryinfo&gt;
5122
5123 &lt;glossdiv&gt;&lt;title&gt;0&lt;/title&gt;
5124
5125 &lt;glossentry&gt;
5126 &lt;glossterm&gt;0&lt;/glossterm&gt;
5127 &lt;glossdef&gt;
5128 &lt;para&gt;Numeric zero, as opposed to the letter `O' (the 15th letter of
5129 the English alphabet). In their unmodified forms they look a lot
5130 alike, and various kluges invented to make them visually distinct have
5131 compounded the confusion. If your zero is center-dotted and letter-O
5132 is not, or if letter-O looks almost rectangular but zero looks more
5133 like an American football stood on end (or the reverse), you're
5134 probably looking at a modern character display (though the dotted zero
5135 seems to have originated as an option on IBM 3270 controllers). If
5136 your zero is slashed but letter-O is not, you're probably looking at
5137 an old-style ASCII graphic set descended from the default typewheel on
5138 the venerable ASR-33 Teletype (Scandinavians, for whom /O is a letter,
5139 curse this arrangement). (Interestingly, the slashed zero long
5140 predates computers; Florian Cajori's monumental "A History of
5141 Mathematical Notations" notes that it was used in the twelfth and
5142 thirteenth centuries.) If letter-O has a slash across it and the zero
5143 does not, your display is tuned for a very old convention used at IBM
5144 and a few other early mainframe makers (Scandinavians curse &lt;emphasis&gt;this&lt;/emphasis&gt;
5145 arrangement even more, because it means two of their letters collide).
5146 Some Burroughs/Unisys equipment displays a zero with a &lt;emphasis&gt;reversed&lt;/emphasis&gt;
5147 slash. Old CDC computers rendered letter O as an unbroken oval and 0
5148 as an oval broken at upper right and lower left. And yet another
5149 convention common on early line printers left zero unornamented but
5150 added a tail or hook to the letter-O so that it resembled an inverted
5151 Q or cursive capital letter-O (this was endorsed by a draft ANSI
5152 standard for how to draw ASCII characters, but the final standard
5153 changed the distinguisher to a tick-mark in the upper-left corner).
5154 Are we sufficiently confused yet?&lt;/para&gt;
5155 &lt;/glossdef&gt;
5156 &lt;/glossentry&gt;
5157
5158 &lt;glossentry&gt;
5159 &lt;glossterm&gt;1TBS&lt;/glossterm&gt;
5160 &lt;glossdef&gt;
5161 &lt;para role="accidence"&gt;
5162 &lt;phrase role="pronounce"&gt;&lt;/phrase&gt;
5163 &lt;phrase role="partsofspeach"&gt;n&lt;/phrase&gt;
5164 &lt;/para&gt;
5165 &lt;para&gt;The "One True Brace Style"&lt;/para&gt;
5166 &lt;glossseealso&gt;indent style&lt;/glossseealso&gt;
5167 &lt;/glossdef&gt;
5168 &lt;/glossentry&gt;
5169
5170 &lt;!-- ... --&gt;
5171
5172 &lt;/glossdiv&gt;
5173
5174 &lt;!-- ... --&gt;
5175
5176 &lt;/glossary&gt;</programlisting>
5177 </informalexample>
5178
5179 </refsection>
5180
5181 <refsection><info><title>Marking Up Glossary Terms</title></info>
5182
5183 <para>That takes care of the glossary database, now you have to get the entries
5184 into your document. Unlike bibliography entries, which can be empty, creating
5185 <quote>placeholder</quote> glossary entries would be very tedious. So instead,
5186 support for <parameter>glossary.collection</parameter> relies on implicit linking.</para>
5187
5188 <para>In your source document, simply use <tag>firstterm</tag> and
5189 <tag>glossterm</tag> to identify the terms you wish to have included
5190 in the glossary. The stylesheets assume that you will either set the
5191 <tag class="attribute">baseform</tag> attribute correctly, or that the
5192 content of the element exactly matches a term in your glossary.</para>
5193
5194 <para>If you're using a <parameter>glossary.collection</parameter>, don't
5195 make explicit links on the terms in your document.</para>
5196
5197 <para>So, in your document, you might write things like this:</para>
5198
5199 <informalexample>
5200 <programlisting>&lt;para&gt;This is dummy text, without any real meaning.
5201 The point is simply to reference glossary terms like &lt;glossterm&gt;0&lt;/glossterm&gt;
5202 and the &lt;firstterm baseform="1TBS"&gt;One True Brace Style (1TBS)&lt;/firstterm&gt;.
5203 The &lt;glossterm&gt;1TBS&lt;/glossterm&gt;, as you can probably imagine, is a nearly
5204 religious issue.&lt;/para&gt;</programlisting>
5205 </informalexample>
5206
5207 <para>If you set the <parameter>firstterm.only.link</parameter> parameter,
5208 only the terms marked with <tag>firstterm</tag> will be links.
5209 Otherwise, all the terms will be linked.</para>
5210
5211 </refsection>
5212
5213 <refsection><info><title>Marking Up the Glossary</title></info>
5214
5215 <para>The glossary itself has to be identified for the stylesheets. For lack
5216 of a better choice, the <tag class="attribute">role</tag> is used.
5217 To identify the glossary as the target for automatic processing, set
5218 the role to <quote><literal>auto</literal></quote>. The title of this
5219 glossary (and any other information from the <tag>glossaryinfo</tag>
5220 that's rendered by your stylesheet) will be displayed, but the entries will
5221 come from the database.
5222 </para>
5223
5224 <para>Unfortunately, the glossary can't be empty, so you must put in
5225 at least one <tag>glossentry</tag>. The content of this entry
5226 is irrelevant, it will not be rendered:</para>
5227
5228 <informalexample>
5229 <programlisting>&lt;glossary role="auto"&gt;
5230 &lt;glossentry&gt;
5231 &lt;glossterm&gt;Irrelevant&lt;/glossterm&gt;
5232 &lt;glossdef&gt;
5233 &lt;para&gt;If you can see this, the document was processed incorrectly. Use
5234 the &lt;parameter&gt;glossary.collection&lt;/parameter&gt; parameter.&lt;/para&gt;
5235 &lt;/glossdef&gt;
5236 &lt;/glossentry&gt;
5237 &lt;/glossary&gt;</programlisting>
5238 </informalexample>
5239
5240 <para>What about glossary divisions? If your glossary database has glossary
5241 divisions <emphasis>and</emphasis> your automatic glossary contains at least
5242 one <tag>glossdiv</tag>, the automic glossary will have divisions.
5243 If the <tag>glossdiv</tag> is missing from either location, no divisions
5244 will be rendered.</para>
5245
5246 <para>Glossary entries (and divisions, if appropriate) in the glossary will
5247 occur in precisely the order they occur in your database.</para>
5248
5249 </refsection>
5250
5251 <refsection><info><title>Formatting the Document</title></info>
5252
5253 <para>Finally, when you are ready to format your document, simply set the
5254 <parameter>glossary.collection</parameter> parameter (in either a
5255 customization layer or directly through your processor's interface) to
5256 point to your global glossary.</para>
5257
5258 <para>The stylesheets will format the glossary in your document as if
5259 all of the entries implicilty referenced appeared there literally.</para>
5260 </refsection>
5261
5262 <refsection><info><title>Limitations</title></info>
5263
5264 <para>Glossary cross-references <emphasis>within the glossary</emphasis> are
5265 not supported. For example, this <emphasis>will not</emphasis> work:</para>
5266
5267 <informalexample>
5268 <programlisting>&lt;glossentry&gt;
5269 &lt;glossterm&gt;gloss-1&lt;/glossterm&gt;
5270 &lt;glossdef&gt;&lt;para&gt;A description that references &lt;glossterm&gt;gloss-2&lt;/glossterm&gt;.&lt;/para&gt;
5271 &lt;glossseealso&gt;gloss-2&lt;/glossseealso&gt;
5272 &lt;/glossdef&gt;
5273 &lt;/glossentry&gt;</programlisting>
5274 </informalexample>
5275
5276 <para>If you put glossary cross-references in your glossary that way,
5277 you'll get the cryptic error: <computeroutput>Warning:
5278 glossary.collection specified, but there are 0 automatic
5279 glossaries</computeroutput>.</para>
5280
5281 <para>Instead, you must do two things:</para>
5282
5283 <orderedlist>
5284 <listitem>
5285 <para>Markup your glossary using <tag>glossseealso</tag>:</para>
5286
5287 <informalexample>
5288 <programlisting>&lt;glossentry&gt;
5289 &lt;glossterm&gt;gloss-1&lt;/glossterm&gt;
5290 &lt;glossdef&gt;&lt;para&gt;A description that references &lt;glossterm&gt;gloss-2&lt;/glossterm&gt;.&lt;/para&gt;
5291 &lt;glossseealso&gt;gloss-2&lt;/glossseealso&gt;
5292 &lt;/glossdef&gt;
5293 &lt;/glossentry&gt;</programlisting>
5294 </informalexample>
5295 </listitem>
5296
5297 <listitem>
5298 <para>Make sure there is at least one <tag>glossterm</tag> reference to
5299 <glossterm>gloss-2</glossterm> <emphasis>in your document</emphasis>. The
5300 easiest way to do that is probably within a <tag>remark</tag> in your
5301 automatic glossary:</para>
5302
5303 <informalexample>
5304 <programlisting>&lt;glossary role="auto"&gt;
5305 &lt;remark&gt;Make sure there's a reference to &lt;glossterm&gt;gloss-2&lt;/glossterm&gt;.&lt;/remark&gt;
5306 &lt;glossentry&gt;
5307 &lt;glossterm&gt;Irrelevant&lt;/glossterm&gt;
5308 &lt;glossdef&gt;
5309 &lt;para&gt;If you can see this, the document was processed incorrectly. Use
5310 the &lt;parameter&gt;glossary.collection&lt;/parameter&gt; parameter.&lt;/para&gt;
5311 &lt;/glossdef&gt;
5312 &lt;/glossentry&gt;
5313 &lt;/glossary&gt;</programlisting>
5314 </informalexample>
5315 </listitem>
5316 </orderedlist>
5317 </refsection>
5318
5319 </refsection>
5320 </refentry>
5321
5322 <refentry version="5.0" xml:id="glossary.as.blocks">
5323 <refmeta>
5324 <refentrytitle>glossary.as.blocks</refentrytitle>
5325 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5326 </refmeta>
5327 <refnamediv>
5328 <refname>glossary.as.blocks</refname>
5329 <refpurpose>Present glossarys using blocks instead of lists?</refpurpose>
5330 </refnamediv>
5331
5332 <refsynopsisdiv>
5333 <programlisting xml:id="glossary.as.blocks.frag">
5334 &lt;xsl:param name="glossary.as.blocks" select="0"&gt;&lt;/xsl:param&gt;
5335 </programlisting>
5336 </refsynopsisdiv>
5337
5338 <refsection><info><title>Description</title></info>
5339
5340 <para>If non-zero, <tag>glossary</tag>s will be formatted as
5341 blocks.</para>
5342
5343 <para>If you have long <tag>glossterm</tag>s, proper list
5344 markup in the FO case may produce unattractive lists. By setting this
5345 parameter, you can force the stylesheets to produce block markup
5346 instead of proper lists.</para>
5347
5348 <para>You can override this setting with a processing instruction as the
5349 child of <tag>glossary</tag>: <tag class="xmlpi">dbfo
5350 glossary-presentation="blocks"</tag> or <tag class="xmlpi">dbfo
5351 glossary-presentation="list"</tag></para>
5352
5353 </refsection>
5354 </refentry>
5355
5356 <refentry version="5.0" xml:id="glosslist.as.blocks">
5357 <refmeta>
5358 <refentrytitle>glosslist.as.blocks</refentrytitle>
5359 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5360 </refmeta>
5361 <refnamediv>
5362 <refname>glosslist.as.blocks</refname>
5363 <refpurpose>Use blocks for glosslists?</refpurpose>
5364 </refnamediv>
5365
5366 <refsynopsisdiv>
5367 <programlisting xml:id="glosslist.as.blocks.frag">
5368 &lt;xsl:param name="glosslist.as.blocks" select="0"&gt;&lt;/xsl:param&gt;
5369 </programlisting>
5370 </refsynopsisdiv>
5371
5372 <refsection><info><title>Description</title></info>
5373
5374 <para>See <parameter>glossary.as.blocks</parameter>.</para>
5375
5376 </refsection>
5377 </refentry>
5378
5379 <refentry version="5.0" xml:id="glossentry.list.item.properties">
5380 <refmeta>
5381 <refentrytitle>glossentry.list.item.properties</refentrytitle>
5382 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
5383 </refmeta>
5384 <refnamediv>
5385 <refname>glossentry.list.item.properties</refname>
5386 <refpurpose>To add properties to each glossentry in a list.</refpurpose>
5387 </refnamediv>
5388
5389 <refsynopsisdiv>
5390 <programlisting xml:id="glossentry.list.item.properties.frag">&lt;xsl:attribute-set name="glossentry.list.item.properties"&gt;
5391   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
5392   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
5393   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
5394 &lt;/xsl:attribute-set&gt;
5395 </programlisting>
5396 </refsynopsisdiv>
5397 <refsection><info><title>Description</title></info>
5398 <para>These properties are added to the fo:list-item containing a
5399 glossentry in a glossary when the <parameter>glossary.as.blocks</parameter> parameter
5400 is zero.
5401 Use this attribute-set to set
5402 spacing between entries, for example.</para>
5403
5404 </refsection>
5405 </refentry>
5406
5407 <refentry version="5.0" xml:id="glossterm.block.properties">
5408 <refmeta>
5409 <refentrytitle>glossterm.block.properties</refentrytitle>
5410 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
5411 </refmeta>
5412 <refnamediv>
5413 <refname>glossterm.block.properties</refname>
5414 <refpurpose>To add properties to the block of a glossentry's glossterm.</refpurpose>
5415 </refnamediv>
5416
5417 <refsynopsisdiv>
5418 <programlisting xml:id="glossterm.block.properties.frag">&lt;xsl:attribute-set name="glossterm.block.properties"&gt;
5419   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
5420   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
5421   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
5422   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
5423   &lt;xsl:attribute name="keep-together.within-column"&gt;always&lt;/xsl:attribute&gt;
5424 &lt;/xsl:attribute-set&gt;
5425 </programlisting>
5426 </refsynopsisdiv>
5427 <refsection><info><title>Description</title></info>
5428 <para>These properties are added to the block containing a
5429 glossary term in a glossary when the <parameter>glossary.as.blocks</parameter> parameter
5430 is non-zero.
5431 Use this attribute-set to set the space above and below,
5432 font properties,
5433 and any indent for the glossary term.</para>
5434
5435 </refsection>
5436 </refentry>
5437
5438 <refentry version="5.0" xml:id="glossdef.block.properties">
5439 <refmeta>
5440 <refentrytitle>glossdef.block.properties</refentrytitle>
5441 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
5442 </refmeta>
5443 <refnamediv>
5444 <refname>glossdef.block.properties</refname>
5445 <refpurpose>To add properties to the block of a glossary definition.</refpurpose>
5446 </refnamediv>
5447
5448 <refsynopsisdiv>
5449 <programlisting xml:id="glossdef.block.properties.frag">&lt;xsl:attribute-set name="glossdef.block.properties"&gt;
5450   &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;.25in&lt;/xsl:attribute&gt;
5451 &lt;/xsl:attribute-set&gt;
5452 </programlisting>
5453 </refsynopsisdiv>
5454 <refsection><info><title>Description</title></info>
5455 <para>These properties are added to the block containing a
5456 glossary definition in a glossary when
5457 the <parameter>glossary.as.blocks</parameter> parameter
5458 is non-zero.
5459 Use this attribute-set to set the space above and below,
5460 any font properties,
5461 and any indent for the glossary definition.</para>
5462
5463 </refsection>
5464 </refentry>
5465
5466 <refentry version="5.0" xml:id="glossterm.list.properties">
5467 <refmeta>
5468 <refentrytitle>glossterm.list.properties</refentrytitle>
5469 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
5470 </refmeta>
5471 <refnamediv>
5472 <refname>glossterm.list.properties</refname>
5473 <refpurpose>To add properties to the glossterm in a list.</refpurpose>
5474 </refnamediv>
5475
5476 <refsynopsisdiv>
5477 <programlisting xml:id="glossterm.list.properties.frag">
5478 &lt;xsl:attribute-set name="glossterm.list.properties"&gt;
5479 &lt;/xsl:attribute-set&gt;
5480 </programlisting>
5481 </refsynopsisdiv>
5482 <refsection><info><title>Description</title></info>
5483 <para>These properties are added to the block containing a
5484 glossary term in a glossary when the <parameter>glossary.as.blocks</parameter> parameter
5485 is zero.
5486 Use this attribute-set to set
5487 font properties, for example.</para>
5488
5489 </refsection>
5490 </refentry>
5491
5492 <refentry version="5.0" xml:id="glossdef.list.properties">
5493 <refmeta>
5494 <refentrytitle>glossdef.list.properties</refentrytitle>
5495 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
5496 </refmeta>
5497 <refnamediv>
5498 <refname>glossdef.list.properties</refname>
5499 <refpurpose>To add properties to the glossary definition in a list.</refpurpose>
5500 </refnamediv>
5501
5502 <refsynopsisdiv>
5503 <programlisting xml:id="glossdef.list.properties.frag">
5504 &lt;xsl:attribute-set name="glossdef.list.properties"&gt;
5505 &lt;/xsl:attribute-set&gt;
5506 </programlisting>
5507 </refsynopsisdiv>
5508 <refsection><info><title>Description</title></info>
5509 <para>These properties are added to the block containing a
5510 glossary definition in a glossary when
5511 the <parameter>glossary.as.blocks</parameter> parameter
5512 is zero.
5513 Use this attribute-set to set font properties, for example.</para>
5514
5515 </refsection>
5516 </refentry>
5517
5518 <refentry version="5.0" xml:id="glossterm.width">
5519 <refmeta>
5520 <refentrytitle>glossterm.width</refentrytitle>
5521 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
5522 </refmeta>
5523 <refnamediv>
5524 <refname>glossterm.width</refname>
5525 <refpurpose>Width of glossterm in list presentation mode</refpurpose>
5526 </refnamediv>
5527
5528 <refsynopsisdiv>
5529 <programlisting xml:id="glossterm.width.frag">
5530 &lt;xsl:param name="glossterm.width"&gt;2in&lt;/xsl:param&gt;
5531 </programlisting>
5532 </refsynopsisdiv>
5533
5534 <refsection><info><title>Description</title></info>
5535
5536 <para>This parameter specifies the width reserved for glossary terms when
5537 a list presentation is used.</para>
5538
5539 </refsection>
5540 </refentry>
5541
5542 <refentry version="5.0" xml:id="glossterm.separation">
5543 <refmeta>
5544 <refentrytitle>glossterm.separation</refentrytitle>
5545 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
5546 </refmeta>
5547 <refnamediv>
5548 <refname>glossterm.separation</refname>
5549 <refpurpose>Separation between glossary terms and descriptions in list mode</refpurpose>
5550 </refnamediv>
5551
5552 <refsynopsisdiv>
5553 <programlisting xml:id="glossterm.separation.frag">
5554 &lt;xsl:param name="glossterm.separation"&gt;0.25in&lt;/xsl:param&gt;
5555 </programlisting>
5556 </refsynopsisdiv>
5557
5558 <refsection><info><title>Description</title></info>
5559
5560 <para>Specifies the miminum horizontal
5561 separation between glossary terms and descriptions when
5562 they are presented side-by-side using lists
5563 when the <parameter>glossary.as.blocks</parameter>
5564 is zero.</para>
5565
5566 </refsection>
5567 </refentry>
5568
5569 <refentry version="5.0" xml:id="glossentry.show.acronym">
5570 <refmeta>
5571 <refentrytitle>glossentry.show.acronym</refentrytitle>
5572 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
5573 <refmiscinfo class="other" otherclass="value">no</refmiscinfo> 
5574 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
5575 <refmiscinfo class="other" otherclass="value">primary</refmiscinfo>
5576 </refmeta>
5577 <refnamediv>
5578 <refname>glossentry.show.acronym</refname>
5579 <refpurpose>Display <tag>glossentry</tag> acronyms?</refpurpose>
5580 </refnamediv>
5581
5582 <refsynopsisdiv>
5583 <programlisting xml:id="glossentry.show.acronym.frag">
5584 &lt;xsl:param name="glossentry.show.acronym"&gt;no&lt;/xsl:param&gt;
5585 </programlisting>
5586 </refsynopsisdiv>
5587
5588 <refsection><info><title>Description</title></info>
5589
5590 <para>A setting of <quote>yes</quote> means they should be displayed;
5591 <quote>no</quote> means they shouldn't. If <quote>primary</quote> is used,
5592 then they are shown as the primary text for the entry.</para>
5593
5594 <note>
5595 <para>This setting controls both <tag>acronym</tag> and
5596 <tag>abbrev</tag> elements in the <tag>glossentry</tag>.</para>
5597 </note>
5598
5599 </refsection>
5600 </refentry>
5601
5602 <refentry version="5.0" xml:id="glossary.sort">
5603 <refmeta>
5604 <refentrytitle>glossary.sort</refentrytitle>
5605 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5606 </refmeta>
5607 <refnamediv>
5608 <refname>glossary.sort</refname>
5609 <refpurpose>Sort glossentry elements?</refpurpose>
5610 </refnamediv>
5611
5612 <refsynopsisdiv>
5613 <programlisting xml:id="glossary.sort.frag">
5614 &lt;xsl:param name="glossary.sort" select="0"&gt;&lt;/xsl:param&gt;
5615 </programlisting>
5616 </refsynopsisdiv>
5617
5618 <refsection><info><title>Description</title></info>
5619
5620 <para>If non-zero, then the glossentry elements within a
5621 glossary, glossdiv, or glosslist are sorted on the glossterm, using
5622 the current lang setting.  If zero (the default), then
5623 glossentry elements are not sorted and are presented
5624 in document order.
5625 </para>
5626
5627 </refsection>
5628 </refentry>
5629
5630 </reference>
5631 <reference xml:id="misc"><title>Miscellaneous</title>
5632 <refentry version="5.0" xml:id="formal.procedures">
5633 <refmeta>
5634 <refentrytitle>formal.procedures</refentrytitle>
5635 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5636 </refmeta>
5637 <refnamediv>
5638 <refname>formal.procedures</refname>
5639 <refpurpose>Selects formal or informal procedures</refpurpose>
5640 </refnamediv>
5641
5642 <refsynopsisdiv>
5643 <programlisting xml:id="formal.procedures.frag">
5644 &lt;xsl:param name="formal.procedures" select="1"&gt;&lt;/xsl:param&gt;
5645 </programlisting>
5646 </refsynopsisdiv>
5647
5648 <refsection><info><title>Description</title></info>
5649
5650 <para>Formal procedures are numbered and always have a title.
5651 </para>
5652
5653 </refsection>
5654 </refentry>
5655
5656 <refentry version="5.0" xml:id="formal.title.placement">
5657 <refmeta>
5658 <refentrytitle>formal.title.placement</refentrytitle>
5659 <refmiscinfo class="other" otherclass="datatype">table</refmiscinfo>
5660 </refmeta>
5661 <refnamediv>
5662 <refname>formal.title.placement</refname>
5663 <refpurpose>Specifies where formal object titles should occur</refpurpose>
5664 </refnamediv>
5665
5666 <refsynopsisdiv>
5667 <programlisting xml:id="formal.title.placement.frag">
5668 &lt;xsl:param name="formal.title.placement"&gt;
5669 figure before
5670 example before
5671 equation before
5672 table before
5673 procedure before
5674 task before
5675 &lt;/xsl:param&gt;
5676 </programlisting>
5677 </refsynopsisdiv>
5678
5679 <refsection><info><title>Description</title></info>
5680
5681 <para>Specifies where formal object titles should occur. For each formal object
5682 type (<tag>figure</tag>,
5683 <tag>example</tag>,
5684 <tag>equation</tag>,
5685 <tag>table</tag>, and <tag>procedure</tag>)
5686 you can specify either the keyword
5687 <quote><literal>before</literal></quote> or
5688 <quote><literal>after</literal></quote>.</para>
5689
5690 </refsection>
5691 </refentry>
5692
5693 <refentry version="5.0" xml:id="runinhead.default.title.end.punct">
5694 <refmeta>
5695 <refentrytitle>runinhead.default.title.end.punct</refentrytitle>
5696 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
5697 </refmeta>
5698 <refnamediv>
5699 <refname>runinhead.default.title.end.punct</refname>
5700 <refpurpose>Default punctuation character on a run-in-head</refpurpose>
5701 </refnamediv>
5702
5703 <refsynopsisdiv>
5704 <programlisting xml:id="runinhead.default.title.end.punct.frag">&lt;xsl:param name="runinhead.default.title.end.punct"&gt;.&lt;/xsl:param&gt;
5705 </programlisting>
5706 </refsynopsisdiv>
5707
5708 <refsection><info><title>Description</title></info>
5709
5710 <para>If non-zero, For a <tag>formalpara</tag>, use the specified
5711 string as the separator between the title and following text. The period is the default value.</para>
5712
5713 </refsection>
5714 </refentry>
5715
5716 <refentry version="5.0" xml:id="runinhead.title.end.punct">
5717 <refmeta>
5718 <refentrytitle>runinhead.title.end.punct</refentrytitle>
5719 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
5720 </refmeta>
5721 <refnamediv>
5722 <refname>runinhead.title.end.punct</refname>
5723 <refpurpose>Characters that count as punctuation on a run-in-head</refpurpose>
5724 </refnamediv>
5725
5726 <refsynopsisdiv>
5727 <programlisting xml:id="runinhead.title.end.punct.frag">
5728 &lt;xsl:param name="runinhead.title.end.punct"&gt;.!?:&lt;/xsl:param&gt;
5729 </programlisting>
5730 </refsynopsisdiv>
5731
5732 <refsection><info><title>Description</title></info>
5733
5734 <para>Specify which characters are to be counted as punctuation. These
5735 characters are checked for a match with the last character of the
5736 title. If no match is found, the
5737 <parameter>runinhead.default.title.end.punct</parameter> contents are
5738 inserted. This is to avoid duplicated punctuation in the output.
5739 </para>
5740
5741 </refsection>
5742 </refentry>
5743
5744 <refentry version="5.0" xml:id="show.comments">
5745 <refmeta>
5746 <refentrytitle>show.comments</refentrytitle>
5747 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5748 </refmeta>
5749 <refnamediv>
5750 <refname>show.comments</refname>
5751 <refpurpose>Display <tag>remark</tag> elements?</refpurpose>
5752 </refnamediv>
5753
5754 <refsynopsisdiv>
5755 <programlisting xml:id="show.comments.frag">
5756 &lt;xsl:param name="show.comments" select="1"&gt;&lt;/xsl:param&gt;
5757 </programlisting>
5758 </refsynopsisdiv>
5759
5760 <refsection><info><title>Description</title></info>
5761
5762 <para>If non-zero, comments will be displayed, otherwise they
5763 are suppressed.  Comments here refers to the <tag>remark</tag> element
5764 (which was called <literal>comment</literal> prior to DocBook
5765 4.0), not XML comments (&lt;-- like this --&gt;) which are
5766 unavailable.
5767 </para>
5768
5769 </refsection>
5770 </refentry>
5771
5772 <refentry version="5.0" xml:id="punct.honorific">
5773 <refmeta>
5774 <refentrytitle>punct.honorific</refentrytitle>
5775 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
5776 </refmeta>
5777 <refnamediv>
5778 <refname>punct.honorific</refname>
5779 <refpurpose>Punctuation after an honorific in a personal name.</refpurpose>
5780 </refnamediv>
5781
5782 <refsynopsisdiv>
5783 <programlisting xml:id="punct.honorific.frag">
5784 &lt;xsl:param name="punct.honorific"&gt;.&lt;/xsl:param&gt;
5785 </programlisting>
5786 </refsynopsisdiv>
5787
5788 <refsection><info><title>Description</title></info>
5789
5790 <para>This parameter specifies the punctuation that should be added after an
5791 honorific in a personal name.</para>
5792
5793 </refsection>
5794 </refentry>
5795
5796 <refentry version="5.0" xml:id="segmentedlist.as.table">
5797 <refmeta>
5798 <refentrytitle>segmentedlist.as.table</refentrytitle>
5799 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5800 </refmeta>
5801 <refnamediv>
5802 <refname>segmentedlist.as.table</refname>
5803 <refpurpose>Format segmented lists as tables?</refpurpose>
5804 </refnamediv>
5805
5806 <refsynopsisdiv>
5807 <programlisting xml:id="segmentedlist.as.table.frag">
5808 &lt;xsl:param name="segmentedlist.as.table" select="0"&gt;&lt;/xsl:param&gt;
5809 </programlisting>
5810 </refsynopsisdiv>
5811
5812 <refsection><info><title>Description</title></info>
5813
5814 <para>If non-zero, <tag>segmentedlist</tag>s will be formatted as
5815 tables.</para>
5816
5817 </refsection>
5818 </refentry>
5819
5820 <refentry version="5.0" xml:id="variablelist.as.blocks">
5821 <refmeta>
5822 <refentrytitle>variablelist.as.blocks</refentrytitle>
5823 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5824 </refmeta>
5825 <refnamediv>
5826 <refname>variablelist.as.blocks</refname>
5827 <refpurpose>Format <tag>variablelist</tag>s lists as blocks?</refpurpose>
5828 </refnamediv>
5829
5830 <refsynopsisdiv>
5831 <programlisting xml:id="variablelist.as.blocks.frag">
5832 &lt;xsl:param name="variablelist.as.blocks" select="0"&gt;&lt;/xsl:param&gt;
5833 </programlisting>
5834 </refsynopsisdiv>
5835
5836 <refsection><info><title>Description</title></info>
5837
5838 <para>If non-zero, <tag>variablelist</tag>s will be formatted as
5839 blocks.</para>
5840
5841 <para>If you have long terms, proper list markup in the FO case may produce
5842 unattractive lists. By setting this parameter, you can force the stylesheets
5843 to produce block markup instead of proper lists.</para>
5844
5845 <para>You can override this setting with a processing instruction as the
5846 child of <tag>variablelist</tag>: <tag class="xmlpi">dbfo
5847 list-presentation="blocks"</tag> or <tag class="xmlpi">dbfo
5848 list-presentation="list"</tag>.</para>
5849
5850 <para>When using <literal>list-presentation="list"</literal>,
5851 you can also control the amount of space used for the <tag>term</tag>s with 
5852 the <tag class="xmlpi">dbfo term-width=".25in"</tag> processing instruction,
5853 the <tag class="attribute">termlength</tag> attribute on <tag>variablelist</tag>,
5854 or allow the stylesheets to attempt to calculate the amount of space to leave based on the 
5855 number of letters in the longest term.  
5856 </para>
5857
5858 <programlisting>  &lt;variablelist&gt;
5859         &lt;?dbfo list-presentation="list"?&gt;
5860         &lt;?dbfo term-width="1.5in"?&gt;
5861         &lt;?dbhtml list-presentation="table"?&gt;
5862         &lt;?dbhtml term-width="1.5in"?&gt;
5863         &lt;varlistentry&gt;
5864           &lt;term&gt;list&lt;/term&gt;
5865           &lt;listitem&gt;
5866                 &lt;para&gt;
5867                   Formatted as a list even if variablelist.as.blocks is set to 1.
5868                 &lt;/para&gt;
5869           &lt;/listitem&gt;
5870         &lt;/varlistentry&gt;
5871   &lt;/variablelist&gt;</programlisting>
5872
5873
5874 </refsection>
5875
5876 </refentry>
5877
5878 <refentry version="5.0" xml:id="blockquote.properties">
5879 <refmeta>
5880   <refentrytitle>blockquote.properties</refentrytitle>
5881   <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
5882 </refmeta>  
5883 <refnamediv>
5884 <refname>blockquote.properties</refname>
5885 <refpurpose>To set the style for block quotations.</refpurpose>
5886 </refnamediv>
5887
5888 <refsynopsisdiv>
5889 <programlisting xml:id="blockquote.properties.frag">
5890 &lt;xsl:attribute-set name="blockquote.properties"&gt;
5891 &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;0.5in&lt;/xsl:attribute&gt;
5892 &lt;xsl:attribute name="margin-{$direction.align.end}"&gt;0.5in&lt;/xsl:attribute&gt;
5893 &lt;xsl:attribute name="space-after.minimum"&gt;0.5em&lt;/xsl:attribute&gt;
5894 &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;
5895 &lt;xsl:attribute name="space-after.maximum"&gt;2em&lt;/xsl:attribute&gt;
5896 &lt;/xsl:attribute-set&gt;
5897 </programlisting>
5898 </refsynopsisdiv>
5899
5900 <refsection><info><title>Description</title></info>
5901
5902 <para>The <parameter>blockquote.properties</parameter> attribute set specifies
5903 the formating properties of block quotations.</para>
5904
5905 </refsection>
5906 </refentry>
5907
5908 <refentry version="5.0" xml:id="ulink.show">
5909 <refmeta>
5910 <refentrytitle>ulink.show</refentrytitle>
5911 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5912 </refmeta>
5913 <refnamediv>
5914 <refname>ulink.show</refname>
5915 <refpurpose>Display URLs after <tag>ulink</tag>s?</refpurpose>
5916 </refnamediv>
5917
5918 <refsynopsisdiv>
5919 <programlisting xml:id="ulink.show.frag">
5920 &lt;xsl:param name="ulink.show" select="1"&gt;&lt;/xsl:param&gt;
5921 </programlisting>
5922 </refsynopsisdiv>
5923
5924 <refsection><info><title>Description</title></info>
5925
5926 <para>If non-zero, the URL of each <tag>ulink</tag> will
5927 appear after the text of the link. If the text of the link and the URL
5928 are identical, the URL is suppressed. </para>
5929
5930 <para>See also <parameter>ulink.footnotes</parameter>.</para>
5931
5932 <note><para>DocBook 5 does not have an <tag>ulink</tag> element. When processing 
5933 DocBoook 5 documents, <parameter>ulink.show</parameter> applies to all inline 
5934 elements that are marked up with <tag class="attribute">xlink:href</tag> attributes 
5935 that point to external resources.</para>
5936 </note>
5937
5938 </refsection>
5939 </refentry>
5940
5941 <refentry version="5.0" xml:id="ulink.footnotes">
5942 <refmeta>
5943 <refentrytitle>ulink.footnotes</refentrytitle>
5944 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
5945 </refmeta>
5946 <refnamediv>
5947 <refname>ulink.footnotes</refname>
5948 <refpurpose>Generate footnotes for <tag>ulink</tag>s?</refpurpose>
5949 </refnamediv>
5950
5951 <refsynopsisdiv>
5952 <programlisting xml:id="ulink.footnotes.frag">
5953 &lt;xsl:param name="ulink.footnotes" select="0"&gt;&lt;/xsl:param&gt;
5954 </programlisting>
5955 </refsynopsisdiv>
5956
5957 <refsection><info><title>Description</title></info>
5958
5959 <para>If non-zero, and if <parameter>ulink.show</parameter> also is non-zero,
5960 the URL of each <tag>ulink</tag> will appear as a footnote.</para>
5961
5962 <note><para>DocBook 5 does not have an <tag>ulink</tag> element. When processing 
5963 DocBoook 5 documents, <parameter>ulink.footnotes</parameter> applies to all inline 
5964 elements that are marked up with <tag class="attribute">xlink:href</tag> attributes 
5965 that point to external resources.</para>
5966 </note>
5967
5968 </refsection>
5969 </refentry>
5970
5971 <refentry version="5.0" xml:id="ulink.hyphenate">
5972 <refmeta>
5973 <refentrytitle>ulink.hyphenate</refentrytitle>
5974 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
5975 </refmeta>
5976 <refnamediv>
5977 <refname>ulink.hyphenate</refname>
5978 <refpurpose>Allow URLs to be automatically hyphenated</refpurpose>
5979 </refnamediv>
5980
5981 <refsynopsisdiv>
5982 <programlisting xml:id="ulink.hyphenate.frag">
5983 &lt;xsl:param name="ulink.hyphenate"&gt;&lt;/xsl:param&gt;
5984 </programlisting>
5985 </refsynopsisdiv>
5986
5987 <refsection><info><title>Description</title></info>
5988
5989 <para>If not empty, the specified character (or more generally, content) is
5990 added to URLs after every character included in the string
5991 in the <parameter>ulink.hyphenate.chars</parameter> parameter (default
5992 is <quote>/</quote>). If the character in this parameter is a
5993 Unicode soft hyphen (0x00AD) or Unicode zero-width space (0x200B), some FO
5994 processors will be able to reasonably hyphenate long URLs.</para>
5995
5996 <para>As of 28 Jan 2002, discretionary hyphens are more widely and correctly
5997 supported than zero-width spaces for this purpose.</para>
5998
5999 </refsection>
6000 </refentry>
6001
6002 <refentry version="5.0" xml:id="ulink.hyphenate.chars">
6003 <refmeta>
6004 <refentrytitle>ulink.hyphenate.chars</refentrytitle>
6005 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6006 </refmeta>
6007 <refnamediv>
6008 <refname>ulink.hyphenate.chars</refname>
6009 <refpurpose>List of characters to allow ulink URLs to be automatically hyphenated on</refpurpose>
6010 </refnamediv>
6011
6012 <refsynopsisdiv>
6013 <programlisting xml:id="ulink.hyphenate.chars.frag">
6014 &lt;xsl:param name="ulink.hyphenate.chars"&gt;/&lt;/xsl:param&gt;
6015 </programlisting>
6016 </refsynopsisdiv>
6017
6018 <refsection><info><title>Description</title></info>
6019
6020 <para>If the <parameter>ulink.hyphenate</parameter> is not empty, then 
6021 hyphenation of ulinks is turned on, and any
6022 character contained in this parameter is treated as an allowable
6023 hyphenation point.</para>
6024
6025 <para>The default value is <quote>/</quote>, but the parameter
6026 could be customized
6027 to contain other URL characters, as for example:</para>
6028 <programlisting>
6029 &lt;xsl:param name="ulink.hyphenate.chars"&gt;:/@&amp;?.#&lt;/xsl:param&gt;
6030 </programlisting>
6031
6032 </refsection>
6033 </refentry>
6034
6035 <refentry version="5.0" xml:id="shade.verbatim">
6036 <refmeta>
6037 <refentrytitle>shade.verbatim</refentrytitle>
6038 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6039 </refmeta>
6040 <refnamediv>
6041 <refname>shade.verbatim</refname>
6042 <refpurpose>Should verbatim environments be shaded?</refpurpose>
6043 </refnamediv>
6044
6045 <refsynopsisdiv>
6046 <programlisting xml:id="shade.verbatim.frag">&lt;xsl:param name="shade.verbatim" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
6047 </refsynopsisdiv>
6048
6049 <refsection><info><title>Description</title></info>
6050
6051 <para>In the FO stylesheet, if this parameter is non-zero then the
6052 <property>shade.verbatim.style</property> properties will be applied
6053 to verbatim environments.</para>
6054
6055 <para>In the HTML stylesheet, this parameter is now deprecated. Use
6056 CSS instead.</para>
6057
6058 </refsection>
6059 </refentry>
6060
6061 <refentry version="5.0" xml:id="shade.verbatim.style">
6062 <refmeta>
6063 <refentrytitle>shade.verbatim.style</refentrytitle>
6064 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
6065 </refmeta>
6066 <refnamediv>
6067 <refname>shade.verbatim.style</refname>
6068 <refpurpose>Properties that specify the style of shaded verbatim listings</refpurpose>
6069 </refnamediv>
6070
6071 <refsynopsisdiv>
6072 <programlisting xml:id="shade.verbatim.style.frag">
6073
6074 &lt;xsl:attribute-set name="shade.verbatim.style"&gt;
6075   &lt;xsl:attribute name="background-color"&gt;#E0E0E0&lt;/xsl:attribute&gt;
6076 &lt;/xsl:attribute-set&gt;
6077 </programlisting>
6078 </refsynopsisdiv>
6079
6080 <refsection><info><title>Description</title></info>
6081
6082 <para>Properties that specify the style of shaded verbatim listings. The
6083 parameters specified (the border and background color) are added to
6084 the styling of the xsl-fo output. A border might be specified as "thin
6085 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>
6086
6087 </refsection>
6088 </refentry>
6089
6090 <refentry version="5.0" xml:id="hyphenate.verbatim">
6091 <refmeta>
6092 <refentrytitle>hyphenate.verbatim</refentrytitle>
6093 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6094 </refmeta>
6095 <refnamediv>
6096 <refname>hyphenate.verbatim</refname>
6097 <refpurpose>Should verbatim environments be hyphenated on space characters?</refpurpose>
6098 </refnamediv>
6099
6100 <refsynopsisdiv>
6101 <programlisting xml:id="hyphenate.verbatim.frag">&lt;xsl:param name="hyphenate.verbatim" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
6102 </refsynopsisdiv>
6103
6104 <refsection><info><title>Description</title></info>
6105
6106 <para>If the lines of program listing are too long to fit into one
6107 line it is quite common to split them at space and indicite by hook
6108 arrow that code continues on the next line. You can turn on this
6109 behaviour for <tag>programlisting</tag>,
6110 <tag>screen</tag> and <tag>synopsis</tag> elements by
6111 using this parameter.</para>
6112
6113 <para>Note that you must also enable line wrapping for verbatim environments and
6114 select appropriate hyphenation character (e.g. hook arrow). This can
6115 be done using <parameter>monospace.verbatim.properties</parameter>
6116 attribute set:</para>
6117
6118 <programlisting>&lt;xsl:attribute-set name="monospace.verbatim.properties" 
6119                    use-attribute-sets="verbatim.properties monospace.properties"&gt;
6120   &lt;xsl:attribute name="wrap-option"&gt;wrap&lt;/xsl:attribute&gt;
6121   &lt;xsl:attribute name="hyphenation-character"&gt;&amp;#x25BA;&lt;/xsl:attribute&gt;
6122 &lt;/xsl:attribute-set&gt;</programlisting>
6123
6124 <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
6125 selected character is available in the font you are using for verbatim
6126 environments.</para>
6127
6128 </refsection>
6129 </refentry>
6130
6131 <refentry version="5.0" xml:id="hyphenate.verbatim.characters">
6132 <refmeta>
6133 <refentrytitle>hyphenate.verbatim.characters</refentrytitle>
6134 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6135 </refmeta>
6136 <refnamediv>
6137 <refname>hyphenate.verbatim.characters</refname>
6138 <refpurpose>List of characters after which a line break can occur in listings</refpurpose>
6139 </refnamediv>
6140
6141 <refsynopsisdiv>
6142 <programlisting xml:id="hyphenate.verbatim.characters.frag">
6143 &lt;xsl:param name="hyphenate.verbatim.characters"&gt;&lt;/xsl:param&gt;
6144 </programlisting>
6145 </refsynopsisdiv>
6146
6147 <refsection><info><title>Description</title></info>
6148
6149 <para>If you enable <parameter>hyphenate.verbatim</parameter> line
6150 breaks are allowed only on space characters. If this is not enough for
6151 your document, you can specify list of additional characters after
6152 which line break is allowed in this parameter.</para>
6153
6154 </refsection>
6155 </refentry>
6156
6157 <refentry version="5.0" xml:id="use.svg">
6158 <refmeta>
6159 <refentrytitle>use.svg</refentrytitle>
6160 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6161 </refmeta>
6162 <refnamediv>
6163 <refname>use.svg</refname>
6164 <refpurpose>Allow SVG in the result tree?</refpurpose>
6165 </refnamediv>
6166
6167 <refsynopsisdiv>
6168 <programlisting xml:id="use.svg.frag">
6169 &lt;xsl:param name="use.svg" select="1"&gt;&lt;/xsl:param&gt;
6170 </programlisting>
6171 </refsynopsisdiv>
6172
6173 <refsection><info><title>Description</title></info>
6174
6175 <para>If non-zero, SVG will be considered an acceptable image format. SVG
6176 is passed through to the result tree, so correct rendering of the resulting
6177 diagram depends on the formatter (FO processor or web browser) that is used
6178 to process the output from the stylesheet.</para>
6179
6180 </refsection>
6181 </refentry>
6182
6183 <refentry version="5.0" xml:id="use.role.as.xrefstyle">
6184 <refmeta>
6185 <refentrytitle>use.role.as.xrefstyle</refentrytitle>
6186 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6187 </refmeta>
6188 <refnamediv>
6189 <refname>use.role.as.xrefstyle</refname>
6190 <refpurpose>Use <tag class="attribute">role</tag> attribute for
6191 <tag class="attribute">xrefstyle</tag> on <tag>xref</tag>?</refpurpose>
6192 </refnamediv>
6193
6194 <refsynopsisdiv>
6195 <programlisting xml:id="use.role.as.xrefstyle.frag">
6196 &lt;xsl:param name="use.role.as.xrefstyle" select="1"&gt;&lt;/xsl:param&gt;
6197 </programlisting>
6198 </refsynopsisdiv>
6199
6200 <refsection><info><title>Description</title></info>
6201
6202 <para>In DocBook documents that conform to a schema older than V4.3, this parameter allows 
6203 <tag class="attribute">role</tag> to serve the purpose of specifying the cross reference style.</para>
6204
6205 <para>If non-zero, the <tag class="attribute">role</tag> attribute on
6206 <tag>xref</tag> will be used to select the cross reference style.
6207 In DocBook V4.3, the <tag class="attribute">xrefstyle</tag> attribute was added for this purpose.
6208 If the <tag class="attribute">xrefstyle</tag> attribute is present, 
6209 <tag class="attribute">role</tag> will be ignored, regardless of the setting
6210 of this parameter.</para>
6211
6212 </refsection>
6213
6214 <refsection><info><title>Example</title></info>
6215
6216 <para>The following small stylesheet shows how to configure the
6217 stylesheets to make use of the cross reference style:</para>
6218
6219 <programlisting>&lt;?xml version="1.0"?&gt;
6220 &lt;xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
6221                 version="1.0"&gt;
6222
6223 &lt;xsl:import href="../xsl/html/docbook.xsl"/&gt;
6224
6225 &lt;xsl:output method="html"/&gt;
6226
6227 &lt;xsl:param name="local.l10n.xml" select="document('')"/&gt;
6228 &lt;l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0"&gt;
6229   &lt;l:l10n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" language="en"&gt;
6230    &lt;l:context name="xref"&gt;
6231       &lt;l:template name="chapter" style="title" text="Chapter %n, %t"/&gt;
6232       &lt;l:template name="chapter" text="Chapter %n"/&gt;
6233     &lt;/l:context&gt;
6234   &lt;/l:l10n&gt;
6235 &lt;/l:i18n&gt;
6236
6237 &lt;/xsl:stylesheet&gt;</programlisting>
6238
6239 <para>With this stylesheet, the cross references in the following document:</para>
6240
6241 <programlisting>&lt;?xml version="1.0" encoding="utf-8"?&gt;
6242 &lt;!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
6243                   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"&gt;
6244 &lt;book id="book"&gt;&lt;title&gt;Book&lt;/title&gt;
6245
6246 &lt;preface&gt;
6247 &lt;title&gt;Preface&lt;/title&gt;
6248
6249 &lt;para&gt;Normal: &lt;xref linkend="ch1"/&gt;.&lt;/para&gt;
6250 &lt;para&gt;Title: &lt;xref xrefstyle="title" linkend="ch1"/&gt;.&lt;/para&gt;
6251
6252 &lt;/preface&gt;
6253
6254 &lt;chapter id="ch1"&gt;
6255 &lt;title&gt;First Chapter&lt;/title&gt;
6256
6257 &lt;para&gt;Irrelevant.&lt;/para&gt;
6258
6259 &lt;/chapter&gt;
6260 &lt;/book&gt;</programlisting>
6261
6262 <para>will appear as:</para>
6263
6264 <informalexample>
6265 <para>Normal: Chapter 1.</para>
6266 <para>Title: Chapter 1, <emphasis>First Chapter</emphasis>.</para>
6267 </informalexample>
6268 </refsection>
6269
6270 </refentry>
6271
6272 <refentry version="5.0" xml:id="menuchoice.separator">
6273 <refmeta>
6274 <refentrytitle>menuchoice.separator</refentrytitle>
6275 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6276 </refmeta>
6277 <refnamediv>
6278 <refname>menuchoice.separator</refname>
6279 <refpurpose>Separator between items of a <tag>menuchoice</tag>
6280 other than <tag>guimenuitem</tag> and
6281 <tag>guisubmenu</tag></refpurpose>
6282 </refnamediv>
6283
6284 <refsynopsisdiv>
6285 <programlisting xml:id="menuchoice.separator.frag">
6286 &lt;xsl:param name="menuchoice.separator"&gt;+&lt;/xsl:param&gt;
6287 </programlisting>
6288 </refsynopsisdiv>
6289
6290 <refsection><info><title>Description</title></info>
6291
6292 <para>Separator used to connect items of a <tag>menuchoice</tag> other
6293 than <tag>guimenuitem</tag> and <tag>guisubmenu</tag>. The latter
6294 elements are linked with <parameter>menuchoice.menu.separator</parameter>.
6295 </para>
6296
6297 </refsection>
6298 </refentry>
6299
6300 <refentry version="5.0" xml:id="menuchoice.menu.separator">
6301 <refmeta>
6302 <refentrytitle>menuchoice.menu.separator</refentrytitle>
6303 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6304 </refmeta>
6305 <refnamediv>
6306 <refname>menuchoice.menu.separator</refname>
6307 <refpurpose>Separator between items of a <tag>menuchoice</tag>
6308 with <tag>guimenuitem</tag> or
6309 <tag>guisubmenu</tag></refpurpose>
6310 </refnamediv>
6311
6312 <refsynopsisdiv>
6313 <programlisting xml:id="menuchoice.menu.separator.frag">
6314 &lt;xsl:param name="menuchoice.menu.separator"&gt; &#8594; &lt;/xsl:param&gt;
6315 </programlisting>
6316 </refsynopsisdiv>
6317
6318 <refsection><info><title>Description</title></info>
6319
6320 <para>Separator used to connect items of a <tag>menuchoice</tag> with
6321 <tag>guimenuitem</tag> or <tag>guisubmenu</tag>. Other elements
6322 are linked with <parameter>menuchoice.separator</parameter>.
6323 </para>
6324 <para>The default value is &amp;#x2192;, which is the
6325 &amp;rarr; (right arrow) character entity.  
6326 The current FOP (0.20.5) requires setting the font-family
6327 explicitly.
6328 </para>
6329 <para>The default value also includes spaces around the arrow,
6330 which will allow a line to break.  Replace the spaces with
6331 &amp;#xA0; (nonbreaking space) if you don't want those
6332 spaces to break.
6333 </para>
6334
6335 </refsection>
6336 </refentry>
6337
6338 <refentry version="5.0" xml:id="default.float.class">
6339 <refmeta>
6340 <refentrytitle>default.float.class</refentrytitle>
6341 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6342 </refmeta>
6343 <refnamediv>
6344 <refname>default.float.class</refname>
6345 <refpurpose>Specifies the default float class</refpurpose>
6346 </refnamediv>
6347
6348 <refsynopsisdiv>
6349 <programlisting xml:id="default.float.class.frag">
6350 &lt;xsl:param name="default.float.class"&gt;
6351   &lt;xsl:choose&gt;
6352     &lt;xsl:when test="contains($stylesheet.result.type,'html')"&gt;left&lt;/xsl:when&gt;
6353     &lt;xsl:otherwise&gt;before&lt;/xsl:otherwise&gt;
6354   &lt;/xsl:choose&gt;
6355 &lt;/xsl:param&gt;
6356 </programlisting>
6357 </refsynopsisdiv>
6358
6359 <refsection><info><title>Description</title></info>
6360
6361 <para>Selects the direction in which a float should be placed. for
6362 xsl-fo this is before, for html it is left. For Western texts, the
6363 before direction is the top of the page.</para>
6364
6365 </refsection>
6366 </refentry>
6367
6368 <refentry version="5.0" xml:id="footnote.number.format">
6369 <refmeta>
6370 <refentrytitle>footnote.number.format</refentrytitle>
6371 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
6372 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>
6373 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>
6374 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>
6375 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>
6376 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>
6377 </refmeta>
6378 <refnamediv>
6379 <refname>footnote.number.format</refname>
6380 <refpurpose>Identifies the format used for footnote numbers</refpurpose>
6381 </refnamediv>
6382
6383 <refsynopsisdiv>
6384 <programlisting xml:id="footnote.number.format.frag">
6385 &lt;xsl:param name="footnote.number.format"&gt;1&lt;/xsl:param&gt;
6386 </programlisting>
6387 </refsynopsisdiv>
6388
6389 <refsection><info><title>Description</title></info>
6390
6391 <para>The <parameter>footnote.number.format</parameter> specifies the format
6392 to use for footnote numeration (1, i, I, a, or A).</para>
6393
6394 </refsection>
6395 </refentry>
6396
6397 <refentry version="5.0" xml:id="table.footnote.number.format">
6398 <refmeta>
6399 <refentrytitle>table.footnote.number.format</refentrytitle>
6400 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
6401 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>
6402 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>
6403 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>
6404 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>
6405 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>
6406 </refmeta>
6407 <refnamediv>
6408 <refname>table.footnote.number.format</refname>
6409 <refpurpose>Identifies the format used for footnote numbers in tables</refpurpose>
6410 </refnamediv>
6411
6412 <refsynopsisdiv>
6413 <programlisting xml:id="table.footnote.number.format.frag">
6414 &lt;xsl:param name="table.footnote.number.format"&gt;a&lt;/xsl:param&gt;
6415 </programlisting>
6416 </refsynopsisdiv>
6417
6418 <refsection><info><title>Description</title></info>
6419
6420 <para>The <parameter>table.footnote.number.format</parameter> specifies the format
6421 to use for footnote numeration (1, i, I, a, or A) in tables.</para>
6422
6423 </refsection>
6424 </refentry>
6425
6426 <refentry version="5.0" xml:id="footnote.number.symbols">
6427 <refmeta>
6428 <refentrytitle>footnote.number.symbols</refentrytitle>
6429 <refmiscinfo class="other" otherclass="datatype"/>
6430 </refmeta>
6431 <refnamediv>
6432 <refname>footnote.number.symbols</refname>
6433 <refpurpose>Special characters to use as footnote markers</refpurpose>
6434 </refnamediv>
6435
6436 <refsynopsisdiv>
6437 <programlisting xml:id="footnote.number.symbols.frag">
6438 &lt;xsl:param name="footnote.number.symbols"&gt;&lt;/xsl:param&gt;
6439 </programlisting>
6440 </refsynopsisdiv>
6441
6442 <refsection><info><title>Description</title></info>
6443
6444 <para>If <parameter>footnote.number.symbols</parameter> is not the empty string,
6445 footnotes will use the characters it contains as footnote symbols. For example,
6446 <quote>*&amp;#x2020;&amp;#x2021;&amp;#x25CA;&amp;#x2720;</quote> will identify
6447 footnotes with <quote>*</quote>, <quote>&#8224;</quote>, <quote>&#8225;</quote>,
6448 <quote>&#9674;</quote>, and <quote>&#10016;</quote>. If there are more footnotes
6449 than symbols, the stylesheets will fall back to numbered footnotes using
6450 <parameter>footnote.number.format</parameter>.</para>
6451
6452 <para>The use of symbols for footnotes depends on the ability of your
6453 processor (or browser) to render the symbols you select. Not all systems are
6454 capable of displaying the full range of Unicode characters. If the quoted characters
6455 in the preceding paragraph are not displayed properly, that's a good indicator
6456 that you may have trouble using those symbols for footnotes.</para>
6457
6458 </refsection>
6459 </refentry>
6460
6461 <refentry version="5.0" xml:id="table.footnote.number.symbols">
6462 <refmeta>
6463 <refentrytitle>table.footnote.number.symbols</refentrytitle>
6464 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6465 </refmeta>
6466 <refnamediv>
6467 <refname>table.footnote.number.symbols</refname>
6468 <refpurpose>Special characters to use a footnote markers in tables</refpurpose>
6469 </refnamediv>
6470
6471 <refsynopsisdiv>
6472 <programlisting xml:id="table.footnote.number.symbols.frag">
6473 &lt;xsl:param name="table.footnote.number.symbols"&gt;&lt;/xsl:param&gt;
6474 </programlisting>
6475 </refsynopsisdiv>
6476
6477 <refsection><info><title>Description</title></info>
6478
6479 <para>If <parameter>table.footnote.number.symbols</parameter> is not the empty string,
6480 table footnotes will use the characters it contains as footnote symbols. For example,
6481 <quote>*&amp;#x2020;&amp;#x2021;&amp;#x25CA;&amp;#x2720;</quote> will identify
6482 footnotes with <quote>*</quote>, <quote>&#8224;</quote>, <quote>&#8225;</quote>,
6483 <quote>&#9674;</quote>, and <quote>&#10016;</quote>. If there are more footnotes
6484 than symbols, the stylesheets will fall back to numbered footnotes using
6485 <parameter>table.footnote.number.format</parameter>.</para>
6486
6487 <para>The use of symbols for footnotes depends on the ability of your
6488 processor (or browser) to render the symbols you select. Not all systems are
6489 capable of displaying the full range of Unicode characters. If the quoted characters
6490 in the preceding paragraph are not displayed properly, that's a good indicator
6491 that you may have trouble using those symbols for footnotes.</para>
6492
6493 </refsection>
6494 </refentry>
6495
6496 <refentry version="5.0" xml:id="footnote.properties">
6497 <refmeta>
6498 <refentrytitle>footnote.properties</refentrytitle>
6499 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
6500 </refmeta>  
6501 <refnamediv>
6502 <refname>footnote.properties</refname>
6503 <refpurpose>Properties applied to each footnote body
6504 </refpurpose>
6505 </refnamediv>
6506
6507 <refsynopsisdiv>
6508 <programlisting xml:id="footnote.properties.frag">
6509 &lt;xsl:attribute-set name="footnote.properties"&gt;
6510   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
6511   &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;
6512   &lt;xsl:attribute name="font-weight"&gt;normal&lt;/xsl:attribute&gt;
6513   &lt;xsl:attribute name="font-style"&gt;normal&lt;/xsl:attribute&gt;
6514   &lt;xsl:attribute name="text-align"&gt;&lt;xsl:value-of select="$alignment"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
6515   &lt;xsl:attribute name="start-indent"&gt;0pt&lt;/xsl:attribute&gt;
6516   &lt;xsl:attribute name="text-indent"&gt;0pt&lt;/xsl:attribute&gt;
6517   &lt;xsl:attribute name="hyphenate"&gt;&lt;xsl:value-of select="$hyphenate"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
6518   &lt;xsl:attribute name="wrap-option"&gt;wrap&lt;/xsl:attribute&gt;
6519   &lt;xsl:attribute name="linefeed-treatment"&gt;treat-as-space&lt;/xsl:attribute&gt;
6520 &lt;/xsl:attribute-set&gt;
6521 </programlisting>
6522 </refsynopsisdiv>
6523
6524 <refsection><info><title>Description</title></info>
6525
6526 <para>This attribute set is applied to the footnote-block 
6527 for each footnote.
6528 It can be used to set the
6529 font-size, font-family, and other inheritable properties that will be
6530 applied to all footnotes.</para>
6531
6532 </refsection>
6533 </refentry>
6534
6535 <refentry version="5.0" xml:id="table.footnote.properties">
6536 <refmeta>
6537 <refentrytitle>table.footnote.properties</refentrytitle>
6538 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
6539 </refmeta>
6540 <refnamediv>
6541 <refname>table.footnote.properties</refname>
6542 <refpurpose>Properties applied to each table footnote body
6543 </refpurpose>
6544 </refnamediv>
6545
6546 <refsynopsisdiv>
6547 <programlisting xml:id="table.footnote.properties.frag">
6548 &lt;xsl:attribute-set name="table.footnote.properties"&gt;
6549   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
6550   &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;
6551   &lt;xsl:attribute name="font-weight"&gt;normal&lt;/xsl:attribute&gt;
6552   &lt;xsl:attribute name="font-style"&gt;normal&lt;/xsl:attribute&gt;
6553   &lt;xsl:attribute name="space-before"&gt;2pt&lt;/xsl:attribute&gt;
6554   &lt;xsl:attribute name="text-align"&gt;&lt;xsl:value-of select="$alignment"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
6555 &lt;/xsl:attribute-set&gt;
6556 </programlisting>
6557 </refsynopsisdiv>
6558
6559 <refsection><info><title>Description</title></info>
6560
6561 <para>This attribute set is applied to the footnote-block 
6562 for each table footnote.
6563 It can be used to set the
6564 font-size, font-family, and other inheritable properties that will be
6565 applied to all table footnotes.</para>
6566
6567 </refsection>
6568 </refentry>
6569
6570 <refentry version="5.0" xml:id="footnote.mark.properties">
6571 <refmeta>
6572 <refentrytitle>footnote.mark.properties</refentrytitle>
6573 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
6574 </refmeta>  
6575 <refnamediv>
6576 <refname>footnote.mark.properties</refname>
6577 <refpurpose>Properties applied to each footnote mark
6578 </refpurpose>
6579 </refnamediv>
6580
6581 <refsynopsisdiv>
6582 <programlisting xml:id="footnote.mark.properties.frag">
6583 &lt;xsl:attribute-set name="footnote.mark.properties"&gt;
6584   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
6585   &lt;xsl:attribute name="font-size"&gt;75%&lt;/xsl:attribute&gt;
6586   &lt;xsl:attribute name="font-weight"&gt;normal&lt;/xsl:attribute&gt;
6587   &lt;xsl:attribute name="font-style"&gt;normal&lt;/xsl:attribute&gt;
6588 &lt;/xsl:attribute-set&gt;
6589 </programlisting>
6590 </refsynopsisdiv>
6591
6592 <refsection><info><title>Description</title></info>
6593
6594 <para>This attribute set is applied to the footnote mark used
6595 for each footnote.
6596 It should contain only inline properties.
6597 </para>
6598
6599 <para>The property to make the mark a superscript is contained in the
6600 footnote template itself, because the current version of FOP reports
6601 an error if baseline-shift is used.
6602 </para>
6603
6604 </refsection>
6605 </refentry>
6606
6607 <refentry version="5.0" xml:id="footnote.sep.leader.properties">
6608 <refmeta>
6609 <refentrytitle>footnote.sep.leader.properties</refentrytitle>
6610 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
6611 </refmeta>
6612 <refnamediv>
6613 <refname>footnote.sep.leader.properties</refname>
6614 <refpurpose>Properties associated with footnote separators</refpurpose>
6615 </refnamediv>
6616
6617 <refsynopsisdiv>
6618 <programlisting xml:id="footnote.sep.leader.properties.frag">
6619 &lt;xsl:attribute-set name="footnote.sep.leader.properties"&gt;
6620   &lt;xsl:attribute name="color"&gt;black&lt;/xsl:attribute&gt;
6621   &lt;xsl:attribute name="leader-pattern"&gt;rule&lt;/xsl:attribute&gt;
6622   &lt;xsl:attribute name="leader-length"&gt;1in&lt;/xsl:attribute&gt;
6623 &lt;/xsl:attribute-set&gt;
6624 </programlisting>
6625 </refsynopsisdiv>
6626
6627 <refsection><info><title>Description</title></info>
6628
6629 <para>The styling for the rule line that separates the
6630 footnotes from the body text.
6631 These are properties applied to the fo:leader used as
6632 the separator.
6633 </para>
6634 <para>If you want to do more than just set properties on
6635 the leader element, then you can customize the template
6636 named <literal>footnote.separator</literal> in 
6637 <filename>fo/pagesetup.xsl</filename>.</para>
6638
6639 </refsection>
6640 </refentry>
6641
6642 <refentry version="5.0" xml:id="xref.with.number.and.title">
6643 <refmeta>
6644 <refentrytitle>xref.with.number.and.title</refentrytitle>
6645 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6646 </refmeta>
6647 <refnamediv>
6648 <refname>xref.with.number.and.title</refname>
6649 <refpurpose>Use number and title in cross references</refpurpose>
6650 </refnamediv>
6651
6652 <refsynopsisdiv>
6653 <programlisting xml:id="xref.with.number.and.title.frag">
6654 &lt;xsl:param name="xref.with.number.and.title" select="1"&gt;&lt;/xsl:param&gt;
6655 </programlisting>
6656 </refsynopsisdiv>
6657
6658 <refsection><info><title>Description</title></info>
6659
6660 <para>A cross reference may include the number (for example, the number of
6661 an example or figure) and the <tag>title</tag> which is a required child of some
6662 targets. This parameter inserts both the relevant number as well as
6663 the title into the link. </para>
6664
6665 </refsection>
6666 </refentry>
6667
6668 <refentry version="5.0" xml:id="superscript.properties">
6669 <refmeta>
6670 <refentrytitle>superscript.properties</refentrytitle>
6671 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
6672 </refmeta>
6673 <refnamediv>
6674 <refname>superscript.properties</refname>
6675 <refpurpose>Properties associated with superscripts</refpurpose>
6676 </refnamediv>
6677
6678 <refsynopsisdiv>
6679 <programlisting xml:id="superscript.properties.frag">
6680 &lt;xsl:attribute-set name="superscript.properties"&gt;
6681   &lt;xsl:attribute name="font-size"&gt;75%&lt;/xsl:attribute&gt;
6682 &lt;/xsl:attribute-set&gt;
6683 </programlisting>
6684 </refsynopsisdiv>
6685
6686 <refsection><info><title>Description</title></info>
6687
6688 <para>Specifies styling properties for superscripts.</para>
6689
6690 </refsection>
6691 </refentry>
6692
6693 <refentry version="5.0" xml:id="subscript.properties">
6694 <refmeta>
6695 <refentrytitle>subscript.properties</refentrytitle>
6696 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
6697 </refmeta>
6698 <refnamediv>
6699 <refname>subscript.properties</refname>
6700 <refpurpose>Properties associated with subscripts</refpurpose>
6701 </refnamediv>
6702
6703 <refsynopsisdiv>
6704 <programlisting xml:id="subscript.properties.frag">
6705 &lt;xsl:attribute-set name="subscript.properties"&gt;
6706   &lt;xsl:attribute name="font-size"&gt;75%&lt;/xsl:attribute&gt;
6707 &lt;/xsl:attribute-set&gt;
6708 </programlisting>
6709 </refsynopsisdiv>
6710
6711 <refsection><info><title>Description</title></info>
6712
6713 <para>Specifies styling properties for subscripts.</para>
6714
6715 </refsection>
6716 </refentry>
6717
6718 <refentry version="5.0" xml:id="pgwide.properties">
6719 <refmeta>
6720 <refentrytitle>pgwide.properties</refentrytitle>
6721 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
6722 </refmeta>
6723 <refnamediv>
6724 <refname>pgwide.properties</refname>
6725 <refpurpose>Properties to make a figure or table page wide.
6726 </refpurpose>
6727 </refnamediv>
6728
6729 <refsynopsisdiv>
6730 <programlisting xml:id="pgwide.properties.frag">
6731 &lt;xsl:attribute-set name="pgwide.properties"&gt;
6732   &lt;xsl:attribute name="start-indent"&gt;0pt&lt;/xsl:attribute&gt;
6733 &lt;/xsl:attribute-set&gt;
6734 </programlisting>
6735 </refsynopsisdiv>
6736
6737 <refsection><info><title>Description</title></info>
6738
6739 <para>This attribute set is used to set the properties
6740 that make a figure or table "page wide" in fo output.
6741 It comes into effect when an attribute <literal>pgwide="1"</literal>
6742 is used.
6743 </para>
6744
6745 <para>
6746 By default, it sets <parameter>start-indent</parameter>
6747 to <literal>0pt</literal>.
6748 In a stylesheet that sets the parameter
6749 <parameter>body.start.indent</parameter>
6750 to a non-zero value in order to indent body text,
6751 this attribute set can be used to outdent pgwide
6752 figures to the start margin.
6753 </para>
6754
6755 <para>If a document uses a multi-column page layout,
6756 then this attribute set could try setting <parameter>span</parameter>
6757 to a value of <literal>all</literal>.  However, this may
6758 not work with some processors because a span property must be on an
6759 fo:block that is a direct child of fo:flow.  It may work in
6760 some processors anyway.
6761 </para>
6762
6763 </refsection>
6764 </refentry>
6765
6766 <refentry version="5.0" xml:id="highlight.source">
6767 <refmeta>
6768 <refentrytitle>highlight.source</refentrytitle>
6769 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6770 </refmeta>
6771 <refnamediv>
6772 <refname>highlight.source</refname>
6773 <refpurpose>Should the content of <tag>programlisting</tag>
6774 be syntactically highlighted?</refpurpose>
6775 </refnamediv>
6776
6777 <refsynopsisdiv>
6778 <programlisting xml:id="highlight.source.frag">
6779 &lt;xsl:param name="highlight.source" select="0"&gt;&lt;/xsl:param&gt;
6780 </programlisting>
6781 </refsynopsisdiv>
6782
6783 <refsection><info><title>Description</title></info>
6784
6785 <para>When this parameter is non-zero, the stylesheets will try to do syntax highlighting of the 
6786 content of <tag>programlisting</tag> elements. You specify the language for each programlisting 
6787 by using the <tag class="attribute">language</tag> attribute. The <parameter>highlight.default.language</parameter> 
6788 parameter can be used to specify the language for programlistings without a <tag class="attribute">language</tag> 
6789 attribute. Syntax highlighting also works for <tag>screen</tag> and <tag>synopsis</tag> elements.</para>
6790
6791 <para>The actual highlighting work is done by the XSLTHL extension module. This is an external Java library that has to be 
6792 downloaded separately (see below).</para>
6793
6794 <itemizedlist>
6795 <para>In order to use this extension, you must</para> 
6796
6797 <listitem><para>add <filename>xslthl-2.x.x.jar</filename> to your Java classpath. The latest version is available
6798 from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://sourceforge.net/projects/xslthl">the XSLT syntax highlighting project</link> 
6799 at SourceForge.</para>
6800 </listitem>
6801 <listitem>
6802 <para>use a customization layer in which you import one of the following stylesheet modules: 
6803 <itemizedlist>
6804   <listitem>
6805     <para><filename>html/highlight.xsl</filename>
6806     </para>
6807   </listitem>
6808 <listitem>
6809     <para><filename>xhtml/highlight.xsl</filename>
6810     </para>
6811   </listitem>
6812 <listitem>
6813     <para><filename>xhtml-1_1/highlight.xsl</filename>
6814     </para>
6815   </listitem>
6816 <listitem>
6817     <para><filename>fo/highlight.xsl</filename>
6818     </para>
6819 </listitem>
6820 </itemizedlist>
6821 </para>
6822 </listitem>
6823 <listitem><para>let either the <literal>xslthl.config</literal> Java system property or the
6824 <parameter>highlight.xslthl.config</parameter> parameter point to the configuration file for syntax 
6825 highlighting (using URL syntax). DocBook XSL comes with a ready-to-use configuration file, 
6826 <filename>highlighting/xslthl-config.xml</filename>.</para>
6827 </listitem>
6828 </itemizedlist>
6829
6830 <para>The extension works with Saxon 6.5.x and Xalan-J. (Saxon 8.5 or later is also supported, but since it is 
6831 an XSLT 2.0 processor it is not guaranteed to work with DocBook XSL in all circumstances.)</para>
6832
6833 <para>The following is an example of a Saxon 6 command adapted for syntax highlighting, to be used on Windows:</para>
6834
6835 <informalexample>
6836 <para><command>java -cp c:/Java/saxon.jar;c:/Java/xslthl-2.0.1.jar 
6837 -Dxslthl.config=file:///c:/docbook-xsl/highlighting/xslthl-config.xml com.icl.saxon.StyleSheet 
6838 -o test.html test.xml myhtml.xsl</command></para>
6839 </informalexample>
6840
6841 </refsection>
6842 </refentry>
6843
6844 <refentry version="5.0" xml:id="highlight.xslthl.config">
6845 <refmeta>
6846 <refentrytitle>highlight.xslthl.config</refentrytitle>
6847 <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo>
6848 </refmeta>
6849 <refnamediv>
6850 <refname>highlight.xslthl.config</refname>
6851 <refpurpose>Location of XSLTHL configuration file</refpurpose>
6852 </refnamediv>
6853
6854 <refsynopsisdiv>
6855 <programlisting xml:id="highlight.xslthl.config.frag">
6856 &lt;xsl:param name="highlight.xslthl.config"&gt;&lt;/xsl:param&gt;
6857 </programlisting>
6858 </refsynopsisdiv>
6859
6860 <refsection><info><title>Description</title></info>
6861
6862 <para>This location has precedence over the corresponding Java property.</para>
6863
6864 <para>Please note that usually you have to specify location as URL not
6865 just as a simple path on the local
6866 filesystem. E.g. <filename>file:///home/user/xslthl/my-xslthl-config.xml</filename>.</para>
6867
6868
6869
6870 </refsection>
6871 </refentry>
6872
6873 <refentry version="5.0" xml:id="highlight.default.language">
6874 <refmeta>
6875 <refentrytitle>highlight.default.language</refentrytitle>
6876 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
6877 </refmeta>
6878 <refnamediv>
6879 <refname>highlight.default.language</refname>
6880 <refpurpose>Default language of programlisting</refpurpose>
6881 </refnamediv>
6882
6883 <refsynopsisdiv>
6884 <programlisting xml:id="highlight.default.language.frag">
6885 &lt;xsl:param name="highlight.default.language"&gt;&lt;/xsl:param&gt;
6886 </programlisting>
6887 </refsynopsisdiv>
6888
6889 <refsection><info><title>Description</title></info>
6890
6891 <para>This language is used when there is no language attribute on programlisting.</para>
6892
6893 </refsection>
6894 </refentry>
6895
6896 <refentry version="5.0" xml:id="email.delimiters.enabled">
6897 <refmeta>
6898 <refentrytitle>email.delimiters.enabled</refentrytitle>
6899 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6900 </refmeta>
6901 <refnamediv>
6902 <refname>email.delimiters.enabled</refname>
6903 <refpurpose>Generate delimiters around email addresses?</refpurpose>
6904 </refnamediv>
6905
6906 <refsynopsisdiv>
6907 <programlisting xml:id="email.delimiters.enabled.frag">
6908 &lt;xsl:param name="email.delimiters.enabled" select="1"&gt;&lt;/xsl:param&gt;
6909 </programlisting>
6910 </refsynopsisdiv>
6911
6912 <refsection><info><title>Description</title></info>
6913
6914 <para>If non-zero, delimiters
6915
6916 <footnote><para>For delimiters, the
6917 stylesheets are currently hard-coded to output angle
6918 brackets.</para></footnote> 
6919
6920 are generated around e-mail addresses
6921 (the output of the <tag>email</tag> element).</para>
6922
6923 </refsection>
6924 </refentry>
6925
6926 <refentry version="5.0" xml:id="email.mailto.enabled">
6927 <refmeta>
6928 <refentrytitle>email.mailto.enabled</refentrytitle>
6929 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
6930 </refmeta>
6931 <refnamediv>
6932 <refname>email.mailto.enabled</refname>
6933 <refpurpose>Generate mailto: links for email addresses?</refpurpose>
6934 </refnamediv>
6935
6936 <refsynopsisdiv>
6937 <programlisting xml:id="email.mailto.enabled.frag">
6938 &lt;xsl:param name="email.mailto.enabled" select="0"&gt;&lt;/xsl:param&gt;
6939 </programlisting>
6940 </refsynopsisdiv>
6941
6942 <refsection><info><title>Description</title></info>
6943
6944 <para>If non-zero the generated output for the <tag>email</tag> element
6945 will be a clickable mailto: link that brings up the default mail client
6946 on the system.</para>
6947
6948 </refsection>
6949 </refentry>
6950
6951 <refentry version="5.0" xml:id="section.container.element">
6952 <refmeta>
6953 <refentrytitle>section.container.element</refentrytitle>
6954 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
6955 <refmiscinfo class="other" otherclass="value">block</refmiscinfo>
6956 <refmiscinfo class="other" otherclass="value">wrapper</refmiscinfo>
6957 </refmeta>
6958 <refnamediv>
6959 <refname>section.container.element</refname>
6960 <refpurpose>Select XSL-FO element name to contain sections</refpurpose>
6961 </refnamediv>
6962
6963 <refsynopsisdiv>
6964 <programlisting xml:id="section.container.element.frag">
6965 &lt;xsl:param name="section.container.element"&gt;block&lt;/xsl:param&gt;
6966 </programlisting>
6967 </refsynopsisdiv>
6968
6969 <refsection><info><title>Description</title></info>
6970
6971 <para>Selects the element name for outer container of
6972 each section. The choices are <literal>block</literal> (default)
6973 or <literal>wrapper</literal>.
6974 The <literal>fo:</literal> namespace prefix is added
6975 by the stylesheet to form the full element name.
6976 </para>
6977
6978 <para>This element receives the section <literal>id</literal>
6979 attribute and the appropriate section level attribute-set.
6980 </para>
6981
6982 <para>Changing this parameter to <literal>wrapper</literal>
6983 is only necessary when producing multi-column output
6984 that contains page-wide spans.  Using <literal>fo:wrapper</literal>
6985 avoids the nesting of <literal>fo:block</literal>
6986 elements that prevents spans from working (the standard says
6987 a span must be on a block that is a direct child of 
6988 <literal>fo:flow</literal>).
6989 </para>
6990
6991 <para>If set to <literal>wrapper</literal>, the
6992 section attribute-sets only support properties
6993 that are inheritable.  That's because there is no
6994 block to apply them to.  Properties such as
6995 font-family are inheritable, but properties such as
6996 border are not.
6997 </para>
6998
6999 <para>Only some XSL-FO processors need to use this parameter.
7000 The Antenna House processor, for example, will handle 
7001 spans in nested blocks without changing the element name.
7002 The RenderX XEP product and FOP follow the XSL-FO standard 
7003 and need to use <literal>wrapper</literal>.
7004 </para>
7005
7006 </refsection>
7007 </refentry>
7008
7009 <refentry version="5.0" xml:id="monospace.verbatim.font.width">
7010 <refmeta>
7011 <refentrytitle>monospace.verbatim.font.width</refentrytitle>
7012 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7013 </refmeta>
7014 <refnamediv>
7015 <refname>monospace.verbatim.font.width</refname>
7016 <refpurpose>Width of a single monospace font character</refpurpose>
7017 </refnamediv>
7018
7019 <refsynopsisdiv>
7020 <programlisting xml:id="monospace.verbatim.font.width.frag">
7021 &lt;xsl:param name="monospace.verbatim.font.width"&gt;0.60em&lt;/xsl:param&gt;
7022 </programlisting>
7023 </refsynopsisdiv>
7024
7025 <refsection><info><title>Description</title></info>
7026
7027 <para>Specifies with em units the width of a single character
7028 of the monospace font. The default value is <literal>0.6em</literal>.</para>
7029
7030 <para>This parameter is only used when a <tag>screen</tag>
7031 or <tag>programlisting</tag> element has a 
7032 <tag class="attribute">width</tag> attribute, which is
7033 expressed as a plain integer to indicate the maximum character count
7034 of each line.
7035 To convert this character count to an actual maximum width
7036 measurement, the width of the font characters must be provided.
7037 Different monospace fonts have different character width,
7038 so this parameter should be adjusted to fit the 
7039 monospace font being used.
7040 </para>
7041
7042 </refsection>
7043 </refentry>
7044
7045 <refentry version="5.0" xml:id="exsl.node.set.available">
7046 <refmeta>
7047 <refentrytitle>exsl.node.set.available</refentrytitle>
7048 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7049 </refmeta>
7050 <refnamediv>
7051 <refname>exsl.node.set.available</refname>
7052 <refpurpose>Is the test function-available('exsl:node-set') true?</refpurpose>
7053 </refnamediv>
7054
7055 <refsynopsisdiv>
7056 <programlisting xml:id="exsl.node.set.available.frag">&lt;xsl:param name="exsl.node.set.available"&gt; 
7057   &lt;xsl:choose&gt;
7058     &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;
7059     &lt;xsl:otherwise&gt;0&lt;/xsl:otherwise&gt;
7060   &lt;/xsl:choose&gt;
7061 &lt;/xsl:param&gt;
7062 </programlisting>
7063 </refsynopsisdiv>
7064
7065 <refsection><info><title>Description</title></info>
7066
7067 <para>If non-zero,
7068 then the exsl:node-set() function is available to be used in
7069 the stylesheet.
7070 If zero, then the function is not available.
7071 This param automatically detects the presence of
7072 the function and does not normally need to be set manually.</para>
7073
7074 <para>This param was created to handle a long-standing
7075 bug in the Xalan processor that fails to detect the
7076 function even though it is available.</para>
7077
7078 </refsection>
7079 </refentry>
7080
7081 <refentry version="5.0" xml:id="bookmarks.collapse">
7082 <refmeta>
7083 <refentrytitle>bookmarks.collapse</refentrytitle>
7084 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> 
7085 </refmeta>
7086 <refnamediv>
7087 <refname>bookmarks.collapse</refname>
7088 <refpurpose>Specifies the initial state of bookmarks</refpurpose>
7089 </refnamediv>
7090
7091 <refsynopsisdiv>
7092 <programlisting xml:id="bookmarks.collapse.frag">
7093 &lt;xsl:param name="bookmarks.collapse" select="1"&gt;&lt;/xsl:param&gt;
7094 </programlisting>
7095 </refsynopsisdiv>
7096
7097 <refsection><info><title>Description</title></info>
7098
7099 <para>If non-zero, the bookmark tree is collapsed so that only the 
7100 top-level bookmarks are displayed initially. Otherwise, the whole tree 
7101 of bookmarks is displayed.</para>
7102
7103 <para>This parameter currently works with FOP 0.93 or later.</para>
7104
7105 </refsection>
7106 </refentry>
7107
7108 </reference>
7109 <reference xml:id="graphics"><title>Graphics</title>
7110 <refentry version="5.0" xml:id="graphic.default.extension">
7111 <refmeta>
7112 <refentrytitle>graphic.default.extension</refentrytitle>
7113 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
7114 </refmeta>
7115 <refnamediv>
7116 <refname>graphic.default.extension</refname>
7117 <refpurpose>Default extension for graphic filenames</refpurpose>
7118 </refnamediv>
7119
7120 <refsynopsisdiv>
7121 <programlisting xml:id="graphic.default.extension.frag">&lt;xsl:param name="graphic.default.extension"&gt;&lt;/xsl:param&gt;</programlisting>
7122 </refsynopsisdiv>
7123
7124 <refsection><info><title>Description</title></info>
7125
7126 <para>If a <tag>graphic</tag> or <tag>mediaobject</tag>
7127 includes a reference to a filename that does not include an extension,
7128 and the <tag class="attribute">format</tag> attribute is
7129 <emphasis>unspecified</emphasis>, the default extension will be used.
7130 </para>
7131
7132 </refsection>
7133 </refentry>
7134
7135 <refentry version="5.0" xml:id="default.image.width">
7136 <refmeta>
7137 <refentrytitle>default.image.width</refentrytitle>
7138 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7139 </refmeta>
7140 <refnamediv>
7141 <refname>default.image.width</refname>
7142 <refpurpose>The default width of images</refpurpose>
7143 </refnamediv>
7144
7145 <refsynopsisdiv>
7146 <programlisting xml:id="default.image.width.frag">
7147 &lt;xsl:param name="default.image.width"&gt;&lt;/xsl:param&gt;
7148 </programlisting>
7149 </refsynopsisdiv>
7150
7151 <refsection><info><title>Description</title></info>
7152
7153 <para>If specified, this value will be used for the
7154 <tag class="attribute">width</tag> attribute on images that do not specify any 
7155 <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>
7156
7157 </refsection>
7158 </refentry>
7159
7160 <refentry version="5.0" xml:id="preferred.mediaobject.role">
7161 <refmeta>
7162 <refentrytitle>preferred.mediaobject.role</refentrytitle>
7163 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
7164 </refmeta>
7165 <refnamediv>
7166 <refname>preferred.mediaobject.role</refname>
7167 <refpurpose>Select which mediaobject to use based on
7168 this value of an object's <tag class="attribute">role</tag> attribute.
7169 </refpurpose>
7170 </refnamediv>
7171
7172 <refsynopsisdiv>
7173 <programlisting xml:id="preferred.mediaobject.role.frag">
7174 &lt;xsl:param name="preferred.mediaobject.role"&gt;&lt;/xsl:param&gt;
7175 </programlisting>
7176 </refsynopsisdiv>
7177
7178 <refsection><info><title>Description</title></info>
7179
7180 <para>A mediaobject may contain several objects such as imageobjects.
7181 If the parameter <parameter>use.role.for.mediaobject</parameter> is
7182 non-zero, then the <literal>role</literal> attribute on
7183 <tag>imageobject</tag>s and other objects within a
7184 <tag>mediaobject</tag> container will be used to select which object
7185 will be used.  If one of the objects has a role value that matches the
7186 <parameter>preferred.mediaobject.role</parameter> parameter, then it
7187 has first priority for selection.  If more than one has such a role
7188 value, the first one is used.
7189 </para>
7190 <para>
7191 See the <parameter>use.role.for.mediaobject</parameter> parameter
7192 for the sequence of selection.</para>
7193 </refsection>
7194 </refentry>
7195
7196 <refentry version="5.0" xml:id="use.role.for.mediaobject">
7197 <refmeta>
7198 <refentrytitle>use.role.for.mediaobject</refentrytitle>
7199 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7200 </refmeta>
7201 <refnamediv>
7202 <refname>use.role.for.mediaobject</refname>
7203 <refpurpose>Use <tag class="attribute">role</tag> attribute 
7204 value for selecting which of several objects within a mediaobject to use.
7205 </refpurpose>
7206 </refnamediv>
7207
7208 <refsynopsisdiv>
7209 <programlisting xml:id="use.role.for.mediaobject.frag">
7210 &lt;xsl:param name="use.role.for.mediaobject" select="1"&gt;&lt;/xsl:param&gt;
7211 </programlisting>
7212 </refsynopsisdiv>
7213
7214 <refsection><info><title>Description</title></info>
7215
7216 <para>If non-zero, the <tag class="attribute">role</tag> attribute on
7217 <tag>imageobject</tag>s or other objects within a <tag>mediaobject</tag> container will be used to select which object will be
7218 used.
7219 </para>
7220 <para>
7221 The order of selection when then parameter is non-zero is:
7222 </para>
7223 <orderedlist>
7224 <listitem>
7225     <para>If the stylesheet parameter <parameter>preferred.mediaobject.role</parameter> has a value, then the object whose role equals that value is selected.</para>
7226 </listitem>
7227 <listitem>
7228 <para>Else if an object's role attribute has a value of
7229 <literal>html</literal> for HTML processing or
7230 <literal>fo</literal> for FO output, then the first
7231 of such objects is selected.
7232 </para>
7233 </listitem>
7234 <listitem>
7235 <para>Else the first suitable object is selected.</para>
7236 </listitem>
7237 </orderedlist>
7238 <para>
7239 If the value of 
7240 <parameter>use.role.for.mediaobject</parameter>
7241 is zero, then role attributes are not considered
7242 and the first suitable object
7243 with or without a role value is used.
7244 </para>
7245 </refsection>
7246 </refentry>
7247
7248 <refentry version="5.0" xml:id="ignore.image.scaling">
7249 <refmeta>
7250 <refentrytitle>ignore.image.scaling</refentrytitle>
7251 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7252 </refmeta>
7253 <refnamediv>
7254 <refname>ignore.image.scaling</refname>
7255 <refpurpose>Tell the stylesheets to ignore the author's image scaling attributes</refpurpose>
7256 </refnamediv>
7257
7258 <refsynopsisdiv>
7259 <programlisting xml:id="ignore.image.scaling.frag">
7260 &lt;xsl:param name="ignore.image.scaling" select="0"&gt;&lt;/xsl:param&gt;
7261 </programlisting>
7262 </refsynopsisdiv>
7263
7264 <refsection><info><title>Description</title></info>
7265
7266 <para>If non-zero, the scaling attributes on graphics and media objects are
7267 ignored.</para>
7268
7269 </refsection>
7270 </refentry>
7271
7272 <refentry version="5.0" xml:id="img.src.path">
7273 <refmeta>
7274 <refentrytitle>img.src.path</refentrytitle>
7275 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
7276 </refmeta>
7277 <refnamediv>
7278 <refname>img.src.path</refname>
7279 <refpurpose>Path to HTML/FO image files</refpurpose>
7280 </refnamediv>
7281
7282 <refsynopsisdiv>
7283 <programlisting xml:id="img.src.path.frag">&lt;xsl:param name="img.src.path"&gt;&lt;/xsl:param&gt;</programlisting>
7284 </refsynopsisdiv>
7285
7286 <refsection><info><title>Description</title></info>
7287
7288 <para>Add a path prefix to the value of the <tag class="attribute">fileref</tag> 
7289 attribute of <tag>graphic</tag>, <tag>inlinegraphic</tag>, and <tag>imagedata</tag> elements. The resulting 
7290 compound path is used in the output as the value of the <tag class="attribute">src</tag> 
7291 attribute of <tag class="element">img</tag> (HTML) or <tag class="element">external-graphic</tag> (FO).
7292 </para>
7293
7294 <para>
7295 The path given by <literal>img.src.path</literal> could be relative to the directory where the HTML/FO
7296 files are created, or it could be an absolute URI.
7297 The default value is empty.
7298 Be sure to include a trailing slash if needed.
7299 </para>
7300
7301 <para>This prefix is not applied to any filerefs that start
7302 with "/" or contain "//:".
7303 </para>
7304
7305 </refsection>
7306 </refentry>
7307
7308 <refentry version="5.0" xml:id="keep.relative.image.uris">
7309 <refmeta>
7310 <refentrytitle>keep.relative.image.uris</refentrytitle>
7311 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7312 </refmeta>
7313 <refnamediv>
7314 <refname>keep.relative.image.uris</refname>
7315 <refpurpose>Should image URIs be resolved against xml:base?</refpurpose>
7316 </refnamediv>
7317
7318 <refsynopsisdiv>
7319 <programlisting xml:id="keep.relative.image.uris.frag">
7320
7321 &lt;xsl:param name="keep.relative.image.uris" select="0"&gt;&lt;/xsl:param&gt;
7322 </programlisting>
7323 </refsynopsisdiv>
7324
7325 <refsection><info><title>Description</title></info>
7326
7327 <para>If non-zero, relative URIs (in, for example
7328 <literal>fileref</literal> attributes) will be used in the generated
7329 output. Otherwise, the URIs will be made absolute with respect to the
7330 base URI.</para>
7331
7332 <para>Note that the stylesheets calculate (and use) the absolute form
7333 for some purposes, this only applies to the resulting output.</para>
7334
7335 </refsection>
7336 </refentry>
7337
7338 </reference>
7339 <reference xml:id="general"><title>Pagination and General Styles</title>
7340 <partintro xml:id="margins_partintro">
7341 <section xml:id="margins_intro"><title>Understanding XSL FO Margins</title>
7342
7343 <para>To make sense of the parameters in this section, it's useful to
7344 consider <xref linkend="fig.pagemodel"/>.</para>
7345
7346 <figure xml:id="fig.pagemodel">
7347   <title>Page Model</title>
7348   <mediaobject xml:id="fo-pageregions-image">
7349     <imageobject role="html">
7350       <imagedata fileref="page.png"/>
7351     </imageobject>
7352     <imageobject role="fo">
7353       <imagedata fileref="fo/page.png"/>
7354     </imageobject>
7355     <textobject><phrase>Figure showing page margins</phrase></textobject>
7356     <textobject>
7357       <para>This figure shows the physical page with the various FO page regions
7358       identified.</para>
7359     </textobject>
7360   </mediaobject>
7361 </figure>
7362
7363 <para>First, let's consider the regions on the page.</para>
7364
7365 <para>The white region is the physical page. Its dimensions are determined by
7366 the <parameter>page.height</parameter> and <parameter>page.width</parameter>
7367 parameters.</para>
7368
7369 <para>The yellow region is the region-body. The size and placement of
7370 the region body is constrained by the dimensions labelled in the
7371 figure.</para>
7372
7373 <para>The pink region at the top of the page is the region-before. The
7374 darker area inside the region-before is the header text. In XSL, the default
7375 display alignment for a region is <literal>before</literal>, but the
7376 DocBook stylesheets still explicitly make it <literal>before</literal>. That's
7377 why the darker area is at the top.</para>
7378
7379 <para>The pink region at the bottom of the page is the region-after.
7380 The darker area is the footer text. In XSL, the default display
7381 alignment for a region is <literal>before</literal>,
7382 but the DocBook stylesheets explicitly make it
7383 <literal>after</literal>. That's why the darker area is at the bottom.</para>
7384
7385 <para>The dimensions in the figure are:</para>
7386
7387 <orderedlist numeration="upperalpha">
7388 <listitem><para>The page-master margin-top.
7389 </para></listitem>
7390 <listitem><para>The region-before extent.
7391 </para></listitem>
7392 <listitem><para>The region-body margin-top.
7393 </para></listitem>
7394 <listitem><para>The region-after extent.
7395 </para></listitem>
7396 <listitem><para>The page-master margin-bottom.
7397 </para></listitem>
7398 <listitem><para>The region-body margin-bottom.
7399 </para></listitem>
7400 <listitem><para>The sum of the page-master margin-left and the
7401 region-body margin-left. In DocBook, the region-body margin-left is
7402 zero by default, so this is simply the page-master margin-left.
7403 </para></listitem>
7404 <listitem><para>The sum of the page-master margin-right and the
7405 region-body margin-right. In DocBook, the region-body margin-right is
7406 zero by default, so this is simply the page-master margin-right.
7407 </para></listitem>
7408 </orderedlist>
7409
7410 </section>
7411 </partintro>
7412
7413 <refentry version="5.0" xml:id="page.height">
7414 <refmeta>
7415 <refentrytitle>page.height</refentrytitle>
7416 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7417 </refmeta>
7418 <refnamediv>
7419 <refname>page.height</refname>
7420 <refpurpose>The height of the physical page</refpurpose>
7421 </refnamediv>
7422
7423 <refsynopsisdiv>
7424 <programlisting xml:id="page.height.frag">&lt;xsl:param name="page.height"&gt;
7425   &lt;xsl:choose&gt;
7426     &lt;xsl:when test="$page.orientation = 'portrait'"&gt;
7427       &lt;xsl:value-of select="$page.height.portrait"&gt;&lt;/xsl:value-of&gt;
7428     &lt;/xsl:when&gt;
7429     &lt;xsl:otherwise&gt;
7430       &lt;xsl:value-of select="$page.width.portrait"&gt;&lt;/xsl:value-of&gt;
7431     &lt;/xsl:otherwise&gt;
7432   &lt;/xsl:choose&gt;
7433 &lt;/xsl:param&gt;</programlisting>
7434 </refsynopsisdiv>
7435
7436 <refsection><info><title>Description</title></info>
7437
7438 <para>The page height is generally calculated from the
7439 <parameter>paper.type</parameter> and
7440 <parameter>page.orientation</parameter> parameters.
7441 </para>
7442
7443 </refsection>
7444 </refentry>
7445
7446 <refentry version="5.0" xml:id="page.height.portrait">
7447 <refmeta>
7448 <refentrytitle>page.height.portrait</refentrytitle>
7449 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7450 </refmeta>
7451 <refnamediv>
7452 <refname>page.height.portrait</refname>
7453 <refpurpose>Specify the physical size of the long edge of the page</refpurpose>
7454 </refnamediv>
7455
7456 <refsynopsisdiv>
7457 <programlisting xml:id="page.height.portrait.frag">&lt;xsl:param name="page.height.portrait"&gt;
7458   &lt;xsl:choose&gt;
7459     &lt;xsl:when test="$paper.type = 'A4landscape'"&gt;210mm&lt;/xsl:when&gt;
7460     &lt;xsl:when test="$paper.type = 'USletter'"&gt;11in&lt;/xsl:when&gt;
7461     &lt;xsl:when test="$paper.type = 'USlandscape'"&gt;8.5in&lt;/xsl:when&gt;
7462     &lt;xsl:when test="$paper.type = '4A0'"&gt;2378mm&lt;/xsl:when&gt;
7463     &lt;xsl:when test="$paper.type = '2A0'"&gt;1682mm&lt;/xsl:when&gt;
7464     &lt;xsl:when test="$paper.type = 'A0'"&gt;1189mm&lt;/xsl:when&gt;
7465     &lt;xsl:when test="$paper.type = 'A1'"&gt;841mm&lt;/xsl:when&gt;
7466     &lt;xsl:when test="$paper.type = 'A2'"&gt;594mm&lt;/xsl:when&gt;
7467     &lt;xsl:when test="$paper.type = 'A3'"&gt;420mm&lt;/xsl:when&gt;
7468     &lt;xsl:when test="$paper.type = 'A4'"&gt;297mm&lt;/xsl:when&gt;
7469     &lt;xsl:when test="$paper.type = 'A5'"&gt;210mm&lt;/xsl:when&gt;
7470     &lt;xsl:when test="$paper.type = 'A6'"&gt;148mm&lt;/xsl:when&gt;
7471     &lt;xsl:when test="$paper.type = 'A7'"&gt;105mm&lt;/xsl:when&gt;
7472     &lt;xsl:when test="$paper.type = 'A8'"&gt;74mm&lt;/xsl:when&gt;
7473     &lt;xsl:when test="$paper.type = 'A9'"&gt;52mm&lt;/xsl:when&gt;
7474     &lt;xsl:when test="$paper.type = 'A10'"&gt;37mm&lt;/xsl:when&gt;
7475     &lt;xsl:when test="$paper.type = 'B0'"&gt;1414mm&lt;/xsl:when&gt;
7476     &lt;xsl:when test="$paper.type = 'B1'"&gt;1000mm&lt;/xsl:when&gt;
7477     &lt;xsl:when test="$paper.type = 'B2'"&gt;707mm&lt;/xsl:when&gt;
7478     &lt;xsl:when test="$paper.type = 'B3'"&gt;500mm&lt;/xsl:when&gt;
7479     &lt;xsl:when test="$paper.type = 'B4'"&gt;353mm&lt;/xsl:when&gt;
7480     &lt;xsl:when test="$paper.type = 'B5'"&gt;250mm&lt;/xsl:when&gt;
7481     &lt;xsl:when test="$paper.type = 'B6'"&gt;176mm&lt;/xsl:when&gt;
7482     &lt;xsl:when test="$paper.type = 'B7'"&gt;125mm&lt;/xsl:when&gt;
7483     &lt;xsl:when test="$paper.type = 'B8'"&gt;88mm&lt;/xsl:when&gt;
7484     &lt;xsl:when test="$paper.type = 'B9'"&gt;62mm&lt;/xsl:when&gt;
7485     &lt;xsl:when test="$paper.type = 'B10'"&gt;44mm&lt;/xsl:when&gt;
7486     &lt;xsl:when test="$paper.type = 'C0'"&gt;1297mm&lt;/xsl:when&gt;
7487     &lt;xsl:when test="$paper.type = 'C1'"&gt;917mm&lt;/xsl:when&gt;
7488     &lt;xsl:when test="$paper.type = 'C2'"&gt;648mm&lt;/xsl:when&gt;
7489     &lt;xsl:when test="$paper.type = 'C3'"&gt;458mm&lt;/xsl:when&gt;
7490     &lt;xsl:when test="$paper.type = 'C4'"&gt;324mm&lt;/xsl:when&gt;
7491     &lt;xsl:when test="$paper.type = 'C5'"&gt;229mm&lt;/xsl:when&gt;
7492     &lt;xsl:when test="$paper.type = 'C6'"&gt;162mm&lt;/xsl:when&gt;
7493     &lt;xsl:when test="$paper.type = 'C7'"&gt;114mm&lt;/xsl:when&gt;
7494     &lt;xsl:when test="$paper.type = 'C8'"&gt;81mm&lt;/xsl:when&gt;
7495     &lt;xsl:when test="$paper.type = 'C9'"&gt;57mm&lt;/xsl:when&gt;
7496     &lt;xsl:when test="$paper.type = 'C10'"&gt;40mm&lt;/xsl:when&gt;
7497     &lt;xsl:otherwise&gt;11in&lt;/xsl:otherwise&gt;
7498   &lt;/xsl:choose&gt;
7499 &lt;/xsl:param&gt;</programlisting>
7500 </refsynopsisdiv>
7501
7502 <refsection><info><title>Description</title></info>
7503
7504 <para>The portrait page height is the length of the long
7505 edge of the physical page.
7506 </para>
7507
7508 </refsection>
7509 </refentry>
7510
7511 <refentry version="5.0" xml:id="page.margin.bottom">
7512 <refmeta>
7513 <refentrytitle>page.margin.bottom</refentrytitle>
7514 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7515 </refmeta>
7516 <refnamediv>
7517 <refname>page.margin.bottom</refname>
7518 <refpurpose>The bottom margin of the page</refpurpose>
7519 </refnamediv>
7520
7521 <refsynopsisdiv>
7522 <programlisting xml:id="page.margin.bottom.frag">
7523 &lt;xsl:param name="page.margin.bottom"&gt;0.5in&lt;/xsl:param&gt;
7524 </programlisting>
7525 </refsynopsisdiv>
7526
7527 <refsection><info><title>Description</title></info>
7528
7529 <para>The bottom page margin is the distance from the bottom of the region-after
7530 to the physical bottom of the page.
7531 </para>
7532
7533 </refsection>
7534 </refentry>
7535
7536 <refentry version="5.0" xml:id="page.margin.inner">
7537 <refmeta>
7538 <refentrytitle>page.margin.inner</refentrytitle>
7539 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7540 </refmeta>
7541 <refnamediv>
7542 <refname>page.margin.inner</refname>
7543 <refpurpose>The inner page margin</refpurpose>
7544 </refnamediv>
7545
7546 <refsynopsisdiv>
7547 <programlisting xml:id="page.margin.inner.frag">&lt;xsl:param name="page.margin.inner"&gt;
7548   &lt;xsl:choose&gt;
7549     &lt;xsl:when test="$double.sided != 0"&gt;1.25in&lt;/xsl:when&gt;
7550     &lt;xsl:otherwise&gt;1in&lt;/xsl:otherwise&gt;
7551   &lt;/xsl:choose&gt;
7552 &lt;/xsl:param&gt;</programlisting>
7553 </refsynopsisdiv>
7554
7555 <refsection><info><title>Description</title></info>
7556
7557 <para>The inner page margin is the distance from bound edge of the
7558 page to the first column of text. </para>
7559
7560 <para>The inner page margin is the distance from bound edge of the
7561 page to the outer edge of the first column of text.</para>
7562
7563 <para>In left-to-right text direction,
7564 this is the left margin of recto (front side) pages.
7565 For single-sided output, it is the left margin
7566 of all pages.</para>
7567
7568 <para>In right-to-left text direction,
7569 this is the right margin of recto pages.
7570 For single-sided output, this is the
7571 right margin of all pages.</para>
7572
7573 <note>
7574 <para>Current versions (at least as of version 4.13)
7575 of the XEP XSL-FO processor do not
7576 correctly handle these margin settings for documents
7577 with right-to-left text direction.
7578 The workaround in that situation is to reverse
7579 the values for <parameter>page.margin.inner</parameter>
7580 and <parameter>page.margin.outer</parameter>, until
7581 this bug is fixed by RenderX.  It does not affect documents
7582 with left-to-right text direction.</para>
7583 </note>
7584
7585 </refsection>
7586 </refentry>
7587
7588 <refentry version="5.0" xml:id="page.margin.outer">
7589 <refmeta>
7590 <refentrytitle>page.margin.outer</refentrytitle>
7591 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7592 </refmeta>
7593 <refnamediv>
7594 <refname>page.margin.outer</refname>
7595 <refpurpose>The outer page margin</refpurpose>
7596 </refnamediv>
7597
7598 <refsynopsisdiv>
7599 <programlisting xml:id="page.margin.outer.frag">&lt;xsl:param name="page.margin.outer"&gt;
7600   &lt;xsl:choose&gt;
7601     &lt;xsl:when test="$double.sided != 0"&gt;0.75in&lt;/xsl:when&gt;
7602     &lt;xsl:otherwise&gt;1in&lt;/xsl:otherwise&gt;
7603   &lt;/xsl:choose&gt;
7604 &lt;/xsl:param&gt;</programlisting>
7605 </refsynopsisdiv>
7606
7607 <refsection><info><title>Description</title></info>
7608
7609 <para>The outer page margin is the distance from non-bound edge of the
7610 page to the outer edge of the last column of text.</para>
7611
7612 <para>In left-to-right text direction,
7613 this is the right margin of recto (front side) pages.
7614 For single-sided output, it is the right margin
7615 of all pages.</para>
7616
7617 <para>In right-to-left text direction,
7618 this is the left margin of recto pages.
7619 For single-sided output, this is the
7620 left margin of all pages.</para>
7621
7622 <note>
7623 <para>Current versions (at least as of version 4.13)
7624 of the XEP XSL-FO processor do not
7625 correctly handle these margin settings for documents
7626 with right-to-left text direction.
7627 The workaround in that situation is to reverse
7628 the values for <parameter>page.margin.inner</parameter>
7629 and <parameter>page.margin.outer</parameter>, until
7630 this bug is fixed by RenderX.  It does not affect documents
7631 with left-to-right text direction.</para>
7632 </note>
7633
7634 </refsection>
7635 </refentry>
7636
7637 <refentry version="5.0" xml:id="page.margin.top">
7638 <refmeta>
7639 <refentrytitle>page.margin.top</refentrytitle>
7640 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7641 </refmeta>
7642 <refnamediv>
7643 <refname>page.margin.top</refname>
7644 <refpurpose>The top margin of the page</refpurpose>
7645 </refnamediv>
7646
7647 <refsynopsisdiv>
7648 <programlisting xml:id="page.margin.top.frag">
7649 &lt;xsl:param name="page.margin.top"&gt;0.5in&lt;/xsl:param&gt;
7650 </programlisting>
7651 </refsynopsisdiv>
7652
7653 <refsection><info><title>Description</title></info>
7654
7655 <para>The top page margin is the distance from the physical top of the
7656 page to the top of the region-before.</para>
7657
7658 </refsection>
7659 </refentry>
7660
7661 <refentry version="5.0" xml:id="page.orientation">
7662 <refmeta>
7663 <refentrytitle>page.orientation</refentrytitle>
7664 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
7665 <refmiscinfo class="other" otherclass="value">portrait</refmiscinfo>
7666 <refmiscinfo class="other" otherclass="value">landscape</refmiscinfo>
7667 </refmeta>
7668 <refnamediv>
7669 <refname>page.orientation</refname>
7670 <refpurpose>Select the page orientation</refpurpose>
7671 </refnamediv>
7672
7673 <refsynopsisdiv>
7674 <programlisting xml:id="page.orientation.frag">
7675 &lt;xsl:param name="page.orientation"&gt;portrait&lt;/xsl:param&gt;
7676 </programlisting>
7677 </refsynopsisdiv>
7678
7679 <refsection><info><title>Description</title></info>
7680
7681 <para> Select one from portrait or landscape.
7682 In portrait orientation, the short edge is horizontal; in
7683 landscape orientation, it is vertical.
7684 </para>
7685
7686 </refsection>
7687 </refentry>
7688
7689 <refentry version="5.0" xml:id="page.width">
7690 <refmeta>
7691 <refentrytitle>page.width</refentrytitle>
7692 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7693 </refmeta>
7694 <refnamediv>
7695 <refname>page.width</refname>
7696 <refpurpose>The width of the physical page</refpurpose>
7697 </refnamediv>
7698
7699 <refsynopsisdiv>
7700 <programlisting xml:id="page.width.frag">&lt;xsl:param name="page.width"&gt;
7701   &lt;xsl:choose&gt;
7702     &lt;xsl:when test="$page.orientation = 'portrait'"&gt;
7703       &lt;xsl:value-of select="$page.width.portrait"&gt;&lt;/xsl:value-of&gt;
7704     &lt;/xsl:when&gt;
7705     &lt;xsl:otherwise&gt;
7706       &lt;xsl:value-of select="$page.height.portrait"&gt;&lt;/xsl:value-of&gt;
7707     &lt;/xsl:otherwise&gt;
7708   &lt;/xsl:choose&gt;
7709 &lt;/xsl:param&gt;</programlisting>
7710 </refsynopsisdiv>
7711
7712 <refsection><info><title>Description</title></info>
7713
7714 <para>The page width is generally calculated from the
7715 <parameter>paper.type</parameter> and 
7716 <parameter>page.orientation</parameter> parameters.</para>
7717
7718 </refsection>
7719 </refentry>
7720
7721 <refentry version="5.0" xml:id="page.width.portrait">
7722 <refmeta>
7723 <refentrytitle>page.width.portrait</refentrytitle>
7724 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7725 </refmeta>
7726 <refnamediv>
7727 <refname>page.width.portrait</refname>
7728 <refpurpose>Specify the physical size of the short edge of the page</refpurpose>
7729 </refnamediv>
7730
7731 <refsynopsisdiv>
7732 <programlisting xml:id="page.width.portrait.frag">&lt;xsl:param name="page.width.portrait"&gt;
7733   &lt;xsl:choose&gt;
7734     &lt;xsl:when test="$paper.type = 'USletter'"&gt;8.5in&lt;/xsl:when&gt;
7735     &lt;xsl:when test="$paper.type = '4A0'"&gt;1682mm&lt;/xsl:when&gt;
7736     &lt;xsl:when test="$paper.type = '2A0'"&gt;1189mm&lt;/xsl:when&gt;
7737     &lt;xsl:when test="$paper.type = 'A0'"&gt;841mm&lt;/xsl:when&gt;
7738     &lt;xsl:when test="$paper.type = 'A1'"&gt;594mm&lt;/xsl:when&gt;
7739     &lt;xsl:when test="$paper.type = 'A2'"&gt;420mm&lt;/xsl:when&gt;
7740     &lt;xsl:when test="$paper.type = 'A3'"&gt;297mm&lt;/xsl:when&gt;
7741     &lt;xsl:when test="$paper.type = 'A4'"&gt;210mm&lt;/xsl:when&gt;
7742     &lt;xsl:when test="$paper.type = 'A5'"&gt;148mm&lt;/xsl:when&gt;
7743     &lt;xsl:when test="$paper.type = 'A6'"&gt;105mm&lt;/xsl:when&gt;
7744     &lt;xsl:when test="$paper.type = 'A7'"&gt;74mm&lt;/xsl:when&gt;
7745     &lt;xsl:when test="$paper.type = 'A8'"&gt;52mm&lt;/xsl:when&gt;
7746     &lt;xsl:when test="$paper.type = 'A9'"&gt;37mm&lt;/xsl:when&gt;
7747     &lt;xsl:when test="$paper.type = 'A10'"&gt;26mm&lt;/xsl:when&gt;
7748     &lt;xsl:when test="$paper.type = 'B0'"&gt;1000mm&lt;/xsl:when&gt;
7749     &lt;xsl:when test="$paper.type = 'B1'"&gt;707mm&lt;/xsl:when&gt;
7750     &lt;xsl:when test="$paper.type = 'B2'"&gt;500mm&lt;/xsl:when&gt;
7751     &lt;xsl:when test="$paper.type = 'B3'"&gt;353mm&lt;/xsl:when&gt;
7752     &lt;xsl:when test="$paper.type = 'B4'"&gt;250mm&lt;/xsl:when&gt;
7753     &lt;xsl:when test="$paper.type = 'B5'"&gt;176mm&lt;/xsl:when&gt;
7754     &lt;xsl:when test="$paper.type = 'B6'"&gt;125mm&lt;/xsl:when&gt;
7755     &lt;xsl:when test="$paper.type = 'B7'"&gt;88mm&lt;/xsl:when&gt;
7756     &lt;xsl:when test="$paper.type = 'B8'"&gt;62mm&lt;/xsl:when&gt;
7757     &lt;xsl:when test="$paper.type = 'B9'"&gt;44mm&lt;/xsl:when&gt;
7758     &lt;xsl:when test="$paper.type = 'B10'"&gt;31mm&lt;/xsl:when&gt;
7759     &lt;xsl:when test="$paper.type = 'C0'"&gt;917mm&lt;/xsl:when&gt;
7760     &lt;xsl:when test="$paper.type = 'C1'"&gt;648mm&lt;/xsl:when&gt;
7761     &lt;xsl:when test="$paper.type = 'C2'"&gt;458mm&lt;/xsl:when&gt;
7762     &lt;xsl:when test="$paper.type = 'C3'"&gt;324mm&lt;/xsl:when&gt;
7763     &lt;xsl:when test="$paper.type = 'C4'"&gt;229mm&lt;/xsl:when&gt;
7764     &lt;xsl:when test="$paper.type = 'C5'"&gt;162mm&lt;/xsl:when&gt;
7765     &lt;xsl:when test="$paper.type = 'C6'"&gt;114mm&lt;/xsl:when&gt;
7766     &lt;xsl:when test="$paper.type = 'C7'"&gt;81mm&lt;/xsl:when&gt;
7767     &lt;xsl:when test="$paper.type = 'C8'"&gt;57mm&lt;/xsl:when&gt;
7768     &lt;xsl:when test="$paper.type = 'C9'"&gt;40mm&lt;/xsl:when&gt;
7769     &lt;xsl:when test="$paper.type = 'C10'"&gt;28mm&lt;/xsl:when&gt;
7770     &lt;xsl:otherwise&gt;8.5in&lt;/xsl:otherwise&gt;
7771   &lt;/xsl:choose&gt;
7772 &lt;/xsl:param&gt;</programlisting>
7773 </refsynopsisdiv>
7774
7775 <refsection><info><title>Description</title></info>
7776
7777 <para>The portrait page width is the length of the short
7778 edge of the physical page.
7779 </para>
7780
7781 </refsection>
7782 </refentry>
7783
7784 <refentry version="5.0" xml:id="paper.type">
7785 <refmeta>
7786 <refentrytitle>paper.type</refentrytitle>
7787 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
7788 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>
7789 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>
7790 <refmiscinfo class="other" otherclass="value">USletter<alt>8.5x11in</alt></refmiscinfo>
7791 <refmiscinfo class="other" otherclass="value">USlandscape<alt>11x8.5in</alt></refmiscinfo>
7792 <refmiscinfo class="other" otherclass="value">USlegal<alt>8.5inx14in</alt></refmiscinfo>
7793 <refmiscinfo class="other" otherclass="value">USlegallandscape<alt>14inx8.5in</alt></refmiscinfo>
7794 <refmiscinfo class="other" otherclass="value">4A0<alt>2378x1682mm</alt></refmiscinfo>
7795 <refmiscinfo class="other" otherclass="value">2A0<alt>1682x1189mm</alt></refmiscinfo>
7796 <refmiscinfo class="other" otherclass="value">A0<alt>1189x841mm</alt></refmiscinfo>
7797 <refmiscinfo class="other" otherclass="value">A1<alt>841x594mm</alt></refmiscinfo>
7798 <refmiscinfo class="other" otherclass="value">A2<alt>594x420mm</alt></refmiscinfo>
7799 <refmiscinfo class="other" otherclass="value">A3<alt>420x297mm</alt></refmiscinfo>
7800 <refmiscinfo class="other" otherclass="value">A4<alt>297x210mm</alt></refmiscinfo>
7801 <refmiscinfo class="other" otherclass="value">A5<alt>210x148mm</alt></refmiscinfo>
7802 <refmiscinfo class="other" otherclass="value">A6<alt>148x105mm</alt></refmiscinfo>
7803 <refmiscinfo class="other" otherclass="value">A7<alt>105x74mm</alt></refmiscinfo>
7804 <refmiscinfo class="other" otherclass="value">A8<alt>74x52mm</alt></refmiscinfo>
7805 <refmiscinfo class="other" otherclass="value">A9<alt>52x37mm</alt></refmiscinfo>
7806 <refmiscinfo class="other" otherclass="value">A10<alt>37x26mm</alt></refmiscinfo>
7807 <refmiscinfo class="other" otherclass="value">B0<alt>1414x1000mm</alt></refmiscinfo>
7808 <refmiscinfo class="other" otherclass="value">B1<alt>1000x707mm</alt></refmiscinfo>
7809 <refmiscinfo class="other" otherclass="value">B2<alt>707x500mm</alt></refmiscinfo>
7810 <refmiscinfo class="other" otherclass="value">B3<alt>500x353mm</alt></refmiscinfo>
7811 <refmiscinfo class="other" otherclass="value">B4<alt>353x250mm</alt></refmiscinfo>
7812 <refmiscinfo class="other" otherclass="value">B5<alt>250x176mm</alt></refmiscinfo>
7813 <refmiscinfo class="other" otherclass="value">B6<alt>176x125mm</alt></refmiscinfo>
7814 <refmiscinfo class="other" otherclass="value">B7<alt>125x88mm</alt></refmiscinfo>
7815 <refmiscinfo class="other" otherclass="value">B8<alt>88x62mm</alt></refmiscinfo>
7816 <refmiscinfo class="other" otherclass="value">B9<alt>62x44mm</alt></refmiscinfo>
7817 <refmiscinfo class="other" otherclass="value">B10<alt>44x31mm</alt></refmiscinfo>
7818 <refmiscinfo class="other" otherclass="value">C0<alt>1297x917mm</alt></refmiscinfo>
7819 <refmiscinfo class="other" otherclass="value">C1<alt>917x648mm</alt></refmiscinfo>
7820 <refmiscinfo class="other" otherclass="value">C2<alt>648x458mm</alt></refmiscinfo>
7821 <refmiscinfo class="other" otherclass="value">C3<alt>458x324mm</alt></refmiscinfo>
7822 <refmiscinfo class="other" otherclass="value">C4<alt>324x229mm</alt></refmiscinfo>
7823 <refmiscinfo class="other" otherclass="value">C5<alt>229x162mm</alt></refmiscinfo>
7824 <refmiscinfo class="other" otherclass="value">C6<alt>162x114mm</alt></refmiscinfo>
7825 <refmiscinfo class="other" otherclass="value">C7<alt>114x81mm</alt></refmiscinfo>
7826 <refmiscinfo class="other" otherclass="value">C8<alt>81x57mm</alt></refmiscinfo>
7827 <refmiscinfo class="other" otherclass="value">C9<alt>57x40mm</alt></refmiscinfo>
7828 <refmiscinfo class="other" otherclass="value">C10<alt>40x28mm</alt></refmiscinfo>
7829 </refmeta>
7830 <refnamediv>
7831 <refname>paper.type</refname>
7832 <refpurpose>Select the paper type</refpurpose>
7833 </refnamediv>
7834
7835 <refsynopsisdiv>
7836 <programlisting xml:id="paper.type.frag">
7837 &lt;xsl:param name="paper.type"&gt;USletter&lt;/xsl:param&gt;
7838 </programlisting>
7839 </refsynopsisdiv>
7840
7841 <refsection><info><title>Description</title></info>
7842
7843 <para>The paper type is a convenient way to specify the paper size.
7844 The list of known paper sizes includes USletter and most of the A,
7845 B, and C sizes. See <parameter>page.width.portrait</parameter>, for example.
7846
7847
7848 </para>
7849
7850 </refsection>
7851 </refentry>
7852
7853 <refentry version="5.0" xml:id="double.sided">
7854 <refmeta>
7855 <refentrytitle>double.sided</refentrytitle>
7856 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
7857 </refmeta>
7858 <refnamediv>
7859 <refname>double.sided</refname>
7860 <refpurpose>Is the document to be printed double sided?</refpurpose>
7861 </refnamediv>
7862
7863 <refsynopsisdiv>
7864 <programlisting xml:id="double.sided.frag">
7865 &lt;xsl:param name="double.sided" select="0"&gt;&lt;/xsl:param&gt;
7866 </programlisting>
7867 </refsynopsisdiv>
7868
7869 <refsection><info><title>Description</title></info>
7870
7871 <para>Double-sided documents are printed with a slightly wider margin
7872 on the binding edge of the page.
7873 </para>
7874 <para>FIXME: The current set of parameters does not take writing direction
7875 into account.</para>
7876
7877 </refsection>
7878 </refentry>
7879
7880 <refentry version="5.0" xml:id="body.margin.bottom">
7881 <refmeta>
7882 <refentrytitle>body.margin.bottom</refentrytitle>
7883 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7884 </refmeta>
7885 <refnamediv>
7886 <refname>body.margin.bottom</refname>
7887 <refpurpose>The bottom margin of the body text</refpurpose>
7888 </refnamediv>
7889
7890 <refsynopsisdiv>
7891 <programlisting xml:id="body.margin.bottom.frag">
7892 &lt;xsl:param name="body.margin.bottom"&gt;0.5in&lt;/xsl:param&gt;
7893 </programlisting>
7894 </refsynopsisdiv>
7895
7896 <refsection><info><title>Description</title></info>
7897
7898 <para>The body bottom margin is the distance from the last line of text
7899 in the page body to the bottom of the region-after.
7900 </para>
7901
7902 </refsection>
7903 </refentry>
7904
7905 <refentry version="5.0" xml:id="body.margin.top">
7906 <refmeta>
7907 <refentrytitle>body.margin.top</refentrytitle>
7908 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7909 </refmeta>
7910 <refnamediv>
7911 <refname>body.margin.top</refname>
7912 <refpurpose>To specify the size of the top margin of a page</refpurpose>
7913 </refnamediv>
7914
7915 <refsynopsisdiv>
7916 <programlisting xml:id="body.margin.top.frag">
7917 &lt;xsl:param name="body.margin.top"&gt;0.5in&lt;/xsl:param&gt;
7918 </programlisting>
7919 </refsynopsisdiv>
7920
7921 <refsection><info><title>Description</title></info>
7922
7923 <para>The body top margin is the distance from the top of the
7924 region-before to the first line of text in the page body.</para>
7925
7926 </refsection>
7927 </refentry>
7928
7929 <refentry version="5.0" xml:id="body.start.indent">
7930 <refmeta>
7931 <refentrytitle>body.start.indent</refentrytitle>
7932 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7933 </refmeta>
7934 <refnamediv>
7935 <refname>body.start.indent</refname>
7936 <refpurpose>The start-indent for the body text</refpurpose>
7937 </refnamediv>
7938
7939 <refsynopsisdiv>
7940 <programlisting xml:id="body.start.indent.frag">
7941 &lt;xsl:param name="body.start.indent"&gt;
7942   &lt;xsl:choose&gt;
7943     &lt;xsl:when test="$fop.extensions != 0"&gt;0pt&lt;/xsl:when&gt;
7944     &lt;xsl:when test="$passivetex.extensions != 0"&gt;0pt&lt;/xsl:when&gt;
7945     &lt;xsl:otherwise&gt;4pc&lt;/xsl:otherwise&gt;
7946   &lt;/xsl:choose&gt;
7947 &lt;/xsl:param&gt;
7948 </programlisting>
7949 </refsynopsisdiv>
7950
7951 <refsection><info><title>Description</title></info>
7952
7953 <para>This parameter provides
7954 the means of indenting the body text relative to
7955 section titles.
7956 For left-to-right text direction, it indents the left side.
7957 For right-to-left text direction, it indents the right side.
7958 It is used in place of the 
7959 <parameter>title.margin.left</parameter> for
7960 all XSL-FO processors except FOP 0.25.
7961 It enables support for side floats to appear
7962 in the indented margin area.
7963 </para>
7964 <para>This start-indent property is added to the fo:flow
7965 for certain page sequences.  Which page-sequences it is 
7966 applied to is determined by the template named
7967 <literal>set.flow.properties</literal>.
7968 By default, that template adds it to the flow
7969 for page-sequences using the <quote>body</quote>
7970 master-reference, as well as appendixes and prefaces.
7971 </para>
7972 <para>If this parameter is used, section titles should have
7973 a start-indent value of 0pt if they are to be
7974 outdented relative to the body text.
7975 </para>
7976
7977 <para>If you are using FOP, then set this parameter to a zero
7978 width value and set the <parameter>title.margin.left</parameter>
7979 parameter to the negative value of the desired indent.
7980 </para>
7981
7982 <para>See also <parameter>body.end.indent</parameter> and
7983 <parameter>title.margin.left</parameter>.
7984 </para>
7985
7986 </refsection>
7987 </refentry>
7988
7989 <refentry version="5.0" xml:id="body.end.indent">
7990 <refmeta>
7991 <refentrytitle>body.end.indent</refentrytitle>
7992 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
7993 </refmeta>
7994 <refnamediv>
7995 <refname>body.end.indent</refname>
7996 <refpurpose>The end-indent for the body text</refpurpose>
7997 </refnamediv>
7998
7999 <refsynopsisdiv>
8000 <programlisting xml:id="body.end.indent.frag">
8001 &lt;xsl:param name="body.end.indent"&gt;0pt&lt;/xsl:param&gt;
8002 </programlisting>
8003 </refsynopsisdiv>
8004
8005 <refsection><info><title>Description</title></info>
8006
8007 <para>This end-indent property is added to the fo:flow
8008 for certain page sequences.  Which page-sequences it is 
8009 applied to is determined by the template named
8010 <literal>set.flow.properties</literal>.
8011 By default, that template adds it to the flow
8012 for page-sequences using the <quote>body</quote>
8013 master-reference, as well as appendixes and prefaces.
8014 </para>
8015
8016 <para>See also <parameter>body.start.indent</parameter>.
8017 </para>
8018
8019 </refsection>
8020 </refentry>
8021
8022 <refentry version="5.0" xml:id="alignment">
8023 <refmeta>
8024 <refentrytitle>alignment</refentrytitle>
8025   <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
8026   <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>
8027   <refmiscinfo class="other" otherclass="value">left</refmiscinfo>
8028   <refmiscinfo class="other" otherclass="value">start</refmiscinfo>
8029   <refmiscinfo class="other" otherclass="value">right</refmiscinfo>
8030   <refmiscinfo class="other" otherclass="value">end</refmiscinfo>
8031   <refmiscinfo class="other" otherclass="value">center</refmiscinfo>
8032   <refmiscinfo class="other" otherclass="value">justify</refmiscinfo>
8033 </refmeta>
8034 <refnamediv>
8035 <refname>alignment</refname>
8036 <refpurpose>Specify the default text alignment</refpurpose>
8037 </refnamediv>
8038
8039 <refsynopsisdiv>
8040 <programlisting xml:id="alignment.frag">&lt;xsl:param name="alignment"&gt;justify&lt;/xsl:param&gt;</programlisting>
8041 </refsynopsisdiv>
8042
8043 <refsection><info><title>Description</title></info>
8044
8045 <para>The default text alignment is used for most body text.
8046 Allowed values are 
8047 <literal>left</literal>,
8048 <literal>right</literal>,
8049 <literal>start</literal>,
8050 <literal>end</literal>,
8051 <literal>center</literal>,
8052 <literal>justify</literal>.
8053 The default value is <literal>justify</literal>.
8054 </para>
8055
8056 </refsection>
8057 </refentry>
8058
8059 <refentry version="5.0" xml:id="hyphenate">
8060 <refmeta>
8061 <refentrytitle>hyphenate</refentrytitle>
8062 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
8063 <refmiscinfo class="other" otherclass="list-type">closed</refmiscinfo>
8064 <refmiscinfo class="other" otherclass="value">true</refmiscinfo>
8065 <refmiscinfo class="other" otherclass="value">false</refmiscinfo>
8066 </refmeta>
8067 <refnamediv>
8068 <refname>hyphenate</refname>
8069 <refpurpose>Specify hyphenation behavior</refpurpose>
8070 </refnamediv>
8071
8072 <refsynopsisdiv>
8073 <programlisting xml:id="hyphenate.frag">&lt;xsl:param name="hyphenate"&gt;true&lt;/xsl:param&gt;</programlisting>
8074 </refsynopsisdiv>
8075
8076 <refsection><info><title>Description</title></info>
8077
8078 <para>If true, words may be hyphenated. Otherwise, they may not.
8079 </para>
8080
8081 </refsection>
8082 </refentry>
8083
8084 <refentry version="5.0" xml:id="line-height">
8085 <refmeta>
8086 <refentrytitle>line-height</refentrytitle>
8087 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
8088 </refmeta>
8089 <refnamediv>
8090 <refname>line-height</refname>
8091 <refpurpose>Specify the line-height property</refpurpose>
8092 </refnamediv>
8093
8094 <refsynopsisdiv>
8095 <programlisting xml:id="line-height.frag">
8096 &lt;xsl:param name="line-height"&gt;normal&lt;/xsl:param&gt;
8097 </programlisting>
8098 </refsynopsisdiv>
8099
8100 <refsection><info><title>Description</title></info>
8101
8102 <para>Sets the line-height property.</para>
8103
8104 </refsection>
8105 </refentry>
8106
8107 <refentry version="5.0" xml:id="column.count.back">
8108 <refmeta>
8109 <refentrytitle>column.count.back</refentrytitle>
8110 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
8111 </refmeta>
8112 <refnamediv>
8113 <refname>column.count.back</refname>
8114 <refpurpose>Number of columns on back matter pages</refpurpose>
8115 </refnamediv>
8116
8117 <refsynopsisdiv>
8118 <programlisting xml:id="column.count.back.frag">
8119 &lt;xsl:param name="column.count.back" select="1"&gt;&lt;/xsl:param&gt;
8120 </programlisting>
8121 </refsynopsisdiv>
8122
8123 <refsection><info><title>Description</title></info>
8124
8125 <para>Number of columns on back matter (appendix, glossary, etc.) pages.</para>
8126
8127 </refsection>
8128 </refentry>
8129
8130 <refentry version="5.0" xml:id="column.count.body">
8131 <refmeta>
8132 <refentrytitle>column.count.body</refentrytitle>
8133 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
8134 </refmeta>
8135 <refnamediv>
8136 <refname>column.count.body</refname>
8137 <refpurpose>Number of columns on body pages</refpurpose>
8138 </refnamediv>
8139
8140 <refsynopsisdiv>
8141 <programlisting xml:id="column.count.body.frag">
8142 &lt;xsl:param name="column.count.body" select="1"&gt;&lt;/xsl:param&gt;
8143 </programlisting>
8144 </refsynopsisdiv>
8145
8146 <refsection><info><title>Description</title></info>
8147
8148 <para>Number of columns on body pages.</para>
8149
8150 </refsection>
8151 </refentry>
8152
8153 <refentry version="5.0" xml:id="column.count.front">
8154 <refmeta>
8155 <refentrytitle>column.count.front</refentrytitle>
8156 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
8157 </refmeta>
8158 <refnamediv>
8159 <refname>column.count.front</refname>
8160 <refpurpose>Number of columns on front matter pages</refpurpose>
8161 </refnamediv>
8162
8163 <refsynopsisdiv>
8164 <programlisting xml:id="column.count.front.frag">
8165 &lt;xsl:param name="column.count.front" select="1"&gt;&lt;/xsl:param&gt;
8166 </programlisting>
8167 </refsynopsisdiv>
8168
8169 <refsection><info><title>Description</title></info>
8170
8171 <para>Number of columns on front matter (dedication, preface, etc.) pages.</para>
8172
8173 </refsection>
8174 </refentry>
8175
8176 <refentry version="5.0" xml:id="column.count.index">
8177 <refmeta>
8178 <refentrytitle>column.count.index</refentrytitle>
8179 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
8180 </refmeta>
8181 <refnamediv>
8182 <refname>column.count.index</refname>
8183 <refpurpose>Number of columns on index pages</refpurpose>
8184 </refnamediv>
8185
8186 <refsynopsisdiv>
8187 <programlisting xml:id="column.count.index.frag">
8188 &lt;xsl:param name="column.count.index"&gt;2&lt;/xsl:param&gt;
8189 </programlisting>
8190 </refsynopsisdiv>
8191
8192 <refsection><info><title>Description</title></info>
8193
8194 <para>Number of columns on index pages.</para>
8195
8196 </refsection>
8197 </refentry>
8198
8199 <refentry version="5.0" xml:id="column.count.lot">
8200 <refmeta>
8201 <refentrytitle>column.count.lot</refentrytitle>
8202 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
8203 </refmeta>
8204 <refnamediv>
8205 <refname>column.count.lot</refname>
8206 <refpurpose>Number of columns on a 'List-of-Titles' page</refpurpose>
8207 </refnamediv>
8208
8209 <refsynopsisdiv>
8210 <programlisting xml:id="column.count.lot.frag">
8211 &lt;xsl:param name="column.count.lot" select="1"&gt;&lt;/xsl:param&gt;
8212 </programlisting>
8213 </refsynopsisdiv>
8214
8215 <refsection><info><title>Description</title></info>
8216
8217 <para>Number of columns on a page sequence containing the Table of Contents,
8218 List of Figures, etc.</para>
8219
8220 </refsection>
8221 </refentry>
8222
8223 <refentry version="5.0" xml:id="column.count.titlepage">
8224 <refmeta>
8225 <refentrytitle>column.count.titlepage</refentrytitle>
8226 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
8227 </refmeta>
8228 <refnamediv>
8229 <refname>column.count.titlepage</refname>
8230 <refpurpose>Number of columns on a title page</refpurpose>
8231 </refnamediv>
8232
8233 <refsynopsisdiv>
8234 <programlisting xml:id="column.count.titlepage.frag">
8235 &lt;xsl:param name="column.count.titlepage" select="1"&gt;&lt;/xsl:param&gt;
8236 </programlisting>
8237 </refsynopsisdiv>
8238
8239 <refsection><info><title>Description</title></info>
8240
8241 <para>Number of columns on a title page</para>
8242
8243 </refsection>
8244 </refentry>
8245
8246 <refentry version="5.0" xml:id="column.gap.back">
8247 <refmeta>
8248 <refentrytitle>column.gap.back</refentrytitle>
8249 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8250 </refmeta>
8251 <refnamediv>
8252 <refname>column.gap.back</refname>
8253 <refpurpose>Gap between columns in back matter</refpurpose>
8254 </refnamediv>
8255
8256 <refsynopsisdiv>
8257 <programlisting xml:id="column.gap.back.frag">
8258 &lt;xsl:param name="column.gap.back"&gt;12pt&lt;/xsl:param&gt;
8259 </programlisting>
8260 </refsynopsisdiv>
8261
8262 <refsection><info><title>Description</title></info>
8263
8264 <para>Specifies the gap between columns in back matter (if
8265 <parameter>column.count.back</parameter> is greater than one).</para>
8266
8267 </refsection>
8268 </refentry>
8269
8270 <refentry version="5.0" xml:id="column.gap.body">
8271 <refmeta>
8272 <refentrytitle>column.gap.body</refentrytitle>
8273 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8274 </refmeta>
8275 <refnamediv>
8276 <refname>column.gap.body</refname>
8277 <refpurpose>Gap between columns in the body</refpurpose>
8278 </refnamediv>
8279
8280 <refsynopsisdiv>
8281 <programlisting xml:id="column.gap.body.frag">
8282 &lt;xsl:param name="column.gap.body"&gt;12pt&lt;/xsl:param&gt;
8283 </programlisting>
8284 </refsynopsisdiv>
8285
8286 <refsection><info><title>Description</title></info>
8287
8288 <para>Specifies the gap between columns in body matter (if
8289 <parameter>column.count.body</parameter> is greater than one).</para>
8290
8291 </refsection>
8292 </refentry>
8293
8294 <refentry version="5.0" xml:id="column.gap.front">
8295 <refmeta>
8296 <refentrytitle>column.gap.front</refentrytitle>
8297 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8298 </refmeta>
8299 <refnamediv>
8300 <refname>column.gap.front</refname>
8301 <refpurpose>Gap between columns in the front matter</refpurpose>
8302 </refnamediv>
8303
8304 <refsynopsisdiv>
8305 <programlisting xml:id="column.gap.front.frag">
8306 &lt;xsl:param name="column.gap.front"&gt;12pt&lt;/xsl:param&gt;
8307 </programlisting>
8308 </refsynopsisdiv>
8309
8310 <refsection><info><title>Description</title></info>
8311
8312 <para>Specifies the gap between columns in front matter (if
8313 <parameter>column.count.front</parameter> is greater than one).</para>
8314
8315 </refsection>
8316 </refentry>
8317
8318 <refentry version="5.0" xml:id="column.gap.index">
8319 <refmeta>
8320 <refentrytitle>column.gap.index</refentrytitle>
8321 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8322 </refmeta>
8323 <refnamediv>
8324 <refname>column.gap.index</refname>
8325 <refpurpose>Gap between columns in the index</refpurpose>
8326 </refnamediv>
8327
8328 <refsynopsisdiv>
8329 <programlisting xml:id="column.gap.index.frag">
8330 &lt;xsl:param name="column.gap.index"&gt;12pt&lt;/xsl:param&gt;
8331 </programlisting>
8332 </refsynopsisdiv>
8333
8334 <refsection><info><title>Description</title></info>
8335
8336 <para>Specifies the gap between columns in indexes (if
8337 <parameter>column.count.index</parameter> is greater than one).</para>
8338
8339 </refsection>
8340 </refentry>
8341
8342 <refentry version="5.0" xml:id="column.gap.lot">
8343 <refmeta>
8344 <refentrytitle>column.gap.lot</refentrytitle>
8345 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8346 </refmeta>
8347 <refnamediv>
8348 <refname>column.gap.lot</refname>
8349 <refpurpose>Gap between columns on a 'List-of-Titles' page</refpurpose>
8350 </refnamediv>
8351
8352 <refsynopsisdiv>
8353 <programlisting xml:id="column.gap.lot.frag">
8354 &lt;xsl:param name="column.gap.lot"&gt;12pt&lt;/xsl:param&gt;
8355 </programlisting>
8356 </refsynopsisdiv>
8357
8358 <refsection><info><title>Description</title></info>
8359
8360 <para>Specifies the gap between columns on 'List-of-Titles' pages (if
8361 <parameter>column.count.lot</parameter> is greater than one).</para>
8362
8363 </refsection>
8364 </refentry>
8365
8366 <refentry version="5.0" xml:id="column.gap.titlepage">
8367 <refmeta>
8368 <refentrytitle>column.gap.titlepage</refentrytitle>
8369 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8370 </refmeta>
8371 <refnamediv>
8372 <refname>column.gap.titlepage</refname>
8373 <refpurpose>Gap between columns on title pages</refpurpose>
8374 </refnamediv>
8375
8376 <refsynopsisdiv>
8377 <programlisting xml:id="column.gap.titlepage.frag">
8378 &lt;xsl:param name="column.gap.titlepage"&gt;12pt&lt;/xsl:param&gt;
8379 </programlisting>
8380 </refsynopsisdiv>
8381
8382 <refsection><info><title>Description</title></info>
8383
8384 <para>Specifies the gap between columns on title pages (if
8385 <parameter>column.count.titlepage</parameter> is greater than one).</para>
8386
8387
8388 </refsection>
8389 </refentry>
8390
8391 <refentry version="5.0" xml:id="region.after.extent">
8392 <refmeta>
8393 <refentrytitle>region.after.extent</refentrytitle>
8394 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8395 </refmeta>
8396 <refnamediv>
8397 <refname>region.after.extent</refname>
8398 <refpurpose>Specifies the height of the footer.</refpurpose>
8399 </refnamediv>
8400
8401 <refsynopsisdiv>
8402 <programlisting xml:id="region.after.extent.frag">
8403 &lt;xsl:param name="region.after.extent"&gt;0.4in&lt;/xsl:param&gt;
8404 </programlisting>
8405 </refsynopsisdiv>
8406
8407 <refsection><info><title>Description</title></info>
8408
8409 <para>The region after extent is the height of the area where footers
8410 are printed.
8411 </para>
8412
8413 </refsection>
8414 </refentry>
8415
8416 <refentry version="5.0" xml:id="region.before.extent">
8417 <refmeta>
8418 <refentrytitle>region.before.extent</refentrytitle>
8419 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8420 </refmeta>
8421 <refnamediv>
8422 <refname>region.before.extent</refname>
8423 <refpurpose>Specifies the height of the header</refpurpose>
8424 </refnamediv>
8425
8426 <refsynopsisdiv>
8427 <programlisting xml:id="region.before.extent.frag">
8428 &lt;xsl:param name="region.before.extent"&gt;0.4in&lt;/xsl:param&gt;
8429 </programlisting>
8430 </refsynopsisdiv>
8431
8432 <refsection><info><title>Description</title></info>
8433
8434 <para>The region before extent is the height of the area where headers
8435 are printed.
8436 </para>
8437
8438 </refsection>
8439 </refentry>
8440
8441 <refentry version="5.0" xml:id="default.units">
8442 <refmeta>
8443 <refentrytitle>default.units</refentrytitle>
8444 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
8445 <refmiscinfo class="other" otherclass="value">cm</refmiscinfo>
8446 <refmiscinfo class="other" otherclass="value">mm</refmiscinfo>
8447 <refmiscinfo class="other" otherclass="value">in</refmiscinfo>
8448 <refmiscinfo class="other" otherclass="value">pt</refmiscinfo>
8449 <refmiscinfo class="other" otherclass="value">pc</refmiscinfo>
8450 <refmiscinfo class="other" otherclass="value">px</refmiscinfo>
8451 <refmiscinfo class="other" otherclass="value">em</refmiscinfo>
8452 </refmeta>
8453 <refnamediv>
8454 <refname>default.units</refname>
8455 <refpurpose>Default units for an unqualified dimension</refpurpose>
8456 </refnamediv>
8457
8458 <refsynopsisdiv>
8459 <programlisting xml:id="default.units.frag">
8460 &lt;xsl:param name="default.units"&gt;pt&lt;/xsl:param&gt;
8461 </programlisting>
8462 </refsynopsisdiv>
8463
8464 <refsection><info><title>Description</title></info>
8465
8466 <para>If an unqualified dimension is encountered (for example, in a
8467 graphic width), the <parameter>default.units</parameter> will be used for the
8468 units. Unqualified dimensions are not allowed in XSL Formatting Objects.
8469 </para>
8470
8471 </refsection>
8472 </refentry>
8473
8474 <refentry version="5.0" xml:id="normal.para.spacing">
8475 <refmeta>
8476 <refentrytitle>normal.para.spacing</refentrytitle>
8477 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
8478 </refmeta>
8479 <refnamediv>
8480 <refname>normal.para.spacing</refname>
8481 <refpurpose>What space do you want between normal paragraphs</refpurpose>
8482 </refnamediv>
8483
8484 <refsynopsisdiv>
8485 <programlisting xml:id="normal.para.spacing.frag">&lt;xsl:attribute-set name="normal.para.spacing"&gt;
8486   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
8487   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
8488   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
8489 &lt;/xsl:attribute-set&gt;</programlisting>
8490 </refsynopsisdiv>
8491 <refsection><info><title>Description</title></info>
8492 <para>Specify the spacing required between normal paragraphs</para>
8493 </refsection>
8494 </refentry>
8495
8496 <refentry version="5.0" xml:id="body.font.master">
8497 <refmeta>
8498 <refentrytitle>body.font.master</refentrytitle>
8499   <refmiscinfo class="other" otherclass="datatype">number</refmiscinfo>
8500 </refmeta>
8501 <refnamediv>
8502 <refname>body.font.master</refname>
8503 <refpurpose>Specifies the default point size for body text</refpurpose>
8504 </refnamediv>
8505
8506 <refsynopsisdiv>
8507 <programlisting xml:id="body.font.master.frag">
8508 &lt;xsl:param name="body.font.master"&gt;10&lt;/xsl:param&gt;
8509 </programlisting>
8510 </refsynopsisdiv>
8511
8512 <refsection><info><title>Description</title></info>
8513
8514 <para>The body font size is specified in two parameters
8515 (<parameter>body.font.master</parameter> and <parameter>body.font.size</parameter>)
8516 so that math can be performed on the font size by XSLT.
8517 </para>
8518
8519 </refsection>
8520 </refentry>
8521
8522 <refentry version="5.0" xml:id="body.font.size">
8523 <refmeta>
8524 <refentrytitle>body.font.size</refentrytitle>
8525 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8526 </refmeta>
8527 <refnamediv>
8528 <refname>body.font.size</refname>
8529 <refpurpose>Specifies the default font size for body text</refpurpose>
8530 </refnamediv>
8531
8532 <refsynopsisdiv>
8533 <programlisting xml:id="body.font.size.frag">
8534 &lt;xsl:param name="body.font.size"&gt;
8535  &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;&lt;xsl:text&gt;pt&lt;/xsl:text&gt;
8536 &lt;/xsl:param&gt;</programlisting>
8537 </refsynopsisdiv>
8538
8539 <refsection><info><title>Description</title></info>
8540
8541 <para>The body font size is specified in two parameters
8542 (<parameter>body.font.master</parameter> and <parameter>body.font.size</parameter>)
8543 so that math can be performed on the font size by XSLT.
8544 </para>
8545
8546 </refsection>
8547 </refentry>
8548
8549 <refentry version="5.0" xml:id="footnote.font.size">
8550 <refmeta>
8551 <refentrytitle>footnote.font.size</refentrytitle>
8552 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8553 </refmeta>
8554 <refnamediv>
8555 <refname>footnote.font.size</refname>
8556 <refpurpose>The font size for footnotes</refpurpose>
8557 </refnamediv>
8558
8559 <refsynopsisdiv>
8560 <programlisting xml:id="footnote.font.size.frag">&lt;xsl:param name="footnote.font.size"&gt;
8561  &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;
8562 &lt;/xsl:param&gt;</programlisting>
8563 </refsynopsisdiv>
8564
8565 <refsection><info><title>Description</title></info>
8566
8567 <para>The footnote font size is used for...footnotes!
8568 </para>
8569
8570 </refsection>
8571 </refentry>
8572
8573 <refentry version="5.0" xml:id="title.margin.left">
8574 <refmeta>
8575 <refentrytitle>title.margin.left</refentrytitle>
8576 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8577 </refmeta>
8578 <refnamediv>
8579 <refname>title.margin.left</refname>
8580 <refpurpose>Adjust the left margin for titles</refpurpose>
8581 </refnamediv>
8582
8583 <refsynopsisdiv>
8584 <programlisting xml:id="title.margin.left.frag">
8585 &lt;xsl:param name="title.margin.left"&gt;
8586   &lt;xsl:choose&gt;
8587     &lt;xsl:when test="$fop.extensions != 0"&gt;-4pc&lt;/xsl:when&gt;
8588     &lt;xsl:when test="$passivetex.extensions != 0"&gt;0pt&lt;/xsl:when&gt;
8589     &lt;xsl:otherwise&gt;0pt&lt;/xsl:otherwise&gt;
8590   &lt;/xsl:choose&gt;
8591 &lt;/xsl:param&gt;
8592 </programlisting>
8593 </refsynopsisdiv>
8594
8595 <refsection><info><title>Description</title></info>
8596
8597 <para>This parameter provides
8598 the means of adjusting the left margin for titles
8599 when the XSL-FO processor being used is
8600 an old version of FOP (0.25 and earlier).
8601 It is only useful when the <parameter>fop.extensions</parameter>
8602 is nonzero.</para>
8603
8604 <para>The left margin of the body region
8605 is calculated to include this space,
8606 and titles are outdented to the left outside
8607 the body region by this amount,
8608 effectively leaving titles at the intended left margin
8609 and the body text indented.
8610 Currently this method is only used for old FOP because
8611 it cannot properly use the <parameter>body.start.indent</parameter>
8612 parameter.
8613 </para>
8614 <para>
8615 The default value when the <parameter>fop.extensions</parameter>
8616 parameter is nonzero is -4pc, which means the
8617 body text is indented 4 picas relative to
8618 the titles.
8619 The default value when the <parameter>fop.extensions</parameter>
8620 parameter equals zero is 0pt, and
8621 the body indent should instead be specified
8622 using the <parameter>body.start.indent</parameter>
8623 parameter.
8624 </para>
8625 <para>
8626 If you set the value to zero, be sure to still include
8627 a unit indicator such as <literal>0pt</literal>, or
8628 the FO processor will report errors.
8629 </para>
8630
8631 </refsection>
8632 </refentry>
8633
8634 <refentry version="5.0" xml:id="draft.mode">
8635 <refmeta>
8636 <refentrytitle>draft.mode</refentrytitle>
8637 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
8638 <refmiscinfo class="other" otherclass="value">no</refmiscinfo> 
8639 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
8640 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>
8641 </refmeta>
8642 <refnamediv>
8643 <refname>draft.mode</refname>
8644 <refpurpose>Select draft mode</refpurpose>
8645 </refnamediv>
8646
8647 <refsynopsisdiv>
8648 <programlisting xml:id="draft.mode.frag">
8649 &lt;xsl:param name="draft.mode"&gt;no&lt;/xsl:param&gt;
8650 </programlisting>
8651 </refsynopsisdiv>
8652
8653 <refsection><info><title>Description</title></info>
8654
8655 <para>Selects draft mode. If <parameter>draft.mode</parameter> is
8656 <quote><literal>yes</literal></quote>, the entire document will be treated
8657 as a draft. If it is <quote><literal>no</literal></quote>, the entire document
8658 will be treated as a final copy. If it is <quote><literal>maybe</literal></quote>,
8659 individual sections will be treated as draft or final independently, depending
8660 on how their <literal>status</literal> attribute is set.
8661 </para>
8662
8663 </refsection>
8664 </refentry>
8665
8666 <refentry version="5.0" xml:id="draft.watermark.image">
8667 <refmeta>
8668 <refentrytitle>draft.watermark.image</refentrytitle>
8669 <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo>
8670 </refmeta>
8671 <refnamediv>
8672 <refname>draft.watermark.image</refname>
8673 <refpurpose>The URI of the image to be used for draft watermarks</refpurpose>
8674 </refnamediv>
8675
8676 <refsynopsisdiv>
8677 <programlisting xml:id="draft.watermark.image.frag">
8678 &lt;xsl:param name="draft.watermark.image"&gt;images/draft.png&lt;/xsl:param&gt;
8679 </programlisting>
8680 </refsynopsisdiv>
8681
8682 <refsection><info><title>Description</title></info>
8683
8684 <para>The image to be used for draft watermarks.</para>
8685
8686 </refsection>
8687 </refentry>
8688
8689 <refentry version="5.0" xml:id="headers.on.blank.pages">
8690 <refmeta>
8691 <refentrytitle>headers.on.blank.pages</refentrytitle>
8692 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
8693 </refmeta>
8694 <refnamediv>
8695 <refname>headers.on.blank.pages</refname>
8696 <refpurpose>Put headers on blank pages?</refpurpose>
8697 </refnamediv>
8698
8699 <refsynopsisdiv>
8700 <programlisting xml:id="headers.on.blank.pages.frag">
8701 &lt;xsl:param name="headers.on.blank.pages" select="1"&gt;&lt;/xsl:param&gt;
8702 </programlisting>
8703 </refsynopsisdiv>
8704
8705 <refsection><info><title>Description</title></info>
8706
8707 <para>If non-zero, headers will be placed on blank pages.</para>
8708
8709 </refsection>
8710 </refentry>
8711
8712 <refentry version="5.0" xml:id="footers.on.blank.pages">
8713 <refmeta>
8714 <refentrytitle>footers.on.blank.pages</refentrytitle>
8715 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
8716 </refmeta>
8717 <refnamediv>
8718 <refname>footers.on.blank.pages</refname>
8719 <refpurpose>Put footers on blank pages?</refpurpose>
8720 </refnamediv>
8721
8722 <refsynopsisdiv>
8723 <programlisting xml:id="footers.on.blank.pages.frag">
8724 &lt;xsl:param name="footers.on.blank.pages" select="1"&gt;&lt;/xsl:param&gt;
8725 </programlisting>
8726 </refsynopsisdiv>
8727
8728 <refsection><info><title>Description</title></info>
8729
8730 <para>If non-zero, footers will be placed on blank pages.</para>
8731
8732 </refsection>
8733 </refentry>
8734
8735 <refentry version="5.0" xml:id="header.rule">
8736 <refmeta>
8737 <refentrytitle>header.rule</refentrytitle>
8738 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
8739 </refmeta>
8740 <refnamediv>
8741 <refname>header.rule</refname>
8742 <refpurpose>Rule under headers?</refpurpose>
8743 </refnamediv>
8744
8745 <refsynopsisdiv>
8746 <programlisting xml:id="header.rule.frag">
8747 &lt;xsl:param name="header.rule" select="1"&gt;&lt;/xsl:param&gt;
8748 </programlisting>
8749 </refsynopsisdiv>
8750
8751 <refsection><info><title>Description</title></info>
8752
8753 <para>If non-zero, a rule will be drawn below the page headers.</para>
8754
8755 </refsection>
8756 </refentry>
8757
8758 <refentry version="5.0" xml:id="footer.rule">
8759 <refmeta>
8760 <refentrytitle>footer.rule</refentrytitle>
8761 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
8762 </refmeta>
8763 <refnamediv>
8764 <refname>footer.rule</refname>
8765 <refpurpose>Rule over footers?</refpurpose>
8766 </refnamediv>
8767
8768 <refsynopsisdiv>
8769 <programlisting xml:id="footer.rule.frag">
8770 &lt;xsl:param name="footer.rule" select="1"&gt;&lt;/xsl:param&gt;
8771 </programlisting>
8772 </refsynopsisdiv>
8773
8774 <refsection><info><title>Description</title></info>
8775
8776 <para>If non-zero, a rule will be drawn above the page footers.</para>
8777
8778 </refsection>
8779 </refentry>
8780
8781 <refentry version="5.0" xml:id="header.column.widths">
8782 <refmeta>
8783 <refentrytitle>header.column.widths</refentrytitle>
8784 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
8785 </refmeta>
8786 <refnamediv>
8787 <refname>header.column.widths</refname>
8788 <refpurpose>Specify relative widths of header areas</refpurpose>
8789 </refnamediv>
8790
8791 <refsynopsisdiv><programlisting xml:id="header.column.widths.frag">
8792 &lt;xsl:param name="header.column.widths"&gt;1 1 1&lt;/xsl:param&gt;
8793 </programlisting></refsynopsisdiv>
8794
8795 <refsection><info><title>Description</title></info>
8796
8797 <para>Page headers in print output use a three column table
8798 to position text at the left, center, and right side of
8799 the header on the page.
8800 This parameter lets you specify the relative sizes of the
8801 three columns.  The default value is
8802 "1 1 1".</para>
8803
8804 <para>The parameter value must be three numbers, separated
8805 by white space. The first number represents the relative
8806 width of the inside header for
8807 double-sided output.  The second number is the relative
8808 width of the center header.  The third number is the
8809 relative width of the outside header for
8810 double-sided output.
8811 </para>
8812 <para>For single-sided output, the first number is the
8813 relative width of left header for left-to-right
8814 text direction, or the right header for right-to-left
8815 text direction.  
8816 The third number is the
8817 relative width of right header for left-to-right
8818 text direction, or the left header for right-to-left
8819 text direction.</para>
8820
8821 <para>The numbers are used to specify the column widths
8822 for the table that makes up the header area.
8823 In the FO output, this looks like:
8824 </para>
8825
8826 <programlisting>
8827 &lt;fo:table-column column-number="1" 
8828     column-width="proportional-column-width(1)"/&gt;
8829 </programlisting>
8830
8831 <para>
8832 The <literal>proportional-column-width()</literal>
8833 function computes a column width by dividing its
8834 argument by the total of the arguments for all the columns, and
8835 then multiplying the result by the width of the whole table
8836 (assuming all the column specs use the function).
8837 Its argument can be any positive integer or floating point number.
8838 Zero is an acceptable value, although some FO processors
8839 may warn about it, in which case using a very small number might
8840 be more satisfactory.
8841 </para>
8842
8843 <para>For example, the value "1 2 1" means the center
8844 header should have twice the width of the other areas.
8845 A value of "0 0 1" means the entire header area
8846 is reserved for the right (or outside) header text.
8847 Note that to keep the center area centered on
8848 the page, the left and right values must be
8849 the same. A specification like "1 2 3" means the
8850 center area is no longer centered on the page
8851 since the right area is three times the width of the left area.
8852 </para>
8853
8854 </refsection>
8855 </refentry>
8856
8857 <refentry version="5.0" xml:id="footer.column.widths">
8858 <refmeta>
8859 <refentrytitle>footer.column.widths</refentrytitle>
8860 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
8861 </refmeta>
8862 <refnamediv>
8863 <refname>footer.column.widths</refname>
8864 <refpurpose>Specify relative widths of footer areas</refpurpose>
8865 </refnamediv>
8866
8867 <refsynopsisdiv><programlisting xml:id="footer.column.widths.frag">
8868 &lt;xsl:param name="footer.column.widths"&gt;1 1 1&lt;/xsl:param&gt;
8869 </programlisting></refsynopsisdiv>
8870
8871 <refsection><info><title>Description</title></info>
8872
8873 <para>Page footers in print output use a three column table
8874 to position text at the left, center, and right side of
8875 the footer on the page.
8876 This parameter lets you specify the relative sizes of the
8877 three columns.  The default value is
8878 "1 1 1".</para>
8879
8880 <para>The parameter value must be three numbers, separated
8881 by white space. The first number represents the relative
8882 width of the inside footer for
8883 double-sided output.  The second number is the relative
8884 width of the center footer.  The third number is the
8885 relative width of the outside footer for
8886 double-sided output.
8887 </para>
8888 <para>For single-sided output, the first number is the
8889 relative width of left footer for left-to-right
8890 text direction, or the right footer for right-to-left
8891 text direction.  
8892 The third number is the
8893 relative width of right footer for left-to-right
8894 text direction, or the left footer for right-to-left
8895 text direction.</para>
8896
8897 <para>The numbers are used to specify the column widths
8898 for the table that makes up the footer area.
8899 In the FO output, this looks like:
8900 </para>
8901
8902 <programlisting>
8903 &lt;fo:table-column column-number="1" 
8904     column-width="proportional-column-width(1)"/&gt;
8905 </programlisting>
8906
8907 <para>
8908 The <literal>proportional-column-width()</literal>
8909 function computes a column width by dividing its
8910 argument by the total of the arguments for all the columns, and
8911 then multiplying the result by the width of the whole table
8912 (assuming all the column specs use the function).
8913 Its argument can be any positive integer or floating point number.
8914 Zero is an acceptable value, although some FO processors
8915 may warn about it, in which case using a very small number might
8916 be more satisfactory.
8917 </para>
8918
8919 <para>For example, the value "1 2 1" means the center
8920 footer should have twice the width of the other areas.
8921 A value of "0 0 1" means the entire footer area
8922 is reserved for the right (or outside) footer text.
8923 Note that to keep the center area centered on
8924 the page, the left and right values must be
8925 the same. A specification like "1 2 3" means the
8926 center area is no longer centered on the page
8927 since the right area is three times the width of the left area.
8928 </para>
8929
8930 </refsection>
8931 </refentry>
8932
8933 <refentry version="5.0" xml:id="header.table.properties">
8934 <refmeta>
8935 <refentrytitle>header.table.properties</refentrytitle>
8936 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
8937 </refmeta>
8938 <refnamediv>
8939 <refname>header.table.properties</refname>
8940 <refpurpose>Apply properties to the header layout table</refpurpose>
8941 </refnamediv>
8942
8943 <refsynopsisdiv>
8944 <programlisting xml:id="header.table.properties.frag">
8945 &lt;xsl:attribute-set name="header.table.properties"&gt;
8946   &lt;xsl:attribute name="table-layout"&gt;fixed&lt;/xsl:attribute&gt;
8947   &lt;xsl:attribute name="width"&gt;100%&lt;/xsl:attribute&gt;
8948 &lt;/xsl:attribute-set&gt;
8949 </programlisting>
8950 </refsynopsisdiv>
8951
8952 <refsection><info><title>Description</title></info>
8953
8954 <para>Properties applied to the table that lays out the page header.</para>
8955
8956 </refsection>
8957 </refentry>
8958
8959 <refentry version="5.0" xml:id="header.table.height">
8960 <refmeta>
8961 <refentrytitle>header.table.height</refentrytitle>
8962 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
8963 </refmeta>
8964 <refnamediv>
8965 <refname>header.table.height</refname>
8966 <refpurpose>Specify the minimum height of the table containing the running page headers</refpurpose>
8967 </refnamediv>
8968
8969 <refsynopsisdiv><programlisting xml:id="header.table.height.frag">
8970 &lt;xsl:param name="header.table.height"&gt;14pt&lt;/xsl:param&gt;
8971 </programlisting></refsynopsisdiv>
8972
8973 <refsection><info><title>Description</title></info>
8974
8975 <para>Page headers in print output use a three column table
8976 to position text at the left, center, and right side of
8977 the header on the page.
8978 This parameter lets you specify the minimum height 
8979 of the single row in the table.  
8980 Since this specifies only the minimum height,
8981 the table should automatically grow to fit taller content.
8982 The default value is "14pt".</para>
8983
8984 </refsection>
8985 </refentry>
8986
8987 <refentry version="5.0" xml:id="footer.table.properties">
8988 <refmeta>
8989 <refentrytitle>footer.table.properties</refentrytitle>
8990 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
8991 </refmeta>
8992 <refnamediv>
8993 <refname>footer.table.properties</refname>
8994 <refpurpose>Apply properties to the footer layout table</refpurpose>
8995 </refnamediv>
8996
8997 <refsynopsisdiv>
8998 <programlisting xml:id="footer.table.properties.frag">
8999 &lt;xsl:attribute-set name="footer.table.properties"&gt;
9000   &lt;xsl:attribute name="table-layout"&gt;fixed&lt;/xsl:attribute&gt;
9001   &lt;xsl:attribute name="width"&gt;100%&lt;/xsl:attribute&gt;
9002 &lt;/xsl:attribute-set&gt;
9003 </programlisting>
9004 </refsynopsisdiv>
9005
9006 <refsection><info><title>Description</title></info>
9007
9008 <para>Properties applied to the table that lays out the page footer.</para>
9009
9010 </refsection>
9011 </refentry>
9012
9013 <refentry version="5.0" xml:id="footer.table.height">
9014 <refmeta>
9015 <refentrytitle>footer.table.height</refentrytitle>
9016 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9017 </refmeta>
9018 <refnamediv>
9019 <refname>footer.table.height</refname>
9020 <refpurpose>Specify the minimum height of the table containing the running page footers</refpurpose>
9021 </refnamediv>
9022
9023 <refsynopsisdiv><programlisting xml:id="footer.table.height.frag">
9024 &lt;xsl:param name="footer.table.height"&gt;14pt&lt;/xsl:param&gt;
9025 </programlisting></refsynopsisdiv>
9026
9027 <refsection><info><title>Description</title></info>
9028
9029 <para>Page footers in print output use a three column table
9030 to position text at the left, center, and right side of
9031 the footer on the page.
9032 This parameter lets you specify the minimum height 
9033 of the single row in the table.  
9034 Since this specifies only the minimum height,
9035 the table should automatically grow to fit taller content.
9036 The default value is "14pt".</para>
9037
9038 </refsection>
9039 </refentry>
9040
9041 <refentry version="5.0" xml:id="header.content.properties">
9042 <refmeta>
9043 <refentrytitle>header.content.properties</refentrytitle>
9044 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9045 </refmeta>
9046 <refnamediv>
9047 <refname>header.content.properties</refname>
9048 <refpurpose>Properties of page header content</refpurpose>
9049 </refnamediv>
9050
9051 <refsynopsisdiv>
9052 <programlisting xml:id="header.content.properties.frag">
9053 &lt;xsl:attribute-set name="header.content.properties"&gt;
9054   &lt;xsl:attribute name="font-family"&gt;
9055     &lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;
9056   &lt;/xsl:attribute&gt;
9057   &lt;xsl:attribute name="margin-left"&gt;
9058     &lt;xsl:value-of select="$title.margin.left"&gt;&lt;/xsl:value-of&gt;
9059   &lt;/xsl:attribute&gt;
9060 &lt;/xsl:attribute-set&gt;
9061 </programlisting>
9062 </refsynopsisdiv>
9063
9064 <refsection><info><title>Description</title></info>
9065
9066 <para>Properties of page header content.</para>
9067
9068 </refsection>
9069 </refentry>
9070
9071 <refentry version="5.0" xml:id="footer.content.properties">
9072 <refmeta>
9073 <refentrytitle>footer.content.properties</refentrytitle>
9074 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9075 </refmeta>
9076 <refnamediv>
9077 <refname>footer.content.properties</refname>
9078 <refpurpose>Properties of page footer content</refpurpose>
9079 </refnamediv>
9080
9081 <refsynopsisdiv>
9082 <programlisting xml:id="footer.content.properties.frag">
9083 &lt;xsl:attribute-set name="footer.content.properties"&gt;
9084   &lt;xsl:attribute name="font-family"&gt;
9085     &lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;
9086   &lt;/xsl:attribute&gt;
9087   &lt;xsl:attribute name="margin-left"&gt;
9088     &lt;xsl:value-of select="$title.margin.left"&gt;&lt;/xsl:value-of&gt;
9089   &lt;/xsl:attribute&gt;
9090 &lt;/xsl:attribute-set&gt;
9091 </programlisting>
9092 </refsynopsisdiv>
9093
9094 <refsection><info><title>Description</title></info>
9095
9096 <para>Properties of page footer content.</para>
9097
9098 </refsection>
9099 </refentry>
9100
9101 <refentry version="5.0" xml:id="marker.section.level">
9102 <refmeta>
9103 <refentrytitle>marker.section.level</refentrytitle>
9104 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
9105 </refmeta>
9106 <refnamediv>
9107 <refname>marker.section.level</refname>
9108 <refpurpose>Control depth of sections shown in running headers or footers</refpurpose>
9109 </refnamediv>
9110
9111 <refsynopsisdiv>
9112 <programlisting xml:id="marker.section.level.frag">
9113 &lt;xsl:param name="marker.section.level"&gt;2&lt;/xsl:param&gt;
9114 </programlisting>
9115 </refsynopsisdiv>
9116
9117 <refsection><info><title>Description</title></info>
9118
9119 <para>The <parameter>marker.section.level</parameter> parameter
9120 controls the depth of section levels that may be displayed
9121 in running headers and footers.  For example, if the value
9122 is 2 (the default), then titles from <tag>sect1</tag> and 
9123 <tag>sect2</tag> or equivalent <tag>section</tag>
9124 elements are candidates for use in running headers and
9125 footers.
9126 </para>
9127 <para>Each candidate title is marked in the FO output with a
9128 <tag>&lt;fo:marker marker-class-name="section.head.marker"&gt;</tag>
9129 element.
9130 </para>
9131 <para>In order for such titles to appear in headers
9132 or footers, the <literal>header.content</literal>
9133 or <literal>footer.content</literal> template
9134 must be customized to retrieve the marker using
9135 an output element such as:
9136 </para>
9137 <programlisting>
9138 &lt;fo:retrieve-marker retrieve-class-name="section.head.marker"
9139                        retrieve-position="first-including-carryover"
9140                        retrieve-boundary="page-sequence"/&gt;
9141 </programlisting>
9142
9143
9144 </refsection>
9145 </refentry>
9146
9147 </reference>
9148 <reference xml:id="fonts"><title>Font Families</title>
9149 <refentry version="5.0" xml:id="body.font.family">
9150 <refmeta>
9151 <refentrytitle>body.font.family</refentrytitle>
9152 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
9153 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>
9154 <refmiscinfo class="other" otherclass="value">serif</refmiscinfo>
9155 <refmiscinfo class="other" otherclass="value">sans-serif</refmiscinfo>
9156 <refmiscinfo class="other" otherclass="value">monospace</refmiscinfo>
9157 </refmeta>
9158 <refnamediv>
9159 <refname>body.font.family</refname>
9160 <refpurpose>The default font family for body text</refpurpose>
9161 </refnamediv>
9162
9163 <refsynopsisdiv>
9164 <programlisting xml:id="body.font.family.frag">
9165 &lt;xsl:param name="body.font.family"&gt;serif&lt;/xsl:param&gt;
9166 </programlisting>
9167 </refsynopsisdiv>
9168
9169 <refsection><info><title>Description</title></info>
9170
9171 <para>The body font family is the default font used for text in the page body.
9172 </para>
9173
9174 </refsection>
9175 </refentry>
9176
9177 <refentry version="5.0" xml:id="dingbat.font.family">
9178 <refmeta>
9179 <refentrytitle>dingbat.font.family</refentrytitle>
9180 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
9181 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>
9182 <refmiscinfo class="other" otherclass="value">serif</refmiscinfo>
9183 <refmiscinfo class="other" otherclass="value">sans-serif</refmiscinfo>
9184 <refmiscinfo class="other" otherclass="value">monospace</refmiscinfo>
9185 </refmeta>
9186 <refnamediv>
9187 <refname>dingbat.font.family</refname>
9188 <refpurpose>The font family for copyright, quotes, and other symbols</refpurpose>
9189 </refnamediv>
9190
9191 <refsynopsisdiv>
9192 <programlisting xml:id="dingbat.font.family.frag">
9193 &lt;xsl:param name="dingbat.font.family"&gt;serif&lt;/xsl:param&gt;
9194 </programlisting>
9195 </refsynopsisdiv>
9196
9197 <refsection><info><title>Description</title></info>
9198
9199 <para>The dingbat font family is used for dingbats. If it is defined
9200 as the empty string, no font change is effected around dingbats.
9201 </para>
9202
9203 </refsection>
9204 </refentry>
9205
9206 <refentry version="5.0" xml:id="monospace.font.family">
9207 <refmeta>
9208 <refentrytitle>monospace.font.family</refentrytitle>
9209 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
9210 </refmeta>
9211 <refnamediv>
9212 <refname>monospace.font.family</refname>
9213 <refpurpose>The default font family for monospace environments</refpurpose>
9214 </refnamediv>
9215
9216 <refsynopsisdiv>
9217 <programlisting xml:id="monospace.font.family.frag">
9218 &lt;xsl:param name="monospace.font.family"&gt;monospace&lt;/xsl:param&gt;
9219 </programlisting>
9220 </refsynopsisdiv>
9221
9222 <refsection><info><title>Description</title></info>
9223
9224 <para>The monospace font family is used for verbatim environments
9225 (program listings, screens, etc.).
9226 </para>
9227
9228 </refsection>
9229 </refentry>
9230
9231 <refentry version="5.0" xml:id="sans.font.family">
9232 <refmeta>
9233 <refentrytitle>sans.font.family</refentrytitle>
9234 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
9235 </refmeta>
9236 <refnamediv>
9237 <refname>sans.font.family</refname>
9238 <refpurpose>The default sans-serif font family</refpurpose>
9239 </refnamediv>
9240
9241 <refsynopsisdiv>
9242 <programlisting xml:id="sans.font.family.frag">
9243 &lt;xsl:param name="sans.font.family"&gt;sans-serif&lt;/xsl:param&gt;
9244 </programlisting>
9245 </refsynopsisdiv>
9246
9247 <refsection><info><title>Description</title></info>
9248
9249 <para>The default sans-serif font family. At the present, this isn't
9250 actually used by the stylesheets.
9251 </para>
9252
9253 </refsection>
9254 </refentry>
9255
9256 <refentry version="5.0" xml:id="title.font.family">
9257 <refmeta>
9258 <refentrytitle>title.font.family</refentrytitle>
9259 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
9260 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>
9261 <refmiscinfo class="other" otherclass="value">serif</refmiscinfo>
9262 <refmiscinfo class="other" otherclass="value">sans-serif</refmiscinfo>
9263 <refmiscinfo class="other" otherclass="value">monospace</refmiscinfo>
9264 </refmeta>
9265 <refnamediv>
9266 <refname>title.font.family</refname>
9267 <refpurpose>The default font family for titles</refpurpose>
9268 </refnamediv>
9269
9270 <refsynopsisdiv>
9271 <programlisting xml:id="title.font.family.frag">
9272 &lt;xsl:param name="title.font.family"&gt;sans-serif&lt;/xsl:param&gt;
9273 </programlisting>
9274 </refsynopsisdiv>
9275
9276 <refsection><info><title>Description</title></info>
9277
9278 <para>The title font family is used for titles (chapter, section, figure,
9279 etc.)
9280 </para>
9281
9282 </refsection>
9283 </refentry>
9284
9285 <refentry version="5.0" xml:id="symbol.font.family">
9286 <refmeta>
9287 <refentrytitle>symbol.font.family</refentrytitle>
9288 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
9289 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>
9290 <refmiscinfo class="other" otherclass="value">serif</refmiscinfo>
9291 <refmiscinfo class="other" otherclass="value">sans-serif</refmiscinfo>
9292 <refmiscinfo class="other" otherclass="value">monospace</refmiscinfo>
9293 </refmeta>
9294 <refnamediv>
9295 <refname>symbol.font.family</refname>
9296 <refpurpose>The font families to be searched for symbols outside
9297     of the body font</refpurpose>
9298 </refnamediv>
9299
9300 <refsynopsisdiv>
9301 <programlisting xml:id="symbol.font.family.frag">
9302 &lt;xsl:param name="symbol.font.family"&gt;Symbol,ZapfDingbats&lt;/xsl:param&gt;
9303 </programlisting>
9304 </refsynopsisdiv>
9305
9306 <refsection><info><title>Description</title></info>
9307
9308 <para>A typical body or title font does not contain all
9309 the character glyphs that DocBook supports.  This parameter
9310 specifies additional fonts that should be searched for
9311 special characters not in the normal font.
9312 These symbol font names are automatically appended
9313 to the body or title font family name when fonts
9314 are specified in a 
9315 <tag class="attribute">font-family</tag>
9316 property in the FO output.
9317 </para>
9318 <para>The symbol font names should be entered as a
9319 comma-separated list.  The default value is
9320 <literal>Symbol,ZapfDingbats</literal>.
9321 </para>
9322
9323 </refsection>
9324 </refentry>
9325
9326 </reference>
9327 <reference xml:id="propsets"><title>Property Sets</title>
9328 <refentry version="5.0" xml:id="formal.object.properties">
9329 <refmeta>
9330 <refentrytitle>formal.object.properties</refentrytitle>
9331 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9332 </refmeta>
9333 <refnamediv>
9334 <refname>formal.object.properties</refname>
9335 <refpurpose>Properties associated with a formal object such as a figure, or other component that has a title</refpurpose>
9336 </refnamediv>
9337
9338 <refsynopsisdiv>
9339 <programlisting xml:id="formal.object.properties.frag">
9340 &lt;xsl:attribute-set name="formal.object.properties"&gt;
9341   &lt;xsl:attribute name="space-before.minimum"&gt;0.5em&lt;/xsl:attribute&gt;
9342   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
9343   &lt;xsl:attribute name="space-before.maximum"&gt;2em&lt;/xsl:attribute&gt;
9344   &lt;xsl:attribute name="space-after.minimum"&gt;0.5em&lt;/xsl:attribute&gt;
9345   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;
9346   &lt;xsl:attribute name="space-after.maximum"&gt;2em&lt;/xsl:attribute&gt;
9347   &lt;xsl:attribute name="keep-together.within-column"&gt;always&lt;/xsl:attribute&gt;
9348 &lt;/xsl:attribute-set&gt;
9349 </programlisting>
9350 </refsynopsisdiv>
9351
9352 <refsection><info><title>Description</title></info>
9353
9354 <para>The styling for formal objects in docbook. Specify the spacing
9355 before and after the object.</para>
9356
9357 </refsection>
9358 </refentry>
9359
9360 <refentry version="5.0" xml:id="formal.title.properties">
9361 <refmeta>
9362 <refentrytitle>formal.title.properties</refentrytitle>
9363 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9364 </refmeta>
9365 <refnamediv>
9366 <refname>formal.title.properties</refname>
9367 <refpurpose>Style the title element of formal object such as a figure.</refpurpose>
9368 </refnamediv>
9369
9370 <refsynopsisdiv>
9371 <programlisting xml:id="formal.title.properties.frag">
9372 &lt;xsl:attribute-set name="formal.title.properties" use-attribute-sets="normal.para.spacing"&gt;
9373   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
9374   &lt;xsl:attribute name="font-size"&gt;
9375     &lt;xsl:value-of select="$body.font.master * 1.2"&gt;&lt;/xsl:value-of&gt;
9376     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
9377   &lt;/xsl:attribute&gt;
9378   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
9379   &lt;xsl:attribute name="space-after.minimum"&gt;0.4em&lt;/xsl:attribute&gt;
9380   &lt;xsl:attribute name="space-after.optimum"&gt;0.6em&lt;/xsl:attribute&gt;
9381   &lt;xsl:attribute name="space-after.maximum"&gt;0.8em&lt;/xsl:attribute&gt;
9382 &lt;/xsl:attribute-set&gt;
9383 </programlisting>
9384 </refsynopsisdiv>
9385 <refsection><info><title>Description</title></info>
9386 <para>Specify how the title should be styled. Specify the font size and weight of the title of the formal object.</para>
9387 </refsection>
9388 </refentry>
9389
9390 <refentry version="5.0" xml:id="informal.object.properties">
9391 <refmeta>
9392 <refentrytitle>informal.object.properties</refentrytitle>
9393 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9394 </refmeta>
9395 <refnamediv>
9396 <refname>informal.object.properties</refname>
9397 <refpurpose>Properties associated with an informal (untitled) object, such as an informalfigure</refpurpose>
9398 </refnamediv>
9399
9400 <refsynopsisdiv>
9401 <programlisting xml:id="informal.object.properties.frag">&lt;xsl:attribute-set name="informal.object.properties"&gt;
9402   &lt;xsl:attribute name="space-before.minimum"&gt;0.5em&lt;/xsl:attribute&gt;
9403   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
9404   &lt;xsl:attribute name="space-before.maximum"&gt;2em&lt;/xsl:attribute&gt;
9405   &lt;xsl:attribute name="space-after.minimum"&gt;0.5em&lt;/xsl:attribute&gt;
9406   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;
9407   &lt;xsl:attribute name="space-after.maximum"&gt;2em&lt;/xsl:attribute&gt;
9408 &lt;/xsl:attribute-set&gt;</programlisting>
9409 </refsynopsisdiv>
9410 <refsection><info><title>Description</title></info>
9411 <para>The styling for informal objects in docbook. Specify the spacing before and after the object.</para>
9412 </refsection>
9413 </refentry>
9414
9415 <refentry version="5.0" xml:id="monospace.properties">
9416 <refmeta>
9417 <refentrytitle>monospace.properties</refentrytitle>
9418 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9419 </refmeta>
9420 <refnamediv>
9421 <refname>monospace.properties</refname>
9422 <refpurpose>Properties of monospaced content</refpurpose>
9423 </refnamediv>
9424
9425 <refsynopsisdiv>
9426 <programlisting xml:id="monospace.properties.frag">
9427 &lt;xsl:attribute-set name="monospace.properties"&gt;
9428   &lt;xsl:attribute name="font-family"&gt;
9429     &lt;xsl:value-of select="$monospace.font.family"&gt;&lt;/xsl:value-of&gt;
9430   &lt;/xsl:attribute&gt;
9431 &lt;/xsl:attribute-set&gt;
9432 </programlisting>
9433 </refsynopsisdiv>
9434
9435 <refsection><info><title>Description</title></info>
9436
9437 <para>Specifies the font name for monospaced output. This property set
9438 used to set the font-size as well, but that doesn't work very well
9439 when different fonts are used (as they are in titles and paragraphs,
9440 for example).</para>
9441
9442 <para>If you want to set the font-size in a customization layer, it's
9443 probably going to be more appropriate to set font-size-adjust, if your
9444 formatter supports it.</para>
9445
9446 </refsection>
9447 </refentry>
9448
9449 <refentry version="5.0" xml:id="verbatim.properties">
9450 <refmeta>
9451 <refentrytitle>verbatim.properties</refentrytitle>
9452 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9453 </refmeta>
9454 <refnamediv>
9455 <refname>verbatim.properties</refname>
9456 <refpurpose>Properties associated with verbatim text</refpurpose>
9457 </refnamediv>
9458
9459 <refsynopsisdiv>
9460 <programlisting xml:id="verbatim.properties.frag">
9461 &lt;xsl:attribute-set name="verbatim.properties"&gt;
9462   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
9463   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;
9464   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
9465   &lt;xsl:attribute name="space-after.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
9466   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;
9467   &lt;xsl:attribute name="space-after.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
9468   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
9469   &lt;xsl:attribute name="wrap-option"&gt;no-wrap&lt;/xsl:attribute&gt;
9470   &lt;xsl:attribute name="white-space-collapse"&gt;false&lt;/xsl:attribute&gt;
9471   &lt;xsl:attribute name="white-space-treatment"&gt;preserve&lt;/xsl:attribute&gt;
9472   &lt;xsl:attribute name="linefeed-treatment"&gt;preserve&lt;/xsl:attribute&gt;
9473   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;
9474 &lt;/xsl:attribute-set&gt;</programlisting>
9475 </refsynopsisdiv>
9476
9477 <refsection><info><title>Description</title></info>
9478 <para>This attribute set is used on all verbatim environments.</para>
9479 </refsection>
9480
9481 </refentry>
9482
9483 <refentry version="5.0" xml:id="monospace.verbatim.properties">
9484 <refmeta>
9485 <refentrytitle>monospace.verbatim.properties</refentrytitle>
9486 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9487 </refmeta>
9488 <refnamediv>
9489 <refname>monospace.verbatim.properties</refname>
9490 <refpurpose>What font and size do you want for monospaced content?</refpurpose>
9491 </refnamediv>
9492
9493 <refsynopsisdiv>
9494 <programlisting xml:id="monospace.verbatim.properties.frag">
9495 &lt;xsl:attribute-set name="monospace.verbatim.properties" use-attribute-sets="verbatim.properties monospace.properties"&gt;
9496   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;
9497   &lt;xsl:attribute name="wrap-option"&gt;no-wrap&lt;/xsl:attribute&gt;
9498 &lt;/xsl:attribute-set&gt;
9499 </programlisting>
9500 </refsynopsisdiv>
9501 <refsection><info><title>Description</title></info>
9502 <para>Specify the font name and size you want for monospaced output</para>
9503 </refsection>
9504 </refentry>
9505
9506 <refentry version="5.0" xml:id="sidebar.properties">
9507 <refmeta>
9508 <refentrytitle>sidebar.properties</refentrytitle>
9509 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9510 </refmeta>
9511 <refnamediv>
9512 <refname>sidebar.properties</refname>
9513 <refpurpose>Attribute set for sidebar properties</refpurpose>
9514 </refnamediv>
9515
9516 <refsynopsisdiv>
9517 <programlisting xml:id="sidebar.properties.frag">
9518 &lt;xsl:attribute-set name="sidebar.properties" use-attribute-sets="formal.object.properties"&gt;
9519   &lt;xsl:attribute name="border-style"&gt;solid&lt;/xsl:attribute&gt;
9520   &lt;xsl:attribute name="border-width"&gt;1pt&lt;/xsl:attribute&gt;
9521   &lt;xsl:attribute name="border-color"&gt;black&lt;/xsl:attribute&gt;
9522   &lt;xsl:attribute name="background-color"&gt;#DDDDDD&lt;/xsl:attribute&gt;
9523   &lt;xsl:attribute name="padding-start"&gt;12pt&lt;/xsl:attribute&gt;
9524   &lt;xsl:attribute name="padding-end"&gt;12pt&lt;/xsl:attribute&gt;
9525   &lt;xsl:attribute name="padding-top"&gt;6pt&lt;/xsl:attribute&gt;
9526   &lt;xsl:attribute name="padding-bottom"&gt;6pt&lt;/xsl:attribute&gt;
9527   &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;0pt&lt;/xsl:attribute&gt;
9528   &lt;xsl:attribute name="margin-{$direction.align.end}"&gt;0pt&lt;/xsl:attribute&gt;
9529 &lt;!--
9530   &lt;xsl:attribute name="margin-top"&gt;6pt&lt;/xsl:attribute&gt;
9531   &lt;xsl:attribute name="margin-bottom"&gt;6pt&lt;/xsl:attribute&gt;
9532 --&gt;
9533 &lt;/xsl:attribute-set&gt;
9534 </programlisting>
9535 </refsynopsisdiv>
9536
9537 <refsection><info><title>Description</title></info>
9538
9539 <para>The styling for sidebars.</para>
9540
9541 </refsection>
9542 </refentry>
9543
9544 <refentry version="5.0" xml:id="sidebar.title.properties">
9545 <refmeta>
9546 <refentrytitle>sidebar.title.properties</refentrytitle>
9547 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9548 </refmeta>
9549 <refnamediv>
9550 <refname>sidebar.title.properties</refname>
9551 <refpurpose>Attribute set for sidebar titles</refpurpose>
9552 </refnamediv>
9553
9554 <refsynopsisdiv>
9555 <programlisting xml:id="sidebar.title.properties.frag">
9556 &lt;xsl:attribute-set name="sidebar.title.properties"&gt;
9557   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
9558   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
9559   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;
9560   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
9561 &lt;/xsl:attribute-set&gt;
9562 </programlisting>
9563 </refsynopsisdiv>
9564
9565 <refsection><info><title>Description</title></info>
9566
9567 <para>The styling for sidebars titles.</para>
9568
9569 </refsection>
9570 </refentry>
9571
9572 <refentry version="5.0" xml:id="sidebar.float.type">
9573 <refmeta>
9574 <refentrytitle>sidebar.float.type</refentrytitle>
9575 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
9576 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>
9577 <refmiscinfo class="other" otherclass="value">before</refmiscinfo>
9578 <refmiscinfo class="other" otherclass="value">left</refmiscinfo>
9579 <refmiscinfo class="other" otherclass="value">start</refmiscinfo> 
9580 <refmiscinfo class="other" otherclass="value">right</refmiscinfo>
9581 <refmiscinfo class="other" otherclass="value">end</refmiscinfo>     
9582 <refmiscinfo class="other" otherclass="value">inside</refmiscinfo>
9583 <refmiscinfo class="other" otherclass="value">outside</refmiscinfo> 
9584 </refmeta>
9585 <refnamediv>
9586 <refname>sidebar.float.type</refname>
9587 <refpurpose>Select type of float for sidebar elements</refpurpose>
9588 </refnamediv>
9589
9590 <refsynopsisdiv>
9591 <programlisting xml:id="sidebar.float.type.frag">
9592 &lt;xsl:param name="sidebar.float.type"&gt;none&lt;/xsl:param&gt;
9593 </programlisting>
9594 </refsynopsisdiv>
9595
9596 <refsection><info><title>Description</title></info>
9597
9598 <para>Selects the type of float for sidebar elements.
9599 </para>
9600 <itemizedlist>
9601 <listitem>
9602 <para>If <parameter>sidebar.float.type</parameter> is
9603 <quote><literal>none</literal></quote>, then 
9604 no float is used.
9605 </para>
9606 </listitem>
9607 <listitem>
9608 <para>If <parameter>sidebar.float.type</parameter> is
9609 <quote><literal>before</literal></quote>, then 
9610 the float appears at the top of the page.  On some processors,
9611 that may be the next page rather than the current page.
9612 </para>
9613 </listitem>
9614
9615 <listitem>
9616 <para>If <parameter>sidebar.float.type</parameter> is
9617 <quote><literal>left</literal></quote>,
9618 then a left side float is used.
9619 </para>
9620 </listitem>
9621
9622 <listitem>
9623 <para>If <parameter>sidebar.float.type</parameter> is
9624 <quote><literal>start</literal></quote>,
9625 then when the text direction is left-to-right a left side float is used.
9626 When the text direction is right-to-left, a right side float is used.
9627 </para>
9628 </listitem>
9629
9630 <listitem>
9631 <para>If <parameter>sidebar.float.type</parameter> is
9632 <quote><literal>right</literal></quote>,
9633 then a right side float is used.
9634 </para>
9635 </listitem>
9636
9637 <listitem>
9638 <para>If <parameter>sidebar.float.type</parameter> is
9639 <quote><literal>end</literal></quote>,
9640 then when the text direction is left-to-right a right side float is used.
9641 When the text direction is right-to-left, a left side float is used.
9642 </para>
9643 </listitem>
9644
9645 <listitem>
9646 <para>If your XSL-FO processor supports floats positioned on the
9647 <quote><literal>inside</literal></quote> or
9648 <quote><literal>outside</literal></quote>
9649 of double-sided pages, then you have those two 
9650 options for side floats as well.
9651 </para>
9652 </listitem>
9653 </itemizedlist>
9654
9655 </refsection>
9656 </refentry>
9657
9658 <refentry version="5.0" xml:id="sidebar.float.width">
9659 <refmeta>
9660 <refentrytitle>sidebar.float.width</refentrytitle>
9661 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9662 </refmeta>
9663 <refnamediv>
9664 <refname>sidebar.float.width</refname>
9665 <refpurpose>Set the default width for sidebars</refpurpose>
9666 </refnamediv>
9667
9668 <refsynopsisdiv>
9669 <programlisting xml:id="sidebar.float.width.frag">
9670 &lt;xsl:param name="sidebar.float.width"&gt;1in&lt;/xsl:param&gt;
9671 </programlisting>
9672 </refsynopsisdiv>
9673
9674 <refsection><info><title>Description</title></info>
9675
9676 <para>Sets the default width for sidebars when used as a side float.
9677 The width determines the degree to which the sidebar block intrudes into
9678 the text area.
9679 </para>
9680 <para>If <parameter>sidebar.float.type</parameter> is
9681 <quote><literal>before</literal></quote> or 
9682 <quote><literal>none</literal></quote>, then 
9683 this parameter is ignored.
9684 </para>
9685
9686 </refsection>
9687 </refentry>
9688
9689 <refentry version="5.0" xml:id="margin.note.properties">
9690 <refmeta>
9691 <refentrytitle>margin.note.properties</refentrytitle>
9692 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9693 </refmeta>
9694 <refnamediv>
9695 <refname>margin.note.properties</refname>
9696 <refpurpose>Attribute set for margin.note properties</refpurpose>
9697 </refnamediv>
9698
9699 <refsynopsisdiv>
9700 <programlisting xml:id="margin.note.properties.frag">
9701 &lt;xsl:attribute-set name="margin.note.properties"&gt;
9702   &lt;xsl:attribute name="font-size"&gt;90%&lt;/xsl:attribute&gt;
9703   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;
9704 &lt;/xsl:attribute-set&gt;
9705 </programlisting>
9706 </refsynopsisdiv>
9707
9708 <refsection><info><title>Description</title></info>
9709
9710 <para>The styling for margin notes.
9711 By default, margin notes are not implemented for any
9712 element. A stylesheet customization is needed to make
9713 use of this attribute-set.</para>
9714
9715 <para>You can use a template named <quote>floater</quote>
9716 to create the customization.
9717 That template can create side floats by specifying the
9718 content and characteristics as template parameters.
9719 </para>
9720
9721 <para>For example:</para>
9722 <programlisting>&lt;xsl:template match="para[@role='marginnote']"&gt;
9723   &lt;xsl:call-template name="floater"&gt;
9724     &lt;xsl:with-param name="position"&gt;
9725       &lt;xsl:value-of select="$margin.note.float.type"/&gt;
9726     &lt;/xsl:with-param&gt;
9727     &lt;xsl:with-param name="width"&gt;
9728       &lt;xsl:value-of select="$margin.note.width"/&gt;
9729     &lt;/xsl:with-param&gt;
9730     &lt;xsl:with-param name="content"&gt;
9731       &lt;xsl:apply-imports/&gt;
9732     &lt;/xsl:with-param&gt;
9733   &lt;/xsl:call-template&gt;
9734 &lt;/xsl:template&gt;</programlisting>
9735
9736 </refsection>
9737 </refentry>
9738
9739 <refentry version="5.0" xml:id="margin.note.title.properties">
9740 <refmeta>
9741 <refentrytitle>margin.note.title.properties</refentrytitle>
9742 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9743 </refmeta>
9744 <refnamediv>
9745 <refname>margin.note.title.properties</refname>
9746 <refpurpose>Attribute set for margin note titles</refpurpose>
9747 </refnamediv>
9748
9749 <refsynopsisdiv>
9750 <programlisting xml:id="margin.note.title.properties.frag">
9751 &lt;xsl:attribute-set name="margin.note.title.properties"&gt;
9752   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
9753   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
9754   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;
9755   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
9756 &lt;/xsl:attribute-set&gt;
9757 </programlisting>
9758 </refsynopsisdiv>
9759
9760 <refsection><info><title>Description</title></info>
9761
9762 <para>The styling for margin note titles.</para>
9763
9764 </refsection>
9765 </refentry>
9766
9767 <refentry version="5.0" xml:id="margin.note.float.type">
9768 <refmeta>
9769 <refentrytitle>margin.note.float.type</refentrytitle>
9770 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
9771 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>
9772 <refmiscinfo class="other" otherclass="value">before</refmiscinfo>
9773 <refmiscinfo class="other" otherclass="value">left</refmiscinfo>
9774 <refmiscinfo class="other" otherclass="value">start</refmiscinfo> 
9775 <refmiscinfo class="other" otherclass="value">right</refmiscinfo>
9776 <refmiscinfo class="other" otherclass="value">end</refmiscinfo>     
9777 <refmiscinfo class="other" otherclass="value">inside</refmiscinfo>
9778 <refmiscinfo class="other" otherclass="value">outside</refmiscinfo> 
9779 </refmeta>
9780 <refnamediv>
9781 <refname>margin.note.float.type</refname>
9782 <refpurpose>Select type of float for margin note customizations</refpurpose>
9783 </refnamediv>
9784
9785 <refsynopsisdiv>
9786 <programlisting xml:id="margin.note.float.type.frag">
9787 &lt;xsl:param name="margin.note.float.type"&gt;none&lt;/xsl:param&gt;
9788 </programlisting>
9789 </refsynopsisdiv>
9790
9791 <refsection><info><title>Description</title></info>
9792
9793 <para>Selects the type of float for margin notes.
9794 DocBook does not define a margin note element, so this
9795 feature must be implemented as a customization of the stylesheet.
9796 See <parameter>margin.note.properties</parameter> for
9797 an example.
9798 </para>
9799 <itemizedlist>
9800 <listitem>
9801 <para>If <parameter>margin.note.float.type</parameter> is
9802 <quote><literal>none</literal></quote>, then 
9803 no float is used.
9804 </para>
9805 </listitem>
9806 <listitem>
9807 <para>If <parameter>margin.note.float.type</parameter> is
9808 <quote><literal>before</literal></quote>, then 
9809 the float appears at the top of the page.  On some processors,
9810 that may be the next page rather than the current page.
9811 </para>
9812 </listitem>
9813 <listitem>
9814 <para>If <parameter>margin.note.float.type</parameter> is
9815 <quote><literal>left</literal></quote> or
9816 <quote><literal>start</literal></quote>, then 
9817 a left side float is used.
9818 </para>
9819 </listitem>
9820 <listitem>
9821 <para>If <parameter>margin.note.float.type</parameter> is
9822 <quote><literal>right</literal></quote> or
9823 <quote><literal>end</literal></quote>, then 
9824 a right side float is used.
9825 </para>
9826 </listitem>
9827 <listitem>
9828 <para>If your XSL-FO processor supports floats positioned on the
9829 <quote><literal>inside</literal></quote> or
9830 <quote><literal>outside</literal></quote>
9831 of double-sided pages, then you have those two 
9832 options for side floats as well.
9833 </para>
9834 </listitem>
9835 </itemizedlist>
9836
9837 </refsection>
9838 </refentry>
9839
9840 <refentry version="5.0" xml:id="margin.note.width">
9841 <refmeta>
9842 <refentrytitle>margin.note.width</refentrytitle>
9843 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
9844 </refmeta>
9845 <refnamediv>
9846 <refname>margin.note.width</refname>
9847 <refpurpose>Set the default width for margin notes</refpurpose>
9848 </refnamediv>
9849
9850 <refsynopsisdiv>
9851 <programlisting xml:id="margin.note.width.frag">
9852 &lt;xsl:param name="margin.note.width"&gt;1in&lt;/xsl:param&gt;
9853 </programlisting>
9854 </refsynopsisdiv>
9855
9856 <refsection><info><title>Description</title></info>
9857
9858 <para>Sets the default width for margin notes when used as a side
9859 float.  The width determines the degree to which the margin note block
9860 intrudes into the text area.
9861 </para>
9862 <para>If <parameter>margin.note.float.type</parameter> is
9863 <quote><literal>before</literal></quote> or 
9864 <quote><literal>none</literal></quote>, then 
9865 this parameter is ignored.
9866 </para>
9867
9868 </refsection>
9869 </refentry>
9870
9871 <refentry version="5.0" xml:id="component.title.properties">
9872 <refmeta>
9873 <refentrytitle>component.title.properties</refentrytitle>
9874 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9875 </refmeta>
9876 <refnamediv>
9877 <refname>component.title.properties</refname>
9878 <refpurpose>Properties for component titles</refpurpose>
9879 </refnamediv>
9880
9881 <refsynopsisdiv>
9882 <programlisting xml:id="component.title.properties.frag">
9883 &lt;xsl:attribute-set name="component.title.properties"&gt;
9884   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
9885   &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;
9886   &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;
9887   &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;
9888   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
9889   &lt;xsl:attribute name="text-align"&gt;
9890     &lt;xsl:choose&gt;
9891       &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;
9892       &lt;xsl:otherwise&gt;start&lt;/xsl:otherwise&gt;
9893     &lt;/xsl:choose&gt;
9894   &lt;/xsl:attribute&gt;
9895   &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;
9896 &lt;/xsl:attribute-set&gt;
9897 </programlisting>
9898 </refsynopsisdiv>
9899
9900 <refsection><info><title>Description</title></info>
9901
9902 <para>The properties common to all component titles.</para>
9903
9904 </refsection>
9905 </refentry>
9906
9907 <refentry version="5.0" xml:id="component.titlepage.properties">
9908 <refmeta>
9909 <refentrytitle>component.titlepage.properties</refentrytitle>
9910 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9911 </refmeta>
9912 <refnamediv>
9913 <refname>component.titlepage.properties</refname>
9914 <refpurpose>Properties for component titlepages</refpurpose>
9915 </refnamediv>
9916
9917 <refsynopsisdiv>
9918 <programlisting xml:id="component.titlepage.properties.frag">
9919 &lt;xsl:attribute-set name="component.titlepage.properties"&gt;
9920 &lt;/xsl:attribute-set&gt;
9921 </programlisting>
9922 </refsynopsisdiv>
9923
9924 <refsection><info><title>Description</title></info>
9925
9926 <para>The properties that are applied to the outer block containing
9927 all the component title page information. 
9928 Its main use is to set a <literal>span="all"</literal>
9929 property on the block that is a direct child of the flow.</para>
9930
9931 <para>This attribute-set also applies to index titlepages. It is empty by default.</para>
9932
9933 </refsection>
9934 </refentry>
9935
9936 <refentry version="5.0" xml:id="section.title.properties">
9937 <refmeta>
9938 <refentrytitle>section.title.properties</refentrytitle>
9939 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9940 </refmeta>
9941 <refnamediv>
9942 <refname>section.title.properties</refname>
9943 <refpurpose>Properties for section titles</refpurpose>
9944 </refnamediv>
9945
9946 <refsynopsisdiv>
9947 <programlisting xml:id="section.title.properties.frag">
9948 &lt;xsl:attribute-set name="section.title.properties"&gt;
9949   &lt;xsl:attribute name="font-family"&gt;
9950     &lt;xsl:value-of select="$title.font.family"&gt;&lt;/xsl:value-of&gt;
9951   &lt;/xsl:attribute&gt;
9952   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
9953   &lt;!-- font size is calculated dynamically by section.heading template --&gt;
9954   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
9955   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
9956   &lt;xsl:attribute name="space-before.optimum"&gt;1.0em&lt;/xsl:attribute&gt;
9957   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
9958   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;
9959   &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;
9960 &lt;/xsl:attribute-set&gt;
9961 </programlisting>
9962 </refsynopsisdiv>
9963
9964 <refsection><info><title>Description</title></info>
9965
9966 <para>The properties common to all section titles.</para>
9967
9968 </refsection>
9969 </refentry>
9970
9971 <refentry version="5.0" xml:id="section.title.level1.properties">
9972 <refmeta>
9973 <refentrytitle>section.title.level1.properties</refentrytitle>
9974 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
9975 </refmeta>
9976 <refnamediv>
9977 <refname>section.title.level1.properties</refname>
9978 <refpurpose>Properties for level-1 section titles</refpurpose>
9979 </refnamediv>
9980
9981 <refsynopsisdiv>
9982 <programlisting xml:id="section.title.level1.properties.frag">
9983 &lt;xsl:attribute-set name="section.title.level1.properties"&gt;
9984   &lt;xsl:attribute name="font-size"&gt;
9985     &lt;xsl:value-of select="$body.font.master * 2.0736"&gt;&lt;/xsl:value-of&gt;
9986     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
9987   &lt;/xsl:attribute&gt;
9988 &lt;/xsl:attribute-set&gt;
9989 </programlisting>
9990 </refsynopsisdiv>
9991
9992 <refsection><info><title>Description</title></info>
9993
9994 <para>The properties of level-1 section titles.</para>
9995
9996 </refsection>
9997 </refentry>
9998
9999
10000 <refentry version="5.0" xml:id="section.title.level2.properties">
10001 <refmeta>
10002 <refentrytitle>section.title.level2.properties</refentrytitle>
10003 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10004 </refmeta>
10005 <refnamediv>
10006 <refname>section.title.level2.properties</refname>
10007 <refpurpose>Properties for level-2 section titles</refpurpose>
10008 </refnamediv>
10009
10010 <refsynopsisdiv>
10011 <programlisting xml:id="section.title.level2.properties.frag">
10012 &lt;xsl:attribute-set name="section.title.level2.properties"&gt;
10013   &lt;xsl:attribute name="font-size"&gt;
10014     &lt;xsl:value-of select="$body.font.master * 1.728"&gt;&lt;/xsl:value-of&gt;
10015     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
10016   &lt;/xsl:attribute&gt;
10017 &lt;/xsl:attribute-set&gt;
10018 </programlisting>
10019 </refsynopsisdiv>
10020
10021 <refsection><info><title>Description</title></info>
10022
10023 <para>The properties of level-2 section titles.</para>
10024
10025 </refsection>
10026 </refentry>
10027
10028 <refentry version="5.0" xml:id="section.title.level3.properties">
10029 <refmeta>
10030 <refentrytitle>section.title.level3.properties</refentrytitle>
10031 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10032 </refmeta>
10033 <refnamediv>
10034 <refname>section.title.level3.properties</refname>
10035 <refpurpose>Properties for level-3 section titles</refpurpose>
10036 </refnamediv>
10037
10038 <refsynopsisdiv>
10039 <programlisting xml:id="section.title.level3.properties.frag">
10040 &lt;xsl:attribute-set name="section.title.level3.properties"&gt;
10041   &lt;xsl:attribute name="font-size"&gt;
10042     &lt;xsl:value-of select="$body.font.master * 1.44"&gt;&lt;/xsl:value-of&gt;
10043     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
10044   &lt;/xsl:attribute&gt;
10045 &lt;/xsl:attribute-set&gt;
10046 </programlisting>
10047 </refsynopsisdiv>
10048
10049 <refsection><info><title>Description</title></info>
10050
10051 <para>The properties of level-3 section titles.</para>
10052
10053 </refsection>
10054 </refentry>
10055
10056 <refentry version="5.0" xml:id="section.title.level4.properties">
10057 <refmeta>
10058 <refentrytitle>section.title.level4.properties</refentrytitle>
10059 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10060 </refmeta>
10061 <refnamediv>
10062 <refname>section.title.level4.properties</refname>
10063 <refpurpose>Properties for level-4 section titles</refpurpose>
10064 </refnamediv>
10065
10066 <refsynopsisdiv>
10067 <programlisting xml:id="section.title.level4.properties.frag">
10068 &lt;xsl:attribute-set name="section.title.level4.properties"&gt;
10069   &lt;xsl:attribute name="font-size"&gt;
10070     &lt;xsl:value-of select="$body.font.master * 1.2"&gt;&lt;/xsl:value-of&gt;
10071     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
10072   &lt;/xsl:attribute&gt;
10073 &lt;/xsl:attribute-set&gt;
10074 </programlisting>
10075 </refsynopsisdiv>
10076
10077 <refsection><info><title>Description</title></info>
10078
10079 <para>The properties of level-4 section titles.</para>
10080
10081 </refsection>
10082 </refentry>
10083
10084 <refentry version="5.0" xml:id="section.title.level5.properties">
10085 <refmeta>
10086 <refentrytitle>section.title.level5.properties</refentrytitle>
10087 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10088 </refmeta>
10089 <refnamediv>
10090 <refname>section.title.level5.properties</refname>
10091 <refpurpose>Properties for level-5 section titles</refpurpose>
10092 </refnamediv>
10093
10094 <refsynopsisdiv>
10095 <programlisting xml:id="section.title.level5.properties.frag">
10096 &lt;xsl:attribute-set name="section.title.level5.properties"&gt;
10097   &lt;xsl:attribute name="font-size"&gt;
10098     &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;
10099     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
10100   &lt;/xsl:attribute&gt;
10101 &lt;/xsl:attribute-set&gt;
10102 </programlisting>
10103 </refsynopsisdiv>
10104
10105 <refsection><info><title>Description</title></info>
10106
10107 <para>The properties of level-5 section titles.</para>
10108
10109 </refsection>
10110 </refentry>
10111
10112 <refentry version="5.0" xml:id="section.title.level6.properties">
10113 <refmeta>
10114 <refentrytitle>section.title.level6.properties</refentrytitle>
10115 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10116 </refmeta>
10117 <refnamediv>
10118 <refname>section.title.level6.properties</refname>
10119 <refpurpose>Properties for level-6 section titles</refpurpose>
10120 </refnamediv>
10121
10122 <refsynopsisdiv>
10123 <programlisting xml:id="section.title.level6.properties.frag">
10124 &lt;xsl:attribute-set name="section.title.level6.properties"&gt;
10125   &lt;xsl:attribute name="font-size"&gt;
10126     &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;
10127     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
10128   &lt;/xsl:attribute&gt;
10129 &lt;/xsl:attribute-set&gt;
10130 </programlisting>
10131 </refsynopsisdiv>
10132
10133 <refsection><info><title>Description</title></info>
10134
10135 <para>The properties of level-6 section titles. This property set is actually
10136 used for all titles below level 5.</para>
10137
10138 </refsection>
10139 </refentry>
10140
10141 <refentry version="5.0" xml:id="section.properties">
10142 <refmeta>
10143 <refentrytitle>section.properties</refentrytitle>
10144 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10145 </refmeta>
10146 <refnamediv>
10147 <refname>section.properties</refname>
10148 <refpurpose>Properties for all section levels</refpurpose>
10149 </refnamediv>
10150
10151 <refsynopsisdiv>
10152 <programlisting xml:id="section.properties.frag">
10153 &lt;xsl:attribute-set name="section.properties"&gt;
10154 &lt;/xsl:attribute-set&gt;
10155 </programlisting>
10156 </refsynopsisdiv>
10157
10158 <refsection><info><title>Description</title></info>
10159
10160 <para>The properties that apply to the containing
10161 block of all section levels, and therefore apply to
10162 the whole section.  
10163 This attribute set is inherited by the
10164 more specific attribute sets such as
10165 <tag>section.level1.properties</tag>.
10166 The default is empty.
10167 </para>
10168
10169 </refsection>
10170 </refentry>
10171
10172 <refentry version="5.0" xml:id="section.level1.properties">
10173 <refmeta>
10174 <refentrytitle>section.level1.properties</refentrytitle>
10175 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10176 </refmeta>
10177 <refnamediv>
10178 <refname>section.level1.properties</refname>
10179 <refpurpose>Properties for level-1 sections</refpurpose>
10180 </refnamediv>
10181
10182 <refsynopsisdiv>
10183 <programlisting xml:id="section.level1.properties.frag">
10184 &lt;xsl:attribute-set name="section.level1.properties" use-attribute-sets="section.properties"&gt;
10185 &lt;/xsl:attribute-set&gt;
10186 </programlisting>
10187 </refsynopsisdiv>
10188
10189 <refsection><info><title>Description</title></info>
10190
10191 <para>The properties that apply to the containing
10192 block of a level-1 section, and therefore apply to
10193 the whole section.  This includes <tag>sect1</tag>
10194 elements and <tag>section</tag> elements at level 1.
10195 </para>
10196
10197 <para>For example, you could start each level-1 section on
10198 a new page by using:</para>
10199 <programlisting>&lt;xsl:attribute-set name="section.level1.properties"&gt;
10200   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;
10201 &lt;/xsl:attribute-set&gt;
10202 </programlisting>
10203
10204 <para>This attribute set inherits attributes from the
10205 general <tag>section.properties</tag> attribute set.
10206 </para>
10207
10208 </refsection>
10209 </refentry>
10210
10211 <refentry version="5.0" xml:id="section.level2.properties">
10212 <refmeta>
10213 <refentrytitle>section.level2.properties</refentrytitle>
10214 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10215 </refmeta>
10216 <refnamediv>
10217 <refname>section.level2.properties</refname>
10218 <refpurpose>Properties for level-2 sections</refpurpose>
10219 </refnamediv>
10220
10221 <refsynopsisdiv>
10222 <programlisting xml:id="section.level2.properties.frag">
10223 &lt;xsl:attribute-set name="section.level2.properties" use-attribute-sets="section.properties"&gt;
10224 &lt;/xsl:attribute-set&gt;
10225 </programlisting>
10226 </refsynopsisdiv>
10227
10228 <refsection><info><title>Description</title></info>
10229
10230 <para>The properties that apply to the containing
10231 block of a level-2 section, and therefore apply to
10232 the whole section.  This includes <tag>sect2</tag>
10233 elements and <tag>section</tag> elements at level 2.
10234 </para>
10235
10236 <para>For example, you could start each level-2 section on
10237 a new page by using:</para>
10238 <programlisting>&lt;xsl:attribute-set name="section.level2.properties"&gt;
10239   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;
10240 &lt;/xsl:attribute-set&gt;
10241 </programlisting>
10242
10243 <para>This attribute set inherits attributes from the
10244 general <tag>section.properties</tag> attribute set.
10245 </para>
10246
10247 </refsection>
10248 </refentry>
10249
10250 <refentry version="5.0" xml:id="section.level3.properties">
10251 <refmeta>
10252 <refentrytitle>section.level3.properties</refentrytitle>
10253 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10254 </refmeta>
10255 <refnamediv>
10256 <refname>section.level3.properties</refname>
10257 <refpurpose>Properties for level-3 sections</refpurpose>
10258 </refnamediv>
10259
10260 <refsynopsisdiv>
10261 <programlisting xml:id="section.level3.properties.frag">
10262 &lt;xsl:attribute-set name="section.level3.properties" use-attribute-sets="section.properties"&gt;
10263 &lt;/xsl:attribute-set&gt;
10264 </programlisting>
10265 </refsynopsisdiv>
10266
10267 <refsection><info><title>Description</title></info>
10268
10269 <para>The properties that apply to the containing
10270 block of a level-3 section, and therefore apply to
10271 the whole section.  This includes <tag>sect3</tag>
10272 elements and <tag>section</tag> elements at level 3.
10273 </para>
10274
10275 <para>For example, you could start each level-3 section on
10276 a new page by using:</para>
10277 <programlisting>&lt;xsl:attribute-set name="section.level3.properties"&gt;
10278   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;
10279 &lt;/xsl:attribute-set&gt;
10280 </programlisting>
10281
10282 <para>This attribute set inherits attributes from the
10283 general <tag>section.properties</tag> attribute set.
10284 </para>
10285
10286 </refsection>
10287 </refentry>
10288
10289 <refentry version="5.0" xml:id="section.level4.properties">
10290 <refmeta>
10291 <refentrytitle>section.level4.properties</refentrytitle>
10292 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10293 </refmeta>
10294 <refnamediv>
10295 <refname>section.level4.properties</refname>
10296 <refpurpose>Properties for level-4 sections</refpurpose>
10297 </refnamediv>
10298
10299 <refsynopsisdiv>
10300 <programlisting xml:id="section.level4.properties.frag">
10301 &lt;xsl:attribute-set name="section.level4.properties" use-attribute-sets="section.properties"&gt;
10302 &lt;/xsl:attribute-set&gt;
10303 </programlisting>
10304 </refsynopsisdiv>
10305
10306 <refsection><info><title>Description</title></info>
10307
10308 <para>The properties that apply to the containing
10309 block of a level-4 section, and therefore apply to
10310 the whole section.  This includes <tag>sect4</tag>
10311 elements and <tag>section</tag> elements at level 4.
10312 </para>
10313
10314 <para>For example, you could start each level-4 section on
10315 a new page by using:</para>
10316 <programlisting>&lt;xsl:attribute-set name="section.level4.properties"&gt;
10317   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;
10318 &lt;/xsl:attribute-set&gt;
10319 </programlisting>
10320
10321 <para>This attribute set inherits attributes from the
10322 general <tag>section.properties</tag> attribute set.
10323 </para>
10324
10325 </refsection>
10326 </refentry>
10327
10328 <refentry version="5.0" xml:id="section.level5.properties">
10329 <refmeta>
10330 <refentrytitle>section.level5.properties</refentrytitle>
10331 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10332 </refmeta>
10333 <refnamediv>
10334 <refname>section.level5.properties</refname>
10335 <refpurpose>Properties for level-5 sections</refpurpose>
10336 </refnamediv>
10337
10338 <refsynopsisdiv>
10339 <programlisting xml:id="section.level5.properties.frag">
10340 &lt;xsl:attribute-set name="section.level5.properties" use-attribute-sets="section.properties"&gt;
10341 &lt;/xsl:attribute-set&gt;
10342 </programlisting>
10343 </refsynopsisdiv>
10344
10345 <refsection><info><title>Description</title></info>
10346
10347 <para>The properties that apply to the containing
10348 block of a level-5 section, and therefore apply to
10349 the whole section.  This includes <tag>sect5</tag>
10350 elements and <tag>section</tag> elements at level 5.
10351 </para>
10352
10353 <para>For example, you could start each level-5 section on
10354 a new page by using:</para>
10355 <programlisting>&lt;xsl:attribute-set name="section.level5.properties"&gt;
10356   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;
10357 &lt;/xsl:attribute-set&gt;
10358 </programlisting>
10359
10360 <para>This attribute set inherits attributes from the
10361 general <tag>section.properties</tag> attribute set.
10362 </para>
10363
10364 </refsection>
10365 </refentry>
10366
10367 <refentry version="5.0" xml:id="section.level6.properties">
10368 <refmeta>
10369 <refentrytitle>section.level6.properties</refentrytitle>
10370 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10371 </refmeta>
10372 <refnamediv>
10373 <refname>section.level6.properties</refname>
10374 <refpurpose>Properties for level-6 sections</refpurpose>
10375 </refnamediv>
10376
10377 <refsynopsisdiv>
10378 <programlisting xml:id="section.level6.properties.frag">
10379 &lt;xsl:attribute-set name="section.level6.properties" use-attribute-sets="section.properties"&gt;
10380 &lt;/xsl:attribute-set&gt;
10381 </programlisting>
10382 </refsynopsisdiv>
10383
10384 <refsection><info><title>Description</title></info>
10385
10386 <para>The properties that apply to the containing
10387 block of a level 6 or lower section, and therefore apply to
10388 the whole section.  This includes 
10389 <tag>section</tag> elements at level 6 and lower.
10390 </para>
10391
10392 <para>For example, you could start each level-6 section on
10393 a new page by using:</para>
10394 <programlisting>&lt;xsl:attribute-set name="section.level6.properties"&gt;
10395   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;
10396 &lt;/xsl:attribute-set&gt;
10397 </programlisting>
10398
10399 <para>This attribute set inherits attributes from the
10400 general <tag>section.properties</tag> attribute set.
10401 </para>
10402
10403 </refsection>
10404 </refentry>
10405
10406 <refentry version="5.0" xml:id="figure.properties">
10407 <refmeta>
10408 <refentrytitle>figure.properties</refentrytitle>
10409 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10410 </refmeta>  
10411 <refnamediv>
10412 <refname>figure.properties</refname>
10413 <refpurpose>Properties associated with a figure</refpurpose>
10414 </refnamediv>
10415
10416 <refsynopsisdiv>
10417 <programlisting xml:id="figure.properties.frag">
10418 &lt;xsl:attribute-set name="figure.properties" use-attribute-sets="formal.object.properties"&gt;&lt;/xsl:attribute-set&gt;
10419 </programlisting>
10420 </refsynopsisdiv>
10421
10422 <refsection><info><title>Description</title></info>
10423
10424 <para>The styling for figures.</para>
10425
10426 </refsection>
10427 </refentry>
10428
10429 <refentry version="5.0" xml:id="example.properties">
10430 <refmeta>
10431 <refentrytitle>example.properties</refentrytitle>
10432 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10433 </refmeta>
10434 <refnamediv>
10435 <refname>example.properties</refname>
10436 <refpurpose>Properties associated with a example</refpurpose>
10437 </refnamediv>
10438
10439 <refsynopsisdiv>
10440 <programlisting xml:id="example.properties.frag">
10441 &lt;xsl:attribute-set name="example.properties" use-attribute-sets="formal.object.properties"&gt;&lt;/xsl:attribute-set&gt;
10442 </programlisting>
10443 </refsynopsisdiv>
10444
10445 <refsection><info><title>Description</title></info>
10446
10447 <para>The styling for examples.</para>
10448
10449 </refsection>
10450 </refentry>
10451
10452 <refentry version="5.0" xml:id="equation.properties">
10453 <refmeta>
10454 <refentrytitle>equation.properties</refentrytitle>
10455 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10456 </refmeta>
10457 <refnamediv>
10458 <refname>equation.properties</refname>
10459 <refpurpose>Properties associated with a equation</refpurpose>
10460 </refnamediv>
10461
10462 <refsynopsisdiv>
10463 <programlisting xml:id="equation.properties.frag">
10464 &lt;xsl:attribute-set name="equation.properties" use-attribute-sets="formal.object.properties"&gt;&lt;/xsl:attribute-set&gt;
10465 </programlisting>
10466 </refsynopsisdiv>
10467
10468 <refsection><info><title>Description</title></info>
10469
10470 <para>The styling for equations.</para>
10471
10472 </refsection>
10473 </refentry>
10474
10475 <refentry version="5.0" xml:id="equation.number.properties">
10476 <refmeta>
10477 <refentrytitle>equation.number.properties</refentrytitle>
10478 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10479 </refmeta>
10480 <refnamediv>
10481 <refname>equation.number.properties</refname>
10482 <refpurpose>Properties that apply to the <tag>fo:table-cell</tag> containing the number
10483 of an <tag>equation</tag> that does not have a title.</refpurpose>
10484 </refnamediv>
10485
10486 <refsynopsisdiv>
10487 <programlisting xml:id="equation.number.properties.frag">&lt;xsl:attribute-set name="equation.number.properties"&gt;
10488   &lt;xsl:attribute name="text-align"&gt;end&lt;/xsl:attribute&gt;
10489   &lt;xsl:attribute name="display-align"&gt;center&lt;/xsl:attribute&gt;
10490 &lt;/xsl:attribute-set&gt;</programlisting>
10491 </refsynopsisdiv>
10492 <refsection><info><title>Description</title></info>
10493 <para>Properties that apply to the fo:table-cell containing the number
10494 of an equation when it has no title. The number in an equation with a
10495 title is formatted along with the title, and this attribute-set does not apply.</para>
10496 </refsection>
10497 </refentry>
10498
10499 <refentry version="5.0" xml:id="table.properties">
10500 <refmeta>
10501 <refentrytitle>table.properties</refentrytitle>
10502 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10503 </refmeta>
10504 <refnamediv>
10505 <refname>table.properties</refname>
10506 <refpurpose>Properties associated with the block surrounding a table</refpurpose>
10507 </refnamediv>
10508
10509 <refsynopsisdiv>
10510 <programlisting xml:id="table.properties.frag">
10511 &lt;xsl:attribute-set name="table.properties" use-attribute-sets="formal.object.properties"&gt;
10512   &lt;xsl:attribute name="keep-together.within-column"&gt;auto&lt;/xsl:attribute&gt;
10513 &lt;/xsl:attribute-set&gt;
10514 </programlisting>
10515 </refsynopsisdiv>
10516
10517 <refsection><info><title>Description</title></info>
10518
10519 <para>Block styling properties for tables. This parameter should really
10520 have been called <literal>table.block.properties</literal> or something
10521 like that, but we&#8217;re leaving it to avoid backwards-compatibility
10522 problems.</para>
10523
10524 <para>See also <parameter>table.table.properties</parameter>.</para>
10525
10526 </refsection>
10527 </refentry>
10528
10529 <refentry version="5.0" xml:id="informalfigure.properties">
10530 <refmeta>
10531 <refentrytitle>informalfigure.properties</refentrytitle>
10532 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10533 </refmeta>
10534 <refnamediv>
10535 <refname>informalfigure.properties</refname>
10536 <refpurpose>Properties associated with an informalfigure</refpurpose>
10537 </refnamediv>
10538
10539 <refsynopsisdiv>
10540 <programlisting xml:id="informalfigure.properties.frag">
10541 &lt;xsl:attribute-set name="informalfigure.properties" use-attribute-sets="informal.object.properties"&gt;&lt;/xsl:attribute-set&gt;
10542 </programlisting>
10543 </refsynopsisdiv>
10544
10545 <refsection><info><title>Description</title></info>
10546
10547 <para>The styling for informalfigures.</para>
10548
10549 </refsection>
10550 </refentry>
10551
10552 <refentry version="5.0" xml:id="informalexample.properties">
10553 <refmeta>
10554 <refentrytitle>informalexample.properties</refentrytitle>
10555 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10556 </refmeta>
10557 <refnamediv>
10558 <refname>informalexample.properties</refname>
10559 <refpurpose>Properties associated with an informalexample</refpurpose>
10560 </refnamediv>
10561
10562 <refsynopsisdiv>
10563 <programlisting xml:id="informalexample.properties.frag">
10564 &lt;xsl:attribute-set name="informalexample.properties" use-attribute-sets="informal.object.properties"&gt;&lt;/xsl:attribute-set&gt;
10565 </programlisting>
10566 </refsynopsisdiv>
10567
10568 <refsection><info><title>Description</title></info>
10569
10570 <para>The styling for informalexamples.</para>
10571
10572 </refsection>
10573 </refentry>
10574
10575 <refentry version="5.0" xml:id="informalequation.properties">
10576 <refmeta>
10577 <refentrytitle>informalequation.properties</refentrytitle>
10578 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10579 </refmeta>
10580 <refnamediv>
10581 <refname>informalequation.properties</refname>
10582 <refpurpose>Properties associated with an informalequation</refpurpose>
10583 </refnamediv>
10584
10585 <refsynopsisdiv>
10586 <programlisting xml:id="informalequation.properties.frag">
10587 &lt;xsl:attribute-set name="informalequation.properties" use-attribute-sets="informal.object.properties"&gt;&lt;/xsl:attribute-set&gt;
10588 </programlisting>
10589 </refsynopsisdiv>
10590
10591 <refsection><info><title>Description</title></info>
10592
10593 <para>The styling for informalequations.</para>
10594
10595 </refsection>
10596 </refentry>
10597
10598 <refentry version="5.0" xml:id="informaltable.properties">
10599 <refmeta>
10600 <refentrytitle>informaltable.properties</refentrytitle>
10601 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10602 </refmeta>
10603 <refnamediv>
10604 <refname>informaltable.properties</refname>
10605 <refpurpose>Properties associated with the block surrounding an informaltable</refpurpose>
10606 </refnamediv>
10607
10608 <refsynopsisdiv>
10609 <programlisting xml:id="informaltable.properties.frag">
10610 &lt;xsl:attribute-set name="informaltable.properties" use-attribute-sets="informal.object.properties"&gt;&lt;/xsl:attribute-set&gt;
10611 </programlisting>
10612 </refsynopsisdiv>
10613
10614 <refsection><info><title>Description</title></info>
10615
10616 <para>Block styling properties for informaltables. This parameter should really
10617 have been called <literal>informaltable.block.properties</literal> or something
10618 like that, but we&#8217;re leaving it to avoid backwards-compatibility
10619 problems.</para>
10620
10621 <para>See also <parameter>table.table.properties</parameter>.</para>
10622
10623 </refsection>
10624 </refentry>
10625
10626 <refentry version="5.0" xml:id="procedure.properties">
10627 <refmeta>
10628 <refentrytitle>procedure.properties</refentrytitle>
10629 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10630 </refmeta>
10631 <refnamediv>
10632 <refname>procedure.properties</refname>
10633 <refpurpose>Properties associated with a procedure</refpurpose>
10634 </refnamediv>
10635
10636 <refsynopsisdiv>
10637 <programlisting xml:id="procedure.properties.frag">
10638 &lt;xsl:attribute-set name="procedure.properties" use-attribute-sets="formal.object.properties"&gt;
10639   &lt;xsl:attribute name="keep-together.within-column"&gt;auto&lt;/xsl:attribute&gt;
10640 &lt;/xsl:attribute-set&gt;
10641 </programlisting>
10642 </refsynopsisdiv>
10643
10644 <refsection><info><title>Description</title></info>
10645
10646 <para>The styling for procedures.</para>
10647
10648 </refsection>
10649 </refentry>
10650
10651 <refentry version="5.0" xml:id="root.properties">
10652 <refmeta>
10653 <refentrytitle>root.properties</refentrytitle>
10654 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10655 </refmeta>
10656 <refnamediv>
10657 <refname>root.properties</refname>
10658 <refpurpose>The properties of the fo:root element</refpurpose>
10659 </refnamediv>
10660
10661 <refsynopsisdiv>
10662 <programlisting xml:id="root.properties.frag">
10663 &lt;xsl:attribute-set name="root.properties"&gt;
10664   &lt;xsl:attribute name="font-family"&gt;
10665     &lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;
10666   &lt;/xsl:attribute&gt;
10667   &lt;xsl:attribute name="font-size"&gt;
10668     &lt;xsl:value-of select="$body.font.size"&gt;&lt;/xsl:value-of&gt;
10669   &lt;/xsl:attribute&gt;
10670   &lt;xsl:attribute name="text-align"&gt;
10671     &lt;xsl:value-of select="$alignment"&gt;&lt;/xsl:value-of&gt;
10672   &lt;/xsl:attribute&gt;
10673   &lt;xsl:attribute name="line-height"&gt;
10674     &lt;xsl:value-of select="$line-height"&gt;&lt;/xsl:value-of&gt;
10675   &lt;/xsl:attribute&gt;
10676   &lt;xsl:attribute name="font-selection-strategy"&gt;character-by-character&lt;/xsl:attribute&gt;
10677   &lt;xsl:attribute name="line-height-shift-adjustment"&gt;disregard-shifts&lt;/xsl:attribute&gt;
10678   &lt;xsl:attribute name="writing-mode"&gt;
10679     &lt;xsl:value-of select="$direction.mode"&gt;&lt;/xsl:value-of&gt;
10680   &lt;/xsl:attribute&gt;
10681 &lt;/xsl:attribute-set&gt;
10682 </programlisting>
10683 </refsynopsisdiv>
10684
10685 <refsection><info><title>Description</title></info>
10686
10687 <para>This property set is used on the <tag>fo:root</tag> element of
10688 an FO file. It defines a set of default, global parameters.</para>
10689
10690 </refsection>
10691 </refentry>
10692
10693 <refentry version="5.0" xml:id="qanda.title.properties">
10694 <refmeta>
10695 <refentrytitle>qanda.title.properties</refentrytitle>
10696 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10697 </refmeta>
10698 <refnamediv>
10699 <refname>qanda.title.properties</refname>
10700 <refpurpose>Properties for qanda set titles</refpurpose>
10701 </refnamediv>
10702
10703 <refsynopsisdiv>
10704 <programlisting xml:id="qanda.title.properties.frag">
10705 &lt;xsl:attribute-set name="qanda.title.properties"&gt;
10706   &lt;xsl:attribute name="font-family"&gt;
10707     &lt;xsl:value-of select="$title.font.family"&gt;&lt;/xsl:value-of&gt;
10708   &lt;/xsl:attribute&gt;
10709   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
10710   &lt;!-- font size is calculated dynamically by qanda.heading template --&gt;
10711   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
10712   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;
10713   &lt;xsl:attribute name="space-before.optimum"&gt;1.0em&lt;/xsl:attribute&gt;
10714   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;
10715 &lt;/xsl:attribute-set&gt;
10716 </programlisting>
10717 </refsynopsisdiv>
10718
10719 <refsection><info><title>Description</title></info>
10720
10721 <para>The properties common to all qanda set titles.</para>
10722
10723 </refsection>
10724 </refentry>
10725
10726 <refentry version="5.0" xml:id="qanda.title.level1.properties">
10727 <refmeta>
10728 <refentrytitle>qanda.title.level1.properties</refentrytitle>
10729 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10730 </refmeta>
10731 <refnamediv>
10732 <refname>qanda.title.level1.properties</refname>
10733 <refpurpose>Properties for level-1 qanda set titles</refpurpose>
10734 </refnamediv>
10735
10736 <refsynopsisdiv>
10737 <programlisting xml:id="qanda.title.level1.properties.frag">
10738 &lt;xsl:attribute-set name="qanda.title.level1.properties"&gt;
10739   &lt;xsl:attribute name="font-size"&gt;
10740     &lt;xsl:value-of select="$body.font.master * 2.0736"&gt;&lt;/xsl:value-of&gt;
10741     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
10742   &lt;/xsl:attribute&gt;
10743 &lt;/xsl:attribute-set&gt;
10744 </programlisting>
10745 </refsynopsisdiv>
10746
10747 <refsection><info><title>Description</title></info>
10748
10749 <para>The properties of level-1 qanda set titles.</para>
10750
10751 </refsection>
10752 </refentry>
10753
10754 <refentry version="5.0" xml:id="qanda.title.level2.properties">
10755 <refmeta>
10756 <refentrytitle>qanda.title.level2.properties</refentrytitle>
10757 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10758 </refmeta>
10759 <refnamediv>
10760 <refname>qanda.title.level2.properties</refname>
10761 <refpurpose>Properties for level-2 qanda set titles</refpurpose>
10762 </refnamediv>
10763
10764 <refsynopsisdiv>
10765 <programlisting xml:id="qanda.title.level2.properties.frag">
10766 &lt;xsl:attribute-set name="qanda.title.level2.properties"&gt;
10767   &lt;xsl:attribute name="font-size"&gt;
10768     &lt;xsl:value-of select="$body.font.master * 1.728"&gt;&lt;/xsl:value-of&gt;
10769     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
10770   &lt;/xsl:attribute&gt;
10771 &lt;/xsl:attribute-set&gt;
10772 </programlisting>
10773 </refsynopsisdiv>
10774
10775 <refsection><info><title>Description</title></info>
10776
10777 <para>The properties of level-2 qanda set titles.</para>
10778
10779 </refsection>
10780 </refentry>
10781
10782 <refentry version="5.0" xml:id="qanda.title.level3.properties">
10783 <refmeta>
10784 <refentrytitle>qanda.title.level3.properties</refentrytitle>
10785 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10786 </refmeta>
10787 <refnamediv>
10788 <refname>qanda.title.level3.properties</refname>
10789 <refpurpose>Properties for level-3 qanda set titles</refpurpose>
10790 </refnamediv>
10791
10792 <refsynopsisdiv>
10793 <programlisting xml:id="qanda.title.level3.properties.frag">
10794 &lt;xsl:attribute-set name="qanda.title.level3.properties"&gt;
10795   &lt;xsl:attribute name="font-size"&gt;
10796     &lt;xsl:value-of select="$body.font.master * 1.44"&gt;&lt;/xsl:value-of&gt;
10797     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
10798   &lt;/xsl:attribute&gt;
10799 &lt;/xsl:attribute-set&gt;
10800 </programlisting>
10801 </refsynopsisdiv>
10802
10803 <refsection><info><title>Description</title></info>
10804
10805 <para>The properties of level-3 qanda set titles.</para>
10806
10807 </refsection>
10808 </refentry>
10809
10810 <refentry version="5.0" xml:id="qanda.title.level4.properties">
10811 <refmeta>
10812 <refentrytitle>qanda.title.level4.properties</refentrytitle>
10813 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10814 </refmeta>
10815 <refnamediv>
10816 <refname>qanda.title.level4.properties</refname>
10817 <refpurpose>Properties for level-4 qanda set titles</refpurpose>
10818 </refnamediv>
10819
10820 <refsynopsisdiv>
10821 <programlisting xml:id="qanda.title.level4.properties.frag">
10822 &lt;xsl:attribute-set name="qanda.title.level4.properties"&gt;
10823   &lt;xsl:attribute name="font-size"&gt;
10824     &lt;xsl:value-of select="$body.font.master * 1.2"&gt;&lt;/xsl:value-of&gt;
10825     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
10826   &lt;/xsl:attribute&gt;
10827 &lt;/xsl:attribute-set&gt;
10828 </programlisting>
10829 </refsynopsisdiv>
10830
10831 <refsection><info><title>Description</title></info>
10832
10833 <para>The properties of level-4 qanda set titles.</para>
10834
10835 </refsection>
10836 </refentry>
10837
10838 <refentry version="5.0" xml:id="qanda.title.level5.properties">
10839 <refmeta>
10840 <refentrytitle>qanda.title.level5.properties</refentrytitle>
10841 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10842 </refmeta>
10843 <refnamediv>
10844 <refname>qanda.title.level5.properties</refname>
10845 <refpurpose>Properties for level-5 qanda set titles</refpurpose>
10846 </refnamediv>
10847
10848 <refsynopsisdiv>
10849 <programlisting xml:id="qanda.title.level5.properties.frag">
10850 &lt;xsl:attribute-set name="qanda.title.level5.properties"&gt;
10851   &lt;xsl:attribute name="font-size"&gt;
10852     &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;
10853     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
10854   &lt;/xsl:attribute&gt;
10855 &lt;/xsl:attribute-set&gt;
10856 </programlisting>
10857 </refsynopsisdiv>
10858
10859 <refsection><info><title>Description</title></info>
10860
10861 <para>The properties of level-5 qanda set titles.</para>
10862
10863 </refsection>
10864 </refentry>
10865
10866 <refentry version="5.0" xml:id="qanda.title.level6.properties">
10867 <refmeta>
10868 <refentrytitle>qanda.title.level6.properties</refentrytitle>
10869 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10870 </refmeta>
10871 <refnamediv>
10872 <refname>qanda.title.level6.properties</refname>
10873 <refpurpose>Properties for level-6 qanda set titles</refpurpose>
10874 </refnamediv>
10875
10876 <refsynopsisdiv>
10877 <programlisting xml:id="qanda.title.level6.properties.frag">
10878 &lt;xsl:attribute-set name="qanda.title.level6.properties"&gt;
10879   &lt;xsl:attribute name="font-size"&gt;
10880     &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;
10881     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;
10882   &lt;/xsl:attribute&gt;
10883 &lt;/xsl:attribute-set&gt;
10884 </programlisting>
10885 </refsynopsisdiv>
10886
10887 <refsection><info><title>Description</title></info>
10888
10889 <para>The properties of level-6 qanda set titles.
10890 This property set is actually
10891 used for all titles below level 5.</para>
10892
10893 </refsection>
10894 </refentry>
10895
10896 <refentry version="5.0" xml:id="article.appendix.title.properties">
10897 <refmeta>
10898 <refentrytitle>article.appendix.title.properties</refentrytitle>
10899 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10900 </refmeta>
10901 <refnamediv>
10902 <refname>article.appendix.title.properties</refname>
10903 <refpurpose>Properties for appendix titles that appear in an article</refpurpose>
10904 </refnamediv>
10905
10906 <refsynopsisdiv>
10907 <programlisting xml:id="article.appendix.title.properties.frag">
10908 &lt;xsl:attribute-set name="article.appendix.title.properties" use-attribute-sets="section.title.properties                          section.title.level1.properties"&gt;
10909   &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;
10910     &lt;xsl:value-of select="$title.margin.left"&gt;&lt;/xsl:value-of&gt;
10911   &lt;/xsl:attribute&gt;
10912 &lt;/xsl:attribute-set&gt;
10913 </programlisting>
10914 </refsynopsisdiv>
10915
10916 <refsection><info><title>Description</title></info>
10917
10918 <para>The properties for the title of an appendix that
10919 appears inside an article.  The default is to use
10920 the properties of sect1 titles.</para>
10921
10922 </refsection>
10923 </refentry>
10924
10925 <refentry version="5.0" xml:id="abstract.properties">
10926 <refmeta>
10927 <refentrytitle>abstract.properties</refentrytitle>
10928 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10929 </refmeta>
10930 <refnamediv>
10931 <refname>abstract.properties</refname>
10932 <refpurpose>Properties associated with the block surrounding an abstract</refpurpose>
10933 </refnamediv>
10934
10935 <refsynopsisdiv>
10936 <programlisting xml:id="abstract.properties.frag">
10937 &lt;xsl:attribute-set name="abstract.properties"&gt;
10938   &lt;xsl:attribute name="start-indent"&gt;0.0in&lt;/xsl:attribute&gt;
10939   &lt;xsl:attribute name="end-indent"&gt;0.0in&lt;/xsl:attribute&gt;
10940 &lt;/xsl:attribute-set&gt;
10941 </programlisting>
10942 </refsynopsisdiv>
10943
10944 <refsection><info><title>Description</title></info>
10945
10946 <para>Block styling properties for abstract.</para>
10947
10948 <para>See also <parameter>abstract.title.properties</parameter>.</para>
10949
10950 </refsection>
10951 </refentry>
10952
10953 <refentry version="5.0" xml:id="abstract.title.properties">
10954 <refmeta>
10955 <refentrytitle>abstract.title.properties</refentrytitle>
10956 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10957 </refmeta>
10958 <refnamediv>
10959 <refname>abstract.title.properties</refname>
10960 <refpurpose>Properties for abstract titles</refpurpose>
10961 </refnamediv>
10962
10963 <refsynopsisdiv>
10964 <programlisting xml:id="abstract.title.properties.frag">
10965 &lt;xsl:attribute-set name="abstract.title.properties"&gt;
10966   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$title.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;
10967   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;
10968   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
10969   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;
10970   &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;
10971   &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;
10972   &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;
10973   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;
10974   &lt;xsl:attribute name="text-align"&gt;center&lt;/xsl:attribute&gt;
10975 &lt;/xsl:attribute-set&gt;
10976 </programlisting>
10977 </refsynopsisdiv>
10978
10979 <refsection><info><title>Description</title></info>
10980
10981 <para>The properties for abstract titles.</para>
10982
10983 <para>See also <parameter>abstract.properties</parameter>.</para>
10984
10985 </refsection>
10986 </refentry>
10987
10988 <refentry version="5.0" xml:id="index.page.number.properties">
10989 <refmeta>
10990 <refentrytitle>index.page.number.properties</refentrytitle>
10991 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10992 </refmeta>
10993 <refnamediv>
10994 <refname>index.page.number.properties</refname>
10995 <refpurpose>Properties associated with index page numbers</refpurpose>
10996 </refnamediv>
10997
10998 <refsynopsisdiv>
10999 <programlisting xml:id="index.page.number.properties.frag">
11000 &lt;xsl:attribute-set name="index.page.number.properties"&gt;
11001 &lt;/xsl:attribute-set&gt;
11002 </programlisting>
11003 </refsynopsisdiv>
11004
11005 <refsection><info><title>Description</title></info>
11006
11007 <para>Properties associated with page numbers in indexes. 
11008 Changing color to indicate the page number is a link is
11009 one possibility.
11010 </para>
11011
11012 </refsection>
11013 </refentry>
11014
11015 <refentry version="5.0" xml:id="revhistory.table.properties">
11016 <refmeta>
11017 <refentrytitle>revhistory.table.properties</refentrytitle>
11018 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11019 </refmeta>
11020 <refnamediv>
11021 <refname>revhistory.table.properties</refname>
11022 <refpurpose>The properties of table used for formatting revhistory</refpurpose>
11023 </refnamediv>
11024
11025 <refsynopsisdiv>
11026 <programlisting xml:id="revhistory.table.properties.frag">
11027 &lt;xsl:attribute-set name="revhistory.table.properties"&gt;
11028 &lt;/xsl:attribute-set&gt;
11029 </programlisting>
11030 </refsynopsisdiv>
11031
11032 <refsection><info><title>Description</title></info>
11033
11034 <para>This property set defines appearance of revhistory table.</para>
11035
11036 </refsection>
11037 </refentry>
11038
11039 <refentry version="5.0" xml:id="revhistory.table.cell.properties">
11040 <refmeta>
11041 <refentrytitle>revhistory.table.cell.properties</refentrytitle>
11042 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11043 </refmeta>
11044 <refnamediv>
11045 <refname>revhistory.table.cell.properties</refname>
11046 <refpurpose>The properties of table cells used for formatting revhistory</refpurpose>
11047 </refnamediv>
11048
11049 <refsynopsisdiv>
11050 <programlisting xml:id="revhistory.table.cell.properties.frag">
11051 &lt;xsl:attribute-set name="revhistory.table.cell.properties"&gt;
11052 &lt;/xsl:attribute-set&gt;
11053 </programlisting>
11054 </refsynopsisdiv>
11055
11056 <refsection><info><title>Description</title></info>
11057
11058 <para>This property set defines appearance of individual cells in revhistory table.</para>
11059
11060 </refsection>
11061 </refentry>
11062
11063 <refentry version="5.0" xml:id="revhistory.title.properties">
11064 <refmeta>
11065 <refentrytitle>revhistory.title.properties</refentrytitle>
11066 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
11067 </refmeta>
11068 <refnamediv>
11069 <refname>revhistory.title.properties</refname>
11070 <refpurpose>The properties of revhistory title</refpurpose>
11071 </refnamediv>
11072
11073 <refsynopsisdiv>
11074 <programlisting xml:id="revhistory.title.properties.frag">
11075 &lt;xsl:attribute-set name="revhistory.title.properties"&gt;
11076 &lt;/xsl:attribute-set&gt;
11077 </programlisting>
11078 </refsynopsisdiv>
11079
11080 <refsection><info><title>Description</title></info>
11081
11082 <para>This property set defines appearance of revhistory title.</para>
11083
11084 </refsection>
11085 </refentry>
11086
11087 </reference>
11088 <reference xml:id="profiling"><title>Profiling</title>
11089 <partintro xml:id="profiling_partintro">
11090 <para>The following parameters can be used for attribute-based
11091 profiling of your document. For more information about profiling, see 
11092 <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="Profiling.html">Profiling (conditional text)</link>.</para>
11093 </partintro>
11094 <refentry version="5.0" xml:id="profile.arch">
11095 <refmeta>
11096 <refentrytitle>profile.arch</refentrytitle>
11097 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11098 </refmeta>
11099 <refnamediv>
11100 <refname>profile.arch</refname>
11101 <refpurpose>Target profile for <tag class="attribute">arch</tag>
11102 attribute</refpurpose>
11103 </refnamediv>
11104
11105 <refsynopsisdiv>
11106 <programlisting xml:id="profile.arch.frag">
11107 &lt;xsl:param name="profile.arch"&gt;&lt;/xsl:param&gt;
11108 </programlisting>
11109 </refsynopsisdiv>
11110
11111
11112 <refsection><info><title>Description</title></info>
11113
11114 <para>The value of this parameter specifies profiles which should be
11115 included in the output. You can specify multiple profiles by
11116 separating them by semicolon. You can change separator character by
11117 <parameter>profile.separator</parameter>
11118 parameter.</para>
11119
11120 <para>This parameter has effect only when you are using profiling
11121 stylesheets (<filename>profile-docbook.xsl</filename>,
11122 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11123 ones (<filename>docbook.xsl</filename>,
11124 <filename>chunk.xsl</filename>, &#8230;).</para>
11125
11126 </refsection>
11127 </refentry>
11128
11129 <refentry version="5.0" xml:id="profile.audience">
11130 <refmeta>
11131 <refentrytitle>profile.audience</refentrytitle>
11132 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11133 </refmeta>
11134 <refnamediv>
11135 <refname>profile.audience</refname>
11136 <refpurpose>Target profile for <tag class="attribute">audience</tag>
11137 attribute</refpurpose>
11138 </refnamediv>
11139
11140 <refsynopsisdiv>
11141 <programlisting xml:id="profile.audience.frag">
11142 &lt;xsl:param name="profile.audience"&gt;&lt;/xsl:param&gt;
11143 </programlisting>
11144 </refsynopsisdiv>
11145
11146 <refsection><info><title>Description</title></info>
11147
11148 <para>Value of this parameter specifies profiles which should be
11149 included in the output. You can specify multiple profiles by
11150 separating them by semicolon. You can change separator character by
11151 <parameter>profile.separator</parameter>
11152 parameter.</para>
11153
11154 <para>This parameter has effect only when you are using profiling
11155 stylesheets (<filename>profile-docbook.xsl</filename>,
11156 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11157 ones (<filename>docbook.xsl</filename>,
11158 <filename>chunk.xsl</filename>, &#8230;).</para>
11159
11160 </refsection>
11161 </refentry>
11162
11163 <refentry version="5.0" xml:id="profile.condition">
11164 <refmeta>
11165 <refentrytitle>profile.condition</refentrytitle>
11166 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11167 </refmeta>
11168 <refnamediv>
11169 <refname>profile.condition</refname>
11170 <refpurpose>Target profile for <tag class="attribute">condition</tag>
11171 attribute</refpurpose>
11172 </refnamediv>
11173
11174 <refsynopsisdiv>
11175 <programlisting xml:id="profile.condition.frag">
11176 &lt;xsl:param name="profile.condition"&gt;&lt;/xsl:param&gt;
11177 </programlisting>
11178 </refsynopsisdiv>
11179
11180 <refsection><info><title>Description</title></info>
11181
11182 <para>The value of this parameter specifies profiles which should be
11183 included in the output. You can specify multiple profiles by
11184 separating them by semicolon. You can change separator character by
11185 <parameter>profile.separator</parameter>
11186 parameter.</para>
11187
11188 <para>This parameter has effect only when you are using profiling
11189 stylesheets (<filename>profile-docbook.xsl</filename>,
11190 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11191 ones (<filename>docbook.xsl</filename>,
11192 <filename>chunk.xsl</filename>, &#8230;).</para>
11193
11194 </refsection>
11195 </refentry>
11196
11197 <refentry version="5.0" xml:id="profile.conformance">
11198 <refmeta>
11199 <refentrytitle>profile.conformance</refentrytitle>
11200 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11201 </refmeta>
11202 <refnamediv>
11203 <refname>profile.conformance</refname>
11204 <refpurpose>Target profile for <tag class="attribute">conformance</tag>
11205 attribute</refpurpose>
11206 </refnamediv>
11207
11208 <refsynopsisdiv>
11209 <programlisting xml:id="profile.conformance.frag">
11210 &lt;xsl:param name="profile.conformance"&gt;&lt;/xsl:param&gt;
11211 </programlisting>
11212 </refsynopsisdiv>
11213
11214 <refsection><info><title>Description</title></info>
11215
11216 <para>The value of this parameter specifies profiles which should be
11217 included in the output. You can specify multiple profiles by
11218 separating them by semicolon. You can change separator character by
11219 <parameter>profile.separator</parameter>
11220 parameter.</para>
11221
11222 <para>This parameter has effect only when you are using profiling
11223 stylesheets (<filename>profile-docbook.xsl</filename>,
11224 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11225 ones (<filename>docbook.xsl</filename>,
11226 <filename>chunk.xsl</filename>, &#8230;).</para>
11227
11228 </refsection>
11229 </refentry>
11230
11231 <refentry version="5.0" xml:id="profile.lang">
11232 <refmeta>
11233 <refentrytitle>profile.lang</refentrytitle>
11234 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11235 </refmeta>
11236 <refnamediv>
11237 <refname>profile.lang</refname>
11238 <refpurpose>Target profile for <tag class="attribute">lang</tag>
11239 attribute</refpurpose>
11240 </refnamediv>
11241
11242 <refsynopsisdiv>
11243 <programlisting xml:id="profile.lang.frag">
11244 &lt;xsl:param name="profile.lang"&gt;&lt;/xsl:param&gt;
11245 </programlisting>
11246 </refsynopsisdiv>
11247
11248 <refsection><info><title>Description</title></info>
11249
11250 <para>The value of this parameter specifies profiles which should be
11251 included in the output. You can specify multiple profiles by
11252 separating them by semicolon. You can change separator character by
11253 <parameter>profile.separator</parameter>
11254 parameter.</para>
11255
11256 <para>This parameter has effect only when you are using profiling
11257 stylesheets (<filename>profile-docbook.xsl</filename>,
11258 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11259 ones (<filename>docbook.xsl</filename>,
11260 <filename>chunk.xsl</filename>, &#8230;).</para>
11261
11262 </refsection>
11263 </refentry>
11264
11265 <refentry version="5.0" xml:id="profile.os">
11266 <refmeta>
11267 <refentrytitle>profile.os</refentrytitle>
11268 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11269 </refmeta>
11270 <refnamediv>
11271 <refname>profile.os</refname>
11272 <refpurpose>Target profile for <tag class="attribute">os</tag>
11273 attribute</refpurpose>
11274 </refnamediv>
11275
11276 <refsynopsisdiv>
11277 <programlisting xml:id="profile.os.frag">
11278 &lt;xsl:param name="profile.os"&gt;&lt;/xsl:param&gt;
11279 </programlisting>
11280 </refsynopsisdiv>
11281
11282 <refsection><info><title>Description</title></info>
11283
11284 <para>The value of this parameter specifies profiles which should be
11285 included in the output. You can specify multiple profiles by
11286 separating them by semicolon. You can change separator character by
11287 <parameter>profile.separator</parameter>
11288 parameter.</para>
11289
11290 <para>This parameter has effect only when you are using profiling
11291 stylesheets (<filename>profile-docbook.xsl</filename>,
11292 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11293 ones (<filename>docbook.xsl</filename>,
11294 <filename>chunk.xsl</filename>, &#8230;).</para>
11295
11296 </refsection>
11297 </refentry>
11298
11299 <refentry version="5.0" xml:id="profile.revision">
11300 <refmeta>
11301 <refentrytitle>profile.revision</refentrytitle>
11302 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11303 </refmeta>
11304 <refnamediv>
11305 <refname>profile.revision</refname>
11306 <refpurpose>Target profile for <tag class="attribute">revision</tag>
11307 attribute</refpurpose>
11308 </refnamediv>
11309
11310 <refsynopsisdiv>
11311 <programlisting xml:id="profile.revision.frag">
11312 &lt;xsl:param name="profile.revision"&gt;&lt;/xsl:param&gt;
11313 </programlisting>
11314 </refsynopsisdiv>
11315
11316 <refsection><info><title>Description</title></info>
11317
11318 <para>The value of this parameter specifies profiles which should be
11319 included in the output. You can specify multiple profiles by
11320 separating them by semicolon. You can change separator character by
11321 <parameter>profile.separator</parameter>
11322 parameter.</para>
11323
11324 <para>This parameter has effect only when you are using profiling
11325 stylesheets (<filename>profile-docbook.xsl</filename>,
11326 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11327 ones (<filename>docbook.xsl</filename>,
11328 <filename>chunk.xsl</filename>, &#8230;).</para>
11329
11330 </refsection>
11331 </refentry>
11332
11333 <refentry version="5.0" xml:id="profile.revisionflag">
11334 <refmeta>
11335 <refentrytitle>profile.revisionflag</refentrytitle>
11336 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11337 </refmeta>
11338 <refnamediv>
11339 <refname>profile.revisionflag</refname>
11340 <refpurpose>Target profile for <tag class="attribute">revisionflag</tag>
11341 attribute</refpurpose>
11342 </refnamediv>
11343
11344 <refsynopsisdiv>
11345 <programlisting xml:id="profile.revisionflag.frag">
11346 &lt;xsl:param name="profile.revisionflag"&gt;&lt;/xsl:param&gt;
11347 </programlisting>
11348 </refsynopsisdiv>
11349
11350 <refsection><info><title>Description</title></info>
11351
11352 <para>The value of this parameter specifies profiles which should be
11353 included in the output. You can specify multiple profiles by
11354 separating them by semicolon. You can change separator character by
11355 <parameter>profile.separator</parameter>
11356 parameter.</para>
11357
11358 <para>This parameter has effect only when you are using profiling
11359 stylesheets (<filename>profile-docbook.xsl</filename>,
11360 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11361 ones (<filename>docbook.xsl</filename>,
11362 <filename>chunk.xsl</filename>, &#8230;).</para>
11363
11364 </refsection>
11365 </refentry>
11366
11367 <refentry version="5.0" xml:id="profile.role">
11368 <refmeta>
11369 <refentrytitle>profile.role</refentrytitle>
11370 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11371 </refmeta>
11372 <refnamediv>
11373 <refname>profile.role</refname>
11374 <refpurpose>Target profile for <tag class="attribute">role</tag>
11375 attribute</refpurpose>
11376 </refnamediv>
11377
11378 <refsynopsisdiv>
11379 <programlisting xml:id="profile.role.frag">
11380 &lt;xsl:param name="profile.role"&gt;&lt;/xsl:param&gt;
11381 </programlisting>
11382 </refsynopsisdiv>
11383
11384 <refsection><info><title>Description</title></info>
11385
11386 <para>The value of this parameter specifies profiles which should be
11387 included in the output. You can specify multiple profiles by
11388 separating them by semicolon. You can change separator character by
11389 <parameter>profile.separator</parameter>
11390 parameter.</para>
11391
11392 <para>This parameter has effect only when you are using profiling
11393 stylesheets (<filename>profile-docbook.xsl</filename>,
11394 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11395 ones (<filename>docbook.xsl</filename>,
11396 <filename>chunk.xsl</filename>, &#8230;).</para>
11397
11398 <warning>
11399 <para>Note that <tag class="attribute">role</tag> is often
11400 used for other purposes than profiling. For example it is commonly
11401 used to get emphasize in bold font:</para>
11402
11403 <programlisting>&lt;emphasis role="bold"&gt;very important&lt;/emphasis&gt;</programlisting>
11404
11405 <para>If you are using <tag class="attribute">role</tag> for
11406 these purposes do not forget to add values like <literal>bold</literal> to
11407 value of this parameter. If you forgot you will get document with
11408 small pieces missing which are very hard to track.</para>
11409
11410 <para>For this reason it is not recommended to use <tag class="attribute">role</tag> attribute for profiling. You should
11411 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>
11412 </warning>
11413
11414 </refsection>
11415 </refentry>
11416
11417 <refentry version="5.0" xml:id="profile.security">
11418 <refmeta>
11419 <refentrytitle>profile.security</refentrytitle>
11420 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11421 </refmeta>
11422 <refnamediv>
11423 <refname>profile.security</refname>
11424 <refpurpose>Target profile for <tag class="attribute">security</tag>
11425 attribute</refpurpose>
11426 </refnamediv>
11427
11428 <refsynopsisdiv>
11429 <programlisting xml:id="profile.security.frag">
11430 &lt;xsl:param name="profile.security"&gt;&lt;/xsl:param&gt;
11431 </programlisting>
11432 </refsynopsisdiv>
11433
11434 <refsection><info><title>Description</title></info>
11435
11436 <para>The value of this parameter specifies profiles which should be
11437 included in the output. You can specify multiple profiles by
11438 separating them by semicolon. You can change separator character by
11439 <parameter>profile.separator</parameter>
11440 parameter.</para>
11441
11442 <para>This parameter has effect only when you are using profiling
11443 stylesheets (<filename>profile-docbook.xsl</filename>,
11444 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11445 ones (<filename>docbook.xsl</filename>,
11446 <filename>chunk.xsl</filename>, &#8230;).</para>
11447
11448 </refsection>
11449 </refentry>
11450
11451 <refentry version="5.0" xml:id="profile.status">
11452 <refmeta>
11453 <refentrytitle>profile.status</refentrytitle>
11454 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11455 </refmeta>
11456 <refnamediv>
11457 <refname>profile.status</refname>
11458 <refpurpose>Target profile for <tag class="attribute">status</tag>
11459 attribute</refpurpose>
11460 </refnamediv>
11461
11462 <refsynopsisdiv>
11463 <programlisting xml:id="profile.status.frag">
11464 &lt;xsl:param name="profile.status"&gt;&lt;/xsl:param&gt;
11465 </programlisting>
11466 </refsynopsisdiv>
11467
11468 <refsection><info><title>Description</title></info>
11469
11470 <para>The value of this parameter specifies profiles which should be
11471 included in the output. You can specify multiple profiles by
11472 separating them by semicolon. You can change separator character by
11473 <parameter>profile.separator</parameter>
11474 parameter.</para>
11475
11476 <para>This parameter has effect only when you are using profiling
11477 stylesheets (<filename>profile-docbook.xsl</filename>,
11478 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11479 ones (<filename>docbook.xsl</filename>,
11480 <filename>chunk.xsl</filename>, &#8230;).</para>
11481
11482 </refsection>
11483 </refentry>
11484
11485 <refentry version="5.0" xml:id="profile.userlevel">
11486 <refmeta>
11487 <refentrytitle>profile.userlevel</refentrytitle>
11488 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11489 </refmeta>
11490 <refnamediv>
11491 <refname>profile.userlevel</refname>
11492 <refpurpose>Target profile for <tag class="attribute">userlevel</tag>
11493 attribute</refpurpose>
11494 </refnamediv>
11495
11496 <refsynopsisdiv>
11497 <programlisting xml:id="profile.userlevel.frag">
11498 &lt;xsl:param name="profile.userlevel"&gt;&lt;/xsl:param&gt;
11499 </programlisting>
11500 </refsynopsisdiv>
11501
11502 <refsection><info><title>Description</title></info>
11503
11504 <para>The value of this parameter specifies profiles which should be
11505 included in the output. You can specify multiple profiles by
11506 separating them by semicolon. You can change separator character by
11507 <parameter>profile.separator</parameter>
11508 parameter.</para>
11509
11510 <para>This parameter has effect only when you are using profiling
11511 stylesheets (<filename>profile-docbook.xsl</filename>,
11512 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11513 ones (<filename>docbook.xsl</filename>,
11514 <filename>chunk.xsl</filename>, &#8230;).</para>
11515
11516 </refsection>
11517 </refentry>
11518
11519 <refentry version="5.0" xml:id="profile.vendor">
11520 <refmeta>
11521 <refentrytitle>profile.vendor</refentrytitle>
11522 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11523 </refmeta>
11524 <refnamediv>
11525 <refname>profile.vendor</refname>
11526 <refpurpose>Target profile for <tag class="attribute">vendor</tag>
11527 attribute</refpurpose>
11528 </refnamediv>
11529
11530 <refsynopsisdiv>
11531 <programlisting xml:id="profile.vendor.frag">
11532 &lt;xsl:param name="profile.vendor"&gt;&lt;/xsl:param&gt;
11533 </programlisting>
11534 </refsynopsisdiv>
11535
11536 <refsection><info><title>Description</title></info>
11537
11538 <para>The value of this parameter specifies profiles which should be
11539 included in the output. You can specify multiple profiles by
11540 separating them by semicolon. You can change separator character by
11541 <parameter>profile.separator</parameter>
11542 parameter.</para>
11543
11544 <para>This parameter has effect only when you are using profiling
11545 stylesheets (<filename>profile-docbook.xsl</filename>,
11546 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11547 ones (<filename>docbook.xsl</filename>,
11548 <filename>chunk.xsl</filename>, &#8230;).</para>
11549
11550 </refsection>
11551 </refentry>
11552
11553 <refentry version="5.0" xml:id="profile.wordsize">
11554 <refmeta>
11555 <refentrytitle>profile.wordsize</refentrytitle>
11556 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11557 </refmeta>
11558 <refnamediv>
11559 <refname>profile.wordsize</refname>
11560 <refpurpose>Target profile for <tag class="attribute">wordsize</tag>
11561 attribute</refpurpose>
11562 </refnamediv>
11563
11564 <refsynopsisdiv>
11565 <programlisting xml:id="profile.wordsize.frag">
11566 &lt;xsl:param name="profile.wordsize"&gt;&lt;/xsl:param&gt;
11567 </programlisting>
11568 </refsynopsisdiv>
11569
11570 <refsection><info><title>Description</title></info>
11571
11572 <para>The value of this parameter specifies profiles which should be
11573 included in the output. You can specify multiple profiles by
11574 separating them by semicolon. You can change separator character by
11575 <parameter>profile.separator</parameter>
11576 parameter.</para>
11577
11578 <para>This parameter has effect only when you are using profiling
11579 stylesheets (<filename>profile-docbook.xsl</filename>,
11580 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11581 ones (<filename>docbook.xsl</filename>,
11582 <filename>chunk.xsl</filename>, &#8230;).</para>
11583
11584 </refsection>
11585 </refentry>
11586
11587 <refentry version="5.0" xml:id="profile.attribute">
11588 <refmeta>
11589 <refentrytitle>profile.attribute</refentrytitle>
11590 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11591 </refmeta>
11592 <refnamediv>
11593 <refname>profile.attribute</refname>
11594 <refpurpose>Name of user-specified profiling attribute</refpurpose>
11595 </refnamediv>
11596
11597 <refsynopsisdiv>
11598 <programlisting xml:id="profile.attribute.frag">
11599 &lt;xsl:param name="profile.attribute"&gt;&lt;/xsl:param&gt;
11600 </programlisting>
11601 </refsynopsisdiv>
11602
11603 <refsection><info><title>Description</title></info>
11604
11605 <para>This parameter is used in conjuction with
11606 <parameter>profile.value</parameter>.</para>
11607
11608 <para>This parameter has effect only when you are using profiling
11609 stylesheets (<filename>profile-docbook.xsl</filename>,
11610 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11611 ones (<filename>docbook.xsl</filename>,
11612 <filename>chunk.xsl</filename>, &#8230;).</para>
11613
11614 </refsection>
11615 </refentry>
11616
11617 <refentry version="5.0" xml:id="profile.value">
11618 <refmeta>
11619 <refentrytitle>profile.value</refentrytitle>
11620 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11621 </refmeta>
11622 <refnamediv>
11623 <refname>profile.value</refname>
11624 <refpurpose>Target profile for user-specified attribute</refpurpose>
11625 </refnamediv>
11626
11627 <refsynopsisdiv>
11628 <programlisting xml:id="profile.value.frag">
11629 &lt;xsl:param name="profile.value"&gt;&lt;/xsl:param&gt;
11630 </programlisting>
11631 </refsynopsisdiv>
11632
11633 <refsection><info><title>Description</title></info>
11634
11635 <para>When you are using this parameter you must also specify name of
11636 profiling attribute with parameter
11637 <parameter>profile.attribute</parameter>.</para>
11638
11639 <para>The value of this parameter specifies profiles which should be
11640 included in the output. You can specify multiple profiles by
11641 separating them by semicolon. You can change separator character by
11642 <parameter>profile.separator</parameter>
11643 parameter.</para>
11644
11645 <para>This parameter has effect only when you are using profiling
11646 stylesheets (<filename>profile-docbook.xsl</filename>,
11647 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal
11648 ones (<filename>docbook.xsl</filename>,
11649 <filename>chunk.xsl</filename>, &#8230;).</para>
11650
11651 </refsection>
11652 </refentry>
11653
11654 <refentry version="5.0" xml:id="profile.separator">
11655 <refmeta>
11656 <refentrytitle>profile.separator</refentrytitle>
11657 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11658 </refmeta>
11659 <refnamediv>
11660 <refname>profile.separator</refname>
11661 <refpurpose>Separator character for compound profile values</refpurpose>
11662 </refnamediv>
11663
11664 <refsynopsisdiv>
11665 <programlisting xml:id="profile.separator.frag">
11666 &lt;xsl:param name="profile.separator"&gt;;&lt;/xsl:param&gt;
11667 </programlisting>
11668 </refsynopsisdiv>
11669
11670 <refsection><info><title>Description</title></info>
11671
11672 <para>Separator character used for compound profile values. See <parameter>profile.arch</parameter></para>
11673
11674 </refsection>
11675 </refentry>
11676
11677 </reference>
11678 <reference xml:id="l10n"><title>Localization</title>
11679 <refentry version="5.0" xml:id="l10n.gentext.language">
11680 <refmeta>
11681 <refentrytitle>l10n.gentext.language</refentrytitle>
11682 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11683 </refmeta>
11684 <refnamediv>
11685 <refname>l10n.gentext.language</refname>
11686 <refpurpose>Sets the gentext language</refpurpose>
11687 </refnamediv>
11688
11689 <refsynopsisdiv>
11690 <programlisting xml:id="l10n.gentext.language.frag">
11691 &lt;xsl:param name="l10n.gentext.language"&gt;&lt;/xsl:param&gt;
11692 </programlisting>
11693 </refsynopsisdiv>
11694
11695 <refsection><info><title>Description</title></info>
11696
11697 <para>If this parameter is set to any value other than the empty string, its
11698 value will be used as the value for the language when generating text. Setting
11699 <parameter>l10n.gentext.language</parameter> overrides any settings within the
11700 document being formatted.</para>
11701
11702 <para>It's much more likely that you might want to set the
11703 <parameter>l10n.gentext.default.language</parameter> parameter.</para>
11704
11705 </refsection>
11706 </refentry>
11707
11708 <refentry version="5.0" xml:id="l10n.gentext.default.language">
11709   <refmeta>
11710     <refentrytitle>l10n.gentext.default.language</refentrytitle>
11711     <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11712   </refmeta>
11713   <refnamediv>
11714     <refname>l10n.gentext.default.language</refname>
11715     <refpurpose>Sets the default language for generated text</refpurpose>
11716   </refnamediv>
11717
11718   <refsynopsisdiv>
11719 <programlisting xml:id="l10n.gentext.default.language.frag">
11720 &lt;xsl:param name="l10n.gentext.default.language"&gt;en&lt;/xsl:param&gt;
11721 </programlisting>
11722 </refsynopsisdiv>
11723
11724 <refsection><info><title>Description</title></info>
11725
11726 <para>The value of the <parameter>l10n.gentext.default.language</parameter>
11727 parameter is used as the language for generated text if no setting is provided
11728 in the source document.</para>
11729
11730 </refsection>
11731 </refentry>
11732
11733 <refentry version="5.0" xml:id="l10n.gentext.use.xref.language">
11734 <refmeta>
11735 <refentrytitle>l10n.gentext.use.xref.language</refentrytitle>
11736 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
11737 </refmeta>
11738 <refnamediv>
11739 <refname>l10n.gentext.use.xref.language</refname>
11740 <refpurpose>Use the language of target when generating cross-reference text?</refpurpose>
11741 </refnamediv>
11742
11743 <refsynopsisdiv>
11744 <programlisting xml:id="l10n.gentext.use.xref.language.frag">
11745 &lt;xsl:param name="l10n.gentext.use.xref.language" select="0"&gt;&lt;/xsl:param&gt;
11746 </programlisting>
11747 </refsynopsisdiv>
11748
11749 <refsection><info><title>Description</title></info>
11750
11751 <para>If non-zero, the language of the target will be used when
11752 generating cross reference text. Usually, the <quote>current</quote>
11753 language is used when generating text (that is, the language of the
11754 element that contains the cross-reference element). But setting this parameter
11755 allows the language of the element <emphasis>pointed to</emphasis> to control
11756 the generated text.</para>
11757
11758 <para>Consider the following example:</para>
11759
11760 <informalexample>
11761 <programlisting>&lt;para lang="en"&gt;See also &lt;xref linkend="chap3"/&gt;.&lt;/para&gt;
11762 </programlisting>
11763 </informalexample>
11764
11765 <para>Suppose that Chapter 3 happens to be written in German.
11766 If <parameter>l10n.gentext.use.xref.language</parameter> is non-zero, the
11767 resulting text will be something like this:</para>
11768
11769 <blockquote>
11770 <para>See also Kapital 3.</para>
11771 </blockquote>
11772
11773 <para>Where the more traditional rendering would be:</para>
11774
11775 <blockquote>
11776 <para>See also Chapter 3.</para>
11777 </blockquote>
11778
11779 </refsection>
11780 </refentry>
11781
11782 <refentry version="5.0" xml:id="l10n.lang.value.rfc.compliant">
11783 <refmeta>
11784 <refentrytitle>l10n.lang.value.rfc.compliant</refentrytitle>
11785 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
11786 </refmeta>
11787 <refnamediv>
11788 <refname>l10n.lang.value.rfc.compliant</refname>
11789 <refpurpose>Make value of lang attribute RFC compliant?</refpurpose>
11790 </refnamediv>
11791
11792 <refsynopsisdiv>
11793 <programlisting xml:id="l10n.lang.value.rfc.compliant.frag">
11794 &lt;xsl:param name="l10n.lang.value.rfc.compliant" select="1"&gt;&lt;/xsl:param&gt;
11795 </programlisting>
11796 </refsynopsisdiv>
11797
11798 <refsection><info><title>Description</title></info>
11799
11800 <para>If non-zero, ensure that the values for all <tag class="attribute">lang</tag> attributes in HTML output are RFC
11801 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:
11802
11803 <blockquote><para>[RFC1766] defines and explains the language codes
11804 that must be used in HTML documents.</para>
11805 <para>Briefly, language codes consist of a primary code and a possibly
11806 empty series of subcodes:
11807
11808 <literallayout class="monospaced">language-code = primary-code ( "-" subcode )*</literallayout>
11809 </para>
11810 <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
11811 of Languages</link>, the EBNF for "language tag" is given as:
11812
11813 <literallayout class="monospaced">Language-Tag = Primary-tag *( "-" Subtag )
11814 Primary-tag = 1*8ALPHA
11815 Subtag = 1*8ALPHA</literallayout>
11816 </para>
11817 </blockquote>
11818 </para></footnote>.
11819
11820 by taking any underscore characters in any <tag class="attribute">lang</tag> values found in source documents, and
11821 replacing them with hyphen characters in output HTML files. For
11822 example, <literal>zh_CN</literal> in a source document becomes
11823 <literal>zh-CN</literal> in the HTML output form that source.
11824
11825 <note>
11826 <para>This parameter does not cause any case change in <tag class="attribute">lang</tag> values, because RFC 1766
11827 explicitly states that all "language tags" (as it calls them) "are
11828 to be treated as case insensitive".</para>
11829 </note>
11830 </para>
11831
11832 </refsection>
11833 </refentry>
11834
11835 <refentry version="5.0" xml:id="writing.mode">
11836 <refmeta>
11837 <refentrytitle>writing.mode</refentrytitle>
11838 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
11839 </refmeta>
11840 <refnamediv>
11841 <refname>writing.mode</refname>
11842 <refpurpose>Direction of text flow based on locale</refpurpose>
11843 </refnamediv>
11844
11845 <refsynopsisdiv>
11846 <programlisting xml:id="writing.mode.frag">
11847 &lt;xsl:param name="writing.mode"&gt;
11848   &lt;xsl:call-template name="gentext"&gt;
11849     &lt;xsl:with-param name="key"&gt;writing-mode&lt;/xsl:with-param&gt;
11850     &lt;xsl:with-param name="lang"&gt;
11851       &lt;xsl:call-template name="l10n.language"&gt;
11852         &lt;xsl:with-param name="target" select="/*[1]"&gt;&lt;/xsl:with-param&gt;
11853       &lt;/xsl:call-template&gt;
11854     &lt;/xsl:with-param&gt;
11855   &lt;/xsl:call-template&gt;
11856 &lt;/xsl:param&gt;
11857 </programlisting>
11858 </refsynopsisdiv>
11859
11860 <refsection><info><title>Description</title></info>
11861
11862 <para>Sets direction of text flow and text alignment based on locale.
11863 The value is normally taken from the gentext file for the 
11864 lang attribute of the document's root element, using the 
11865 key name 'writing-mode' to look it up in the gentext file.
11866 But the param can also be
11867 set on the command line to override that gentext value.
11868 </para>
11869 <para>Accepted values are:
11870 <variablelist>
11871   <varlistentry>
11872     <term>lr-tb</term>
11873     <listitem>
11874       <para>Left-to-right text flow in each line, lines stack top to bottom.</para>
11875     </listitem>
11876   </varlistentry>
11877   <varlistentry>
11878     <term>rl-tb</term>
11879     <listitem>
11880       <para>Right-to-left text flow in each line, lines stack top to bottom.</para>
11881     </listitem>
11882   </varlistentry>
11883   <varlistentry>
11884     <term>tb-rl</term>
11885     <listitem>
11886       <para>Top-to-bottom text flow in each vertical line, lines stack right to left.
11887       Supported by only a few XSL-FO processors. Not supported in HTML output.</para>
11888     </listitem>
11889   </varlistentry>
11890   <varlistentry>
11891     <term>lr</term>
11892     <listitem>
11893       <para>Shorthand for lr-tb.</para>
11894     </listitem>
11895   </varlistentry>
11896   <varlistentry>
11897     <term>rl</term>
11898     <listitem>
11899       <para>Shorthand for rl-tb.</para>
11900     </listitem>
11901   </varlistentry>
11902   <varlistentry>
11903     <term>tb</term>
11904     <listitem>
11905       <para>Shorthand for tb-rl.</para>
11906     </listitem>
11907   </varlistentry>
11908 </variablelist>
11909 </para>
11910
11911 </refsection>
11912 </refentry>
11913
11914 </reference>
11915 <reference xml:id="ebnf"><title>EBNF</title>
11916 <refentry version="5.0" xml:id="ebnf.assignment">
11917 <refmeta>
11918 <refentrytitle>ebnf.assignment</refentrytitle>
11919 <refmiscinfo class="other" otherclass="datatype">rtf</refmiscinfo>
11920 </refmeta>
11921 <refnamediv>
11922 <refname>ebnf.assignment</refname>
11923 <refpurpose>The EBNF production assignment operator</refpurpose>
11924 </refnamediv>
11925
11926 <refsynopsisdiv>
11927 <programlisting xml:id="ebnf.assignment.frag">
11928
11929 &lt;xsl:param name="ebnf.assignment"&gt;
11930   &lt;fo:inline font-family="{$monospace.font.family}"&gt;
11931     &lt;xsl:text&gt;::=&lt;/xsl:text&gt;
11932   &lt;/fo:inline&gt;
11933 &lt;/xsl:param&gt;
11934 </programlisting>
11935 </refsynopsisdiv>
11936
11937 <refsection><info><title>Description</title></info>
11938
11939 <para>The <parameter>ebnf.assignment</parameter> parameter determines what
11940 text is used to show <quote>assignment</quote> in <tag>production</tag>s
11941 in <tag>productionset</tag>s.</para>
11942
11943 <para>While <quote><literal>::=</literal></quote> is common, so are several
11944 other operators.</para>
11945
11946 </refsection>
11947 </refentry>
11948
11949 <refentry version="5.0" xml:id="ebnf.statement.terminator">
11950 <refmeta>
11951 <refentrytitle>ebnf.statement.terminator</refentrytitle>
11952 <refmiscinfo class="other" otherclass="datatype">rtf</refmiscinfo>
11953 </refmeta>
11954 <refnamediv>
11955 <refname>ebnf.statement.terminator</refname>
11956 <refpurpose>Punctuation that ends an EBNF statement.</refpurpose>
11957 </refnamediv>
11958
11959 <refsynopsisdiv>
11960 <programlisting xml:id="ebnf.statement.terminator.frag">
11961
11962 &lt;xsl:param name="ebnf.statement.terminator"&gt;&lt;/xsl:param&gt;
11963 </programlisting>
11964 </refsynopsisdiv>
11965
11966 <refsection><info><title>Description</title></info>
11967
11968 <para>The <parameter>ebnf.statement.terminator</parameter> parameter determines what
11969 text is used to terminate each <tag>production</tag>
11970 in <tag>productionset</tag>.</para>
11971
11972 <para>Some notations end each statement with a period.</para>
11973
11974 </refsection>
11975 </refentry>
11976
11977 </reference>
11978 <reference xml:id="prepress"><title>Prepress</title>
11979 <refentry version="5.0" xml:id="crop.marks">
11980 <refmeta>
11981 <refentrytitle>crop.marks</refentrytitle>
11982 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
11983 </refmeta>
11984 <refnamediv>
11985 <refname>crop.marks</refname>
11986 <refpurpose>Output crop marks?</refpurpose>
11987 </refnamediv>
11988
11989 <refsynopsisdiv>
11990 <programlisting xml:id="crop.marks.frag">
11991 &lt;xsl:param name="crop.marks" select="0"&gt;&lt;/xsl:param&gt;
11992 </programlisting>
11993 </refsynopsisdiv>
11994
11995 <refsection><info><title>Description</title></info>
11996
11997 <para>If non-zero, crop marks will be added to each page. Currently this
11998 works only with XEP if you have <parameter>xep.extensions</parameter> set.</para>
11999
12000 </refsection>
12001 </refentry>
12002
12003 <refentry version="5.0" xml:id="crop.mark.width">
12004 <refmeta>
12005 <refentrytitle>crop.mark.width</refentrytitle>
12006 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
12007 </refmeta>
12008 <refnamediv>
12009 <refname>crop.mark.width</refname>
12010 <refpurpose>Width of crop marks.</refpurpose>
12011 </refnamediv>
12012
12013 <refsynopsisdiv>
12014 <programlisting xml:id="crop.mark.width.frag">
12015 &lt;xsl:param name="crop.mark.width"&gt;0.5pt&lt;/xsl:param&gt;
12016 </programlisting>
12017 </refsynopsisdiv>
12018
12019 <refsection><info><title>Description</title></info>
12020
12021 <para>Width of crop marks. Crop marks are controlled by
12022 <parameter>crop.marks</parameter> parameter.</para>
12023
12024 </refsection>
12025 </refentry>
12026
12027 <refentry version="5.0" xml:id="crop.mark.offset">
12028 <refmeta>
12029 <refentrytitle>crop.mark.offset</refentrytitle>
12030 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
12031 </refmeta>
12032 <refnamediv>
12033 <refname>crop.mark.offset</refname>
12034 <refpurpose>Length of crop marks.</refpurpose>
12035 </refnamediv>
12036
12037 <refsynopsisdiv>
12038 <programlisting xml:id="crop.mark.offset.frag">
12039 &lt;xsl:param name="crop.mark.offset"&gt;24pt&lt;/xsl:param&gt;
12040 </programlisting>
12041 </refsynopsisdiv>
12042
12043 <refsection><info><title>Description</title></info>
12044
12045 <para>Length of crop marks. Crop marks are controlled by
12046 <parameter>crop.marks</parameter> parameter.</para>
12047
12048 </refsection>
12049 </refentry>
12050
12051 <refentry version="5.0" xml:id="crop.mark.bleed">
12052 <refmeta>
12053 <refentrytitle>crop.mark.bleed</refentrytitle>
12054 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
12055 </refmeta>
12056 <refnamediv>
12057 <refname>crop.mark.bleed</refname>
12058 <refpurpose>Length of invisible part of crop marks.</refpurpose>
12059 </refnamediv>
12060
12061 <refsynopsisdiv>
12062 <programlisting xml:id="crop.mark.bleed.frag">
12063 &lt;xsl:param name="crop.mark.bleed"&gt;6pt&lt;/xsl:param&gt;
12064 </programlisting>
12065 </refsynopsisdiv>
12066
12067 <refsection><info><title>Description</title></info>
12068
12069 <para>Length of invisible part of crop marks. Crop marks are controlled by
12070 <parameter>crop.marks</parameter> parameter.</para>
12071
12072 </refsection>
12073 </refentry>
12074
12075 </reference>
12076
12077 <appendix xml:id="stylesheet"><title>The Stylesheet</title>
12078
12079 <para>The <filename>param.xsl</filename> stylesheet is just a wrapper
12080 around all these parameters.</para>
12081
12082 <programlisting xml:id="top">
12083 &lt;xsl:stylesheet exclude-result-prefixes="src" version="1.0"&gt;
12084
12085 &lt;!-- This file is generated from param.xweb --&gt;
12086
12087 &lt;!-- ********************************************************************
12088      $Id: param.xweb 8543 2009-12-02 06:05:24Z bobstayton $
12089      ********************************************************************
12090
12091      This file is part of the XSL DocBook Stylesheet distribution.
12092      See ../README or http://docbook.sf.net/release/xsl/current/ for
12093      copyright and other information.
12094
12095      ******************************************************************** --&gt;
12096
12097 &lt;src:fragref linkend="abstract.properties.frag"&gt;&lt;/src:fragref&gt;
12098 &lt;src:fragref linkend="abstract.title.properties.frag"&gt;&lt;/src:fragref&gt;
12099 &lt;src:fragref linkend="admon.graphics.extension.frag"&gt;&lt;/src:fragref&gt;
12100 &lt;src:fragref linkend="admon.graphics.frag"&gt;&lt;/src:fragref&gt;
12101 &lt;src:fragref linkend="admon.graphics.path.frag"&gt;&lt;/src:fragref&gt;
12102 &lt;src:fragref linkend="admon.textlabel.frag"&gt;&lt;/src:fragref&gt;
12103 &lt;src:fragref linkend="admonition.properties.frag"&gt;&lt;/src:fragref&gt;
12104 &lt;src:fragref linkend="admonition.title.properties.frag"&gt;&lt;/src:fragref&gt;
12105 &lt;src:fragref linkend="graphical.admonition.properties.frag"&gt;&lt;/src:fragref&gt;
12106 &lt;src:fragref linkend="nongraphical.admonition.properties.frag"&gt;&lt;/src:fragref&gt;
12107 &lt;src:fragref linkend="alignment.frag"&gt;&lt;/src:fragref&gt;
12108 &lt;src:fragref linkend="appendix.autolabel.frag"&gt;&lt;/src:fragref&gt;
12109 &lt;src:fragref linkend="arbortext.extensions.frag"&gt;&lt;/src:fragref&gt;
12110 &lt;src:fragref linkend="article.appendix.title.properties.frag"&gt;&lt;/src:fragref&gt;
12111 &lt;src:fragref linkend="author.othername.in.middle.frag"&gt;&lt;/src:fragref&gt;
12112 &lt;src:fragref linkend="autotoc.label.separator.frag"&gt;&lt;/src:fragref&gt;
12113 &lt;src:fragref linkend="axf.extensions.frag"&gt;&lt;/src:fragref&gt;
12114 &lt;src:fragref linkend="biblioentry.item.separator.frag"&gt;&lt;/src:fragref&gt;
12115 &lt;src:fragref linkend="biblioentry.properties.frag"&gt;&lt;/src:fragref&gt;
12116 &lt;src:fragref linkend="bibliography.collection.frag"&gt;&lt;/src:fragref&gt;
12117 &lt;src:fragref linkend="bibliography.numbered.frag"&gt;&lt;/src:fragref&gt;
12118 &lt;src:fragref linkend="bibliography.style.frag"&gt;&lt;/src:fragref&gt;
12119 &lt;src:fragref linkend="blockquote.properties.frag"&gt;&lt;/src:fragref&gt;
12120 &lt;src:fragref linkend="body.font.family.frag"&gt;&lt;/src:fragref&gt;
12121 &lt;src:fragref linkend="body.font.master.frag"&gt;&lt;/src:fragref&gt;
12122 &lt;src:fragref linkend="body.font.size.frag"&gt;&lt;/src:fragref&gt;
12123 &lt;src:fragref linkend="body.margin.bottom.frag"&gt;&lt;/src:fragref&gt;
12124 &lt;src:fragref linkend="body.margin.top.frag"&gt;&lt;/src:fragref&gt;
12125 &lt;src:fragref linkend="body.start.indent.frag"&gt;&lt;/src:fragref&gt;
12126 &lt;src:fragref linkend="body.end.indent.frag"&gt;&lt;/src:fragref&gt;
12127 &lt;src:fragref linkend="bookmarks.collapse.frag"&gt;&lt;/src:fragref&gt;
12128 &lt;src:fragref linkend="bridgehead.in.toc.frag"&gt;&lt;/src:fragref&gt;
12129 &lt;src:fragref linkend="callout.defaultcolumn.frag"&gt;&lt;/src:fragref&gt;
12130 &lt;src:fragref linkend="callout.graphics.extension.frag"&gt;&lt;/src:fragref&gt;
12131 &lt;src:fragref linkend="callout.graphics.frag"&gt;&lt;/src:fragref&gt;
12132 &lt;src:fragref linkend="callout.icon.size.frag"&gt;&lt;/src:fragref&gt;
12133 &lt;src:fragref linkend="callout.graphics.number.limit.frag"&gt;&lt;/src:fragref&gt;
12134 &lt;src:fragref linkend="callout.graphics.path.frag"&gt;&lt;/src:fragref&gt;
12135 &lt;src:fragref linkend="callout.unicode.font.frag"&gt;&lt;/src:fragref&gt;
12136 &lt;src:fragref linkend="callout.unicode.frag"&gt;&lt;/src:fragref&gt;
12137 &lt;src:fragref linkend="callout.unicode.number.limit.frag"&gt;&lt;/src:fragref&gt;
12138 &lt;src:fragref linkend="callout.unicode.start.character.frag"&gt;&lt;/src:fragref&gt;
12139 &lt;src:fragref linkend="callouts.extension.frag"&gt;&lt;/src:fragref&gt;
12140 &lt;src:fragref linkend="chapter.autolabel.frag"&gt;&lt;/src:fragref&gt;
12141 &lt;src:fragref linkend="collect.xref.targets.frag"&gt;&lt;/src:fragref&gt;
12142 &lt;src:fragref linkend="column.count.back.frag"&gt;&lt;/src:fragref&gt;
12143 &lt;src:fragref linkend="column.count.body.frag"&gt;&lt;/src:fragref&gt;
12144 &lt;src:fragref linkend="column.count.front.frag"&gt;&lt;/src:fragref&gt;
12145 &lt;src:fragref linkend="column.count.index.frag"&gt;&lt;/src:fragref&gt;
12146 &lt;src:fragref linkend="column.count.lot.frag"&gt;&lt;/src:fragref&gt;
12147 &lt;src:fragref linkend="column.count.titlepage.frag"&gt;&lt;/src:fragref&gt;
12148 &lt;src:fragref linkend="column.gap.back.frag"&gt;&lt;/src:fragref&gt;
12149 &lt;src:fragref linkend="column.gap.body.frag"&gt;&lt;/src:fragref&gt;
12150 &lt;src:fragref linkend="column.gap.front.frag"&gt;&lt;/src:fragref&gt;
12151 &lt;src:fragref linkend="column.gap.index.frag"&gt;&lt;/src:fragref&gt;
12152 &lt;src:fragref linkend="column.gap.lot.frag"&gt;&lt;/src:fragref&gt;
12153 &lt;src:fragref linkend="column.gap.titlepage.frag"&gt;&lt;/src:fragref&gt;
12154 &lt;src:fragref linkend="compact.list.item.spacing.frag"&gt;&lt;/src:fragref&gt;
12155 &lt;src:fragref linkend="component.label.includes.part.label.frag"&gt;&lt;/src:fragref&gt;
12156 &lt;src:fragref linkend="component.title.properties.frag"&gt;&lt;/src:fragref&gt;
12157 &lt;src:fragref linkend="component.titlepage.properties.frag"&gt;&lt;/src:fragref&gt;
12158 &lt;src:fragref linkend="crop.marks.frag"&gt;&lt;/src:fragref&gt;
12159 &lt;src:fragref linkend="crop.mark.width.frag"&gt;&lt;/src:fragref&gt;
12160 &lt;src:fragref linkend="crop.mark.offset.frag"&gt;&lt;/src:fragref&gt;
12161 &lt;src:fragref linkend="crop.mark.bleed.frag"&gt;&lt;/src:fragref&gt;
12162 &lt;src:fragref linkend="current.docid.frag"&gt;&lt;/src:fragref&gt;
12163 &lt;src:fragref linkend="default.float.class.frag"&gt;&lt;/src:fragref&gt;
12164 &lt;src:fragref linkend="default.image.width.frag"&gt;&lt;/src:fragref&gt;
12165 &lt;src:fragref linkend="default.table.width.frag"&gt;&lt;/src:fragref&gt;
12166 &lt;src:fragref linkend="default.table.frame.frag"&gt;&lt;/src:fragref&gt;
12167 &lt;src:fragref linkend="default.table.rules.frag"&gt;&lt;/src:fragref&gt;
12168 &lt;src:fragref linkend="default.units.frag"&gt;&lt;/src:fragref&gt;
12169 &lt;src:fragref linkend="dingbat.font.family.frag"&gt;&lt;/src:fragref&gt;
12170 &lt;src:fragref linkend="double.sided.frag"&gt;&lt;/src:fragref&gt;
12171 &lt;src:fragref linkend="draft.mode.frag"&gt;&lt;/src:fragref&gt;
12172 &lt;src:fragref linkend="draft.watermark.image.frag"&gt;&lt;/src:fragref&gt;
12173 &lt;src:fragref linkend="ebnf.assignment.frag"&gt;&lt;/src:fragref&gt;
12174 &lt;src:fragref linkend="ebnf.statement.terminator.frag"&gt;&lt;/src:fragref&gt;
12175 &lt;src:fragref linkend="email.delimiters.enabled.frag"&gt;&lt;/src:fragref&gt;
12176 &lt;src:fragref linkend="email.mailto.enabled.frag"&gt;&lt;/src:fragref&gt;
12177 &lt;src:fragref linkend="equation.properties.frag"&gt;&lt;/src:fragref&gt;
12178 &lt;src:fragref linkend="equation.number.properties.frag"&gt;&lt;/src:fragref&gt;
12179 &lt;src:fragref linkend="example.properties.frag"&gt;&lt;/src:fragref&gt;
12180 &lt;src:fragref linkend="exsl.node.set.available.frag"&gt;&lt;/src:fragref&gt;
12181 &lt;src:fragref linkend="figure.properties.frag"&gt;&lt;/src:fragref&gt;
12182 &lt;src:fragref linkend="firstterm.only.link.frag"&gt;&lt;/src:fragref&gt;
12183 &lt;src:fragref linkend="footer.content.properties.frag"&gt;&lt;/src:fragref&gt;
12184 &lt;src:fragref linkend="footer.rule.frag"&gt;&lt;/src:fragref&gt;
12185 &lt;src:fragref linkend="footer.column.widths.frag"&gt;&lt;/src:fragref&gt;
12186 &lt;src:fragref linkend="footer.table.height.frag"&gt;&lt;/src:fragref&gt;
12187 &lt;src:fragref linkend="footer.table.properties.frag"&gt;&lt;/src:fragref&gt;
12188 &lt;src:fragref linkend="footers.on.blank.pages.frag"&gt;&lt;/src:fragref&gt;
12189 &lt;src:fragref linkend="footnote.font.size.frag"&gt;&lt;/src:fragref&gt;
12190 &lt;src:fragref linkend="footnote.number.format.frag"&gt;&lt;/src:fragref&gt;
12191 &lt;src:fragref linkend="footnote.number.symbols.frag"&gt;&lt;/src:fragref&gt;
12192 &lt;src:fragref linkend="footnote.mark.properties.frag"&gt;&lt;/src:fragref&gt;
12193 &lt;src:fragref linkend="footnote.properties.frag"&gt;&lt;/src:fragref&gt;
12194 &lt;src:fragref linkend="footnote.sep.leader.properties.frag"&gt;&lt;/src:fragref&gt;
12195 &lt;src:fragref linkend="fop.extensions.frag"&gt;&lt;/src:fragref&gt;
12196 &lt;src:fragref linkend="fop1.extensions.frag"&gt;&lt;/src:fragref&gt;
12197 &lt;src:fragref linkend="formal.object.properties.frag"&gt;&lt;/src:fragref&gt;
12198 &lt;src:fragref linkend="formal.procedures.frag"&gt;&lt;/src:fragref&gt;
12199 &lt;src:fragref linkend="formal.title.placement.frag"&gt;&lt;/src:fragref&gt;
12200 &lt;src:fragref linkend="formal.title.properties.frag"&gt;&lt;/src:fragref&gt;
12201 &lt;src:fragref linkend="funcsynopsis.decoration.frag"&gt;&lt;/src:fragref&gt;
12202 &lt;src:fragref linkend="funcsynopsis.style.frag"&gt;&lt;/src:fragref&gt;
12203 &lt;src:fragref linkend="function.parens.frag"&gt;&lt;/src:fragref&gt;
12204 &lt;src:fragref linkend="generate.index.frag"&gt;&lt;/src:fragref&gt;
12205 &lt;src:fragref linkend="generate.section.toc.level.frag"&gt;&lt;/src:fragref&gt;
12206 &lt;src:fragref linkend="generate.toc.frag"&gt;&lt;/src:fragref&gt;
12207 &lt;src:fragref linkend="glossary.as.blocks.frag"&gt;&lt;/src:fragref&gt;
12208 &lt;src:fragref linkend="glossary.collection.frag"&gt;&lt;/src:fragref&gt;
12209 &lt;src:fragref linkend="glossary.sort.frag"&gt;&lt;/src:fragref&gt;
12210 &lt;src:fragref linkend="glossentry.show.acronym.frag"&gt;&lt;/src:fragref&gt;
12211 &lt;src:fragref linkend="glosslist.as.blocks.frag"&gt;&lt;/src:fragref&gt;
12212 &lt;src:fragref linkend="glossterm.auto.link.frag"&gt;&lt;/src:fragref&gt;
12213 &lt;src:fragref linkend="glossterm.separation.frag"&gt;&lt;/src:fragref&gt;
12214 &lt;src:fragref linkend="glossterm.width.frag"&gt;&lt;/src:fragref&gt;
12215 &lt;src:fragref linkend="glossentry.list.item.properties.frag"&gt;&lt;/src:fragref&gt;
12216 &lt;src:fragref linkend="glossterm.list.properties.frag"&gt;&lt;/src:fragref&gt;
12217 &lt;src:fragref linkend="glossterm.block.properties.frag"&gt;&lt;/src:fragref&gt;
12218 &lt;src:fragref linkend="glossdef.list.properties.frag"&gt;&lt;/src:fragref&gt;
12219 &lt;src:fragref linkend="glossdef.block.properties.frag"&gt;&lt;/src:fragref&gt;
12220 &lt;src:fragref linkend="graphic.default.extension.frag"&gt;&lt;/src:fragref&gt;
12221 &lt;src:fragref linkend="header.content.properties.frag"&gt;&lt;/src:fragref&gt;
12222 &lt;src:fragref linkend="header.rule.frag"&gt;&lt;/src:fragref&gt;
12223 &lt;src:fragref linkend="header.column.widths.frag"&gt;&lt;/src:fragref&gt;
12224 &lt;src:fragref linkend="header.table.height.frag"&gt;&lt;/src:fragref&gt;
12225 &lt;src:fragref linkend="header.table.properties.frag"&gt;&lt;/src:fragref&gt;
12226 &lt;src:fragref linkend="headers.on.blank.pages.frag"&gt;&lt;/src:fragref&gt;
12227 &lt;src:fragref linkend="highlight.default.language.frag"&gt;&lt;/src:fragref&gt;
12228 &lt;src:fragref linkend="highlight.source.frag"&gt;&lt;/src:fragref&gt;
12229 &lt;src:fragref linkend="highlight.xslthl.config.frag"&gt;&lt;/src:fragref&gt;
12230 &lt;src:fragref linkend="hyphenate.frag"&gt;&lt;/src:fragref&gt;
12231 &lt;src:fragref linkend="hyphenate.verbatim.frag"&gt;&lt;/src:fragref&gt;
12232 &lt;src:fragref linkend="hyphenate.verbatim.characters.frag"&gt;&lt;/src:fragref&gt;
12233 &lt;src:fragref linkend="ignore.image.scaling.frag"&gt;&lt;/src:fragref&gt;
12234 &lt;src:fragref linkend="img.src.path.frag"&gt;&lt;/src:fragref&gt;
12235 &lt;src:fragref linkend="index.method.frag"&gt;&lt;/src:fragref&gt;
12236 &lt;src:fragref linkend="index.on.role.frag"&gt;&lt;/src:fragref&gt;
12237 &lt;src:fragref linkend="index.on.type.frag"&gt;&lt;/src:fragref&gt;
12238 &lt;src:fragref linkend="index.page.number.properties.frag"&gt;&lt;/src:fragref&gt;
12239 &lt;src:fragref linkend="informalequation.properties.frag"&gt;&lt;/src:fragref&gt;
12240 &lt;src:fragref linkend="informalexample.properties.frag"&gt;&lt;/src:fragref&gt;
12241 &lt;src:fragref linkend="informalfigure.properties.frag"&gt;&lt;/src:fragref&gt;
12242 &lt;src:fragref linkend="informal.object.properties.frag"&gt;&lt;/src:fragref&gt;
12243 &lt;src:fragref linkend="informaltable.properties.frag"&gt;&lt;/src:fragref&gt;
12244 &lt;src:fragref linkend="index.preferred.page.properties.frag"&gt;&lt;/src:fragref&gt;
12245 &lt;src:fragref linkend="index.div.title.properties.frag"&gt;&lt;/src:fragref&gt;
12246 &lt;src:fragref linkend="index.entry.properties.frag"&gt;&lt;/src:fragref&gt;
12247 &lt;src:fragref linkend="index.number.separator.frag"&gt;&lt;/src:fragref&gt;
12248 &lt;src:fragref linkend="index.range.separator.frag"&gt;&lt;/src:fragref&gt;
12249 &lt;src:fragref linkend="index.term.separator.frag"&gt;&lt;/src:fragref&gt;
12250 &lt;src:fragref linkend="insert.link.page.number.frag"&gt;&lt;/src:fragref&gt;
12251 &lt;src:fragref linkend="insert.xref.page.number.frag"&gt;&lt;/src:fragref&gt;
12252 &lt;src:fragref linkend="itemizedlist.properties.frag"&gt;&lt;/src:fragref&gt;
12253 &lt;src:fragref linkend="itemizedlist.label.properties.frag"&gt;&lt;/src:fragref&gt;
12254 &lt;src:fragref linkend="itemizedlist.label.width.frag"&gt;&lt;/src:fragref&gt;
12255 &lt;src:fragref linkend="keep.relative.image.uris.frag"&gt;&lt;/src:fragref&gt;
12256 &lt;src:fragref linkend="l10n.gentext.default.language.frag"&gt;&lt;/src:fragref&gt;
12257 &lt;src:fragref linkend="l10n.gentext.language.frag"&gt;&lt;/src:fragref&gt;
12258 &lt;src:fragref linkend="l10n.gentext.use.xref.language.frag"&gt;&lt;/src:fragref&gt;
12259 &lt;src:fragref linkend="l10n.lang.value.rfc.compliant.frag"&gt;&lt;/src:fragref&gt;
12260 &lt;src:fragref linkend="label.from.part.frag"&gt;&lt;/src:fragref&gt;
12261 &lt;src:fragref linkend="line-height.frag"&gt;&lt;/src:fragref&gt;
12262 &lt;src:fragref linkend="linenumbering.everyNth.frag"&gt;&lt;/src:fragref&gt;
12263 &lt;src:fragref linkend="linenumbering.extension.frag"&gt;&lt;/src:fragref&gt;
12264 &lt;src:fragref linkend="linenumbering.separator.frag"&gt;&lt;/src:fragref&gt;
12265 &lt;src:fragref linkend="linenumbering.width.frag"&gt;&lt;/src:fragref&gt;
12266 &lt;src:fragref linkend="list.block.properties.frag"&gt;&lt;/src:fragref&gt;
12267 &lt;src:fragref linkend="list.block.spacing.frag"&gt;&lt;/src:fragref&gt;
12268 &lt;src:fragref linkend="list.item.spacing.frag"&gt;&lt;/src:fragref&gt;
12269 &lt;src:fragref linkend="make.index.markup.frag"&gt;&lt;/src:fragref&gt;
12270 &lt;src:fragref linkend="make.single.year.ranges.frag"&gt;&lt;/src:fragref&gt;
12271 &lt;src:fragref linkend="make.year.ranges.frag"&gt;&lt;/src:fragref&gt;
12272 &lt;src:fragref linkend="margin.note.properties.frag"&gt;&lt;/src:fragref&gt;
12273 &lt;src:fragref linkend="margin.note.title.properties.frag"&gt;&lt;/src:fragref&gt;
12274 &lt;src:fragref linkend="margin.note.float.type.frag"&gt;&lt;/src:fragref&gt;
12275 &lt;src:fragref linkend="margin.note.width.frag"&gt;&lt;/src:fragref&gt;
12276 &lt;src:fragref linkend="marker.section.level.frag"&gt;&lt;/src:fragref&gt;
12277 &lt;src:fragref linkend="menuchoice.menu.separator.frag"&gt;&lt;/src:fragref&gt;
12278 &lt;src:fragref linkend="menuchoice.separator.frag"&gt;&lt;/src:fragref&gt;
12279 &lt;src:fragref linkend="monospace.font.family.frag"&gt;&lt;/src:fragref&gt;
12280 &lt;src:fragref linkend="monospace.properties.frag"&gt;&lt;/src:fragref&gt;
12281 &lt;src:fragref linkend="monospace.verbatim.properties.frag"&gt;&lt;/src:fragref&gt;
12282 &lt;src:fragref linkend="monospace.verbatim.font.width.frag"&gt;&lt;/src:fragref&gt;
12283 &lt;src:fragref linkend="nominal.table.width.frag"&gt;&lt;/src:fragref&gt;
12284 &lt;src:fragref linkend="normal.para.spacing.frag"&gt;&lt;/src:fragref&gt;
12285 &lt;src:fragref linkend="olink.doctitle.frag"&gt;&lt;/src:fragref&gt;
12286 &lt;src:fragref linkend="olink.base.uri.frag"&gt;&lt;/src:fragref&gt;
12287 &lt;src:fragref linkend="olink.debug.frag"&gt;&lt;/src:fragref&gt;
12288 &lt;src:fragref linkend="olink.properties.frag"&gt;&lt;/src:fragref&gt;
12289 &lt;src:fragref linkend="olink.lang.fallback.sequence.frag"&gt;&lt;/src:fragref&gt;
12290 &lt;src:fragref linkend="orderedlist.properties.frag"&gt;&lt;/src:fragref&gt;
12291 &lt;src:fragref linkend="orderedlist.label.properties.frag"&gt;&lt;/src:fragref&gt;
12292 &lt;src:fragref linkend="orderedlist.label.width.frag"&gt;&lt;/src:fragref&gt;
12293 &lt;src:fragref linkend="prefer.internal.olink.frag"&gt;&lt;/src:fragref&gt;
12294 &lt;src:fragref linkend="insert.olink.page.number.frag"&gt;&lt;/src:fragref&gt;
12295 &lt;src:fragref linkend="insert.olink.pdf.frag.frag"&gt;&lt;/src:fragref&gt;
12296 &lt;src:fragref linkend="page.height.frag"&gt;&lt;/src:fragref&gt;
12297 &lt;src:fragref linkend="page.height.portrait.frag"&gt;&lt;/src:fragref&gt;
12298 &lt;src:fragref linkend="page.margin.bottom.frag"&gt;&lt;/src:fragref&gt;
12299 &lt;src:fragref linkend="page.margin.inner.frag"&gt;&lt;/src:fragref&gt;
12300 &lt;src:fragref linkend="page.margin.outer.frag"&gt;&lt;/src:fragref&gt;
12301 &lt;src:fragref linkend="page.margin.top.frag"&gt;&lt;/src:fragref&gt;
12302 &lt;src:fragref linkend="page.orientation.frag"&gt;&lt;/src:fragref&gt;
12303 &lt;src:fragref linkend="page.width.frag"&gt;&lt;/src:fragref&gt;
12304 &lt;src:fragref linkend="page.width.portrait.frag"&gt;&lt;/src:fragref&gt;
12305 &lt;src:fragref linkend="paper.type.frag"&gt;&lt;/src:fragref&gt;
12306 &lt;src:fragref linkend="part.autolabel.frag"&gt;&lt;/src:fragref&gt;
12307 &lt;src:fragref linkend="passivetex.extensions.frag"&gt;&lt;/src:fragref&gt;
12308 &lt;src:fragref linkend="pgwide.properties.frag"&gt;&lt;/src:fragref&gt;
12309 &lt;src:fragref linkend="preface.autolabel.frag"&gt;&lt;/src:fragref&gt;
12310 &lt;src:fragref linkend="preferred.mediaobject.role.frag"&gt;&lt;/src:fragref&gt;
12311 &lt;src:fragref linkend="procedure.properties.frag"&gt;&lt;/src:fragref&gt;
12312 &lt;src:fragref linkend="process.empty.source.toc.frag"&gt;&lt;/src:fragref&gt;
12313 &lt;src:fragref linkend="process.source.toc.frag"&gt;&lt;/src:fragref&gt;
12314 &lt;src:fragref linkend="profile.arch.frag"&gt;&lt;/src:fragref&gt;
12315 &lt;src:fragref linkend="profile.audience.frag"&gt;&lt;/src:fragref&gt;
12316 &lt;src:fragref linkend="profile.attribute.frag"&gt;&lt;/src:fragref&gt;
12317 &lt;src:fragref linkend="profile.condition.frag"&gt;&lt;/src:fragref&gt;
12318 &lt;src:fragref linkend="profile.conformance.frag"&gt;&lt;/src:fragref&gt;
12319 &lt;src:fragref linkend="profile.lang.frag"&gt;&lt;/src:fragref&gt;
12320 &lt;src:fragref linkend="profile.os.frag"&gt;&lt;/src:fragref&gt;
12321 &lt;src:fragref linkend="profile.revision.frag"&gt;&lt;/src:fragref&gt;
12322 &lt;src:fragref linkend="profile.revisionflag.frag"&gt;&lt;/src:fragref&gt;
12323 &lt;src:fragref linkend="profile.role.frag"&gt;&lt;/src:fragref&gt;
12324 &lt;src:fragref linkend="profile.security.frag"&gt;&lt;/src:fragref&gt;
12325 &lt;src:fragref linkend="profile.separator.frag"&gt;&lt;/src:fragref&gt;
12326 &lt;src:fragref linkend="profile.status.frag"&gt;&lt;/src:fragref&gt;
12327 &lt;src:fragref linkend="profile.userlevel.frag"&gt;&lt;/src:fragref&gt;
12328 &lt;src:fragref linkend="profile.value.frag"&gt;&lt;/src:fragref&gt;
12329 &lt;src:fragref linkend="profile.vendor.frag"&gt;&lt;/src:fragref&gt;
12330 &lt;src:fragref linkend="profile.wordsize.frag"&gt;&lt;/src:fragref&gt;
12331 &lt;src:fragref linkend="punct.honorific.frag"&gt;&lt;/src:fragref&gt;
12332 &lt;src:fragref linkend="qanda.defaultlabel.frag"&gt;&lt;/src:fragref&gt;
12333 &lt;src:fragref linkend="qanda.in.toc.frag"&gt;&lt;/src:fragref&gt;
12334 &lt;src:fragref linkend="qanda.nested.in.toc.frag"&gt;&lt;/src:fragref&gt;
12335 &lt;src:fragref linkend="qanda.inherit.numeration.frag"&gt;&lt;/src:fragref&gt;
12336 &lt;src:fragref linkend="qandadiv.autolabel.frag"&gt;&lt;/src:fragref&gt;
12337 &lt;src:fragref linkend="qanda.title.level1.properties.frag"&gt;&lt;/src:fragref&gt;
12338 &lt;src:fragref linkend="qanda.title.level2.properties.frag"&gt;&lt;/src:fragref&gt;
12339 &lt;src:fragref linkend="qanda.title.level3.properties.frag"&gt;&lt;/src:fragref&gt;
12340 &lt;src:fragref linkend="qanda.title.level4.properties.frag"&gt;&lt;/src:fragref&gt;
12341 &lt;src:fragref linkend="qanda.title.level5.properties.frag"&gt;&lt;/src:fragref&gt;
12342 &lt;src:fragref linkend="qanda.title.level6.properties.frag"&gt;&lt;/src:fragref&gt;
12343 &lt;src:fragref linkend="qanda.title.properties.frag"&gt;&lt;/src:fragref&gt;
12344 &lt;src:fragref linkend="refentry.generate.name.frag"&gt;&lt;/src:fragref&gt;
12345 &lt;src:fragref linkend="refentry.generate.title.frag"&gt;&lt;/src:fragref&gt;
12346 &lt;src:fragref linkend="refentry.pagebreak.frag"&gt;&lt;/src:fragref&gt;
12347 &lt;src:fragref linkend="refentry.title.properties.frag"&gt;&lt;/src:fragref&gt;
12348 &lt;src:fragref linkend="refentry.xref.manvolnum.frag"&gt;&lt;/src:fragref&gt;
12349 &lt;src:fragref linkend="reference.autolabel.frag"&gt;&lt;/src:fragref&gt;
12350 &lt;src:fragref linkend="refclass.suppress.frag"&gt;&lt;/src:fragref&gt;
12351 &lt;src:fragref linkend="region.after.extent.frag"&gt;&lt;/src:fragref&gt;
12352 &lt;src:fragref linkend="region.before.extent.frag"&gt;&lt;/src:fragref&gt;
12353 &lt;src:fragref linkend="revhistory.table.properties.frag"&gt;&lt;/src:fragref&gt;
12354 &lt;src:fragref linkend="revhistory.table.cell.properties.frag"&gt;&lt;/src:fragref&gt;
12355 &lt;src:fragref linkend="revhistory.title.properties.frag"&gt;&lt;/src:fragref&gt;
12356 &lt;src:fragref linkend="root.properties.frag"&gt;&lt;/src:fragref&gt;
12357 &lt;src:fragref linkend="rootid.frag"&gt;&lt;/src:fragref&gt;
12358 &lt;src:fragref linkend="runinhead.default.title.end.punct.frag"&gt;&lt;/src:fragref&gt;
12359 &lt;src:fragref linkend="runinhead.title.end.punct.frag"&gt;&lt;/src:fragref&gt;
12360 &lt;src:fragref linkend="sans.font.family.frag"&gt;&lt;/src:fragref&gt;
12361 &lt;src:fragref linkend="section.autolabel.frag"&gt;&lt;/src:fragref&gt;
12362 &lt;src:fragref linkend="section.autolabel.max.depth.frag"&gt;&lt;/src:fragref&gt;
12363 &lt;src:fragref linkend="section.container.element.frag"&gt;&lt;/src:fragref&gt;
12364 &lt;src:fragref linkend="section.label.includes.component.label.frag"&gt;&lt;/src:fragref&gt;
12365 &lt;src:fragref linkend="section.title.level1.properties.frag"&gt;&lt;/src:fragref&gt;
12366 &lt;src:fragref linkend="section.title.level2.properties.frag"&gt;&lt;/src:fragref&gt;
12367 &lt;src:fragref linkend="section.title.level3.properties.frag"&gt;&lt;/src:fragref&gt;
12368 &lt;src:fragref linkend="section.title.level4.properties.frag"&gt;&lt;/src:fragref&gt;
12369 &lt;src:fragref linkend="section.title.level5.properties.frag"&gt;&lt;/src:fragref&gt;
12370 &lt;src:fragref linkend="section.title.level6.properties.frag"&gt;&lt;/src:fragref&gt;
12371 &lt;src:fragref linkend="section.title.properties.frag"&gt;&lt;/src:fragref&gt;
12372 &lt;src:fragref linkend="section.level1.properties.frag"&gt;&lt;/src:fragref&gt;
12373 &lt;src:fragref linkend="section.level2.properties.frag"&gt;&lt;/src:fragref&gt;
12374 &lt;src:fragref linkend="section.level3.properties.frag"&gt;&lt;/src:fragref&gt;
12375 &lt;src:fragref linkend="section.level4.properties.frag"&gt;&lt;/src:fragref&gt;
12376 &lt;src:fragref linkend="section.level5.properties.frag"&gt;&lt;/src:fragref&gt;
12377 &lt;src:fragref linkend="section.level6.properties.frag"&gt;&lt;/src:fragref&gt;
12378 &lt;src:fragref linkend="section.properties.frag"&gt;&lt;/src:fragref&gt;
12379 &lt;src:fragref linkend="segmentedlist.as.table.frag"&gt;&lt;/src:fragref&gt;
12380 &lt;src:fragref linkend="shade.verbatim.frag"&gt;&lt;/src:fragref&gt;
12381 &lt;src:fragref linkend="shade.verbatim.style.frag"&gt;&lt;/src:fragref&gt;
12382 &lt;src:fragref linkend="show.comments.frag"&gt;&lt;/src:fragref&gt;
12383 &lt;src:fragref linkend="sidebar.properties.frag"&gt;&lt;/src:fragref&gt;
12384 &lt;src:fragref linkend="sidebar.title.properties.frag"&gt;&lt;/src:fragref&gt;
12385 &lt;src:fragref linkend="sidebar.float.type.frag"&gt;&lt;/src:fragref&gt;
12386 &lt;src:fragref linkend="sidebar.float.width.frag"&gt;&lt;/src:fragref&gt;
12387 &lt;src:fragref linkend="simplesect.in.toc.frag"&gt;&lt;/src:fragref&gt;
12388 &lt;src:fragref linkend="subscript.properties.frag"&gt;&lt;/src:fragref&gt;
12389 &lt;src:fragref linkend="superscript.properties.frag"&gt;&lt;/src:fragref&gt;
12390 &lt;src:fragref linkend="symbol.font.family.frag"&gt;&lt;/src:fragref&gt;
12391 &lt;src:fragref linkend="table.cell.border.color.frag"&gt;&lt;/src:fragref&gt;
12392 &lt;src:fragref linkend="table.cell.border.style.frag"&gt;&lt;/src:fragref&gt;
12393 &lt;src:fragref linkend="table.cell.border.thickness.frag"&gt;&lt;/src:fragref&gt;
12394 &lt;src:fragref linkend="table.cell.padding.frag"&gt;&lt;/src:fragref&gt;
12395 &lt;src:fragref linkend="table.footnote.number.format.frag"&gt;&lt;/src:fragref&gt;
12396 &lt;src:fragref linkend="table.footnote.number.symbols.frag"&gt;&lt;/src:fragref&gt;
12397 &lt;src:fragref linkend="table.footnote.properties.frag"&gt;&lt;/src:fragref&gt;
12398 &lt;src:fragref linkend="table.frame.border.color.frag"&gt;&lt;/src:fragref&gt;
12399 &lt;src:fragref linkend="table.frame.border.style.frag"&gt;&lt;/src:fragref&gt;
12400 &lt;src:fragref linkend="table.frame.border.thickness.frag"&gt;&lt;/src:fragref&gt;
12401 &lt;src:fragref linkend="table.properties.frag"&gt;&lt;/src:fragref&gt;
12402 &lt;src:fragref linkend="tablecolumns.extension.frag"&gt;&lt;/src:fragref&gt;
12403 &lt;src:fragref linkend="table.table.properties.frag"&gt;&lt;/src:fragref&gt;
12404 &lt;src:fragref linkend="target.database.document.frag"&gt;&lt;/src:fragref&gt;
12405 &lt;src:fragref linkend="targets.filename.frag"&gt;&lt;/src:fragref&gt;
12406 &lt;src:fragref linkend="textdata.default.encoding.frag"&gt;&lt;/src:fragref&gt;
12407 &lt;src:fragref linkend="tex.math.delims.frag"&gt;&lt;/src:fragref&gt;
12408 &lt;src:fragref linkend="tex.math.in.alt.frag"&gt;&lt;/src:fragref&gt;
12409 &lt;src:fragref linkend="textinsert.extension.frag"&gt;&lt;/src:fragref&gt;
12410 &lt;src:fragref linkend="title.font.family.frag"&gt;&lt;/src:fragref&gt;
12411 &lt;src:fragref linkend="title.margin.left.frag"&gt;&lt;/src:fragref&gt;
12412 &lt;src:fragref linkend="toc.indent.width.frag"&gt;&lt;/src:fragref&gt;
12413 &lt;src:fragref linkend="toc.line.properties.frag"&gt;&lt;/src:fragref&gt;
12414 &lt;src:fragref linkend="toc.margin.properties.frag"&gt;&lt;/src:fragref&gt;
12415 &lt;src:fragref linkend="toc.max.depth.frag"&gt;&lt;/src:fragref&gt;
12416 &lt;src:fragref linkend="toc.section.depth.frag"&gt;&lt;/src:fragref&gt;
12417 &lt;src:fragref linkend="ulink.footnotes.frag"&gt;&lt;/src:fragref&gt;
12418 &lt;src:fragref linkend="ulink.hyphenate.frag"&gt;&lt;/src:fragref&gt;
12419 &lt;src:fragref linkend="ulink.hyphenate.chars.frag"&gt;&lt;/src:fragref&gt;
12420 &lt;src:fragref linkend="ulink.show.frag"&gt;&lt;/src:fragref&gt;
12421 &lt;src:fragref linkend="use.extensions.frag"&gt;&lt;/src:fragref&gt;
12422 &lt;src:fragref linkend="use.local.olink.style.frag"&gt;&lt;/src:fragref&gt;
12423 &lt;src:fragref linkend="use.role.as.xrefstyle.frag"&gt;&lt;/src:fragref&gt;
12424 &lt;src:fragref linkend="use.role.for.mediaobject.frag"&gt;&lt;/src:fragref&gt;
12425 &lt;src:fragref linkend="use.svg.frag"&gt;&lt;/src:fragref&gt;
12426 &lt;src:fragref linkend="variablelist.as.blocks.frag"&gt;&lt;/src:fragref&gt;
12427 &lt;src:fragref linkend="variablelist.max.termlength.frag"&gt;&lt;/src:fragref&gt;
12428 &lt;src:fragref linkend="variablelist.term.separator.frag"&gt;&lt;/src:fragref&gt;
12429 &lt;src:fragref linkend="variablelist.term.properties.frag"&gt;&lt;/src:fragref&gt;
12430 &lt;src:fragref linkend="variablelist.term.break.after.frag"&gt;&lt;/src:fragref&gt;
12431 &lt;src:fragref linkend="verbatim.properties.frag"&gt;&lt;/src:fragref&gt;
12432 &lt;src:fragref linkend="writing.mode.frag"&gt;&lt;/src:fragref&gt;
12433 &lt;src:fragref linkend="xep.extensions.frag"&gt;&lt;/src:fragref&gt;
12434 &lt;src:fragref linkend="xep.index.item.properties.frag"&gt;&lt;/src:fragref&gt;
12435 &lt;src:fragref linkend="xref.label-page.separator.frag"&gt;&lt;/src:fragref&gt;
12436 &lt;src:fragref linkend="xref.label-title.separator.frag"&gt;&lt;/src:fragref&gt;
12437 &lt;src:fragref linkend="xref.properties.frag"&gt;&lt;/src:fragref&gt;
12438 &lt;src:fragref linkend="xref.title-page.separator.frag"&gt;&lt;/src:fragref&gt;
12439 &lt;src:fragref linkend="xref.with.number.and.title.frag"&gt;&lt;/src:fragref&gt;
12440
12441 &lt;/xsl:stylesheet&gt;
12442 </programlisting>
12443
12444 </appendix>
12445 </book>