]> git.stg.codes - stg.git/blob - doc/xslt/RELEASE-NOTES.xml
activeUsers SNMP parameter description added
[stg.git] / doc / xslt / RELEASE-NOTES.xml
1 <article xmlns="http://docbook.org/ns/docbook"
2   xmlns:xlink="http://www.w3.org/1999/xlink"
3   xmlns:xi="http://www.w3.org/2001/XInclude"
4   xml:lang="en" xml:id="releasenotes"
5   version="5.0">
6
7 <info>
8   <title>Release Notes for the DocBook XSL Stylesheets</title>
9   <pubdate><?dbtimestamp format="Y-m-d"?></pubdate>
10   <releaseinfo role="cvs">$Revision: 8934 $ $Date: 2010-11-01 13:03:14 -0700 (Mon, 01 Nov 2010) $</releaseinfo>
11   <!-- * <author><orgname>DocBook Project Development Team</orgname></author> -->
12 <abstract>
13 <para condition="dot-zero;dot-one-plus">This release-notes
14   document is available in the following formats:
15   <link
16     xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.html"
17     >HTML</link>,
18   <link
19     xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.pdf"
20     >PDF</link>,
21   <link
22     xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.txt"
23     >plain text</link>; it provides a per-release list
24 of enhancements and changes to the stylesheets’ public APIs
25 (user-configurable parameters) and excludes descriptions of most
26 bug fixes. For a complete list of all changes (including all bug
27 fixes) that have been made since the previous release, see the
28 separate <link xlink:href="NEWS">NEWS</link> (plain text) or <link
29   xlink:href="NEWS.html">NEWS.html</link> files. Also available:
30 An online <link
31   xlink:href="http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/xsl/?view=log"
32   >hyperlinked change history</link> (warning: big file) of all
33 changes made over the entire history of the codebase.</para>
34 <para condition="dot-zero">As with all DocBook Project <link
35     linkend="dot0">dot-zero</link> releases, this is an
36   experimental release. It will be followed shortly by a stable
37   release.</para>
38 <para condition="dot-one-plus">As with all DocBook Project “dot
39   one plus” releases, this release aspires to be stable (in
40   contrast to <link linkend="dot0">dot-zero</link> releases, which
41   are experimental).</para>
42 <para condition="snapshot">This is a pre-release “snapshot” of the
43 DocBook XSL Stylesheets. The change information in the first
44 section of this file 
45 (for “<xi:include href="NEWS.xml" xpointer="xpointer(/article/sect1/title/text())"/>”) is
46 auto-generated from change descriptions stored in the project
47 source-code repository.</para>
48 <para condition="snapshot">That means the first section contains
49 descriptions both of bug fixes and of feature changes. The
50 remaining sections are manually edited changelog subsets that
51 exclude bug-fix descriptions – that is, trimmed down to just those
52 those descriptions that document enhancements and changes to the
53 public APIs (user-configurable parameters).</para>
54 </abstract>
55 </info>
56
57 <sect1 condition="snapshot" xml:id="current">
58   <xi:include href="NEWS.xml" xpointer="xpointer(/article/sect1/*)"/>
59 </sect1>
60 <sect1 xml:id="V1.76.1">
61 <title>Release Notes: 1.76.1</title>
62 <para>The following is a list of changes that have been made
63         since the 1.76.0 release.</para>
64
65 <sect2 xml:id="rnV1.76.1_FO">
66 <title>FO</title>
67 <para>The following changes have been made to the
68             <filename>fo</filename> code
69             since the 1.76.0 release.</para>
70 <itemizedlist>
71 <listitem>
72 <para><literal>Robert Stayton: docbook.xsl; xref.xsl; fop1.xsl</literal></para><screen><phrase role="commit-message">Apply patch to support named destination in fop1.xsl, per Sourceforge
73 bug report #3029845.</phrase></screen>
74 </listitem>
75 </itemizedlist>
76 </sect2><!--end of FO changes for 1.76.1-->
77
78 <sect2 xml:id="rnV1.76.1_HTML">
79 <title>HTML</title>
80 <para>The following changes have been made to the <filename>html</filename> code since the 1.76.0 release.</para>
81 <itemizedlist>
82 <listitem>
83 <para><literal>Keith Fahlgren: highlight.xsl</literal></para><screen><phrase role="commit-message">Implementing handling for &lt;b&gt; and &lt;i&gt;: transform to &lt;strong&gt; and &lt;em&gt; for XHTML outputs and do not use in the highliting output (per Mauritz Jeanson)</phrase></screen>
84 </listitem>
85 </itemizedlist>
86 </sect2><!--end of HTML changes for 1.76.1-->
87
88 <sect2 xml:id="rnV1.76.1_Params">
89 <title>Params</title>
90 <para>The following changes have been made to the
91             <filename>params</filename> code
92             since the 1.76.0 release.</para>
93 <itemizedlist>
94 <listitem>
95 <para><literal>Robert Stayton: draft.mode.xml</literal></para><screen><phrase role="commit-message">Change default for <parameter>draft.mode</parameter> to 'no'.</phrase></screen>
96 </listitem>
97 </itemizedlist>
98 </sect2><!--end of Params changes for 1.76.1-->
99
100
101 </sect1>
102   <sect1 xml:id="V1.76.0">
103     <title>Release Notes: 1.76.0</title>
104 <para>This release includes important bug fixes and adds the following
105 significant feature changes:</para>
106 <variablelist>
107 <varlistentry>
108 <term>Webhelp</term>
109 <listitem><para>A new browser-based, cross-platform help format with full-text search and other features typically found in help systems. See <filename>webhelp/docs/content/ch01.html</filename> for more information and a demo. </para></listitem>
110
111 </varlistentry>
112
113 <varlistentry>
114 <term>Gentext</term>
115 <listitem><para>Many updates and additions to translation/locales thanks to Red Hat, the Fedora Project, and other contributors.</para></listitem>
116 </varlistentry>
117 <varlistentry>
118 <term>Common</term>
119 <listitem><para>Faster localization support, as language files are loaded on demand.</para></listitem>
120
121 </varlistentry>
122             <varlistentry>
123             <term>FO</term>
124             <listitem><para>Support for SVG content in <tag>imagedata</tag> added.</para></listitem>
125 </varlistentry>
126             <varlistentry>
127             <term>HTML</term>
128             <listitem><para>Output improved when using '<parameter>make.clean.html</parameter>' and a stock CSS file is now provided.</para></listitem> 
129 </varlistentry>
130 <varlistentry>
131 <term>EPUB</term>
132 <listitem><para>A number of improvements to NCX, cover and image selection, and XHTML 1.1 element choices</para></listitem>
133 </varlistentry>
134
135 </variablelist>
136
137     <para>The following is a list of changes that have been made since the 1.75.2 release.</para>
138     <sect2 xml:id="rnV1.76.0_Gentext">
139       <title>Gentext</title>
140       <para>The following changes have been made to the <filename>gentext</filename> code since the 1.75.2 release.</para>
141       <itemizedlist>
142         <listitem>
143           <para>
144             <literal>rlandmann: locale/fa.xml</literal>
145           </para>
146           <screen>
147             <phrase role="commit-message">Update to Persian translation from the Fedora Project</phrase>
148           </screen>
149         </listitem>
150         <listitem>
151           <para>
152             <literal>rlandmann: locale/nds.xml</literal>
153           </para>
154           <screen>
155             <phrase role="commit-message">Locale for Low German</phrase>
156           </screen>
157         </listitem>
158         <listitem>
159           <para>
160             <literal>Mauritz Jeanson: locale/ka.xml; Makefile</literal>
161           </para>
162           <screen>
163             <phrase role="commit-message">Added support for Georgian based on patch #2917147.</phrase>
164           </screen>
165         </listitem>
166         <listitem>
167           <para>
168             <literal>rlandmann: locale/nl.xml; locale/ja.xml</literal>
169           </para>
170           <screen>
171             <phrase role="commit-message">Updated translations from Red Hat and the Fedora Project</phrase>
172           </screen>
173         </listitem>
174         <listitem>
175           <para>
176             <literal>rlandmann: locale/bs.xml; locale/ru.xml; locale/hr.xml</literal>
177           </para>
178           <screen>
179             <phrase role="commit-message">Updated locales from Red Hat and the Fedora Project</phrase>
180           </screen>
181         </listitem>
182         <listitem>
183           <para>
184             <literal>rlandmann: locale/pt.xml; locale/cs.xml; locale/es.xml; locale/bg.xml; locale/nl.xml; loca⋯</literal>
185           </para>
186           <screen>
187             <phrase role="commit-message">Updated translations from Red Hat and the Fedora Project</phrase>
188           </screen>
189         </listitem>
190         <listitem>
191           <para>
192             <literal>rlandmann: locale/as.xml; locale/bn_IN.xml; locale/ast.xml; locale/ml.xml; locale/te.xml; ⋯</literal>
193           </para>
194           <screen>
195             <phrase role="commit-message">New translations from Red Hat and the Fedora Project</phrase>
196           </screen>
197         </listitem>
198         <listitem>
199           <para>
200             <literal>rlandmann: locale/pt.xml; locale/ca.xml; locale/da.xml; locale/sr.xml; locale/ru.xml; loca⋯</literal>
201           </para>
202           <screen>
203             <phrase role="commit-message">Updated translations from Red Hat and the Fedora Project</phrase>
204           </screen>
205         </listitem>
206       </itemizedlist>
207     </sect2>
208     <!--end of Gentext changes for 1.76.0-->
209     <sect2 xml:id="rnV1.76.0_Common">
210       <title>Common</title>
211       <para>The following changes have been made to the <filename>common</filename> code since the 1.75.2 release.</para>
212       <itemizedlist>
213         <listitem>
214           <para>
215             <literal>Mauritz Jeanson: common.xsl</literal>
216           </para>
217           <screen>
218             <phrase role="commit-message">Fixed bug in output-orderedlist-starting-number template (@startingnumber did not work for FO).</phrase>
219           </screen>
220         </listitem>
221         <listitem>
222           <para>
223             <literal>Mauritz Jeanson: gentext.xsl</literal>
224           </para>
225           <screen>
226             <phrase role="commit-message">Added fix to catch ID also of descendants of <tag>listitem</tag>. Closes bug #2955077.</phrase>
227           </screen>
228         </listitem>
229         <listitem>
230           <para>
231             <literal>Jirka Kosek: l10n.xsl</literal>
232           </para>
233           <screen>
234             <phrase role="commit-message">Stripped down, faster version of gentext.template is used when there is no localization customization.</phrase>
235           </screen>
236         </listitem>
237         <listitem>
238           <para>
239             <literal>Mauritz Jeanson: stripns.xsl</literal>
240           </para>
241           <screen>
242             <phrase role="commit-message">Added fix that preserves <tag>link</tag>/@role (makes links in the <tag>reference</tag> documentation
243 with @role="tcg" work).</phrase>
244           </screen>
245         </listitem>
246         <listitem>
247           <para>
248             <literal>Mauritz Jeanson: l10n.xsl</literal>
249           </para>
250           <screen>
251             <phrase role="commit-message">Fixed bugs related to manpages and L10n.</phrase>
252           </screen>
253         </listitem>
254         <listitem>
255           <para>
256             <literal>Jirka Kosek: entities.ent; autoidx-kosek.xsl</literal>
257           </para>
258           <screen>
259             <phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
260           </screen>
261         </listitem>
262         <listitem>
263           <para>
264             <literal>Jirka Kosek: l10n.xsl; l10n.dtd; l10n.xml; autoidx-kosek.xsl</literal>
265           </para>
266           <screen>
267             <phrase role="commit-message">Refactored localization support. Language files are loaded on demand. Speedup is about 30%.</phrase>
268           </screen>
269         </listitem>
270         <listitem>
271           <para>
272             <literal>Jirka Kosek: l10n.xsl</literal>
273           </para>
274           <screen>
275             <phrase role="commit-message">Added xsl:keys for improved performance of localization texts look up. Performance gain around 15%.</phrase>
276           </screen>
277         </listitem>
278         <listitem>
279           <para>
280             <literal>Mauritz Jeanson: titles.xsl</literal>
281           </para>
282           <screen>
283             <phrase role="commit-message">Fixed bug #2912677 (error with <tag>xref</tag> in <tag>title</tag>).</phrase>
284           </screen>
285         </listitem>
286         <listitem>
287           <para>
288             <literal>Robert Stayton: olink.xsl</literal>
289           </para>
290           <screen>
291             <phrase role="commit-message">Fix bug in xrefstyle "<tag>title</tag>" handling introduced with 
292 the 'insert.targetdb.data' template.</phrase>
293           </screen>
294         </listitem>
295         <listitem>
296           <para>
297             <literal>Robert Stayton: gentext.xsl</literal>
298           </para>
299           <screen>
300             <phrase role="commit-message">Fix bug in <tag>xref</tag> to <tag>equation</tag> without <tag>title</tag> to use context="xref-number" instead
301 of "xref-number-and-title".</phrase>
302           </screen>
303         </listitem>
304         <listitem>
305           <para>
306             <literal>Robert Stayton: labels.xsl</literal>
307           </para>
308           <screen>
309             <phrase role="commit-message">Number all equations in one sequence, with or without <tag>title</tag>.</phrase>
310           </screen>
311         </listitem>
312         <listitem>
313           <para>
314             <literal>Robert Stayton: entities.ent</literal>
315           </para>
316           <screen>
317             <phrase role="commit-message">Fix bug #2896909 where duplicate @sortas on indexterms caused 
318 some indexterms to drop out of <tag>index</tag>.</phrase>
319           </screen>
320         </listitem>
321         <listitem>
322           <para>
323             <literal>Robert Stayton: stripns.xsl</literal>
324           </para>
325           <screen>
326             <phrase role="commit-message">Expand the "Stripping namespace ..." message to advise users to
327 use the namespaced stylesheets.</phrase>
328           </screen>
329         </listitem>
330         <listitem>
331           <para>
332             <literal>Robert Stayton: stripns.xsl</literal>
333           </para>
334           <screen>
335             <phrase role="commit-message">need a local version of $exsl.node.set.available variable because
336 this module imported many places.</phrase>
337           </screen>
338         </listitem>
339         <listitem>
340           <para>
341             <literal>Mauritz Jeanson: olink.xsl</literal>
342           </para>
343           <screen>
344             <phrase role="commit-message">Added /node() to the select expression that is used to compute the <tag>title</tag> text
345 so that no &lt;ttl&gt; elements end up in the output. Closes bug #2830119.</phrase>
346           </screen>
347         </listitem>
348       </itemizedlist>
349     </sect2>
350     <!--end of Common changes for 1.76.0-->
351     <sect2 xml:id="rnV1.76.0_FO">
352       <title>FO</title>
353       <para>The following changes have been made to the
354             <filename>fo</filename> code
355             since the 1.75.2 release.</para>
356       <itemizedlist>
357         <listitem>
358           <para>
359             <literal>Robert Stayton: table.xsl</literal>
360           </para>
361           <screen>
362             <phrase role="commit-message">Fix bug 2979166 able - Attribute @rowheader not working</phrase>
363           </screen>
364         </listitem>
365         <listitem>
366           <para>
367             <literal>Mauritz Jeanson: inline.xsl</literal>
368           </para>
369           <screen>
370             <phrase role="commit-message">Improved <tag>glossterm</tag> auto-linking by using keys. The old code was inefficient when processing documents
371 with many inline glossterms.</phrase>
372           </screen>
373         </listitem>
374         <listitem>
375           <para>
376             <literal>Robert Stayton: titlepage.xsl</literal>
377           </para>
378           <screen>
379             <phrase role="commit-message">Fix bug 2805530 <tag>author</tag>/<tag>orgname</tag> not appearing on <tag>title</tag> page.</phrase>
380           </screen>
381         </listitem>
382         <listitem>
383           <para>
384             <literal>Mauritz Jeanson: graphics.xsl</literal>
385           </para>
386           <screen>
387             <phrase role="commit-message">Added support for SVG content in <tag>imagedata</tag> (inspired by patch #2909154).</phrase>
388           </screen>
389         </listitem>
390         <listitem>
391           <para>
392             <literal>Mauritz Jeanson: table.xsl</literal>
393           </para>
394           <screen>
395             <phrase role="commit-message">Removed superfluous test used when computing column-width. Closes bug #3000898.</phrase>
396           </screen>
397         </listitem>
398         <listitem>
399           <para>
400             <literal>Mauritz Jeanson: inline.xsl</literal>
401           </para>
402           <screen>
403             <phrase role="commit-message">Added missing &lt;xsl:call-template name="<tag>anchor</tag>"/&gt;. Closes bug #2998567.</phrase>
404           </screen>
405         </listitem>
406         <listitem>
407           <para>
408             <literal>Mauritz Jeanson: lists.xsl</literal>
409           </para>
410           <screen>
411             <phrase role="commit-message">Added table-layout="fixed" on <tag>segmentedlist</tag> <tag>table</tag> (required by XSL spec when  proportional-column-width() is used).</phrase>
412           </screen>
413         </listitem>
414         <listitem>
415           <para>
416             <literal>Jirka Kosek: autoidx-kosek.xsl</literal>
417           </para>
418           <screen>
419             <phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
420           </screen>
421         </listitem>
422         <listitem>
423           <para>
424             <literal>Jirka Kosek: index.xsl</literal>
425           </para>
426           <screen>
427             <phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
428           </screen>
429         </listitem>
430         <listitem>
431           <para>
432             <literal>Robert Stayton: xref.xsl</literal>
433           </para>
434           <screen>
435             <phrase role="commit-message">Fix bug in <tag>olink</tag> template when an <tag>olink</tag> has an id.
436 Add warning message with id value when trying to <tag>link</tag>
437 to an element that has no generated text.</phrase>
438           </screen>
439         </listitem>
440         <listitem>
441           <para>
442             <literal>Mauritz Jeanson: refentry.xsl</literal>
443           </para>
444           <screen>
445             <phrase role="commit-message">Fixed bug #2930968 (<tag>indexterm</tag> in <tag>refmeta</tag> not handled correctly).</phrase>
446           </screen>
447         </listitem>
448         <listitem>
449           <para>
450             <literal>Robert Stayton: block.xsl</literal>
451           </para>
452           <screen>
453             <phrase role="commit-message">fix bug 2949567 <tag>title</tag> in <tag>revhistory</tag> breaks FO transform.</phrase>
454           </screen>
455         </listitem>
456         <listitem>
457           <para>
458             <literal>Robert Stayton: glossary.xsl</literal>
459           </para>
460           <screen>
461             <phrase role="commit-message">Output id attributes on <tag>glossdiv</tag> blocks so they can be added to
462 xrefs or <tag>TOC</tag>.</phrase>
463           </screen>
464         </listitem>
465         <listitem>
466           <para>
467             <literal>Jirka Kosek: xref.xsl</literal>
468           </para>
469           <screen>
470             <phrase role="commit-message">Enabled hyphenation of URLs when ulink content is the same as <tag>link</tag> target</phrase>
471           </screen>
472         </listitem>
473         <listitem>
474           <para>
475             <literal>Robert Stayton: table.xsl</literal>
476           </para>
477           <screen>
478             <phrase role="commit-message">Apply patch to turn off <tag>row</tag> recursion if no @morerows attributes present.
479 This will enable very large tables without <tag>row</tag> spanning to 
480 process without running into recursion limits.</phrase>
481           </screen>
482         </listitem>
483         <listitem>
484           <para>
485             <literal>Robert Stayton: formal.xsl</literal>
486           </para>
487           <screen>
488             <phrase role="commit-message">Format <tag>equation</tag> without <tag>title</tag> using <tag>table</tag> layout with <tag>equation</tag> number
489 next to the <tag>equation</tag>.</phrase>
490           </screen>
491         </listitem>
492         <listitem>
493           <para>
494             <literal>Robert Stayton: param.xweb; param.ent</literal>
495           </para>
496           <screen>
497             <phrase role="commit-message">Add <parameter>equation.number.properties</parameter>.</phrase>
498           </screen>
499         </listitem>
500       </itemizedlist>
501     </sect2>
502     <!--end of FO changes for 1.76.0-->
503     <sect2 xml:id="rnV1.76.0_HTML">
504       <title>HTML</title>
505       <para>The following changes have been made to the
506             <filename>html</filename> code
507             since the 1.75.2 release.</para>
508       <itemizedlist>
509         <listitem>
510           <para>
511             <literal>Mauritz Jeanson: block.xsl</literal>
512           </para>
513           <screen>
514             <phrase role="commit-message">Modified <tag>acknowledgements</tag> template to avoid invalid output (&lt;p&gt; in &lt;p&gt;).</phrase>
515           </screen>
516         </listitem>
517         <listitem>
518           <para>
519             <literal>Mauritz Jeanson: titlepage.xsl</literal>
520           </para>
521           <screen>
522             <phrase role="commit-message">Added default <tag>sidebar</tag> attribute-sets.</phrase>
523           </screen>
524         </listitem>
525         <listitem>
526           <para>
527             <literal>Robert Stayton: table.xsl</literal>
528           </para>
529           <screen>
530             <phrase role="commit-message">Fix bug 2979166 able - Attribute @rowheader not working</phrase>
531           </screen>
532         </listitem>
533         <listitem>
534           <para>
535             <literal>Robert Stayton: footnote.xsl</literal>
536           </para>
537           <screen>
538             <phrase role="commit-message">Fix bug 3033191 footnotes in html tables.</phrase>
539           </screen>
540         </listitem>
541         <listitem>
542           <para>
543             <literal>Mauritz Jeanson: inline.xsl</literal>
544           </para>
545           <screen>
546             <phrase role="commit-message">Improved <tag>glossterm</tag> auto-linking by using keys. The old code was inefficient when processing documents
547 with many inline glossterms.</phrase>
548           </screen>
549         </listitem>
550         <listitem>
551           <para>
552             <literal>Robert Stayton: docbook.css.xml; verbatim.xsl</literal>
553           </para>
554           <screen>
555             <phrase role="commit-message">Fix bug 2844927 Validity error for <tag>callout</tag> bugs.</phrase>
556           </screen>
557         </listitem>
558         <listitem>
559           <para>
560             <literal>Robert Stayton: formal.xsl</literal>
561           </para>
562           <screen>
563             <phrase role="commit-message">Convert formal.object.heading to respect <parameter>make.clean.html</parameter> param.</phrase>
564           </screen>
565         </listitem>
566         <listitem>
567           <para>
568             <literal>Robert Stayton: titlepage.templates.xml; block.xsl</literal>
569           </para>
570           <screen>
571             <phrase role="commit-message">Fix bug 2840768 <tag>sidebar</tag> without <tag>title</tag> inserts empty b <tag>tag</tag>.</phrase>
572           </screen>
573         </listitem>
574         <listitem>
575           <para>
576             <literal>Mauritz Jeanson: docbook.xsl</literal>
577           </para>
578           <screen>
579             <phrase role="commit-message">Moved the template that outputs &lt;base&gt; so that the base URI also applies to relative CSS paths that come later.
580 See patch #2896121.</phrase>
581           </screen>
582         </listitem>
583         <listitem>
584           <para>
585             <literal>Jirka Kosek: autoidx-kosek.xsl</literal>
586           </para>
587           <screen>
588             <phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
589           </screen>
590         </listitem>
591         <listitem>
592           <para>
593             <literal>Robert Stayton: chunk-code.xsl</literal>
594           </para>
595           <screen>
596             <phrase role="commit-message">fix bug 2948363 generated <tag>filename</tag> for <tag>refentry</tag> not unique, when
597 used in a set.</phrase>
598           </screen>
599         </listitem>
600         <listitem>
601           <para>
602             <literal>Robert Stayton: component.xsl</literal>
603           </para>
604           <screen>
605             <phrase role="commit-message">Fix missing "<tag>Chapter</tag> n" <tag>label</tag> when use <tag>chapter</tag>/<tag>info</tag>/<tag>title</tag>.</phrase>
606           </screen>
607         </listitem>
608         <listitem>
609           <para>
610             <literal>Robert Stayton: table.xsl</literal>
611           </para>
612           <screen>
613             <phrase role="commit-message"><tag>Row</tag> recursion turned off if no @morerows attributes in the <tag>table</tag>.
614 This will prevent failure on long <tag>table</tag> (with no @morerows) due
615 to excessive depth of recursion.</phrase>
616           </screen>
617         </listitem>
618         <listitem>
619           <para>
620             <literal>Robert Stayton: autotoc.xsl; docbook.css.xml</literal>
621           </para>
622           <screen>
623             <phrase role="commit-message">Support <parameter>make.clean.html</parameter> in autotoc.xsl.</phrase>
624           </screen>
625         </listitem>
626         <listitem>
627           <para>
628             <literal>Robert Stayton: docbook.css.xml; block.xsl</literal>
629           </para>
630           <screen>
631             <phrase role="commit-message">Add support for <parameter>make.clean.html</parameter> setting in block elements.</phrase>
632           </screen>
633         </listitem>
634         <listitem>
635           <para>
636             <literal>Robert Stayton: docbook.css.xml</literal>
637           </para>
638           <screen>
639             <phrase role="commit-message">Stock CSS styles for DocBook HTML output when '<parameter>make.clean.html</parameter>' is non-zero.</phrase>
640           </screen>
641         </listitem>
642         <listitem>
643           <para>
644             <literal>Robert Stayton: html.xsl</literal>
645           </para>
646           <screen>
647             <phrase role="commit-message">Add templates for generating CSS files and links to them.</phrase>
648           </screen>
649         </listitem>
650         <listitem>
651           <para>
652             <literal>Robert Stayton: param.xweb</literal>
653           </para>
654           <screen>
655             <phrase role="commit-message">Fix bugs in new entity references.</phrase>
656           </screen>
657         </listitem>
658         <listitem>
659           <para>
660             <literal>Robert Stayton: chunk-common.xsl</literal>
661           </para>
662           <screen>
663             <phrase role="commit-message">List of Equations now includes on equations with titles.</phrase>
664           </screen>
665         </listitem>
666         <listitem>
667           <para>
668             <literal>Robert Stayton: table.xsl</literal>
669           </para>
670           <screen>
671             <phrase role="commit-message">If a <tag>colspec</tag> has a colname attribute, add it to the HTML <tag>col</tag>
672 element as a class attribute so it can be styled.</phrase>
673           </screen>
674         </listitem>
675         <listitem>
676           <para>
677             <literal>Robert Stayton: formal.xsl</literal>
678           </para>
679           <screen>
680             <phrase role="commit-message">Fix bug 2825842 where <tag>table</tag> footnotes not appearing in HTML-coded <tag>table</tag>.</phrase>
681           </screen>
682         </listitem>
683         <listitem>
684           <para>
685             <literal>Robert Stayton: chunktoc.xsl</literal>
686           </para>
687           <screen>
688             <phrase role="commit-message">Fix bug #2834826 where <tag>appendix</tag> inside part was not chunked as it should be.</phrase>
689           </screen>
690         </listitem>
691         <listitem>
692           <para>
693             <literal>Mauritz Jeanson: chunktoc.xsl</literal>
694           </para>
695           <screen>
696             <phrase role="commit-message">Added missing namespace declarations. Closes bug #2890069.</phrase>
697           </screen>
698         </listitem>
699         <listitem>
700           <para>
701             <literal>Mauritz Jeanson: footnote.xsl</literal>
702           </para>
703           <screen>
704             <phrase role="commit-message">Updated the template for <tag>footnote</tag> paras to use the 'paragraph' template. Closes bug #2803739.</phrase>
705           </screen>
706         </listitem>
707         <listitem>
708           <para>
709             <literal>Keith Fahlgren: inline.xsl; lists.xsl</literal>
710           </para>
711           <screen>
712             <phrase role="commit-message">Remove &lt;b&gt; and &lt;i&gt; elements "discouraged in favor of style sheets" from
713 XHTML, XHTML 1.1 (and therefore EPUB) outputs by changing html2xhtml.xsl.
714
715 Fixes bug #2873153: No &lt;b&gt; and &lt;i&gt; tags in XHTML/EPUB
716
717 Added regression to EPUB specs:</phrase>
718           </screen>
719         </listitem>
720         <listitem>
721           <para>
722             <literal>Mauritz Jeanson: inline.xsl</literal>
723           </para>
724           <screen>
725             <phrase role="commit-message">Fixed bug #2844916 (don't output @target if <parameter>ulink.target</parameter> is empty).</phrase>
726           </screen>
727         </listitem>
728         <listitem>
729           <para>
730             <literal>Keith Fahlgren: autoidx.xsl</literal>
731           </para>
732           <screen>
733             <phrase role="commit-message">Fix a bug when using <parameter>index.on.type</parameter>: an '<tag>index</tag> symbols' <tag>section</tag> was created 
734 even if that typed <tag>index</tag> didn't include any symbols (they were in the other types).</phrase>
735           </screen>
736         </listitem>
737       </itemizedlist>
738     </sect2>
739     <!--end of HTML changes for 1.76.0-->
740     <sect2 xml:id="rnV1.76.0_Manpages">
741       <title>Manpages</title>
742       <para>The following changes have been made to the
743             <filename>manpages</filename> code
744             since the 1.75.2 release.</para>
745       <itemizedlist>
746         <listitem>
747           <para>
748             <literal>Mauritz Jeanson: other.xsl</literal>
749           </para>
750           <screen>
751             <phrase role="commit-message">Modified the write.stubs template so that the <tag>section</tag> directory name is not output twice. Should fix bug #2831602.
752 Also ensured that $lang is added to the .so path (when <parameter>man.output.lang.in.name.enabled</parameter>=1).</phrase>
753           </screen>
754         </listitem>
755         <listitem>
756           <para>
757             <literal>Mauritz Jeanson: docbook.xsl; other.xsl</literal>
758           </para>
759           <screen>
760             <phrase role="commit-message">Fixed bug #2412738 (apostrophe escaping) by applying the submitted patch.</phrase>
761           </screen>
762         </listitem>
763         <listitem>
764           <para>
765             <literal>Norman Walsh: block.xsl; endnotes.xsl</literal>
766           </para>
767           <screen>
768             <phrase role="commit-message">Fix bug where <tag>simpara</tag> in <tag>footnote</tag> didn't work. Patch by Jonathan Nieder, jrnieder@gmail.com</phrase>
769           </screen>
770         </listitem>
771         <listitem>
772           <para>
773             <literal>dleidert: lists.xsl</literal>
774           </para>
775           <screen>
776             <phrase role="commit-message">Fix two indentation issues: In the first case there is no corresponding .RS
777 macro (Debian #519438, sf.net 2793873). In the second case an .RS instead of
778 the probably intended .sp leads to an indentation bug (Debian #527309,
779 sf.net #2642139).</phrase>
780           </screen>
781         </listitem>
782       </itemizedlist>
783     </sect2>
784     <!--end of Manpages changes for 1.76.0-->
785     <sect2 xml:id="rnV1.76.0_Epub">
786       <title>Epub</title>
787       <para>The following changes have been made to the
788             <filename>epub</filename> code
789             since the 1.75.2 release.</para>
790       <itemizedlist>
791         <listitem>
792           <para>
793             <literal>Keith Fahlgren: bin/spec/examples/AMasqueOfDays.epub; docbook.xsl; bin/spec/epub_spec.rb</literal>
794           </para>
795           <screen>
796             <phrase role="commit-message">Resolve some actual regressions in <tag>date</tag> output spotted by more recent versions of epubcheck</phrase>
797           </screen>
798         </listitem>
799         <listitem>
800           <para>
801             <literal>Keith Fahlgren: docbook.xsl</literal>
802           </para>
803           <screen>
804             <phrase role="commit-message">Updated <tag>mediaobject</tag> selection code that better uses roles (when available); based on contributons by  Glenn McDonald</phrase>
805           </screen>
806         </listitem>
807         <listitem>
808           <para>
809             <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl</literal>
810           </para>
811           <screen>
812             <phrase role="commit-message">Ensure that NCX documents are always outputted with a default namespace
813 to prevent problems with the kindlegen machinery</phrase>
814           </screen>
815         </listitem>
816         <listitem>
817           <para>
818             <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/partintro.xml; docbook.x⋯</literal>
819           </para>
820           <screen>
821             <phrase role="commit-message">Adding support for partintros with sect2s, 3s, etc</phrase>
822           </screen>
823         </listitem>
824         <listitem>
825           <para>
826             <literal>Keith Fahlgren: docbook.xsl</literal>
827           </para>
828           <screen>
829             <phrase role="commit-message">Adding param to workaround horrific ADE bug with the inability to process &lt;br&gt;</phrase>
830           </screen>
831         </listitem>
832         <listitem>
833           <para>
834             <literal>Keith Fahlgren: docbook.xsl</literal>
835           </para>
836           <screen>
837             <phrase role="commit-message">Add support for <tag>authorgroup</tag>/<tag>author</tag> in OPF metadata (via Michael Wiedmann)</phrase>
838           </screen>
839         </listitem>
840         <listitem>
841           <para>
842             <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb</literal>
843           </para>
844           <screen>
845             <phrase role="commit-message">Remove &lt;b&gt; and &lt;i&gt; elements "discouraged in favor of style sheets" from
846 XHTML, XHTML 1.1 (and therefore EPUB) outputs by changing html2xhtml.xsl.
847
848 Fixes bug #2873153: No &lt;b&gt; and &lt;i&gt; tags in XHTML/EPUB
849
850 Added regression to EPUB specs:</phrase>
851           </screen>
852         </listitem>
853         <listitem>
854           <para>
855             <literal>Keith Fahlgren: bin/lib/docbook.rb; bin/spec/files/DejaVuSerif-Italic.otf; docbook.xsl; bi⋯</literal>
856           </para>
857           <screen>
858             <phrase role="commit-message">This resolves bug #2873142, Please add support for multiple embedded fonts
859
860
861 If you navigate to a checkout of DocBook-XSL and go to:
862 xsl/epub/bin/spec/files
863 You can now run the following <tag>command</tag>:
864
865 ../../dbtoepub -f DejaVuSerif.otf -f DejaVuSerif-Italic.otf -c test.css
866 -s test_cust.xsl orm.book.001.xml
867
868 In dbtoepub, the following option can be used more than once:
869 -f, --font [OTF FILE] Embed OTF FILE in .epub.
870
871 The underlying stylesheet now accepts a comma-separated list of font file
872 names rather than just one as the RENAMED epub.embedded.fonts ('s' added).
873
874 The runnable EPUB spec now includes:
875 - should be valid .epub after including more than one embedded font</phrase>
876           </screen>
877         </listitem>
878         <listitem>
879           <para>
880             <literal>Keith Fahlgren: docbook.xsl</literal>
881           </para>
882           <screen>
883             <phrase role="commit-message">Improve the selection of <tag>cover</tag> images when working in DocBook 4.x land (work in progress)</phrase>
884           </screen>
885         </listitem>
886         <listitem>
887           <para>
888             <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl</literal>
889           </para>
890           <screen>
891             <phrase role="commit-message">Improve the quality of the OPF spine regression by ensuring that the spine
892 elements for deeply nested refentries are in order and adjacent to their
893 opening wrapper XHTML chunk.</phrase>
894           </screen>
895         </listitem>
896         <listitem>
897           <para>
898             <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/files/orm.book.00⋯</literal>
899           </para>
900           <screen>
901             <phrase role="commit-message">Add more careful handling of refentries to ensure that they always appear in the opf:spine.
902 This was only a problem when refentries were pushed deep into the hierarchy (like inside
903 a <tag>sect2</tag>), but presented navigational problems for many reading systems (despite the
904 correct NCX references). This may *not* be the best solution, but attacking a better
905 chunking strategy for refentries was too big a nut to crack at this time.</phrase>
906           </screen>
907         </listitem>
908       </itemizedlist>
909     </sect2>
910     <!--end of Epub changes for 1.76.0-->
911     <sect2 xml:id="rnV1.76.0_Eclipse">
912       <title>Eclipse</title>
913       <para>The following changes have been made to the
914             <filename>eclipse</filename> code
915             since the 1.75.2 release.</para>
916       <itemizedlist>
917         <listitem>
918           <para>
919             <literal>Mauritz Jeanson: eclipse3.xsl</literal>
920           </para>
921           <screen>
922             <phrase role="commit-message">Added a stylesheet module that generates plug-ins conforming to the standard (OSGi-based) Eclipse 3.x 
923 architecture. The main difference to the older format is that metadata is stored in a separate 
924 <parameter>manifest</parameter> file. The module imports and extends the existing eclipse.xsl module. Based on code 
925 contributed in patch #2624668.</phrase>
926           </screen>
927         </listitem>
928       </itemizedlist>
929     </sect2>
930     <!--end of Eclipse changes for 1.76.0-->
931     <sect2 xml:id="rnV1.76.0_Params">
932       <title>Params</title>
933       <para>The following changes have been made to the
934             <filename>params</filename> code
935             since the 1.75.2 release.</para>
936       <itemizedlist>
937         <listitem>
938           <para>
939             <literal>Robert Stayton: draft.watermark.image.xml</literal>
940           </para>
941           <screen>
942             <phrase role="commit-message">Fix bug 2922488 <parameter>draft.watermark.image</parameter> pointing to web resource.
943 Now the value is images/draft.png, and may require customization
944 for local resolution.</phrase>
945           </screen>
946         </listitem>
947         <listitem>
948           <para>
949             <literal>Mauritz Jeanson: equation.number.properties.xml</literal>
950           </para>
951           <screen>
952             <phrase role="commit-message">Corrected <tag>refpurpose</tag>.</phrase>
953           </screen>
954         </listitem>
955         <listitem>
956           <para>
957             <literal>Norman Walsh: paper.type.xml</literal>
958           </para>
959           <screen>
960             <phrase role="commit-message">Added USlegal and USlegallandscape paper types.</phrase>
961           </screen>
962         </listitem>
963         <listitem>
964           <para>
965             <literal>Jirka Kosek: highlight.xslthl.config.xml</literal>
966           </para>
967           <screen>
968             <phrase role="commit-message">Added note about specifying location as URL</phrase>
969           </screen>
970         </listitem>
971         <listitem>
972           <para>
973             <literal>Robert Stayton: docbook.css.source.xml; generate.css.header.xml; custom.css.source.xml; ma⋯</literal>
974           </para>
975           <screen>
976             <phrase role="commit-message">Params to support generated CSS files.</phrase>
977           </screen>
978         </listitem>
979         <listitem>
980           <para>
981             <literal>Robert Stayton: equation.number.properties.xml</literal>
982           </para>
983           <screen>
984             <phrase role="commit-message">New attribute set for numbers appearing next to equations.</phrase>
985           </screen>
986         </listitem>
987       </itemizedlist>
988     </sect2>
989     <!--end of Params changes for 1.76.0-->
990     <sect2 xml:id="rnV1.76.0_XSL-Xalan">
991       <title>XSL-Xalan</title>
992       <para>The following changes have been made to the
993             <filename>xsl-xalan</filename> code
994             since the 1.75.2 release.</para>
995       <itemizedlist>
996         <listitem>
997           <para>
998             <literal>dleidert: nbproject/genfiles.properties; nbproject/build-impl.xml</literal>
999           </para>
1000           <screen>
1001             <phrase role="commit-message">Rebuild netbeans build files after adding missing Netbeans configuration to allow easier packaging for Debian.</phrase>
1002           </screen>
1003         </listitem>
1004       </itemizedlist>
1005     </sect2>
1006     <!--end of XSL-Xalan changes for 1.76.0-->
1007   </sect1>
1008 <sect1 xml:id="rn_V1.75.2">
1009 <title>Release Notes: 1.75.2</title>
1010 <para>The following is a list of changes that have been made
1011         since the 1.75.1 release.</para>
1012
1013 <sect2 xml:id="rn_V1.75.2_Gentext">
1014 <title>Gentext</title>
1015 <para>The following changes have been made to the
1016             <filename>gentext</filename> code
1017             since the 1.75.1 release.</para>
1018 <itemizedlist>
1019 <listitem>
1020 <para><literal>dleidert: locale/ja.xml</literal></para><screen><phrase role="commit-message">Improved Japanese translation for Note(s). Closes bug #2823965.</phrase></screen>
1021 </listitem>
1022 <listitem>
1023 <para><literal>dleidert: locale/pl.xml</literal></para><screen><phrase role="commit-message">Polish alphabet contains O with acute accent, not with grave accent. Closes bug #2823964.</phrase></screen>
1024 </listitem>
1025 <listitem>
1026 <para><literal>Robert Stayton: locale/ja.xml</literal></para><screen><phrase role="commit-message">Fix translation of "<tag>index</tag>", per bug report 2796064.</phrase></screen>
1027 </listitem>
1028 <listitem>
1029 <para><literal>Robert Stayton: locale/is.xml</literal></para><screen><phrase role="commit-message">New Icelandic locale file.</phrase></screen>
1030 </listitem>
1031 </itemizedlist>
1032 </sect2><!--end of Gentext changes for 1.75.2-->
1033
1034 <sect2 xml:id="rn_V1.75.2_Common">
1035 <title>Common</title>
1036 <para>The following changes have been made to the
1037             <filename>common</filename> code
1038             since the 1.75.1 release.</para>
1039 <itemizedlist>
1040 <listitem>
1041 <para><literal>Norman Walsh: stripns.xsl</literal></para><screen><phrase role="commit-message">Support more downconvert cases</phrase></screen>
1042 </listitem>
1043 <listitem>
1044 <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Make sure <tag>title</tag> inside <tag>info</tag> is used if no other <tag>title</tag>.</phrase></screen>
1045 </listitem>
1046 </itemizedlist>
1047 </sect2><!--end of Common changes for 1.75.2-->
1048
1049 <sect2 xml:id="rn_V1.75.2_FO">
1050 <title>FO</title>
1051 <para>The following changes have been made to the
1052             <filename>fo</filename> code
1053             since the 1.75.1 release.</para>
1054 <itemizedlist>
1055 <listitem>
1056 <para><literal>Robert Stayton: pi.xsl</literal></para><screen><phrase role="commit-message">Turn off dbfo-need for <parameter>fop1.extensions</parameter> also, per bug #2816141.</phrase></screen>
1057 </listitem>
1058 </itemizedlist>
1059 </sect2><!--end of FO changes for 1.75.2-->
1060
1061 <sect2 xml:id="rn_V1.75.2_HTML">
1062 <title>HTML</title>
1063 <para>The following changes have been made to the
1064             <filename>html</filename> code
1065             since the 1.75.1 release.</para>
1066 <itemizedlist>
1067 <listitem>
1068 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Output "<tag>Copyright</tag>" heading in XHTML too.</phrase></screen>
1069 </listitem>
1070 <listitem>
1071 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added stylesheet.result.type test for <tag>copyright</tag>. Closes bug #2813289.</phrase></screen>
1072 </listitem>
1073 <listitem>
1074 <para><literal>Norman Walsh: htmltbl.xsl</literal></para><screen><phrase role="commit-message">Remove ambiguity wrt @span, @rowspan, and @colspan</phrase></screen>
1075 </listitem>
1076 </itemizedlist>
1077 </sect2><!--end of HTML changes for 1.75.2-->
1078
1079 <sect2 xml:id="rn_V1.75.2_Manpages">
1080 <title>Manpages</title>
1081 <para>The following changes have been made to the
1082             <filename>manpages</filename> code
1083             since the 1.75.1 release.</para>
1084 <itemizedlist>
1085 <listitem>
1086 <para><literal>Mauritz Jeanson: endnotes.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space() for ulink content. Closes bug #2793877.</phrase></screen>
1087 </listitem>
1088 <listitem>
1089 <para><literal>Mauritz Jeanson: docbook.xsl</literal></para><screen><phrase role="commit-message">Added stylesheet.result.type test for <tag>copyright</tag>. Closes bug #2813289.</phrase></screen>
1090 </listitem>
1091 </itemizedlist>
1092 </sect2><!--end of Manpages changes for 1.75.2-->
1093
1094 <sect2 xml:id="rn_V1.75.2_Epub">
1095 <title>Epub</title>
1096 <para>The following changes have been made to the
1097             <filename>epub</filename> code
1098             since the 1.75.1 release.</para>
1099 <itemizedlist>
1100 <listitem>
1101 <para><literal>Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb</literal></para><screen><phrase role="commit-message">Corrected bugs caused by path and file assumptions were not met</phrase></screen>
1102 </listitem>
1103 <listitem>
1104 <para><literal>Keith Fahlgren: bin/lib/docbook.rb; docbook.xsl</literal></para><screen><phrase role="commit-message">Cleaning up hardcoded values into parameters and fixing Ruby library to pass them properly; all thanks to patch from Liza Daly</phrase></screen>
1105 </listitem>
1106 </itemizedlist>
1107 </sect2><!--end of Epub changes for 1.75.2-->
1108
1109 <sect2 xml:id="rn_V1.75.2_Profiling">
1110 <title>Profiling</title>
1111 <para>The following changes have been made to the
1112             <filename>profiling</filename> code
1113             since the 1.75.1 release.</para>
1114 <itemizedlist>
1115 <listitem>
1116 <para><literal>Robert Stayton: profile.xsl</literal></para><screen><phrase role="commit-message">Fix bug 2815493 missing <parameter>exsl.node.set.available</parameter> parameter.</phrase></screen>
1117 </listitem>
1118 </itemizedlist>
1119 </sect2><!--end of Profiling changes for 1.75.2-->
1120
1121 <sect2 xml:id="rn_V1.75.2_XSL-Saxon">
1122 <title>XSL-Saxon</title>
1123 <para>The following changes have been made to the
1124             <filename>xsl-saxon</filename> code
1125             since the 1.75.1 release.</para>
1126 <itemizedlist>
1127 <listitem>
1128 <para><literal>Mauritz Jeanson: src/com/nwalsh/saxon/ColumnUpdateEmitter.java; src/com/nwalsh/saxon/Colum⋯</literal></para><screen><phrase role="commit-message">Added fixes so that colgroups in the XHTML namespace are processed properly.</phrase></screen>
1129 </listitem>
1130 </itemizedlist>
1131 </sect2><!--end of XSL-Saxon changes for 1.75.2-->
1132
1133 <sect2 xml:id="rn_V1.75.2_XSL-Xalan">
1134 <title>XSL-Xalan</title>
1135 <para>The following changes have been made to the
1136             <filename>xsl-xalan</filename> code
1137             since the 1.75.1 release.</para>
1138 <itemizedlist>
1139 <listitem>
1140 <para><literal>Mauritz Jeanson: nbproject/project.xml</literal></para><screen><phrase role="commit-message">Added missing NetBeans configuration.</phrase></screen>
1141 </listitem>
1142 </itemizedlist>
1143 </sect2><!--end of XSL-Xalan changes for 1.75.2-->
1144
1145 </sect1>
1146
1147
1148 <sect1 xml:id="rn_V1.75.1">
1149 <title>Release Notes: 1.75.1</title>
1150 <para>This release includes bug fixes.</para>
1151
1152 <para>The following is a list of changes that have been made since the 1.75.0 release.</para>
1153
1154
1155 <sect2 xml:id="rn_V1.75.1_FO">
1156 <title>FO</title>
1157 <para>The following changes have been made to the <filename>fo</filename> code since the 1.75.0 release.</para>
1158 <itemizedlist>
1159 <listitem>
1160 <para><literal>Keith Fahlgren: block.xsl</literal></para><screen><phrase role="commit-message">Switching to em dash for character before <tag>attribution</tag> in <tag>epigraph</tag>; resolves Bug #2793878</phrase></screen>
1161 </listitem>
1162 <listitem>
1163 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed bug 2789947, id attribute missing on <tag>simplelist</tag> fo output.</phrase></screen>
1164 </listitem>
1165 </itemizedlist>
1166 </sect2><!--end of FO changes for 1.75.1-->
1167
1168 <sect2 xml:id="rn_V1.75.1_HTML">
1169 <title>HTML</title>
1170 <para>The following changes have been made to the
1171             <filename>html</filename> code
1172             since the 1.75.0 release.</para>
1173 <itemizedlist>
1174 <listitem>
1175 <para><literal>Keith Fahlgren: block.xsl</literal></para><screen><phrase role="commit-message">Switching to em dash for character before <tag>attribution</tag> in <tag>epigraph</tag>; resolves Bug #2793878</phrase></screen>
1176 </listitem>
1177 <listitem>
1178 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed bug 2789678: apply-templates line accidentally deleted.</phrase></screen>
1179 </listitem>
1180 </itemizedlist>
1181 </sect2><!--end of HTML changes for 1.75.1-->
1182
1183 <sect2 xml:id="rn_V1.75.1_Epub">
1184 <title>Epub</title>
1185 <para>The following changes have been made to the
1186             <filename>epub</filename> code
1187             since the 1.75.0 release.</para>
1188 <itemizedlist>
1189 <listitem>
1190 <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl</literal></para><screen><phrase role="commit-message">Added regression and fix to correct "bug" with namespace-prefixed container elements in META-INF/container.xml ; resolves Issue #2790017</phrase></screen>
1191 </listitem>
1192 <listitem>
1193 <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/onegraphic.xinclude.xml;⋯</literal></para><screen><phrase role="commit-message">Another attempt at flexible named entity and XInclude processing</phrase></screen>
1194 </listitem>
1195 <listitem>
1196 <para><literal>Keith Fahlgren: bin/lib/docbook.rb</literal></para><screen><phrase role="commit-message">Tweaking solution to Bug #2750442 following regression reported by Michael Wiedmann.</phrase></screen>
1197 </listitem>
1198 </itemizedlist>
1199 </sect2><!--end of Epub changes for 1.75.1-->
1200
1201 <sect2 xml:id="rn_V1.75.1_Params">
1202 <title>Params</title>
1203 <para>The following changes have been made to the
1204             <filename>params</filename> code
1205             since the 1.75.0 release.</para>
1206 <itemizedlist>
1207 <listitem>
1208 <para><literal>Mauritz Jeanson: highlight.source.xml</literal></para><screen><phrase role="commit-message">Updated documentation to reflect changes made in r8419.</phrase></screen>
1209 </listitem>
1210 </itemizedlist>
1211 </sect2><!--end of Params changes for 1.75.1-->
1212
1213 </sect1>
1214
1215
1216 <sect1 xml:id="V1.75.0">
1217 <title>Release Notes: 1.75.0</title>
1218 <para>This release includes important bug fixes and adds the following
1219 significant feature changes:
1220 <variablelist>
1221 <varlistentry>
1222 <term>Gentext</term>
1223 <listitem><para>Modifications to translations have been made. </para></listitem>
1224
1225 </varlistentry>
1226 <varlistentry>
1227 <term>Common</term>
1228 <listitem>
1229 <para>Added support for some format properties on tables using
1230 HTML <tag>table</tag> markup.  </para>
1231 <para>Added two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections
1232 and numbered questions can be distinguished.  Satisfies
1233 Feature Request #1539045.</para>
1234 <para>Added code to handle <tag>acknowledgements</tag> in <tag>book</tag> and part. The element is processed
1235 similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
1236 any dedications.</para>
1237 </listitem>
1238 </varlistentry>
1239
1240 <varlistentry>
1241 <term>FO</term>
1242 <listitem>
1243 <para>The inclusion of highlighting code has been simplified.</para>
1244 <para>Add support for pgwide on informal objects.</para>
1245 <para>Added a new parameter, <parameter>bookmarks.collapse</parameter>, that controls the initial <tag>state</tag> of the bookmark tree. Closes FR #1792326.</para>
1246 <para>Add support for more dbfo processing instructions.</para>
1247 <para>Add new <parameter>variablelist.term.properties</parameter> to format terms, per request # 1968513.</para>
1248 <para>Add support for @width on <tag>screen</tag> and <tag>programlisting</tag>, fixes bug #2012736.</para>
1249 <para>Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.  </para>
1250 <para>Add <parameter>writing.mode</parameter> param for FO output.</para>
1251 </listitem>
1252 </varlistentry>
1253 <varlistentry>
1254 <term>HTML</term>
1255 <listitem>
1256 <para>Convert all calls to class.attribute to calls to common.html.attributes to support dir, lang, and <tag>title</tag> attributes in html output for all elements.  Fulfills feature request #1993833.</para>
1257 <para>Inclusion of highlighting code was simplified. Only one import is now necessary.</para>
1258 <para>Add new param <parameter>index.links.to.section</parameter>.</para>
1259 <para>Add support for the new <parameter>index.links.to.section</parameter> param which permits precise links to indexterms in HTML output rather than to the <tag>section</tag> <tag>title</tag>.</para>
1260 </listitem>
1261 </varlistentry>
1262 <varlistentry>
1263 <term>ePub</term>
1264 <listitem>
1265 <para>Slightly more nuanced handling of <tag>imageobject</tag> alternatives and better support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442 reported by Raphael Hertzog.</para>
1266 <para>Added a colon after an <tag>abstract</tag>/<tag>title</tag> when mapping into the dc:description for OPF metadata in ePub output to help the flat text have more pseudo-semantics (sugestions from Michael Wiedmann)</para>
1267 <para>Added DocBook <tag>subjectset</tag> -&gt; OPF dc:<tag>subject</tag> mapping and tests</para>
1268 <para>Added DocBook <tag>date</tag> -&gt; OPF dc:date mapping and tests</para>
1269 <para>Added DocBook <tag>abstract</tag> -&gt; OPF dc:description mapping and tests</para>
1270 <para>Added --output option to dbtoepub based on user request</para>
1271 </listitem>
1272
1273 </varlistentry>
1274 <varlistentry>
1275 <term>HTMLHelp</term>
1276 <listitem>
1277 <para>Add support for generating <tag>olink</tag> target <tag>database</tag> for htmlhelp files.</para></listitem>
1278
1279 </varlistentry>
1280
1281 <varlistentry>
1282 <term>Params</term>
1283 <listitem>
1284 <para>Add default setting for @rules attribute on HTML markup tables.</para>
1285 <para>Added a new parameter, <parameter>bookmarks.collapse</parameter>, that controls the initial <tag>state</tag> of the bookmark tree. When the parameter has a non-zero value (the default), only the top-level bookmarks are displayed initially. Otherwise, the whole tree of bookmarks is displayed.  This is implemented for FOP 0.9X. Closes FR #1792326.</para>
1286 <para>Add new <parameter>variablelist.term.properties</parameter> to format terms, per request # 1968513.</para>
1287 <para>Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections and numbered questions can be distinguished.  Satisfies Feature Request #1539045.</para>
1288 <para>Add param to control whether an <tag>index</tag> <tag>entry</tag> links to a <tag>section</tag> <tag>title</tag> or to the precise location of the <tag>indexterm</tag>.</para>
1289 <para>New attribute list for <tag>glossentry</tag> in <tag>glossary</tag>.</para>
1290 <para>New parameter to support @width on <tag>programlisting</tag> and <tag>screen</tag>.</para>
1291 <para>Add attribute-sets for formatting <tag>glossary</tag> terms and defs.</para>
1292 </listitem>
1293 </varlistentry>
1294 <varlistentry>
1295 <term>Highlighting</term>
1296 <listitem>
1297 <para>Inclusion of highlighting code was simplified. Only one import is now necessary.</para>
1298 </listitem>
1299
1300 </varlistentry>
1301 </variablelist>
1302
1303
1304 </para>
1305 <para>The following is a list of changes that have been made
1306         since the 1.74.3 release.</para>
1307
1308 <sect2 xml:id="rn_V1.75.0_Gentext">
1309 <title>Gentext</title>
1310 <para>The following changes have been made to the
1311             <filename>gentext</filename> code
1312             since the 1.74.3 release.</para>
1313 <itemizedlist>
1314 <listitem>
1315 <para><literal>Robert Stayton: locale/sv.xml; locale/ja.xml; locale/pl.xml</literal></para><screen><phrase role="commit-message">Check in translations of <tag>Legalnotice</tag> submitted on mailing list.</phrase></screen>
1316 </listitem>
1317 <listitem>
1318 <para><literal>Robert Stayton: locale/es.xml</literal></para><screen><phrase role="commit-message">Fix spelling errors in <tag>Acknowledgements</tag> entries.</phrase></screen>
1319 </listitem>
1320 <listitem>
1321 <para><literal>Robert Stayton: locale/es.xml</literal></para><screen><phrase role="commit-message">Check in translations for 4 elements submitted through docbook-apps
1322 message of 14 April 2009.</phrase></screen>
1323 </listitem>
1324 <listitem>
1325 <para><literal>David Cramer: locale/zh.xml; locale/ca.xml; locale/ru.xml; locale/ga.xml; locale/gl.xml; l⋯</literal></para><screen><phrase role="commit-message">Internationalized punctuation in <tag>glosssee</tag> and <tag>glossseealso</tag></phrase></screen>
1326 </listitem>
1327 <listitem>
1328 <para><literal>Robert Stayton: Makefile</literal></para><screen><phrase role="commit-message">Check in fixes for DSSSL gentext targets from submitted patch #1689633.</phrase></screen>
1329 </listitem>
1330 <listitem>
1331 <para><literal>Robert Stayton: locale/uk.xml</literal></para><screen><phrase role="commit-message">Check in major update submitted with bug report #2008524.</phrase></screen>
1332 </listitem>
1333 <listitem>
1334 <para><literal>Robert Stayton: locale/zh_tw.xml</literal></para><screen><phrase role="commit-message">Check in fix to Note string submitted in bug #2441051.</phrase></screen>
1335 </listitem>
1336 <listitem>
1337 <para><literal>Robert Stayton: locale/ru.xml</literal></para><screen><phrase role="commit-message">Checkin typo fix submitted in bug #2453406.</phrase></screen>
1338 </listitem>
1339 </itemizedlist>
1340 </sect2><!--end of Gentext changes for 1.75.0-->
1341
1342 <sect2 xml:id="rn_V1.75.0_Common">
1343 <title>Common</title>
1344 <para>The following changes have been made to the
1345             <filename>common</filename> code
1346             since the 1.74.3 release.</para>
1347 <itemizedlist>
1348 <listitem>
1349 <para><literal>Robert Stayton: gentext.xsl</literal></para><screen><phrase role="commit-message">Fix extra generated space when xrefstyle includes 'nopage'.</phrase></screen>
1350 </listitem>
1351 <listitem>
1352 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support for some format properties on tables using
1353 HTML <tag>table</tag> markup.  These include:
1354   - frame attribute on <tag>table</tag> (or uses $default.table.frame parameter).
1355   - rules attribute on <tag>table</tag> (or uses $default.table.rules parameter).
1356   - align attribute on <tag>td</tag> and <tag>th</tag>
1357   - valign attribute on <tag>td</tag> and <tag>th</tag>
1358   - colspan on <tag>td</tag> and <tag>th</tag>
1359   - rowspan on <tag>td</tag> and <tag>th</tag>
1360   - bgcolor on <tag>td</tag> and <tag>th</tag></phrase></screen>
1361 </listitem>
1362 <listitem>
1363 <para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Add placeholder template to massage <tag>olink</tag> hot text to make
1364 customization easier, per Feature Request 1828608.</phrase></screen>
1365 </listitem>
1366 <listitem>
1367 <para><literal>Robert Stayton: targets.xsl</literal></para><screen><phrase role="commit-message">Add support for collecting <tag>olink</tag> targets from a <tag>glossary</tag>
1368 generated from a <parameter>glossary.collection</parameter>.</phrase></screen>
1369 </listitem>
1370 <listitem>
1371 <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Handle <tag>firstterm</tag> like <tag>glossterm</tag> in mode="title.markup".</phrase></screen>
1372 </listitem>
1373 <listitem>
1374 <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Add match on <tag>info</tag>/<tag>title</tag> in title.markup templates where missing.</phrase></screen>
1375 </listitem>
1376 <listitem>
1377 <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Changed "ancestor::<tag>title</tag>" to "(ancestor::<tag>title</tag> and (@id or @xml:id))".
1378 This enables proper formatting of inline elements in titles in TOCs, 
1379 as long as these inlines don't have id or xml:id attributes.</phrase></screen>
1380 </listitem>
1381 <listitem>
1382 <para><literal>Robert Stayton: labels.xsl</literal></para><screen><phrase role="commit-message">Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections
1383 and numbered questions can be distinguished.  Satisfies
1384 Feature Request #1539045.</phrase></screen>
1385 </listitem>
1386 <listitem>
1387 <para><literal>Robert Stayton: stripns.xsl; pi.xsl</literal></para><screen><phrase role="commit-message">Convert function-available(exsl:node-set) to use the new param
1388 so Xalan bug is isolated.</phrase></screen>
1389 </listitem>
1390 <listitem>
1391 <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Added fixes for bugs #2112656 and #1759205:
1392 1. Reverted mistaken commits r7485 and r7523. 
1393 2. Updated the template with match="<tag>link</tag>" and mode="no.anchor.mode" so that 
1394 @endterm is used if it exists and if the <tag>link</tag> has no content.</phrase></screen>
1395 </listitem>
1396 <listitem>
1397 <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Added code to handle <tag>acknowledgements</tag> in <tag>book</tag> and part. The element is processed
1398 similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
1399 any dedications.</phrase></screen>
1400 </listitem>
1401 <listitem>
1402 <para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Fix bug #2018717 <parameter>use.local.olink.style</parameter> uses wrong gentext context.</phrase></screen>
1403 </listitem>
1404 <listitem>
1405 <para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787167 incorrect hot text for some olinks.</phrase></screen>
1406 </listitem>
1407 <listitem>
1408 <para><literal>Robert Stayton: common.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1669654 Broken output if <tag>copyright</tag> &lt;<tag>year</tag>&gt; contains a range.</phrase></screen>
1409 </listitem>
1410 <listitem>
1411 <para><literal>Robert Stayton: labels.xsl</literal></para><screen><phrase role="commit-message">Fix bug in labelling <tag>figure</tag> inside <tag>appendix</tag> inside <tag>article</tag> inside <tag>book</tag>.</phrase></screen>
1412 </listitem>
1413 </itemizedlist>
1414 </sect2><!--end of Common changes for 1.75.0-->
1415
1416 <sect2 xml:id="rn_V1.75.0_FO">
1417 <title>FO</title>
1418 <para>The following changes have been made to the
1419             <filename>fo</filename> code
1420             since the 1.74.3 release.</para>
1421 <itemizedlist>
1422 <listitem>
1423 <para><literal>Jirka Kosek: highlight.xsl</literal></para><screen><phrase role="commit-message">Inclusion of highlighting code was simplified. Only one import is now necessary.</phrase></screen>
1424 </listitem>
1425 <listitem>
1426 <para><literal>Robert Stayton: fop1.xsl</literal></para><screen><phrase role="commit-message">Add the new fop extensions namespace declaration, in case FOP
1427 extension functions are used.</phrase></screen>
1428 </listitem>
1429 <listitem>
1430 <para><literal>Robert Stayton: formal.xsl</literal></para><screen><phrase role="commit-message">Add support for pgwide on informal objects.</phrase></screen>
1431 </listitem>
1432 <listitem>
1433 <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Fixed spurious closing <tag>quote</tag> on line 134.</phrase></screen>
1434 </listitem>
1435 <listitem>
1436 <para><literal>Robert Stayton: docbook.xsl; autoidx-kosek.xsl; autoidx.xsl</literal></para><screen><phrase role="commit-message">Convert function-available for node-set() to use
1437 new $exsl.node.set.available param in test.</phrase></screen>
1438 </listitem>
1439 <listitem>
1440 <para><literal>David Cramer: xref.xsl</literal></para><screen><phrase role="commit-message">Suppress extra space after <tag>xref</tag> when xrefstyle='select: <tag>label</tag> nopage' (#2740472)</phrase></screen>
1441 </listitem>
1442 <listitem>
1443 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Fixed doc bug for row-height.</phrase></screen>
1444 </listitem>
1445 <listitem>
1446 <para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Internationalized punctuation in <tag>glosssee</tag> and <tag>glossseealso</tag></phrase></screen>
1447 </listitem>
1448 <listitem>
1449 <para><literal>Robert Stayton: param.xweb; param.ent; htmltbl.xsl; table.xsl</literal></para><screen><phrase role="commit-message">Add support for some format properties on tables using
1450 HTML <tag>table</tag> markup.  These include:
1451   - frame attribute on <tag>table</tag> (or uses $default.table.frame parameter).
1452   - rules attribute on <tag>table</tag> (or uses $default.table.rules parameter).
1453   - align attribute on <tag>td</tag> and <tag>th</tag>
1454   - valign attribute on <tag>td</tag> and <tag>th</tag>
1455   - colspan on <tag>td</tag> and <tag>th</tag>
1456   - rowspan on <tag>td</tag> and <tag>th</tag>
1457   - bgcolor on <tag>td</tag> and <tag>th</tag></phrase></screen>
1458 </listitem>
1459 <listitem>
1460 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support bgcolor in <tag>td</tag> and <tag>th</tag>
1461 elements in HTML <tag>table</tag> markup.</phrase></screen>
1462 </listitem>
1463 <listitem>
1464 <para><literal>Robert Stayton: htmltbl.xsl</literal></para><screen><phrase role="commit-message">Add support for colspan and rowspan and bgcolor in <tag>td</tag> and <tag>th</tag>
1465 elements in HTML <tag>table</tag> markup.</phrase></screen>
1466 </listitem>
1467 <listitem>
1468 <para><literal>Robert Stayton: param.xweb</literal></para><screen><phrase role="commit-message">Fix working of page-master left and right margins.</phrase></screen>
1469 </listitem>
1470 <listitem>
1471 <para><literal>Mauritz Jeanson: param.xweb; param.ent; fop1.xsl</literal></para><screen><phrase role="commit-message">Added a new parameter, <parameter>bookmarks.collapse</parameter>, that controls the initial <tag>state</tag> of the bookmark tree. When the parameter has a non-zero value (the default), only the top-level bookmarks are displayed initially. Otherwise, the whole tree of bookmarks is displayed.  This is implemented for FOP 0.9X. Closes FR #1792326.</phrase></screen>
1472 </listitem>
1473 <listitem>
1474 <para><literal>Robert Stayton: table.xsl; pi.xsl</literal></para><screen><phrase role="commit-message">Add support for dbfo row-height processing instruction, like that in dbhtml.</phrase></screen>
1475 </listitem>
1476 <listitem>
1477 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Add support for dbfo keep-together processing instruction for
1478 entire list instances.</phrase></screen>
1479 </listitem>
1480 <listitem>
1481 <para><literal>Robert Stayton: lists.xsl; block.xsl</literal></para><screen><phrase role="commit-message">Add support fo dbfo keep-together processing instruction to
1482 more blocks like list items and paras.</phrase></screen>
1483 </listitem>
1484 <listitem>
1485 <para><literal>Robert Stayton: lists.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new <parameter>variablelist.term.properties</parameter> to format terms, per request # 1968513.</phrase></screen>
1486 </listitem>
1487 <listitem>
1488 <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">In simple.xlink, rearrange order of processing.</phrase></screen>
1489 </listitem>
1490 <listitem>
1491 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Handle <tag>firstterm</tag> like <tag>glossterm</tag> in mode="xref-to".</phrase></screen>
1492 </listitem>
1493 <listitem>
1494 <para><literal>Robert Stayton: glossary.xsl; xref.xsl; pi.xsl; footnote.xsl</literal></para><screen><phrase role="commit-message">Implement simple.xlink for <tag>glosssee</tag> and <tag>glossseealso</tag> so they can use
1495 other types of linking besides otherterm.</phrase></screen>
1496 </listitem>
1497 <listitem>
1498 <para><literal>Robert Stayton: qandaset.xsl</literal></para><screen><phrase role="commit-message">Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections and numbered questions can be distinguished.  Satisfies Feature Request #1539045.</phrase></screen>
1499 </listitem>
1500 <listitem>
1501 <para><literal>Robert Stayton: titlepage.xsl</literal></para><screen><phrase role="commit-message">For the <tag>book</tag> <tag>title</tag> templates, I changed <tag>info</tag>/<tag>title</tag> to <tag>book</tag>/<tag>info</tag>/<tag>title</tag>
1502 so other element's titles will not be affected.</phrase></screen>
1503 </listitem>
1504 <listitem>
1505 <para><literal>Robert Stayton: xref.xsl; verbatim.xsl</literal></para><screen><phrase role="commit-message">Use param <parameter>exsl.node.set.available</parameter> to test for <tag>function</tag>.</phrase></screen>
1506 </listitem>
1507 <listitem>
1508 <para><literal>Robert Stayton: param.xweb; param.ent; footnote.xsl</literal></para><screen><phrase role="commit-message">Start using new param <parameter>exsl.node.set.available</parameter> to work around Xalan bug.</phrase></screen>
1509 </listitem>
1510 <listitem>
1511 <para><literal>Robert Stayton: titlepage.templates.xml</literal></para><screen><phrase role="commit-message">Add comment on use of t:predicate for <tag>editor</tag> to prevent
1512 extra processing of multiple editors. Fixes bug 2687842.</phrase></screen>
1513 </listitem>
1514 <listitem>
1515 <para><literal>Robert Stayton: xref.xsl; autoidx.xsl</literal></para><screen><phrase role="commit-message">An <tag>indexterm</tag> <tag>primary</tag>, <tag>secondary</tag>, or <tag>tertiary</tag> element with an id or xml:id
1516 now outputs that ID, so that <tag>index</tag> entries can be cross referenced to.</phrase></screen>
1517 </listitem>
1518 <listitem>
1519 <para><literal>Mauritz Jeanson: synop.xsl</literal></para><screen><phrase role="commit-message">Added modeless template for ooclass|oointerface|ooexception.
1520 Closes bug #1623468.</phrase></screen>
1521 </listitem>
1522 <listitem>
1523 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Add template with match on <tag>indexterm</tag> in mode="xref-to" to fix bug 2102592.</phrase></screen>
1524 </listitem>
1525 <listitem>
1526 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Now <tag>xref</tag> to <tag>qandaentry</tag> will use the <tag>label</tag> element in a <tag>question</tag> for
1527 the <tag>link</tag> text if it has one.</phrase></screen>
1528 </listitem>
1529 <listitem>
1530 <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Add id if specified from @id to output for <tag>quote</tag> and <tag>phrase</tag> so
1531 they can be <tag>xref</tag>'ed to.</phrase></screen>
1532 </listitem>
1533 <listitem>
1534 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>xref</tag> to <tag>phrase</tag>, <tag>simpara</tag>, <tag>anchor</tag>, and <tag>quote</tag>.
1535 This assumes the <tag>author</tag> specifies something using xrefstyle since
1536 the elements don't have ordinary <tag>link</tag> text.</phrase></screen>
1537 </listitem>
1538 <listitem>
1539 <para><literal>Robert Stayton: toc.xsl</literal></para><screen><phrase role="commit-message">Fix bug in new <tag>toc</tag> templates.</phrase></screen>
1540 </listitem>
1541 <listitem>
1542 <para><literal>Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl; titlepage.templates⋯</literal></para><screen><phrase role="commit-message">Added code to handle <tag>acknowledgements</tag> in <tag>book</tag> and part. The element is processed
1543 similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
1544 any dedications.</phrase></screen>
1545 </listitem>
1546 <listitem>
1547 <para><literal>Robert Stayton: toc.xsl</literal></para><screen><phrase role="commit-message">Rewrite <tag>toc</tag> templates to support an empty <tag>toc</tag> or populated <tag>toc</tag>
1548 in all permitted contexts.  Same for lot elements.
1549 This fixes bug #1595969 for FO outputs.</phrase></screen>
1550 </listitem>
1551 <listitem>
1552 <para><literal>Robert Stayton: index.xsl</literal></para><screen><phrase role="commit-message">Fix indents for <tag>seealsoie</tag> so they are consistent.</phrase></screen>
1553 </listitem>
1554 <listitem>
1555 <para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Removed duplicate (<parameter>monospace.font.family</parameter>).</phrase></screen>
1556 </listitem>
1557 <listitem>
1558 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add <parameter>glossentry.list.item.properties</parameter>.</phrase></screen>
1559 </listitem>
1560 <listitem>
1561 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add <parameter>monospace.verbatim.font.width</parameter> param to support @width on <tag>programlisting</tag>.</phrase></screen>
1562 </listitem>
1563 <listitem>
1564 <para><literal>Robert Stayton: verbatim.xsl</literal></para><screen><phrase role="commit-message">Put <tag>programlisting</tag> in fo:block-container with writing-mode="lr-tb"
1565 when text direction is right to left because all program languages
1566 are left-to-right.</phrase></screen>
1567 </listitem>
1568 <listitem>
1569 <para><literal>Robert Stayton: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add support for @width on <tag>screen</tag> and <tag>programlisting</tag>, fixes bug #2012736.</phrase></screen>
1570 </listitem>
1571 <listitem>
1572 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1973585 <tag>xref</tag> to <tag>para</tag> with xrefstyle not handled correctly.</phrase></screen>
1573 </listitem>
1574 <listitem>
1575 <para><literal>Mauritz Jeanson: block.xsl</literal></para><screen><phrase role="commit-message">Added support for <tag>acknowledgements</tag> in <tag>article</tag>.
1576 Support in <tag>book</tag>/part remains to be added.</phrase></screen>
1577 </listitem>
1578 <listitem>
1579 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787167 incorrect hot text for some olinks.</phrase></screen>
1580 </listitem>
1581 <listitem>
1582 <para><literal>Robert Stayton: fo.xsl</literal></para><screen><phrase role="commit-message">Add writing-mode="tb-rl" as well since some XSL-FO processors support it.</phrase></screen>
1583 </listitem>
1584 <listitem>
1585 <para><literal>Robert Stayton: autotoc.xsl; lists.xsl; glossary.xsl; fo.xsl; table.xsl; pagesetup.xsl</literal></para><screen><phrase role="commit-message">Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.
1586 Changed instances of margin-left to margin-{$direction.align.start}
1587 and margin-right to margin-{$direction.align.end}. Those direction.align
1588 params are computed from the writing mode value in each locale's
1589 gentext key named 'writing-mode', introduced in 1.74.3 to add
1590 right-to-left support to HTML outputs.</phrase></screen>
1591 </listitem>
1592 <listitem>
1593 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add attribute-sets for formatting <tag>glossary</tag> terms and defs.</phrase></screen>
1594 </listitem>
1595 <listitem>
1596 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add <parameter>writing.mode</parameter> param for FO output.</phrase></screen>
1597 </listitem>
1598 <listitem>
1599 <para><literal>Robert Stayton: autotoc.xsl</literal></para><screen><phrase role="commit-message">Fix bug 1546008: in <tag>qandaentry</tag> in a <tag>TOC</tag>, use its blockinfo/<tag>titleabbrev</tag> or blockinfo/<tag>title</tag>
1600 instead of <tag>question</tag>, if available. For DocBook 5, use the <tag>info</tag> versions.</phrase></screen>
1601 </listitem>
1602 <listitem>
1603 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add better pointer to README for XSLTHL</phrase></screen>
1604 </listitem>
1605 <listitem>
1606 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">More tweaking the way that XSLTHL does or does not get called</phrase></screen>
1607 </listitem>
1608 <listitem>
1609 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
1610 </listitem>
1611 </itemizedlist>
1612 </sect2><!--end of FO changes for 1.75.0-->
1613
1614 <sect2 xml:id="rn_V1.75.0_HTML">
1615 <title>HTML</title>
1616 <para>The following changes have been made to the
1617             <filename>html</filename> code
1618             since the 1.74.3 release.</para>
1619 <itemizedlist>
1620 <listitem>
1621 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Removed redundant lang and <tag>title</tag> attributes on list element inside
1622 div element for lists.</phrase></screen>
1623 </listitem>
1624 <listitem>
1625 <para><literal>Robert Stayton: inline.xsl; titlepage.xsl; division.xsl; toc.xsl; sections.xsl; table.xsl;⋯</literal></para><screen><phrase role="commit-message">Convert all calls to class.attribute to calls to common.html.attributes
1626 to support dir, lang, and <tag>title</tag> attributes in html output for all elements.
1627 Fulfills feature request #1993833.</phrase></screen>
1628 </listitem>
1629 <listitem>
1630 <para><literal>Robert Stayton: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Fix bug #2750253 wrong links in list of figures in chunk.html
1631 when target html is in a subdirectory and dbhtml <tag>filename</tag> used.</phrase></screen>
1632 </listitem>
1633 <listitem>
1634 <para><literal>Jirka Kosek: highlight.xsl</literal></para><screen><phrase role="commit-message">Inclusion of highlighting code was simplified. Only one import is now necessary.</phrase></screen>
1635 </listitem>
1636 <listitem>
1637 <para><literal>Robert Stayton: chunk-common.xsl; chunktoc.xsl; docbook.xsl; chunk-changebars.xsl; autoidx⋯</literal></para><screen><phrase role="commit-message">Convert function-available for node-set() to use
1638 new $exsl.node.set.available param in test.</phrase></screen>
1639 </listitem>
1640 <listitem>
1641 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Fixed doc bug for row-height.</phrase></screen>
1642 </listitem>
1643 <listitem>
1644 <para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Internationalized punctuation in <tag>glosssee</tag> and <tag>glossseealso</tag></phrase></screen>
1645 </listitem>
1646 <listitem>
1647 <para><literal>Robert Stayton: lists.xsl; html.xsl; block.xsl</literal></para><screen><phrase role="commit-message">More elements get common.html.attributes.
1648 Added locale.html.attributes template which does the lang,
1649 dir, and <tag>title</tag> attributes, but not the class attribute
1650 (used on <tag>para</tag>, for example).</phrase></screen>
1651 </listitem>
1652 <listitem>
1653 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Replace more <tag>literal</tag> class atts with mode="class.attribute" to support
1654 easier customization.</phrase></screen>
1655 </listitem>
1656 <listitem>
1657 <para><literal>Robert Stayton: glossary.xsl</literal></para><screen><phrase role="commit-message">Support olinking in <tag>glosssee</tag> and <tag>glossseealso</tag>.</phrase></screen>
1658 </listitem>
1659 <listitem>
1660 <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">In simple.xlink, rearrange order of processing.</phrase></screen>
1661 </listitem>
1662 <listitem>
1663 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Handle <tag>firstterm</tag> like <tag>glossterm</tag> in mode="xref-to".</phrase></screen>
1664 </listitem>
1665 <listitem>
1666 <para><literal>Robert Stayton: lists.xsl; html.xsl; block.xsl</literal></para><screen><phrase role="commit-message">Added template named common.html.attributes to output
1667 class, <tag>title</tag>, lang, and dir for most elements.
1668 Started adding it to some list and block elements.</phrase></screen>
1669 </listitem>
1670 <listitem>
1671 <para><literal>Robert Stayton: qandaset.xsl</literal></para><screen><phrase role="commit-message">Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections
1672 and numbered questions can be distinguished.  Satisfies
1673 Feature Request #1539045.</phrase></screen>
1674 </listitem>
1675 <listitem>
1676 <para><literal>Robert Stayton: param.xweb; chunk-code.xsl; param.ent; xref.xsl; chunkfast.xsl; verbatim.x⋯</literal></para><screen><phrase role="commit-message">Use new param <parameter>exsl.node.set.available</parameter> to test, handles Xalan bug.</phrase></screen>
1677 </listitem>
1678 <listitem>
1679 <para><literal>Robert Stayton: autoidx.xsl</literal></para><screen><phrase role="commit-message">Use named anchors for <tag>primary</tag>, <tag>secondary</tag>, and <tag>tertiary</tag> ids so
1680 duplicate entries with different ids can still have an id output.</phrase></screen>
1681 </listitem>
1682 <listitem>
1683 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new param <parameter>index.links.to.section</parameter>.</phrase></screen>
1684 </listitem>
1685 <listitem>
1686 <para><literal>Robert Stayton: xref.xsl; autoidx.xsl</literal></para><screen><phrase role="commit-message">Pass through an id on <tag>primary</tag>, <tag>secondary</tag>, or <tag>tertiary</tag> to 
1687 the <tag>index</tag> <tag>entry</tag>, so that one could <tag>link</tag> to an <tag>index</tag> <tag>entry</tag>.
1688 You can't <tag>link</tag> to the id on an <tag>indexterm</tag> because that is
1689 used to place the main <tag>anchor</tag> in the text flow.</phrase></screen>
1690 </listitem>
1691 <listitem>
1692 <para><literal>Robert Stayton: autoidx.xsl</literal></para><screen><phrase role="commit-message">Add support for the new <parameter>index.links.to.section</parameter> param which permits
1693 precise links to indexterms in HTML output rather than to
1694 the <tag>section</tag> <tag>title</tag>.</phrase></screen>
1695 </listitem>
1696 <listitem>
1697 <para><literal>Mauritz Jeanson: synop.xsl</literal></para><screen><phrase role="commit-message">Added modeless template for ooclass|oointerface|ooexception.
1698 Closes bug #1623468.</phrase></screen>
1699 </listitem>
1700 <listitem>
1701 <para><literal>Robert Stayton: qandaset.xsl</literal></para><screen><phrase role="commit-message">Make sure a <tag>qandaset</tag> has an <tag>anchor</tag>, even when it has no <tag>title</tag>, 
1702 because it may be referenced in a <tag>TOC</tag> or <tag>xref</tag>.
1703 Before, the <tag>anchor</tag> was output by the <tag>title</tag>, but there was no
1704 <tag>anchor</tag> if there was no <tag>title</tag>.</phrase></screen>
1705 </listitem>
1706 <listitem>
1707 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Add a template for <tag>indexterm</tag> with mode="xref-to" to fix bug 2102592.</phrase></screen>
1708 </listitem>
1709 <listitem>
1710 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Now <tag>xref</tag> to <tag>qandaentry</tag> will use the <tag>label</tag> element in a <tag>question</tag> for
1711 the <tag>link</tag> text if it has one.</phrase></screen>
1712 </listitem>
1713 <listitem>
1714 <para><literal>Robert Stayton: qandaset.xsl; html.xsl</literal></para><screen><phrase role="commit-message">Create separate templates for computing <tag>label</tag> of <tag>question</tag> and <tag>answer</tag>
1715 in a <tag>qandaentry</tag>, so such can be used for the <tag>alt</tag> text of an <tag>xref</tag>
1716 to a <tag>qandaentry</tag>.</phrase></screen>
1717 </listitem>
1718 <listitem>
1719 <para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Now support <tag>xref</tag> to <tag>phrase</tag>, <tag>simpara</tag>, <tag>anchor</tag>, and <tag>quote</tag>,
1720 most useful when an xrefstyle is used.</phrase></screen>
1721 </listitem>
1722 <listitem>
1723 <para><literal>Robert Stayton: toc.xsl</literal></para><screen><phrase role="commit-message">Rewrite <tag>toc</tag> templates to support an empty <tag>toc</tag> or populated <tag>toc</tag>
1724 in all permitted contexts.  Same for lot elements.
1725 This fixes bug #1595969 for HTML outputs.</phrase></screen>
1726 </listitem>
1727 <listitem>
1728 <para><literal>Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl; titlepage.templates⋯</literal></para><screen><phrase role="commit-message">Added code to handle <tag>acknowledgements</tag> in <tag>book</tag> and part. The element is processed
1729 similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
1730 any dedications.</phrase></screen>
1731 </listitem>
1732 <listitem>
1733 <para><literal>Robert Stayton: index.xsl</literal></para><screen><phrase role="commit-message">Rewrote <tag>primaryie</tag>, <tag>secondaryie</tag> and <tag>tertiaryie</tag> templates to handle
1734 nesting of elements and <tag>seeie</tag> and <tag>seealsoie</tag>, as reported in
1735 bug # 1168912.</phrase></screen>
1736 </listitem>
1737 <listitem>
1738 <para><literal>Robert Stayton: autotoc.xsl</literal></para><screen><phrase role="commit-message">Fix <tag>simplesect</tag> in <tag>toc</tag> problem.</phrase></screen>
1739 </listitem>
1740 <listitem>
1741 <para><literal>Robert Stayton: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add support for @width per bug report #2012736.</phrase></screen>
1742 </listitem>
1743 <listitem>
1744 <para><literal>Robert Stayton: formal.xsl; htmltbl.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787140 HTML tables not handling attributes correctly.</phrase></screen>
1745 </listitem>
1746 <listitem>
1747 <para><literal>Robert Stayton: param.xweb</literal></para><screen><phrase role="commit-message">Move writing-mode param.</phrase></screen>
1748 </listitem>
1749 <listitem>
1750 <para><literal>Keith Fahlgren: refentry.xsl</literal></para><screen><phrase role="commit-message">Remove a nesting of &lt;p&gt; inside &lt;p&gt; for <tag>refclass</tag> (made XHTML* invalid, made HTML silly)</phrase></screen>
1751 </listitem>
1752 <listitem>
1753 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1945872 to allow passthrough of colwidth values to
1754 HTML <tag>table</tag> when no <parameter>tablecolumns.extension</parameter> is available and
1755 when no instance of * appears in the <tag>table</tag>'s colspecs.</phrase></screen>
1756 </listitem>
1757 <listitem>
1758 <para><literal>Mauritz Jeanson: block.xsl</literal></para><screen><phrase role="commit-message">Added support for <tag>acknowledgements</tag> in <tag>article</tag>.
1759 Support in <tag>book</tag>/part remains to be added.</phrase></screen>
1760 </listitem>
1761 <listitem>
1762 <para><literal>Robert Stayton: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787167 incorrect hot text for some olinks.</phrase></screen>
1763 </listitem>
1764 <listitem>
1765 <para><literal>Robert Stayton: qandaset.xsl</literal></para><screen><phrase role="commit-message">Fix bug 1546008: in <tag>qandaentry</tag> in a <tag>TOC</tag>, use its blockinfo/<tag>titleabbrev</tag> or blockinfo/<tag>title</tag>
1766 instead of <tag>question</tag>, if available. For DocBook 5, use the <tag>info</tag> versions.</phrase></screen>
1767 </listitem>
1768 <listitem>
1769 <para><literal>Robert Stayton: chunktoc.xsl</literal></para><screen><phrase role="commit-message">Add support for generating <tag>olink</tag> <tag>database</tag> when using chunktoc.xsl.</phrase></screen>
1770 </listitem>
1771 <listitem>
1772 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add better pointer to README for XSLTHL</phrase></screen>
1773 </listitem>
1774 <listitem>
1775 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Another stab at fixing the stupid XSLTHT includes across processors (Saxon regression reported by Sorin Ristache)</phrase></screen>
1776 </listitem>
1777 <listitem>
1778 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">More tweaking the way that XSLTHL does or does not get called</phrase></screen>
1779 </listitem>
1780 <listitem>
1781 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
1782 </listitem>
1783 </itemizedlist>
1784 </sect2><!--end of HTML changes for 1.75.0-->
1785
1786 <sect2 xml:id="rn_V1.75.0_Manpages">
1787 <title>Manpages</title>
1788 <para>The following changes have been made to the
1789             <filename>manpages</filename> code
1790             since the 1.74.3 release.</para>
1791 <itemizedlist>
1792 <listitem>
1793 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Convert function-available test for node-set() <tag>function</tag> to
1794 test of $exsl.node.set.available param.</phrase></screen>
1795 </listitem>
1796 <listitem>
1797 <para><literal>Mauritz Jeanson: lists.xsl</literal></para><screen><phrase role="commit-message">Added a template for <tag>bibliolist</tag>. Closes bug #1815916.</phrase></screen>
1798 </listitem>
1799 </itemizedlist>
1800 </sect2><!--end of Manpages changes for 1.75.0-->
1801
1802 <sect2 xml:id="rn_V1.75.0_Epub">
1803 <title>ePub</title>
1804 <para>The following changes have been made to the
1805             <filename>epub</filename> code
1806             since the 1.74.3 release.</para>
1807 <itemizedlist>
1808 <listitem>
1809 <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/onegraphic.xinclude.xml;⋯</literal></para><screen><phrase role="commit-message">Slightly more nuanced handling of <tag>imageobject</tag> alternatives and better support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442 reported by Raphael Hertzog.</phrase></screen>
1810 </listitem>
1811 <listitem>
1812 <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Add a colon after an <tag>abstract</tag>/<tag>title</tag> when mapping into the dc:description for OPF metadata in ePub output to help the flat text have more pseudo-semantics (sugestions from Michael Wiedmann)</phrase></screen>
1813 </listitem>
1814 <listitem>
1815 <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/files/de.xml</literal></para><screen><phrase role="commit-message">Correctly set dc:language in OPF metadata when i18nizing. Closes Bug #2755150</phrase></screen>
1816 </listitem>
1817 <listitem>
1818 <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl</literal></para><screen><phrase role="commit-message">Corrected namespace declarations for <tag>literal</tag> XHTML elements to make them serialize "normally"</phrase></screen>
1819 </listitem>
1820 <listitem>
1821 <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Be a little bit more nuanced about dates</phrase></screen>
1822 </listitem>
1823 <listitem>
1824 <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x⋯</literal></para><screen><phrase role="commit-message">Add DocBook <tag>subjectset</tag> -&gt; OPF dc:<tag>subject</tag> mapping and tests</phrase></screen>
1825 </listitem>
1826 <listitem>
1827 <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x⋯</literal></para><screen><phrase role="commit-message">Add DocBook <tag>date</tag> -&gt; OPF dc:date mapping and tests</phrase></screen>
1828 </listitem>
1829 <listitem>
1830 <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x⋯</literal></para><screen><phrase role="commit-message">Add DocBook <tag>abstract</tag> -&gt; OPF dc:description mapping and tests</phrase></screen>
1831 </listitem>
1832 <listitem>
1833 <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Check in patch submitted by user to add opf:file-as attribute
1834 to dc:creator element.</phrase></screen>
1835 </listitem>
1836 <listitem>
1837 <para><literal>Keith Fahlgren: bin/dbtoepub</literal></para><screen><phrase role="commit-message">Adding --output option to dbtoepub based on user request</phrase></screen>
1838 </listitem>
1839 <listitem>
1840 <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb</literal></para><screen><phrase role="commit-message">Cleaning and regularizing the generation of namespaced nodes for OPF, NCX, XHTML and other outputted filetypes (hat <tag>tip</tag> to bobstayton for pointing out the silly, incorrect code)</phrase></screen>
1841 </listitem>
1842 <listitem>
1843 <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/refclass.xml</literal></para><screen><phrase role="commit-message">Remove a nesting of &lt;p&gt; inside &lt;p&gt; for <tag>refclass</tag> (made XHTML* invalid, made HTML silly)</phrase></screen>
1844 </listitem>
1845 <listitem>
1846 <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/blockquotepre.xml</literal></para><screen><phrase role="commit-message">Added regression test and fix for XHTML validation problem with &lt;a&gt;s added inside &lt;<tag>blockquote</tag>&gt;; This potentially causes another problem (where something is referenced by has no <tag>anchor</tag>, but someone reporting that should cause the whole &lt;a id='thing'/&gt; thing to be reconsidered with modern browsers in mind.</phrase></screen>
1847 </listitem>
1848 </itemizedlist>
1849 </sect2><!--end of Epub changes for 1.75.0-->
1850
1851 <sect2 xml:id="rn_V1.75.0_HTMLHelp">
1852 <title>HTMLHelp</title>
1853 <para>The following changes have been made to the
1854             <filename>htmlhelp</filename> code
1855             since the 1.74.3 release.</para>
1856 <itemizedlist>
1857 <listitem>
1858 <para><literal>Robert Stayton: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Add support for generating <tag>olink</tag> target <tag>database</tag> for htmlhelp files.</phrase></screen>
1859 </listitem>
1860 </itemizedlist>
1861 </sect2><!--end of HTMLHelp changes for 1.75.0-->
1862
1863
1864 <sect2 xml:id="rn_V1.75.0_Params">
1865 <title>Params</title>
1866 <para>The following changes have been made to the
1867             <filename>params</filename> code
1868             since the 1.74.3 release.</para>
1869 <itemizedlist>
1870 <listitem>
1871 <para><literal>Robert Stayton: default.table.rules.xml</literal></para><screen><phrase role="commit-message">Add default setting for @rules attribute on HTML markup tables.</phrase></screen>
1872 </listitem>
1873 <listitem>
1874 <para><literal>Mauritz Jeanson: bookmarks.collapse.xml</literal></para><screen><phrase role="commit-message">Added a new parameter, <parameter>bookmarks.collapse</parameter>, that controls the initial <tag>state</tag> 
1875 of the bookmark tree. When the parameter has a non-zero value (the default), 
1876 only the top-level bookmarks are displayed initially. Otherwise, the whole 
1877 tree of bookmarks is displayed. 
1878
1879 This is implemented for FOP 0.9X. Closes FR #1792326.</phrase></screen>
1880 </listitem>
1881 <listitem>
1882 <para><literal>Robert Stayton: variablelist.term.properties.xml</literal></para><screen><phrase role="commit-message">Add new <parameter>variablelist.term.properties</parameter> to format terms, per 
1883 request # 1968513.</phrase></screen>
1884 </listitem>
1885 <listitem>
1886 <para><literal>Robert Stayton: qanda.defaultlabel.xml</literal></para><screen><phrase role="commit-message">Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections
1887 and numbered questions can be distinguished.  Satisfies
1888 Feature Request #1539045.</phrase></screen>
1889 </listitem>
1890 <listitem>
1891 <para><literal>Robert Stayton: index.links.to.section.xml</literal></para><screen><phrase role="commit-message">Change default to 1 to match past behavior.</phrase></screen>
1892 </listitem>
1893 <listitem>
1894 <para><literal>Robert Stayton: exsl.node.set.available.xml</literal></para><screen><phrase role="commit-message">Isolate this text for Xalan bug regarding exsl:node-set available.
1895 If it is ever fixed in Xalan, just fix it here.</phrase></screen>
1896 </listitem>
1897 <listitem>
1898 <para><literal>Robert Stayton: index.links.to.section.xml</literal></para><screen><phrase role="commit-message">Add param to control whether an <tag>index</tag> <tag>entry</tag> links to
1899 a <tag>section</tag> <tag>title</tag> or to the precise location of the
1900 <tag>indexterm</tag>.</phrase></screen>
1901 </listitem>
1902 <listitem>
1903 <para><literal>Robert Stayton: glossentry.list.item.properties.xml</literal></para><screen><phrase role="commit-message">New attribute list for <tag>glossentry</tag> in <tag>glossary</tag>.</phrase></screen>
1904 </listitem>
1905 <listitem>
1906 <para><literal>Robert Stayton: monospace.verbatim.font.width.xml</literal></para><screen><phrase role="commit-message">New parameter to support @width on <tag>programlisting</tag> and <tag>screen</tag>.</phrase></screen>
1907 </listitem>
1908 <listitem>
1909 <para><literal>Mauritz Jeanson: highlight.source.xml</literal></para><screen><phrase role="commit-message">Updated and reorganized the description.</phrase></screen>
1910 </listitem>
1911 <listitem>
1912 <para><literal>Robert Stayton: page.margin.outer.xml; page.margin.inner.xml</literal></para><screen><phrase role="commit-message">Add caveat about XEP bug when writing-mode is right-to-left.</phrase></screen>
1913 </listitem>
1914 <listitem>
1915 <para><literal>Robert Stayton: article.appendix.title.properties.xml; writing.mode.xml; body.start.indent⋯</literal></para><screen><phrase role="commit-message">Change 'left' to 'start' and 'right' to 'end' to support right-to-left
1916 writing mode.</phrase></screen>
1917 </listitem>
1918 <listitem>
1919 <para><literal>Robert Stayton: glossdef.block.properties.xml; glossdef.list.properties.xml; glossterm.blo⋯</literal></para><screen><phrase role="commit-message">Add attribute-sets for formatting <tag>glossary</tag> terms and defs.</phrase></screen>
1920 </listitem>
1921 <listitem>
1922 <para><literal>Robert Stayton: glossterm.separation.xml</literal></para><screen><phrase role="commit-message">Clarify the description.</phrase></screen>
1923 </listitem>
1924 <listitem>
1925 <para><literal>Robert Stayton: make.year.ranges.xml</literal></para><screen><phrase role="commit-message">Now handles <tag>year</tag> element containing a comma or dash without error.</phrase></screen>
1926 </listitem>
1927 </itemizedlist>
1928 </sect2><!--end of Params changes for 1.75.0-->
1929
1930 <sect2 xml:id="rn_V1.75.0_Highlighting">
1931 <title>Highlighting</title>
1932 <para>The following changes have been made to the
1933             <filename>highlighting</filename> code
1934             since the 1.74.3 release.</para>
1935 <itemizedlist>
1936 <listitem>
1937 <para><literal>Jirka Kosek: README</literal></para><screen><phrase role="commit-message">Inclusion of highlighting code was simplified. Only one import is now necessary.</phrase></screen>
1938 </listitem>
1939 <listitem>
1940 <para><literal>Keith Fahlgren: README</literal></para><screen><phrase role="commit-message">Adding XSLTHL readme</phrase></screen>
1941 </listitem>
1942 <listitem>
1943 <para><literal>Keith Fahlgren: common.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
1944 </listitem>
1945 </itemizedlist>
1946 </sect2><!--end of Highlighting changes for 1.75.0-->
1947
1948 <sect2 xml:id="rn_V1.75.0_XSL-Saxon">
1949 <title>XSL-Saxon</title>
1950 <para>The following changes have been made to the
1951             <filename>xsl-saxon</filename> code
1952             since the 1.74.3 release.</para>
1953 <itemizedlist>
1954 <listitem>
1955 <para><literal>Mauritz Jeanson: src/com/nwalsh/saxon/Text.java</literal></para><screen><phrase role="commit-message">Added a fix that prevents output of extra blank line.
1956 Hopefully this closes bug #894805.</phrase></screen>
1957 </listitem>
1958 </itemizedlist>
1959 </sect2><!--end of XSL-Saxon changes for 1.75.0-->
1960
1961 <sect2 xml:id="rn_V1.75.0_XSL-Xalan">
1962 <title>XSL-Xalan</title>
1963 <para>The following changes have been made to the
1964             <filename>xsl-xalan</filename> code
1965             since the 1.74.3 release.</para>
1966 <itemizedlist>
1967 <listitem>
1968 <para><literal>Mauritz Jeanson: src/com/nwalsh/xalan/Text.java</literal></para><screen><phrase role="commit-message">Added a fix that prevents output of extra blank line.
1969 Hopefully this closes bug #894805.</phrase></screen>
1970 </listitem>
1971 </itemizedlist>
1972 </sect2><!--end of XSL-Xalan changes for 1.75.0-->
1973
1974
1975 </sect1>
1976
1977 <sect1 xml:id="V1.74.3">
1978 <title>Release Notes: 1.74.3</title>
1979 <para>This release fixes some bugs in the 1.74.2 release.</para>
1980 <para>See <filename>highlighting/README</filename> for XSLTHL usage instructions.</para>
1981 </sect1>
1982 <sect1 xml:id="V1.74.2">
1983 <title>Release Notes: 1.74.2</title>
1984 <para>This release fixes some bugs in the 1.74.1 release.</para>
1985 </sect1>
1986
1987 <sect1 xml:id="V1.74.1">
1988 <title>Release Notes: 1.74.1</title>
1989 <para>This release includes important bug fixes and adds the following
1990 significant feature changes:
1991 <variablelist>
1992 <varlistentry>
1993 <term>Gentext</term>
1994 <listitem><para>Kirghiz locale added and Chinese translations have been simplified.</para></listitem>
1995 <listitem><para>Somme support for gentext and right-to-left languages has been added.</para></listitem>
1996 </varlistentry>
1997 <varlistentry>
1998 <term>FO</term>
1999 <listitem><para>Various bugs have been resolved. </para> </listitem>
2000 <listitem><para>Support for a new processing instruction: <markup>dbfo funcsynopsis-style</markup> has been added.  </para> </listitem>
2001 <listitem><para>Added new param <parameter>email.mailto.enabled</parameter> for FO output. Patch from Paolo Borelli.  </para>
2002 </listitem>
2003 <listitem><para>Support for documented metadata in fop1 mode has been added. </para>
2004 </listitem>
2005
2006 </varlistentry>
2007 <varlistentry>
2008 <term>Highlighting</term>
2009 <listitem><para>Support for the latest version of XSLTHL 2.0 and some new language syntaxes have been added to a variety of outputs.</para></listitem>
2010
2011 </varlistentry>
2012
2013 <varlistentry>
2014 <term>Manpages</term>
2015 <listitem><para>Added man.output.better.ps.enabled param (zero default). It non-zero, no such
2016 markup is embedded in generated man pages, and no enhancements are
2017 included in the PostScript output generated from those man pages
2018 by the man -Tps <tag>command</tag>.</para></listitem>
2019
2020 </varlistentry>
2021
2022
2023 <varlistentry>
2024 <term>HTML</term>
2025 <listitem><para>Support for <parameter>writing.mode</parameter> to set text direction and <parameter>alignment</parameter> based on document locale has been added.</para></listitem>
2026 <listitem>
2027 <para>Added a new top-level stylesheet module, chunk-changebars.xsl, to be 
2028 used for generating chunked output with highlighting based on change 
2029 (@revisionflag) markup. The module imports/includes the standard chunking 
2030 and changebars templates and contains additional logic for chunked output.
2031 See FRs #1015180 and #1819915.</para>
2032 </listitem>
2033
2034 </varlistentry>
2035 <varlistentry>
2036 <term>ePub</term>
2037 <listitem>
2038 <para>Covers now look better in Adobe Digital Editions thanks to a patch from Paul Norton of Adobe</para>
2039 </listitem>
2040 <listitem><para>Cover handling now more generic (including limited DocBook 5.0 <markup>cover</markup> support thanks to patch contributed by Liza Daly.</para> </listitem>
2041 <listitem><para>Cover markup now carries more reliably into files destined for .mobi and the Kindle.</para> </listitem>
2042 <listitem><para><markup>dc:identifiers</markup> are now generated from more types of numbering schemes. </para></listitem>
2043 <listitem><para>Both SEO and semantic structure of chunked ePub output by ensuring that we always send out one and only one h1 in each XHTML chunk.</para></listitem>
2044 <listitem>
2045 <para>Primitive support for embedding a single font added.</para>
2046 </listitem>
2047 <listitem>
2048 <para>Support for embedding a CSS customizations added.</para>
2049 </listitem>
2050
2051 </varlistentry>
2052
2053 <varlistentry>
2054 <term>Roundtrip</term>
2055
2056 <listitem>
2057 <para>Support for imagedata-metadata and <tag>table</tag> as images added.</para>
2058 </listitem>
2059 <listitem>
2060 <para>Support for imagedata-metadata and <tag>legalnotice</tag> as images added.</para>
2061 </listitem>
2062 </varlistentry>
2063
2064 <varlistentry>
2065 <term>Params</term>
2066 <listitem><para><parameter>man.output.better.ps.enabled</parameter> added for Manpages output </para></listitem>
2067 <listitem>
2068 <para><parameter>writing.mode.xml</parameter> added to set text direction.</para>
2069 </listitem>
2070 <listitem>
2071 <para>Added new param <parameter>email.mailto.enabled</parameter> for FO output.
2072 Patch from Paolo Borelli. Closes #2086321.</para>
2073 </listitem>
2074 <listitem>
2075 <para><parameter>highlight.source</parameter> upgraded to support the latest version of XSLTHL 2.0.</para>
2076 </listitem>
2077
2078 </varlistentry>
2079
2080
2081
2082 </variablelist>
2083 </para>
2084 <para>The following is a list of changes that have been made since the 1.74.0 release.</para>
2085
2086
2087 <sect2 xml:id="summary_V1.74.1_Gentext">
2088 <title>Gentext</title>
2089 <para>The following changes have been made to the <filename>gentext</filename> code since the 1.74.0 release.</para>
2090 <itemizedlist>
2091 <listitem>
2092 <para><literal>Michael(tm) Smith: locale/ky.xml; Makefile</literal></para><screen><phrase role="commit-message">new Kirghiz locale from Ilyas Bakirov</phrase></screen>
2093 </listitem>
2094 <listitem>
2095 <para><literal>Mauritz Jeanson: locale/en.xml</literal></para><screen><phrase role="commit-message">Added "<tag>Acknowledgements</tag>".</phrase></screen>
2096 </listitem>
2097 <listitem>
2098 <para><literal>Dongsheng Song: locale/zh_cn.xml</literal></para><screen><phrase role="commit-message">Simplified Chinese translation.</phrase></screen>
2099 </listitem>
2100 <listitem>
2101 <para><literal>Robert Stayton: locale/lv.xml; locale/ca.xml; locale/pt.xml; locale/tr.xml; locale/af.xml;⋯</literal></para><screen><phrase role="commit-message">Add writing-mode gentext string to support right-to-left languages.</phrase></screen>
2102 </listitem>
2103 </itemizedlist>
2104 </sect2><!--end of Gentext changes for 1.74.1-->
2105
2106 <sect2 xml:id="summary_V1.74.1_FO">
2107 <title>FO</title>
2108 <para>The following changes have been made to the <filename>fo</filename> code since the 1.74.0 release.</para>
2109 <itemizedlist>
2110 <listitem>
2111 <para><literal>David Cramer: footnote.xsl</literal></para><screen><phrase role="commit-message">Added a check to confirm that a <tag>footnoteref</tag>'s linkend points to a <tag>footnote</tag>. Stylesheets stop processing if not and provide a useful error message.</phrase></screen>
2112 </listitem>
2113 <listitem>
2114 <para><literal>Mauritz Jeanson: spaces.xsl</literal></para><screen><phrase role="commit-message">Convert spaces to fo:leader also in elements in the DB 5 namespace.</phrase></screen>
2115 </listitem>
2116 <listitem>
2117 <para><literal>Mauritz Jeanson: pi.xsl; synop.xsl</literal></para><screen><phrase role="commit-message">Added support for a new processing instruction: dbfo funcsynopsis-style. 
2118 Closes bug #1838213.</phrase></screen>
2119 </listitem>
2120 <listitem>
2121 <para><literal>Michael(tm) Smith: inline.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added new param <parameter>email.mailto.enabled</parameter> for FO output.
2122 Patch from Paolo Borelli. Closes #2086321.</phrase></screen>
2123 </listitem>
2124 <listitem>
2125 <para><literal>Mauritz Jeanson: docbook.xsl</literal></para><screen><phrase role="commit-message">Added support for document metadata for fop1 (patch #2067318).</phrase></screen>
2126 </listitem>
2127 <listitem>
2128 <para><literal>Jirka Kosek: param.ent; param.xweb; highlight.xsl</literal></para><screen><phrase role="commit-message">Upgraded to support the latest version of XSLTHL 2.0
2129  -- nested markup in highlited code is now processed
2130  -- it is no longer needed to specify path XSLTHL configuration file using Java property
2131  -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
2132 </listitem>
2133 </itemizedlist>
2134 </sect2><!--end of FO changes for 1.74.1-->
2135
2136 <sect2 xml:id="summary_V1.74.1_HTML">
2137 <title>HTML</title>
2138 <para>The following changes have been made to the <filename>html</filename> code since the 1.74.0 release.</para>
2139 <itemizedlist>
2140 <listitem>
2141 <para><literal>Robert Stayton: param.xweb; docbook.xsl; param.ent; html.xsl</literal></para><screen><phrase role="commit-message">Add support for <parameter>writing.mode</parameter> to set text direction and <parameter>alignment</parameter> based on document locale.</phrase></screen>
2142 </listitem>
2143 <listitem>
2144 <para><literal>Mauritz Jeanson: chunk-changebars.xsl</literal></para><screen><phrase role="commit-message">Added a new top-level stylesheet module, chunk-changebars.xsl, to be 
2145 used for generating chunked output with highlighting based on change 
2146 (@revisionflag) markup. The module imports/includes the standard chunking 
2147 and changebars templates and contains additional logic for chunked output.
2148 See FRs #1015180 and #1819915.</phrase></screen>
2149 </listitem>
2150 </itemizedlist>
2151 </sect2><!--end of HTML changes for 1.74.1-->
2152
2153 <sect2 xml:id="summary_V1.74.1_Manpages">
2154 <title>Manpages</title>
2155 <para>The following changes have been made to the <filename>manpages</filename> code since the 1.74.0 release.</para>
2156 <itemizedlist>
2157 <listitem>
2158 <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">Put the following at the top of generated roff for each page:
2159   \" t
2160 purpose is to explicitly tell AT&amp;T troff that the page needs to be
2161 pre-processed through tbl(1); groff can <tag>figure</tag> it out
2162 automatically, but apparently AT&amp;T troff needs to be explicitly told</phrase></screen>
2163 </listitem>
2164 </itemizedlist>
2165 </sect2><!--end of Manpages changes for 1.74.1-->
2166
2167 <sect2 xml:id="summary_V1.74.1_Epub">
2168 <title>ePub</title>
2169 <para>The following changes have been made to the <filename>epub</filename> code since the 1.74.0 release.</para>
2170 <itemizedlist>
2171 <listitem>
2172 <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Patch from Paul Norton of Adobe to get covers to look better in Adobe Digital Editions</phrase></screen>
2173 </listitem>
2174 <listitem>
2175 <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/v5cover.xml; bin/spec/sp⋯</literal></para><screen><phrase role="commit-message">Patch contributed by Liza Daly to make ePub <tag>cover</tag> handling more generic. Additionally
2176 DocBook 5.0's &lt;<tag>cover</tag>&gt; now has some limited support:
2177
2178 - should <tag>reference</tag> a <tag>cover</tag> in the OPF guide for a DocBook 5.0 test document</phrase></screen>
2179 </listitem>
2180 <listitem>
2181 <para><literal>Keith Fahlgren: bin/spec/files/isbn.xml; bin/spec/files/issn.xml; bin/spec/files/biblioid.⋯</literal></para><screen><phrase role="commit-message">Liza Daly reported that the dc:identifer-generation code was garbage (she was right).
2182
2183 Added new tests:
2184 - should include at least one dc:identifier
2185 - should include an ISBN as URN for dc:identifier if an ISBN was in the metadata
2186 - should include an ISSN as URN for dc:identifier if an ISSN was in the metadata
2187 - should include an <tag>biblioid</tag> as a dc:identifier if an <tag>biblioid</tag> was in the metadata
2188 - should include a URN for a <tag>biblioid</tag> with @class attribute as a dc:identifier if an <tag>biblioid</tag> was in the metadata</phrase></screen>
2189 </listitem>
2190 <listitem>
2191 <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb</literal></para><screen><phrase role="commit-message">Improve both SEO and  semantic structure of chunked ePub output by ensuring that
2192 we always send out one and only one h1 in each XHTML chunk.
2193
2194 DocBook::Epub
2195 - should include one and only one &lt;h1&gt; in each HTML file in rendered ePub files
2196 for &lt;<tag>book</tag>&gt;s
2197 - should include one and only one &lt;h1&gt; in each HTML file in rendered ePub files
2198 for &lt;<tag>book</tag>&gt;s even if they do not have <tag>section</tag> markup</phrase></screen>
2199 </listitem>
2200 <listitem>
2201 <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x⋯</literal></para><screen><phrase role="commit-message">Adding better support for covers in epub files destined for .mobi and the Kindle</phrase></screen>
2202 </listitem>
2203 <listitem>
2204 <para><literal>Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/DejaVuSerif.otf; docbook.⋯</literal></para><screen><phrase role="commit-message">Adding primitive support for embedding a single font</phrase></screen>
2205 </listitem>
2206 <listitem>
2207 <para><literal>Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/test_cust.xsl; bin/spec/e⋯</literal></para><screen><phrase role="commit-message">Adding support for user-specified customization layers in dbtoepub</phrase></screen>
2208 </listitem>
2209 <listitem>
2210 <para><literal>Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/docbook.rb; bin/s⋯</literal></para><screen><phrase role="commit-message">Adding CSS support to .epub target &amp; dbtoepub:
2211     -c, --css [FILE]                 Use FILE for CSS on generated XHTML.
2212
2213
2214 DocBook::Epub
2215 ...
2216 - should include a CSS <tag>link</tag> in HTML files when a CSS file has been provided
2217 - should include CSS file in .epub when a CSS file has been provided
2218 - should include a CSS <tag>link</tag> in OPF file when a CSS file has been provided</phrase></screen>
2219 </listitem>
2220 </itemizedlist>
2221 </sect2><!--end of Epub changes for 1.74.1-->
2222
2223 <sect2 xml:id="summary_V1.74.1_Roundtrip">
2224 <title>Roundtrip</title>
2225 <para>The following changes have been made to the
2226             <filename>roundtrip</filename> code
2227             since the 1.74.0 release.</para>
2228 <itemizedlist>
2229 <listitem>
2230 <para><literal>Steve Ball: blocks2dbk.xsl; template.xml; template.dot</literal></para><screen><phrase role="commit-message">added support for imagedata-metadata
2231 added support for <tag>table</tag> as images</phrase></screen>
2232 </listitem>
2233 <listitem>
2234 <para><literal>Steve Ball: blocks2dbk.xsl; normalise2sections.xsl; sections2blocks.xsl</literal></para><screen><phrase role="commit-message">Improved support for <tag>personname</tag> inlines.</phrase></screen>
2235 </listitem>
2236 <listitem>
2237 <para><literal>Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml</literal></para><screen><phrase role="commit-message">Added support for <tag>legalnotice</tag>.</phrase></screen>
2238 </listitem>
2239 <listitem>
2240 <para><literal>Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl</literal></para><screen><phrase role="commit-message">added support for <tag>orgname</tag> in <tag>author</tag></phrase></screen>
2241 </listitem>
2242 <listitem>
2243 <para><literal>Steve Ball: specifications.xml; supported.xml; blocks2dbk.xsl; wordml2normalise.xsl; dbk2w⋯</literal></para><screen><phrase role="commit-message">Updated specification.
2244 to-DocBook: add cols attribute to <tag>tgroup</tag>
2245 from-DocBook: fix for <tag>blockquote</tag> <tag>title</tag></phrase></screen>
2246 </listitem>
2247 </itemizedlist>
2248 </sect2><!--end of Roundtrip changes for 1.74.1-->
2249
2250 <sect2 xml:id="summary_V1.74.1_Params">
2251 <title>Params</title>
2252 <para>The following changes have been made to the <filename>params</filename> since the 1.74.0 release.</para>
2253 <itemizedlist>
2254 <listitem>
2255 <para>The change was to add man.output.better.ps.enabled parameter, with
2256 its default value set to zero.
2257
2258 If the value of the man.output.better.ps.enabled parameter is
2259 non-zero, certain markup is embedded in each generated man page
2260 such that PostScript output from the man -Tps <tag>command</tag> for that
2261 page will include a number of enhancements designed to improve the
2262 quality of that output.
2263
2264 If man.output.better.ps.enabled is zero (the default), no such
2265 markup is embedded in generated man pages, and no enhancements are
2266 included in the PostScript output generated from those man pages
2267 by the man -Tps <tag>command</tag>.
2268
2269 WARNING: The enhancements provided by this parameter rely on
2270 features that are specific to groff (GNU troff) and that are not
2271 part of "classic" AT&amp;T troff or any of its derivatives. Therefore,
2272 any man pages you generate with this parameter enabled will be
2273 readable only on systems on which the groff (GNU troff) program is
2274 installed, such as GNU/Linux systems.  The pages will not not be
2275 readable on systems on with the classic troff (AT&amp;T troff) <tag>command</tag>
2276 is installed.
2277
2278 NOTE: The value of this parameter only affects PostScript output
2279 generated from the man <tag>command</tag>. It has no effect on output
2280 generated using the FO backend.
2281
2282 <tag>TIP</tag>: You can generate PostScript output for any man page by
2283 running the following <tag>command</tag>:
2284
2285 man FOO -Tps &gt; FOO.ps
2286
2287 You can then generate PDF output by running the following <tag>command</tag>:
2288
2289 ps2pdf FOO.ps</para>
2290 </listitem>
2291 <listitem>
2292 <para><literal>Robert Stayton: writing.mode.xml</literal></para><screen><phrase role="commit-message">writing mode param used to set text direction.</phrase></screen>
2293 </listitem>
2294 <listitem>
2295 <para><literal>Michael(tm) Smith: email.mailto.enabled.xml</literal></para><screen><phrase role="commit-message">Added new param <parameter>email.mailto.enabled</parameter> for FO output.
2296 Patch from Paolo Borelli. Closes #2086321.</phrase></screen>
2297 </listitem>
2298 <listitem>
2299 <para><literal>Jirka Kosek: highlight.source.xml; highlight.xslthl.config.xml</literal></para><screen><phrase role="commit-message">Upgraded to support the latest version of XSLTHL 2.0
2300  -- nested markup in highlited code is now processed
2301  -- it is no longer needed to specify path XSLTHL configuration file using Java property
2302  -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
2303 </listitem>
2304 </itemizedlist>
2305 </sect2><!--end of Params changes for 1.74.1-->
2306
2307 <sect2 xml:id="summary_V1.74.1_Highlighting">
2308 <title>Highlighting</title>
2309 <para>The following changes have been made to the
2310             <filename>highlighting</filename> code
2311             since the 1.74.0 release.</para>
2312 <itemizedlist>
2313 <listitem>
2314 <para><literal>Jirka Kosek: cpp-hl.xml; c-hl.xml; tcl-hl.xml; php-hl.xml; common.xsl; perl-hl.xml; delphi⋯</literal></para><screen><phrase role="commit-message">Upgraded to support the latest version of XSLTHL 2.0
2315  -- nested markup in highlited code is now processed
2316  -- it is no longer needed to specify path XSLTHL configuration file using Java property
2317  -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
2318 </listitem>
2319 </itemizedlist>
2320 </sect2><!--end of Highlighting changes for 1.74.1-->
2321
2322 </sect1>
2323
2324
2325 <sect1 xml:id="V1.74.0">
2326 <title>Release Notes: 1.74.0</title>
2327 <para>This release includes important bug fixes and adds the following
2328 significant feature changes:
2329 <variablelist>
2330 <varlistentry>
2331 <term>.epub target</term>
2332 <listitem><para>Paul Norton (Adobe) and Keith Fahlgren(O'Reilly Media) have donated code that generates <filename>.epub</filename> documents from
2333 DocBook input. An alpha-reference implementation in Ruby has also been provided.</para>
2334 <para>.epub is an open standard of the The International Digital Publishing Forum (IDPF), 
2335 a the trade and standards association for the digital publishing industry. </para> 
2336 <para>Read more about this target in <filename>epub/README</filename>
2337 </para></listitem>
2338 </varlistentry>
2339
2340 <varlistentry>
2341 <term>XHTML 1.1 target</term>
2342 <listitem><para>To support .epub output, a strict XHTML 1.1 target has been added. The stylesheets for this output are
2343 generated and are quite similar to the XHTML target.</para></listitem>
2344 </varlistentry>
2345 <varlistentry>
2346 <term>Gentext updates</term>
2347 <listitem><para>A number of locales have been updated.</para></listitem>
2348 </varlistentry>
2349 <varlistentry>
2350 <term>Roundtrip improvements</term>
2351 <listitem><para>Table, figure, template syncronization, and character style improvements have been made for WordML &amp; Pages. Support added for OpenOffice.org.</para></listitem>
2352
2353 </varlistentry>
2354
2355 <varlistentry>
2356     <term>First implementation of a libxslt extension</term>
2357     <listitem>
2358       <para>A stylesheet extension for libxslt, written in Python, has been added. 
2359       The extension is a function for adjusting column widths in CALS tables. See 
2360       <filename>extensions/README.LIBXSLT</filename> for more information.</para>
2361     </listitem>
2362  </varlistentry>
2363
2364 </variablelist>
2365 </para>
2366 <para>The following is a list of changes that have been made
2367         since the 1.73.2 release.</para>
2368
2369 <sect2 xml:id="V1.74.0_Gentext">
2370 <title>Gentext</title>
2371 <para>The following changes have been made to the
2372             <filename>gentext</filename> code
2373             since the 1.73.2 release.</para>
2374 <itemizedlist>
2375 <listitem>
2376 <para><literal>Michael(tm) Smith: locale/id.xml</literal></para><screen><phrase role="commit-message">Checked in changes to Indonesion locale submitted by Euis Luhuanam a long time ago.</phrase></screen>
2377 </listitem>
2378 <listitem>
2379 <para><literal>Michael(tm) Smith: locale/lt.xml</literal></para><screen><phrase role="commit-message">Added changes to Lithuanian locate submitted a long time back by Nikolajus Krauklis.</phrase></screen>
2380 </listitem>
2381 <listitem>
2382 <para><literal>Michael(tm) Smith: locale/hu.xml</literal></para><screen><phrase role="commit-message">fixed error in lowercase.alpha definition in Hungarian locale</phrase></screen>
2383 </listitem>
2384 <listitem>
2385 <para><literal>Michael(tm) Smith: locale/nb.xml</literal></para><screen><phrase role="commit-message">Corrected language code for nb locale, and restored missing "startquote" key.</phrase></screen>
2386 </listitem>
2387 <listitem>
2388 <para><literal>Michael(tm) Smith: locale/ja.xml</literal></para><screen><phrase role="commit-message">Committed changes to ja locale file, from Akagi Kobayashi. Adds bracket quotes around many xref instances that did not have them
2389 before.</phrase></screen>
2390 </listitem>
2391 <listitem>
2392 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">"no" locale is now "nb"</phrase></screen>
2393 </listitem>
2394 <listitem>
2395 <para><literal>Michael(tm) Smith: locale/nb.xml</literal></para><screen><phrase role="commit-message">Update Norwegian Bokmål translation. Thanks to Hans F. Nordhaug.</phrase></screen>
2396 </listitem>
2397 <listitem>
2398 <para><literal>Michael(tm) Smith: locale/no.xml; locale/nb.xml</literal></para><screen><phrase role="commit-message">per message from Hans F. Nordhaug, correct identifier for
2399 Norwegian Bokmål is "nb" (not "no") and has been for quite some
2400 time now...</phrase></screen>
2401 </listitem>
2402 <listitem>
2403 <para><literal>Michael(tm) Smith: locale/ja.xml</literal></para><screen><phrase role="commit-message">Converted ja.xml source file to use real unicode characters so
2404 that the actual glyphs so up when you edit it in a text editor
2405 (instead of the character references).</phrase></screen>
2406 </listitem>
2407 <listitem>
2408 <para><literal>Michael(tm) Smith: locale/ja.xml</literal></para><screen><phrase role="commit-message">Checked in changes to ja.xml locale file. Thanks to Akagi Kobayashi.</phrase></screen>
2409 </listitem>
2410 <listitem>
2411 <para><literal>Michael(tm) Smith: locale/it.xml</literal></para><screen><phrase role="commit-message">Changes from Federico Zenith</phrase></screen>
2412 </listitem>
2413 <listitem>
2414 <para><literal>Dongsheng Song: locale/zh_cn.xml</literal></para><screen><phrase role="commit-message">Added missing translations.</phrase></screen>
2415 </listitem>
2416 </itemizedlist>
2417 </sect2><!--end of Gentext changes for 1.74.0-->
2418
2419 <sect2 xml:id="V1.74.0_Common">
2420 <title>Common</title>
2421 <para>The following changes have been made to the
2422             <filename>common</filename> code
2423             since the 1.73.2 release.</para>
2424 <itemizedlist>
2425 <listitem>
2426 <para><literal>Michael(tm) Smith: l10n.xsl</literal></para><screen><phrase role="commit-message">Added new template "l10.language.name" for retrieving the
2427 English-language name of the lang setting of the current document.
2428 Closes #1916837. Thanks to Simon Kennedy.</phrase></screen>
2429 </listitem>
2430 <listitem>
2431 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">fixed syntax error</phrase></screen>
2432 </listitem>
2433 <listitem>
2434 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">fixed a couple of typos</phrase></screen>
2435 </listitem>
2436 <listitem>
2437 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">refined handling of cases where refentry "source" or "manual"
2438 metadata is missing or when we use fallback content instead. We
2439 now report a Warning if we use fallback content.</phrase></screen>
2440 </listitem>
2441 <listitem>
2442 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">don't use refmiscinfo@class=date value as fallback for refentry
2443 "source" or "manual" metadata fields</phrase></screen>
2444 </listitem>
2445 <listitem>
2446 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Made reporting of missing refentry metadata more quiet:
2447
2448   - we no longer report anything if usable-but-not-preferred
2449     metadata is found; we just quietly use whatever we manage to
2450     find
2451
2452   - we now only report missing "source" metadata if the refentry
2453     is missing BOTH "source name" and "version" metadata; if it
2454     has one but not the other, we use whichever one it has and
2455     don't report anything as missing
2456
2457 The above changes were made because testing with some "real world"
2458 source reveals that some authors are intentionally choosing to use
2459 "non preferred" markup for some metadata, and also choosing to
2460 omit "source name" or "version" metadata in there DocBook XML. So
2461 it does no good to give them pedantic reminders about what they
2462 already know...
2463
2464 Also, changed code to cause "fixme" text to be inserted in output
2465 in particular cases:
2466
2467   - if we can't manage to find any "source" metadata at all, we
2468     now put fixme text into the output
2469
2470   - if we can't manage to find any "manual" metadata a all, we 
2471     now put fixme text into the output
2472
2473 The "source" and "manual" metadata is necessary information, so
2474 buy putting the fixme stuff in the output, we alert users to the
2475 need problem of it being missing.</phrase></screen>
2476 </listitem>
2477 <listitem>
2478 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">When generating manpages output, we no longer report anything if
2479 the refentry source is missing date or pubdate content. In
2480 practice, many users intentionally omit the date from the source
2481 because they explicitly want it to be generated.</phrase></screen>
2482 </listitem>
2483 <listitem>
2484 <para><literal>Michael(tm) Smith: l10n.xml</literal></para><screen><phrase role="commit-message">further change needed for switch from no locale to nb.</phrase></screen>
2485 </listitem>
2486 <listitem>
2487 <para><literal>Michael(tm) Smith: common.xsl</literal></para><screen><phrase role="commit-message">Added support for orgname in authorgroup. Thanks to Camille
2488 Bégnis.</phrase></screen>
2489 </listitem>
2490 <listitem>
2491 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">"no" locale is now "nb"</phrase></screen>
2492 </listitem>
2493 <listitem>
2494 <para><literal>Mauritz Jeanson: stripns.xsl</literal></para><screen><phrase role="commit-message">Removed the template matching "ng:link|db:link" (in order to make @xlink:show 
2495 work with &lt;link&gt; elements). As far as I can tell, this template is no longer needed.</phrase></screen>
2496 </listitem>
2497 <listitem>
2498 <para><literal>Mauritz Jeanson: entities.ent</literal></para><screen><phrase role="commit-message">Moved declaration of comment.block.parents entity to common/entities.ent.</phrase></screen>
2499 </listitem>
2500 <listitem>
2501 <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Added an update the fix made in revision 7528 (handling of xref/link in no.anchor.mode mode).
2502 Having xref in title is not a problem as long as the target is not an ancestor element. 
2503 Closes bug #1838136.
2504
2505 Note that an xref that is in a title and whose target is an ancestor element is still not 
2506 rendered in the TOC. This could be considered a bug, but on the other hand I cannot really
2507 see the point in having such an xref in a document.</phrase></screen>
2508 </listitem>
2509 <listitem>
2510 <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Added a "not(ancestor::title)" test to work around "too many nested 
2511 apply-templates" problems when processing xrefs or links in no.anchor.mode mode.
2512 Hopefully, this closes bug #1811721.</phrase></screen>
2513 </listitem>
2514 <listitem>
2515 <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Removed old template matching "link" in no.anchor.mode mode.</phrase></screen>
2516 </listitem>
2517 <listitem>
2518 <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Process &lt;link&gt; in no.anchor.mode mode with the same template as &lt;xref&gt;. 
2519 Closes bug #1759205 (Empty link in no.anchor.mode mode).</phrase></screen>
2520 </listitem>
2521 <listitem>
2522 <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">In no.anchor.mode mode, do not output anchors for elements that are descendants 
2523 of &lt;title&gt;. Previously, having inline elements with @id/@xml:id in &lt;title&gt;s 
2524 resulted in anchors both in the TOC and in the main flow. Closes bug #1797492.</phrase></screen>
2525 </listitem>
2526 </itemizedlist>
2527 </sect2><!--end of Common changes for 1.74.0-->
2528
2529 <sect2 xml:id="V1.74.0_FO">
2530 <title>FO</title>
2531 <para>The following changes have been made to the
2532             <filename>fo</filename> code
2533             since the 1.73.2 release.</para>
2534 <itemizedlist>
2535 <listitem> <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Updated documentation for keep-together.</phrase></screen> </listitem>
2536 <listitem> <para><literal>Mauritz Jeanson: task.xsl</literal></para><screen><phrase role="commit-message">Enabled use of the keep-together PI on <tag>task</tag> elements.</phrase></screen> </listitem>
2537 <listitem>
2538 <para><literal>Robert Stayton: index.xsl</literal></para><screen><phrase role="commit-message">FOP1 requires fo:wrapper for inline index entries, not fo:inline.</phrase></screen>
2539 </listitem>
2540 <listitem>
2541 <para><literal>Robert Stayton: index.xsl</literal></para><screen><phrase role="commit-message">Fixed non-working inline.or.block template for indexterm wrappers.
2542 Add fop1 to list of processors using inline.or.block.</phrase></screen>
2543 </listitem>
2544 <listitem>
2545 <para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1891965 (colsep in entytbl not working).</phrase></screen>
2546 </listitem>
2547 <listitem>
2548 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added support for title in revhistory. Closes bug #1842847.</phrase></screen>
2549 </listitem>
2550 <listitem>
2551 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Small doc cleanup (dbfo float-type).</phrase></screen>
2552 </listitem>
2553 <listitem>
2554 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Insert commas between multiple copyright holders.</phrase></screen>
2555 </listitem>
2556 <listitem>
2557 <para><literal>Mauritz Jeanson: autotoc.xsl; division.xsl</literal></para><screen><phrase role="commit-message">Added modifications to support nested set elements. See bug #1853172.</phrase></screen>
2558 </listitem>
2559 <listitem>
2560 <para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space to xsl:sorts to avoid missorting of glossterms due to stray leading spaces.</phrase></screen>
2561 </listitem>
2562 <listitem>
2563 <para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry</phrase></screen>
2564 </listitem>
2565 <listitem>
2566 <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,
2567 and the "hot text" is the biblioid itself enclosed in brackets.</phrase></screen>
2568 </listitem>
2569 <listitem>
2570 <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Moved declaration of comment.block.parents entity to common/entities.ent.</phrase></screen>
2571 </listitem>
2572 <listitem>
2573 <para><literal>Mauritz Jeanson: docbook.xsl</literal></para><screen><phrase role="commit-message">Updated message about unmatched element.</phrase></screen>
2574 </listitem>
2575 <listitem>
2576 <para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Added link to profiling chapter of TCG.</phrase></screen>
2577 </listitem>
2578 <listitem>
2579 <para><literal>Mauritz Jeanson: refentry.xsl</literal></para><screen><phrase role="commit-message">Fixed typo (refsynopsysdiv -&gt; refsynopsisdiv).</phrase></screen>
2580 </listitem>
2581 <listitem>
2582 <para><literal>David Cramer: fop.xsl; fop1.xsl; ptc.xsl; xep.xsl</literal></para><screen><phrase role="commit-message">Added test to check generate.index param when generating pdf bookmarks</phrase></screen>
2583 </listitem>
2584 <listitem>
2585 <para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Added support for MathML in imagedata.</phrase></screen>
2586 </listitem>
2587 <listitem>
2588 <para><literal>Michael(tm) Smith: math.xsl</literal></para><screen><phrase role="commit-message">Removed unnecessary extra test condition in test express that
2589 checks for passivetex.</phrase></screen>
2590 </listitem>
2591 <listitem>
2592 <para><literal>Michael(tm) Smith: math.xsl</literal></para><screen><phrase role="commit-message">Don't use fo:instream-foreign-object if we are processing with
2593 passivetex. Closes #1806899. Thanks to Justus Piater.</phrase></screen>
2594 </listitem>
2595 <listitem>
2596 <para><literal>Mauritz Jeanson: component.xsl</literal></para><screen><phrase role="commit-message">Added code to output a TOC for an appendix in an article when 
2597 generate.toc='article/appendix toc'. Closes bug #1669658.</phrase></screen>
2598 </listitem>
2599 <listitem>
2600 <para><literal>Dongsheng Song: biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Change encoding from "windows-1250" to "UTF-8".</phrase></screen>
2601 </listitem>
2602 <listitem>
2603 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Updated documentation for dbfo_label-width.</phrase></screen>
2604 </listitem>
2605 <listitem>
2606 <para><literal>Mauritz Jeanson: lists.xsl</literal></para><screen><phrase role="commit-message">Added support for the dbfo_label-width PI in calloutlists.</phrase></screen>
2607 </listitem>
2608 <listitem>
2609 <para><literal>Robert Stayton: biblio.xsl</literal></para><screen><phrase role="commit-message">Support finding glossary database entries inside bibliodivs.</phrase></screen>
2610 </listitem>
2611 <listitem>
2612 <para><literal>Robert Stayton: formal.xsl</literal></para><screen><phrase role="commit-message">Complete support for &lt;?dbfo pgwide="1"?&gt; for informal
2613 elements too.</phrase></screen>
2614 </listitem>
2615 <listitem>
2616 <para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">In the table.block template, added a check for the dbfo_keep-together PI, so that 
2617 a table may break (depending on the PI value) at a page break. This was needed 
2618 since the outer fo:block that surrounds fo:table has keep-together.within-column="always" 
2619 by default, which prevents the table from breaking. Closes bug #1740964 (Titled 
2620 table does not respect dbfo PI).</phrase></screen>
2621 </listitem>
2622 <listitem>
2623 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Added a few missing @role="tcg".</phrase></screen>
2624 </listitem>
2625 <listitem>
2626 <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Use normalize-space() in glossterm comparisons (as in html/inline.xsl).</phrase></screen>
2627 </listitem>
2628 <listitem>
2629 <para><literal>Mauritz Jeanson: autoidx.xsl</literal></para><screen><phrase role="commit-message">Removed the [&amp;scope;] predicate from the target variable in the template with name="reference".
2630 This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
2631 with index.on.type=1. Closes bug #1680836.</phrase></screen>
2632 </listitem>
2633 <listitem>
2634 <para><literal>Michael(tm) Smith: inline.xsl; xref.xsl; footnote.xsl</literal></para><screen><phrase role="commit-message">Added capability in FO output for displaying URLs for all
2635 hyperlinks (elements marked up with xlink:href attributes) in the
2636 same way as URLs for ulinks are already handled (which is to say,
2637 either inline or as numbered footnotes).
2638
2639 Background on this change:
2640 DocBook 5 allows "ubiquitous" linking, which means you can make
2641 any element a hyperlink just by adding an xlink:href attribute to
2642 it, with the value set to an external URL. That's in contrast to
2643 DocBook 4, which only allows you to use specific elements (e.g.,
2644 the link and ulink elements) to mark up hyperlinks.
2645
2646 The existing FO stylesheets have a mechanism for handling display
2647 of URLs for hyperlinks that are marked up with ulink, but they did
2648 not handle display of URLs for elements that were marked up with
2649 xlink:href attributes. This change adds handling for those other
2650 elements, enabling the URLs they link to be displayed either
2651 inline or as numbered footnotes (depending on what values the user
2652 has the ulink.show and ulink.footnotes params set to).
2653
2654 Note that this change only adds URL display support for elements
2655 that call the simple.xlink template -- which currently is most
2656 (but not all) inline elements.
2657
2658 This change also moves the URL display handling out of the ulink
2659 template and into a new "hyperlink.url.display" named template;
2660 the ulink template and the simple.xlink named template now both
2661 call the hyperlink.url.display template.
2662
2663 Warning: In the stylesheet code that determines what footnote
2664 number to assign to each footnote or external hyperlink, there is
2665 an XPath expression for determining whether a particular
2666 xlink:href instance is an external hyperlink; that expression is
2667 necessarily a bit complicated and further testing may reveal that
2668 it doesn't handle all cases as expected -- so some refinements to
2669 it may need to be done later.
2670
2671 Closes #1785519. Thanks to Ken Morse for reporting and
2672 troubleshooting the problem.</phrase></screen>
2673 </listitem>
2674 </itemizedlist>
2675 </sect2><!--end of FO changes for 1.74.0-->
2676
2677 <sect2 xml:id="V1.74.0_HTML">
2678 <title>HTML</title>
2679 <para>The following changes have been made to the
2680             <filename>html</filename> code
2681             since the 1.73.2 release.</para>
2682 <itemizedlist>
2683 <listitem> <para><literal>Keith Fahlgren: inline.xsl; synop.xsl</literal></para><screen><phrase role="commit-message">Work to make HTML and XHTML targets more valid</phrase></screen> </listitem>
2684 <listitem> <para><literal>Keith Fahlgren: table.xsl</literal></para><screen><phrase role="commit-message">Add better handling for tables that have footnotes in the titles</phrase></screen> </listitem>
2685 <listitem> <para><literal>Keith Fahlgren: biblio.xsl</literal></para><screen><phrase role="commit-message">Add anchors to bibliodivs</phrase></screen> </listitem>
2686 <listitem>
2687 <para><literal>Keith Fahlgren: formal.xsl; Makefile; htmltbl.xsl</literal></para><screen><phrase role="commit-message">Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
2688 and Keith Fahlgren of O'Reilly.</phrase></screen>
2689 <para>This change includes new code for generating the XHTML 1.1 target sanely.</para>
2690 </listitem>
2691 <listitem>
2692 <para><literal>Mauritz Jeanson: biblio.xsl</literal></para><screen><phrase role="commit-message">Added code for creating URLs from biblioids with @class="doi" (representing Digital 
2693 Object Identifiers). See FR #1934434 and http://doi.org.
2694
2695 To do: 1) Add support for FO output. 2) Figure out how @class="doi" should be handled 
2696 for bibliorelation, bibliosource and citebiblioid.</phrase></screen>
2697 </listitem>
2698 <listitem>
2699 <para><literal>Norman Walsh: formal.xsl</literal></para><screen><phrase role="commit-message">Don't use xsl:copy because it forces the resulting element to be in the same namespace as the source element; in the XHTML stylesheets, that's wrong. But the HTML-to-XHTML converter does the right thing with literal result elements, so use one of them.</phrase></screen>
2700 </listitem>
2701 <listitem>
2702 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">Added checks and hacks to various makefiles to enable building
2703 under Cygwin. This stuff is ugly and maybe not worth the mess and
2704 trouble, but does seem to work as expected and not break anything
2705 else.</phrase></screen>
2706 </listitem>
2707 <listitem>
2708 <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">added "exslt" namespace binding to html/docbook.xsl file (in
2709 addition to existing "exsl" binding. reason is because lack of it
2710 seems to cause processing problems when using the profiled
2711 version of the stylsheet</phrase></screen>
2712 </listitem>
2713 <listitem>
2714 <para><literal>Norman Walsh: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Rename link</phrase></screen>
2715 </listitem>
2716 <listitem>
2717 <para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">Added a fix to make rowsep apply to the last row of thead in entrytbl.</phrase></screen>
2718 </listitem>
2719 <listitem>
2720 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Simplified and streamlined handling of output for ANSI-style
2721 funcprototype output, to correct a problem that was causing type
2722 data to be lost in the output parameter definitions. For example,
2723 for an instance like this:
2724   &lt;paramdef&gt;void *&lt;parameter&gt;dataptr&lt;/parameter&gt;[]&lt;/paramdef&gt;
2725 ... the brackets (indicating an array type) were being dropped.</phrase></screen>
2726 </listitem>
2727 <listitem>
2728 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Changed HTML handling of K&amp;R-style paramdef output. The parameter
2729 definitions are no longer output in a table (though the prototype
2730 still is). The reason for the change is that the
2731 kr-tabular-funcsynopsis-mode template was causing type data to be
2732 lost in the output parameter definitions. For example, for an
2733 instance like this:
2734   &lt;paramdef&gt;void *&lt;parameter&gt;dataptr&lt;/parameter&gt;[]&lt;/paramdef&gt;
2735 ... the brackets (indicating an array type) were being dropped.
2736 The easiest way to deal with the problem is to not try to chop up
2737 the parameter definitions and display them in table format, but to
2738 instead just output them as-is. May not look quite as pretty, but
2739 at least we can be sure no information is being lost...</phrase></screen>
2740 </listitem>
2741 <listitem>
2742 <para><literal>Michael(tm) Smith: pi.xsl</literal></para><screen><phrase role="commit-message">updated wording of doc for funcsynopsis-style PI</phrase></screen>
2743 </listitem>
2744 <listitem>
2745 <para><literal>Michael(tm) Smith: param.xweb; param.ent; synop.xsl</literal></para><screen><phrase role="commit-message">Removed the funcsynopsis.tabular.threshold param. It's no longer
2746 being used in the code and hasn't been since mid 2006.</phrase></screen>
2747 </listitem>
2748 <listitem>
2749 <para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Added support for the img.src.path parameter for SVG graphics. Closes bug #1888169.</phrase></screen>
2750 </listitem>
2751 <listitem>
2752 <para><literal>Mauritz Jeanson: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Added missing space.</phrase></screen>
2753 </listitem>
2754 <listitem>
2755 <para><literal>Norman Walsh: component.xsl</literal></para><screen><phrase role="commit-message">Fix bug where component titles inside info elements were not handled properly</phrase></screen>
2756 </listitem>
2757 <listitem>
2758 <para><literal>Michael(tm) Smith: pi.xsl</literal></para><screen><phrase role="commit-message">Moved dbhtml_stop-chunking embedded doc into alphabetical order,
2759 fixed text of TCG section it see-also'ed.</phrase></screen>
2760 </listitem>
2761 <listitem>
2762 <para><literal>David Cramer: pi.xsl</literal></para><screen><phrase role="commit-message">Added support for &lt;?dbhtml stop-chunking?&gt; processing instruction</phrase></screen>
2763 </listitem>
2764 <listitem>
2765 <para><literal>David Cramer: chunk-common.xsl; pi.xsl</literal></para><screen><phrase role="commit-message">Added support for &lt;?dbhtml stop-chunking?&gt; processing instruction</phrase></screen>
2766 </listitem>
2767 <listitem>
2768 <para><literal>David Cramer: glossary.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry. Also added normalize-space to avoid missorting due to stray leading spaces.</phrase></screen>
2769 </listitem>
2770 <listitem>
2771 <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,
2772 and the "hot text" is the biblioid itself enclosed in brackets.</phrase></screen>
2773 </listitem>
2774 <listitem>
2775 <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Added support for @xlink:show in the simple.xlink template. The "new" and "replace" 
2776 values are supported (corresponding to values of "_blank" and "_top" for the 
2777 ulink.target parameter). I have assumed that @xlink:show should override ulink.target
2778 for external URI links. This closes bugs #1762023 and #1727498.</phrase></screen>
2779 </listitem>
2780 <listitem>
2781 <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Moved declaration of comment.block.parents entity to common/entities.ent.</phrase></screen>
2782 </listitem>
2783 <listitem>
2784 <para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Added link to profiling chapter of TCG.</phrase></screen>
2785 </listitem>
2786 <listitem>
2787 <para><literal>Dongsheng Song: biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Change encoding from "windows-1250" to "UTF-8".</phrase></screen>
2788 </listitem>
2789 <listitem>
2790 <para><literal>Robert Stayton: biblio.xsl</literal></para><screen><phrase role="commit-message">Add support in biblio collection to entries in bibliodivs.</phrase></screen>
2791 </listitem>
2792 <listitem>
2793 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Added missing @role="tcg".</phrase></screen>
2794 </listitem>
2795 <listitem>
2796 <para><literal>Mauritz Jeanson: chunk-common.xsl; titlepage.xsl</literal></para><screen><phrase role="commit-message">Refactored legalnotice/revhistory chunking, so that the use.id.as.filename 
2797 parameter as well as the dbhtml_filename PI are taken into account. A new named
2798 template in titlepage.xsl is used to compute the filename.</phrase></screen>
2799 </listitem>
2800 <listitem>
2801 <para><literal>Mauritz Jeanson: chunk-common.xsl; titlepage.xsl</literal></para><screen><phrase role="commit-message">An update to the fix for bug #1790495 (r7433):
2802 The "ln-" prefix is output only when the legalnotice doesn't have an
2803 @id/@xml:id, in which case the stylesheets generate an ID value, 
2804 resulting in a filename like "ln-7e0fwgj.html". This is useful because 
2805 without the prefix, you wouldn't know that the file contained a legalnotice. 
2806 The same logic is also applied to revhistory, using an "rh-" prefix.</phrase></screen>
2807 </listitem>
2808 <listitem>
2809 <para><literal>Mauritz Jeanson: autoidx.xsl</literal></para><screen><phrase role="commit-message">Removed the [&amp;scope;] predicate from the target variable in the template with name="reference".
2810 This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
2811 with index.on.type=1. Closes bug #1680836.</phrase></screen>
2812 </listitem>
2813 <listitem>
2814 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added 'ln-' prefix to the name of the legalnotice chunk, in order to match the 
2815 &lt;link href"..."&gt; that is output by make.legalnotice.head.links (chunk-common.xsl).
2816 Modified the href attribute on the legalnotice link.
2817 Closes bug #1790495.</phrase></screen>
2818 </listitem>
2819 </itemizedlist>
2820 </sect2><!--end of HTML changes for 1.74.0-->
2821
2822 <sect2 xml:id="V1.74.0_Manpages">
2823 <title>Manpages</title>
2824 <para>The following changes have been made to the
2825             <filename>manpages</filename> code
2826             since the 1.73.2 release.</para>
2827 <itemizedlist>
2828 <listitem>
2829 <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">slightly adjusted spacing around admonition markers</phrase></screen>
2830 </listitem>
2831 <listitem>
2832 <para><literal>Michael(tm) Smith: refentry.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">make sure refsect3 titles are preceded by a line of space, and
2833 make the indenting of their child content less severe</phrase></screen>
2834 </listitem>
2835 <listitem>
2836 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">only indent verbatim environments in TTY output, not in non-TTY/PS</phrase></screen>
2837 </listitem>
2838 <listitem>
2839 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">made another adjustment to correct vertical alignment of admonition marker</phrase></screen>
2840 </listitem>
2841 <listitem>
2842 <para><literal>Michael(tm) Smith: block.xsl; other.xsl</literal></para><screen><phrase role="commit-message">Adjusted/corrected alignment of adominition marker in PS/non-TTY output.</phrase></screen>
2843 </listitem>
2844 <listitem>
2845 <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">For PS/non-TTY output, display footnote/endnote numbers in
2846 superscript.</phrase></screen>
2847 </listitem>
2848 <listitem>
2849 <para><literal>Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">Changed handling of hanging indents for cmdsynopsis, funcsynopsis,
2850 and synopfragment such that they now look correct in non-TTY/PS
2851 output. We now use the groff \w escape to hang by the actual width
2852 -- in the current font -- of the command, funcdef, or
2853 synopfragment references number (as opposed to hanging by the
2854 number of characters). This rendering in TTY output remains the
2855 same, since the width in monospaced TTY output is the same as the
2856 number of characters.
2857
2858 Also, created new synopsis-block-start and synopsis-block-end
2859 templates to use for cmdsynopsis and funcsynopsis instead of the
2860 corresponding verbatim-* templates.
2861
2862 Along with those changes, also corrected a problem that caused the
2863 content of synopfragment to be dropped, and made a
2864 vertical-spacing change to adjust spacing around table titles and
2865 among sibling synopfragment instances.</phrase></screen>
2866 </listitem>
2867 <listitem>
2868 <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">use common l10.language.name template to retrieve English-language name</phrase></screen>
2869 </listitem>
2870 <listitem>
2871 <para><literal>Michael(tm) Smith: synop.xsl; inline.xsl</literal></para><screen><phrase role="commit-message">added comment in code explaining why we don't put filename output
2872 in italic (despite the fact that man guidelines say we should)</phrase></screen>
2873 </listitem>
2874 <listitem>
2875 <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">put filename output in monospace instead of italic</phrase></screen>
2876 </listitem>
2877 <listitem>
2878 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">put cmdsynopsis in monospace</phrase></screen>
2879 </listitem>
2880 <listitem>
2881 <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">removed template match for literal. template matches for monospace
2882 inlines are all imported from the HTML stylesheet</phrase></screen>
2883 </listitem>
2884 <listitem>
2885 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">don't indent verbatim environments that are descendants of
2886 refsynopsisdiv, not put backgrounds behind them</phrase></screen>
2887 </listitem>
2888 <listitem>
2889 <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">set output of the literal element in monospace. this causes all
2890 inline monospace instances in the git man pages to be set in
2891 monospace (since DocBook XML source for git docs is generated with
2892 asciidoc and asciidoc consistently outputs only &lt;literal&gt; for
2893 inline monospace (not &lt;command&gt; or &lt;code&gt; or anything else).
2894 Of course this only affects non-TTY output...</phrase></screen>
2895 </listitem>
2896 <listitem>
2897 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">Added inline.monoseq named template.</phrase></screen>
2898 </listitem>
2899 <listitem>
2900 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">don't bother using a custom register to store the previous
2901 font-family value when setting blocks of text in code font; just
2902 use \F[] .fam with no arg to switch back</phrase></screen>
2903 </listitem>
2904 <listitem>
2905 <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">put links in blue in PS output (note that this matches how groff
2906 renders content marked up with the .URL macro)</phrase></screen>
2907 </listitem>
2908 <listitem>
2909 <para><literal>Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">removed man.links.are.underlined and added man.font.links. Also,
2910 changed the default font formatting for links to bold.</phrase></screen>
2911 </listitem>
2912 <listitem>
2913 <para><literal>Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added new param man.base.url.for.relative.links .. specifies a
2914 base URL for relative links (for ulink, @xlink:href, imagedata,
2915 audiodata, videodata) shown in the generated NOTES section of
2916 man-page output. The value of man.base.url.for.relative.links is
2917 prepended to any relative URI that is a value of ulink url,
2918 xlink:href, or fileref attribute.
2919
2920 If you use relative URIs in link sources in your DocBook refentry
2921 source, and you leave man.base.url.for.relative.links unset, the
2922 relative links will appear "as is" in the NOTES section of any
2923 man-page output generated from your source. That's probably not
2924 what you want, because such relative links are only usable in the
2925 context of HTML output. So, to make the links meaningful and
2926 usable in the context of man-page output, set a value for
2927 man.base.url.for.relative.links that points
2928 to the online version of HTML output generated from your DocBook
2929 refentry source. For example:
2930
2931   &lt;xsl:param name="man.base.url.for.relative.links"
2932   &gt;http://www.kernel.org/pub/software/scm/git/docs/&lt;/xsl:param&gt;</phrase></screen>
2933 </listitem>
2934 <listitem>
2935 <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">If a source refentry contains a Documentation or DOCUMENTATION
2936 section, don't report it as having missing AUTHOR information.
2937 Also, if missing a contrib/personblurb for a person or org, report
2938 pointers to http://docbook.sf.net/el/personblurb and to
2939 http://docbook.sf.net/el/contrib</phrase></screen>
2940 </listitem>
2941 <listitem>
2942 <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">If we encounter an author|editor|othercredit instance that lacks a
2943 personblurb or contrib, report it to the user (because that means
2944 we have no information about that author|editor|othercredit to
2945 display in the generated AUTHOR|AUTHORS section...)</phrase></screen>
2946 </listitem>
2947 <listitem>
2948 <para><literal>Michael(tm) Smith: info.xsl; docbook.xsl; other.xsl</literal></para><screen><phrase role="commit-message">if we can't find any usable author data, emit a warning and insert
2949 a fixme in the output</phrase></screen>
2950 </listitem>
2951 <listitem>
2952 <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">fixed bug in indenting of output for contrib instances in AUTHORS
2953 section. Thanks to Daniel Leidert and the fglrx docs for exposing
2954 the bug.</phrase></screen>
2955 </listitem>
2956 <listitem>
2957 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">for a para or simpara that is the first child of a callout,
2958 suppress the .sp or .PP that would normally be output (because in
2959 those cases, the output goes into a table cell, and the .sp or .PP
2960 markup causes a spurious linebreak before it when displayed</phrase></screen>
2961 </listitem>
2962 <listitem>
2963 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Added support for rendering co callouts and calloutlist instances.
2964 So you can now use simple callouts -- marking up programlisting
2965 and such with co instances -- and have the callouts displayed in
2966 man-page output. ("simple callouts" means using co@id and
2967 callout@arearefs pointing to co@id instances; in man/roff output,
2968 we can't/don't support markup that uses areaset and area)</phrase></screen>
2969 </listitem>
2970 <listitem>
2971 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">only put a line of space after a verbatim if it's followed by a
2972 text node or a paragraph</phrase></screen>
2973 </listitem>
2974 <listitem>
2975 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">put verbatim environments in slightly smaller font in non-TTY
2976 output</phrase></screen>
2977 </listitem>
2978 <listitem>
2979 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">minor whitespace-only reformatting of lists.xsl source</phrase></screen>
2980 </listitem>
2981 <listitem>
2982 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Made refinements/fixes to output of orderedlist and itemizedlist
2983 -- in part, to get mysql man pages to display correctly. This
2984 change causes a "\c" continuation marker to be added between
2985 listitem markers and contents (to ensure that the content remains
2986 on the same line as the marker when displayed)</phrase></screen>
2987 </listitem>
2988 <listitem>
2989 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">put a line of vertical space after all verbatim output that has
2990 sibling content following it (not just if that sibling content is
2991 a text node)</phrase></screen>
2992 </listitem>
2993 <listitem>
2994 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">refined spacing around titles for admonitions</phrase></screen>
2995 </listitem>
2996 <listitem>
2997 <para><literal>Michael(tm) Smith: block.xsl; other.xsl</literal></para><screen><phrase role="commit-message">Deal with case of verbatim environments that have a linebreak
2998 after the opening tag. Assumption is that users generally don't
2999 want that linebreak to appear in output, so we do some groff
3000 hackery to mess with vertical spacing and close the space.</phrase></screen>
3001 </listitem>
3002 <listitem>
3003 <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">indexterm instances now produce groff comments like this:
3004
3005   .\" primary: secondary: tertiary
3006
3007 remark instances, if non-empty, now produce groff comments</phrase></screen>
3008 </listitem>
3009 <listitem>
3010 <para><literal>Michael(tm) Smith: charmap.groff.xsl; other.xsl</literal></para><screen><phrase role="commit-message">convert no-break space character to groff "\ \&amp;" (instead of just
3011 "\ "). the reason is that if a space occurs at the end of a line,
3012 our processing causes it to be eaten. a real-world case of this is
3013 the mysql(1) man page. appending the "\&amp;" prevents that</phrase></screen>
3014 </listitem>
3015 <listitem>
3016 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">output "sp" before simpara output, not after it (outputting it
3017 after results in undesirable whitespace in particular cases; for
3018 example, in the hg/mercurial docs</phrase></screen>
3019 </listitem>
3020 <listitem>
3021 <para><literal>Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">renamed from title-preamble to pinch.together and replaced "sp -1"
3022 between synopsis fragments with call to pinch.together instead</phrase></screen>
3023 </listitem>
3024 <listitem>
3025 <para><literal>Michael(tm) Smith: table.xsl</literal></para><screen><phrase role="commit-message">use title-preamble template for table titles (instead of "sp -1"
3026 hack), and "sp 1" after all tables (instead of just "sp"</phrase></screen>
3027 </listitem>
3028 <listitem>
3029 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">created title-preamble template for suppressing line spacing after
3030 headings</phrase></screen>
3031 </listitem>
3032 <listitem>
3033 <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">further refinement of indenting in AUTHORS section</phrase></screen>
3034 </listitem>
3035 <listitem>
3036 <para><literal>Michael(tm) Smith: block.xsl; other.xsl</literal></para><screen><phrase role="commit-message">refined handling of admonitions</phrase></screen>
3037 </listitem>
3038 <listitem>
3039 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Use RS/RE in another place where we had IP ""</phrase></screen>
3040 </listitem>
3041 <listitem>
3042 <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">Replace (ab)use of IP with "sp -1" in AUTHORS section with RS/RE
3043 instead.</phrase></screen>
3044 </listitem>
3045 <listitem>
3046 <para><literal>Michael(tm) Smith: table.xsl; synop.xsl; info.xsl</literal></para><screen><phrase role="commit-message">changed all instances of ".sp -1n" to ".sp -1"</phrase></screen>
3047 </listitem>
3048 <listitem>
3049 <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">add extra line before SH heads only in non-TTY output</phrase></screen>
3050 </listitem>
3051 <listitem>
3052 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">Reworked output for admonitions (caution, important, note, tip,
3053 warning). In TTY output, admonitions now get indented. In non-TTY
3054 output, a colored marker (yellow) is displayed next to them.</phrase></screen>
3055 </listitem>
3056 <listitem>
3057 <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">Added BM/EM macros for putting a colored marker in margin next to
3058 a block of text.</phrase></screen>
3059 </listitem>
3060 <listitem>
3061 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">created make.bold.title template by moving title-bolding part out
3062 from nested-section-title template. This allows the bolding to
3063 also be used by the template for formatting admonitions</phrase></screen>
3064 </listitem>
3065 <listitem>
3066 <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">put .br before copyright contents to prevent them from getting run in</phrase></screen>
3067 </listitem>
3068 <listitem>
3069 <para><literal>Michael(tm) Smith: refentry.xsl; other.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">made point size of output for Refsect2 and Refsect3 heads bigger</phrase></screen>
3070 </listitem>
3071 <listitem>
3072 <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">put slightly more space between SH head and underline in non-TTY
3073 output</phrase></screen>
3074 </listitem>
3075 <listitem>
3076 <para><literal>Michael(tm) Smith: param.xweb; param.ent; other.xsl</literal></para><screen><phrase role="commit-message">Added the man.charmap.subset.profile.english parameter and refined
3077 the handling of charmap subsets to differentiate between English
3078 and non-English source.
3079
3080 This way charmap subsets are now handled is this:
3081
3082 If the value of the man.charmap.use.subset parameter is non-zero,
3083 and your DocBook source is not written in English (that is, if its
3084 lang or xml:lang attribute has a value other than en), then the
3085 character-map subset specified by the man.charmap.subset.profile
3086 parameter is used instead of the full roff character map.
3087
3088 Otherwise, if the lang or xml:lang attribute on the root element
3089 in your DocBook source or on the first refentry element in your
3090 source has the value en or if it has no lang or xml:lang
3091 attribute, then the character-map subset specified by the
3092 man.charmap.subset.profile.english parameter is used instead of
3093 man.charmap.subset.profile.
3094
3095 The difference between the two subsets is that
3096 man.charmap.subset.profile provides mappings for characters in
3097 Western European languages that are not part of the Roman
3098 (English) alphabet (ASCII character set).</phrase></screen>
3099 </listitem>
3100 <listitem>
3101 <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">Various updates, mainly related to uppercasing SH titles:
3102
3103   - added a "Language: " metadata line to the top comment area of
3104     output man pages, to indicate the language the page is in
3105
3106   - added a "toupper" macro of doing locale-aware uppercasing of
3107     SH titles and cross-references to SH titles; the mechanism
3108     relies on the uppercase.alpha and lowercase.alpha DocBook
3109     gentext keys to do locale-aware uppercasing based on the
3110     language the page is written in
3111
3112   - added a "string.shuffle" template, which provides a library
3113     function for "shuffling" two strings together into a single
3114     string; it takes the first character for the first string, the
3115     first character from second string, etc. The only current use
3116     for it is to generate the argument for the groff tr request
3117     that does string uppercasing.
3118
3119   - added make.tr.uppercase.arg and make.tr.normalcase.arg named
3120     templates for use in generating groff code for uppercasing and
3121     "normal"-casing SH titles
3122
3123   - made the BB/BE "background drawing" macros have effect only in
3124     non-TTY output
3125
3126   - output a few comments in the top part of source</phrase></screen>
3127 </listitem>
3128 <listitem>
3129 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">removed some leftover kruft</phrase></screen>
3130 </listitem>
3131 <listitem>
3132 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">To create the name(s) for each man page, we now replace any spaces
3133 in the refname(s) with underscores. This ensures that tools like
3134 lexgrog(1) will be able to parse the name (lexgrog won't parse
3135 names that contain spaces).</phrase></screen>
3136 </listitem>
3137 <listitem>
3138 <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">Put a comment into source of man page to indicate where the main
3139 content starts. (We now have a few of macro definitions at the
3140 start of the source, so putting this comment in helps those that
3141 might be viewing the source.)</phrase></screen>
3142 </listitem>
3143 <listitem>
3144 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">refined mechanism for generating SH titles</phrase></screen>
3145 </listitem>
3146 <listitem>
3147 <para><literal>Michael(tm) Smith: charmap.groff.xsl</literal></para><screen><phrase role="commit-message">Added zcaron, Zcaron, scaron, and Scaron to the groff character map.
3148 This means that generated Finnish man pages will no longer contain
3149 any raw accented characters -- they'll instead by marked up with
3150 groff escapes.</phrase></screen>
3151 </listitem>
3152 <listitem>
3153 <para><literal>Michael(tm) Smith: other.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">corrected a regression I introduced about a year ago that caused
3154 dots to be output just as "\." -- instead needs to be "\&amp;." (which
3155 is what it will be now, after this change)</phrase></screen>
3156 </listitem>
3157 <listitem>
3158 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Changed backend handling for generating titles for SH sections and
3159 for cross-references to those sections. This should have no effect
3160 on TTY output (behavior should remain the same hopefully) but
3161 results in titles in normal case (instead of uppercase) in PS
3162 output.</phrase></screen>
3163 </listitem>
3164 <listitem>
3165 <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">use make.subheading template to make subheadings for AUTHORS and
3166 COPYRIGHT sections (instead of harcoding roff markup)</phrase></screen>
3167 </listitem>
3168 <listitem>
3169 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">put code font around programlisting etc.</phrase></screen>
3170 </listitem>
3171 <listitem>
3172 <para><literal>Michael(tm) Smith: synop.xsl; docbook.xsl</literal></para><screen><phrase role="commit-message">embed custom macro definitions in man pages, plus wrap synopsis in
3173 code font</phrase></screen>
3174 </listitem>
3175 <listitem>
3176 <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">use the make.subheading template to generated SH subheading for
3177 endnotes section.</phrase></screen>
3178 </listitem>
3179 <listitem>
3180 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Added some templates for generating if-then-else conditional
3181 markup in groff, so let's use those instead of hard-coding it in
3182 multiple places...</phrase></screen>
3183 </listitem>
3184 <listitem>
3185 <para><literal>Michael(tm) Smith: other.xsl; utility.xsl</literal></para><screen><phrase role="commit-message">Initial checkin of some changes related to making PS/PDF output
3186 from "man -l -Tps" look better. The current changes:
3187
3188   - render synopsis and verbatim sections in a monospace/code font
3189
3190   - put a light-grey background behind all programlisting, screen,
3191     and literallayout instances
3192
3193   - prevent SH heads in PS output from being rendered in uppercase
3194     (as they are in console output)
3195
3196   - also display xrefs to SH heads in PS output in normal case
3197     (instead of uppercase)
3198
3199   - draw a line under SH heads in PS output
3200
3201 The changes made to the code to support the above features were:
3202
3203   - added some embedded/custom macros: one for conditionally
3204     upper-casing SH x-refs, one for redefining the SH macro
3205     itself, with some conditional handling for PS output, and
3206     finally a macro for putting a background/screen (filled box)
3207     around a block of text (e.g., a program listing) in PS output
3208
3209   - added utility templates for wrapping blocks of text in code
3210     font; also templates for inline code font</phrase></screen>
3211 </listitem>
3212 <listitem>
3213 <para><literal>Robert Stayton: refentry.xsl</literal></para><screen><phrase role="commit-message">refpurpose nodes now get apply-templates instead of just normalize-space().</phrase></screen>
3214 </listitem>
3215 <listitem>
3216 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed alignment of first lined of text for each listitem in
3217 orderedlist output for TTY. Existing code seemed to have been
3218 causing an extra undesirable space to appear.</phrase></screen>
3219 </listitem>
3220 <listitem>
3221 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Wrapped some roff conditionals around roff markup for orderedlist
3222 and itemizedlist output, so that the lists look acceptable in PS
3223 output as well as TTY.</phrase></screen>
3224 </listitem>
3225 <listitem>
3226 <para><literal>Michael(tm) Smith: pi.xsl; synop.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added the man.funcsynopsis.style parameter. Has the same effect in
3227 manpages output as the funcsynopsis.style parameter has in HTML
3228 output -- except that its default value is 'ansi' instead of 'kr'.</phrase></screen>
3229 </listitem>
3230 <listitem>
3231 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Reworked handling of K&amp;R funcprototype output. It no longer relies
3232 on the HTML kr-tabular templates, but instead just does direct
3233 transformation to roff. For K&amp;R output, it displays the paramdef
3234 output in an indented list following the prototype.</phrase></screen>
3235 </listitem>
3236 <listitem>
3237 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Properly integrated handling for K&amp;R output into manpages
3238 stylesheet. The choice between K&amp;R output and ANSI output is
3239 currently controlled through use of the (HTML) funcsynopsis.style
3240 parameter. Note that because the mechanism does currently rely on
3241 funcsynopsis.style, the default in manpages output is now K&amp;R
3242 (because that's the default of that param). But I suppose I ought
3243 to create a man.funcsynopsis.style and make the default for that
3244 ANSI (to preserve the existing default behavior).</phrase></screen>
3245 </listitem>
3246 <listitem>
3247 <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">added manpages/pi.xsl file</phrase></screen>
3248 </listitem>
3249 <listitem>
3250 <para><literal>Michael(tm) Smith: .cvsignore; pi.xsl</literal></para><screen><phrase role="commit-message">Added "dbman funcsynopsis-style" PI and incorporated it into the
3251 doc build.</phrase></screen>
3252 </listitem>
3253 <listitem>
3254 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Fixed regression that caused an unescaped dash to be output
3255 between refname and refpurpose content. Closes bug #1894244.
3256 Thanks to Daniel Leidert.</phrase></screen>
3257 </listitem>
3258 <listitem>
3259 <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">Fixed problem with dots being escaped in filenames of generated
3260 man files. Closes #1827195. Thanks to Daniel Leidert.</phrase></screen>
3261 </listitem>
3262 <listitem>
3263 <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">Added support for processing structfield (was appearing in roff
3264 output surrounded by HTML &lt;em&gt; tags; fixed so that it gets roff
3265 ital markup). Closes bug #1858329.  Thanks to Sam Varshavchik.</phrase></screen>
3266 </listitem>
3267 </itemizedlist>
3268 </sect2><!--end of Manpages changes for 1.74.0-->
3269
3270 <sect2 xml:id="V1.74.0_Epub">
3271 <title>Epub</title>
3272 <para>The following changes have been made to the
3273             <filename>epub</filename> code
3274             since the 1.73.2 release.</para>
3275 <itemizedlist>
3276 <listitem> <para><literal>Keith Fahlgren: bin/spec/README; bin/spec/epub_realbook_spec.rb</literal></para><screen><phrase role="commit-message">'Realbook' spec now passes</phrase></screen> </listitem>
3277 <listitem> <para><literal>Keith Fahlgren: bin/dbtoepub; README; bin/spec/README; bin/lib/docbook.rb; bin/spec/epub_r⋯</literal></para><screen><phrase role="commit-message">Very primitive Windows support for dbtoepub <tag>reference</tag> implementation; README for running tests and for the .epub target in general; shorter realbook test document (still fails for now)</phrase></screen> </listitem>
3278 <listitem> <para><literal>Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/docbook.rb; bin/s⋯</literal></para><screen><phrase role="commit-message">Changes to OPF spine to not duplicate idrefs for documents with parts not at the root; regression specs for same</phrase></screen> </listitem>
3279 <listitem> <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Fixing linking to <tag>cover</tag> @id, distinct from other needs of cover-image-id (again, thanks to Martin Goerner)</phrase></screen> </listitem>
3280 <listitem> <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Updating the <tag>title</tag> of the <tag>toc</tag> element in the guide to be more explicit (thanks to Martin Goerner)</phrase></screen> </listitem>
3281 <listitem>
3282 <para><literal>Keith Fahlgren: bin/spec/examples/amasque_exploded/content.opf; bin/spec/examples/amasque_⋯</literal></para><screen><phrase role="commit-message">Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
3283 and Keith Fahlgren of O'Reilly.</phrase></screen>
3284 </listitem>
3285 <listitem>
3286 <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">== General epub test support
3287
3288 $ spec -O ~/.spec.opts spec/epub_spec.rb 
3289
3290 DocBook::Epub
3291 - should be able to be created
3292 - should fail on a nonexistent file
3293 - should be able to render to a file
3294 - should create a file after rendering
3295 - should have the correct mimetype after rendering
3296 - should be valid .epub after rendering an article
3297 - should be valid .epub after rendering an article without sections
3298 - should be valid .epub after rendering a book
3299 - should be valid .epub after rendering a book even if it has one graphic
3300 - should be valid .epub after rendering a book even if it has many graphics
3301 - should be valid .epub after rendering a book even if it has many duplicated graphics
3302 - should report an empty file as invalid
3303 - should confirm that a valid .epub file is valid
3304 - should not include PDFs in rendered epub files as valid image inclusions
3305 - should include a TOC link in rendered epub files for &lt;book&gt;s
3306
3307 Finished in 20.608395 seconds
3308
3309 15 examples, 0 failures
3310
3311
3312 == Verbose epub test coverage against _all_ of the testdocs 
3313
3314 Fails on only (errors truncated):
3315 1)
3316 'DocBook::Epub should be able to render a valid .epub for the test document /Users/keith/work/docbook-dev/trunk/xsl/epub/bin/spec/testdocs/calloutlist.003.xml [30]' FAILED
3317 'DocBook::Epub should be able to render a valid .epub for the test document /Users/keith/work/docbook-dev/trunk/xsl/epub/bin/spec/testdocs/cmdsynopsis.001.xml [35]' FAILED
3318 ....
3319
3320 Finished in 629.89194 seconds
3321
3322 224 examples, 15 failures
3323
3324 224 examples, 15 failures yields 6% failure rate</phrase></screen>
3325 </listitem>
3326 </itemizedlist>
3327 </sect2><!--end of Epub changes for 1.74.0-->
3328
3329 <sect2 xml:id="V1.74.0_HTMLHelp">
3330 <title>HTMLHelp</title>
3331 <para>The following changes have been made to the
3332             <filename>htmlhelp</filename> code
3333             since the 1.73.2 release.</para>
3334 <itemizedlist>
3335 <listitem>
3336 <para><literal>Mauritz Jeanson: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt; to calls to
3337 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
3338 This makes chunk.quietly=1 suppress chunk filename messages also for help 
3339 support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
3340 </listitem>
3341 </itemizedlist>
3342 </sect2><!--end of HTMLHelp changes for 1.74.0-->
3343
3344 <sect2 xml:id="V1.74.0_Eclipse">
3345 <title>Eclipse</title>
3346 <para>The following changes have been made to the
3347             <filename>eclipse</filename> code
3348             since the 1.73.2 release.</para>
3349 <itemizedlist>
3350 <listitem>
3351 <para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Use sortas attributes (if they exist) when sorting indexterms</phrase></screen>
3352 </listitem>
3353 <listitem>
3354 <para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added support for indexterm/see in eclipse index.xml</phrase></screen>
3355 </listitem>
3356 <listitem>
3357 <para><literal>Mauritz Jeanson: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt;
3358 to helpidx template.</phrase></screen>
3359 </listitem>
3360 <listitem>
3361 <para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Generate index.xml file and add related goo to plugin.xml file. Does not yet support see and seealso.</phrase></screen>
3362 </listitem>
3363 <listitem>
3364 <para><literal>Mauritz Jeanson: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt; to calls to
3365 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
3366 This makes chunk.quietly=1 suppress chunk filename messages also for help 
3367 support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
3368 </listitem>
3369 </itemizedlist>
3370 </sect2><!--end of Eclipse changes for 1.74.0-->
3371
3372 <sect2 xml:id="V1.74.0_JavaHelp">
3373 <title>JavaHelp</title>
3374 <para>The following changes have been made to the
3375             <filename>javahelp</filename> code
3376             since the 1.73.2 release.</para>
3377 <itemizedlist>
3378 <listitem>
3379 <para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt; to calls to
3380 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
3381 This makes chunk.quietly=1 suppress chunk filename messages also for help 
3382 support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
3383 </listitem>
3384 </itemizedlist>
3385 </sect2><!--end of JavaHelp changes for 1.74.0-->
3386
3387 <sect2 xml:id="V1.74.0_Roundtrip">
3388 <title>Roundtrip</title>
3389 <para>The following changes have been made to the
3390             <filename>roundtrip</filename> code
3391             since the 1.73.2 release.</para>
3392 <itemizedlist>
3393 <listitem>
3394 <para><literal>Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl</literal></para><screen><phrase role="commit-message">fix table/cell borders for wordml, fix formal figure, add emphasis-strong</phrase></screen>
3395 </listitem>
3396 <listitem>
3397 <para><literal>Mauritz Jeanson: supported.xml</literal></para><screen><phrase role="commit-message">Changed @cols to 5.</phrase></screen>
3398 </listitem>
3399 <listitem>
3400 <para><literal>Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml</literal></para><screen><phrase role="commit-message">added pubdate, fixed metadata handling in biblioentry</phrase></screen>
3401 </listitem>
3402 <listitem>
3403 <para><literal>Steve Ball: supported.xml</literal></para><screen><phrase role="commit-message">Added support for edition.</phrase></screen>
3404 </listitem>
3405 <listitem>
3406 <para><literal>Steve Ball: docbook-pages.xsl; wordml-blocks.xsl; docbook.xsl; wordml.xsl; pages-normalise⋯</literal></para><screen><phrase role="commit-message">Removed stylesheets for old, deprecated conversion method.</phrase></screen>
3407 </listitem>
3408 <listitem>
3409 <para><literal>Steve Ball: specifications.xml; dbk2ooo.xsl; blocks2dbk.xsl; dbk2pages.xsl; blocks2dbk.dtd⋯</literal></para><screen><phrase role="commit-message">Added support for Open Office, added edition element, improved list and table support in Word and Pages</phrase></screen>
3410 </listitem>
3411 <listitem>
3412 <para><literal>Steve Ball: normalise-common.xsl; blocks2dbk.xsl; dbk2pages.xsl; template-pages.xml; templ⋯</literal></para><screen><phrase role="commit-message">Fixed bug in WordML table handling, improved table handling for Pages 08, synchronised WordML and Pages templates.</phrase></screen>
3413 </listitem>
3414 <listitem>
3415 <para><literal>Steve Ball: normalise-common.xsl; blocks2dbk.xsl; wordml2normalise.xsl; dbk2wp.xsl</literal></para><screen><phrase role="commit-message">fix caption, attributes</phrase></screen>
3416 </listitem>
3417 <listitem>
3418 <para><literal>Steve Ball: specifications.xml; blocks2dbk.xsl; wordml2normalise.xsl; blocks2dbk.dtd; temp⋯</literal></para><screen><phrase role="commit-message">Fixes to table and list handling</phrase></screen>
3419 </listitem>
3420 <listitem>
3421 <para><literal>Steve Ball: blocks2dbk.xsl</literal></para><screen><phrase role="commit-message">added support for explicit emphasis character styles</phrase></screen>
3422 </listitem>
3423 <listitem>
3424 <para><literal>Steve Ball: wordml2normalise.xsl</literal></para><screen><phrase role="commit-message">added support for customisation in image handling</phrase></screen>
3425 </listitem>
3426 <listitem>
3427 <para><literal>Steve Ball: blocks2dbk.xsl</literal></para><screen><phrase role="commit-message">Added inlinemediaobject support for metadata.</phrase></screen>
3428 </listitem>
3429 <listitem>
3430 <para><literal>Steve Ball: normalise-common.xsl; blocks2dbk.xsl; template.xml; dbk2wordml.xsl; dbk2wp.xsl</literal></para><screen><phrase role="commit-message">Added support file. Added style locking. Conversion bug fixes.</phrase></screen>
3431 </listitem>
3432 </itemizedlist>
3433 </sect2><!--end of Roundtrip changes for 1.74.0-->
3434
3435 <sect2 xml:id="V1.74.0_Slides">
3436 <title>Slides</title>
3437 <para>The following changes have been made to the
3438             <filename>slides</filename> code
3439             since the 1.73.2 release.</para>
3440 <itemizedlist>
3441 <listitem>
3442 <para><literal>Michael(tm) Smith: fo/Makefile; html/Makefile</literal></para><screen><phrase role="commit-message">Added checks and hacks to various makefiles to enable building
3443 under Cygwin. This stuff is ugly and maybe not worth the mess and
3444 trouble, but does seem to work as expected and not break anything
3445 else.</phrase></screen>
3446 </listitem>
3447 <listitem>
3448 <para><literal>Jirka Kosek: html/plain.xsl</literal></para><screen><phrase role="commit-message">Added support for showing foil number</phrase></screen>
3449 </listitem>
3450 </itemizedlist>
3451 </sect2><!--end of Slides changes for 1.74.0-->
3452
3453 <sect2 xml:id="V1.74.0_Website">
3454 <title>Website</title>
3455 <para>The following changes have been made to the
3456             <filename>website</filename> code
3457             since the 1.73.2 release.</para>
3458 <itemizedlist>
3459 <listitem>
3460 <para><literal>Michael(tm) Smith: extensions/saxon64/.classes/.gitignore; extensions/xalan2/.classes/com/⋯</literal></para><screen><phrase role="commit-message">renamed a bunch more .cvsignore files to .gitignore (to facilitate use of git-svn)</phrase></screen>
3461 </listitem>
3462 </itemizedlist>
3463 </sect2><!--end of Website changes for 1.74.0-->
3464
3465 <sect2 xml:id="V1.74.0_Params">
3466 <title>Params</title>
3467 <para>The following changes have been made to the
3468             <filename>params</filename> code
3469             since the 1.73.2 release.</para>
3470 <itemizedlist>
3471 <listitem> <para><literal>Keith Fahlgren: epub.autolabel.xml</literal></para><screen><phrase role="commit-message">New parameter for epub, epub.autolabel</phrase></screen> </listitem>
3472 <listitem>
3473 <para><literal>Mauritz Jeanson: table.frame.border.color.xml; table.cell.padding.xml; table.cell.border.t⋯</literal></para><screen><phrase role="commit-message">Added missing refpurposes and descriptions.</phrase></screen>
3474 </listitem>
3475 <listitem>
3476 <para><literal>Keith Fahlgren: ade.extensions.xml</literal></para><screen><phrase role="commit-message">Extensions to support Adobe Digital Editions extensions in .epub output.</phrase></screen>
3477 </listitem>
3478 <listitem>
3479 <para><literal>Mauritz Jeanson: fop.extensions.xml; fop1.extensions.xml</literal></para><screen><phrase role="commit-message">Clarified that fop1.extensions is for FOP 0.90 and later. Version 1 is not here yet...</phrase></screen>
3480 </listitem>
3481 <listitem>
3482 <para><literal>Michael(tm) Smith: man.links.are.underlined.xml; man.endnotes.list.enabled.xml; man.font.l⋯</literal></para><screen><phrase role="commit-message">removed man.links.are.underlined and added man.font.links. Also,
3483 changed the default font formatting for links to bold.</phrase></screen>
3484 </listitem>
3485 <listitem>
3486 <para><literal>Michael(tm) Smith: man.base.url.for.relative.links.xml</literal></para><screen><phrase role="commit-message">Added new param man.base.url.for.relative.links .. specifies a
3487 base URL for relative links (for ulink, @xlink:href, imagedata,
3488 audiodata, videodata) shown in the generated NOTES section of
3489 man-page output. The value of man.base.url.for.relative.links is
3490 prepended to any relative URI that is a value of ulink url,
3491 xlink:href, or fileref attribute.
3492
3493 If you use relative URIs in link sources in your DocBook refentry
3494 source, and you leave man.base.url.for.relative.links unset, the
3495 relative links will appear "as is" in the NOTES section of any
3496 man-page output generated from your source. That's probably not
3497 what you want, because such relative links are only usable in the
3498 context of HTML output. So, to make the links meaningful and
3499 usable in the context of man-page output, set a value for
3500 man.base.url.for.relative.links that points
3501 to the online version of HTML output generated from your DocBook
3502 refentry source. For example:
3503
3504   &lt;xsl:param name="man.base.url.for.relative.links"
3505   &gt;http://www.kernel.org/pub/software/scm/git/docs/&lt;/xsl:param&gt;</phrase></screen>
3506 </listitem>
3507 <listitem>
3508 <para><literal>Michael(tm) Smith: man.string.subst.map.xml</literal></para><screen><phrase role="commit-message">squeeze .sp\n.sp into a single .sp (to prevent a extra, spurious
3509 line of whitespace from being inserted after programlisting etc.
3510 in certain cases)</phrase></screen>
3511 </listitem>
3512 <listitem>
3513 <para><literal>Michael(tm) Smith: refentry.manual.fallback.profile.xml; refentry.source.fallback.profile.⋯</literal></para><screen><phrase role="commit-message">don't use refmiscinfo@class=date value as fallback for refentry
3514 "source" or "manual" metadata fields</phrase></screen>
3515 </listitem>
3516 <listitem>
3517 <para><literal>Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml; man.charmap.su⋯</literal></para><screen><phrase role="commit-message">made some further doc tweaks related to the
3518 man.charmap.subset.profile.english param</phrase></screen>
3519 </listitem>
3520 <listitem>
3521 <para><literal>Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml; man.charmap.su⋯</literal></para><screen><phrase role="commit-message">Added the man.charmap.subset.profile.english parameter and refined
3522 the handling of charmap subsets to differentiate between English
3523 and non-English source.
3524
3525 This way charmap subsets are now handled is this:
3526
3527 If the value of the man.charmap.use.subset parameter is non-zero,
3528 and your DocBook source is not written in English (that is, if its
3529 lang or xml:lang attribute has a value other than en), then the
3530 character-map subset specified by the man.charmap.subset.profile
3531 parameter is used instead of the full roff character map.
3532
3533 Otherwise, if the lang or xml:lang attribute on the root element
3534 in your DocBook source or on the first refentry element in your
3535 source has the value en or if it has no lang or xml:lang
3536 attribute, then the character-map subset specified by the
3537 man.charmap.subset.profile.english parameter is used instead of
3538 man.charmap.subset.profile.
3539
3540 The difference between the two subsets is that
3541 man.charmap.subset.profile provides mappings for characters in
3542 Western European languages that are not part of the Roman
3543 (English) alphabet (ASCII character set).</phrase></screen>
3544 </listitem>
3545 <listitem>
3546 <para><literal>Michael(tm) Smith: man.charmap.subset.profile.xml</literal></para><screen><phrase role="commit-message">Added to default charmap used by manpages:
3547
3548   - the "letters" part of the 'C1 Controls And Latin-1 Supplement
3549     (Latin-1 Supplement)' Unicode block
3550   - Latin Extended-A block (but not all of the characters from
3551     that block have mappings in groff, so some of them are still
3552     passed through as-is)
3553
3554 The effects of this change are that in man pages generated for
3555 most Western European languages and for Finnish, all characters
3556 not part of the Roman alphabet are (e.g., "accented" characters)
3557 are converted to groff escapes.
3558
3559 Previously, by default we passed through those characters as is
3560 (and users needed to use the full charmap if they wanted to have
3561 those characters converted).
3562
3563 As a result of this change, man pages generated for Western
3564 European languages will be viewable in some environments in which
3565 they are not viewable if the "raw" non-Roman characters are in them.</phrase></screen>
3566 </listitem>
3567 <listitem>
3568 <para><literal>Mauritz Jeanson: generate.legalnotice.link.xml; generate.revhistory.link.xml</literal></para><screen><phrase role="commit-message">Added information on how the filename is computed.</phrase></screen>
3569 </listitem>
3570 <listitem>
3571 <para><literal>Mauritz Jeanson: default.table.width.xml</literal></para><screen><phrase role="commit-message">Clarified PI usage.</phrase></screen>
3572 </listitem>
3573 <listitem>
3574 <para><literal>Michael(tm) Smith: man.funcsynopsis.style.xml</literal></para><screen><phrase role="commit-message">Added the man.funcsynopsis.style parameter. Has the same effect in
3575 manpages output as the funcsynopsis.style parameter has in HTML
3576 output -- except that its default value is 'ansi' instead of 'kr'.</phrase></screen>
3577 </listitem>
3578 <listitem>
3579 <para><literal>Michael(tm) Smith: funcsynopsis.tabular.threshold.xml</literal></para><screen><phrase role="commit-message">Removed the funcsynopsis.tabular.threshold param. It's no longer
3580 being used in the code and hasn't been since mid 2006.</phrase></screen>
3581 </listitem>
3582 <listitem>
3583 <para><literal>Mauritz Jeanson: table.properties.xml</literal></para><screen><phrase role="commit-message">Set keep-together.within-column to "auto". This seems to be the most sensible
3584 default value for tables.</phrase></screen>
3585 </listitem>
3586 <listitem>
3587 <para><literal>Mauritz Jeanson: informal.object.properties.xml; admon.graphics.extension.xml; informalequ⋯</literal></para><screen><phrase role="commit-message">Several small documentation fixes.</phrase></screen>
3588 </listitem>
3589 <listitem>
3590 <para><literal>Mauritz Jeanson: manifest.in.base.dir.xml</literal></para><screen><phrase role="commit-message">Wording fixes.</phrase></screen>
3591 </listitem>
3592 <listitem>
3593 <para><literal>Mauritz Jeanson: header.content.properties.xml; footer.content.properties.xml</literal></para><screen><phrase role="commit-message">Added refpurpose.</phrase></screen>
3594 </listitem>
3595 <listitem>
3596 <para><literal>Mauritz Jeanson: ulink.footnotes.xml; ulink.show.xml</literal></para><screen><phrase role="commit-message">Updated for DocBook 5.</phrase></screen>
3597 </listitem>
3598 <listitem>
3599 <para><literal>Mauritz Jeanson: index.method.xml; glossterm.auto.link.xml</literal></para><screen><phrase role="commit-message">Spelling and wording fixes.</phrase></screen>
3600 </listitem>
3601 <listitem>
3602 <para><literal>Mauritz Jeanson: callout.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Clarifed available graphics formats and extensions.</phrase></screen>
3603 </listitem>
3604 <listitem>
3605 <para><literal>Mauritz Jeanson: footnote.sep.leader.properties.xml</literal></para><screen><phrase role="commit-message">Corrected refpurpose.</phrase></screen>
3606 </listitem>
3607 <listitem>
3608 <para><literal>Jirka Kosek: footnote.properties.xml</literal></para><screen><phrase role="commit-message">Added more properties which make it possible to render correctly footnotes placed inside verbatim elements.</phrase></screen>
3609 </listitem>
3610 <listitem>
3611 <para><literal>Mauritz Jeanson: img.src.path.xml</literal></para><screen><phrase role="commit-message">img.src.path works with inlinegraphic too.</phrase></screen>
3612 </listitem>
3613 <listitem>
3614 <para><literal>Mauritz Jeanson: saxon.character.representation.xml</literal></para><screen><phrase role="commit-message">Added TCG link.</phrase></screen>
3615 </listitem>
3616 <listitem>
3617 <para><literal>Mauritz Jeanson: img.src.path.xml</literal></para><screen><phrase role="commit-message">Updated description of img.src.path. Bug #1785224 revealed that 
3618 there was a risk of misunderstanding how it works.</phrase></screen>
3619 </listitem>
3620 </itemizedlist>
3621 </sect2><!--end of Params changes for 1.74.0-->
3622
3623 <sect2 xml:id="V1.74.0_Profiling">
3624 <title>Profiling</title>
3625 <para>The following changes have been made to the
3626             <filename>profiling</filename> code
3627             since the 1.73.2 release.</para>
3628 <itemizedlist>
3629 <listitem>
3630 <para><literal>Jirka Kosek: xsl2profile.xsl</literal></para><screen><phrase role="commit-message">Added new rules to profile all content generated by HTML Help (including alias files)</phrase></screen>
3631 </listitem>
3632 <listitem>
3633 <para><literal>Robert Stayton: profile-mode.xsl</literal></para><screen><phrase role="commit-message">use mode="profile" instead of xsl:copy-of for attributes so
3634 they can be more easily customized.</phrase></screen>
3635 </listitem>
3636 </itemizedlist>
3637 </sect2><!--end of Profiling changes for 1.74.0-->
3638
3639
3640 <sect2 xml:id="V1.74.0_Tools">
3641 <title>Tools</title>
3642 <para>The following changes have been made to the
3643             <filename>tools</filename> code
3644             since the 1.73.2 release.</para>
3645 <itemizedlist>
3646 <listitem>
3647 <para><literal>Michael(tm) Smith: make/Makefile.DocBook</literal></para><screen><phrase role="commit-message">various changes and additions to support making with asciidoc as
3648 an input format</phrase></screen>
3649 </listitem>
3650 <listitem>
3651 <para><literal>Michael(tm) Smith: make/Makefile.DocBook</literal></para><screen><phrase role="commit-message">make dblatex the default PDF maker for the example makefile</phrase></screen>
3652 </listitem>
3653 <listitem>
3654 <para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">Reworked handling of K&amp;R funcprototype output. It no longer relies
3655 on the HTML kr-tabular templates, but instead just does direct
3656 transformation to roff. For K&amp;R output, it displays the paramdef
3657 output in an indented list following the prototype.</phrase></screen>
3658 </listitem>
3659 <listitem>
3660 <para><literal>Mauritz Jeanson: xsl/build/make-xsl-params.xsl</literal></para><screen><phrase role="commit-message">Made attribute-sets members of the param list. This enables links to attribute-sets in the
3661 reference documentation.</phrase></screen>
3662 </listitem>
3663 <listitem>
3664 <para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">use .BI handling in K&amp;R funsynopsis output for manpages, just as
3665 we do already of ANSI output</phrase></screen>
3666 </listitem>
3667 <listitem>
3668 <para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">Implemented initial support for handling tabular K&amp;R output of
3669 funcprototype in manpages output. Accomplished by adding more
3670 templates to the intermediate HTML-to-roff stylesheet that the
3671 build uses to create the manpages/html-synop.xsl stylesheet.</phrase></screen>
3672 </listitem>
3673 <listitem>
3674 <para><literal>Michael(tm) Smith: xsl/build/doc-link-docbook.xsl</literal></para><screen><phrase role="commit-message">Made the xsl/tools/xsl/build/doc-link-docbook.xsl stylesheet
3675 import profile-docbook.xsl, so that we can do profiling of release
3676 notes. Corrected some problems in the target for the release-notes
3677 HTML build.</phrase></screen>
3678 </listitem>
3679 </itemizedlist>
3680 </sect2><!--end of Tools changes for 1.74.0-->
3681
3682 <sect2 xml:id="V1.74.0_Extensions">
3683 <title>Extensions</title>
3684 <para>The following changes have been made to the
3685             <filename>extensions</filename> code
3686             since the 1.73.2 release.</para>
3687 <itemizedlist>
3688 <listitem> <para><literal>Keith Fahlgren: Makefile</literal></para><screen><phrase role="commit-message">Use DOCBOOK_SVN variable everywhere, please; build with PDF_MAKER</phrase></screen> </listitem>
3689 <listitem>
3690 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">moved extensions build targets from master xsl/Makefile to
3691 xsl/extensions/Makefile</phrase></screen>
3692 </listitem>
3693 <listitem>
3694 <para><literal>Michael(tm) Smith: .cvsignore</literal></para><screen><phrase role="commit-message">re-adding empty extensions subdir</phrase></screen>
3695 </listitem>
3696 </itemizedlist>
3697 </sect2><!--end of Extensions changes for 1.74.0-->
3698
3699 <sect2 xml:id="V1.74.0_XSL-Saxon">
3700 <title>XSL-Saxon</title>
3701 <para>The following changes have been made to the
3702             <filename>xsl-saxon</filename> code
3703             since the 1.73.2 release.</para>
3704 <itemizedlist>
3705 <listitem>
3706 <para><literal>Michael(tm) Smith: VERSION</literal></para><screen><phrase role="commit-message">bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
3707 recent change to snapshot build infrastructure</phrase></screen>
3708 </listitem>
3709 <listitem>
3710 <para><literal>Michael(tm) Smith: nbproject/build-impl.xml; nbproject/project.properties</literal></para><screen><phrase role="commit-message">Changed hard-coded file references in "clean" target to variable
3711 references. Closes #1792043. Thanks to Daniel Leidert.</phrase></screen>
3712 </listitem>
3713 <listitem>
3714 <para><literal>Michael(tm) Smith: VERSION; Makefile</literal></para><screen><phrase role="commit-message">Did post-release wrap-up of xsl-saxon and xsl-xalan dirs</phrase></screen>
3715 </listitem>
3716 <listitem>
3717 <para><literal>Michael(tm) Smith: nbproject/build-impl.xml; VERSION; Makefile; test</literal></para><screen><phrase role="commit-message">More tweaks to get release-ready</phrase></screen>
3718 </listitem>
3719 </itemizedlist>
3720 </sect2><!--end of XSL-Saxon changes for 1.74.0-->
3721
3722 <sect2 xml:id="V1.74.0_XSL-Xalan">
3723 <title>XSL-Xalan</title>
3724 <para>The following changes have been made to the
3725             <filename>xsl-xalan</filename> code
3726             since the 1.73.2 release.</para>
3727 <itemizedlist>
3728 <listitem>
3729 <para><literal>Michael(tm) Smith: VERSION</literal></para><screen><phrase role="commit-message">bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
3730 recent change to snapshot build infrastructure</phrase></screen>
3731 </listitem>
3732 <listitem>
3733 <para><literal>Michael(tm) Smith: nbproject/build-impl.xml</literal></para><screen><phrase role="commit-message">Changed hard-coded file references in "clean" target to variable
3734 references. Closes #1792043. Thanks to Daniel Leidert.</phrase></screen>
3735 </listitem>
3736 <listitem>
3737 <para><literal>Michael(tm) Smith: Makefile; VERSION</literal></para><screen><phrase role="commit-message">Did post-release wrap-up of xsl-saxon and xsl-xalan dirs</phrase></screen>
3738 </listitem>
3739 <listitem>
3740 <para><literal>Michael(tm) Smith: Makefile; nbproject/build-impl.xml; VERSION</literal></para><screen><phrase role="commit-message">More tweaks to get release-ready</phrase></screen>
3741 </listitem>
3742 </itemizedlist>
3743 </sect2><!--end of XSL-Xalan changes for 1.74.0-->
3744
3745 <sect2 xml:id="V1.74.0_XSL-libxslt">
3746 <title>XSL-libxslt</title>
3747 <para>The following changes have been made to the
3748             <filename>xsl-libxslt</filename> code
3749             since the 1.73.2 release.</para>
3750 <itemizedlist>
3751 <listitem>
3752 <para><literal>Mauritz Jeanson: python/xslt.py</literal></para><screen><phrase role="commit-message">Print the result to stdout if no outfile has been given.
3753 Some unnecessary semicolons removed.</phrase></screen>
3754 </listitem>
3755 <listitem>
3756 <para><literal>Mauritz Jeanson: python/xslt.py</literal></para><screen><phrase role="commit-message">Added a function that quotes parameter values (to ensure that they are interpreted as strings).
3757 Replaced deprecated functions from the string module with string methods.</phrase></screen>
3758 </listitem>
3759 <listitem>
3760 <para><literal>Michael(tm) Smith: python/README; python/README.LIBXSLT</literal></para><screen><phrase role="commit-message">renamed xsl-libxslt/python/README to xsl-libxslt/python/README.LIBXSLT</phrase></screen>
3761 </listitem>
3762 <listitem>
3763 <para><literal>Mauritz Jeanson: python/README</literal></para><screen><phrase role="commit-message">Tweaked the text a little.</phrase></screen>
3764 </listitem>
3765 </itemizedlist>
3766 </sect2><!--end of XSL-libxslt changes for 1.74.0-->
3767
3768 </sect1>
3769
3770 <sect1 xml:id="V1.73.2">
3771 <title>Release Notes: 1.73.2</title>
3772 <para>This is solely a minor bug-fix update to the 1.73.1 release.
3773   It fixes a packaging error in the 1.73.1 package, as well as a
3774   bug in footnote handling in FO output.</para>
3775 </sect1>
3776
3777 <sect1 xml:id="V1.73.1">
3778 <title>Release: 1.73.1</title>
3779 <para>This is mostly a bug-fix update to the 1.73.0 release.</para>
3780
3781 <sect2 xml:id="V1.73.1_Gentext">
3782 <title>Gentext</title>
3783 <para>The following changes have been made to the
3784             <filename>gentext</filename> code
3785             since the 1.73.0 release.</para>
3786 <itemizedlist>
3787 <listitem>
3788 <para><literal>Mauritz Jeanson: locale/de.xml</literal></para><screen><phrase role="commit-message">Applied patch #1766009.</phrase></screen>
3789 </listitem>
3790 <listitem>
3791 <para><literal>Michael(tm) Smith: locale/lv.xml</literal></para><screen><phrase role="commit-message">Added localization for <tag>ProductionSet</tag>.</phrase></screen>
3792 </listitem>
3793 </itemizedlist>
3794 </sect2><!--end of Gentext changes for 1.73.1-->
3795
3796 <sect2 xml:id="V1.73.1_FO">
3797 <title>FO</title>
3798 <para>The following changes have been made to the
3799             <filename>fo</filename> code
3800             since the 1.73.0 release.</para>
3801 <itemizedlist>
3802 <listitem>
3803 <para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">Modified the <tag>tgroup</tag> template so that, for tables with multiple tgroups, 
3804 a width attribute is output on all corresponding fo:tables. Previously, 
3805 there was a test prohibiting this (and a comment saying that outputting more
3806 than one width attribute will cause an error). But this seems to be no longer 
3807 relevant; it is not a problem with FOP 0.93 or XEP 4.10. Closes bug #1760559.</phrase></screen>
3808 </listitem>
3809 <listitem>
3810 <para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Replaced useless &lt;a&gt; elements with warning messages (textinsert extension).</phrase></screen>
3811 </listitem>
3812 <listitem>
3813 <para><literal>Mauritz Jeanson: admon.xsl</literal></para><screen><phrase role="commit-message">Enabled generation of ids (on fo:wrapper) for indexterms in admonition titles, so that page
3814 references in the <tag>index</tag> can be created. Closes bug #1775086.</phrase></screen>
3815 </listitem>
3816 </itemizedlist>
3817 </sect2><!--end of FO changes for 1.73.1-->
3818
3819 <sect2 xml:id="V1.73.1_HTML">
3820 <title>HTML</title>
3821 <para>The following changes have been made to the
3822             <filename>html</filename> code
3823             since the 1.73.0 release.</para>
3824 <itemizedlist>
3825 <listitem>
3826 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:call-template name="process.footnotes"/&gt; to <tag>abstract</tag> template
3827 so that footnotes in <tag>info</tag>/<tag>abstract</tag> are processed. Closes bug #1760907.</phrase></screen>
3828 </listitem>
3829 <listitem>
3830 <para><literal>Michael(tm) Smith: pi.xsl; synop.xsl</literal></para><screen><phrase role="commit-message">Changed handling of HTML output for the <tag>cmdsynopsis</tag> and
3831 <tag>funcsynopsis</tag> elements, such that a@id instances are generated for
3832 them if they are descendants of any element containing a dbcmdlist
3833 or dbfunclist PI. Also, update the embedded <tag>reference</tag> docs for the
3834 dbcmdlist and dbfunclist PIs to make it clear that they can be
3835 used within any element for which <tag>cmdsynopsis</tag> or <tag>funcsynopsis</tag> are
3836 valid children.</phrase></screen>
3837 </listitem>
3838 <listitem>
3839 <para><literal>Michael(tm) Smith: formal.xsl</literal></para><screen><phrase role="commit-message">Reverted the part of <tag>revision</tag> 6952 that caused a@id anchors to be
3840 generated for output of informal objects. Thanks to Sam Steingold
3841 for reporting.</phrase></screen>
3842 </listitem>
3843 <listitem>
3844 <para><literal>Robert Stayton: glossary.xsl</literal></para><screen><phrase role="commit-message">Account for a <tag>glossary</tag> with no <tag>glossdiv</tag> or <tag>glossentry</tag> children.</phrase></screen>
3845 </listitem>
3846 <listitem>
3847 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Modified <tag>legalnotice</tag> template so that the base.name parameter is calculated 
3848 in the same way as for <tag>revhistory</tag> chunks. Using &lt;xsl:apply-templates 
3849 mode="chunk-filename" select="."/&gt; did not work for single-page output since
3850 the template with that mode is in chunk-code.xsl.</phrase></screen>
3851 </listitem>
3852 <listitem>
3853 <para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Updated support for SVG (must be a child of <tag>imagedata</tag> in DB 5).
3854 Added support for MathML in <tag>imagedata</tag>.</phrase></screen>
3855 </listitem>
3856 <listitem>
3857 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Added documentation for the dbhh PI (used for context-sensitive HTML Help).
3858 (The two templates matching 'dbhh' are still in htmlhelp-common.xsl).</phrase></screen>
3859 </listitem>
3860 </itemizedlist>
3861 </sect2><!--end of HTML changes for 1.73.1-->
3862
3863 <sect2 xml:id="V1.73.1_Manpages">
3864 <title>Manpages</title>
3865 <para>The following changes have been made to the
3866             <filename>manpages</filename> code
3867             since the 1.73.0 release.</para>
3868 <itemizedlist>
3869 <listitem>
3870 <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">In manpages output, generate warnings about notesources with
3871 non-para children only if the notesource is a <tag>footnote</tag> or
3872 <tag>annotation</tag>. Thanks to Sam Steingold for reporting problems with
3873 the existing handling.</phrase></screen>
3874 </listitem>
3875 </itemizedlist>
3876 </sect2><!--end of Manpages changes for 1.73.1-->
3877
3878 <sect2 xml:id="V1.73.1_HTMLHelp">
3879 <title>HTMLHelp</title>
3880 <para>The following changes have been made to the
3881             <filename>htmlhelp</filename> code
3882             since the 1.73.0 release.</para>
3883 <itemizedlist>
3884 <listitem>
3885 <para><literal>Michael(tm) Smith: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
3886 eclipse, and javahelp stylesheets.</phrase></screen>
3887 </listitem>
3888 </itemizedlist>
3889 </sect2><!--end of HTMLHelp changes for 1.73.1-->
3890
3891 <sect2 xml:id="V1.73.1_Eclipse">
3892 <title>Eclipse</title>
3893 <para>The following changes have been made to the
3894             <filename>eclipse</filename> code
3895             since the 1.73.0 release.</para>
3896 <itemizedlist>
3897 <listitem>
3898 <para><literal>Michael(tm) Smith: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
3899 eclipse, and javahelp stylesheets.</phrase></screen>
3900 </listitem>
3901 </itemizedlist>
3902 </sect2><!--end of Eclipse changes for 1.73.1-->
3903
3904 <sect2 xml:id="V1.73.1_JavaHelp">
3905 <title>JavaHelp</title>
3906 <para>The following changes have been made to the
3907             <filename>javahelp</filename> code
3908             since the 1.73.0 release.</para>
3909 <itemizedlist>
3910 <listitem>
3911 <para><literal>Michael(tm) Smith: javahelp.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
3912 eclipse, and javahelp stylesheets.</phrase></screen>
3913 </listitem>
3914 </itemizedlist>
3915 </sect2><!--end of JavaHelp changes for 1.73.1-->
3916
3917 <sect2 xml:id="V1.73.1_Roundtrip">
3918 <title>Roundtrip</title>
3919 <para>The following changes have been made to the
3920             <filename>roundtrip</filename> code
3921             since the 1.73.0 release.</para>
3922 <itemizedlist>
3923 <listitem>
3924 <para><literal>Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; pages2normalise.xsl</literal></para><screen><phrase role="commit-message">Modularised blocks2dbk to allow customisation,
3925 Added support for tables to pages2normalise</phrase></screen>
3926 </listitem>
3927 </itemizedlist>
3928 </sect2><!--end of Roundtrip changes for 1.73.1-->
3929
3930 <sect2 xml:id="V1.73.1_Params">
3931 <title>Params</title>
3932 <para>The following changes have been made to the
3933             <filename>params</filename> code
3934             since the 1.73.0 release.</para>
3935 <itemizedlist>
3936 <listitem>
3937 <para><literal>Robert Stayton: procedure.properties.xml</literal></para><screen><phrase role="commit-message"><tag>procedure</tag> was inheriting keep-together from formal.object.properties, but
3938 a <tag>procedure</tag> does not need to be kept together by default.</phrase></screen>
3939 </listitem>
3940 <listitem>
3941 <para><literal>Dave Pawson: title.font.family.xml; component.label.includes.part.label.xml; table.frame.b⋯</literal></para><screen><phrase role="commit-message">Regular formatting re-org.</phrase></screen>
3942 </listitem>
3943 </itemizedlist>
3944 </sect2><!--end of Params changes for 1.73.1-->
3945 </sect1>
3946
3947 <sect1 xml:id="V1.73.0">
3948 <title>Release: 1.73.0</title>
3949 <para>This release includes important bug fixes and adds the following
3950 significant feature changes:
3951 <variablelist>
3952   <varlistentry>
3953     <term>New localizations and localization updates</term>
3954     <listitem>
3955       <para>We added two new localizations: Latvian and
3956         Esperanto, and made updates to the Czech, Chinese
3957         Simplified, Mongolian, Serbian, Italian, and Ukrainian
3958         localizations.</para>
3959     </listitem>
3960   </varlistentry>
3961   <varlistentry>
3962     <term>ISO690 citation style for bibliography output.</term>
3963     <listitem>
3964       <para>Set the
3965         <parameter>bibliography.style</parameter> parameter to
3966         <literal>iso690</literal> to use ISO690 style.</para>
3967     </listitem>
3968   </varlistentry>
3969   <varlistentry>
3970     <term>New documentation for processing instructions (PI)</term>
3971     <listitem>
3972       <para>The reference documentation that ships with the
3973         release now includes <link
3974           xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/pi/"
3975           >documentation on all PIs</link> that you can use to
3976         control output from the stylesheets.</para>
3977     </listitem>
3978   </varlistentry>
3979   <varlistentry>
3980     <term>New profiling parameters for <literal>audience</literal> and <literal>wordsize</literal></term>
3981     <listitem>
3982       <para>You can now do profiling based on the values of the
3983         <literal>audience</literal> and
3984         <literal>wordsize</literal> attributes.</para>
3985     </listitem>
3986   </varlistentry>
3987   <varlistentry>
3988     <term>Changes to man-page output</term>
3989     <listitem>
3990       <para>The manpages stylesheet now supports single-pass
3991         profiling and single-pass DocBook 5 namespace stripping
3992         (just as the HTML and FO stylesheets also do). Also, added
3993         handling for <tag>mediaobject</tag> &amp;
3994         <tag>inlinemediaobject</tag>. (Each <tag>imagedata</tag>,
3995         <tag>audiodata</tag>, or <tag>videodata</tag> element
3996         within a <tag>mediaobject</tag> or inline
3997         <tag>mediaobject</tag> is now treated as a "notesource"
3998         and so handled in much the same way as links and
3999         <tag>annotation</tag>/<tag>alt</tag>/<tag>footnote</tag>
4000         are in manpages output.) And added the
4001         <parameter>man.authors.section.enabled</parameter> and
4002         <parameter>man.copyright.section.enabled</parameter>
4003         parameters to enable control over whether output includes
4004         auto-generated <literal>AUTHORS</literal> and
4005         <literal>COPYRIGHT</literal> sections.</para>
4006     </listitem>
4007   </varlistentry>
4008   <varlistentry>
4009     <term>Highlighting support for C</term>
4010     <listitem>
4011       <para>The highlighting mechanism for generating
4012         syntax-highlighted code snippets in output now supports C
4013         code listings (along with Java, PHP, XSLT, and others).</para>
4014     </listitem>
4015   </varlistentry>
4016   <varlistentry>
4017     <term>Experimental <literal>docbook-xsl-update script</literal></term>
4018     <listitem>
4019       <para>We added an experimental <literal>docbook-xsl-update
4020           script</literal>, the purpose of which is to facilitate
4021         easy sync-up to the latest docbook-xsl snapshot (by means
4022         of rsync).</para>
4023     </listitem>
4024   </varlistentry>
4025 </variablelist> 
4026 </para>
4027
4028 <sect2 xml:id="V1.73.0_Gentext">
4029 <title>Gentext</title>
4030 <para>The following changes have been made to the
4031 <filename>gentext</filename> code
4032 since the 1.72.0 release.</para>
4033 <itemizedlist>
4034 <listitem>
4035 <para><literal>Michael(tm) Smith: locale/lv.xml; Makefile</literal></para><screen><phrase role="commit-message">Added Latvian localization file, from Girts Ziemelis.</phrase></screen>
4036 </listitem>
4037 <listitem>
4038 <para><literal>Dongsheng Song: locale/zh_cn.xml</literal></para><screen><phrase role="commit-message">Brought up to <tag>date</tag> with en.xml in terms of items. A few strings marked for translation.</phrase></screen>
4039 </listitem>
4040 <listitem>
4041 <para><literal>Jirka Kosek: locale/cs.xml</literal></para><screen><phrase role="commit-message">Added missing translations</phrase></screen>
4042 </listitem>
4043 <listitem>
4044 <para><literal>Robert Stayton: locale/eo.xml</literal></para><screen><phrase role="commit-message">New locale for Esperanto.</phrase></screen>
4045 </listitem>
4046 <listitem>
4047 <para><literal>Robert Stayton: locale/mn.xml</literal></para><screen><phrase role="commit-message">Update from Ganbold Tsagaankhuu.</phrase></screen>
4048 </listitem>
4049 <listitem>
4050 <para><literal>Jirka Kosek: locale/en.xml; locale/cs.xml</literal></para><screen><phrase role="commit-message">Rules for normalizing <tag>glossary</tag> entries before they are sorted can be now different for each language.</phrase></screen>
4051 </listitem>
4052 <listitem>
4053 <para><literal>Michael(tm) Smith: locale/sr_Latn.xml; locale/sr.xml</literal></para><screen><phrase role="commit-message">Committed changes from Miloš Komarčević to Serbian files.</phrase></screen>
4054 </listitem>
4055 <listitem>
4056 <para><literal>Robert Stayton: locale/ja.xml</literal></para><screen><phrase role="commit-message">Fix <tag>chapter</tag> in context xref-number-and-title</phrase></screen>
4057 </listitem>
4058 <listitem>
4059 <para><literal>Robert Stayton: locale/it.xml</literal></para><screen><phrase role="commit-message">Improved version from contributor.</phrase></screen>
4060 </listitem>
4061 <listitem>
4062 <para><literal>Mauritz Jeanson: locale/uk.xml</literal></para><screen><phrase role="commit-message">Applied patch 1592083.</phrase></screen>
4063 </listitem>
4064 </itemizedlist>
4065 </sect2><!--end of Gentext changes for 1.73.0-->
4066 <sect2 xml:id="V1.73.0_Common">
4067 <title>Common</title>
4068 <para>The following changes have been made to the
4069 <filename>common</filename> code
4070 since the 1.72.0 release.</para>
4071 <itemizedlist>
4072 <listitem>
4073 <para><literal>Michael(tm) Smith: labels.xsl</literal></para><screen><phrase role="commit-message">Changed handling of <tag>reference</tag> auto-labeling such that <tag>reference</tag>
4074 (when it appears at the component level) is now affected by the
4075 <parameter>label.from.part</parameter> param, just as <tag>preface</tag>, <tag>chapter</tag>, and <tag>appendix</tag>.</phrase></screen>
4076 </listitem>
4077 <listitem>
4078 <para><literal>Michael(tm) Smith: common.xsl</literal></para><screen><phrase role="commit-message">Added support to the HTML stylesheets for proper processing of
4079 <tag>orgname</tag> as a child of <tag>author</tag>.</phrase></screen>
4080 </listitem>
4081 <listitem>
4082 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Refined logging output of <tag>refentry</tag> metadata-gathering template;
4083 for some cases of "missing" elements (<tag>refmiscinfo</tag> stuff, etc.),
4084 the log messages now include URL to corresponding page in the
4085 Definitive Guide (TDG).</phrase></screen>
4086 </listitem>
4087 <listitem>
4088 <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Add <tag>refsection</tag>/<tag>info</tag>/<tag>title</tag> support.</phrase></screen>
4089 </listitem>
4090 <listitem>
4091 <para><literal>Michael(tm) Smith: titles.xsl</literal></para><screen><phrase role="commit-message">Added support for correct handling of <tag>xref</tag> to elements that
4092 contain <tag>info</tag>/<tag>title</tag> descendants but no <tag>title</tag> children.
4093
4094 This should be further refined so that it handles any *<tag>info</tag>
4095 elements. And there are probably some other places where similar
4096 handling for *<tag>info</tag>/<tag>title</tag> should be added.</phrase></screen>
4097 </listitem>
4098 <listitem>
4099 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Modified &lt;xsl:when&gt; in datetime.format template to work
4100 around Xalan bug.</phrase></screen>
4101 </listitem>
4102 </itemizedlist>
4103 </sect2><!--end of Common changes for 1.73.0-->
4104 <sect2 xml:id="V1.73.0_FO">
4105 <title>FO</title>
4106 <para>The following changes have been made to the
4107 <filename>fo</filename> code
4108 since the 1.72.0 release.</para>
4109 <itemizedlist>
4110 <listitem>
4111 <para><literal>Robert Stayton: component.xsl</literal></para><screen><phrase role="commit-message">Add parameters to the page.sequence utility template.</phrase></screen>
4112 </listitem>
4113 <listitem>
4114 <para><literal>Mauritz Jeanson: xref.xsl</literal></para><screen><phrase role="commit-message">Added template for <tag>xref</tag> to <tag>area</tag>/<tag>areaset</tag>.
4115 Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
4116 </listitem>
4117 <listitem>
4118 <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">Added template match for <tag>person</tag> element to fo stylesheet.</phrase></screen>
4119 </listitem>
4120 <listitem>
4121 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Added support for spacing="compact" in <tag>variablelist</tag>, per bug report #1722540.</phrase></screen>
4122 </listitem>
4123 <listitem>
4124 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message"><tag>table</tag> pgwide="1" should also use pgwide.properties attribute-set.</phrase></screen>
4125 </listitem>
4126 <listitem>
4127 <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Make citations numbered if <parameter>bibliography.numbered</parameter> != 0.</phrase></screen>
4128 </listitem>
4129 <listitem>
4130 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new profiling parameters for audience and wordsize.</phrase></screen>
4131 </listitem>
4132 <listitem>
4133 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added <parameter>callout.icon.size</parameter> parameter.</phrase></screen>
4134 </listitem>
4135 <listitem>
4136 <para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add support for xlink as <tag>olink</tag>.</phrase></screen>
4137 </listitem>
4138 <listitem>
4139 <para><literal>Robert Stayton: autotoc.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add support for <parameter>qanda.in.toc</parameter> to fo <tag>TOC</tag>.</phrase></screen>
4140 </listitem>
4141 <listitem>
4142 <para><literal>Robert Stayton: component.xsl</literal></para><screen><phrase role="commit-message">Improved the page.sequence utility template for use with <tag>book</tag>.</phrase></screen>
4143 </listitem>
4144 <listitem>
4145 <para><literal>Robert Stayton: division.xsl</literal></para><screen><phrase role="commit-message">Refactored the big <tag>book</tag> template into smaller pieces.
4146 Used the "page.sequence" utility template in
4147 component.xsl to shorten the <tag>toc</tag> piece.
4148 Added placeholder templates for front.cover and back.cover.</phrase></screen>
4149 </listitem>
4150 <listitem>
4151 <para><literal>Robert Stayton: param.xweb; param.ent; sections.xsl</literal></para><screen><phrase role="commit-message">Add <parameter>section.container.element</parameter> parameter to enable
4152 pgwide spans inside sections.</phrase></screen>
4153 </listitem>
4154 <listitem>
4155 <para><literal>Robert Stayton: param.xweb; param.ent; component.xsl</literal></para><screen><phrase role="commit-message">Add component.titlepage.properties attribute-set to
4156 support span="all" and other properties.</phrase></screen>
4157 </listitem>
4158 <listitem>
4159 <para><literal>Robert Stayton: htmltbl.xsl; table.xsl</literal></para><screen><phrase role="commit-message">Apply table.row.properties template to html <tag>tr</tag> rows too.
4160 Add keep-with-next to table.row.properties when <tag>row</tag> is in <tag>thead</tag>.</phrase></screen>
4161 </listitem>
4162 <listitem>
4163 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support for <parameter>default.table.frame</parameter> parameter.
4164 Fix bug 1575446 rowsep last check for @morerows.</phrase></screen>
4165 </listitem>
4166 <listitem>
4167 <para><literal>Robert Stayton: refentry.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>info</tag>/<tag>title</tag> in refsections.</phrase></screen>
4168 </listitem>
4169 <listitem>
4170 <para><literal>David Cramer: qandaset.xsl</literal></para><screen><phrase role="commit-message">Make fo questions and answers behave the same way as html</phrase></screen>
4171 </listitem>
4172 <listitem>
4173 <para><literal>Jirka Kosek: lists.xsl</literal></para><screen><phrase role="commit-message">Added missing attribute set for <tag>procedure</tag></phrase></screen>
4174 </listitem>
4175 <listitem>
4176 <para><literal>Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent; biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Added support for formatting biblioentries according to ISO690 <tag>citation</tag> style.
4177 New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
4178 The code was provided by Jana Dvorakova</phrase></screen>
4179 </listitem>
4180 <listitem>
4181 <para><literal>Robert Stayton: param.xweb; param.ent; pagesetup.xsl</literal></para><screen><phrase role="commit-message">Add header.table.properties and footer.table.properties attribute-sets.</phrase></screen>
4182 </listitem>
4183 <listitem>
4184 <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Add <parameter>fop1.extensions</parameter> for <tag>menuchoice</tag> arrow handling exception.</phrase></screen>
4185 </listitem>
4186 </itemizedlist>
4187 </sect2><!--end of FO changes for 1.73.0-->
4188 <sect2 xml:id="V1.73.0_HTML">
4189 <title>HTML</title>
4190 <para>The following changes have been made to the
4191             <filename>html</filename> code
4192             since the 1.72.0 release.</para>
4193 <itemizedlist>
4194 <listitem>
4195 <para><literal>Mauritz Jeanson: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Moved declaration and documentation of <parameter>javahelp.encoding</parameter> from javahelp.xsl to the
4196 regular "parameter machinery".</phrase></screen>
4197 </listitem>
4198 <listitem>
4199 <para><literal>Michael(tm) Smith: admon.xsl</literal></para><screen><phrase role="commit-message">Changed handling of titles for note, warning, <tag>caution</tag>, <tag>important</tag>,
4200 <tag>tip</tag> admonitions: We now output and HTML h3 head only if
4201 <parameter>admon.textlabel</parameter> is non-zero or if the admonition actually contains
4202 a <tag>title</tag>; otherwise, we don't output an h3 head at all.
4203 (Previously, we were outputting an empty h3 if the <parameter>admon.textlabel</parameter>
4204 was zero and if the admonition had no title.)</phrase></screen>
4205 </listitem>
4206 <listitem>
4207 <para><literal>Mauritz Jeanson: xref.xsl</literal></para><screen><phrase role="commit-message">Added template for <tag>xref</tag> to <tag>area</tag>/<tag>areaset</tag>.
4208 Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
4209 </listitem>
4210 <listitem>
4211 <para><literal>Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; sections.xsl</literal></para><screen><phrase role="commit-message">Added fixes to avoid duplicate ids when <parameter>generate.id.attributes</parameter> = 1.
4212 This (hopefully) closes bug #1671052.</phrase></screen>
4213 </listitem>
4214 <listitem>
4215 <para><literal>Michael(tm) Smith: formal.xsl; pi.xsl</literal></para><screen><phrase role="commit-message">Made the dbfunclist PI work as intended. Also added doc for
4216 dbfunclist and dbcmdlist PIs.</phrase></screen>
4217 </listitem>
4218 <listitem>
4219 <para><literal>Michael(tm) Smith: pi.xsl; synop.xsl</literal></para><screen><phrase role="commit-message">Made the dbcmdlist work the way it appears to have been intended
4220 to work. Restored dbhtml-dir template back to pi.xsl.</phrase></screen>
4221 </listitem>
4222 <listitem>
4223 <para><literal>Michael(tm) Smith: titlepage.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added new param <parameter>abstract.notitle.enabled</parameter>.
4224 If non-zero, in output of the <tag>abstract</tag> element on titlepages,
4225 display of the <tag>abstract</tag> <tag>title</tag> is suppressed.
4226 Because sometimes you really don't want or need that <tag>title</tag>
4227 there...</phrase></screen>
4228 </listitem>
4229 <listitem>
4230 <para><literal>Michael(tm) Smith: chunk-code.xsl; graphics.xsl</literal></para><screen><phrase role="commit-message">When we are chunking long descriptions for <tag>mediaobject</tag> instances
4231 into separate HTML output files, and <parameter>use.id.as.filename</parameter> is
4232 non-zero, if a <tag>mediaobject</tag> has an ID, use that ID as the basename
4233 for the long-description file (otherwise, we generate an ID for it
4234 and use that ID as the basename for the file).
4235 The parallels the recent change made to cause IDs for <tag>legalnotice</tag>
4236 instances to be used as basenames for <tag>legalnotice</tag> chunks.
4237 Also, made some minor refinements to the recent changes for
4238 <tag>legalnotice</tag> chunk handling.</phrase></screen>
4239 </listitem>
4240 <listitem>
4241 <para><literal>Michael(tm) Smith: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added support to the HTML stylesheets for proper processing of
4242 <tag>orgname</tag> as a child of <tag>author</tag>.</phrase></screen>
4243 </listitem>
4244 <listitem>
4245 <para><literal>Michael(tm) Smith: chunk-code.xsl</literal></para><screen><phrase role="commit-message">When $generate.legalnotice.link is non-zero and
4246 $use.id.as.filename is also non-zero, if a <tag>legalnotice</tag> has an ID,
4247 then instead of assigning the "ln-&lt;generatedID&gt;" basename to the
4248 output file for that <tag>legalnotice</tag>, just use its real ID as the
4249 basename for the file -- as we do when chunking other elements
4250 that have IDs.</phrase></screen>
4251 </listitem>
4252 <listitem>
4253 <para><literal>David Cramer: xref.xsl</literal></para><screen><phrase role="commit-message">Handle <tag>alt</tag> text on xrefs to steps when the step doesn't have a <tag>title</tag>.</phrase></screen>
4254 </listitem>
4255 <listitem>
4256 <para><literal>David Cramer: lists.xsl</literal></para><screen><phrase role="commit-message">Added &lt;p&gt; element around <tag>term</tag> in <tag>variablelist</tag> when formatted as <tag>table</tag> to avoid misalignment of <tag>term</tag> and <tag>listitem</tag> in xhtml (non-quirks mode) output</phrase></screen>
4257 </listitem>
4258 <listitem>
4259 <para><literal>David Cramer: qandaset.xsl</literal></para><screen><phrase role="commit-message">Added &lt;p&gt; element around <tag>question</tag> and <tag>answer</tag> labels to avoid misalignment of <tag>label</tag> and <tag>listitem</tag> in xhtml (non-quirks mode) output</phrase></screen>
4260 </listitem>
4261 <listitem>
4262 <para><literal>David Cramer: lists.xsl</literal></para><screen><phrase role="commit-message">Added &lt;p&gt; element around callouts to avoid misalignment of <tag>callout</tag> and <tag>listitem</tag> in xhtml (non-quirks mode) output</phrase></screen>
4263 </listitem>
4264 <listitem>
4265 <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Make citations numbered if <parameter>bibliography.numbered</parameter> != 0.</phrase></screen>
4266 </listitem>
4267 <listitem>
4268 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add support for new profiling attributes audience and wordsize.</phrase></screen>
4269 </listitem>
4270 <listitem>
4271 <para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add support for xlink olinks.</phrase></screen>
4272 </listitem>
4273 <listitem>
4274 <para><literal>Jirka Kosek: glossary.xsl</literal></para><screen><phrase role="commit-message">Rules for normalizing <tag>glossary</tag> entries before they are sorted can be now different for each language.</phrase></screen>
4275 </listitem>
4276 <listitem>
4277 <para><literal>Robert Stayton: chunk-common.xsl; chunk-code.xsl; manifest.xsl; chunk.xsl</literal></para><screen><phrase role="commit-message">Refactored the chunking modules to move all named templates to
4278 chunk-common.xsl and all match templates to chunk-code.xsl, in
4279 order to enable better chunk customization.
4280 See the comments in chunk.xsl for more details.</phrase></screen>
4281 </listitem>
4282 <listitem>
4283 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Add <tag>anchor</tag> for xml:id for <tag>listitem</tag> in <tag>varlistentry</tag>.</phrase></screen>
4284 </listitem>
4285 <listitem>
4286 <para><literal>Robert Stayton: refentry.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>info</tag>/<tag>title</tag> in refsections for db5.</phrase></screen>
4287 </listitem>
4288 <listitem>
4289 <para><literal>Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent; biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Added support for formatting biblioentries according to ISO690 <tag>citation</tag> style.
4290 New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
4291 The code was provided by Jana Dvorakova</phrase></screen>
4292 </listitem>
4293 <listitem>
4294 <para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add call to class.attribute to &lt;a&gt; output elements so they can
4295 have a class value too.</phrase></screen>
4296 </listitem>
4297 <listitem>
4298 <para><literal>Mauritz Jeanson: glossary.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1644881:
4299 * Added curly braces around all $language attribute values. 
4300 * Moved declaration of language variable to top level of stylesheet.
4301 Tested with Xalan, Saxon, and xsltproc.</phrase></screen>
4302 </listitem>
4303 </itemizedlist>
4304 </sect2><!--end of HTML changes for 1.73.0-->
4305 <sect2 xml:id="V1.73.0_Manpages">
4306 <title>Manpages</title>
4307 <para>The following changes have been made to the
4308             <filename>manpages</filename> code
4309             since the 1.72.0 release.</para>
4310 <itemizedlist>
4311 <listitem>
4312 <para><literal>Michael(tm) Smith: param.xweb; docbook.xsl; param.ent</literal></para><screen><phrase role="commit-message">Added the <parameter>man.authors.section.enabled</parameter> and
4313 <parameter>man.copyright.section.enabled</parameter> parameters. Set those to zero when
4314 you want to suppress display of the auto-generated AUTHORS and
4315 <tag>COPYRIGHT</tag> sections. Closes request #1467806. Thanks to Daniel
4316 Leidert.</phrase></screen>
4317 </listitem>
4318 <listitem>
4319 <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">Took the test that the manpages stylesheet does to see if there
4320 are any <tag>Refentry</tag> chilren in current doc, and made it
4321 namespace-agnostic. Reason for that is because the test otherwise
4322 won't work when it is copied over into the generated
4323 profile-docbook.xsl stylesheet.</phrase></screen>
4324 </listitem>
4325 <listitem>
4326 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">Added a manpages/profile-docbook.xsl file to enable single-pass
4327 profiling for manpages output.</phrase></screen>
4328 </listitem>
4329 <listitem>
4330 <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">Output <tag>copyright</tag> and <tag>legalnotice</tag> in man-page output in whatever
4331 place they are in in document order. Closes #1690539. Thanks to
4332 Daniel Leidert for reporting.</phrase></screen>
4333 </listitem>
4334 <listitem>
4335 <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">Restored support for single-pass namespace stripping to manpages
4336 stylesheet.</phrase></screen>
4337 </listitem>
4338 <listitem>
4339 <para><literal>Michael(tm) Smith: synop.xsl; block.xsl; info.xsl; inline.xsl; lists.xsl; endnotes.xsl; ut⋯</literal></para><screen><phrase role="commit-message">Changed handling of bold and italic/underline output in manpages
4340 output. Should be transparent to users, but...
4341
4342 This touches handling of all bold and italic/underline output. The
4343 exact change is that the mode="bold" and mode="italic" utility
4344 templates were changed to named templates. (I think maybe I've
4345 changed it back and forth from mode to named before, so this is
4346 maybe re-reverting it yet again).
4347
4348 Anyway, the reason for the change is that the templates are
4349 sometimes call on dynamically node-sets, and using modes to format
4350 those doesn't allow passing <tag>info</tag> about the current/real context
4351 node from the source (not the node-set created by the stylesheet)
4352 to that formatting stage.
4353
4354 The named templates allow the context to be passed in as a
4355 parameter, so that the bold/ital formatting template can use
4356 context-aware condition checking.
4357
4358 This was basically necessary in order to suppress bold formatting
4359 in titles, which otherwise gets screwed up because of the numbnut
4360 way that roff handles nested bold/ital.
4361
4362 Closes #1674534). Much thanks to Daniel Leidert, whose in his
4363 docbook-xsl bug-finding kung-fu has achieved Grand Master status.</phrase></screen>
4364 </listitem>
4365 <listitem>
4366 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">Fixed handling of example instances by adding the example element
4367 to the same template we use for processing <tag>figure</tag>. Closes
4368 #1674538. Thanks to Daniel Leidert.</phrase></screen>
4369 </listitem>
4370 <listitem>
4371 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">Don't include lang in manpages <tag>filename</tag>/pathname if lang=en (that
4372 is, only generate lang-qualified file-/pathnames for non-English).</phrase></screen>
4373 </listitem>
4374 <listitem>
4375 <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">In manpages output, emit warnings for notesources (<tag>footnote</tag>, etc.)
4376 that have something other than <tag>para</tag> as a child.
4377
4378 The numbered-with-hanging-indent formatting that's used for
4379 rendering endnotes in the NOTES <tag>section</tag> of man pages places some
4380 limits/assumptions on how the DocBook source is marked up; namely,
4381 for notesources (<tag>footnote</tag>, <tag>annotation</tag>, etc.) that can contain
4382 block-level children, if the they have a block-level child such as
4383 a <tag>table</tag> or <tag>itemizedlist</tag> or <tag>orderedlist</tag> that is the first child of
4384 a <tag>footnote</tag>, we have no way of rendering/indenting its content
4385 properly in the endnotes list.
4386
4387 Thus, the manpages stylesheet not emits a warning message for that
4388 case, and suggests the "fix" (which is to wrap the <tag>table</tag> or
4389 <tag>itemizedlist</tag> or whatever in a <tag>para</tag> that has some preferatory text.</phrase></screen>
4390 </listitem>
4391 <listitem>
4392 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">Added support to mixed-block template for handling tables in
4393 mixed-blocks (e.g., as child of <tag>para</tag>) correctly.</phrase></screen>
4394 </listitem>
4395 <listitem>
4396 <para><literal>Michael(tm) Smith: table.xsl; synop.xsl; block.xsl; info.xsl; lists.xsl; refentry.xsl; end⋯</literal></para><screen><phrase role="commit-message">Reverted necessary escaping of backslash, dot, and dash
4397 out of the well-intentioned (but it now appears,
4398 misguided) "marker" mechanism (introduced in the 1.72.0
4399 release) -- which made use of alternative "marker"
4400 characters as internal representations of those
4401 characters, and then replaced them just prior to
4402 serialization -- and back into what's basically the
4403 system that was used prior to the 1.69.0 release; that
4404 is, into a part of stylesheet code that gets executed
4405 at the beginning of processing -- before any other roff
4406 markup up is. This change obviates the need for the
4407 marker system. It also requires a lot less RAM during
4408 processing (for large files, the marker mechanism
4409 ending up requiring gigabytes of memory).
4410
4411 Closes bug #1661177. Thanks to Scott Smedley for
4412 providing a test case (the fvwm man page) that exposed
4413 the problem with the marker mechanism.
4414
4415 Also moved the mechanism for converting non-breaking
4416 spaces back into the same <tag>area</tag> of the stylesheet code.</phrase></screen>
4417 </listitem>
4418 <listitem>
4419 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed problem with incorrect formatting of nested <tag>variablelist</tag>.
4420 Closes bug #1650931. Thanks to Daniel "Eagle Eye" Leidert.</phrase></screen>
4421 </listitem>
4422 <listitem>
4423 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Make sure that all listitems in <tag>itemizedlist</tag> and <tag>orderedlist</tag> are
4424 preceded by a blank line. This fixes a regression that occurred
4425 when instances of the TP macro that were use in a previous
4426 versions of the list-handling code were switched to RS/RE (because
4427 TP doesn't support nesting). TP automatically generates a blank
4428 line, but RS doesn't. So I added a .sp before each .RS</phrase></screen>
4429 </listitem>
4430 <listitem>
4431 <para><literal>Michael(tm) Smith: block.xsl; inline.xsl; param.xweb; docbook.xsl; links.xsl; param.ent</literal></para><screen><phrase role="commit-message">Made a number of changes related to elements with
4432 out-of-line content:
4433
4434 - Added handling for <tag>mediaobject</tag> &amp; <tag>inlinemediaobject</tag>.
4435   Each <tag>imagedata</tag>, <tag>audiodata</tag>, or <tag>videodata</tag> element
4436   within a <tag>mediaobject</tag> or inline <tag>mediaobject</tag> is now
4437   treated as a "notesource" and so handled in much the
4438   same way as links and <tag>annotation</tag>/<tag>alt</tag>/footnotes.
4439
4440   That means a numbered marker is generated inline to
4441   mark the place in the main flow where the <tag>imagedata</tag>,
4442   <tag>audiodata</tag>, or <tag>videodata</tag> element occurs, and a
4443   corresponding numbered endnote for it is generated in
4444   the endnotes list at the end of the man page; the
4445   endnote contains the URL from the fileref attribute
4446   of the <tag>imagedata</tag>, <tag>audiodata</tag>, or <tag>videodata</tag> element.
4447
4448   For mediobject and <tag>inlinemediaobject</tag> instances that
4449   have a <tag>textobject</tag> child, the <tag>textobject</tag> is displayed
4450   within the main text flow.
4451
4452 - Renamed several man.link.* params to man.endnotes.*,
4453   to reflect that fact that the endnotes list now
4454   contains more than just links. Also did similar
4455   renaming for a number of stylesheet-internal vars.
4456
4457 - Added support for xlink:href (along with existing
4458   support for the legacy ulink element).
4459
4460 - Cleaned up and streamlined the endnotes-handling
4461   code. It's still messy and klunky and the basic
4462   mechanism it uses is very inefficent for documents
4463   that contain a lot of notesources, but at least it's
4464   a bit better than it was.</phrase></screen>
4465 </listitem>
4466 </itemizedlist>
4467 </sect2><!--end of Manpages changes for 1.73.0-->
4468 <sect2 xml:id="V1.73.0_Eclipse">
4469 <title>Eclipse</title>
4470 <para>The following changes have been made to the
4471             <filename>eclipse</filename> code
4472             since the 1.72.0 release.</para>
4473 <itemizedlist>
4474 <listitem>
4475 <para><literal>Mauritz Jeanson: Makefile</literal></para><screen><phrase role="commit-message">Fixed bug #1715093: Makefile for creating profiled version of eclipse.xsl added.</phrase></screen>
4476 </listitem>
4477 <listitem>
4478 <para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space around  to avoid leading whitespace from appearing in the output if there's extra leading whitespace (e.g. &lt;<tag>title</tag>&gt; Foo&lt;/<tag>title</tag>&gt;) in the source</phrase></screen>
4479 </listitem>
4480 </itemizedlist>
4481 </sect2><!--end of Eclipse changes for 1.73.0-->
4482 <sect2 xml:id="V1.73.0_JavaHelp">
4483 <title>JavaHelp</title>
4484 <para>The following changes have been made to the
4485             <filename>javahelp</filename> code
4486             since the 1.72.0 release.</para>
4487 <itemizedlist>
4488 <listitem>
4489 <para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Implemented FR #1230233 (sorted <tag>index</tag> in javahelp).</phrase></screen>
4490 </listitem>
4491 <listitem>
4492 <para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space() around titles and <tag>index</tag> entries to work around whitespace problems.
4493 Added support for <tag>glossary</tag> and <tag>bibliography</tag> in <tag>toc</tag> and map files.</phrase></screen>
4494 </listitem>
4495 </itemizedlist>
4496 </sect2><!--end of JavaHelp changes for 1.73.0-->
4497 <sect2 xml:id="V1.73.0_Roundtrip">
4498 <title>Roundtrip</title>
4499 <para>The following changes have been made to the
4500             <filename>roundtrip</filename> code
4501             since the 1.72.0 release.</para>
4502 <itemizedlist>
4503 <listitem>
4504 <para><literal>Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl; normalise2sections.xsl; sections2blocks.⋯</literal></para><screen><phrase role="commit-message">new stylesheets for better word processor support and easier maintenance</phrase></screen>
4505 </listitem>
4506 <listitem>
4507 <para><literal>Steve Ball: template-pages.xml; dbk2wp.xsl; sections-spec.xml</literal></para><screen><phrase role="commit-message">fixed bugs</phrase></screen>
4508 </listitem>
4509 </itemizedlist>
4510 </sect2><!--end of Roundtrip changes for 1.73.0-->
4511 <sect2 xml:id="V1.73.0_Params">
4512 <title>Params</title>
4513 <para>The following changes have been made to the
4514             <filename>params</filename> code
4515             since the 1.72.0 release.</para>
4516 <itemizedlist>
4517 <listitem>
4518 <para><literal>Mauritz Jeanson: htmlhelp.button.back.xml; htmlhelp.button.forward.xml; htmlhelp.button.zo⋯</literal></para><screen><phrase role="commit-message">Modified <tag>refpurpose</tag> text.</phrase></screen>
4519 </listitem>
4520 <listitem>
4521 <para><literal>Mauritz Jeanson: htmlhelp.map.file.xml; htmlhelp.force.map.and.alias.xml; htmlhelp.alias.f⋯</literal></para><screen><phrase role="commit-message">Fixed typos, made some small changes.</phrase></screen>
4522 </listitem>
4523 <listitem>
4524 <para><literal>Mauritz Jeanson: javahelp.encoding.xml</literal></para><screen><phrase role="commit-message">Moved declaration and documentation of <parameter>javahelp.encoding</parameter> from javahelp.xsl to the
4525 regular "parameter machinery".</phrase></screen>
4526 </listitem>
4527 <listitem>
4528 <para><literal>Mauritz Jeanson: generate.id.attributes.xml</literal></para><screen><phrase role="commit-message">Added <tag>refpurpose</tag> text.</phrase></screen>
4529 </listitem>
4530 <listitem>
4531 <para><literal>Mauritz Jeanson: annotation.js.xml; annotation.graphic.open.xml; annotation.graphic.close.⋯</literal></para><screen><phrase role="commit-message">Added better <tag>refpurpose</tag> texts.</phrase></screen>
4532 </listitem>
4533 <listitem>
4534 <para><literal>Michael(tm) Smith: chunker.output.cdata-section-elements.xml; chunker.output.standalone.xm⋯</literal></para><screen><phrase role="commit-message">Fixed some broken formatting in source files for chunker.* params,
4535 as pointed out by Dave Pawson.</phrase></screen>
4536 </listitem>
4537 <listitem>
4538 <para><literal>Michael(tm) Smith: label.from.part.xml</literal></para><screen><phrase role="commit-message">Changed handling of <tag>reference</tag> auto-labeling such that <tag>reference</tag>
4539 (when it appears at the component level) is now affected by the
4540 <parameter>label.from.part</parameter> param, just as <tag>preface</tag>, <tag>chapter</tag>, and <tag>appendix</tag>.</phrase></screen>
4541 </listitem>
4542 <listitem>
4543 <para><literal>Mauritz Jeanson: callout.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Clarified that 'extension' refers to file names.</phrase></screen>
4544 </listitem>
4545 <listitem>
4546 <para><literal>Michael(tm) Smith: abstract.notitle.enabled.xml</literal></para><screen><phrase role="commit-message">Added new param <parameter>abstract.notitle.enabled</parameter>.
4547 If non-zero, in output of the <tag>abstract</tag> element on titlepages,
4548 display of the <tag>abstract</tag> <tag>title</tag> is suppressed.
4549 Because sometimes you really don't want or need that <tag>title</tag>
4550 there...</phrase></screen>
4551 </listitem>
4552 <listitem>
4553 <para><literal>Michael(tm) Smith: man.string.subst.map.xml</literal></para><screen><phrase role="commit-message">Updated manpages string-substitute map to reflect fact that
4554 because of another recent change to suppress bold markup in .SH
4555 output, we no longer need to add a workaround for the accidental
4556 uppercasing of roff escapes that occurred previously.</phrase></screen>
4557 </listitem>
4558 <listitem>
4559 <para><literal>Jirka Kosek: margin.note.float.type.xml; title.font.family.xml; table.frame.border.color.x⋯</literal></para><screen><phrase role="commit-message">Improved parameter metadata</phrase></screen>
4560 </listitem>
4561 <listitem>
4562 <para><literal>Robert Stayton: profile.wordsize.xml; profile.audience.xml</literal></para><screen><phrase role="commit-message">Add support for profiling on new attributes audience and wordsize.</phrase></screen>
4563 </listitem>
4564 <listitem>
4565 <para><literal>Robert Stayton: callout.graphics.number.limit.xml; callout.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Added SVG graphics for fo output.</phrase></screen>
4566 </listitem>
4567 <listitem>
4568 <para><literal>Robert Stayton: callout.icon.size.xml</literal></para><screen><phrase role="commit-message">Set size of <tag>callout</tag> graphics.</phrase></screen>
4569 </listitem>
4570 <listitem>
4571 <para><literal>Jirka Kosek: default.units.xml; chunker.output.method.xml; toc.list.type.xml; output.inden⋯</literal></para><screen><phrase role="commit-message">Updated parameter metadata to the new format.</phrase></screen>
4572 </listitem>
4573 <listitem>
4574 <para><literal>Jirka Kosek: man.output.quietly.xml; title.font.family.xml; footnote.sep.leader.properties⋯</literal></para><screen><phrase role="commit-message">Added type annotations into parameter definition files.</phrase></screen>
4575 </listitem>
4576 <listitem>
4577 <para><literal>Robert Stayton: section.container.element.xml</literal></para><screen><phrase role="commit-message">Support spans in sections for certain processors.</phrase></screen>
4578 </listitem>
4579 <listitem>
4580 <para><literal>Robert Stayton: component.titlepage.properties.xml</literal></para><screen><phrase role="commit-message">Empty attribute set for top level component titlepage block.
4581 Allows setting a span on <tag>title</tag> <tag>info</tag>.</phrase></screen>
4582 </listitem>
4583 <listitem>
4584 <para><literal>Jirka Kosek: bibliography.style.xml</literal></para><screen><phrase role="commit-message">Added <tag>link</tag> to WiKi page with description of special markup needed for ISO690 biblioentries</phrase></screen>
4585 </listitem>
4586 <listitem>
4587 <para><literal>Robert Stayton: make.year.ranges.xml</literal></para><screen><phrase role="commit-message">Clarify that multiple <tag>year</tag> elements are required.</phrase></screen>
4588 </listitem>
4589 <listitem>
4590 <para><literal>Robert Stayton: id.warnings.xml</literal></para><screen><phrase role="commit-message">Turn off <parameter>id.warnings</parameter> by default.</phrase></screen>
4591 </listitem>
4592 <listitem>
4593 <para><literal>Jirka Kosek: bibliography.style.xml</literal></para><screen><phrase role="commit-message">Added support for formatting biblioentries according to ISO690 <tag>citation</tag> style.
4594 New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
4595 The code was provided by Jana Dvorakova</phrase></screen>
4596 </listitem>
4597 <listitem>
4598 <para><literal>Robert Stayton: header.table.properties.xml; footer.table.properties.xml</literal></para><screen><phrase role="commit-message">Support adding <tag>table</tag> properties to header and footer tables.</phrase></screen>
4599 </listitem>
4600 </itemizedlist>
4601 </sect2><!--end of Params changes for 1.73.0-->
4602 <sect2 xml:id="V1.73.0_Highlighting">
4603 <title>Highlighting</title>
4604 <para>The following changes have been made to the
4605             <filename>highlighting</filename> code
4606             since the 1.72.0 release.</para>
4607 <itemizedlist>
4608 <listitem>
4609 <para><literal>Jirka Kosek: c-hl.xml; xslthl-config.xml</literal></para><screen><phrase role="commit-message">Added support for C language. Provided by Bruno Guegan.</phrase></screen>
4610 </listitem>
4611 </itemizedlist>
4612 </sect2><!--end of Highlighting changes for 1.73.0-->
4613 <sect2 xml:id="V1.73.0_Profiling">
4614 <title>Profiling</title>
4615 <para>The following changes have been made to the
4616             <filename>profiling</filename> code
4617             since the 1.72.0 release.</para>
4618 <itemizedlist>
4619 <listitem>
4620 <para><literal>Robert Stayton: profile-mode.xsl</literal></para><screen><phrase role="commit-message">Add support for new profiling attributes audience and wordsize.</phrase></screen>
4621 </listitem>
4622 </itemizedlist>
4623 </sect2><!--end of Profiling changes for 1.73.0-->
4624 <sect2 xml:id="V1.73.0_Lib">
4625 <title>Lib</title>
4626 <para>The following changes have been made to the
4627             <filename>lib</filename> code
4628             since the 1.72.0 release.</para>
4629 <itemizedlist>
4630 <listitem>
4631 <para><literal>Michael(tm) Smith: lib.xweb</literal></para><screen><phrase role="commit-message">Changed name of prepend-pad template to pad-string and twheeked so
4632 it can do both right/left padding.</phrase></screen>
4633 </listitem>
4634 </itemizedlist>
4635 </sect2><!--end of Lib changes for 1.73.0-->
4636 <sect2 xml:id="V1.73.0_Tools">
4637 <title>Tools</title>
4638 <para>The following changes have been made to the
4639             <filename>tools</filename> code
4640             since the 1.72.0 release.</para>
4641 <itemizedlist>
4642 <listitem>
4643 <para><literal>Michael(tm) Smith: bin; bin/docbook-xsl-update</literal></para><screen><phrase role="commit-message">Did some cleanup to the install.sh source and added a
4644 docbook-xsl-update script to the docbook-xsl distro, the purpose
4645 of which is to facilitate easy sync-up to the latest docbook-xsl
4646 snapshot (by means of rsync).</phrase></screen>
4647 </listitem>
4648 </itemizedlist>
4649 </sect2><!--end of Tools changes for 1.73.0-->
4650 <sect2 xml:id="V1.73.0_XSL-Saxon">
4651 <title>XSL-Saxon</title>
4652 <para>The following changes have been made to the
4653             <filename>xsl-saxon</filename> code
4654             since the 1.72.0 release.</para>
4655 <itemizedlist>
4656 <listitem>
4657 <para><literal>Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/com/nwalsh/xalan/⋯</literal></para><screen><phrase role="commit-message">Added modifications so that the new <parameter>callout.icon.size</parameter> parameter is taken into account. This 
4658 parameter is used for FO output (where SVG now is the default graphics format for callouts).</phrase></screen>
4659 </listitem>
4660 <listitem>
4661 <para><literal>Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/src/com/nwalsh/x⋯</literal></para><screen><phrase role="commit-message">Added code for generating id attributes on callouts in HTML and FO output.
4662 These patches enable cross-references to callouts placed by <tag>area</tag> coordinates.
4663 It works for graphic, unicode and text callouts. 
4664 Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
4665 </listitem>
4666 <listitem>
4667 <para><literal>Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/com/nwalsh/xalan⋯</literal></para><screen><phrase role="commit-message">Copied over Website XSL Java extensions.</phrase></screen>
4668 </listitem>
4669 </itemizedlist>
4670 </sect2><!--end of XSL-Saxon changes for 1.73.0-->
4671 <sect2 xml:id="V1.73.0_XSL-Xalan">
4672 <title>XSL-Xalan</title>
4673 <para>The following changes have been made to the
4674             <filename>xsl-xalan</filename> code
4675             since the 1.72.0 release.</para>
4676 <itemizedlist>
4677 <listitem>
4678 <para><literal>Michael(tm) Smith: Makefile; xalan2</literal></para><screen><phrase role="commit-message">Turned off xalan2.jar build. This removes DocBook XSL
4679 Java extensions support for versions of Xalan prior to
4680 Xalan 2.7. If you are currently using the extensions
4681 with an earlier version of Xalan, you need to upgrade
4682 to Xalan 2.7.</phrase></screen>
4683 </listitem>
4684 <listitem>
4685 <para><literal>Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/com/nwalsh/xalan/⋯</literal></para><screen><phrase role="commit-message">Added modifications so that the new <parameter>callout.icon.size</parameter> parameter is taken into account. This 
4686 parameter is used for FO output (where SVG now is the default graphics format for callouts).</phrase></screen>
4687 </listitem>
4688 <listitem>
4689 <para><literal>Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/src/com/nwalsh/x⋯</literal></para><screen><phrase role="commit-message">Added code for generating id attributes on callouts in HTML and FO output.
4690 These patches enable cross-references to callouts placed by <tag>area</tag> coordinates.
4691 It works for graphic, unicode and text callouts. 
4692 Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
4693 </listitem>
4694 <listitem>
4695 <para><literal>Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/com/nwalsh/xalan⋯</literal></para><screen><phrase role="commit-message">Copied over Website XSL Java extensions.</phrase></screen>
4696 </listitem>
4697 </itemizedlist>
4698 </sect2><!--end of XSL-Saxon changes for 1.73.0-->
4699 </sect1><!--end of changes for the 1.73.0 release-->
4700
4701 <sect1 xml:id="V1.72.0">
4702 <title>Release: 1.72.0</title>
4703 <para>This release includes important bug fixes and adds the following
4704 significant feature changes:
4705 <variablelist>
4706   <varlistentry>
4707     <term>Automatic sorting of glossary entries</term>
4708     <listitem>
4709       <para>The HTML and FO stylesheets now support automatic sorting
4710       of <tag>glossary</tag> entries. To enable glossary sorting, set
4711       the value of the <parameter>glossary.sort </parameter> parameter
4712       to <code>1</code> (by default, it’s value is
4713       <code>0</code>). When you enable glossary sorting,
4714       <tag>glossentry</tag> elements within a <tag> glossary</tag>,
4715       <tag>glossdiv</tag>, or <tag>glosslist</tag> are sorted on the
4716       <tag>glossterm</tag>, using the current language setting. If you
4717       don’t enable glossary sorting, then the order of
4718       <tag>glossentry</tag> elements is left “as is” — that is, they
4719       are not sorted but are instead just displayed in document
4720       order.</para>
4721     </listitem>
4722   </varlistentry>
4723   <varlistentry>
4724     <term>WordML renamed to Roundtrip, OpenOffice support added</term>
4725     <listitem>
4726     <para>Stylesheets for “roundtrip” conversion between documents in
4727     OpenOffice format (ODF) and DocBook XML have been added to the set
4728     of stylesheets that formerly had the collective title
4729     <wordasword>WordML</wordasword>, and that set of stylesheets has
4730     been renamed to <wordasword>Roundtrip</wordasword> to better
4731     reflect the actual scope and purpose of its contents.</para>
4732     <para>So the DocBook XSL Stylesheets now support roundtrip
4733     conversion (with certain limitations) of WordML, OpenOffice, and
4734     Apple Pages documents to and from DocBook XML.</para>
4735     </listitem>
4736   </varlistentry>
4737   <varlistentry>
4738     <term>Including QandASet questions in TOCs</term>
4739     <listitem>
4740       <para>The HTML stylesheet now provides support for including
4741       <tag>QandASet</tag> <tag>question</tag>s in the document TOC. To
4742       enable display of <tag>question</tag>s in the document TOC, set
4743       the value of the <parameter>qanda.in.toc</parameter> to
4744       <code>1</code> (by default, it’s <code>0</code>). When you
4745       enable <parameter>qanda.in.toc</parameter>, then the generated
4746       table of contents for a document will include
4747       <tag>qandaset</tag> titles, <tag>qandadiv</tag> titles, and
4748       <tag>question</tag> elements. The default value of zero
4749       excludes them from the TOC.
4750       <note>
4751         <para>The <parameter>qanda.in.toc</parameter> parameter does
4752         not affect any tables of contents that may be generated
4753         <emphasis>within</emphasis> a <tag>qandaset</tag> or
4754         <tag>qandadiv</tag> (only in the document TOC).</para>
4755       </note>
4756       </para>
4757     </listitem>
4758   </varlistentry>
4759   <varlistentry>
4760     <term>Language identifier in man-page filenames and pathnames</term>
4761     <listitem>
4762       <para>Added new parameter <parameter
4763       >man.output.lang.in.name.enabled</parameter>, which controls whether
4764       a language identifier is included in man-page filenames and
4765       pathnames. It works like this:</para>
4766
4767       <para>If the value of <parameter
4768       >man.output.lang.in.name.enabled</parameter> is non-zero,
4769       man-page files are output with a language identifier included in
4770       their filenames or pathnames as follows:</para>
4771
4772       <itemizedlist>
4773         <listitem><para>if
4774         <parameter>man.output.subdirs.enabled</parameter> is non-zero,
4775         each file is output to, e.g., a
4776         <filename>/$lang/man8/foo.8</filename> pathname</para></listitem>
4777
4778         <listitem><para>if
4779         <parameter>man.output.subdirs.enabled</parameter> is zero,
4780         each file is output with a <tag>foo.$lang.8</tag>
4781         filename</para></listitem>
4782       </itemizedlist>
4783
4784     </listitem>
4785   </varlistentry>
4786   <varlistentry>
4787     <term><parameter>index.page.number.properties</parameter> property set</term>
4788     <listitem>
4789       <para>For FO output, use the
4790       <parameter>index.page.number.properties</parameter> to control
4791       formatting of page numbers in <tag>index</tag> output — to (for
4792       example) to display page numbers in <tag>index</tag> output in a
4793       different color (to indicate that they are links).</para>
4794     </listitem>
4795   </varlistentry>
4796   <varlistentry>
4797     <term>Crop marks in output from Antenna House XSL Formatter</term>
4798     <listitem>
4799       <para>Support has been added for generating crop marks in
4800       print/PDF output generated using Antenna House XSL Formatter</para>
4801     </listitem>
4802   </varlistentry>
4803   <varlistentry>
4804     <term>More string-substitution hooks in manpages output</term>
4805     <listitem>
4806       <para>The <parameter>man.string.subst.map.local.pre</parameter>
4807       and <parameter>man.string.subst.map.local.post</parameter>
4808       parameters have been added to enable easier control over
4809       custom string substitutions.</para>
4810     </listitem>
4811   </varlistentry>
4812   <varlistentry>
4813     <term>Moved verbatim properties to attribute-set</term>
4814     <listitem>
4815       <para>The hardcoded properties used in verbatim elements (literallayout,
4816       programlisting, screen) were moved to the verbatim.properties 
4817       attribute-set so they can be more easily customized.</para>
4818     </listitem>
4819   </varlistentry>
4820   <varlistentry>
4821     <term>enhanced simple.xlink template</term>
4822     <listitem>
4823       <para>Now the simple.xlink template in inline.xsl works with
4824       cross reference elements xref and link as well.  Also, more elements
4825       call simple.xlink, which enables DB5 xlink functionality.
4826       </para>
4827     </listitem>
4828   </varlistentry>
4829   <varlistentry>
4830     <term>DocBook 5 compatibility</term>
4831     <listitem>
4832       <para>Stylesheets now consistently support DocBook 5 attributes
4833       (such as xml:id). Also, DocBook 5 info elements are now checked
4834       along with other *info elements, and the use of name() function
4835       was replaced by local-name() so it also matches on DocBook 5 elements.
4836       These changes enable reusing the stylesheets with DocBook 5 
4837       documents with minimal fixup.
4838       </para>
4839     </listitem>
4840   </varlistentry>
4841   <varlistentry>
4842     <term>HTML class attributes now handled in class.attribute mode </term>
4843     <listitem>
4844       <para>The HTML class attributes were formerly hardcoded to the 
4845       element name.  Now the class attribute is generated by applying
4846       templates in class.attribute mode so class attribute names
4847       can be customized. The default is still the element name.</para>
4848     </listitem>
4849   </varlistentry>
4850   <varlistentry>
4851     <term>arabic-indic numbering enabled in autolabels</term>
4852     <listitem>
4853       <para>Numbering of chapter, sections, and pages can now use
4854       arabic-indic numbering when number format is set to 'arabicindic' or
4855       to &#x661;.</para>
4856     </listitem>
4857   </varlistentry>
4858 </variablelist>
4859 The following is a detailed list of changes (not
4860 including bug fixes) that have been made since the 1.71.1
4861 release.</para>
4862
4863 <sect2 xml:id="V1.72.0_Common">
4864 <title>Common</title>
4865 <para>The following changes have been made to the
4866             <filename>common</filename> code
4867             since the 1.71.1 release.</para>
4868 <itemizedlist>
4869 <listitem>
4870 <literallayout><phrase role="commit-message">Add support for arabicindic numbering to autolabel.format template.<alt>M: /trunk/xsl/common/labels.xsl - Robert Stayton</alt></phrase></literallayout>
4871 </listitem>
4872 <listitem>
4873 <literallayout><phrase role="commit-message">Finish support for @xml:id everywhere @id is used.<alt>M: /trunk/xsl/common/gentext.xsl; M: /trunk/xsl/common/titles.xsl - Robert Stayton</alt></phrase></literallayout>
4874 </listitem>
4875 <listitem>
4876 <literallayout><phrase role="commit-message">replace name() with local-name() in most cases.<alt>M: /trunk/xsl/common/l10n.xsl; M: /trunk/xsl/common/olink.xsl; M: /trunk/xsl/common/subtitles.xsl; M: /trunk/xsl/common/labels.xsl; M: /trunk/xsl/common/titles.xsl; M: /trunk/xsl/common/common.xsl - Robert Stayton</alt></phrase></literallayout>
4877 </listitem>
4878 <listitem>
4879 <literallayout><phrase role="commit-message">Add support for <tag>info</tag>.<alt>M: /trunk/xsl/common/subtitles.xsl; M: /trunk/xsl/common/labels.xsl; M: /trunk/xsl/common/titles.xsl; M: /trunk/xsl/common/common.xsl; M: /trunk/xsl/common/targets.xsl - Robert Stayton</alt></phrase></literallayout>
4880 </listitem>
4881 <listitem>
4882 <literallayout><phrase role="commit-message">Add utility template tabstyle to return the tabstyle from
4883 any <tag>table</tag> element.<alt>M: /trunk/xsl/common/table.xsl - Robert Stayton</alt></phrase></literallayout>
4884 </listitem>
4885 </itemizedlist>
4886 </sect2><!--end of Common changes for 1.72.0-->
4887
4888 <sect2 xml:id="V1.72.0_FO">
4889 <title>FO</title>
4890 <para>The following changes have been made to the
4891             <filename>fo</filename> code
4892             since the 1.71.1 release.</para>
4893 <itemizedlist>
4894 <listitem>
4895 <literallayout><phrase role="commit-message">Add support for sorting <tag>glossary</tag> entries<alt>M: /trunk/xsl/fo/param.xweb; M: /trunk/xsl/fo/param.ent; M: /trunk/xsl/fo/glossary.xsl - Robert Stayton</alt></phrase></literallayout>
4896 </listitem>
4897 <listitem>
4898 <literallayout><phrase role="commit-message">Add table.row.properties template to customize <tag>table</tag> rows.<alt>M: /trunk/xsl/fo/table.xsl - Robert Stayton</alt></phrase></literallayout>
4899 </listitem>
4900 <listitem>
4901 <literallayout><phrase role="commit-message">Moved all properties to attribute-sets so can be customized more easily.<alt>M: /trunk/xsl/fo/verbatim.xsl - Robert Stayton</alt></phrase></literallayout>
4902 </listitem>
4903 <listitem>
4904 <literallayout><phrase role="commit-message">Add index.page.number.properties attribute-set to format page numbers.<alt>M: /trunk/xsl/fo/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
4905 </listitem>
4906 <listitem>
4907 <literallayout><phrase role="commit-message"><tag>xref</tag> now supports xlink:href, using simple.xlink template.<alt>M: /trunk/xsl/fo/xref.xsl - Robert Stayton</alt></phrase></literallayout>
4908 </listitem>
4909 <listitem>
4910 <literallayout><phrase role="commit-message">Rewrote simple.xlink, and call it with all charseq templates.<alt>M: /trunk/xsl/fo/inline.xsl - Robert Stayton</alt></phrase></literallayout>
4911 </listitem>
4912 <listitem>
4913 <literallayout><phrase role="commit-message">Add simple.xlink processing to <tag>term</tag> and <tag>member</tag> elements.<alt>M: /trunk/xsl/fo/lists.xsl - Robert Stayton</alt></phrase></literallayout>
4914 </listitem>
4915 <listitem>
4916 <literallayout><phrase role="commit-message">Add support for crop marks in Antenna House.<alt>M: /trunk/xsl/fo/axf.xsl; M: /trunk/xsl/fo/pagesetup.xsl - Robert Stayton</alt></phrase></literallayout>
4917 </listitem>
4918 </itemizedlist>
4919 </sect2><!--end of FO changes for 1.72.0-->
4920
4921 <sect2 xml:id="V1.72.0_HTML">
4922 <title>HTML</title>
4923 <para>The following changes have been made to the
4924             <filename>html</filename> code
4925             since the 1.71.1 release.</para>
4926 <itemizedlist>
4927 <listitem>
4928 <literallayout><phrase role="commit-message">Add support for sorting <tag>glossary</tag> entries<alt>M: /trunk/xsl/html/glossary.xsl - Robert Stayton</alt></phrase></literallayout>
4929 </listitem>
4930 <listitem>
4931 <literallayout><phrase role="commit-message">Add support for <parameter>qanda.in.toc</parameter> to add <tag>qandaentry</tag> questions to document <tag>TOC</tag>.<alt>M: /trunk/xsl/html/autotoc.xsl; M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Robert Stayton</alt></phrase></literallayout>
4932 </listitem>
4933 <listitem>
4934 <literallayout><phrase role="commit-message">add simple.xlink support to <tag>variablelist</tag> <tag>term</tag> and <tag>simplelist</tag> <tag>member</tag>.<alt>M: /trunk/xsl/html/lists.xsl - Robert Stayton</alt></phrase></literallayout>
4935 </listitem>
4936 <listitem>
4937 <literallayout><phrase role="commit-message">*.propagates.style now handled in class.attribute mode.<alt>M: /trunk/xsl/html/inline.xsl; M: /trunk/xsl/html/lists.xsl; M: /trunk/xsl/html/table.xsl; M: /trunk/xsl/html/block.xsl; M: /trunk/xsl/html/footnote.xsl - Robert Stayton</alt></phrase></literallayout>
4938 </listitem>
4939 <listitem>
4940 <literallayout><phrase role="commit-message">add class parameter to class.attribute mode to set default class.<alt>M: /trunk/xsl/html/html.xsl - Robert Stayton</alt></phrase></literallayout>
4941 </listitem>
4942 <listitem>
4943 <literallayout><phrase role="commit-message">Convert all class attributes to use the class.attribute mode
4944 so class names can be customized more easily.<alt>M: /trunk/xsl/html/titlepage.xsl; M: /trunk/xsl/html/chunk-code.xsl; M: /trunk/xsl/html/division.xsl; M: /trunk/xsl/html/sections.xsl; M: /trunk/xsl/html/math.xsl; M: /trunk/xsl/html/block.xsl; M: /trunk/xsl/html/info.xsl; M: /trunk/xsl/html/footnote.xsl; M: /trunk/xsl/html/lists.xsl; M: /trunk/xsl/html/admon.xsl; M: /trunk/xsl/html/refentry.xsl; M: /trunk/xsl/html/qandaset.xsl; M: /trunk/xsl/html/graphics.xsl; M: /trunk/xsl/html/biblio.xsl; M: /trunk/xsl/html/task.xsl; M: /trunk/xsl/html/component.xsl; M: /trunk/xsl/html/glossary.xsl; M: /trunk/xsl/html/callout.xsl; M: /trunk/xsl/html/index.xsl; M: /trunk/xsl/html/synop.xsl; M: /trunk/xsl/html/verbatim.xsl; M: /trunk/xsl/html/ebnf.xsl - Robert Stayton</alt></phrase></literallayout>
4945 </listitem>
4946 <listitem>
4947 <literallayout><phrase role="commit-message">Add class.attribute mode to generate class attributes.<alt>M: /trunk/xsl/html/html.xsl - Robert Stayton</alt></phrase></literallayout>
4948 </listitem>
4949 <listitem>
4950 <literallayout><phrase role="commit-message">Added simple.xlink to most remaining inlines.
4951 Changed class attributes to applying class.attributes mode.<alt>M: /trunk/xsl/html/inline.xsl - Robert Stayton</alt></phrase></literallayout>
4952 </listitem>
4953 <listitem>
4954 <literallayout><phrase role="commit-message">Changed <tag>xref</tag> template to use simple.xlink tempalte.<alt>M: /trunk/xsl/html/xref.xsl - Robert Stayton</alt></phrase></literallayout>
4955 </listitem>
4956 <listitem>
4957 <literallayout><phrase role="commit-message">Improve generate.html.title to work with <tag>link</tag> targets too.<alt>M: /trunk/xsl/html/html.xsl - Robert Stayton</alt></phrase></literallayout>
4958 </listitem>
4959 <listitem>
4960 <literallayout><phrase role="commit-message">Improved simple.xlink to support <tag>link</tag> and <tag>xref</tag>.<alt>M: /trunk/xsl/html/inline.xsl - Robert Stayton</alt></phrase></literallayout>
4961 </listitem>
4962 <listitem>
4963 <literallayout><phrase role="commit-message">Use new link.title.attribute now.<alt>M: /trunk/xsl/html/xref.xsl - Robert Stayton</alt></phrase></literallayout>
4964 </listitem>
4965 <listitem>
4966 <literallayout><phrase role="commit-message">Rewrote simple.xlink to handle linkend also.
4967 Better computation of <tag>title</tag> attribute on <tag>link</tag> too.<alt>M: /trunk/xsl/html/inline.xsl - Robert Stayton</alt></phrase></literallayout>
4968 </listitem>
4969 <listitem>
4970 <literallayout><phrase role="commit-message">Handle Xalan quirk as special case.<alt>M: /trunk/xsl/html/db5strip.xsl - Robert Stayton</alt></phrase></literallayout>
4971 </listitem>
4972 <listitem>
4973 <literallayout><phrase role="commit-message">Add support for <tag>info</tag>.<alt>M: /trunk/xsl/html/admon.xsl; M: /trunk/xsl/html/autotoc.xsl; M: /trunk/xsl/html/lists.xsl; M: /trunk/xsl/html/refentry.xsl; M: /trunk/xsl/html/biblio.xsl; M: /trunk/xsl/html/qandaset.xsl; M: /trunk/xsl/html/component.xsl; M: /trunk/xsl/html/glossary.xsl; M: /trunk/xsl/html/division.xsl; M: /trunk/xsl/html/index.xsl; M: /trunk/xsl/html/sections.xsl; M: /trunk/xsl/html/table.xsl; M: /trunk/xsl/html/block.xsl - Robert Stayton</alt></phrase></literallayout>
4974 </listitem>
4975 <listitem>
4976 <literallayout><phrase role="commit-message">Fixed imagemaps so they work properly going from calspair coords
4977 to HTML <tag>area</tag> coords.<alt>M: /trunk/xsl/html/graphics.xsl - Robert Stayton</alt></phrase></literallayout>
4978 </listitem>
4979 </itemizedlist>
4980 </sect2><!--end of HTML changes for 1.72.0-->
4981
4982 <sect2 xml:id="V1.72.0_Manpages">
4983 <title>Manpages</title>
4984 <para>The following changes have been made to the
4985             <filename>manpages</filename> code
4986             since the 1.71.1 release.</para>
4987 <itemizedlist>
4988 <listitem>
4989 <literallayout><phrase role="commit-message">Added doc for <parameter>man.output.lang.in.name.enabled</parameter> parameter. This
4990 checkin completes support for writing file/pathnames for man-pages
4991 with $lang include in the names. Closes #1585967. knightly
4992 accolades to Daniel Leidert for providing the feature request.<alt>M: /trunk/xsl/manpages/param.xweb; M: /trunk/xsl/manpages/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
4993 </listitem>
4994 <listitem>
4995 <literallayout><phrase role="commit-message">Added new param <parameter>man.output.lang.in.name.enabled</parameter>, which
4996 controls whether $LANG value is included in manpages
4997 filenames and pathnames. It works like this:
4998
4999 If the value of <parameter>man.output.lang.in.name.enabled</parameter> is non-zero,
5000 man-page files are output with the $lang value included in
5001 their filenames or pathnames as follows;
5002
5003 - if <parameter>man.output.subdirs.enabled</parameter> is non-zero, each file is
5004   output to, e.g., a /$lang/man8/foo.8 pathname
5005
5006 - if <parameter>man.output.subdirs.enabled</parameter> is zero, each file is output
5007   with a foo.$lang.8 <tag>filename</tag><alt>M: /trunk/xsl/manpages/docbook.xsl; M: /trunk/xsl/manpages/other.xsl; M: /trunk/xsl/manpages/utility.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5008 </listitem>
5009 <listitem>
5010 <literallayout><phrase role="commit-message">Use "\e" instead of "\\" for backslash output, because the
5011 groff docs say that's the correct thing to do; also because
5012 testing (thanks, Paul Dubois) shows that "\\" doesn't always
5013 work as expected; for example, "\\" within a <tag>table</tag> seems to
5014 mess things up.<alt>M: /trunk/xsl/manpages/charmap.groff.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5015 </listitem>
5016 <listitem>
5017 <literallayout><phrase role="commit-message">Added the <parameter>man.string.subst.map.local.pre</parameter> and
5018 <parameter>man.string.subst.map.local.post</parameter> parameters. Those parameters
5019 enable local additions and changes to string-substitution mappings
5020 without the need to change the value of <parameter>man.string.subst.map</parameter>
5021 parameter (which is for standard system mappings). Closes
5022 #1456738. Thanks to Sam Steingold for constructing a true
5023 stylesheet torture test (the clisp docs) that exposed the need for
5024 these params.<alt>M: /trunk/xsl/manpages/param.xweb; M: /trunk/xsl/manpages/param.ent; M: /trunk/xsl/manpages/other.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5025 </listitem>
5026 <listitem>
5027 <literallayout><phrase role="commit-message">Added the Markup element to the list of elements that get output
5028 in bold. Thanks to Eric S. Raymond.<alt>M: /trunk/xsl/manpages/inline.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5029 </listitem>
5030 <listitem>
5031 <literallayout><phrase role="commit-message">Replaced all dots in roff requests with U+2302 ("house"
5032 character), and added escaping in output for all instances of dot
5033 that are not in roff requests. This fixes the problem case where a
5034 string beginning with a dot (for example, the string ".bashrc")
5035 might occur at the beginning of a line in output, in which case 
5036 would mistakenly get interpreted as a roff request. Thanks to Eric
5037 S. Raymond for pushing to fix this.<alt>M: /trunk/xsl/manpages/table.xsl; M: /trunk/xsl/manpages/synop.xsl; M: /trunk/xsl/manpages/block.xsl; M: /trunk/xsl/manpages/info.xsl; M: /trunk/xsl/manpages/lists.xsl; M: /trunk/xsl/manpages/refentry.xsl; M: /trunk/xsl/manpages/links.xsl; M: /trunk/xsl/manpages/other.xsl; M: /trunk/xsl/manpages/utility.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5038 </listitem>
5039 <listitem>
5040 <literallayout><phrase role="commit-message">Made change to ensure that list content nested in
5041 <tag>itemizedlist</tag> and <tag>orderedlist</tag> instances is properly indented. This
5042 is a switch from using .TP to format those lists to using .RS/.RE
5043 to format them instead (because .TP does not allow nesting). Closes bug #1602616.
5044 Thanks to Daniel Leidert.<alt>M: /trunk/xsl/manpages/lists.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5045 </listitem>
5046 </itemizedlist>
5047 </sect2><!--end of Manpages changes for 1.72.0-->
5048
5049 <sect2 xml:id="V1.72.0_Params">
5050 <title>Params</title>
5051 <para>The following changes have been made to the
5052             <filename>params</filename> code
5053             since the 1.71.1 release.</para>
5054 <itemizedlist>
5055 <listitem>
5056 <literallayout><phrase role="commit-message">Added doc for <parameter>man.output.lang.in.name.enabled</parameter> parameter. This
5057 checkin completes support for writing file/pathnames for man-pages
5058 with $lang include in the names. Closes #1585967. knightly
5059 accolades to Daniel Leidert for providing the feature request.<alt>A: /trunk/xsl/params/man.output.lang.in.name.enabled.xml - Michael(tm) Smith</alt></phrase></literallayout>
5060 </listitem>
5061 <listitem>
5062 <literallayout><phrase role="commit-message">Added new param <parameter>man.output.lang.in.name.enabled</parameter>, which
5063 controls whether $LANG value is included in manpages
5064 filenames and pathnames. It works like this:
5065
5066 If the value of <parameter>man.output.lang.in.name.enabled</parameter> is non-zero,
5067 man-page files are output with the $lang value included in
5068 their filenames or pathnames as follows;
5069
5070 - if <parameter>man.output.subdirs.enabled</parameter> is non-zero, each file is
5071   output to, e.g., a /$lang/man8/foo.8 pathname
5072
5073 - if <parameter>man.output.subdirs.enabled</parameter> is zero, each file is output
5074   with a foo.$lang.8 <tag>filename</tag><alt>M: /trunk/xsl/manpages/docbook.xsl; M: /trunk/xsl/manpages/other.xsl; M: /trunk/xsl/manpages/utility.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5075 </listitem>
5076 <listitem>
5077 <literallayout><phrase role="commit-message">Added the <parameter>man.string.subst.map.local.pre</parameter> and
5078 <parameter>man.string.subst.map.local.post</parameter> parameters. Those parameters
5079 enable local additions and changes to string-substitution mappings
5080 without the need to change the value of <parameter>man.string.subst.map</parameter>
5081 parameter (which is for standard system mappings). Closes
5082 #1456738. Thanks to Sam Steingold for constructing a true
5083 stylesheet torture test (the clisp docs) that exposed the need for
5084 these params.<alt>A: /trunk/xsl/params/man.string.subst.map.local.post.xml; A: /trunk/xsl/params/man.string.subst.map.local.pre.xml; M: /trunk/xsl/params/man.string.subst.map.xml - Michael(tm) Smith</alt></phrase></literallayout>
5085 </listitem>
5086 <listitem>
5087 <literallayout><phrase role="commit-message">Add index.page.number.properties by default.<alt>M: /trunk/xsl/params/xep.index.item.properties.xml - Robert Stayton</alt></phrase></literallayout>
5088 </listitem>
5089 <listitem>
5090 <literallayout><phrase role="commit-message">Added <parameter>index.page.number.properties</parameter> to allow customizations of page numbers in indexes.<alt>A: /trunk/xsl/params/index.page.number.properties.xml - Robert Stayton</alt></phrase></literallayout>
5091 </listitem>
5092 <listitem>
5093 <literallayout><phrase role="commit-message">Move show-destination="replace" property from template to attribute-set
5094 so it can be customized.<alt>M: /trunk/xsl/params/olink.properties.xml - Robert Stayton</alt></phrase></literallayout>
5095 </listitem>
5096 <listitem>
5097 <literallayout><phrase role="commit-message">Add support for sorting <tag>glossary</tag> entries<alt>A: /trunk/xsl/params/glossary.sort.xml - Robert Stayton</alt></phrase></literallayout>
5098 </listitem>
5099 <listitem>
5100 <literallayout><phrase role="commit-message">Add option to include qanda in tables of contents.<alt>A: /trunk/xsl/params/qanda.in.toc.xml - Robert Stayton</alt></phrase></literallayout>
5101 </listitem>
5102 <listitem>
5103 <literallayout><phrase role="commit-message">Moved all properties to attribute-sets so can be customized more easily.<alt>M: /trunk/xsl/params/verbatim.properties.xml - Robert Stayton</alt></phrase></literallayout>
5104 </listitem>
5105 </itemizedlist>
5106 </sect2><!--end of Params changes for 1.72.0-->
5107
5108 <sect2 xml:id="V1.72.0_Template">
5109 <title>Template</title>
5110 <para>The following changes have been made to the
5111             <filename>template</filename> code
5112             since the 1.71.1 release.</para>
5113 <itemizedlist>
5114 <listitem>
5115 <literallayout><phrase role="commit-message">Added workaround for Xalan bug: use for-each and copy instead of copy-of (#1604770).<alt>M: /trunk/xsl/template/titlepage.xsl - Mauritz Jeanson</alt></phrase></literallayout>
5116 </listitem>
5117 </itemizedlist>
5118 </sect2><!--end of Template changes for 1.72.0-->
5119
5120 <sect2 xml:id="V1.72.0_Roundtrip">
5121 <title>Roundtrip</title>
5122 <para>The following changes have been made to the
5123             <filename>roundtrip</filename> code
5124             since the 1.71.1 release.</para>
5125 <itemizedlist>
5126 <listitem>
5127 <literallayout><phrase role="commit-message">rename to roundtrip, add OpenOffice support<alt>M: /trunk/xsl/roundtrip/docbook-pages.xsl; M: /trunk/xsl/roundtrip/specifications.xml; A: /trunk/xsl/roundtrip/dbk2ooo.xsl; M: /trunk/xsl/roundtrip/docbook.xsl; A: /trunk/xsl/roundtrip/dbk2pages.xsl; M: /trunk/xsl/roundtrip/template.xml; A: /trunk/xsl/roundtrip/dbk2wordml.xsl; A: /trunk/xsl/roundtrip/dbk2wp.xsl; M: /trunk/xsl/roundtrip/template.dot; M: /trunk/xsl/roundtrip/wordml-final.xsl - Steve Ball</alt></phrase></literallayout>
5128 </listitem>
5129 </itemizedlist>
5130 </sect2><!--end of Roundtrip changes for 1.72.0-->
5131 </sect1><!--end of V1.72.0-->
5132
5133 <sect1 xml:id="V1.71.1">
5134 <title>Release: 1.71.1</title>
5135 <para>This is a minor update to the 1.71.0 release. Along with a
5136 number of bug fixes, it includes two feature changes:
5137
5138 <itemizedlist>
5139   <listitem>
5140     <para>Added support for profiling based on <tag
5141     class="attribute">xml:lang</tag> and <tag
5142     class="attribute">status</tag> attributes.</para>
5143   </listitem>
5144   <listitem>
5145     <para>Added initial support in manpages output for
5146     <tag>footnote</tag>, <tag>annotation</tag>, and <tag>alt</tag>
5147     instances. Basically, they all now get handled the same way
5148     <tag>ulink</tag> instances are. They are treated as a class as
5149     "note sources": A numbered marker is generated at the place in the
5150     main text flow where they occur, then their contents are displayed
5151     in an endnotes section at the end of the man page.</para>
5152   </listitem>
5153 </itemizedlist>
5154 </para>
5155
5156 <sect2 xml:id="V1.71.1_Common">
5157 <title>Common</title>
5158 <para>The following changes have been made to the
5159             <filename>common</filename> code
5160             since the 1.71.1 release.</para>
5161 <itemizedlist>
5162 <listitem>
5163 <literallayout><phrase role="commit-message">For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.<alt>D: /trunk/xsl/common/autoidx-ng.xsl - Jirka Kosek</alt></phrase></literallayout>
5164 </listitem>
5165 <listitem>
5166 <literallayout><phrase role="commit-message">Add support for Xalan generating a root xml:base like saxon.<alt>M: /trunk/xsl/common/stripns.xsl - Robert Stayton</alt></phrase></literallayout>
5167 </listitem>
5168 </itemizedlist>
5169 </sect2><!--end of Common changes for 1.71.1-->
5170
5171 <sect2 xml:id="V1.71.1_FO">
5172 <title>FO</title>
5173 <para>The following changes have been made to the
5174             <filename>fo</filename> code
5175             since the 1.71.1 release.</para>
5176 <itemizedlist>
5177 <listitem>
5178 <literallayout><phrase role="commit-message">For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.<alt>M: /trunk/xsl/fo/autoidx-ng.xsl; M: /trunk/xsl/fo/autoidx-kosek.xsl - Jirka Kosek</alt></phrase></literallayout>
5179 </listitem>
5180 <listitem>
5181 <literallayout><phrase role="commit-message">Add support for Xalan to add root node xml:base for db5 docs.<alt>M: /trunk/xsl/fo/docbook.xsl - Robert Stayton</alt></phrase></literallayout>
5182 </listitem>
5183 <listitem>
5184 <literallayout><phrase role="commit-message">Added support for profiling based on xml:lang and status attributes.<alt>M: /trunk/xsl/fo/param.xweb; M: /trunk/xsl/fo/param.ent - Jirka Kosek</alt></phrase></literallayout>
5185 </listitem>
5186 </itemizedlist>
5187 </sect2><!--end of FO changes for 1.71.1-->
5188
5189 <sect2 xml:id="V1.71.1_HTML">
5190 <title>HTML</title>
5191 <para>The following changes have been made to the
5192             <filename>html</filename> code
5193             since the 1.71.1 release.</para>
5194 <itemizedlist>
5195 <listitem>
5196 <literallayout><phrase role="commit-message">For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.<alt>M: /trunk/xsl/html/autoidx-ng.xsl; M: /trunk/xsl/html/autoidx-kosek.xsl - Jirka Kosek</alt></phrase></literallayout>
5197 </listitem>
5198 <listitem>
5199 <literallayout><phrase role="commit-message">Add support for Xalan to add root node xml:base for db5 docs.<alt>M: /trunk/xsl/html/chunk-code.xsl; M: /trunk/xsl/html/docbook.xsl - Robert Stayton</alt></phrase></literallayout>
5200 </listitem>
5201 <listitem>
5202 <literallayout><phrase role="commit-message">Added support for profiling based on xml:lang and status attributes.<alt>M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Jirka Kosek</alt></phrase></literallayout>
5203 </listitem>
5204 <listitem>
5205 <literallayout><phrase role="commit-message">Made changes in namespace declarations to prevent xmllint's
5206 canonicalizer from treating them as relative namespace URIs.
5207
5208   - Changed xmlns:k="java:com.isogen.saxoni18n.Saxoni18nService"
5209     to xmlns:k="http://www.isogen.com/functions/com.isogen.saxoni18n.Saxoni18nService";
5210     Saxon accepts either form
5211     (see http://www.saxonica.com/documentation/extensibility/functions.html);
5212     to Saxon, "the part of the URI before the final '/' is immaterial".
5213
5214   - Changed, e.g. xmlns:xverb="com.nwalsh.xalan.Verbatim" to
5215     xmlns:xverb="xalan://com.nwalsh.xalan.Verbatim"; Xalan accepts
5216     either form
5217     (see http://xml.apache.org/xalan-j/extensions.html#java-namespace-declare);
5218     just as Saxon does, it will "simply use the string to the
5219     right of the rightmost forward slash as the Java class name".
5220
5221   - Changed xmlns:xalanredirect="org.apache.xalan.xslt.extensions.Redirect"
5222     to xmlns:redirect="http://xml.apache.org/xalan/redirect", and
5223     adjusted associated code to make the current Xalan redirect spec.
5224     (see http://xml.apache.org/xalan-j/apidocs/org/apache/xalan/lib/Redirect.html)<alt>M: /trunk/xsl/html/oldchunker.xsl; M: /trunk/xsl/html/chunker.xsl; M: /trunk/xsl/html/graphics.xsl; M: /trunk/xsl/html/callout.xsl; M: /trunk/xsl/html/autoidx-kimber.xsl; M: /trunk/xsl/html/autoidx-kosek.xsl; M: /trunk/xsl/html/table.xsl; M: /trunk/xsl/html/verbatim.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5225 </listitem>
5226 <listitem>
5227 <literallayout><phrase role="commit-message">Added the <parameter>html.append</parameter> and <parameter>chunk.append</parameter> parameters. By default, the
5228 value of both is empty; but the internal DocBook XSL stylesheets
5229 build sets their value to "&lt;xsl:text&gt;&amp;#x0a;&lt;/xsl:text&gt;", in order
5230 to ensure that all files in the docbook-xsl-doc package end in a
5231 newline character. (Because diff and some other tools may emit
5232 error messages and/or not behave as expected when processing
5233 files that are not newline-terminated.)<alt>M: /trunk/xsl/html/chunk-common.xsl; M: /trunk/xsl/html/titlepage.xsl; M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/docbook.xsl; M: /trunk/xsl/html/graphics.xsl; M: /trunk/xsl/html/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
5234 </listitem>
5235 </itemizedlist>
5236 </sect2><!--end of HTML changes for 1.71.1-->
5237
5238 <sect2 xml:id="V1.71.1_Highlighting">
5239 <title>Highlighting</title>
5240 <para>The following changes have been made to the
5241             <filename>highlighting</filename> code
5242             since the 1.71.1 release.</para>
5243 <itemizedlist>
5244 <listitem>
5245 <literallayout><phrase role="commit-message">Added license information<alt>M: /trunk/xsl/highlighting/delphi-hl.xml; M: /trunk/xsl/highlighting/myxml-hl.xml; M: /trunk/xsl/highlighting/php-hl.xml; M: /trunk/xsl/highlighting/m2-hl.xml; M: /trunk/xsl/highlighting/ini-hl.xml; M: /trunk/xsl/highlighting/xslthl-config.xml; M: /trunk/xsl/highlighting/java-hl.xml - Jirka Kosek</alt></phrase></literallayout>
5246 </listitem>
5247 </itemizedlist>
5248 </sect2><!--end of Highlighting changes for 1.71.1-->
5249
5250 <sect2 xml:id="V1.71.1_Manpages">
5251 <title>Manpages</title>
5252 <para>The following changes have been made to the
5253             <filename>manpages</filename> code
5254             since the 1.71.1 release.</para>
5255 <itemizedlist>
5256 <listitem>
5257 <literallayout><phrase role="commit-message">Added initial support in manpages output for <tag>footnote</tag>, <tag>annotation</tag>,
5258 and <tag>alt</tag> instances. Basically, they all now get handled the same
5259 way ulink instances are. They are treated as a class as "note
5260 sources": A numbered marker is generated at the place in the main
5261 text flow where they occur, then their contents are displayed in
5262 an endnotes <tag>section</tag> at the end of the man page (currently titled
5263 REFERENCES, for English output, but will be changed to NOTES).
5264
5265 This support is not yet complete. It works for most "normal"
5266 cases, but probably mishandles a good number of cases. More
5267 testing will be needed to expose the problems. It may well also
5268 introduce some bugs and regressions in other areas, including
5269 basic paragraph handling, handling of "mixed block" content,
5270 handling of other indented content, and handling of authorblurb
5271 and <tag>personblurb</tag> in the AUTHORS <tag>section</tag>.<alt>M: /trunk/xsl/manpages/table.xsl; M: /trunk/xsl/manpages/block.xsl; M: /trunk/xsl/manpages/docbook.xsl; M: /trunk/xsl/manpages/links.xsl; M: /trunk/xsl/manpages/other.xsl; M: /trunk/xsl/manpages/utility.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5272 </listitem>
5273 </itemizedlist>
5274 </sect2><!--end of Manpages changes for 1.71.1-->
5275
5276 <sect2 xml:id="V1.71.1_Params">
5277 <title>Params</title>
5278 <para>The following changes have been made to the
5279             <filename>params</filename> code
5280             since the 1.71.1 release.</para>
5281 <itemizedlist>
5282 <listitem>
5283 <literallayout><phrase role="commit-message">Added support for profiling based on xml:lang and status attributes.<alt>A: /trunk/xsl/params/profile.status.xml - Jirka Kosek</alt></phrase></literallayout>
5284 </listitem>
5285 <listitem>
5286 <literallayout><phrase role="commit-message">Added the <parameter>html.append</parameter> and <parameter>chunk.append</parameter> parameters. By default, the
5287 value of both is empty; but the internal DocBook XSL stylesheets
5288 build sets their value to "&lt;xsl:text&gt;&amp;#x0a;&lt;/xsl:text&gt;", in order
5289 to ensure that all files in the docbook-xsl-doc <tag>package</tag> end in a
5290 newline character. (Because diff and some other tools may emit
5291 error messages and/or not behave as expected when processing
5292 files that are not newline-terminated.)<alt>A: /trunk/xsl/params/html.append.xml; A: /trunk/xsl/params/chunk.append.xml - Michael(tm) Smith</alt></phrase></literallayout>
5293 </listitem>
5294 </itemizedlist>
5295 </sect2><!--end of Params changes for 1.71.1-->
5296
5297 <sect2 xml:id="V1.71.1_Profiling">
5298 <title>Profiling</title>
5299 <para>The following changes have been made to the
5300             <filename>profiling</filename> code
5301             since the 1.71.1 release.</para>
5302 <itemizedlist>
5303 <listitem>
5304 <literallayout><phrase role="commit-message">Added support for profiling based on xml:lang and status attributes.<alt>M: /trunk/xsl/profiling/profile.xsl; M: /trunk/xsl/profiling/profile-mode.xsl - Jirka Kosek</alt></phrase></literallayout>
5305 </listitem>
5306 </itemizedlist>
5307 </sect2><!--end of Profiling changes for 1.71.1-->
5308
5309 </sect1>
5310
5311 <sect1 xml:id="V1.71.0">
5312 <title>Release: 1.71.0</title>
5313 <para>This is mainly a bug fix release, but it also includes two
5314 significant feature changes:
5315 <variablelist>
5316   <varlistentry>
5317     <term>Highlighting support added</term>
5318     <listitem>
5319       <para>The stylesheets now include support for source-code
5320       highlighting in output of programlisting instances (controlled
5321       through the <parameter>highlight.source</parameter>
5322       parameter). The Java-based implementation requires Saxon and
5323       makes use of <link
5324       xlink:href="http://molhanec.net/"><person><personname
5325       ><firstname>Michal</firstname><surname
5326       >Molhanec</surname></personname></person></link>’s <link
5327       xlink:href="http://sourceforge.net/projects/xslthl"
5328       >XSLTHL</link>. More details are available at Jirka Kosek’s
5329       website: <blockquote ><simpara ><link
5330       xlink:href="http://xmlguru.cz/2006/07/docbook-syntax-highlighting"/></simpara
5331       ></blockquote> The support is currently limited to highlighting
5332       of XML, Java, PHP, Delphi, Modula-2 sources, and INI
5333       files.</para>
5334     </listitem>
5335   </varlistentry>
5336   <varlistentry>
5337     <term>Changes to autoindexing</term>
5338     <listitem>
5339       <para>The templates that handle alternative indexing methods
5340       were reworked to avoid errors produced by certain processors not
5341       being able to tolerate the presence of unused functions.  With
5342       this release, none of the code for the 'kimber' or 'kosek'
5343       methods is included in the default stylesheets.  In order to use
5344       one of those methods, your customization layer must import one
5345       of the optional stylesheet modules:</para>
5346       <para>
5347         <itemizedlist>
5348            <listitem>
5349              <simpara>html/autoidx-kosek.xsl</simpara>
5350            </listitem>
5351            <listitem>
5352              <simpara>html/autoidx-kimber.xsl</simpara>
5353            </listitem>
5354            <listitem>
5355              <simpara>fo/autoidx-kosek.xsl</simpara>
5356            </listitem>
5357            <listitem>
5358              <simpara>fo/autoidx-kimber.xsl</simpara>
5359            </listitem>
5360         </itemizedlist>
5361         See the <parameter>index.method</parameter> parameter
5362         reference page for more information.
5363       </para>
5364       <para>Two other changes to note:
5365       <itemizedlist>
5366         <listitem>
5367           <simpara>The default indexing method now can handle accented
5368           characters in latin-based alphabets, not just English. This
5369           means accented latin letters will group and sort with their
5370           unaccented counterpart.</simpara>
5371         </listitem>
5372         <listitem>
5373           <simpara>The default value for the
5374           <parameter>index.method</parameter> parameter was changed
5375           from 'english' to 'basic' because now the default method can
5376           handle latin-based alphabets, not just English.</simpara>
5377         </listitem>
5378       </itemizedlist>
5379       </para>
5380     </listitem>
5381   </varlistentry>
5382 </variablelist>
5383 The following is a list of changes that have
5384 been made since the 1.70.1 release.</para>
5385
5386 <sect2 xml:id="V1.71.0_Common">
5387 <title>Common</title>
5388 <para>The following changes have been made to the
5389             <filename>common</filename> code
5390             since the 1.70.1 release.</para>
5391 <itemizedlist>
5392
5393 <listitem>
5394 <literallayout><phrase role="commit-message">Added <parameter>reference.autolabel</parameter> parameter for controlling labels on
5395 <tag>reference</tag> output.<alt>M: /trunk/xsl/common/labels.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5396 </listitem>
5397 <listitem>
5398 <literallayout><phrase role="commit-message">Support <tag>row</tag>s that are *completely* overlapped by the preceding <tag>row</tag><alt>M: /trunk/xsl/common/table.xsl - Norman Walsh</alt></phrase></literallayout>
5399 </listitem>
5400 <listitem>
5401 <literallayout><phrase role="commit-message">New modules for supporting indexing extensions.<alt>A: /trunk/xsl/common/autoidx-kimber.xsl; A: /trunk/xsl/common/autoidx-kosek.xsl - Robert Stayton</alt></phrase></literallayout>
5402 </listitem>
5403 <listitem>
5404 <literallayout><phrase role="commit-message">Support startinglinenumber on <tag>orderedlist</tag><alt>M: /trunk/xsl/common/common.xsl - Norman Walsh</alt></phrase></literallayout>
5405 </listitem>
5406 </itemizedlist>
5407 </sect2><!--end of Common changes for 1.71.0-->
5408
5409 <sect2 xml:id="V1.71.0_Extensions">
5410 <title>Extensions</title>
5411 <para>The following changes have been made to the
5412             <filename>extensions</filename> code
5413             since the 1.70.1 release.</para>
5414 <itemizedlist>
5415 <listitem>
5416 <literallayout><phrase role="commit-message">Completely reworked extensions build system; now uses NetBeans and ant<alt>D: /trunk/xsl/extensions/xalan27/.cvsignore; A: /trunk/xsl/extensions/saxon65/nbproject; A: /trunk/xsl/extensions/saxon65/nbproject/project.properties; D: /trunk/xsl/extensions/prj.el; A: /trunk/xsl/extensions/saxon65/src; A: /trunk/xsl/extensions/xalan2/src/com; M: /trunk/xsl/extensions/xalan2/src/com/nwalsh/xalan/Text.java; A: /trunk/xsl/extensions/saxon65/nbproject/project.xml; D: /trunk/xsl/extensions/build.xml; A: /trunk/xsl/extensions/saxon65/build.xml; A: /trunk/xsl/extensions/xalan2/nbproject/genfiles.properties; A: /trunk/xsl/extensions/saxon65; D: /trunk/xsl/extensions/xalan2/com; M: /trunk/xsl/extensions/xalan2/src/com/nwalsh/xalan/Func.java; A: /trunk/xsl/extensions/xalan2/test; A: /trunk/xsl/extensions/saxon65/src/com; A: /trunk/xsl/extensions/xalan2/nbproject/build-impl.xml; A: /trunk/xsl/extensions/xalan2/nbproject; A: /trunk/xsl/extensions/xalan2/src; A: /trunk/xsl/extensions/xalan2/nbproject/project.properties; D: /trunk/xsl/extensions/.cvsignore; M: /trunk/xsl/extensions/Makefile; D: /trunk/xsl/extensions/saxon8; A: /trunk/xsl/extensions/saxon65/nbproject/genfiles.properties; A: /trunk/xsl/extensions/xalan2/nbproject/project.xml; A: /trunk/xsl/extensions/saxon65/test; M: /trunk/xsl/extensions/xalan2/src/com/nwalsh/xalan/Verbatim.java; A: /trunk/xsl/extensions/xalan2/build.xml; M: /trunk/xsl/extensions/xalan2; D: /trunk/xsl/extensions/saxon643; A: /trunk/xsl/extensions/saxon65/nbproject/build-impl.xml - Norman Walsh</alt></phrase></literallayout>
5417 </listitem>
5418 </itemizedlist>
5419 </sect2><!--end of Extensions changes for 1.71.0-->
5420
5421 <sect2 xml:id="V1.71.0_FO">
5422 <title>FO</title>
5423 <para>The following changes have been made to the
5424             <filename>fo</filename> code
5425             since the 1.70.1 release.</para>
5426 <itemizedlist>
5427
5428 <listitem>
5429 <literallayout><phrase role="commit-message">xsl:sort lang attribute now uses two-char substring of lang attribute.<alt>M: /trunk/xsl/fo/autoidx-kimber.xsl - Robert Stayton</alt></phrase></literallayout>
5430 </listitem>
5431
5432 <listitem>
5433 <literallayout><phrase role="commit-message">Support titlecase "Java", "Perl", and "IDL" as values for the
5434 language attribute on <tag>classsynopsis</tag>, etc. (instead of just
5435 lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
5436 (instead of just "cpp").
5437
5438 Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
5439 to "Brian A. Vanderburg II".<alt>M: /trunk/xsl/fo/synop.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5440 </listitem>
5441
5442 <listitem>
5443 <literallayout><phrase role="commit-message">Added support for the <parameter>reference.autolabel</parameter> param in (X)HTML and FO
5444 output.<alt>M: /trunk/xsl/fo/param.xweb; M: /trunk/xsl/fo/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
5445 </listitem>
5446
5447 <listitem>
5448 <literallayout><phrase role="commit-message">Support <tag>row</tag>s that are *completely* overlapped by the preceding <tag>row</tag><alt>M: /trunk/xsl/fo/table.xsl - Norman Walsh</alt></phrase></literallayout>
5449 </listitem>
5450
5451 <listitem>
5452 <literallayout><phrase role="commit-message">Rearranged templates for the 3 indexing methods
5453 and changed method named 'english' to 'basic'.<alt>M: /trunk/xsl/fo/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
5454 </listitem>
5455 <listitem>
5456 <literallayout><phrase role="commit-message">New modules for supporting indexing extensions.<alt>A: /trunk/xsl/fo/autoidx-kimber.xsl; A: /trunk/xsl/fo/autoidx-kosek.xsl - Robert Stayton</alt></phrase></literallayout>
5457 </listitem>
5458
5459 <listitem>
5460 <literallayout><phrase role="commit-message">Turn off blank-body for <parameter>fop1.extensions</parameter> too since fop 0.92
5461 does not support it either.<alt>M: /trunk/xsl/fo/pagesetup.xsl - Robert Stayton</alt></phrase></literallayout>
5462 </listitem>
5463
5464 <listitem>
5465 <literallayout><phrase role="commit-message">Add Xalan variant to test for exslt:node-set <tag>function</tag>.
5466 Xalan can use <tag>function</tag> named node-set(), but doesn't
5467 recognize it using function-available().<alt>M: /trunk/xsl/fo/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
5468 </listitem>
5469
5470 <listitem>
5471 <literallayout><phrase role="commit-message">Added support to FO stylesheets for handling instances of <tag>Org</tag>
5472 where it occurs outside of *<tag>info</tag> content. In HTML stylesheets,
5473 moved handling of <tag>Org</tag> out of info.xsl and into inline.xsl. In both
5474 FO and HTML stylesheets, added support for correctly processing
5475 <tag>Affiliation</tag> and <tag>Jobtitle</tag>.<alt>M: /trunk/xsl/fo/inline.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5476 </listitem>
5477 <listitem>
5478 <literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
5479 <tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
5480 instances, and removed some debugging stuff that was generated in
5481 manpages output to mark the ends of sections.<alt>M: /trunk/xsl/fo/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5482 </listitem>
5483 <listitem>
5484 <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
5485 default), delimiters are generated around e-mail addresses (output
5486 of the <tag>email</tag> element). If zero, the delimiters are suppressed.<alt>M: /trunk/xsl/fo/inline.xsl; M: /trunk/xsl/fo/param.xweb; M: /trunk/xsl/fo/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
5487 </listitem>
5488
5489 <listitem>
5490 <literallayout><phrase role="commit-message">Initial support of syntax highlighting of programlistings.<alt>M: /trunk/xsl/fo/param.ent; M: /trunk/xsl/fo/param.xweb; A: /trunk/xsl/fo/highlight.xsl; M: /trunk/xsl/fo/verbatim.xsl - Jirka Kosek</alt></phrase></literallayout>
5491 </listitem>
5492 <listitem>
5493 <literallayout><phrase role="commit-message"><tag>Chapter</tag> after <tag>preface</tag> should restart numbering of pages.<alt>M: /trunk/xsl/fo/pagesetup.xsl - Jirka Kosek</alt></phrase></literallayout>
5494 </listitem>
5495 </itemizedlist>
5496 </sect2><!--end of FO changes for 1.71.0-->
5497
5498 <sect2 xml:id="V1.71.0_HTML">
5499 <title>HTML</title>
5500 <para>The following changes have been made to the
5501             <filename>html</filename> code
5502             since the 1.70.1 release.</para>
5503 <itemizedlist>
5504
5505 <listitem>
5506 <literallayout><phrase role="commit-message">xsl:sort lang attribute now uses two-char substring of lang attribute.<alt>M: /trunk/xsl/html/autoidx-kimber.xsl - Robert Stayton</alt></phrase></literallayout>
5507 </listitem>
5508 <listitem>
5509 <literallayout><phrase role="commit-message">Support titlecase "Java", "Perl", and "IDL" as values for the
5510 language attribute on <tag>classsynopsis</tag>, etc. (instead of just
5511 lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
5512 (instead of just "cpp").
5513
5514 Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
5515 to "Brian A. Vanderburg II".<alt>M: /trunk/xsl/html/synop.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5516 </listitem>
5517
5518 <listitem>
5519 <literallayout><phrase role="commit-message">Added support for the <parameter>reference.autolabel</parameter> param in (X)HTML and FO
5520 output.<alt>M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
5521 </listitem>
5522 <listitem>
5523 <literallayout><phrase role="commit-message">Support <tag>row</tag>s that are *completely* overlapped by the preceding <tag>row</tag><alt>M: /trunk/xsl/html/table.xsl - Norman Walsh</alt></phrase></literallayout>
5524 </listitem>
5525
5526 <listitem>
5527 <literallayout><phrase role="commit-message">Rearranged templates for the 3 indexing methods
5528 and changed method named 'english' to 'basic'.<alt>M: /trunk/xsl/html/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
5529 </listitem>
5530 <listitem>
5531 <literallayout><phrase role="commit-message">New modules for supporting indexing extensions.<alt>A: /trunk/xsl/html/autoidx-kimber.xsl; A: /trunk/xsl/html/autoidx-kosek.xsl - Robert Stayton</alt></phrase></literallayout>
5532 </listitem>
5533
5534 <listitem>
5535 <literallayout><phrase role="commit-message">Added several new HTML parameters for controlling appearance of
5536 content on HTML <tag>title</tag> pages:
5537
5538 <parameter>contrib.inline.enabled</parameter>:
5539   If non-zero (the default), output of the <tag>contrib</tag> element is
5540   displayed as inline content rather than as block content.
5541
5542 <parameter>othercredit.like.author.enabled</parameter>:
5543   If non-zero, output of the <tag>othercredit</tag> element on titlepages is
5544   displayed in the same style as <tag>author</tag> and <tag>editor</tag> output. If zero
5545   (the default), <tag>othercredit</tag> output is displayed using a style
5546   different than that of <tag>author</tag> and <tag>editor</tag>.
5547
5548 <parameter>blurb.on.titlepage.enabled</parameter>:
5549   If non-zero, output from authorblurb and <tag>personblurb</tag> elements is
5550   displayed on <tag>title</tag> pages. If zero (the default), output from
5551   those elements is suppressed on <tag>title</tag> pages (unless you are
5552   using a titlepage customization that causes them to be included).
5553
5554 <parameter>editedby.enabled</parameter>
5555   If non-zero (the default), a localized Edited by heading is
5556   displayed above <tag>editor</tag> names in output of the <tag>editor</tag> element.<alt>M: /trunk/xsl/html/titlepage.xsl; M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
5557 </listitem>
5558
5559 <listitem>
5560 <literallayout><phrase role="commit-message">Add Xalan variant to test for exslt:node-set <tag>function</tag>.
5561 Xalan can use <tag>function</tag> named node-set(), but doesn't
5562 recognize it using function-available().<alt>M: /trunk/xsl/html/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
5563 </listitem>
5564
5565 <listitem>
5566 <literallayout><phrase role="commit-message">Added support to FO stylesheets for handling instances of <tag>Org</tag>
5567 where it occurs outside of *<tag>info</tag> content. In HTML stylesheets,
5568 moved handling of <tag>Org</tag> out of info.xsl and into inline.xsl. In both
5569 FO and HTML stylesheets, added support for correctly processing
5570 <tag>Affiliation</tag> and <tag>Jobtitle</tag>.<alt>M: /trunk/xsl/html/inline.xsl; M: /trunk/xsl/html/info.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5571 </listitem>
5572 <listitem>
5573 <literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
5574 <tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
5575 instances, and removed some debugging stuff that was generated in
5576 manpages output to mark the ends of sections.<alt>M: /trunk/xsl/html/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5577 </listitem>
5578 <listitem>
5579 <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
5580 default), delimiters are generated around e-mail addresses (output
5581 of the <tag>email</tag> element). If zero, the delimiters are suppressed.<alt>M: /trunk/xsl/html/inline.xsl; M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
5582 </listitem>
5583
5584 <listitem>
5585 <literallayout><phrase role="commit-message">Added <parameter>qanda.nested.in.toc</parameter> param. Default value is zero. If
5586 non-zero, instances of "nested" <tag>Qandaentry</tag> (ones that are children
5587 of <tag>Answer</tag> elements) are displayed in the <tag>TOC</tag>. Closes patch 1509018
5588 (from Daniel Leidert). Currently on affects HTML output (no patch
5589 for FO output provided).<alt>M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent; M: /trunk/xsl/html/qandaset.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5590 </listitem>
5591
5592
5593 <listitem>
5594 <literallayout><phrase role="commit-message">Improved handling of relative locations generated files<alt>M: /trunk/xsl/html/html.xsl - Jirka Kosek</alt></phrase></literallayout>
5595 </listitem>
5596
5597 <listitem>
5598 <literallayout><phrase role="commit-message">Initial support of syntax highlighting of programlistings.<alt>M: /trunk/xsl/html/param.ent; M: /trunk/xsl/html/param.xweb; A: /trunk/xsl/html/highlight.xsl; M: /trunk/xsl/html/verbatim.xsl - Jirka Kosek</alt></phrase></literallayout>
5599 </listitem>
5600 <listitem>
5601 <literallayout><phrase role="commit-message">Support <tag>org</tag><alt>M: /trunk/xsl/html/info.xsl - Norman Walsh</alt></phrase></literallayout>
5602 </listitem>
5603 <listitem>
5604 <literallayout><phrase role="commit-message">Support <tag>person</tag><alt>M: /trunk/xsl/html/inline.xsl - Norman Walsh</alt></phrase></literallayout>
5605 </listitem>
5606 <listitem>
5607 <literallayout><phrase role="commit-message">Support $keep.relative.image.uris also when chunking<alt>M: /trunk/xsl/html/chunk-code.xsl - Jirka Kosek</alt></phrase></literallayout>
5608 </listitem>
5609 </itemizedlist>
5610 </sect2><!--end of HTML changes for 1.71.0-->
5611
5612 <sect2 xml:id="V1.71.0_Highlighting">
5613 <title>Highlighting</title>
5614 <para>The following changes have been made to the
5615             <filename>highlighting</filename> code
5616             since the 1.70.1 release.</para>
5617 <itemizedlist>
5618
5619 <listitem>
5620 <literallayout><phrase role="commit-message">Initial support of syntax highlighting of programlistings.<alt>A: /trunk/xsl/highlighting/php-hl.xml; A: /trunk/xsl/highlighting/common.xsl; A: /trunk/xsl/highlighting/delphi-hl.xml; A: /trunk/xsl/highlighting/myxml-hl.xml; A: /trunk/xsl/highlighting/m2-hl.xml; A: /trunk/xsl/highlighting/ini-hl.xml; A: /trunk/xsl/highlighting/xslthl-config.xml; A: /trunk/xsl/highlighting/java-hl.xml - Jirka Kosek</alt></phrase></literallayout>
5621 </listitem>
5622 </itemizedlist>
5623 </sect2><!--end of Highlighting changes for 1.71.0-->
5624
5625 <sect2 xml:id="V1.71.0_Manpages">
5626 <title>Manpages</title>
5627 <para>The following changes have been made to the
5628             <filename>manpages</filename> code
5629             since the 1.70.1 release.</para>
5630 <itemizedlist>
5631
5632 <listitem>
5633 <literallayout><phrase role="commit-message">Suppress <tag>footnote</tag> markers and output warning that footnotes are
5634 not yet supported.<alt>M: /trunk/xsl/manpages/docbook.xsl; M: /trunk/xsl/manpages/links.xsl; M: /trunk/xsl/manpages/other.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5635 </listitem>
5636
5637 <listitem>
5638 <literallayout><phrase role="commit-message">Handle instances of <tag>address</tag>/<tag>otheraddr</tag>/ulink in <tag>author</tag> et al in the
5639 same way as <tag>email</tag> instances; that is, display them on the same
5640 linke as the <tag>author</tag>, <tag>editor</tag>, etc., name.<alt>M: /trunk/xsl/manpages/info.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5641 </listitem>
5642 <listitem>
5643 <literallayout><phrase role="commit-message">Don't number or link-list any Ulink instance whose string value is
5644 identical to the value of its url attribute. Just display it inline.<alt>M: /trunk/xsl/manpages/links.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5645 </listitem>
5646
5647 <listitem>
5648 <literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
5649 <tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
5650 instances, and removed some debugging stuff that was generated in
5651 manpages output to mark the ends of sections.<alt>M: /trunk/xsl/manpages/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5652 </listitem>
5653 <listitem>
5654 <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
5655 default), delimiters are generated around e-mail addresses (output
5656 of the <tag>email</tag> element). If zero, the delimiters are suppressed.<alt>M: /trunk/xsl/manpages/param.xweb; M: /trunk/xsl/manpages/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
5657 </listitem>
5658
5659 <listitem>
5660 <literallayout><phrase role="commit-message">In manpages output, if the last/nearest *<tag>info</tag> element for
5661 particular <tag>Refentry</tag> has multiple <tag>Copyright</tag> and/or <tag>Legalnotice</tag>
5662 children, process them all (not just the first ones). Closes bug
5663 1524576. Thanks to Sam Steingold for the report and to Daniel
5664 Leidert for providing a patch.<alt>M: /trunk/xsl/manpages/info.xsl - Michael(tm) Smith</alt></phrase></literallayout>
5665 </listitem>
5666
5667 </itemizedlist>
5668 </sect2><!--end of Manpages changes for 1.71.0-->
5669
5670 <sect2 xml:id="V1.71.0_Params">
5671 <title>Params</title>
5672 <para>The following changes have been made to the
5673             <filename>params</filename> code
5674             since the 1.70.1 release.</para>
5675 <itemizedlist>
5676 <listitem>
5677 <literallayout><phrase role="commit-message">Added <parameter>reference.autolabel</parameter> parameter for controlling labels on
5678 <tag>reference</tag> output.<alt>A: /trunk/xsl/params/reference.autolabel.xml - Michael(tm) Smith</alt></phrase></literallayout>
5679 </listitem>
5680 <listitem>
5681 <literallayout><phrase role="commit-message">Added namespace declarations to document elements for all param files.<alt>M: /trunk/xsl/params/toc.line.properties.xml; M: /trunk/xsl/params/title.font.family.xml; M: /trunk/xsl/params/component.label.includes.part.label.xml; M: /trunk/xsl/params/refentry.manual.profile.xml; M: /trunk/xsl/params/orderedlist.properties.xml; M: /trunk/xsl/params/olink.pubid.xml; M: /trunk/xsl/params/informalexample.properties.xml; M: /trunk/xsl/params/appendix.autolabel.xml; M: /trunk/xsl/params/htmlhelp.show.toolbar.text.xml; M: /trunk/xsl/params/index.on.role.xml; M: /trunk/xsl/params/htmlhelp.button.jump2.url.xml; M: /trunk/xsl/params/variablelist.term.separator.xml; M: /trunk/xsl/params/para.propagates.style.xml; M: /trunk/xsl/params/html.stylesheet.xml; M: /trunk/xsl/params/qanda.nested.in.toc.xml; M: /trunk/xsl/params/annotation.css.xml; M: /trunk/xsl/params/funcsynopsis.style.xml; M: /trunk/xsl/params/htmlhelp.encoding.xml; M: /trunk/xsl/params/footer.content.properties.xml; M: /trunk/xsl/params/verbatim.properties.xml; M: /trunk/xsl/params/autotoc.label.in.hyperlink.xml; M: /trunk/xsl/params/body.margin.top.xml; M: /trunk/xsl/params/bibliography.numbered.xml; M: /trunk/xsl/params/figure.properties.xml; M: /trunk/xsl/params/variablelist.max.termlength.xml; M: /trunk/xsl/params/table.cell.border.style.xml; M: /trunk/xsl/params/htmlhelp.button.options.xml; M: /trunk/xsl/params/preferred.mediaobject.role.xml; M: /trunk/xsl/params/htmlhelp.chm.xml; M: /trunk/xsl/params/man.charmap.subset.profile.xml; M: /trunk/xsl/params/qanda.title.level3.properties.xml; M: /trunk/xsl/params/page.width.xml; M: /trunk/xsl/params/firstterm.only.link.xml; M: /trunk/xsl/params/section.level6.properties.xml; M: /trunk/xsl/params/htmlhelp.button.locate.xml; M: /trunk/xsl/params/chunk.sections.xml; M: /trunk/xsl/params/use.local.olink.style.xml; M: /trunk/xsl/params/refentry.date.profile.enabled.xml; M: /trunk/xsl/params/refentry.version.suppress.xml; M: /trunk/xsl/params/refentry.generate.title.xml; M: /trunk/xsl/params/punct.honorific.xml; M: /trunk/xsl/params/column.gap.index.xml; M: /trunk/xsl/params/body.start.indent.xml; M: /trunk/xsl/params/crop.mark.width.xml; M: /trunk/xsl/params/refentry.version.profile.enabled.xml; M: /trunk/xsl/params/superscript.properties.xml; M: /trunk/xsl/params/chunker.output.doctype-public.xml; M: /trunk/xsl/params/saxon.character.representation.xml; M: /trunk/xsl/params/saxon.linenumbering.xml; M: /trunk/xsl/params/shade.verbatim.style.xml; M: /trunk/xsl/params/annotate.toc.xml; M: /trunk/xsl/params/profile.attribute.xml; M: /trunk/xsl/params/callout.graphics.number.limit.xml; M: /trunk/xsl/params/profile.arch.xml; M: /trunk/xsl/params/saxon.tablecolumns.xml; M: /trunk/xsl/params/glossterm.auto.link.xml; M: /trunk/xsl/params/default.units.xml; M: /trunk/xsl/params/qanda.title.level1.properties.xml; M: /trunk/xsl/params/list.block.spacing.xml; M: /trunk/xsl/params/section.level4.properties.xml; M: /trunk/xsl/params/spacing.paras.xml; M: /trunk/xsl/params/column.count.index.xml; M: /trunk/xsl/params/dingbat.font.family.xml; M: /trunk/xsl/params/citerefentry.link.xml; M: /trunk/xsl/params/keep.relative.image.uris.xml; M: /trunk/xsl/params/ulink.footnotes.xml; M: /trunk/xsl/params/prefer.internal.olink.xml; M: /trunk/xsl/params/refentry.title.properties.xml; M: /trunk/xsl/params/variablelist.term.break.after.xml; M: /trunk/xsl/params/use.id.function.xml; M: /trunk/xsl/params/callout.unicode.start.character.xml; M: /trunk/xsl/params/column.gap.titlepage.xml; M: /trunk/xsl/params/editedby.enabled.xml; M: /trunk/xsl/params/funcsynopsis.tabular.threshold.xml; M: /trunk/xsl/params/use.extensions.xml; M: /trunk/xsl/params/index.preferred.page.properties.xml; M: /trunk/xsl/params/man.th.extra3.max.length.xml; M: /trunk/xsl/params/column.gap.back.xml; M: /trunk/xsl/params/tex.math.delims.xml; M: /trunk/xsl/params/article.appendix.title.properties.xml; M: /trunk/xsl/params/ulink.target.xml; M: /trunk/xsl/params/suppress.header.navigation.xml; M: /trunk/xsl/params/olink.resolver.xml; M: /trunk/xsl/params/admon.textlabel.xml; M: /trunk/xsl/params/procedure.properties.xml; M: /trunk/xsl/params/blurb.on.titlepage.enabled.xml; M: /trunk/xsl/params/section.level2.properties.xml; M: /trunk/xsl/params/column.gap.front.xml; M: /trunk/xsl/params/margin.note.title.properties.xml; M: /trunk/xsl/params/glossary.collection.xml; M: /trunk/xsl/params/admon.graphics.xml; M: /trunk/xsl/params/current.docid.xml; M: /trunk/xsl/params/qanda.inherit.numeration.xml; M: /trunk/xsl/params/table.cell.padding.xml; M: /trunk/xsl/params/preface.autolabel.xml; M: /trunk/xsl/params/man.th.extra3.suppress.xml; M: /trunk/xsl/params/wordml.template.xml; M: /trunk/xsl/params/htmlhelp.use.hhk.xml; M: /trunk/xsl/params/textinsert.extension.xml; M: /trunk/xsl/params/ebnf.table.bgcolor.xml; M: /trunk/xsl/params/refentry.source.fallback.profile.xml; M: /trunk/xsl/params/body.font.master.xml; M: /trunk/xsl/params/l10n.gentext.default.language.xml; M: /trunk/xsl/params/list.block.properties.xml; M: /trunk/xsl/params/refentry.source.name.suppress.xml; M: /trunk/xsl/params/htmlhelp.hhp.window.xml; M: /trunk/xsl/params/sidebar.properties.xml; M: /trunk/xsl/params/tex.math.file.xml; M: /trunk/xsl/params/man.justify.xml; M: /trunk/xsl/params/subscript.properties.xml; M: /trunk/xsl/params/column.count.front.xml; M: /trunk/xsl/params/index.term.separator.xml; M: /trunk/xsl/params/biblioentry.properties.xml; M: /trunk/xsl/params/biblioentry.item.separator.xml; M: /trunk/xsl/params/htmlhelp.button.home.url.xml; M: /trunk/xsl/params/column.count.body.xml; M: /trunk/xsl/params/suppress.navigation.xml; M: /trunk/xsl/params/htmlhelp.remember.window.position.xml; M: /trunk/xsl/params/htmlhelp.hhc.section.depth.xml; M: /trunk/xsl/params/xref.with.number.and.title.xml; M: /trunk/xsl/params/make.year.ranges.xml; M: /trunk/xsl/params/region.before.extent.xml; M: /trunk/xsl/params/xref.label-page.separator.xml; M: /trunk/xsl/params/html.longdesc.link.xml; M: /trunk/xsl/params/man.subheading.divider.enabled.xml; M: /trunk/xsl/params/index.entry.properties.xml; M: /trunk/xsl/params/generate.legalnotice.link.xml; M: /trunk/xsl/params/section.autolabel.xml; M: /trunk/xsl/params/html.base.xml; M: /trunk/xsl/params/suppress.footer.navigation.xml; M: /trunk/xsl/params/nominal.image.depth.xml; M: /trunk/xsl/params/table.footnote.number.symbols.xml; M: /trunk/xsl/params/table.footnote.number.format.xml; M: /trunk/xsl/params/callout.graphics.xml; M: /trunk/xsl/params/man.break.after.slash.xml; M: /trunk/xsl/params/function.parens.xml; M: /trunk/xsl/params/part.autolabel.xml; M: /trunk/xsl/params/saxon.callouts.xml; M: /trunk/xsl/params/css.decoration.xml; M: /trunk/xsl/params/htmlhelp.button.home.xml; M: /trunk/xsl/params/email.delimiters.enabled.xml; M: /trunk/xsl/params/column.count.lot.xml; M: /trunk/xsl/params/draft.mode.xml; M: /trunk/xsl/params/use.role.for.mediaobject.xml; M: /trunk/xsl/params/refentry.separator.xml; M: /trunk/xsl/params/man.font.funcsynopsisinfo.xml; M: /trunk/xsl/params/man.output.manifest.filename.xml; M: /trunk/xsl/params/process.empty.source.toc.xml; M: /trunk/xsl/params/man.output.in.separate.dir.xml; M: /trunk/xsl/params/graphicsize.use.img.src.path.xml; M: /trunk/xsl/params/man.output.encoding.xml; M: /trunk/xsl/params/column.gap.lot.xml; M: /trunk/xsl/params/profile.role.xml; M: /trunk/xsl/params/column.count.titlepage.xml; M: /trunk/xsl/params/show.comments.xml; M: /trunk/xsl/params/informalfigure.properties.xml; M: /trunk/xsl/params/entry.propagates.style.xml; M: /trunk/xsl/params/bibliography.collection.xml; M: /trunk/xsl/params/contrib.inline.enabled.xml; M: /trunk/xsl/params/section.title.level5.properties.xml; M: /trunk/xsl/params/fop.extensions.xml; M: /trunk/xsl/params/htmlhelp.button.jump1.xml; M: /trunk/xsl/params/man.hyphenate.urls.xml; M: /trunk/xsl/params/profile.condition.xml; M: /trunk/xsl/params/header.column.widths.xml; M: /trunk/xsl/params/annotation.js.xml; M: /trunk/xsl/params/chunker.output.standalone.xml; M: /trunk/xsl/params/targets.filename.xml; M: /trunk/xsl/params/default.float.class.xml; M: /trunk/xsl/params/chapter.autolabel.xml; M: /trunk/xsl/params/sidebar.float.type.xml; M: /trunk/xsl/params/profile.separator.xml; M: /trunk/xsl/params/generate.index.xml; M: /trunk/xsl/params/nongraphical.admonition.properties.xml; M: /trunk/xsl/params/navig.graphics.xml; M: /trunk/xsl/params/htmlhelp.button.next.xml; M: /trunk/xsl/params/insert.olink.pdf.frag.xml; M: /trunk/xsl/params/htmlhelp.button.stop.xml; M: /trunk/xsl/params/footnote.font.size.xml; M: /trunk/xsl/params/profile.value.xml; M: /trunk/xsl/params/ebnf.table.border.xml; M: /trunk/xsl/params/htmlhelp.hhc.folders.instead.books.xml; M: /trunk/xsl/params/glossary.as.blocks.xml; M: /trunk/xsl/params/body.end.indent.xml; M: /trunk/xsl/params/use.role.as.xrefstyle.xml; M: /trunk/xsl/params/man.indent.blurbs.xml; M: /trunk/xsl/params/chunker.output.encoding.xml; M: /trunk/xsl/params/chunker.output.omit-xml-declaration.xml; M: /trunk/xsl/params/sans.font.family.xml; M: /trunk/xsl/params/html.cleanup.xml; M: /trunk/xsl/params/htmlhelp.hhp.xml; M: /trunk/xsl/params/htmlhelp.only.xml; M: /trunk/xsl/params/eclipse.plugin.name.xml; M: /trunk/xsl/params/section.title.level3.properties.xml; M: /trunk/xsl/params/man.th.extra1.suppress.xml; M: /trunk/xsl/params/chunk.section.depth.xml; M: /trunk/xsl/params/htmlhelp.hhp.tail.xml; M: /trunk/xsl/params/sidebar.title.properties.xml; M: /trunk/xsl/params/hyphenate.xml; M: /trunk/xsl/params/paper.type.xml; M: /trunk/xsl/params/chunk.tocs.and.lots.has.title.xml; M: /trunk/xsl/params/symbol.font.family.xml; M: /trunk/xsl/params/page.margin.bottom.xml; M: /trunk/xsl/params/callout.unicode.number.limit.xml; M: /trunk/xsl/params/itemizedlist.properties.xml; M: /trunk/xsl/params/root.filename.xml; M: /trunk/xsl/params/tablecolumns.extension.xml; M: /trunk/xsl/params/htmlhelp.show.favorities.xml; M: /trunk/xsl/params/informaltable.properties.xml; M: /trunk/xsl/params/revhistory.table.cell.properties.xml; M: /trunk/xsl/params/htmlhelp.default.topic.xml; M: /trunk/xsl/params/compact.list.item.spacing.xml; M: /trunk/xsl/params/page.height.portrait.xml; M: /trunk/xsl/params/html.head.legalnotice.link.types.xml; M: /trunk/xsl/params/passivetex.extensions.xml; M: /trunk/xsl/params/orderedlist.label.properties.xml; M: /trunk/xsl/params/othercredit.like.author.enabled.xml; M: /trunk/xsl/params/header.content.properties.xml; M: /trunk/xsl/params/refentry.meta.get.quietly.xml; M: /trunk/xsl/params/section.properties.xml; M: /trunk/xsl/params/htmlhelp.button.hideshow.xml; M: /trunk/xsl/params/simplesect.in.toc.xml; M: /trunk/xsl/params/chunk.quietly.xml; M: /trunk/xsl/params/htmlhelp.enumerate.images.xml; M: /trunk/xsl/params/section.title.level1.properties.xml; M: /trunk/xsl/params/qanda.defaultlabel.xml; M: /trunk/xsl/params/htmlhelp.enhanced.decompilation.xml; M: /trunk/xsl/params/man.th.title.max.length.xml; M: /trunk/xsl/params/footnote.number.format.xml; M: /trunk/xsl/params/body.margin.bottom.xml; M: /trunk/xsl/params/htmlhelp.window.geometry.xml; M: /trunk/xsl/params/htmlhelp.button.jump2.xml; M: /trunk/xsl/params/use.svg.xml; M: /trunk/xsl/params/qanda.title.level6.properties.xml; M: /trunk/xsl/params/collect.xref.targets.xml; M: /trunk/xsl/params/html.extra.head.links.xml; M: /trunk/xsl/params/variablelist.as.table.xml; M: /trunk/xsl/params/man.indent.width.xml; M: /trunk/xsl/params/eclipse.plugin.id.xml; M: /trunk/xsl/params/linenumbering.width.xml; M: /trunk/xsl/params/axf.extensions.xml; M: /trunk/xsl/params/menuchoice.separator.xml; M: /trunk/xsl/params/glossterm.separation.xml; M: /trunk/xsl/params/htmlhelp.autolabel.xml; M: /trunk/xsl/params/chunk.separate.lots.xml; M: /trunk/xsl/params/man.hyphenate.computer.inlines.xml; M: /trunk/xsl/params/linenumbering.separator.xml; M: /trunk/xsl/params/htmlhelp.title.xml; M: /trunk/xsl/params/index.number.separator.xml; M: /trunk/xsl/params/htmlhelp.button.prev.xml; M: /trunk/xsl/params/refentry.manual.fallback.profile.xml; M: /trunk/xsl/params/table.frame.border.color.xml; M: /trunk/xsl/params/footnote.sep.leader.properties.xml; M: /trunk/xsl/params/hyphenate.verbatim.characters.xml; M: /trunk/xsl/params/table.cell.border.thickness.xml; M: /trunk/xsl/params/template.xml; M: /trunk/xsl/params/margin.note.properties.xml; M: /trunk/xsl/params/man.segtitle.suppress.xml; M: /trunk/xsl/params/generate.toc.xml; M: /trunk/xsl/params/formal.object.properties.xml; M: /trunk/xsl/params/footnote.mark.properties.xml; M: /trunk/xsl/params/header.table.height.xml; M: /trunk/xsl/params/htmlhelp.button.back.xml; M: /trunk/xsl/params/qanda.title.level4.properties.xml; M: /trunk/xsl/params/man.links.are.numbered.xml; M: /trunk/xsl/params/manual.toc.xml; M: /trunk/xsl/params/olink.lang.fallback.sequence.xml; M: /trunk/xsl/params/refentry.manual.profile.enabled.xml; M: /trunk/xsl/params/ulink.hyphenate.chars.xml; M: /trunk/xsl/params/manifest.xml; M: /trunk/xsl/params/olink.fragid.xml; M: /trunk/xsl/params/refentry.date.profile.xml; M: /trunk/xsl/params/linenumbering.extension.xml; M: /trunk/xsl/params/component.title.properties.xml; M: /trunk/xsl/params/alignment.xml; M: /trunk/xsl/params/refentry.version.profile.xml; M: /trunk/xsl/params/ebnf.assignment.xml; M: /trunk/xsl/params/htmlhelp.button.print.xml; M: /trunk/xsl/params/annotation.support.xml; M: /trunk/xsl/params/sidebar.float.width.xml; M: /trunk/xsl/params/normal.para.spacing.xml; M: /trunk/xsl/params/xref.title-page.separator.xml; M: /trunk/xsl/params/callout.unicode.font.xml; M: /trunk/xsl/params/default.table.frame.xml; M: /trunk/xsl/params/pages.template.xml; M: /trunk/xsl/params/htmlhelp.button.zoom.xml; M: /trunk/xsl/params/admonition.title.properties.xml; M: /trunk/xsl/params/callout.graphics.extension.xml; M: /trunk/xsl/params/make.valid.html.xml; M: /trunk/xsl/params/qanda.title.level2.properties.xml; M: /trunk/xsl/params/page.margin.top.xml; M: /trunk/xsl/params/xep.index.item.properties.xml; M: /trunk/xsl/params/section.level5.properties.xml; M: /trunk/xsl/params/line-height.xml; M: /trunk/xsl/params/table.cell.border.color.xml; M: /trunk/xsl/params/qandadiv.autolabel.xml; M: /trunk/xsl/params/xref.label-title.separator.xml; M: /trunk/xsl/params/chunk.tocs.and.lots.xml; M: /trunk/xsl/params/man.font.funcprototype.xml; M: /trunk/xsl/params/process.source.toc.xml; M: /trunk/xsl/params/page.orientation.xml; M: /trunk/xsl/params/refentry.generate.name.xml; M: /trunk/xsl/params/navig.showtitles.xml; M: /trunk/xsl/params/table.table.properties.xml; M: /trunk/xsl/params/arbortext.extensions.xml; M: /trunk/xsl/params/informalequation.properties.xml; M: /trunk/xsl/params/headers.on.blank.pages.xml; M: /trunk/xsl/params/table.footnote.properties.xml; M: /trunk/xsl/params/root.properties.xml; M: /trunk/xsl/params/htmlhelp.display.progress.xml; M: /trunk/xsl/params/htmlhelp.hhp.windows.xml; M: /trunk/xsl/params/graphical.admonition.properties.xml; M: /trunk/xsl/params/refclass.suppress.xml; M: /trunk/xsl/params/profile.conformance.xml; M: /trunk/xsl/params/htmlhelp.button.forward.xml; M: /trunk/xsl/params/segmentedlist.as.table.xml; M: /trunk/xsl/params/margin.note.float.type.xml; M: /trunk/xsl/params/man.table.footnotes.divider.xml; M: /trunk/xsl/params/man.output.quietly.xml; M: /trunk/xsl/params/htmlhelp.hhc.show.root.xml; M: /trunk/xsl/params/footers.on.blank.pages.xml; M: /trunk/xsl/params/crop.mark.offset.xml; M: /trunk/xsl/params/olink.doctitle.xml; M: /trunk/xsl/params/section.level3.properties.xml; M: /trunk/xsl/params/callout.unicode.xml; M: /trunk/xsl/params/formal.procedures.xml; M: /trunk/xsl/params/toc.section.depth.xml; M: /trunk/xsl/params/index.prefer.titleabbrev.xml; M: /trunk/xsl/params/nominal.image.width.xml; M: /trunk/xsl/params/htmlhelp.show.menu.xml; M: /trunk/xsl/params/linenumbering.everyNth.xml; M: /trunk/xsl/params/double.sided.xml; M: /trunk/xsl/params/generate.revhistory.link.xml; M: /trunk/xsl/params/olink.properties.xml; M: /trunk/xsl/params/tex.math.in.alt.xml; M: /trunk/xsl/params/man.output.subdirs.enabled.xml; M: /trunk/xsl/params/section.title.properties.xml; M: /trunk/xsl/params/column.count.back.xml; M: /trunk/xsl/params/toc.indent.width.xml; M: /trunk/xsl/params/man.charmap.uri.xml; M: /trunk/xsl/params/index.method.xml; M: /trunk/xsl/params/generate.section.toc.level.xml; M: /trunk/xsl/params/page.width.portrait.xml; M: /trunk/xsl/params/man.th.extra2.max.length.xml; M: /trunk/xsl/params/abstract.properties.xml; M: /trunk/xsl/params/revhistory.table.properties.xml; M: /trunk/xsl/params/nominal.table.width.xml; M: /trunk/xsl/params/ulink.show.xml; M: /trunk/xsl/params/htmlhelp.button.jump1.title.xml; M: /trunk/xsl/params/index.div.title.properties.xml; M: /trunk/xsl/params/profile.userlevel.xml; M: /trunk/xsl/params/html.cellpadding.xml; M: /trunk/xsl/params/orderedlist.label.width.xml; M: /trunk/xsl/params/crop.marks.xml; M: /trunk/xsl/params/menuchoice.menu.separator.xml; M: /trunk/xsl/params/author.othername.in.middle.xml; M: /trunk/xsl/params/section.level1.properties.xml; M: /trunk/xsl/params/textdata.default.encoding.xml; M: /trunk/xsl/params/label.from.part.xml; M: /trunk/xsl/params/use.embed.for.svg.xml; M: /trunk/xsl/params/list.item.spacing.xml; M: /trunk/xsl/params/htmlhelp.hhc.width.xml; M: /trunk/xsl/params/column.gap.body.xml; M: /trunk/xsl/params/rootid.xml; M: /trunk/xsl/params/glosslist.as.blocks.xml; M: /trunk/xsl/params/index.range.separator.xml; M: /trunk/xsl/params/html.ext.xml; M: /trunk/xsl/params/callout.list.table.xml; M: /trunk/xsl/params/highlight.source.xml; M: /trunk/xsl/params/show.revisionflag.xml; M: /trunk/xsl/params/man.output.manifest.enabled.xml; M: /trunk/xsl/params/make.single.year.ranges.xml; M: /trunk/xsl/params/pgwide.properties.xml; M: /trunk/xsl/params/generate.id.attributes.xml; M: /trunk/xsl/params/emphasis.propagates.style.xml; M: /trunk/xsl/params/abstract.title.properties.xml; M: /trunk/xsl/params/htmlhelp.hhc.xml; M: /trunk/xsl/params/monospace.properties.xml; M: /trunk/xsl/params/htmlhelp.hhk.xml; M: /trunk/xsl/params/table.borders.with.css.xml; M: /trunk/xsl/params/man.links.are.underlined.xml; M: /trunk/xsl/params/profile.vendor.xml; M: /trunk/xsl/params/shade.verbatim.xml; M: /trunk/xsl/params/callout.graphics.path.xml; M: /trunk/xsl/params/olink.debug.xml; M: /trunk/xsl/params/make.graphic.viewport.xml; M: /trunk/xsl/params/footnote.number.symbols.xml; M: /trunk/xsl/params/man.charmap.enabled.xml; M: /trunk/xsl/params/page.height.xml; M: /trunk/xsl/params/htmlhelp.button.jump1.url.xml; M: /trunk/xsl/params/man.font.table.title.xml; M: /trunk/xsl/params/revhistory.title.properties.xml; M: /trunk/xsl/params/chunker.output.media-type.xml; M: /trunk/xsl/params/glossterm.width.xml; M: /trunk/xsl/params/points.per.em.xml; M: /trunk/xsl/params/page.margin.inner.xml; M: /trunk/xsl/params/itemizedlist.label.width.xml; M: /trunk/xsl/params/ulink.hyphenate.xml; M: /trunk/xsl/params/crop.mark.bleed.xml; M: /trunk/xsl/params/use.id.as.filename.xml; M: /trunk/xsl/params/section.title.level6.properties.xml; M: /trunk/xsl/params/highlight.default.language.xml; M: /trunk/xsl/params/man.th.extra2.suppress.xml; M: /trunk/xsl/params/id.warnings.xml; M: /trunk/xsl/params/title.margin.left.xml; M: /trunk/xsl/params/chunker.output.doctype-system.xml; M: /trunk/xsl/params/man.indent.verbatims.xml; M: /trunk/xsl/params/table.frame.border.thickness.xml; M: /trunk/xsl/params/monospace.verbatim.properties.xml; M: /trunk/xsl/params/formal.title.properties.xml; M: /trunk/xsl/params/margin.note.width.xml; M: /trunk/xsl/params/man.hyphenate.filenames.xml; M: /trunk/xsl/params/blockquote.properties.xml; M: /trunk/xsl/params/callout.defaultcolumn.xml; M: /trunk/xsl/params/profile.security.xml; M: /trunk/xsl/params/informal.object.properties.xml; M: /trunk/xsl/params/formal.title.placement.xml; M: /trunk/xsl/params/draft.watermark.image.xml; M: /trunk/xsl/params/equation.properties.xml; M: /trunk/xsl/params/body.font.family.xml; M: /trunk/xsl/params/ignore.image.scaling.xml; M: /trunk/xsl/params/chunk.first.sections.xml; M: /trunk/xsl/params/base.dir.xml; M: /trunk/xsl/params/footnote.properties.xml; M: /trunk/xsl/params/olink.outline.ext.xml; M: /trunk/xsl/params/img.src.path.xml; M: /trunk/xsl/params/qanda.title.properties.xml; M: /trunk/xsl/params/ebnf.statement.terminator.xml; M: /trunk/xsl/params/callouts.extension.xml; M: /trunk/xsl/params/manifest.in.base.dir.xml; M: /trunk/xsl/params/fop1.extensions.xml; M: /trunk/xsl/params/olink.sysid.xml; M: /trunk/xsl/params/section.title.level4.properties.xml; M: /trunk/xsl/params/monospace.font.family.xml; M: /trunk/xsl/params/l10n.gentext.language.xml; M: /trunk/xsl/params/graphic.default.extension.xml; M: /trunk/xsl/params/default.image.width.xml; M: /trunk/xsl/params/htmlhelp.button.refresh.xml; M: /trunk/xsl/params/chunker.output.cdata-section-elements.xml; M: /trunk/xsl/params/admon.graphics.path.xml; M: /trunk/xsl/params/admon.style.xml; M: /trunk/xsl/params/profile.revision.xml; M: /trunk/xsl/params/generate.manifest.xml; M: /trunk/xsl/params/html.longdesc.xml; M: /trunk/xsl/params/footer.rule.xml; M: /trunk/xsl/params/eclipse.plugin.provider.xml; M: /trunk/xsl/params/refentry.source.name.profile.xml; M: /trunk/xsl/params/toc.max.depth.xml; M: /trunk/xsl/params/chunker.output.indent.xml; M: /trunk/xsl/params/html.head.legalnotice.link.multiple.xml; M: /trunk/xsl/params/toc.list.type.xml; M: /trunk/xsl/params/link.mailto.url.xml; M: /trunk/xsl/params/table.properties.xml; M: /trunk/xsl/params/side.float.properties.xml; M: /trunk/xsl/params/man.charmap.use.subset.xml; M: /trunk/xsl/params/annotation.graphic.open.xml; M: /trunk/xsl/params/html.cellspacing.xml; M: /trunk/xsl/params/default.table.width.xml; M: /trunk/xsl/params/xep.extensions.xml; M: /trunk/xsl/params/admonition.properties.xml; M: /trunk/xsl/params/toc.margin.properties.xml; M: /trunk/xsl/params/chunk.toc.xml; M: /trunk/xsl/params/table.entry.padding.xml; M: /trunk/xsl/params/header.rule.xml; M: /trunk/xsl/params/glossentry.show.acronym.xml; M: /trunk/xsl/params/variablelist.as.blocks.xml; M: /trunk/xsl/params/man.hyphenate.xml; M: /trunk/xsl/params/refentry.source.name.profile.enabled.xml; M: /trunk/xsl/params/section.label.includes.component.label.xml; M: /trunk/xsl/params/bridgehead.in.toc.xml; M: /trunk/xsl/params/section.title.level2.properties.xml; M: /trunk/xsl/params/admon.graphics.extension.xml; M: /trunk/xsl/params/inherit.keywords.xml; M: /trunk/xsl/params/insert.xref.page.number.xml; M: /trunk/xsl/params/pixels.per.inch.xml; M: /trunk/xsl/params/refentry.pagebreak.xml; M: /trunk/xsl/params/profile.lang.xml; M: /trunk/xsl/params/insert.olink.page.number.xml; M: /trunk/xsl/params/generate.meta.abstract.xml; M: /trunk/xsl/params/graphicsize.extension.xml; M: /trunk/xsl/params/man.indent.lists.xml; M: /trunk/xsl/params/funcsynopsis.decoration.xml; M: /trunk/xsl/params/runinhead.title.end.punct.xml; M: /trunk/xsl/params/man.string.subst.map.xml; M: /trunk/xsl/params/man.links.list.enabled.xml; M: /trunk/xsl/params/section.autolabel.max.depth.xml; M: /trunk/xsl/params/htmlhelp.show.advanced.search.xml; M: /trunk/xsl/params/htmlhelp.map.file.xml; M: /trunk/xsl/params/l10n.gentext.use.xref.language.xml; M: /trunk/xsl/params/body.font.size.xml; M: /trunk/xsl/params/html.stylesheet.type.xml; M: /trunk/xsl/params/refentry.xref.manvolnum.xml; M: /trunk/xsl/params/runinhead.default.title.end.punct.xml; M: /trunk/xsl/params/navig.graphics.extension.xml; M: /trunk/xsl/params/itemizedlist.label.properties.xml; M: /trunk/xsl/params/htmlhelp.force.map.and.alias.xml; M: /trunk/xsl/params/profile.os.xml; M: /trunk/xsl/params/htmlhelp.alias.file.xml; M: /trunk/xsl/params/page.margin.outer.xml; M: /trunk/xsl/params/annotation.graphic.close.xml; M: /trunk/xsl/params/eclipse.autolabel.xml; M: /trunk/xsl/params/table.frame.border.style.xml; M: /trunk/xsl/params/navig.graphics.path.xml; M: /trunk/xsl/params/htmlhelp.hhc.binary.xml; M: /trunk/xsl/params/index.on.type.xml; M: /trunk/xsl/params/target.database.document.xml; M: /trunk/xsl/params/man.subheading.divider.xml; M: /trunk/xsl/params/chunker.output.method.xml; M: /trunk/xsl/params/make.index.markup.xml; M: /trunk/xsl/params/olink.base.uri.xml; M: /trunk/xsl/params/phrase.propagates.style.xml; M: /trunk/xsl/params/man.indent.refsect.xml; M: /trunk/xsl/params/example.properties.xml; M: /trunk/xsl/params/man.font.table.headings.xml; M: /trunk/xsl/params/profile.revisionflag.xml; M: /trunk/xsl/params/region.after.extent.xml; M: /trunk/xsl/params/qanda.title.level5.properties.xml; M: /trunk/xsl/params/marker.section.level.xml; M: /trunk/xsl/params/footer.table.height.xml; M: /trunk/xsl/params/autotoc.label.separator.xml; M: /trunk/xsl/params/footer.column.widths.xml; M: /trunk/xsl/params/hyphenate.verbatim.xml; M: /trunk/xsl/params/xref.properties.xml; M: /trunk/xsl/params/man.output.base.dir.xml; M: /trunk/xsl/params/man.links.list.heading.xml; M: /trunk/xsl/params/insert.link.page.number.xml; M: /trunk/xsl/params/htmlhelp.button.jump2.title.xml; M: /trunk/xsl/params/l10n.lang.value.rfc.compliant.xml - Michael(tm) Smith</alt></phrase></literallayout>
5682 </listitem>
5683 <listitem>
5684 <literallayout><phrase role="commit-message">Updated index.method doc to describe revised setup for importing <tag>index</tag> extensions.<alt>M: /trunk/xsl/params/index.method.xml - Robert Stayton</alt></phrase></literallayout>
5685 </listitem>
5686 <listitem>
5687 <literallayout><phrase role="commit-message">Added several new HTML parameters for controlling appearance of
5688 content on HTML <tag>title</tag> pages:
5689
5690 <parameter>contrib.inline.enabled</parameter>:
5691   If non-zero (the default), output of the <tag>contrib</tag> element is
5692   displayed as inline content rather than as block content.
5693
5694 <parameter>othercredit.like.author.enabled</parameter>:
5695   If non-zero, output of the <tag>othercredit</tag> element on titlepages is
5696   displayed in the same style as <tag>author</tag> and <tag>editor</tag> output. If zero
5697   (the default), <tag>othercredit</tag> output is displayed using a style
5698   different than that of <tag>author</tag> and <tag>editor</tag>.
5699
5700 <parameter>blurb.on.titlepage.enabled</parameter>:
5701   If non-zero, output from authorblurb and <tag>personblurb</tag> elements is
5702   displayed on <tag>title</tag> pages. If zero (the default), output from
5703   those elements is suppressed on <tag>title</tag> pages (unless you are
5704   using a titlepage customization that causes them to be included).
5705
5706 <parameter>editedby.enabled</parameter>
5707   If non-zero (the default), a localized Edited by heading is
5708   displayed above <tag>editor</tag> names in output of the <tag>editor</tag> element.<alt>A: /trunk/xsl/params/contrib.inline.enabled.xml; A: /trunk/xsl/params/blurb.on.titlepage.enabled.xml; A: /trunk/xsl/params/othercredit.like.author.enabled.xml; A: /trunk/xsl/params/editedby.enabled.xml - Michael(tm) Smith</alt></phrase></literallayout>
5709 </listitem>
5710 <listitem>
5711 <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
5712 default), delimiters are generated around e-mail addresses (output
5713 of the <tag>email</tag> element). If zero, the delimiters are suppressed.<alt>A: /trunk/xsl/params/email.delimiters.enabled.xml - Michael(tm) Smith</alt></phrase></literallayout>
5714 </listitem>
5715
5716 <listitem>
5717 <literallayout><phrase role="commit-message">Added <parameter>qanda.nested.in.toc</parameter> param. Default value is zero. If
5718 non-zero, instances of "nested" <tag>Qandaentry</tag> (ones that are children
5719 of <tag>Answer</tag> elements) are displayed in the <tag>TOC</tag>. Closes patch 1509018
5720 (from Daniel Leidert). Currently on affects HTML output (no patch
5721 for FO output provided).<alt>A: /trunk/xsl/params/qanda.nested.in.toc.xml - Michael(tm) Smith</alt></phrase></literallayout>
5722 </listitem>
5723
5724 <listitem>
5725 <literallayout><phrase role="commit-message">Initial support of syntax highlighting of programlistings.<alt>A: /trunk/xsl/params/highlight.source.xml; A: /trunk/xsl/params/highlight.default.language.xml - Jirka Kosek</alt></phrase></literallayout>
5726 </listitem>
5727 </itemizedlist>
5728 </sect2><!--end of Params changes for 1.71.0-->
5729
5730 <sect2 xml:id="V1.71.0_Tools">
5731 <title>Tools</title>
5732 <para>The following changes have been made to the
5733             <filename>tools</filename> code
5734             since the 1.70.1 release.</para>
5735 <itemizedlist>
5736
5737 <listitem>
5738 <literallayout><phrase role="commit-message">Racheted down font sizes of headings in example makefile FO output.<alt>M: /trunk/xsl/tools/make/Makefile.DocBook - Michael(tm) Smith</alt></phrase></literallayout>
5739 </listitem>
5740 <listitem>
5741 <literallayout><phrase role="commit-message">Added param and attribute set to example makefile, for getting
5742 wrapping in verbatims in FO output.<alt>M: /trunk/xsl/tools/make/Makefile.DocBook - Michael(tm) Smith</alt></phrase></literallayout>
5743 </listitem>
5744 <listitem>
5745 <literallayout><phrase role="commit-message">Renamed Makefile.paramDoc to Makefile.docParam.<alt>A: /trunk/xsl/tools/make/Makefile.docParam; D: /trunk/xsl/tools/make/Makefile.paramDoc - Michael(tm) Smith</alt></phrase></literallayout>
5746 </listitem>
5747 <listitem>
5748 <literallayout><phrase role="commit-message">Added Makefile.paramDoc file, for creating versions of param.xsl
5749 files with doc embedded.<alt>A: /trunk/xsl/tools/make/Makefile.paramDoc - Michael(tm) Smith</alt></phrase></literallayout>
5750 </listitem>
5751 <listitem>
5752 <literallayout><phrase role="commit-message">Added variable to example makefile for controlling whether HTML or
5753 XHTML is generated.<alt>M: /trunk/xsl/tools/make/Makefile.DocBook - Michael(tm) Smith</alt></phrase></literallayout>
5754 </listitem>
5755
5756 </itemizedlist>
5757 </sect2><!--end of Tools changes for 1.71.0-->
5758 </sect1>
5759
5760 <sect1 xml:id="V1701">
5761 <title>Release: 1.70.1</title>
5762
5763 <para>This is a stable release of the 1.70 stylesheets. It includes only a
5764 few small changes from 1.70.0.</para>
5765
5766 <para>The following is a list of changes that have been made
5767         since the 1.70.0 release.</para>
5768
5769 <sect2 xml:id="V1701_FO">
5770 <title>FO</title>
5771 <para>The following changes have been made to the
5772         <filename>fo</filename> code
5773         since the 1.70.0 release.</para>
5774 <itemizedlist>
5775 <listitem role="commit-message">
5776 <para>Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output.</para>
5777 <para role="commit-changes">Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params/revhistory.table.properties.xml,1.1; params/revhistory.title.properties.xml,1.1 - Jirka Kosek</para>
5778 </listitem>
5779 <listitem role="commit-message">
5780 <para>Support DBv5 revisions with full author name (not only authorinitials)</para>
5781 <para role="commit-changes">Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek</para>
5782 </listitem>
5783 </itemizedlist>
5784 </sect2><!--end of FO changes for 1.70.1-->
5785
5786 <sect2 xml:id="V1701_HTML">
5787 <title>HTML</title>
5788 <para>The following changes have been made to the
5789         <filename>html</filename> code
5790         since the 1.70.0 release.</para>
5791 <itemizedlist>
5792 <listitem role="commit-message">
5793 <para>Support DBv5 revisions with full author name (not only authorinitials)</para>
5794 <para role="commit-changes">Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek</para>
5795 </listitem>
5796 </itemizedlist>
5797 </sect2><!--end of HTML changes for 1.70.1-->
5798
5799 <sect2 xml:id="V1701_HTMLHelp">
5800 <title>HTMLHelp</title>
5801 <para>The following changes have been made to the
5802         <filename>htmlhelp</filename> code
5803         since the 1.70.0 release.</para>
5804 <itemizedlist>
5805 <listitem role="commit-message">
5806 <para>htmlhelp.generate.index is now param, not variable. This means that you can override its setting from outside. This is useful when you generate indexterms on the fly (see http://www.xml.com/pub/a/2004/07/14/dbndx.html?page=3).</para>
5807 <para role="commit-changes">Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek</para>
5808 </listitem>
5809 <listitem role="commit-message">
5810 <para>Support chunk.tocs.and.lots in HTML Help</para>
5811 <para role="commit-changes">Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek</para>
5812 </listitem>
5813 </itemizedlist>
5814 </sect2><!--end of HTMLHelp changes for 1.70.1-->
5815
5816 <sect2 xml:id="V1701_Params">
5817 <title>Params</title>
5818 <para>The following changes have been made to the
5819         <filename>params</filename> code
5820         since the 1.70.0 release.</para>
5821 <itemizedlist>
5822 <listitem role="commit-message">
5823 <para>Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output.</para>
5824 <para role="commit-changes">Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params/revhistory.table.properties.xml,1.1; params/revhistory.title.properties.xml,1.1 - Jirka Kosek</para>
5825 </listitem>
5826 </itemizedlist>
5827 </sect2><!--end of Params changes for 1.70.1-->
5828
5829 </sect1>
5830
5831 <sect1 xml:id="V1700">
5832 <title>Release: 1.70.0</title>
5833 <para>As with all DocBook Project <link linkend="dot0">dot-zero</link>
5834 releases, this is an experimental release. It will be followed shortly
5835 by a stable release.</para>
5836
5837 <para>This release adds a number of new features,
5838 including:</para>
5839
5840 <itemizedlist>
5841   <listitem>
5842     <para>support for selecting alternative index-collation methods
5843     (in particular, support for using a collation library developed by
5844     Eliot Kimber)</para>
5845   </listitem>
5846   <listitem>
5847     <para>improved handling of DocBook 5 document instances (through a
5848     namespace-stripping mechanism)</para>
5849   </listitem>
5850   <listitem>
5851     <para>full support for CALS and HTML tables in manpages
5852     output</para>
5853   </listitem>
5854   <listitem>
5855     <para>a mechanism for preserving relative URIs in documents that
5856     make use of XInclude</para>
5857   </listitem>
5858   <listitem>
5859     <para>support for the "new" <literal>.90</literal> version of
5860     FOP</para>
5861   </listitem>
5862   <listitem>
5863     <para>enhanced capabilities for controlling formatting of lists in HTML
5864     and FO output</para>
5865   </listitem>
5866   <listitem>
5867     <para>autogeneration of AUTHOR and COPYRIGHT sections in manpages
5868     output</para>
5869   </listitem>
5870   <listitem>
5871     <para>support for generating crop marks in FO/PDF output</para>
5872   </listitem>
5873   <listitem>
5874     <para>support for qandaset as a root element in FO output</para>
5875   </listitem>
5876   <listitem>
5877     <para>support for floatstyle and orient on all table types</para>
5878   </listitem>
5879   <listitem>
5880     <para>support for floatstyle in figure, and example</para>
5881   </listitem>
5882   <listitem>
5883     <para>pgwide.properties attribute-set supports extending figure,
5884       example and table into the left indent area instead of spanning
5885       multiple columns.</para>
5886   </listitem>
5887 </itemizedlist>
5888     <para>The following is a detailed list of enhancements and API
5889     changes that have been made since the 1.69.1 release.</para>
5890
5891 <sect2 xml:id="V1700_Common">
5892 <title>Common</title>
5893 <para>The following changes have been made to the
5894         <filename>common</filename> code
5895         since the 1.69.1 release.</para>
5896 <itemizedlist>
5897 <listitem role="commit-message">
5898 <para>Add the xsl:key for the kimber
5899 indexing method.</para>
5900 <para role="commit-changes">Modified: common/autoidx-ng.xsl,1.2 - Robert
5901 Stayton</para>
5902 </listitem>
5903 <listitem role="commit-message">
5904 <para>Add support for
5905 <tag>qandaset</tag>.</para>
5906 <para role="commit-changes">Modified: common/labels.xsl,1.37;
5907 common/subtitles.xsl,1.7; common/titles.xsl,1.35 - Robert
5908 Stayton</para>
5909 </listitem>
5910 <listitem role="commit-message">
5911 <para>Support dbhtml/dbfo start PI for
5912 <tag>orderedlist</tag> numbering in both HTML and
5913 FO</para>
5914 <para role="commit-changes">Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman
5915 Walsh</para>
5916 </listitem>
5917 <listitem role="commit-message">
5918 <para>Added CVS
5919 header.</para>
5920 <para role="commit-changes">Modified: common/stripns.xsl,1.12 - Robert
5921 Stayton</para>
5922 </listitem>
5923 <listitem role="commit-message">
5924 <para>Changed content model of text
5925 element to ANY rather than #PCDATA because they could contain
5926 markup.</para>
5927 <para role="commit-changes">Modified: common/targetdatabase.dtd,1.7 - Robert
5928 Stayton</para>
5929 </listitem>
5930 <listitem role="commit-message">
5931 <para>Added
5932 <tag>refentry</tag>.meta.get.quietly param.</para>
5933 <para>If zero (the
5934 default), notes and warnings about "missing" markup are generated
5935 during gathering of <tag>refentry</tag> metadata. If
5936 non-zero, the metadata is gathered "quietly" -- that is, the
5937 notes and warnings are suppressed.</para>
5938 <para>NOTE: If you are
5939 processing a large amount of <tag>refentry</tag> content,  you
5940 may be able to speed up processing significantly by  setting a
5941 non-zero value for
5942 <tag>refentry</tag>.meta.get.quietly.</para>
5943 <para role="commit-changes">Modified: common/refentry.xsl,1.17;
5944 manpages/param.ent,1.15; manpages/param.xweb,1.17;
5945 params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
5946 Smith</para>
5947 </listitem>
5948 <listitem role="commit-message">
5949 <para>After namespace stripping, the
5950 source document is the temporary tree created by the stripping
5951 process and it has the wrong base <tag>URI</tag> for relative
5952 references. Earlier versions of this code used to try to fix that
5953 by patching the elements with relative @fileref attributes. That
5954 was inadequate because it calculated an absolute base <tag>URI</tag>
5955 without considering that there might be xml:base attributes
5956 already in effect. It seems obvious now that the right thing to
5957 do is simply to put the xml:base on the root of the document. And
5958 that seems to work.</para>
5959 <para role="commit-changes">Modified: common/stripns.xsl,1.7 - Norman
5960 Walsh</para>
5961 </listitem>
5962 <listitem role="commit-message">
5963 <para>Added support for "software" and
5964 "sectdesc" class values on <tag>refmiscinfo</tag>; "software" is
5965 treated identically to "source", and "setdesc" is treated
5966 identically to "manual".</para>
5967 <para role="commit-changes">Modified: common/refentry.xsl,1.10;
5968 params/man.th.extra2.max.length.xml,1.3;
5969 params/refentry.source.name.profile.xml,1.4 - Michael(tm)
5970 Smith</para>
5971 </listitem>
5972 <listitem role="commit-message">
5973 <para>Added support for DocBook 5
5974 namespace-stripping in manpages stylesheet. Closes request
5975 #1210692.</para>
5976 <para role="commit-changes">Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 -
5977 Michael(tm) Smith</para>
5978 </listitem>
5979 <listitem role="commit-message">
5980 <para>Added &lt;xsl:template
5981 match="/"&gt; to make stripns.xsl usable as a standalone
5982 stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that
5983 DocBook XSLT drivers that include this stylesheet all override
5984 the match="/" template.</para>
5985 <para role="commit-changes">Modified: common/stripns.xsl,1.4 - Michael(tm)
5986 Smith</para>
5987 </listitem>
5988 <listitem role="commit-message">
5989 <para>Number figures, examples, and
5990 tables from <tag>book</tag> if there is no prefix (i.e. if
5991 <parameter>chapter.autolabel</parameter> is set to 0). This avoids
5992 having the list of figures where the figures mysteriously restart
5993 their numeration periodically when
5994 <parameter>chapter.autolabel</parameter> is set to
5995 0.</para>
5996 <para role="commit-changes">Modified: common/labels.xsl,1.36 - David Cramer</para>
5997 </listitem>
5998 <listitem role="commit-message">
5999 <para>Add <tag>task</tag> template in
6000 <tag>title</tag>.markup mode.</para>
6001 <para role="commit-changes">Modified: common/titles.xsl,1.34 - Robert
6002 Stayton</para>
6003 </listitem>
6004 <listitem role="commit-message">
6005 <para>Add children (with ids) of formal
6006 objects to target data.</para>
6007 <para role="commit-changes">Modified: common/targets.xsl,1.10 - Robert
6008 Stayton</para>
6009 </listitem>
6010 <listitem role="commit-message">
6011 <para>Added support for case when
6012 <tag>personname</tag> doesn't contain specific name markup (as allowed
6013 in DocBook 5.0)</para>
6014 <para role="commit-changes">Modified: common/common.xsl,1.54 - Jirka
6015 Kosek</para>
6016 </listitem>
6017 </itemizedlist>
6018 </sect2><!--end of Common changes for snapshot_2006-05-15_0803-->
6019
6020 <sect2 xml:id="V1700_Extensions">
6021 <title>Extensions</title>
6022 <para>The following changes have been made to the
6023         <filename>extensions</filename> code
6024         since the 1.69.1 release.</para>
6025 <itemizedlist>
6026 <listitem role="commit-message">
6027 <para>Support Xalan
6028 2.7</para>
6029 <para role="commit-changes">Modified: extensions/xalan27/.cvsignore,1.1;
6030 extensions/xalan27/build.xml,1.1;
6031 extensions/xalan27/nbproject/.cvsignore,1.1;
6032 extensions/xalan27/nbproject/build-impl.xml,1.1;
6033 extensions/xalan27/nbproject/genfiles.properties,1.1;
6034 extensions/xalan27/nbproject/project.properties,1.1;
6035 extensions/xalan27/nbproject/project.xml,1.1;
6036 extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1;
6037 extensions/xalan27/src/com/nwalsh/xalan/Callout.java,1.1;
6038 extensions/xalan27/src/com/nwalsh/xalan/FormatCallout.java,1.1;
6039 extensions/xalan27/src/com/nwalsh/xalan/FormatDingbatCallout.java,1.1;
6040 extensions/xalan27/src/com/nwalsh/xalan/FormatGraphicCallout.java,1.1;
6041 extensions/xalan27/src/com/nwalsh/xalan/FormatTextCallout.java,1.1;
6042 extensions/xalan27/src/com/nwalsh/xalan/FormatUnicodeCallout.java,1.1;
6043 extensions/xalan27/src/com/nwalsh/xalan/Func.java,1.1;
6044 extensions/xalan27/src/com/nwalsh/xalan/ImageIntrinsics.java,1.1;
6045 extensions/xalan27/src/com/nwalsh/xalan/Params.java,1.1;
6046 extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1;
6047 extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1;
6048 extensions/xalan27/src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman
6049 Walsh</para>
6050 </listitem>
6051 <listitem role="commit-message">
6052 <para>Handle the case where the imageFn
6053 is actually a <tag>URI</tag>. This still needs
6054 work.</para>
6055 <para role="commit-changes">Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4
6056 - Norman Walsh</para>
6057 </listitem>
6058 </itemizedlist>
6059 </sect2><!--end of Extensions changes for snapshot_2006-05-15_0803-->
6060
6061 <sect2 xml:id="V1700_FO">
6062 <title>FO</title>
6063 <para>The following changes have been made to the
6064         <filename>fo</filename> code
6065         since the 1.69.1 release.</para>
6066 <itemizedlist>
6067 <listitem role="commit-message">
6068 <para>Adapted to the new indexing
6069 code. Now works just like a wrapper that calls kosek indexing method,
6070 originally implemented here.</para>
6071 <para role="commit-changes">Modified: fo/autoidx-ng.xsl,1.5 - Jirka
6072 Kosek</para>
6073 </listitem>
6074 <listitem role="commit-message">
6075 <para>Added parameters for header/footer
6076 <tag>table</tag> minimum height.</para>
6077 <para role="commit-changes">Modified: fo/pagesetup.xsl,1.60;
6078 fo/param.ent,1.100; fo/param.xweb,1.113 - Robert
6079 Stayton</para>
6080 </listitem>
6081 <listitem role="commit-message">
6082 <para>Add the <tag>index</tag>.method
6083 parameter.</para>
6084 <para role="commit-changes">Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert
6085 Stayton</para>
6086 </listitem>
6087 <listitem role="commit-message">
6088 <para>Integrate support for three
6089 indexing methods: - the original English-only method. -
6090 Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's
6091 method using Saxon extensions. Use the '<tag>index</tag>.method'
6092 parameter to select.</para>
6093 <para role="commit-changes">Modified: fo/autoidx.xsl,1.38 - Robert
6094 Stayton</para>
6095 </listitem>
6096 <listitem role="commit-message">
6097 <para>Add support for <tag>TOC</tag> for
6098 <tag>qandaset</tag> in fo output.</para>
6099 <para role="commit-changes">Modified: fo/autotoc.xsl,1.30;
6100 fo/qandaset.xsl,1.20 - Robert Stayton</para>
6101 </listitem>
6102 <listitem role="commit-message">
6103 <para>Added parameter
6104 <parameter>ulink.hyphenate</parameter>.chars. Added parameter
6105 insert.<tag>link</tag>.page.number.</para>
6106 <para role="commit-changes">Modified: fo/param.ent,1.98;
6107 fo/param.xweb,1.111 - Robert Stayton</para>
6108 </listitem>
6109 <listitem role="commit-message">
6110 <para>Implemented feature request
6111 #942524 to add insert.<tag>link</tag>.page.number to allow link
6112 element cross references to have a page number.</para>
6113 <para role="commit-changes">Modified: fo/xref.xsl,1.67 -
6114 Robert Stayton</para>
6115 </listitem>
6116 <listitem role="commit-message">
6117 <para>Add support for
6118 <parameter>ulink.hyphenate</parameter>.chars so more characters
6119 can be break points in urls.</para>
6120 <para role="commit-changes">Modified: fo/xref.xsl,1.66 - Robert
6121 Stayton</para>
6122 </listitem>
6123 <listitem role="commit-message">
6124 <para>Implemented patch #1075144 to make
6125 the url text in a ulink in FO output an active <tag>link</tag> as
6126 well.</para>
6127 <para role="commit-changes">Modified: fo/xref.xsl,1.65 - Robert Stayton</para>
6128 </listitem>
6129 <listitem role="commit-message">
6130 <para><tag>table</tag> footnotes now
6131 have their own <tag>table</tag>.<tag>footnote</tag>.properties
6132 attribute set.</para>
6133 <para role="commit-changes">Modified: fo/footnote.xsl,1.23 - Robert
6134 Stayton</para>
6135 </listitem>
6136 <listitem role="commit-message">
6137 <para>Add <tag>qandaset</tag> to
6138 root.elements.</para>
6139 <para role="commit-changes">Modified: fo/docbook.xsl,1.41 - Robert
6140 Stayton</para>
6141 </listitem>
6142 <listitem role="commit-message">
6143 <para>Added mode="page.sequence" to make
6144 it easier to put content into a page sequence.  First used for
6145 <tag>qandaset</tag>.</para>
6146 <para role="commit-changes">Modified: fo/component.xsl,1.37 - Robert
6147 Stayton</para>
6148 </listitem>
6149 <listitem role="commit-message">
6150 <para>Implemented feature request
6151 #1434408 to support formatting
6152 of <tag>biblioentry</tag>.</para>
6153 <para role="commit-changes">Modified: fo/biblio.xsl,1.35 - Robert
6154 Stayton</para>
6155 </listitem>
6156 <listitem role="commit-message">
6157 <para>Added
6158 <tag>biblioentry</tag>.properties.</para>
6159 <para role="commit-changes">Modified: fo/param.ent,1.97;
6160 fo/param.xweb,1.110 - Robert Stayton</para>
6161 </listitem>
6162 <listitem role="commit-message">
6163 <para>Support PTC/Arbortext
6164 bookmarks</para>
6165 <para role="commit-changes">Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman
6166 Walsh</para>
6167 </listitem>
6168 <listitem role="commit-message">
6169 <para>Added
6170 <tag>table</tag>.<tag>footnote</tag>.properties to permit
6171 <tag>table</tag> footnotes to format differently from regular
6172 footnotes.</para>
6173 <para role="commit-changes">Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert
6174 Stayton</para>
6175 </listitem>
6176 <listitem role="commit-message">
6177 <para>Refactored <tag>table</tag>
6178 templates to unify their processing and support all options in
6179 all types.  Now <tag>table</tag> and <tag>informaltable</tag>, in
6180 both Cals and Html markup, use the same templates where possible,
6181 and all support pgwide, rotation, and floats. There is also a
6182 placeholder <tag>table</tag>.container template to
6183 support wrapping a <tag>table</tag> in a layout <tag>table</tag>,
6184 so the XEP <tag>table</tag> <tag>title</tag> "continued"
6185 extension can be more easily implemented.</para>
6186 <para role="commit-changes">Modified: fo/formal.xsl,1.52;
6187 fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 - Robert
6188 Stayton</para>
6189 </listitem>
6190 <listitem role="commit-message">
6191 <para>Added new attribute set
6192 <tag>toc</tag>.line.properties for controlling appearance of lines in
6193 ToC/LoT</para>
6194 <para role="commit-changes">Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95;
6195 fo/param.xweb,1.108 - Jirka Kosek</para>
6196 </listitem>
6197 <listitem role="commit-message">
6198 <para>Added support for float to example
6199 and <tag>equation</tag>. Added support for pgwide to
6200 <tag>figure</tag>, example, and <tag>equation</tag> (the latter
6201 two via a dbfo pgwide="1" processing
6202 instruction).</para>
6203 <para role="commit-changes">Modified: fo/formal.xsl,1.51 - Robert
6204 Stayton</para>
6205 </listitem>
6206 <listitem role="commit-message">
6207 <para>Add pgwide.properties
6208 attribute-set.</para>
6209 <para role="commit-changes">Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert
6210 Stayton</para>
6211 </listitem>
6212 <listitem role="commit-message">
6213 <para>Added <tag>refclass</tag>.suppress
6214 param.</para>
6215 <para>If the value of <tag>refclass</tag>.suppress is
6216 non-zero, then display <tag>refclass</tag> contents is suppressed
6217 in output. Affects HTML and FO output
6218 only.</para>
6219 <para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
6220 html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
6221 Smith</para>
6222 </listitem>
6223 <listitem role="commit-message">
6224 <para>Improved support for
6225 <tag>task</tag> subelements</para>
6226 <para role="commit-changes">Modified: fo/task.xsl,1.3; html/task.xsl,1.3 -
6227 Jirka Kosek</para>
6228 </listitem>
6229 <listitem role="commit-message">
6230 <para>Adjusted spacing around
6231 K&amp;R-formatted <tag>Funcdef</tag> and <tag>Paramdef</tag>
6232 output such that it can more easily be discerned where one ends
6233 and the other begins. Closes #1213264.</para>
6234 <para role="commit-changes">Modified: fo/synop.xsl,1.18 -
6235 Michael(tm) Smith</para>
6236 </listitem>
6237 <listitem role="commit-message">
6238 <para>Made handling of
6239 paramdef/parameter in FO output consistent with that in HTML and
6240 manpages output. Closes #1213259.</para>
6241 <para role="commit-changes">Modified: fo/synop.xsl,1.17 - Michael(tm)
6242 Smith</para>
6243 </listitem>
6244 <listitem role="commit-message">
6245 <para>Made handling of
6246 <tag>Refnamediv</tag> consistent with formatting in HTML
6247 and manpages output; specifically, changed so that
6248 <tag>Refname</tag> (comma-separated list of multiple instances
6249 found) is used (instead of <tag>Refentrytitle</tag> as
6250 previously), then em-dash, then the <tag>Refpurpose</tag>. Closes
6251 #1212562.</para>
6252 <para role="commit-changes">Modified: fo/refentry.xsl,1.30 - Michael(tm)
6253 Smith</para>
6254 </listitem>
6255 <listitem role="commit-message">
6256 <para>Added output of
6257 <tag>Releaseinfo</tag> to recto titlepage ("<tag>copyright</tag>"
6258 page) for <tag>Book</tag> in FO output. This makes it consistent
6259 with HTML output. Closes #1327034. Thanks to Paul DuBois for
6260 reporting.</para>
6261 <para role="commit-changes">Modified: fo/titlepage.templates.xml,1.28 - Michael(tm)
6262 Smith</para>
6263 </listitem>
6264 <listitem role="commit-message">
6265 <para>Added condition for setting
6266 block-progression-dimension.minimum on table-row, instead of
6267 height, when <parameter>fop1.extensions</parameter> is
6268 non-zero. For an explanation of the reason for the change,
6269 <tag>see</tag>: http://wiki.apache.org/xmlgraphics-fop/Troubleshooting/CommonLogMessages</para>
6270 <para role="commit-changes">Modified: fo/pagesetup.xsl,1.59
6271 - Michael(tm) Smith</para>
6272 </listitem>
6273 <listitem role="commit-message">
6274 <para>Added new
6275 <tag>refclass</tag>.suppress param for suppressing display
6276 of <tag>Refclass</tag> in HTML and FO output. Did not add it to
6277 manpages because manpages stylesheet is currently just silently
6278 ignoring <tag>Refclass</tag> anyway. Closes request
6279 #1461065. Thanks to Davor Ocelic (docelic) for
6280 reporting.</para>
6281 <para role="commit-changes">Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 -
6282 Michael(tm) Smith</para>
6283 </listitem>
6284 <listitem role="commit-message">
6285 <para>Add support for keep-together PI
6286 to informal objects.</para>
6287 <para role="commit-changes">Modified: fo/formal.xsl,1.50 - Robert
6288 Stayton</para>
6289 </listitem>
6290 <listitem role="commit-message">
6291 <para>Add support for
6292 <parameter>fop1.extensions</parameter>.</para>
6293 <para role="commit-changes">Modified: fo/formal.xsl,1.49;
6294 fo/graphics.xsl,1.44; fo/table.xsl,1.47 - Robert
6295 Stayton</para>
6296 </listitem>
6297 <listitem role="commit-message">
6298 <para>Add support for fop1
6299 bookmarks.</para>
6300 <para role="commit-changes">Modified: fo/docbook.xsl,1.39 - Robert
6301 Stayton</para>
6302 </listitem>
6303 <listitem role="commit-message">
6304 <para>Add fop1.extentions parameter to
6305 add support for fop development version.</para>
6306 <para role="commit-changes">Modified: fo/param.ent,1.92;
6307 fo/param.xweb,1.105 - Robert Stayton</para>
6308 </listitem>
6309 <listitem role="commit-message">
6310 <para>Start supporting fop development
6311 version, which will become fop version 1.</para>
6312 <para role="commit-changes">Modified: fo/fop1.xsl,1.1 -
6313 Robert Stayton</para>
6314 </listitem>
6315 <listitem role="commit-message">
6316 <para>Add template for <tag>task</tag>
6317 in mode="xref-to".</para>
6318 <para role="commit-changes">Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert
6319 Stayton</para>
6320 </listitem>
6321 <listitem role="commit-message">
6322 <para><tag>table</tag> footnotes now
6323 also get <tag>footnote</tag>.properties
6324 attribute-set.</para>
6325 <para role="commit-changes">Modified: fo/footnote.xsl,1.22 - Robert
6326 Stayton</para>
6327 </listitem>
6328 <listitem role="commit-message">
6329 <para>Added <tag>index</tag>.separator
6330 named template to compute the separator punctuation based on
6331 locale.</para>
6332 <para role="commit-changes">Modified: fo/autoidx.xsl,1.36 - Robert Stayton</para>
6333 </listitem>
6334 <listitem role="commit-message">
6335 <para>Added support for <tag>link</tag>,
6336 <tag>olink</tag>, and <tag>xref</tag> within OO
6337 <tag>Classsynopsis</tag> and children. (Because DocBook NG/5
6338 allows it).</para>
6339 <para role="commit-changes">Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm)
6340 Smith</para>
6341 </listitem>
6342 <listitem role="commit-message">
6343 <para>Support <tag>date</tag> as an
6344 inline</para>
6345 <para role="commit-changes">Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman
6346 Walsh</para>
6347 </listitem>
6348 <listitem role="commit-message">
6349 <para>Added new parameter
6350 <parameter>keep.relative.image.uris</parameter></para>
6351 <para role="commit-changes">Modified: fo/param.ent,1.91;
6352 fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
6353 params/keep.relative.image.uris.xml,1.1 - Norman
6354 Walsh</para>
6355 </listitem>
6356 <listitem role="commit-message">
6357 <para>Map Unicode space characters
6358 U+2000-U+200A to fo:leaders.</para>
6359 <para role="commit-changes">Modified: fo/docbook.xsl,1.38;
6360 fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 - Jirka
6361 Kosek</para>
6362 </listitem>
6363 <listitem role="commit-message">
6364 <para>Output a real em dash for em-dash
6365 dingbat (instead of two hypens).</para>
6366 <para role="commit-changes">Modified: fo/fo.xsl,1.7 - Michael(tm)
6367 Smith</para>
6368 </listitem>
6369 <listitem role="commit-message">
6370 <para>Support default <tag>label</tag>
6371 width parameters for itemized and ordered lists</para>
6372 <para role="commit-changes">Modified: fo/lists.xsl,1.64;
6373 fo/param.ent,1.90; fo/param.xweb,1.103;
6374 params/itemizedlist.label.width.xml,1.1;
6375 params/orderedlist.label.width.xml,1.1 - Norman
6376 Walsh</para>
6377 </listitem>
6378 <listitem role="commit-message">
6379 <para>Generate localized
6380 <tag>title</tag> for <tag>Refsynopsisdiv</tag> if no
6381 appropriate <tag>Title</tag> descendant found in source. Closes
6382 #1212398. This change makes behavior for the <tag>Synopsis</tag>
6383 <tag>title</tag> consistent with the behavior of HTML and
6384 manpages output.</para>
6385 <para>Also, added
6386 xsl:use-attribute-sets="normal.<tag>para</tag>.spacing" to
6387 block generated for <tag>Cmdsynopsis</tag> output. Previously,
6388 that block had no spacing at all specified, which resulted it
6389 being crammed up to closely to the <tag>Synopsis</tag>
6390 head.</para>
6391 <para role="commit-changes">Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm)
6392 Smith</para>
6393 </listitem>
6394 <listitem role="commit-message">
6395 <para>Added parameters to support
6396 localization of <tag>index</tag>
6397 item punctuation.</para>
6398 <para role="commit-changes">Modified: fo/autoidx.xsl,1.35 - Robert
6399 Stayton</para>
6400 </listitem>
6401 <listitem role="commit-message">
6402 <para>Added
6403 <parameter>index.number.separator</parameter>,
6404 <parameter>index.range.separator</parameter>,
6405 and <parameter>index.term.separator</parameter> parameters to
6406 support localization of punctuation in <tag>index</tag>
6407 entries.</para>
6408 <para role="commit-changes">Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert
6409 Stayton</para>
6410 </listitem>
6411 <listitem role="commit-message">
6412 <para>Added "Cross References"
6413 <tag>section</tag> in HTML doc (for consistency with the FO
6414 doc). Also, moved the existing FO "Cross
6415 References" <tag>section</tag> to follow the "Linking"
6416 <tag>section</tag>.</para>
6417 <para role="commit-changes">Modified: fo/param.xweb,1.101; html/param.xweb,1.95 -
6418 Michael(tm) Smith</para>
6419 </listitem>
6420 <listitem role="commit-message">
6421 <para>Added ID attribues to all
6422 <tag>Reference</tag> elements (e.g., id="tables" for the doc for
6423 <tag>section</tag> on <tag>Table</tag> params). So pages for
6424 all subsections of ref docs now have stable filenames instead
6425 of arbitrary generated filenames.</para>
6426 <para role="commit-changes">Modified: fo/param.xweb,1.100;
6427 html/param.xweb,1.94 - Michael(tm) Smith</para>
6428 </listitem>
6429 <listitem role="commit-message">
6430 <para>Added two new parameters for
6431 handling of multi-term
6432 <tag>varlistentry</tag> elements:</para>
6433 <para><parameter>variablelist.term.break.after</parameter>: 
6434 When the <parameter>variablelist.term.break.after</parameter> is
6435 non-zero, it will  generate a line break after each
6436 <tag>term</tag> multi-term
6437 <tag>varlistentry</tag>.</para>
6438 <para><parameter>variablelist.term.separator</parameter>: 
6439 When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
6440 elements, the string  specified in the value of the
6441 <parameter>variablelist.term.separator</parameter>  parameter is
6442 placed after each <tag>term</tag> except the last. The default 
6443 is ", " (a comma followed by a space). To suppress rendering of 
6444 the separator, set the value of
6445 <parameter>variablelist.term.separator</parameter> to  the empty
6446 string ("").</para>
6447 <para>These parameters are primarily intended to be
6448 useful if you have multi-term varlistentries that have long
6449 terms.</para>
6450 <para>Closes #1306676. Thanks to Sam Steingold for
6451 providing an example "lots of long terms" doc that demonstrated
6452 the value of having these options.</para>
6453 <para>Also, added
6454 normalize-space() call to processing of each
6455 <tag>term</tag>.</para>
6456 <para>This change affects all output formats
6457 (HTML, PDF, manpages). The default behavior should pretty much
6458 remain the same as before, but it is possible (as always) that
6459 the change may introduce some
6460 new bugginess.</para>
6461 <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
6462 fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
6463 html/param.xweb,1.93; manpages/lists.xsl,1.22;
6464 manpages/param.ent,1.14; manpages/param.xweb,1.16;
6465 params/variablelist.term.break.after.xml,1.1;
6466 params/variablelist.term.separator.xml,1.1 - Michael(tm)
6467 Smith</para>
6468 </listitem>
6469 <listitem role="commit-message">
6470 <para>Add <tag>sidebar</tag> titlepage
6471 placeholder attset for styles.</para>
6472 <para role="commit-changes">Modified: fo/titlepage.xsl,1.37 - Robert
6473 Stayton</para>
6474 </listitem>
6475 <listitem role="commit-message">
6476 <para>Add titlepage for
6477 <tag>sidebar</tag>.</para>
6478 <para role="commit-changes">Modified: fo/titlepage.templates.xml,1.27 - Robert
6479 Stayton</para>
6480 </listitem>
6481 <listitem role="commit-message">
6482 <para>Implemented RFE
6483 #1292615.</para>
6484 <para>Added bunch of new parameters (attribute sets)
6485 that affect list presentation: list.block.properties,
6486 <tag>itemizedlist</tag>.properties, <tag>orderedlist</tag>.properties,
6487 <tag>itemizedlist</tag>.<tag>label</tag>.properties and
6488 <tag>orderedlist</tag>.<tag>label</tag>.properties. Default behaviour
6489 of stylesheets has not been changed but further customizations will be
6490 much more easier.</para>
6491 <para role="commit-changes">Modified: fo/lists.xsl,1.61; fo/param.ent,1.87;
6492 fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1;
6493 params/itemizedlist.properties.xml,1.1;
6494 params/list.block.properties.xml,1.1;
6495 params/orderedlist.label.properties.xml,1.1;
6496 params/orderedlist.properties.xml,1.1 - Jirka
6497 Kosek</para>
6498 </listitem>
6499 <listitem role="commit-message">
6500 <para>Implemented RFE
6501 #1242092.</para>
6502 <para>You can enable crop marks in your document by
6503 setting crop.marks=1 and xep.extensions=1. Appearance of crop
6504 marks can be controlled by parameters
6505 <parameter>crop.mark.bleed</parameter> (6pt),
6506 <parameter>crop.mark.offset</parameter> (24pt) and
6507 <parameter>crop.mark.width</parameter> (0.5pt).</para>
6508 <para>Also there
6509 is new named template called user-xep-pis. You can overwrite it in
6510 order to produce some PIs that can control XEP as described in
6511 http://www.renderx.com/reference.html#Output_Formats</para>
6512 <para role="commit-changes">Modified: fo/docbook.xsl,1.36;
6513 fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23;
6514 params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1;
6515 params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka
6516 Kosek</para>
6517 </listitem>
6518 </itemizedlist>
6519 </sect2><!--end of FO changes for snapshot_2006-05-15_0803-->
6520
6521 <sect2 xml:id="V1700_HTML">
6522 <title>HTML</title>
6523 <para>The following changes have been made to the
6524         <filename>html</filename> code
6525         since the 1.69.1 release.</para>
6526 <itemizedlist>
6527 <listitem role="commit-message">
6528 <para>implemented
6529 <tag>index</tag>.method parameter and three
6530 methods.</para>
6531 <para role="commit-changes">Modified: html/autoidx.xsl,1.28 - Robert
6532 Stayton</para>
6533 </listitem>
6534 <listitem role="commit-message">
6535 <para>added <tag>index</tag>.method
6536 parameter to support 3 indexing methods.</para>
6537 <para role="commit-changes">Modified: html/param.ent,1.94;
6538 html/param.xweb,1.103 - Robert Stayton</para>
6539 </listitem>
6540 <listitem role="commit-message">
6541 <para>Implemented feature request
6542 #1072510 as a processing instruction to permit including external
6543 HTML content into HTML output.</para>
6544 <para role="commit-changes">Modified: html/pi.xsl,1.9 - Robert
6545 Stayton</para>
6546 </listitem>
6547 <listitem role="commit-message">
6548 <para>Added new parameter
6549 <parameter>chunk.tocs.and.lots</parameter>.has.<tag>title</tag> which
6550 controls presence of <tag>title</tag> in a separate chunk with
6551 ToC/LoT. Disabling <tag>title</tag> can be very useful if you are
6552 generating frameset output (well, yes those frames, but some customers
6553 really want them ;-).</para>
6554 <para role="commit-changes">Modified: html/chunk-code.xsl,1.15;
6555 html/param.ent,1.93; html/param.xweb,1.102;
6556 params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
6557 Kosek</para>
6558 </listitem>
6559 <listitem role="commit-message">
6560 <para>Support dbhtml/dbfo start PI for
6561 <tag>orderedlist</tag> numbering in both HTML and
6562 FO</para>
6563 <para role="commit-changes">Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman
6564 Walsh</para>
6565 </listitem>
6566 <listitem role="commit-message">
6567 <para>Allow <tag>ToC</tag> without
6568 <tag>title</tag> also for set and
6569 <tag>book</tag>.</para>
6570 <para role="commit-changes">Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 -
6571 Jirka Kosek</para>
6572 </listitem>
6573 <listitem role="commit-message">
6574 <para>Implemented floats uniformly for
6575 <tag>figure</tag>, example, <tag>equation</tag>
6576 and <tag>informalfigure</tag>, <tag>informalexample</tag>, and
6577 <tag>informalequation</tag>.</para>
6578 <para role="commit-changes">Modified: html/formal.xsl,1.22 - Robert
6579 Stayton</para>
6580 </listitem>
6581 <listitem role="commit-message">
6582 <para>Added the
6583 autotoc.<tag>label</tag>.in.hyperlink param.</para>
6584 <para>If the value
6585 of autotoc.<tag>label</tag>.in.hyperlink is non-zero, labels
6586 are included in hyperlinked titles in the <tag>TOC</tag>. If it
6587 is instead zero, labels are still displayed prior to the
6588 hyperlinked titles, but are not hyperlinked along with the
6589 titles.</para>
6590 <para>Closes patch #1065868. Thanks to anatoly techtonik
6591 for the patch.</para>
6592 <para role="commit-changes">Modified: html/autotoc.xsl,1.36; html/param.ent,1.92;
6593 html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 -
6594 Michael(tm) Smith</para>
6595 </listitem>
6596 <listitem role="commit-message">
6597 <para>Added two new params:
6598 html.head.<tag>legalnotice</tag>.<tag>link</tag>.types
6599 and html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple.</para>
6600 <para>If
6601 the value of the <parameter>generate.legalnotice.link</parameter> is
6602 non-zero, then the stylesheet generates (in the head
6603 <tag>section</tag> of the HTML source) either a single HTML
6604 <tag>link</tag> element or, if the value of
6605 the html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple is
6606 non-zero, one <tag>link</tag> element for each <tag>link</tag>
6607 type specified. Each <tag>link</tag> has the
6608 following attributes:</para>
6609 <para> - a rel attribute whose value
6610 is derived from the value of 
6611 html.head.<tag>legalnotice</tag>.<tag>link</tag>.types</para>
6612 <para> -
6613 an href attribute whose value is set to the URL of the file 
6614 containing the <tag>legalnotice</tag></para>
6615 <para> - a <tag>title</tag>
6616 attribute whose value is set to the <tag>title</tag> of the 
6617 corresponding <tag>legalnotice</tag> (or a <tag>title</tag>
6618 programatically  determined by the stylesheet)</para>
6619 <para>For
6620 example:</para>
6621 <para> &lt;<tag>link</tag> rel="<tag>copyright</tag>"
6622 href="ln-id2524073.html" title="Legal Notice"&gt;</para>
6623 <para>Closes
6624 #1476450. Thanks to Sam Steingold.</para>
6625 <para role="commit-changes">Modified: html/chunk-common.xsl,1.45;
6626 html/param.ent,1.91; html/param.xweb,1.100;
6627 params/generate.legalnotice.link.xml,1.4;
6628 params/html.head.legalnotice.link.multiple.xml,1.1;
6629 params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm)
6630 Smith</para>
6631 </listitem>
6632 <listitem role="commit-message">
6633 <para>Added <tag>refclass</tag>.suppress
6634 param.</para>
6635 <para>If the value of <tag>refclass</tag>.suppress is
6636 non-zero, then display <tag>refclass</tag> contents is suppressed
6637 in output. Affects HTML and FO output
6638 only.</para>
6639 <para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
6640 html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
6641 Smith</para>
6642 </listitem>
6643 <listitem role="commit-message">
6644 <para>Improved support for
6645 <tag>task</tag> subelements</para>
6646 <para role="commit-changes">Modified: fo/task.xsl,1.3; html/task.xsl,1.3 -
6647 Jirka Kosek</para>
6648 </listitem>
6649 <listitem role="commit-message">
6650 <para>Added new
6651 <tag>refclass</tag>.suppress param for suppressing display
6652 of <tag>Refclass</tag> in HTML and FO output. Did not add it to
6653 manpages because manpages stylesheet is currently just silently
6654 ignoring <tag>Refclass</tag> anyway. Closes request
6655 #1461065. Thanks to Davor Ocelic (docelic) for
6656 reporting.</para>
6657 <para role="commit-changes">Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 -
6658 Michael(tm) Smith</para>
6659 </listitem>
6660 <listitem role="commit-message">
6661 <para>Process <tag>alt</tag> text with
6662 normalize-space(). Replace tab indents with
6663 spaces.</para>
6664 <para role="commit-changes">Modified: html/graphics.xsl,1.57 - Robert
6665 Stayton</para>
6666 </listitem>
6667 <listitem role="commit-message">
6668 <para>Content of <tag>citation</tag>
6669 element is automatically linked to the bibliographic <tag>entry</tag>
6670 with the corresponding <tag>abbrev</tag>.</para>
6671 <para role="commit-changes">Modified: html/biblio.xsl,1.26;
6672 html/inline.xsl,1.47; html/xref.xsl,1.58 - Jirka
6673 Kosek</para>
6674 </listitem>
6675 <listitem role="commit-message">
6676 <para>Add template for <tag>task</tag>
6677 in mode="xref-to".</para>
6678 <para role="commit-changes">Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert
6679 Stayton</para>
6680 </listitem>
6681 <listitem role="commit-message">
6682 <para>Suppress ID warnings if the
6683 .warnings parameter is 0</para>
6684 <para role="commit-changes">Modified: html/html.xsl,1.17 - Norman
6685 Walsh</para>
6686 </listitem>
6687 <listitem role="commit-message">
6688 <para>Add support for floatstyle to
6689 <tag>figure</tag>.</para>
6690 <para role="commit-changes">Modified: html/formal.xsl,1.21 - Robert
6691 Stayton</para>
6692 </listitem>
6693 <listitem role="commit-message">
6694 <para>Handling of <tag>xref</tag> to
6695 area/areaset need support in extensions code also. I currently have no
6696 time to touch extensions code, so code is here to be enabled when
6697 extension is fixed also.</para>
6698 <para role="commit-changes">Modified: html/xref.xsl,1.56 - Jirka
6699 Kosek</para>
6700 </listitem>
6701 <listitem role="commit-message">
6702 <para>Added 3 parameters for overriding
6703 gentext for <tag>index</tag>
6704 punctuation.</para>
6705 <para role="commit-changes">Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert
6706 Stayton</para>
6707 </listitem>
6708 <listitem role="commit-message">
6709 <para>Added parameters to support
6710 localization of <tag>index</tag> item punctuation. Added
6711 <tag>index</tag>.separator named template to compute
6712 the separator punctuation based on
6713 locale.</para>
6714 <para role="commit-changes">Modified: html/autoidx.xsl,1.27 - Robert
6715 Stayton</para>
6716 </listitem>
6717 <listitem role="commit-message">
6718 <para>Added a &lt;div
6719 class="{$class}-contents"&gt; wrapper around output of contents
6720 of all formal objects. Also, added an optional &lt;br
6721 class="{class}-break"/&gt; linebreak after all formal
6722 objects.</para>
6723 <para>WARNING: Because this change places an additional
6724 DIV between the DIV wrapper for the <tag>equation</tag> and the
6725 <tag>equation</tag> contents, it may break some existing CSS
6726 stylesheets that have been created with the assumption that there
6727 would never be an intervening DIV there.</para>
6728 <para>The following is
6729 an example of what <tag>Equation</tag> output looks like as a
6730 result of the changes described above.</para>
6731 <para> &lt;div
6732 class="<tag>equation</tag>"&gt;  &lt;a name="three"
6733 id="three"&gt;&lt;/a&gt;</para>
6734 <para> &lt;p
6735 class="<tag>title</tag>"&gt;&lt;b&gt;(1.3)&lt;/b&gt;&lt;/p&gt;</para>
6736 <para>
6737 &lt;div class="equation-contents"&gt;  &lt;span
6738 class="<tag>mathphrase</tag>"&gt;1+1=3&lt;/span&gt; 
6739 &lt;/div&gt;  &lt;/div&gt;&lt;br
6740 class="equation-break"&gt;</para>
6741 <para>Rationale: These changes allow
6742 CSS control of the placement of the formal-object
6743 <tag>title</tag> relative to the formal-object
6744 contents. For example, using the CSS "float" <tag>property</tag>
6745 enables the <tag>title</tag> and contents to be rendered on the
6746 same line. Example stylesheet:</para>
6747 <para> .<tag>equation</tag>
6748 {  margin-top: 20px;  margin-bottom: 20px;  } 
6749 .equation-contents {  float: left;  }</para>
6750 <para>
6751 .<tag>equation</tag> .<tag>title</tag> {  margin-top: 0; 
6752 float: right;  margin-right: 200px;  }</para>
6753 <para>
6754 .<tag>equation</tag> .<tag>title</tag> b {  font-weight:
6755 normal;  }</para>
6756 <para> .equation-break {  clear: both; 
6757 }</para>
6758 <para>Note that the purpose of the ".equation-break" class is
6759 to provide a way to clear off the floats.</para>
6760 <para>If you want
6761 to instead have the <tag>equation</tag> <tag>title</tag> rendered to
6762 the left of the <tag>equation</tag> contents, you can do
6763 something like this:</para>
6764 <para> .<tag>equation</tag> { 
6765 margin-top: 20px;  width: 300px;  margin-bottom: 20px; 
6766 }  .equation-contents {  float: right;  }</para>
6767 <para>
6768 .<tag>equation</tag> .<tag>title</tag> {  margin-top: 0; 
6769 float: left;  margin-right: 200px;  }</para>
6770 <para>
6771 .<tag>equation</tag> .<tag>title</tag> b {  font-weight:
6772 normal;  }</para>
6773 <para> .equation-break {  clear: both; 
6774 }</para>
6775 <para role="commit-changes">Modified: html/formal.xsl,1.20 - Michael(tm) Smith</para>
6776 </listitem>
6777 <listitem role="commit-message">
6778 <para>Added a chunker.output.quiet
6779 top-level parameter so that the chunker can be made quiet by
6780 default</para>
6781 <para role="commit-changes">Modified: html/chunker.xsl,1.26 - Norman Walsh</para>
6782 </listitem>
6783 <listitem role="commit-message">
6784 <para>Added support for <tag>link</tag>,
6785 <tag>olink</tag>, and <tag>xref</tag> within OO
6786 <tag>Classsynopsis</tag> and children. (Because DocBook NG/5
6787 allows it).</para>
6788 <para role="commit-changes">Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm)
6789 Smith</para>
6790 </listitem>
6791 <listitem role="commit-message">
6792 <para>New parameter:
6793 <parameter>id.warnings</parameter>. If non-zero, warnings are
6794 generated for titled objects that don't have titles. True by default;
6795 I wonder if this will be too aggressive?</para>
6796 <para role="commit-changes">Modified: html/biblio.xsl,1.25;
6797 html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19;
6798 html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16;
6799 html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22;
6800 html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman
6801 Walsh</para>
6802 </listitem>
6803 <listitem role="commit-message">
6804 <para>If the
6805 <parameter>keep.relative.image.uris</parameter> parameter is true,
6806 don't use the absolute <tag>URI</tag> (as calculated from xml:base) in
6807 the img src attribute, us the value the <tag>author</tag>
6808 specified. Note that we still have to calculate the absolute
6809 <tag>filename</tag> for use in the image intrinsics
6810 extension.</para>
6811 <para role="commit-changes">Modified: html/graphics.xsl,1.56 - Norman
6812 Walsh</para>
6813 </listitem>
6814 <listitem role="commit-message">
6815 <para>Support <tag>date</tag> as an
6816 inline</para>
6817 <para role="commit-changes">Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman
6818 Walsh</para>
6819 </listitem>
6820 <listitem role="commit-message">
6821 <para>Added new parameter
6822 <parameter>keep.relative.image.uris</parameter></para>
6823 <para role="commit-changes">Modified: fo/param.ent,1.91;
6824 fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
6825 params/keep.relative.image.uris.xml,1.1 - Norman
6826 Walsh</para>
6827 </listitem>
6828 <listitem role="commit-message">
6829 <para>Added two new parameters for
6830 handling of multi-term
6831 <tag>varlistentry</tag> elements:</para>
6832 <para><parameter>variablelist.term.break.after</parameter>: 
6833 When the <parameter>variablelist.term.break.after</parameter> is
6834 non-zero, it will  generate a line break after each
6835 <tag>term</tag> multi-term
6836 <tag>varlistentry</tag>.</para>
6837 <para><parameter>variablelist.term.separator</parameter>: 
6838 When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
6839 elements, the string  specified in the value of the
6840 <parameter>variablelist.term.separator</parameter>  parameter is
6841 placed after each <tag>term</tag> except the last. The default 
6842 is ", " (a comma followed by a space). To suppress rendering of 
6843 the separator, set the value of
6844 <parameter>variablelist.term.separator</parameter> to  the empty
6845 string ("").</para>
6846 <para>These parameters are primarily intended to be
6847 useful if you have multi-term varlistentries that have long
6848 terms.</para>
6849 <para>Closes #1306676. Thanks to Sam Steingold for
6850 providing an example "lots of long terms" doc that demonstrated
6851 the value of having these options.</para>
6852 <para>Also, added
6853 normalize-space() call to processing of each
6854 <tag>term</tag>.</para>
6855 <para>This change affects all output formats
6856 (HTML, PDF, manpages). The default behavior should pretty much
6857 remain the same as before, but it is possible (as always) that
6858 the change may introduce some
6859 new bugginess.</para>
6860 <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
6861 fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
6862 html/param.xweb,1.93; manpages/lists.xsl,1.22;
6863 manpages/param.ent,1.14; manpages/param.xweb,1.16;
6864 params/variablelist.term.break.after.xml,1.1;
6865 params/variablelist.term.separator.xml,1.1 - Michael(tm)
6866 Smith</para>
6867 </listitem>
6868 <listitem role="commit-message">
6869 <para>Added "wrapper-name" param to
6870 inline.charseq named template, enabling it to output inlines
6871 other than just "span". <tag>Acronym</tag> and <tag>Abbrev</tag>
6872 templates now use inline.charseq to output HTML
6873 "<tag>acronym</tag>" and "abbr" elements (instead of
6874 "span"). Closes #1305468. Thanks to Sam Steingold for suggesting
6875 the change.</para>
6876 <para role="commit-changes">Modified: html/inline.xsl,1.45 - Michael(tm)
6877 Smith</para>
6878 </listitem>
6879 </itemizedlist>
6880 </sect2><!--end of HTML changes for snapshot_2006-05-15_0803-->
6881
6882 <sect2 xml:id="V1700_Manpages">
6883 <title>Manpages</title>
6884 <para>The following changes have been made to the
6885         <filename>manpages</filename> code
6886         since the 1.69.1 release.</para>
6887 <itemizedlist>
6888 <listitem role="commit-message">
6889 <para>Added the following
6890 params:</para>
6891 <para> - man.indent.width (string-valued)  -
6892 man.indent.refsect (boolean)  - man.indent.blurbs (boolean) 
6893 - man.indent.lists (boolean)  - man.indent.verbatims
6894 (boolean)</para>
6895 <para>Note that in earlier snapshots, man.indent.width
6896 was named man.indentation.default.value and the boolean params
6897 had names like man.indentation.*.adjust. Also the
6898 man.indent.blurbs param was called man.indentation.authors.adjust
6899 (or something).</para>
6900 <para>The behavior now is: If the value of a
6901 particular man.indent.* boolean param is non-zero, the
6902 corresponding contents (refsect*, list items,
6903 authorblurb/personblurb, vervatims) are displayed with a left
6904 margin indented by a width equal to the value
6905 of man.indent.width.</para>
6906 <para role="commit-changes">Modified: params/man.indent.blurbs.xml,1.1;
6907 manpages/docbook.xsl,1.74; manpages/info.xsl,1.20;
6908 manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
6909 manpages/param.ent,1.22; manpages/param.xweb,1.24;
6910 manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1;
6911 params/man.indent.refsect.xml,1.1;
6912 params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 -
6913 Michael(tm) Smith</para>
6914 </listitem>
6915 <listitem role="commit-message">
6916 <para>Added
6917 man.<tag>table</tag>.footnotes.divider param.</para>
6918 <para>In each
6919 <tag>table</tag> that contains footenotes, the string specified
6920 by the man.<tag>table</tag>.footnotes.divider parameter is output
6921 before the list of footnotes for the
6922 <tag>table</tag>.</para>
6923 <para role="commit-changes">Modified: manpages/docbook.xsl,1.73;
6924 manpages/links.xsl,1.6; manpages/param.ent,1.21;
6925 manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 -
6926 Michael(tm) Smith</para>
6927 </listitem>
6928 <listitem role="commit-message">
6929 <para>Added the
6930 man.output.in.separate.dir,
6931 man.output.<parameter>base.dir</parameter>,
6932 and man.output.subdirs.enabled parameters.</para>
6933 <para>The
6934 man.output.<parameter>base.dir</parameter> parameter specifies the
6935 base directory into which man-page files are
6936 output. The man.output.subdirs.enabled parameter controls whether
6937 the files are output in subdirectories within the base
6938 directory.</para>
6939 <para>The values of the
6940 man.output.<parameter>base.dir</parameter>
6941 and man.output.subdirs.enabled parameters are used only if the
6942 value of man.output.in.separate.dir parameter is non-zero. If the
6943 value of man.output.in.separate.dir is zero, man-page files are
6944 not output in a separate
6945 directory.</para>
6946 <para role="commit-changes">Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20;
6947 manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1;
6948 params/man.output.in.separate.dir.xml,1.1;
6949 params/man.output.subdirs.enabled.xml,1.1 - Michael(tm)
6950 Smith</para>
6951 </listitem>
6952 <listitem role="commit-message">
6953 <para>Added
6954 man.font.<tag>table</tag>.headings and
6955 man.font.<tag>table</tag>.<tag>title</tag> params, for
6956 controlling font in <tag>table</tag> headings and
6957 titles.</para>
6958 <para role="commit-changes">Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19;
6959 manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1;
6960 params/man.font.table.title.xml,1.1 - Michael(tm)
6961 Smith</para>
6962 </listitem>
6963 <listitem role="commit-message">
6964 <para>Added
6965 man.font.<tag>funcsynopsisinfo</tag> and
6966 man.font.<tag>funcprototype</tag> params, for specifying the roff
6967 font (for example, BI, B, I) for <tag>funcsynopsisinfo</tag> and
6968 <tag>funcprototype</tag> output.</para>
6969 <para role="commit-changes">Modified: manpages/block.xsl,1.19;
6970 manpages/docbook.xsl,1.69; manpages/param.ent,1.18;
6971 manpages/param.xweb,1.20; manpages/synop.xsl,1.29;
6972 manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1;
6973 params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm)
6974 Smith</para>
6975 </listitem>
6976 <listitem role="commit-message">
6977 <para>Added
6978 man.<tag>segtitle</tag>.suppress param.</para>
6979 <para>If the value of
6980 man.<tag>segtitle</tag>.suppress is non-zero, then display
6981 of <tag>segtitle</tag> contents is suppressed in
6982 output.</para>
6983 <para role="commit-changes">Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17;
6984 manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 -
6985 Michael(tm) Smith</para>
6986 </listitem>
6987 <listitem role="commit-message">
6988 <para>Added
6989 man.output.<parameter>manifest</parameter>.enabled and
6990 man.output.manifest.<tag>filename</tag> params.</para>
6991 <para>If
6992 man.output.<parameter>manifest</parameter>.enabled is non-zero, a list
6993 of filenames for man pages generated by the stylesheet
6994 transformation is written to the file named by
6995 man.output.<parameter>manifest</parameter>.<tag>filename</tag></para>
6996 <para role="commit-changes">Modified: manpages/docbook.xsl,1.67;
6997 manpages/other.xsl,1.19; manpages/param.ent,1.16;
6998 manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1;
6999 params/man.output.manifest.filename.xml,1.1;
7000 tools/make/Makefile.DocBook,1.4 - Michael(tm)
7001 Smith</para>
7002 </listitem>
7003 <listitem role="commit-message">
7004 <para>Added
7005 <tag>refentry</tag>.meta.get.quietly param.</para>
7006 <para>If zero (the
7007 default), notes and warnings about "missing" markup are generated
7008 during gathering of <tag>refentry</tag> metadata. If
7009 non-zero, the metadata is gathered "quietly" -- that is, the
7010 notes and warnings are suppressed.</para>
7011 <para>NOTE: If you are
7012 processing a large amount of <tag>refentry</tag> content,  you
7013 may be able to speed up processing significantly by  setting a
7014 non-zero value for
7015 <tag>refentry</tag>.meta.get.quietly.</para>
7016 <para role="commit-changes">Modified: common/refentry.xsl,1.17;
7017 manpages/param.ent,1.15; manpages/param.xweb,1.17;
7018 params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
7019 Smith</para>
7020 </listitem>
7021 <listitem role="commit-message">
7022 <para>Changed names of all boolean
7023 indentation params to man.indent.* Also discarded individual
7024 man.indent.*.value params and switched to just using a common
7025 man.indent.width param (3n by default).</para>
7026 <para role="commit-changes">Modified: manpages/docbook.xsl,1.66;
7027 manpages/info.xsl,1.19; manpages/lists.xsl,1.29;
7028 manpages/other.xsl,1.18; manpages/refentry.xsl,1.13 - Michael(tm)
7029 Smith</para>
7030 </listitem>
7031 <listitem role="commit-message">
7032 <para>Added boolean
7033 man.output.in.separate.dir param, to control whether or not man
7034 files are output in separate directory.</para>
7035 <para role="commit-changes">Modified: manpages/docbook.xsl,1.65;
7036 manpages/utility.xsl,1.14 - Michael(tm) Smith</para>
7037 </listitem>
7038 <listitem role="commit-message">
7039 <para>Added options for controlling
7040 indentation of verbatim output. Controlled through the
7041 man.indentation.verbatims.adjust
7042 and man.indentation.verbatims.value params. Closes
7043 #1242997</para>
7044 <para role="commit-changes">Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 -
7045 Michael(tm) Smith</para>
7046 </listitem>
7047 <listitem role="commit-message">
7048 <para>Added options for controlling
7049 indentation in lists and in *blurb output in the AUTHORS
7050 <tag>section</tag>. Controlled through
7051 the man.indentation.lists.adjust,
7052 man.indentation.lists.value, man.indentation.authors.adjust, and
7053 man.indentation.authors.value parameters. Default is 3 characters
7054 (instead of the roff default of 8 characters). Closes
7055 #1449369.</para>
7056 <para>Also, removed the indent that was being set on
7057 <tag>informalexample</tag> outuput. I will instead add an option
7058 for indenting verbatims, which I think is what the
7059 <tag>informalexample</tag> indent was intended
7060 for originally.</para>
7061 <para role="commit-changes">Modified: manpages/block.xsl,1.14;
7062 manpages/docbook.xsl,1.63; manpages/info.xsl,1.18;
7063 manpages/lists.xsl,1.28 - Michael(tm) Smith</para>
7064 </listitem>
7065 <listitem role="commit-message">
7066 <para>Changed line-spacing call before
7067 <tag>synopfragment</tag> to use ".sp -1n" ("n" units specified)
7068 instead of plain ".sp -1"</para>
7069 <para role="commit-changes">Modified: manpages/synop.xsl,1.28 - Michael(tm)
7070 Smith</para>
7071 </listitem>
7072 <listitem role="commit-message">
7073 <para>Added support for writing man
7074 files into a specific output directory and into appropriate
7075 subdirectories within that output directory. Controlled through
7076 the man.<parameter>base.dir</parameter> parameter (similar to the
7077 <parameter>base.dir</parameter> support in the HTML stylesheet) and
7078 the man.subdirs.enabled parameter, which automatically determines
7079 the name of an appropriate subdir (for example, man/man7,
7080 man/man1, etc.) based on the <tag>section</tag> number/manvolnum
7081 of the source <tag>Refentry</tag>.</para>
7082 <para>Closes #1255036 and
7083 #1170317. Thanks to Denis Bradford for the original feature
7084 request, and to Costin Stroie for submitting a patch that was
7085 very helpful in implementing the
7086 support.</para>
7087 <para role="commit-changes">Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 -
7088 Michael(tm) Smith</para>
7089 </listitem>
7090 <listitem role="commit-message">
7091 <para>Refined XPath statements and
7092 notification messages for <tag>refentry</tag> metadata
7093 handling.</para>
7094 <para role="commit-changes">Modified: common/common.xsl,1.59; common/refentry.xsl,1.14;
7095 manpages/docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm)
7096 Smith</para>
7097 </listitem>
7098 <listitem role="commit-message">
7099 <para>Added support for
7100 <tag>copyright</tag> and <tag>legalnotice</tag>. The manpages
7101 stylesheets now output a <tag>COPYRIGHT</tag> <tag>section</tag>,
7102 after the AUTHORS <tag>section</tag>, if a <tag>copyright</tag>
7103 or <tag>legalnotice</tag> is found in the source. The
7104 <tag>section</tag> contains the <tag>copyright</tag> contents followed
7105 by the <tag>legalnotice</tag> contents. Closes
7106 #1450209.</para>
7107 <para role="commit-changes">Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 -
7108 Michael(tm) Smith</para>
7109 </listitem>
7110 <listitem role="commit-message">
7111 <para>Drastically reworked all of the
7112 XPath expressions used in <tag>refentry</tag> metadata gathering
7113 -- completely removed $parentinfo and turned $info into a set of
7114 nodes that includes the *info contents of the <tag>Refentry</tag>
7115 plus the *info contents all all of its ancestor elements. The
7116 basic XPath expression now used throughout is (using the example
7117 of checking for a <tag>date</tag>):</para>
7118 <para>
7119 (($info[//date])[last()]/date)[1].</para>
7120 <para>That selects the "last"
7121 *info/date <tag>date</tag> in document order -- that is, the one
7122 eitther on the <tag>Refentry</tag> itself or on the
7123 closest ancestor to the <tag>Refentry</tag>.</para>
7124 <para>It's
7125 likely this change may break some things; may need to pick up
7126 some pieces later.</para>
7127 <para>Also, changed the default value for the
7128 <parameter>man.th.extra2.max.length</parameter> from 40 to
7129 30.</para>
7130 <para role="commit-changes">Modified: common/common.xsl,1.58; common/refentry.xsl,1.7;
7131 params/man.th.extra2.max.length.xml,1.2;
7132 params/refentry.date.profile.xml,1.2;
7133 params/refentry.manual.profile.xml,1.2;
7134 params/refentry.source.name.profile.xml,1.2;
7135 params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58;
7136 manpages/other.xsl,1.15 - Michael(tm) Smith</para>
7137 </listitem>
7138 <listitem role="commit-message">
7139 <para>Added support for DocBook 5
7140 namespace-stripping in manpages stylesheet. Closes request
7141 #1210692.</para>
7142 <para role="commit-changes">Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 -
7143 Michael(tm) Smith</para>
7144 </listitem>
7145 <listitem role="commit-message">
7146 <para>Fixed handling of <tag>table</tag>
7147 footnotes. With this checkin, the <tag>table</tag> support in the
7148 manpages stylesheet is now basically feature complete. So this
7149 change closes request #619532, "No support for tables" -- the
7150 oldest currently open manpages feature request, submitted by Ben
7151 Secrest (blsecres) on 2002-10-07. Congratulations to me [patting
7152 myself on the back].</para>
7153 <para role="commit-changes">Modified: manpages/block.xsl,1.11;
7154 manpages/docbook.xsl,1.55; manpages/table.xsl,1.15 - Michael(tm)
7155 Smith</para>
7156 </listitem>
7157 <listitem role="commit-message">
7158 <para>Added handling for
7159 <tag>table</tag> titles. Also fixed handling of nested tables;
7160 nest tables are now "extracted" and displayed just after their
7161 parent tables.</para>
7162 <para role="commit-changes">Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14
7163 - Michael(tm) Smith</para>
7164 </listitem>
7165 <listitem role="commit-message">
7166 <para>Added option for turning off bold
7167 formatting in <tag>Funcsynopsis</tag>. Boldface formatting in
7168 <tag>function</tag> <tag>synopsis</tag> is mandated in the
7169 man(7) man page and is used almost universally in existing man
7170 pages. Despite that, it really does look like crap to have an
7171 entire <tag>Funcsynopsis</tag> output in bold, so I added params
7172 for turning off the bold formatting and/or replacing it with a
7173 different roff special font (e.g., "RI" for alternating
7174 roman/italic instead of the default "BI" for alternating
7175 bold/italic). The new params
7176 are "man.<tag>funcprototype</tag>.font" and
7177 "man.<tag>funcsynopsisinfo</tag>.font". To be documented
7178 later.</para>
7179 <para>Closes #1452247. Thanks to Joe Orton for the feature
7180 request.</para>
7181 <para role="commit-changes">Modified: params/man.string.subst.map.xml,1.16;
7182 manpages/block.xsl,1.10; manpages/docbook.xsl,1.51;
7183 manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm)
7184 Smith</para>
7185 </listitem>
7186 <listitem role="commit-message">
7187 <para>Use AUTHORS instead of
7188 <tag>AUTHOR</tag> if we have multiple people to attribute. Also,
7189 fixed checking such that we generate
7190 <tag>author</tag> <tag>section</tag> even if we don't have an
7191 <tag>author</tag> (as long as there is at least one other
7192 person/entity we can put in the
7193 <tag>section</tag>). Also adjusted assembly of content for
7194 <tag>Author</tag> metainfo field such that we now not only use
7195 <tag>author</tag>, but try to find a "best match" if we can't
7196 find an <tag>author</tag> name to put there.</para>
7197 <para>Closes
7198 #1233592. Thanks to Sam Steingold for the
7199 request.</para>
7200 <para role="commit-changes">Modified: manpages/info.xsl,1.12 - Michael(tm)
7201 Smith</para>
7202 </listitem>
7203 <listitem role="commit-message">
7204 <para>Changes for request #1243027,
7205 "Impove handling of <tag>AUTHOR</tag> <tag>section</tag>." This
7206 adds support for <tag>Collab</tag>, Corpauthor, Corpcredt,
7207 <tag>Orgname</tag>, <tag>Publishername</tag>, and
7208 <tag>Publisher</tag>. Also adds support for output
7209 of <tag>Affiliation</tag> and its children, and support for using
7210 gentext strings for auto-attributing roles (<tag>Author</tag>,
7211 <tag>Editor</tag>, <tag>Publisher</tag>, Translator, etc.). Also
7212 did a lot of code cleanup and modularization of all the
7213 <tag>AUTHOR</tag> handling code. And fixed a bug that was causing
7214 <tag>Author</tag> <tag>info</tag> to not be picked up correctly
7215 for metainfo comment we embed in man-page
7216 source.</para>
7217 <para role="commit-changes">Modified: manpages/info.xsl,1.11 - Michael(tm)
7218 Smith</para>
7219 </listitem>
7220 <listitem role="commit-message">
7221 <para>Support bold output for
7222 "<tag>emphasis</tag> remap='B'". (because Eric Raymond's
7223 doclifter(1) tool converts groff source marked up with ".B"
7224 request or "\fB" escapes to DocBook "<tag>emphasis</tag>
7225 remap='B'".)</para>
7226 <para role="commit-changes">Modified: manpages/inline.xsl,1.14 - Michael(tm)
7227 Smith</para>
7228 </listitem>
7229 <listitem role="commit-message">
7230 <para>Added support for
7231 <tag>Segmentedlist</tag>. Details: Output is tabular, with no
7232 option for "list" type output. Output for <tag>Segtitle</tag>
7233 elements can be supressed by
7234 setting man.<tag>segtitle</tag>.suppress. If <tag>Segtitle</tag>
7235 content is output, it is rendered in italic type (not bold
7236 because not all terminals support bold and so italic ensures the
7237 stand out on those terminals). Extra space (.sp line) at end of
7238 <tag>table</tag> code ensures that it gets handled correctly in
7239 the case where its source is the child of a <tag>Para</tag>.
7240 Closes feature-request #1400097. Thanks to Daniel Leidert for the
7241 patch and push, and to Alastair Rankine for filing the original
7242 feature request.</para>
7243 <para role="commit-changes">Modified: manpages/lists.xsl,1.23;
7244 manpages/utility.xsl,1.10 - Michael(tm) Smith</para>
7245 </listitem>
7246 <listitem role="commit-message">
7247 <para>Improved handling or
7248 Author/Editor/Othercredit.</para>
7249 <para>Reworked content of
7250 (non-visible) comment added at top of each page (metadata
7251 stuff).</para>
7252 <para>Added support for generating a
7253 <parameter>manifest</parameter> file (useful for cleaning up
7254 after builds, etc.)</para>
7255 <para role="commit-changes">Modified: manpages/docbook.xsl,1.46;
7256 manpages/info.xsl,1.9; manpages/other.xsl,1.12;
7257 manpages/utility.xsl,1.6 - Michael(tm) Smith</para>
7258 </listitem>
7259 <listitem role="commit-message">
7260 <para>Added two new parameters for
7261 handling of multi-term
7262 <tag>varlistentry</tag> elements:</para>
7263 <para><parameter>variablelist.term.break.after</parameter>: 
7264 When the <parameter>variablelist.term.break.after</parameter> is
7265 non-zero, it will  generate a line break after each
7266 <tag>term</tag> multi-term
7267 <tag>varlistentry</tag>.</para>
7268 <para><parameter>variablelist.term.separator</parameter>: 
7269 When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
7270 elements, the string  specified in the value of the
7271 <parameter>variablelist.term.separator</parameter>  parameter is
7272 placed after each <tag>term</tag> except the last. The default 
7273 is ", " (a comma followed by a space). To suppress rendering of 
7274 the separator, set the value of
7275 <parameter>variablelist.term.separator</parameter> to  the empty
7276 string ("").</para>
7277 <para>These parameters are primarily intended to be
7278 useful if you have multi-term varlistentries that have long
7279 terms.</para>
7280 <para>Closes #1306676. Thanks to Sam Steingold for
7281 providing an example "lots of long terms" doc that demonstrated
7282 the value of having these options.</para>
7283 <para>Also, added
7284 normalize-space() call to processing of each
7285 <tag>term</tag>.</para>
7286 <para>This change affects all output formats
7287 (HTML, PDF, manpages). The default behavior should pretty much
7288 remain the same as before, but it is possible (as always) that
7289 the change may introduce some
7290 new bugginess.</para>
7291 <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
7292 fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
7293 html/param.xweb,1.93; manpages/lists.xsl,1.22;
7294 manpages/param.ent,1.14; manpages/param.xweb,1.16;
7295 params/variablelist.term.break.after.xml,1.1;
7296 params/variablelist.term.separator.xml,1.1 - Michael(tm)
7297 Smith</para>
7298 </listitem>
7299 </itemizedlist>
7300 </sect2><!--end of Manpages changes for snapshot_2006-05-15_0803-->
7301
7302 <sect2 xml:id="V1700_Params">
7303 <title>Params</title>
7304 <para>The following changes have been made to the
7305         <filename>params</filename> code
7306         since the 1.69.1 release.</para>
7307 <itemizedlist>
7308 <listitem role="commit-message">
7309 <para>New parameters to set
7310 header/footer <tag>table</tag> minimum
7311 height.</para>
7312 <para role="commit-changes">Modified: params/footer.table.height.xml,1.1;
7313 params/header.table.height.xml,1.1 - Robert
7314 Stayton</para>
7315 </listitem>
7316 <listitem role="commit-message">
7317 <para>Support multiple indexing methods
7318 for different languages.</para>
7319 <para role="commit-changes">Modified: params/index.method.xml,1.1 - Robert
7320 Stayton</para>
7321 </listitem>
7322 <listitem role="commit-message">
7323 <para>Remove <tag>qandaset</tag> and
7324 <tag>qandadiv</tag> from <parameter>generate.toc</parameter> for fo
7325 output because formerly it wasn't working, but now it is and
7326 the default behavior should stay the
7327 same.</para>
7328 <para role="commit-changes">Modified: params/generate.toc.xml,1.8 - Robert
7329 Stayton</para>
7330 </listitem>
7331 <listitem role="commit-message">
7332 <para>add support for page number
7333 references to <tag>link</tag> element
7334 too.</para>
7335 <para role="commit-changes">Modified: params/insert.link.page.number.xml,1.1 - Robert
7336 Stayton</para>
7337 </listitem>
7338 <listitem role="commit-message">
7339 <para>Add support for more characters to
7340 hyphen on when <parameter>ulink.hyphenate</parameter> is turned
7341 on.</para>
7342 <para role="commit-changes">Modified: params/ulink.hyphenate.chars.xml,1.1;
7343 params/ulink.hyphenate.xml,1.3 - Robert Stayton</para>
7344 </listitem>
7345 <listitem role="commit-message">
7346 <para>New attribute-set to format
7347 <tag>biblioentry</tag> and
7348 <tag>bibliomixed</tag>.</para>
7349 <para role="commit-changes">Modified: params/biblioentry.properties.xml,1.1 -
7350 Robert Stayton</para>
7351 </listitem>
7352 <listitem role="commit-message">
7353 <para>Added new parameter
7354 <parameter>chunk.tocs.and.lots</parameter>.has.<tag>title</tag> which
7355 controls presence of <tag>title</tag> in a separate chunk with
7356 ToC/LoT. Disabling <tag>title</tag> can be very useful if you are
7357 generating frameset output (well, yes those frames, but some customers
7358 really want them ;-).</para>
7359 <para role="commit-changes">Modified: html/chunk-code.xsl,1.15;
7360 html/param.ent,1.93; html/param.xweb,1.102;
7361 params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
7362 Kosek</para>
7363 </listitem>
7364 <listitem role="commit-message">
7365 <para>Added new attribute set
7366 <tag>toc</tag>.line.properties for controlling appearance of lines in
7367 ToC/LoT</para>
7368 <para role="commit-changes">Modified: params/toc.line.properties.xml,1.1 - Jirka
7369 Kosek</para>
7370 </listitem>
7371 <listitem role="commit-message">
7372 <para>Allow <tag>table</tag> footnotes
7373 to have different properties from regular
7374 footnotes.</para>
7375 <para role="commit-changes">Modified: params/table.footnote.properties.xml,1.1 - Robert
7376 Stayton</para>
7377 </listitem>
7378 <listitem role="commit-message">
7379 <para>Set properties for pgwide="1"
7380 objects.</para>
7381 <para role="commit-changes">Modified: params/pgwide.properties.xml,1.1 - Robert
7382 Stayton</para>
7383 </listitem>
7384 <listitem role="commit-message">
7385 <para>Added the
7386 autotoc.<tag>label</tag>.in.hyperlink param.</para>
7387 <para>If the value
7388 of autotoc.<tag>label</tag>.in.hyperlink is non-zero, labels
7389 are included in hyperlinked titles in the <tag>TOC</tag>. If it
7390 is instead zero, labels are still displayed prior to the
7391 hyperlinked titles, but are not hyperlinked along with the
7392 titles.</para>
7393 <para>Closes patch #1065868. Thanks to anatoly techtonik
7394 for the patch.</para>
7395 <para role="commit-changes">Modified: html/autotoc.xsl,1.36; html/param.ent,1.92;
7396 html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 -
7397 Michael(tm) Smith</para>
7398 </listitem>
7399 <listitem role="commit-message">
7400 <para>Added two new params:
7401 html.head.<tag>legalnotice</tag>.<tag>link</tag>.types
7402 and html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple.</para>
7403 <para>If
7404 the value of the <parameter>generate.legalnotice.link</parameter> is
7405 non-zero, then the stylesheet generates (in the head
7406 <tag>section</tag> of the HTML source) either a single HTML
7407 <tag>link</tag> element or, if the value of
7408 the html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple is
7409 non-zero, one <tag>link</tag> element for each <tag>link</tag>
7410 type specified. Each <tag>link</tag> has the
7411 following attributes:</para>
7412 <para> - a rel attribute whose value
7413 is derived from the value of 
7414 html.head.<tag>legalnotice</tag>.<tag>link</tag>.types</para>
7415 <para> -
7416 an href attribute whose value is set to the URL of the file 
7417 containing the <tag>legalnotice</tag></para>
7418 <para> - a <tag>title</tag>
7419 attribute whose value is set to the <tag>title</tag> of the 
7420 corresponding <tag>legalnotice</tag> (or a <tag>title</tag>
7421 programatically  determined by the stylesheet)</para>
7422 <para>For
7423 example:</para>
7424 <para> &lt;<tag>link</tag> rel="<tag>copyright</tag>"
7425 href="ln-id2524073.html" title="Legal Notice"&gt;</para>
7426 <para>Closes
7427 #1476450. Thanks to Sam Steingold.</para>
7428 <para role="commit-changes">Modified: html/chunk-common.xsl,1.45;
7429 html/param.ent,1.91; html/param.xweb,1.100;
7430 params/generate.legalnotice.link.xml,1.4;
7431 params/html.head.legalnotice.link.multiple.xml,1.1;
7432 params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm)
7433 Smith</para>
7434 </listitem>
7435 <listitem role="commit-message">
7436 <para>Added the following
7437 params:</para>
7438 <para> - man.indent.width (string-valued)  -
7439 man.indent.refsect (boolean)  - man.indent.blurbs (boolean) 
7440 - man.indent.lists (boolean)  - man.indent.verbatims
7441 (boolean)</para>
7442 <para>Note that in earlier snapshots, man.indent.width
7443 was named man.indentation.default.value and the boolean params
7444 had names like man.indentation.*.adjust. Also the
7445 man.indent.blurbs param was called man.indentation.authors.adjust
7446 (or something).</para>
7447 <para>The behavior now is: If the value of a
7448 particular man.indent.* boolean param is non-zero, the
7449 corresponding contents (refsect*, list items,
7450 authorblurb/personblurb, vervatims) are displayed with a left
7451 margin indented by a width equal to the value
7452 of man.indent.width.</para>
7453 <para role="commit-changes">Modified: params/man.indent.blurbs.xml,1.1;
7454 manpages/docbook.xsl,1.74; manpages/info.xsl,1.20;
7455 manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
7456 manpages/param.ent,1.22; manpages/param.xweb,1.24;
7457 manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1;
7458 params/man.indent.refsect.xml,1.1;
7459 params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 -
7460 Michael(tm) Smith</para>
7461 </listitem>
7462 <listitem role="commit-message">
7463 <para>Added
7464 man.<tag>table</tag>.footnotes.divider param.</para>
7465 <para>In each
7466 <tag>table</tag> that contains footenotes, the string specified
7467 by the man.<tag>table</tag>.footnotes.divider parameter is output
7468 before the list of footnotes for the
7469 <tag>table</tag>.</para>
7470 <para role="commit-changes">Modified: manpages/docbook.xsl,1.73;
7471 manpages/links.xsl,1.6; manpages/param.ent,1.21;
7472 manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 -
7473 Michael(tm) Smith</para>
7474 </listitem>
7475 <listitem role="commit-message">
7476 <para>Added the
7477 man.output.in.separate.dir,
7478 man.output.<parameter>base.dir</parameter>,
7479 and man.output.subdirs.enabled parameters.</para>
7480 <para>The
7481 man.output.<parameter>base.dir</parameter> parameter specifies the
7482 base directory into which man-page files are
7483 output. The man.output.subdirs.enabled parameter controls whether
7484 the files are output in subdirectories within the base
7485 directory.</para>
7486 <para>The values of the
7487 man.output.<parameter>base.dir</parameter>
7488 and man.output.subdirs.enabled parameters are used only if the
7489 value of man.output.in.separate.dir parameter is non-zero. If the
7490 value of man.output.in.separate.dir is zero, man-page files are
7491 not output in a separate
7492 directory.</para>
7493 <para role="commit-changes">Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20;
7494 manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1;
7495 params/man.output.in.separate.dir.xml,1.1;
7496 params/man.output.subdirs.enabled.xml,1.1 - Michael(tm)
7497 Smith</para>
7498 </listitem>
7499 <listitem role="commit-message">
7500 <para>Added
7501 man.font.<tag>table</tag>.headings and
7502 man.font.<tag>table</tag>.<tag>title</tag> params, for
7503 controlling font in <tag>table</tag> headings and
7504 titles.</para>
7505 <para role="commit-changes">Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19;
7506 manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1;
7507 params/man.font.table.title.xml,1.1 - Michael(tm)
7508 Smith</para>
7509 </listitem>
7510 <listitem role="commit-message">
7511 <para>Added
7512 man.font.<tag>funcsynopsisinfo</tag> and
7513 man.font.<tag>funcprototype</tag> params, for specifying the roff
7514 font (for example, BI, B, I) for <tag>funcsynopsisinfo</tag> and
7515 <tag>funcprototype</tag> output.</para>
7516 <para role="commit-changes">Modified: manpages/block.xsl,1.19;
7517 manpages/docbook.xsl,1.69; manpages/param.ent,1.18;
7518 manpages/param.xweb,1.20; manpages/synop.xsl,1.29;
7519 manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1;
7520 params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm)
7521 Smith</para>
7522 </listitem>
7523 <listitem role="commit-message">
7524 <para>Changed to select="0" in
7525 <tag>refclass</tag>.suppress (instead of
7526 ..&gt;0&lt;/..)</para>
7527 <para role="commit-changes">Modified: params/refclass.suppress.xml,1.3 - Michael(tm)
7528 Smith</para>
7529 </listitem>
7530 <listitem role="commit-message">
7531 <para>Added
7532 man.<tag>segtitle</tag>.suppress param.</para>
7533 <para>If the value of
7534 man.<tag>segtitle</tag>.suppress is non-zero, then display
7535 of <tag>segtitle</tag> contents is suppressed in
7536 output.</para>
7537 <para role="commit-changes">Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17;
7538 manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 -
7539 Michael(tm) Smith</para>
7540 </listitem>
7541 <listitem role="commit-message">
7542 <para>Added
7543 man.output.<parameter>manifest</parameter>.enabled and
7544 man.output.manifest.<tag>filename</tag> params.</para>
7545 <para>If
7546 man.output.<parameter>manifest</parameter>.enabled is non-zero, a list
7547 of filenames for man pages generated by the stylesheet
7548 transformation is written to the file named by
7549 man.output.<parameter>manifest</parameter>.<tag>filename</tag></para>
7550 <para role="commit-changes">Modified: manpages/docbook.xsl,1.67;
7551 manpages/other.xsl,1.19; manpages/param.ent,1.16;
7552 manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1;
7553 params/man.output.manifest.filename.xml,1.1;
7554 tools/make/Makefile.DocBook,1.4 - Michael(tm)
7555 Smith</para>
7556 </listitem>
7557 <listitem role="commit-message">
7558 <para>Added <tag>refclass</tag>.suppress
7559 param.</para>
7560 <para>If the value of <tag>refclass</tag>.suppress is
7561 non-zero, then display <tag>refclass</tag> contents is suppressed
7562 in output. Affects HTML and FO output
7563 only.</para>
7564 <para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
7565 html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
7566 Smith</para>
7567 </listitem>
7568 <listitem role="commit-message">
7569 <para>Added
7570 <tag>refentry</tag>.meta.get.quietly param.</para>
7571 <para>If zero (the
7572 default), notes and warnings about "missing" markup are generated
7573 during gathering of <tag>refentry</tag> metadata. If
7574 non-zero, the metadata is gathered "quietly" -- that is, the
7575 notes and warnings are suppressed.</para>
7576 <para>NOTE: If you are
7577 processing a large amount of <tag>refentry</tag> content,  you
7578 may be able to speed up processing significantly by  setting a
7579 non-zero value for
7580 <tag>refentry</tag>.meta.get.quietly.</para>
7581 <para role="commit-changes">Modified: common/refentry.xsl,1.17;
7582 manpages/param.ent,1.15; manpages/param.xweb,1.17;
7583 params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
7584 Smith</para>
7585 </listitem>
7586 <listitem role="commit-message">
7587 <para>Added support for "software" and
7588 "sectdesc" class values on <tag>refmiscinfo</tag>; "software" is
7589 treated identically to "source", and "setdesc" is treated
7590 identically to "manual".</para>
7591 <para role="commit-changes">Modified: common/refentry.xsl,1.10;
7592 params/man.th.extra2.max.length.xml,1.3;
7593 params/refentry.source.name.profile.xml,1.4 - Michael(tm)
7594 Smith</para>
7595 </listitem>
7596 <listitem role="commit-message">
7597 <para>Drastically reworked all of the
7598 XPath expressions used in <tag>refentry</tag> metadata gathering
7599 -- completely removed $parentinfo and turned $info into a set of
7600 nodes that includes the *info contents of the <tag>Refentry</tag>
7601 plus the *info contents all all of its ancestor elements. The
7602 basic XPath expression now used throughout is (using the example
7603 of checking for a <tag>date</tag>):</para>
7604 <para>
7605 (($info[//date])[last()]/date)[1].</para>
7606 <para>That selects the "last"
7607 *info/date <tag>date</tag> in document order -- that is, the one
7608 eitther on the <tag>Refentry</tag> itself or on the
7609 closest ancestor to the <tag>Refentry</tag>.</para>
7610 <para>It's
7611 likely this change may break some things; may need to pick up
7612 some pieces later.</para>
7613 <para>Also, changed the default value for the
7614 <parameter>man.th.extra2.max.length</parameter> from 40 to
7615 30.</para>
7616 <para role="commit-changes">Modified: common/common.xsl,1.58; common/refentry.xsl,1.7;
7617 params/man.th.extra2.max.length.xml,1.2;
7618 params/refentry.date.profile.xml,1.2;
7619 params/refentry.manual.profile.xml,1.2;
7620 params/refentry.source.name.profile.xml,1.2;
7621 params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58;
7622 manpages/other.xsl,1.15 - Michael(tm) Smith</para>
7623 </listitem>
7624 <listitem role="commit-message">
7625 <para>Added option for turning off bold
7626 formatting in <tag>Funcsynopsis</tag>. Boldface formatting in
7627 <tag>function</tag> <tag>synopsis</tag> is mandated in the
7628 man(7) man page and is used almost universally in existing man
7629 pages. Despite that, it really does look like crap to have an
7630 entire <tag>Funcsynopsis</tag> output in bold, so I added params
7631 for turning off the bold formatting and/or replacing it with a
7632 different roff special font (e.g., "RI" for alternating
7633 roman/italic instead of the default "BI" for alternating
7634 bold/italic). The new params
7635 are "man.<tag>funcprototype</tag>.font" and
7636 "man.<tag>funcsynopsisinfo</tag>.font". To be documented
7637 later.</para>
7638 <para>Closes #1452247. Thanks to Joe Orton for the feature
7639 request.</para>
7640 <para role="commit-changes">Modified: params/man.string.subst.map.xml,1.16;
7641 manpages/block.xsl,1.10; manpages/docbook.xsl,1.51;
7642 manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm)
7643 Smith</para>
7644 </listitem>
7645 <listitem role="commit-message">
7646 <para><parameter>fop.extensions</parameter> now only
7647 for FOP version 0.20.5 and earlier.</para>
7648 <para role="commit-changes">Modified: params/fop.extensions.xml,1.4
7649 - Robert Stayton</para>
7650 </listitem>
7651 <listitem role="commit-message">
7652 <para>Support for fop1 different from
7653 fop 0.20.5 and earlier.</para>
7654 <para role="commit-changes">Modified: params/fop1.extensions.xml,1.1 - Robert
7655 Stayton</para>
7656 </listitem>
7657 <listitem role="commit-message">
7658 <para>Reset default value to empty
7659 string so template uses gentext first, then the parameter value
7660 if not empty.</para>
7661 <para role="commit-changes">Modified: params/index.number.separator.xml,1.2;
7662 params/index.range.separator.xml,1.2;
7663 params/index.term.separator.xml,1.2 - Robert
7664 Stayton</para>
7665 </listitem>
7666 <listitem role="commit-message">
7667 <para>New parameter:
7668 <parameter>id.warnings</parameter>. If non-zero, warnings are
7669 generated for titled objects that don't have titles. True by default;
7670 I wonder if this will be too aggressive?</para>
7671 <para role="commit-changes">Modified: html/biblio.xsl,1.25;
7672 html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19;
7673 html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16;
7674 html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22;
7675 html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman
7676 Walsh</para>
7677 </listitem>
7678 <listitem role="commit-message">
7679 <para>Added new parameter
7680 <parameter>keep.relative.image.uris</parameter></para>
7681 <para role="commit-changes">Modified: fo/param.ent,1.91;
7682 fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
7683 params/keep.relative.image.uris.xml,1.1 - Norman
7684 Walsh</para>
7685 </listitem>
7686 <listitem role="commit-message">
7687 <para>Support default <tag>label</tag>
7688 width parameters for itemized and ordered lists</para>
7689 <para role="commit-changes">Modified: fo/lists.xsl,1.64;
7690 fo/param.ent,1.90; fo/param.xweb,1.103;
7691 params/itemizedlist.label.width.xml,1.1;
7692 params/orderedlist.label.width.xml,1.1 - Norman
7693 Walsh</para>
7694 </listitem>
7695 <listitem role="commit-message">
7696 <para>Added parameters to localize
7697 punctuation in indexes.</para>
7698 <para role="commit-changes">Modified: params/index.number.separator.xml,1.1;
7699 params/index.range.separator.xml,1.1;
7700 params/index.term.separator.xml,1.1 - Robert
7701 Stayton</para>
7702 </listitem>
7703 <listitem role="commit-message">
7704 <para>Added two new parameters for
7705 handling of multi-term
7706 <tag>varlistentry</tag> elements:</para>
7707 <para><parameter>variablelist.term.break.after</parameter>: 
7708 When the <parameter>variablelist.term.break.after</parameter> is
7709 non-zero, it will  generate a line break after each
7710 <tag>term</tag> multi-term
7711 <tag>varlistentry</tag>.</para>
7712 <para><parameter>variablelist.term.separator</parameter>: 
7713 When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
7714 elements, the string  specified in the value of the
7715 <parameter>variablelist.term.separator</parameter>  parameter is
7716 placed after each <tag>term</tag> except the last. The default 
7717 is ", " (a comma followed by a space). To suppress rendering of 
7718 the separator, set the value of
7719 <parameter>variablelist.term.separator</parameter> to  the empty
7720 string ("").</para>
7721 <para>These parameters are primarily intended to be
7722 useful if you have multi-term varlistentries that have long
7723 terms.</para>
7724 <para>Closes #1306676. Thanks to Sam Steingold for
7725 providing an example "lots of long terms" doc that demonstrated
7726 the value of having these options.</para>
7727 <para>Also, added
7728 normalize-space() call to processing of each
7729 <tag>term</tag>.</para>
7730 <para>This change affects all output formats
7731 (HTML, PDF, manpages). The default behavior should pretty much
7732 remain the same as before, but it is possible (as always) that
7733 the change may introduce some
7734 new bugginess.</para>
7735 <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
7736 fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
7737 html/param.xweb,1.93; manpages/lists.xsl,1.22;
7738 manpages/param.ent,1.14; manpages/param.xweb,1.16;
7739 params/variablelist.term.break.after.xml,1.1;
7740 params/variablelist.term.separator.xml,1.1 - Michael(tm)
7741 Smith</para>
7742 </listitem>
7743 <listitem role="commit-message">
7744 <para>Convert 'no' to string in default
7745 value.</para>
7746 <para role="commit-changes">Modified: params/olink.doctitle.xml,1.4 - Robert
7747 Stayton</para>
7748 </listitem>
7749 <listitem role="commit-message">
7750 <para>Implemented RFE
7751 #1292615.</para>
7752 <para>Added bunch of new parameters (attribute sets)
7753 that affect list presentation: list.block.properties,
7754 <tag>itemizedlist</tag>.properties, <tag>orderedlist</tag>.properties,
7755 <tag>itemizedlist</tag>.<tag>label</tag>.properties and
7756 <tag>orderedlist</tag>.<tag>label</tag>.properties. Default behaviour
7757 of stylesheets has not been changed but further customizations will be
7758 much more easier.</para>
7759 <para role="commit-changes">Modified: fo/lists.xsl,1.61; fo/param.ent,1.87;
7760 fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1;
7761 params/itemizedlist.properties.xml,1.1;
7762 params/list.block.properties.xml,1.1;
7763 params/orderedlist.label.properties.xml,1.1;
7764 params/orderedlist.properties.xml,1.1 - Jirka
7765 Kosek</para>
7766 </listitem>
7767 <listitem role="commit-message">
7768 <para>Implemented RFE
7769 #1242092.</para>
7770 <para>You can enable crop marks in your document by
7771 setting crop.marks=1 and xep.extensions=1. Appearance of crop
7772 marks can be controlled by parameters
7773 <parameter>crop.mark.bleed</parameter> (6pt),
7774 <parameter>crop.mark.offset</parameter> (24pt) and
7775 <parameter>crop.mark.width</parameter> (0.5pt).</para>
7776 <para>Also there
7777 is new named template called user-xep-pis. You can overwrite it in
7778 order to produce some PIs that can control XEP as described in
7779 http://www.renderx.com/reference.html#Output_Formats</para>
7780 <para role="commit-changes">Modified: fo/docbook.xsl,1.36;
7781 fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23;
7782 params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1;
7783 params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka
7784 Kosek</para>
7785 </listitem>
7786 <listitem role="commit-message">
7787 <para>Changed short descriptions in doc
7788 for *autolabel* params to match new autolabel
7789 behavior.</para>
7790 <para role="commit-changes">Modified: params/appendix.autolabel.xml,1.5;
7791 params/chapter.autolabel.xml,1.4; params/part.autolabel.xml,1.5;
7792 params/preface.autolabel.xml,1.4 - Michael(tm)
7793 Smith</para>
7794 </listitem>
7795 </itemizedlist>
7796 </sect2><!--end of Params changes for snapshot_2006-05-15_0803-->
7797
7798 <sect2 xml:id="V1700_Profiling">
7799 <title>Profiling</title>
7800 <para>The following changes have been made to the
7801         <filename>profiling</filename> code
7802         since the 1.69.1 release.</para>
7803 <itemizedlist>
7804 <listitem role="commit-message">
7805 <para>Profiling now works together with
7806 namespace stripping (V5 documents). Namespace striping should work
7807 with all stylesheets named profile-, even if they are not supporting
7808 namespace stripping in a non-profiling
7809 variant.</para>
7810 <para role="commit-changes">Modified: profiling/profile-mode.xsl,1.4;
7811 profiling/xsl2profile.xsl,1.7 - Jirka Kosek</para>
7812 </listitem>
7813 <listitem role="commit-message">
7814 <para>Moved profiling stage out of
7815 templates. This make possible to reuse profiled content by several
7816 templates and still maintaing node indentity (needed for example for
7817 HTML Help where content is processed multiple times).</para>
7818 <para>I
7819 don't know why this was not on the top level before. Maybe some XSLT
7820 processors choked on it. I hope this will be OK
7821 now.</para>
7822 <para role="commit-changes">Modified: profiling/xsl2profile.xsl,1.5 - Jirka
7823 Kosek</para>
7824 </listitem>
7825 </itemizedlist>
7826 </sect2><!--end of Profiling changes for snapshot_2006-05-15_0803-->
7827
7828 <sect2 xml:id="V1700_Tools">
7829 <title>Tools</title>
7830 <para>The following changes have been made to the
7831         <filename>tools</filename> code
7832         since the 1.69.1 release.</para>
7833 <itemizedlist>
7834 <listitem role="commit-message">
7835 <para>Moved Makefile.DocBook from
7836 <tag>contrib</tag> module to xsl
7837 module.</para>
7838 <para role="commit-changes">Modified: tools/make/Makefile.DocBook,1.1 - Michael(tm)
7839 Smith</para>
7840 </listitem>
7841 </itemizedlist>
7842 </sect2><!--end of Tools changes for snapshot_2006-05-15_0803-->
7843
7844 <sect2 xml:id="V1700_WordML">
7845 <title>WordML</title>
7846 <para>The following changes have been made to the
7847         <filename>wordml</filename> code
7848         since the 1.69.1 release.</para>
7849 <itemizedlist>
7850 <listitem role="commit-message">
7851 <para>added <tag>contrib</tag> element,
7852 better handling of default paragraph
7853 style</para>
7854 <para role="commit-changes">Modified: wordml/pages-normalise.xsl,1.6; wordml/supported.xml,1.2;
7855 wordml/wordml-final.xsl,1.14 - Steve Ball</para>
7856 </listitem>
7857 <listitem role="commit-message">
7858 <para>added
7859 <tag>bridgehead</tag></para>
7860 <para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.6;
7861 wordml/docbook.xsl,1.17; wordml/pages-normalise.xsl,1.5;
7862 wordml/template-pages.xml,1.7; wordml/template.dot,1.4;
7863 wordml/template.xml,1.14; wordml/wordml-final.xsl,1.13 - Steve
7864 Ball</para>
7865 </listitem>
7866 <listitem role="commit-message">
7867 <para>added blocks stylesheet to support
7868 bibliographies, glossaries and qandasets</para>
7869 <para role="commit-changes">Modified: wordml/Makefile,1.4;
7870 wordml/README,1.3; wordml/blocks-spec.xml,1.1;
7871 wordml/docbook-pages.xsl,1.5; wordml/docbook.xsl,1.16;
7872 wordml/pages-normalise.xsl,1.4; wordml/sections-spec.xml,1.3;
7873 wordml/specifications.xml,1.13; wordml/template-pages.xml,1.6;
7874 wordml/template.dot,1.3; wordml/template.xml,1.13;
7875 wordml/wordml-blocks.xsl,1.1; wordml/wordml-final.xsl,1.12;
7876 wordml/wordml-sections.xsl,1.3 - Steve Ball</para>
7877 </listitem>
7878 <listitem role="commit-message">
7879 <para>added <tag>mediaobject</tag>
7880 <tag>caption</tag></para>
7881 <para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.4;
7882 wordml/docbook.xsl,1.15; wordml/specifications.xml,1.12;
7883 wordml/template-pages.xml,1.5; wordml/template.dot,1.2;
7884 wordml/template.xml,1.12; wordml/wordml-final.xsl,1.11 - Steve
7885 Ball</para>
7886 </listitem>
7887 <listitem role="commit-message">
7888 <para>added
7889 callouts</para>
7890 <para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.3; wordml/docbook.xsl,1.14;
7891 wordml/pages-normalise.xsl,1.3; wordml/specifications.xml,1.11;
7892 wordml/template-pages.xml,1.4; wordml/wordml-final.xsl,1.10 - Steve
7893 Ball</para>
7894 </listitem>
7895 <listitem role="commit-message">
7896 <para>added Word template
7897 file</para>
7898 <para role="commit-changes">Modified: wordml/template.dot,1.1 - Steve Ball</para>
7899 </listitem>
7900 <listitem role="commit-message">
7901 <para>added <tag>abstract</tag>, fixed
7902 <tag>itemizedlist</tag>, ulink</para>
7903 <para role="commit-changes">Modified: wordml/specifications.xml,1.10;
7904 wordml/wordml-final.xsl,1.9 - Steve Ball</para>
7905 </listitem>
7906 <listitem role="commit-message">
7907 <para>fixed Makefile added many
7908 features to Pages support added <tag>revhistory</tag>, inlines,
7909 highlights, <tag>abstract</tag></para>
7910 <para role="commit-changes">Modified: wordml/Makefile,1.2;
7911 wordml/docbook-pages.xsl,1.2; wordml/pages-normalise.xsl,1.2;
7912 wordml/sections-spec.xml,1.2; wordml/specifications.xml,1.9;
7913 wordml/template-pages.xml,1.3; wordml/template.xml,1.11;
7914 wordml/wordml-final.xsl,1.8; wordml/wordml-sections.xsl,1.2 - Steve
7915 Ball</para>
7916 </listitem>
7917 <listitem role="commit-message">
7918 <para>fixed handling linebreaks when
7919 generating WordML added Apple Pages
7920 support</para>
7921 <para role="commit-changes">Modified: wordml/docbook.xsl,1.13; wordml/template-pages.xml,1.2 -
7922 Steve Ball</para>
7923 </listitem>
7924 </itemizedlist>
7925 </sect2><!--end of WordML changes for snapshot_2006-05-15_0803-->
7926 </sect1>
7927
7928   <sect1 xml:id="V1691">
7929     <title>Release 1.69.1</title>
7930     <para>This release is a minor bug-fix update to the 1.69.0
7931     release. Along with bug fixes, it includes one
7932     configuration-parameter change: The default value of the
7933     <parameter>annotation.support</parameter> parameter is now
7934     <literal>0</literal> (off). The reason for that change is that
7935     there have been reports that <tag>annotation</tag> handling is
7936     causing a significant performance degradation in processing of
7937     large documents with <command>xsltproc</command>.</para>
7938   </sect1>
7939   <!-- end of notes for 1.69.1 release -->
7940
7941   <sect1 xml:id="V1690">
7942     <title>Release 1.69.0</title>
7943     <para>The release includes major feature changes,
7944     particularly in the <link linkend="V1690_MAN">manpages
7945     stylesheets</link>, as well as a large number of bug fixes.</para>
7946
7947     <para>As with all DocBook Project <quote>dot zero</quote> releases, this is an
7948     <link linkend="dot0">experimental release </link>.</para>
7949    
7950     <sect2 xml:id="V1690_COMMON">
7951       <title>Common</title>
7952       <itemizedlist>
7953         <listitem>
7954           <para>This release adds localizations for the following
7955           languages:
7956             <simplelist type="inline">
7957               <?dbchoice choice="and"?>
7958               <member>Albanian</member>
7959               <member>Amharic</member>
7960               <member>Azerbaijani</member>
7961               <member>Hindi</member>
7962               <member>Irish (Gaelic)</member>
7963               <member>Gujarati</member>
7964               <member>Kannada</member>
7965               <member>Mongolian</member>
7966               <member>Oriya</member>
7967               <member>Punjabi</member>
7968               <member>Tagalog</member>
7969               <member>Tamil</member>
7970               <member>Welsh</member>
7971           </simplelist>.</para>
7972         </listitem>
7973         <listitem>
7974           <para>Added support for specifying number format for auto
7975           labels for <tag>chapter</tag>, <tag>appendix</tag>,
7976           <tag>part</tag>, and <tag>preface</tag>. Contolled with the
7977           <parameter>appendix.autolabel</parameter>,
7978           <parameter>chapter.autolabel</parameter>,
7979           <parameter>part.autolabel</parameter>, and
7980           <parameter>preface.autolabel</parameter> parameters.</para>
7981         </listitem>
7982         <listitem>
7983           <para>Added basic support for <tag>biblioref</tag> cross
7984           referencing.</para>
7985         </listitem>
7986         <listitem>
7987           <para>Added support for <tag class="attribute">align</tag>
7988           on <tag>caption</tag> in <tag>mediaobject</tag>.</para>
7989         </listitem>
7990         <listitem>
7991           <para>Added support for processing documents that use the
7992           DocBook V5 namespace.</para>
7993         </listitem>
7994         <listitem>
7995           <para>Added support for <tag>termdef</tag> and
7996           <tag>mathphrase</tag>.</para>
7997         </listitem>
7998         <listitem>
7999           <para>EXPERIMENTAL: Incorporated the Slides and Website
8000           stylesheets into the DocBook XSL stylesheets package. So,
8001           for example, Website documents can now be processed using
8002           the following URI for the driver Website
8003           <filename>tabular.xsl</filename> file: <literallayout class="monospaced"><uri>http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl</uri></literallayout></para>
8004         </listitem>
8005         <listitem>
8006           <para>A <tag>procedure</tag> without a <tag>title</tag> is
8007           now treated as an <quote>informal</quote> procedure (meaning
8008           that it is not added to any generated <quote>list of
8009           procedures</quote> and has no affect on numbering of
8010           generated labels for other procedures).</para>
8011         </listitem>
8012         <listitem>
8013           <para><tag>docname</tag> is no longer added to
8014           <tag>olink</tag> when pointing to a root element.</para>
8015         </listitem>
8016       <!-- ======================================================= -->
8017       <listitem>
8018         <para>Added support for generation of choice separator in
8019         inline simplelist. This enables auto-generation of an
8020         appropriate localized <quote>choice separator</quote> (for
8021         example, <quote>and</quote> or <quote>or</quote>) before the
8022         final item in an inline <tag>simplelist</tag>.</para>
8023         <para>To indicate that you want a choice separator
8024         generated for a particular list, you need to put a processing
8025         instruction (PI) of the form
8026         <tag class="xmlpi">dbchoice choice="foo"</tag> as a
8027         child of the list. For example:
8028         <literallayout class="monospaced">  &lt;para&gt;Choose from
8029   ONE and ONLY ONE of the following: 
8030   &lt;simplelist type="inline"&gt;
8031   &lt;?dbchoice choice="or" ?&gt;
8032   &lt;member&gt;A&lt;/member&gt;
8033   &lt;member&gt;B&lt;/member&gt;
8034   &lt;member&gt;C&lt;/member&gt;.&lt;/simplelist&gt;&lt;/para&gt;</literallayout>
8035
8036         Output (for English):
8037         <blockquote>
8038           <para>Choose from ONE and only ONE of the
8039           following choices: A, B, or C.</para>
8040         </blockquote>
8041         As a temporary workaround for the fact that most of the
8042         DocBook non-English locale files don't have a localization for
8043         the word <quote>or</quote>, you can put in a literal string to
8044         be used; example for French: <tag class="pi">dbchoice choice="ou"</tag>.  That is, use
8045         <quote>ou</quote> instead of <quote>or</quote>.</para>
8046       </listitem>
8047       </itemizedlist>
8048     </sect2>
8049     <sect2 xml:id="V1690_FO">
8050       <title>FO</title>
8051       <itemizedlist>
8052         <listitem>
8053           <para> Added <literal>content-type</literal> property to
8054           <literal>external-graphic</literal> element, based on
8055           <tag>imagedata</tag> <tag class="attribute">format</tag>
8056           attribute.</para>
8057         </listitem>
8058         <listitem>
8059           <para>Added support for generating
8060           <literal>&lt;rx:meta-field creator="$VERSION"/&gt;</literal>
8061           field for XEP output. This makes the DocBook XSL
8062           stylesheet version information available through the
8063           <guimenu>Document Properties</guimenu> menu in Acrobat
8064           Reader and other PDF viewers.</para>
8065         </listitem>
8066         <listitem>
8067           <para>Trademark symbol handling made consistent with
8068           handling of same in HTML stylesheets. Prior to this change,
8069           if you processed a document that contained no value for the
8070           <tag class="attribute">class</tag> attribute on the
8071           <tag>trademark</tag> element, the HTML stylesheets would
8072           default to rendering a superscript <literal>TM
8073           </literal>symbol after the <tag>trademark</tag> contents,
8074           but the FO stylesheets would render nothing.</para>
8075         </listitem>
8076         <listitem>
8077           <para>Added support for generating XEP bookmarks for
8078           <tag>refentry</tag>.</para>
8079         </listitem>
8080         <listitem>
8081           <para>Added support for HTML markup <tag>table</tag> <tag class="attribute">border</tag> attribute, applied to each
8082           table cell.</para>
8083         </listitem>
8084         <listitem>
8085           <para>The <function>table.width</function> template can now
8086           sum column specs if none use <literal>%</literal> or
8087           <literal>*</literal>.</para>
8088         </listitem>
8089         <listitem>
8090           <para>Added <literal>fox:destination</literal> extension
8091           inside <literal>fox:outline</literal> to support linking to
8092           internal destinations.</para>
8093         </listitem>
8094         <listitem>
8095           <para>Added support for customizing
8096           <literal>abstract</literal> with property sets. Controlled
8097           with the <parameter>abstract.properties</parameter> and
8098           <parameter>abstract.title.properties</parameter>
8099           parameters.</para>
8100         </listitem>
8101         <listitem>
8102           <para>Add <tag>footnote</tag>s in <tag>table</tag> title to
8103           table footnote set, and add support for table footnotes to
8104           HTML table markup.</para>
8105         </listitem>
8106         <listitem>
8107           <para>Added support for <tag>title</tag> in
8108           <tag>glosslist</tag>.</para>
8109         </listitem>
8110         <listitem>
8111           <para>Added support for <tag>itemizedlist</tag> symbol
8112           <literal>none</literal>.</para>
8113         </listitem>
8114         <listitem>
8115           <para>Implemented the new
8116           <parameter>graphical.admonition.properties</parameter> and
8117           <parameter>nongraphical.admonition.properties</parameter>
8118           attribute sets.</para>
8119         </listitem>
8120         <listitem>
8121           <para>Added <tag class="attribute">id</tag> to
8122           <tag>formalpara</tag> and some other blocks that were
8123           missing it.</para>
8124         </listitem>
8125         <listitem>
8126           <para>Changed the anchor template to output
8127           <literal>fo:inline</literal> instead of
8128           <literal>fo:wrapper</literal>.</para>
8129         </listitem>
8130         <listitem>
8131           <para>Added support for <parameter>toc.max.depth</parameter>
8132           parameter.</para>
8133         </listitem>
8134       </itemizedlist>
8135     </sect2>
8136     
8137     <sect2 xml:id="V1690_HELP">
8138       <title>Help</title>
8139       <itemizedlist>
8140         <listitem>
8141           <para>Eclipse Help: Added support for generating olink
8142           database.</para>
8143         </listitem>
8144       </itemizedlist>
8145     </sect2>
8146
8147     <sect2 xml:id="V1690_HTML">
8148       <title>HTML</title>
8149       <itemizedlist>
8150         <listitem>
8151           <para>Added a first cut at support in HTML output for
8152           DocBook 5 style <tag>annotation</tag>s. Controlled using the
8153           <parameter>annotation.support</parameter> parameter, and
8154           implemented using JavaScript and CSS styling. For more
8155           details, see the documentation for the
8156           <parameter>annotation.js</parameter>,
8157           <parameter>annotation.css</parameter>,
8158           <parameter>annotation.graphic.open</parameter>, and
8159           <parameter>annotation.graphic.close</parameter>
8160           parameters.</para>
8161         </listitem>
8162         <listitem>
8163           <para>Generate client-side image map for
8164           <tag>imageobjectco</tag> with areas using
8165           <literal>calspair</literal> units</para>
8166         </listitem>
8167         <listitem>
8168           <para>Added support for <tag class="xmlpi">img.src.path</tag> PI.</para>
8169         </listitem>
8170         <listitem>
8171           <para>Added support for passing
8172           <parameter>img.src.path</parameter> to DocBook Java XSLT
8173           image extensions when appropriate. Controlled using the
8174           <parameter>graphicsize.use.img.src.path</parameter>
8175           parameter.</para>
8176         </listitem>
8177         <listitem>
8178           <para>Added support for (not
8179           valid for DocBook 4) <tag class="attribute">xlink:href</tag>
8180           on <tag>area</tag> and (not valid for DocBook 4)
8181           <tag>alt</tag> in <tag>area</tag>.</para>
8182         </listitem>
8183         <listitem>
8184           <para>Added new parameter
8185           <parameter>default.table.frame</parameter> to control table
8186           framing if there is no <tag class="attribute">frame</tag>
8187           attribute on a table.</para>
8188         </listitem>
8189         <listitem>
8190           <para>Added initial, experimental support for generating
8191           content for the HTML <literal>title</literal> attribute from
8192           content of the <tag>alt</tag> element. This change adds
8193           support for the following inline elements only (none of them
8194           are block elements):
8195           <simplelist type="inline">
8196             <?dbchoice choice="and"?>
8197             <member><tag>abbrev</tag></member>
8198             <member><tag>accel</tag></member>
8199             <member><tag>acronym</tag></member>
8200             <member><tag>action</tag></member>
8201             <member><tag>application</tag></member>
8202             <member><tag>authorinitials</tag></member>
8203             <member><tag>beginpage</tag></member>
8204             <member><tag>citation</tag></member>
8205             <member><tag>citerefentry</tag></member>
8206             <member><tag>citetitle</tag></member>
8207             <member><tag>city</tag></member>
8208             <member><tag>classname</tag></member>
8209             <member><tag>code</tag></member>
8210             <member><tag>command</tag></member>
8211             <member><tag>computeroutput</tag></member>
8212             <member><tag>constant</tag></member>
8213             <member><tag>country</tag></member>
8214             <member><tag>database</tag></member>
8215             <member><tag>email</tag></member>
8216             <member><tag>envar</tag></member>
8217             <member><tag>errorcode</tag></member>
8218             <member><tag>errorname</tag></member>
8219             <member><tag>errortext</tag></member>
8220             <member><tag>errortype</tag></member>
8221             <member><tag>exceptionname</tag></member>
8222             <member><tag>fax</tag></member>
8223             <member><tag>filename</tag></member>
8224             <member><tag>firstname</tag></member>
8225             <member><tag>firstterm</tag></member>
8226             <member><tag>foreignphrase</tag></member>
8227             <member><tag>function</tag></member>
8228             <member><tag>glossterm</tag></member>
8229             <member><tag>guibutton</tag></member>
8230             <member><tag>guiicon</tag></member>
8231             <member><tag>guilabel</tag></member>
8232             <member><tag>guimenu</tag></member>
8233             <member><tag>guimenuitem</tag></member>
8234             <member><tag>guisubmenu</tag></member>
8235             <member><tag>hardware</tag></member>
8236             <member><tag>honorific</tag></member>
8237             <member><tag>interface</tag></member>
8238             <member><tag>interfacename</tag></member>
8239             <member><tag>keycap</tag></member>
8240             <member><tag>keycode</tag></member>
8241             <member><tag>keysym</tag></member>
8242             <member><tag>lineage</tag></member>
8243             <member><tag>lineannotation</tag></member>
8244             <member><tag>literal</tag></member>
8245             <member><tag>markup</tag></member>
8246             <member><tag>medialabel</tag></member>
8247             <member><tag>methodname</tag></member>
8248             <member><tag>mousebutton</tag></member>
8249             <member><tag>option</tag></member>
8250             <member><tag>optional</tag></member>
8251             <member><tag>otheraddr</tag></member>
8252             <member><tag>othername</tag></member>
8253             <member><tag>package</tag></member>
8254             <member><tag>parameter</tag></member>
8255             <member><tag>personname</tag></member>
8256             <member><tag>phone</tag></member>
8257             <member><tag>pob</tag></member>
8258             <member><tag>postcode</tag></member>
8259             <member><tag>productname</tag></member>
8260             <member><tag>productnumber</tag></member>
8261             <member><tag>prompt</tag></member>
8262             <member><tag>property</tag></member>
8263             <member><tag>quote</tag></member>
8264             <member><tag>refentrytitle</tag></member>
8265             <member><tag>remark</tag></member>
8266             <member><tag>replaceable</tag></member>
8267             <member><tag>returnvalue</tag></member>
8268             <member><tag>tag</tag></member>
8269             <member><tag>shortcut</tag></member>
8270             <member><tag>state</tag></member>
8271             <member><tag>street</tag></member>
8272             <member><tag>structfield</tag></member>
8273             <member><tag>structname</tag></member>
8274             <member><tag>subscript</tag></member>
8275             <member><tag>superscript</tag></member>
8276             <member><tag>surname</tag></member>
8277             <member><tag>symbol</tag></member>
8278             <member><tag>systemitem</tag></member>
8279             <member><tag>tag</tag></member>
8280             <member><tag>termdef</tag></member>
8281             <member><tag>token</tag></member>
8282             <member><tag>trademark</tag></member>
8283             <member><tag>type</tag></member>
8284             <member><tag>uri</tag></member>
8285             <member><tag>userinput</tag></member>
8286             <member><tag>varname</tag></member>
8287             <member><tag>wordasword</tag></member>
8288           </simplelist>
8289         </para>
8290         </listitem>
8291         <listitem>
8292           <para>Added support for chunking <tag>revhistory</tag> into
8293           separate file (similar to the support for doing same with
8294           <tag>legalnotice</tag>). Patch from Thomas
8295           Schraitle. Controlled through <parameter>new
8296           generate.revhistory.link</parameter> parameter.</para>
8297         </listitem>
8298         <listitem>
8299           <para>l10n.xsl: Made language codes RFC compliant. Added a
8300           new boolean config parameter,
8301           <parameter>l10n.lang.value.rfc.compliant</parameter>. If it
8302           is non-zero (the default), any underscore in a language code
8303           will be converted to a hyphen in HTML output. If it is zero,
8304           the language code will be left as-is.</para>
8305         </listitem>
8306       </itemizedlist>
8307     </sect2>
8308     <sect2 xml:id="V1690_MAN">
8309       <title>man</title>
8310       <para>This release closes out 44 manpages stylesheet bug reports
8311       and feature requests. It adds more than 35 new configuration
8312       parameters for controlling aspects of man-page output --
8313       including hyphenation and justification, handling of links,
8314       conversion of Unicode characters, and contents of man-page
8315       headers and footers.</para>
8316       <itemizedlist>
8317         <!-- ======================================================= -->
8318         <listitem>
8319           <para>New options for globally disabling/enabling
8320           hyphenation and justification:
8321           <parameter>man.justify</parameter> and
8322           <parameter>man.hyphenate</parameter>.</para>
8323           <para>Note that the default
8324           for the both of those is zero (off), because justified text
8325           looks good only when it is also hyphenated; to quote the
8326           <quote>Hyphenation</quote> node from the groff info page:
8327           <blockquote>
8328             <para><emphasis>Since the odds are not great for finding a
8329             set of words, for every output line, which fit nicely on a
8330             line without inserting excessive amounts of space between
8331             words, `gtroff' hyphenates words so that it can justify
8332             lines without inserting too much space between
8333             words.</emphasis></para>
8334           </blockquote>
8335           The problem is that groff can end up hyphenating a lot of
8336           things that you don't want hyphenated (variable names and
8337           command names, for example). Keeping both justification and
8338           hyphenation disabled ensures that hyphens won't get inserted
8339           where you don't want to them, and you don't end up with
8340           lines containing excessive amounts of space between
8341           words. These default settings run counter to how most
8342           existing man pages are formatted. But there are some notable
8343           exceptions, such as the perl man pages.</para>
8344         </listitem>
8345         <listitem>
8346           <para> Added parameters for controlling hyphenation of
8347           computer inlines, filenames, and URLs. By default, even when
8348           hyphenation is enabled (globally), hyphenation is now
8349           suppressed for "computer inlines" (currently, just
8350           <tag>classname</tag>, <tag>constant</tag>, <tag>envar</tag>,
8351           <tag>errorcode</tag>, <tag>option</tag>,
8352           <tag>replaceable</tag>, <tag>userinput</tag>,
8353           <tag>type</tag>, and <tag>varname</tag>, and for
8354           <tag>filenames</tag>, and for URLs from <tag>link</tag>. It
8355           can be (re)enabled using the
8356           <parameter>man.hyphenate.computer.inlines</parameter>,
8357           <parameter>man.hyphenate.filenames</parameter>, and
8358           <parameter>man.hyphenate.urls parameters</parameter>.</para>
8359         </listitem>
8360         <!-- ======================================================= -->
8361         <listitem>
8362           <para>Implemented a new system for replacing Unicode
8363           characters. There are two parts to the new system: a
8364           <quote>string substitution map</quote> for doing
8365           <quote>essential</quote> replacements, and a
8366           <quote>character map</quote> that can optionally be disabled
8367           and enabled.</para>
8368           <para>The new system fixes all open bugs that had to do with
8369           literal Unicode numbered entities such as &amp;#8220; and
8370           &amp;#8221; showing up in output, and greatly expands the
8371           ability of the stylesheets to generate <quote>good</quote> roff
8372           equivalents for Unicode symbols and special
8373           characters.</para>
8374           <para>Here are some details...</para>
8375           <para>The previous manpages mechanism for replacing Unicode
8376           symbols and special characters with roff equivalents (the
8377           <function>replace-entities</function> template) was not
8378           scalable and not complete. The mechanism handled a somewhat
8379           arbitrary selection of less than 20 or so Unicode
8380           characters. But there are potentially more than
8381           <emphasis>800</emphasis> Unicode special characters that
8382           have some groff equivalent they can be mapped to. And there
8383           are about 34 symbols in the Latin-1 (ISO-8859-1) block
8384           alone. Users might reasonably expect that if they include
8385           any of those Latin-1 characters in their DocBook source
8386           documents, they will get correctly converted to known roff
8387           equivalents in output.</para>
8388           <para>In addition to those common symbols, certain users may
8389           have a need to use symbols from other Unicode blocks. Say,
8390           somebody who is documenting an application related to math
8391           might need to use a bunch of symbols from the
8392           <quote>Mathematical Operators</quote> Unicode block (there
8393           are about 65 characters in that block that have reasonable
8394           roff equivalents). Or somebody else might really like
8395           Dingbats -- such as the checkmark character -- and so might
8396           use a bunch of things from the <quote>Dingbat</quote> block
8397           (141 characters in that that have roff equivalents or that
8398           can at least be <quote>degraded</quote> somewhat gracefully
8399           into roff).</para>
8400           <para>So, the old <function>replace-entities</function>
8401           mechanism was replaced with a completely different mechanism
8402           that is based on use of two <quote>maps</quote>: a
8403           <quote>substitution map</quote> and a <quote>character
8404           map</quote> (the latter in a format compliant with the XSLT
8405           2.0 spec and therefore completely <quote>forward
8406           compatible</quote> with XSLT 2.0).</para>
8407           <para>The substitution map is controlled through the
8408           <parameter>man.string.subst.map</parameter> parameter, and
8409           is used to replace things like the backslash character
8410           (which needs special handling to prevent it from being
8411           interpreted as a roff escape). The substitution map cannot
8412           be disabled, because disabling it will cause the output to
8413           be broken. However, you can add to it and change it if
8414           needed.</para>
8415
8416           <para>The <quote>character map</quote> mechanism, on the
8417           other hand, can be completely disabled. It is enabled by
8418           default, and, by default, does replacement of all Latin-1
8419           symbols, along with most special spaces, dashes, and quotes
8420           (about 75 characters by default). Also, you can optionally
8421           enable a <quote>full</quote> character map that provides
8422           support for converting all 800 or so of the characters that
8423           have some reasonable groff equivalent.</para>
8424
8425           <para>The character-map mechanism is controlled through the
8426           following parameters:
8427           <variablelist>
8428             <varlistentry>
8429               <term><parameter>man.charmap.enabled</parameter></term>
8430               <listitem><para>turns character-map support
8431               on/off</para></listitem>
8432             </varlistentry>
8433             <varlistentry>
8434               <term><parameter>man.charmap.use.subset</parameter></term>
8435               <listitem><para>specifies that a subset of the character
8436               map is used instead of the full map</para></listitem>
8437             </varlistentry>
8438             <varlistentry>
8439               <term><parameter>man.charmap.subset.profile</parameter></term>
8440               <listitem><para>specifies profile of character-map
8441               subset</para></listitem>
8442             </varlistentry>
8443             <varlistentry>
8444               <term><parameter>man.charmap.uri</parameter></term>
8445               <listitem><para>specifies an alternate character map to
8446               use instead of the <quote>standard</quote> character map
8447               provided in the distribution</para></listitem>
8448             </varlistentry>
8449           </variablelist>
8450           </para>
8451         </listitem>
8452         <!-- ======================================================= -->
8453         <listitem>
8454           <para>Implemented out-of-line handling of display of URLs
8455           for links (currently, only for <tag>ulink</tag>). This gives
8456           you three choices for handling of links:
8457           <orderedlist>
8458             <listitem>
8459               <para>Number and list links. Each link is numbered
8460               inline, with a number in square brackets preceding the
8461               link contents, and a numbered list of all links is added
8462               to the end of the document.</para>
8463             </listitem>
8464             <listitem>
8465               <para>Only list links. Links are not numbered, but an
8466               (unnumbered) list of links is added to the end of the
8467               document.</para>
8468             </listitem>
8469             <listitem>
8470               <para>Suppress links. Don't number links and don't add
8471               any list of links to the end of the document.</para>
8472             </listitem>
8473           </orderedlist>
8474           You can also choose whether links should be underlined. The
8475           default is <quote>the works</quote> -- list, number, and
8476           underline links. You can use the
8477           <parameter>man.links.list.enabled</parameter>, <parameter>
8478           man.links.are.numbered</parameter>, and
8479           <parameter>man.links.are.underlined</parameter> parameters
8480           to change the defaults. The default heading for the link
8481           list is REFERENCES. You can be change that using the
8482           <parameter>man.links.list.heading</parameter>
8483           parameter.</para>
8484         </listitem>
8485         <listitem>
8486           <para>Changed default output encoding to UTF-8. <emphasis role="bold">This does not mean that man pages are output in
8487           raw UTF-8</emphasis>, because the character map is applied
8488           before final output, causing all UTF-8 characters covered in
8489           the map to be converted to roff equivalents.</para>
8490         </listitem>
8491         <!-- ======================================================= -->
8492         <listitem>
8493           <para>Added support for processing <tag>refsect3</tag> and
8494           <tag>formalpara</tag> and nested <tag>refsection</tag>
8495           elements, down to any arbitrary level of nesting.</para>
8496         </listitem>
8497         <!-- ======================================================= -->
8498         <listitem>
8499           <para>Output of the <literal>NAME</literal> and
8500           <literal>SYNOPSIS</literal> and <literal>AUTHOR</literal>
8501           headings and the headings for admonitions (<tag>note</tag>,
8502           <tag>caution</tag>, etc.) are no longer hard-coded for
8503           English. Instead, headings are generated for those in the
8504           correct locale (just as the FO and HTML stylesheets
8505           do).</para>
8506         </listitem>
8507         <!-- ======================================================= -->
8508         <listitem>
8509           <para>Re-worked mechanism for assembling page
8510           headers/footers (the contents of the <literal>.TH</literal>
8511           macro <quote>title line</quote>).</para>
8512
8513           <para>Here are some details...</para>
8514
8515           <para>All man pages contain a <literal>.TH</literal> roff
8516           macro whose contents are used for rendering the <quote>title
8517           line</quote> displayed in the header and footer of each
8518           page. Here are a couple of examples of real-world man pages
8519           that have useful page headers/footers: <literallayout class="monospaced">
8520   gtk-options(7)    GTK+ User's Manual   gtk-options(7) &lt;-- header
8521   GTK+ 1.2              2003-10-20       gtk-options(7) &lt;-- footer
8522
8523   svgalib(7)       Svgalib User Manual       svgalib(7) &lt;-- header
8524   Svgalib 1.4.1      16 December 1999        svgalib(7) &lt;-- footer</literallayout></para>
8525
8526           <para>And here are the terms with which the
8527           <literal>groff_man(7)</literal> man page refers to the
8528           various parts of the header/footer: <literallayout class="monospaced">
8529   title(section)  extra3  title(section)  &lt;- header
8530   extra2          extra1  title(section)  &lt;- footer</literallayout></para>
8531   <para> Or, using the names with which the <literal>man(7)</literal>
8532    man page refers to those same fields: <literallayout class="monospaced">
8533   title(section)  manual  title(section)  &lt;- page header
8534   source          date    title(section)  &lt;- page footer</literallayout></para>
8535   
8536             <para>The easiest way to control the contents of those
8537             fields is to mark up your <tag>refentry</tag> content like
8538             the following (note that this is a <quote>minimal</quote>
8539             example). <programlisting>
8540   &lt;refentry&gt;
8541     &lt;info&gt;
8542       &lt;date&gt;2003-10-20&lt;/date&gt; <co xml:id="V1690_date-co" linkends="V1690_date"/>
8543     &lt;/info&gt;
8544     &lt;refmeta&gt;
8545       &lt;refentrytitle&gt;gtk-options&lt;/refentrytitle&gt; <co xml:id="V1690_title-co" linkends="V1690_title"/>
8546       &lt;manvolnum&gt;7&lt;/manvolnum&gt; <co xml:id="V1690_manvolnum-co" linkends="V1690_manvolnum"/>
8547       &lt;refmiscinfo class="source-name"&gt;GTK+&lt;/refmiscinfo&gt; <co xml:id="V1690_source-name-co" linkends="V1690_source-name"/>
8548       &lt;refmiscinfo class="version"&gt;1.2&lt;/refmiscinfo&gt; <co xml:id="V1690_version-co" linkends="V1690_version"/>
8549       &lt;refmiscinfo class="manual"&gt;GTK+ User's Manual&lt;/refmiscinfo&gt; <co xml:id="V1690_manual-co" linkends="V1690_manual"/>
8550     &lt;/refmeta&gt;
8551     &lt;refnamediv&gt;
8552       &lt;refname&gt;gtk-options&lt;/refname&gt;
8553       &lt;refpurpose&gt;Standard Command Line Options for GTK+ Programs&lt;/refpurpose&gt;
8554     &lt;/refnamediv&gt;
8555     &lt;refsect1&gt;
8556       &lt;title&gt;Description&lt;/title&gt;
8557       &lt;para&gt;This manual page describes the command line options, which
8558       are common to all GTK+ based applications.&lt;/para&gt;
8559     &lt;/refsect1&gt;
8560   &lt;/refentry&gt;</programlisting>
8561   <calloutlist>
8562     <callout arearefs="V1690_date-co" xml:id="V1690_date">
8563       <para>Sets the <quote>date</quote> part of the header/footer.</para>
8564     </callout>
8565     <callout arearefs="V1690_title-co" xml:id="V1690_title">
8566       <para>Sets the <quote>title</quote> part.</para>
8567     </callout>
8568     <callout arearefs="V1690_manvolnum-co" xml:id="V1690_manvolnum">
8569       <para>Sets the <quote>section</quote> part.</para>
8570     </callout>
8571     <callout arearefs="V1690_source-name-co" xml:id="V1690_source-name">
8572       <para>Sets the <quote>source name</quote> part.</para>
8573     </callout>
8574     <callout arearefs="V1690_version-co" xml:id="V1690_version">
8575       <para>Sets the <quote>version</quote> part.</para>
8576     </callout>
8577     <callout arearefs="V1690_manual-co" xml:id="V1690_manual">
8578       <para>Sets the <quote>manual</quote> part.</para>
8579     </callout>
8580   </calloutlist>
8581             </para>
8582             <para>Below are explanations of the steps the stylesheets
8583             take to attempt to assemble and display
8584             <quote>good</quote> headers and footer. [In the
8585             descriptions, note that <replaceable>*info</replaceable>
8586             is the <tag>refentry</tag> <quote>info</quote> child
8587             (whatever its name), and
8588             <replaceable>parentinfo</replaceable> is the
8589             <quote>info</quote> child of its parent (again, whatever
8590             its name).]
8591           <variablelist>
8592             <varlistentry>
8593               <term>extra1 field (date)</term>
8594               <listitem>
8595                 <para>Content of the <quote>extra1</quote> field is
8596                 what shows up in the <emphasis role="bold">center
8597                 footer</emphasis> position of each page. The
8598                 <literal>man(7)</literal> man page describes it as
8599                 <quote>the date of the last revision</quote>.</para>
8600                 <para>To provide this content, if the
8601                 <parameter>refentry.date.profile.enabled</parameter>
8602                 is non-zero, the stylesheets check the value of
8603                 <parameter>refentry.date.profile</parameter>.</para>
8604                 <para>Otherwise, by default, they check for a
8605                 <tag>date</tag> or <tag>pubdate</tag> not only in the
8606                 <replaceable>*info</replaceable> contents, but also in
8607                 the <replaceable>parentinfo</replaceable>
8608                 contents.</para>
8609                 <para>If a date cannot be found, the stylesheets now
8610                 automatically generate a localized <quote>long
8611                 format</quote> date, ensuring that this field always
8612                 has content in output.</para>
8613                 <para>However, if for some reason you want to suppress
8614                 this field, you can do so by setting a non-zero value
8615                 for <parameter>man.th.extra1.suppress</parameter>.</para>
8616               </listitem>
8617             </varlistentry>
8618             <varlistentry>
8619               <term>extra2 field (source)</term>
8620               <listitem>
8621                 <para>On Linux systems and on systems with a modern
8622                 groff, the content of the <quote>extra2</quote> field
8623                 are what shows up in the <emphasis role="bold">left
8624                 footer</emphasis> position of each page.</para>
8625
8626                 <para>The <literal>man(7)</literal> man page describes
8627                 this as <quote>the source of the command</quote>, and
8628                 provides the following examples:
8629                 <itemizedlist>
8630                   <listitem>
8631                     <para>For binaries, use somwething like: GNU,
8632                     NET-2, SLS Distribution, MCC Distribution.</para>
8633                   </listitem>
8634                   <listitem>
8635                     <para>For system calls, use the version of the
8636                     kernel that you are currently looking at: Linux
8637                     0.99.11.</para>
8638                   </listitem>
8639                   <listitem>
8640                     <para>For library calls, use the source of the
8641                     function: GNU, BSD 4.3, Linux DLL 4.4.1.</para>
8642                   </listitem>
8643                 </itemizedlist>
8644                 </para>
8645
8646                 <para>In practice, there are many pages that simply
8647                 have a version number in the <quote>source</quote>
8648                 field. So, it looks like what we have is a two-part
8649                 field,
8650                 <replaceable>Name</replaceable> <replaceable>Version</replaceable>,
8651                 where:
8652                 <variablelist>
8653                   <varlistentry>
8654                     <term>Name</term>
8655                     <listitem>
8656                       <para>product name (e.g., BSD) or org. name
8657                       (e.g., GNU)</para>
8658                     </listitem>
8659                   </varlistentry>
8660                   <varlistentry>
8661                     <term>Version</term>
8662                     <listitem>
8663                       <para>version name</para>
8664                     </listitem>
8665                   </varlistentry>
8666                 </variablelist>
8667                 Each part is optional. If the
8668                 <replaceable>Name</replaceable> is a product name,
8669                 then the <replaceable>Version</replaceable> is
8670                 probably the version of the product. Or there may be
8671                 no <replaceable>Name</replaceable>, in which case, if
8672                 there is a <replaceable>Version</replaceable>, it is
8673                 probably the version of the item itself, not the
8674                 product it is part of. Or, if the
8675                 <replaceable>Name</replaceable> is an organization
8676                 name, then there probably will be no
8677                 <replaceable>Version</replaceable>.
8678                 </para>
8679                 <para>To provide this content, if the
8680                 <parameter>refentry.source.name.profile.enabled</parameter>
8681                 and
8682                 <parameter>refentry.version.profile.enabled</parameter>
8683                 parameter are non-zero, the stylesheets check the
8684                 value of <parameter>refentry.source.name.profile</parameter>
8685                 <parameter>refentry.version.profile</parameter>.</para>
8686
8687                 <para>Otherwise, by default, they check the following
8688                 places, in the following order:
8689                 <orderedlist>
8690                   <listitem>
8691                     <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productnumber</tag></literallayout>
8692                   </listitem>
8693                   <listitem>
8694                     <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productnumber</tag></literallayout>
8695                   </listitem>
8696                   <listitem>
8697                     <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag>[@class = 'version']</literallayout>
8698                   </listitem>
8699                   <listitem>
8700                     <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>productnumber</tag></literallayout>
8701                   </listitem>
8702                   <listitem>
8703                     <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productname</tag></literallayout>
8704                   </listitem>
8705                   <listitem>
8706                     <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>productname</tag></literallayout>
8707                   </listitem>
8708                   <listitem>
8709                     <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag></literallayout>
8710                   </listitem>
8711                   <listitem>
8712                     <para>[nothing found, so leave it empty]</para>
8713                   </listitem>
8714                 </orderedlist>
8715                 </para>
8716               </listitem>
8717             </varlistentry>
8718             <varlistentry>
8719               <term>extra3 field</term>
8720               <listitem>
8721                 <para>On Linux systems and on systems with a modern
8722                 groff, the content of the <quote>extra3</quote> field
8723                 are what shows up in the <emphasis role="bold">center
8724                 header</emphasis> position of each page. Some man
8725                 pages have <quote>extra2</quote> content, some
8726                 don't. If a particular man page has it, it is most
8727                 often <quote>context</quote> data about some larger
8728                 system the documented item belongs to (for example,
8729                 the name or description of a group of related
8730                 applications). The stylesheets now check the following
8731                 places, in the following order, to look for content to
8732                 add to the <quote>extra3</quote> field.</para>
8733                 <orderedlist>
8734                   <listitem>
8735                     <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>title</tag></literallayout>
8736                   </listitem>
8737                   <listitem>
8738                     <literallayout class="monospaced">parent's <tag>title</tag></literallayout>
8739                   </listitem>
8740                   <listitem>
8741                     <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag></literallayout>
8742                   </listitem>
8743                   <listitem>
8744                     <para>[nothing found, so leave it empty]</para>
8745                   </listitem>
8746                 </orderedlist>
8747               </listitem>
8748             </varlistentry>
8749           </variablelist>
8750         </para>
8751       </listitem>
8752       <!-- ======================================================= -->
8753       <listitem>
8754         <para>Reworked <replaceable>*info</replaceable> gathering. For
8755         each <tag>refentry</tag> found, the stylesheets now cache its
8756         <replaceable>*info</replaceable> content, then check for any
8757         valid parent of it that might have metainfo content and cache
8758         that, if found; they then then do all further matches against
8759         those node-sets (rather than re-selecting the original
8760         <replaceable>*info</replaceable> nodes each time they are
8761         needed).</para>
8762       </listitem>
8763       <!-- ======================================================= -->
8764       <listitem>
8765         <para>New option for breaking strings after forward
8766         slashes. This enables long URLs and pathnames to be broken
8767         across lines. Controlled through
8768         <parameter>man.break.after.slash</parameter> parameter.</para>
8769       </listitem>
8770       <!-- ======================================================= -->
8771       <listitem>
8772         <para>Output for servicemark and trademark are now
8773         <literal>(SM)</literal> and <literal>(TM)</literal>. There is
8774         a groff <literal>"\(tm"</literal> escape, but output from that
8775         is not acceptable.</para>
8776       </listitem>
8777       <!-- ======================================================= -->
8778       <listitem>
8779         <para>New option for controlling the length of the title
8780         part of the <literal>.TH</literal> title line. Controlled
8781         through the <parameter>man.th.title.max.length</parameter>
8782         parameter.</para>
8783       </listitem>
8784       <!-- ======================================================= -->
8785       <listitem>
8786         <para>New option for specifying output encoding of each man
8787         page; controlled with
8788         <parameter>man.output.encoding</parameter> (similar to the
8789         HTML <parameter>chunker.output.encoding </parameter>
8790         parameter).</para>
8791       </listitem> 
8792       <!-- ======================================================= -->
8793      <listitem>
8794         <para>New option for suppressing filename messages when
8795         generating output; controlled with
8796         <parameter>man.output.quietly</parameter> (similar to the HTML
8797         <parameter>chunk.quietly</parameter> parameter).</para>
8798       </listitem>
8799       <!-- ======================================================= -->
8800       <listitem>
8801         <para>The text of cross-references to first-level
8802         <tag>refentry</tag> (<tag>refsect1</tag>, top-level
8803         <tag>refsection</tag>, <tag>refnamediv</tag>, and
8804         <tag>refsynopsisdiv</tag>) are now capitalized.</para>
8805       </listitem>
8806       <!-- ======================================================= -->
8807       <listitem>
8808         <para>Cross-references to <tag>refnamediv</tag> now use the
8809         localized <literal>NAME</literal> title instead of using the
8810         first <tag>refname</tag> child. This makes the output
8811         inconsistent with HTML and FO output, but for man-page output,
8812         it seems to make better sense to have the
8813         <literal>NAME</literal>. (It may actually make better sense to
8814         do it that way in HTML and FO output as well...)</para>
8815       </listitem>
8816       <!-- ======================================================= -->
8817       <listitem>
8818         <para>Added support for processing <tag>funcparams</tag>.</para>
8819       </listitem>
8820       <!-- ======================================================= -->
8821       <listitem>
8822         <para>Removed the space that was being output between
8823         <tag>funcdef</tag> and <tag>paramdef</tag>; example: was:
8824         <literal>float rand (void)</literal>; now:
8825         <literal>float rand(void)</literal></para>
8826       </listitem>
8827       <!-- ======================================================= -->
8828       <listitem>
8829         <para>Turned off bold formatting for the <tag>type</tag>
8830         element when it occurs within a <tag>funcdef</tag> or
8831         <tag>paramdef</tag></para>
8832       </listitem>
8833       <!-- ======================================================= -->
8834       <listitem>
8835         <para>Corrected rendering of <tag>simplelist</tag>. Any
8836         <literal>&lt;simplelist type="inline"</literal> instance
8837         is now rendered as a comma-separated list (also with an
8838         optional localized <quote>and</quote> or <quote>or</quote> before the last item -- see
8839         description elsewhere in these release notes). Any simplelist
8840         instance whose <tag class="attribute">type</tag> is not
8841         <literal>inline</literal> is rendered as a one-column vertical
8842         list (ignoring the values of the <tag class="attribute">type</tag> and <tag class="attribute">columns</tag> attributes if present)</para>
8843       </listitem>
8844       <!-- ======================================================= -->
8845       <listitem>
8846         <para>Comment added at top of roff source for each page now
8847         includes DocBook XSL stylesheets version number (as in the
8848         HTML stylesheets)</para>
8849       </listitem>
8850       <!-- ======================================================= -->
8851       <listitem>
8852         <para>Made change to prevent <quote>sticky</quote> fonts
8853         changes. Now, when the manpages stylesheets encounter node
8854         sets that need to be boldfaced or italicized, they put the
8855         <literal>\fBfoo\fR</literal> and <literal>\fIbar\fR</literal>
8856         groff bold/italic instructions separately around each node in
8857         the set.</para>
8858       </listitem>
8859       <listitem>
8860         <para>synop.xsl: Boldface everything in
8861         <tag>funcsynopsis</tag> output except parameters (which are in
8862         ital). The <literal>man(7)</literal> man page says:
8863         <blockquote>
8864           <para>For functions, the arguments are always specified
8865           using italics, even in the SYNOPSIS section, where the rest
8866           of the function is specified in bold.</para>
8867           </blockquote>
8868           A look through the contents of the
8869           <filename>man/man2</filename> directory shows that most
8870           (all) existing pages do follow this <quote>everything in
8871           funcsynopsis bold</quote> rule. That means the
8872           <tag>type</tag> content and any punctuation (parens,
8873           semicolons, <tag>vararg</tag>s) also must be bolded.</para>
8874       </listitem>
8875       <!-- ======================================================= -->
8876       <listitem>
8877         <para>Removed code for adding backslashes before periods/dots
8878         in roff source, because backslashes in front of periods/dots
8879         in roff source are needed only in the very rare case where a
8880         period is the very first character in a line, without any
8881         space in front of it. A better way to deal with that rare case
8882         is for you to add a zero-width space in front of the offending
8883         dot(s) in your source</para>
8884       </listitem>
8885       <!-- ======================================================= -->
8886       <listitem>
8887         <para>Removed special handling of the <tag>quote</tag>
8888         element. That was hard-coded to cause anything marked up with
8889         the <tag>quote</tag> element to be output preceded by two
8890         backticks and followed by two apostrophes -- that is, that
8891         old-school kludge for generating <quote>curly</quote> quotes in Emacs and
8892         in X-Windows fonts. While Emacs still seems to support that, I
8893         don't think X-Windows has for a long time now. And, anyway, it
8894         looks (and has always looked) like crap when viewed on a
8895         normal tty/console. In addition, it breaks localiztion of
8896         <tag>quote</tag>. By default, <tag>quote</tag> content is
8897         output with localized quotation marks, which, depending on the
8898         locale, may or may not be left and right double quotation
8899         marks.</para>
8900       </listitem>
8901       <!-- ======================================================= -->
8902       <listitem>
8903         <para>Changed mappings for left and right single quotation
8904         marks. Those had previously been incorrectly mapped to the
8905         backtick (&amp;#96;) and apostrophe (&amp;39;) characters (for
8906         kludgy reasons -- see above). They are now correctly mapped to
8907         the <literal>\(oq</literal> and <literal>\(cq</literal> roff
8908         escapes. If you want the old (broken) behavior, you need to
8909         manually change the mappings for those in the value of the
8910         <parameter>man.string.subst.map</parameter> parameter.</para>
8911       </listitem>
8912       <listitem>
8913         <para>Removed <filename>xref.xsl</filename> file. Now, of the
8914         various cross-reference elements, only the <tag>ulink</tag>
8915         element is handled differently; the rest are handled exactly
8916         as the HTML stylesheets handle them, except that no hypertext
8917         links are generated. (Because there is no equivalent hypertext
8918         mechanism is man pages.)</para>
8919       </listitem>
8920       <!-- ======================================================= -->
8921       <listitem>
8922         <para>New option for making <quote>subheading dividers</quote> in generated
8923         roff source. The dividers are not visible in the rendered man
8924         page; they are just there to make the source
8925         readable. Controlled using
8926         <parameter>man.subheading.divider</parameter>.</para>
8927       </listitem>
8928       <!-- ======================================================= -->
8929       <listitem>
8930         <para>Fixed many places where too much space was being added
8931         between lines.</para>
8932       </listitem>
8933     </itemizedlist>
8934     <!-- end of MAN changes for 1.69.0 release -->
8935   </sect2>
8936 </sect1>
8937   <!-- end of notes for 1.69.0 release -->
8938
8939   <sect1 xml:id="V1681">
8940     <title>Release 1.68.1</title>
8941     <para>The release adds localization support for Farsi (thanks to
8942     Sina Heshmati) and improved support for the XLink-based DocBook NG
8943     <tag>db:link</tag> element. Other than that, it is a minor
8944     bug-fix update to the 1.68.0 release. The main thing it fixes is a
8945     build error that caused the XSLT Java extensions to be jarred up
8946     with the wrong package structure. Thanks to Jens Stavnstrup for
8947     quickly reporting the problem, and to Mauritz Jeanson for
8948     investigating and finding the cause.</para>
8949   </sect1>
8950   <!-- end of notes for 1.68.1 release -->
8951
8952   <sect1 xml:id="V1680">
8953     <title>Release 1.68.0</title>
8954     <para>This release includes some features changes, particularly
8955     for FO/PDF output, and a number of bug fixes.
8956       <itemizedlist xml:id="V1680_FO">
8957         <title>FO</title>
8958         <listitem>
8959           <para>Moved footnote properties to attribute-sets.</para>
8960         </listitem>
8961         <listitem>
8962           <para>Added support for side floats, margin notes, and
8963           custom floats.</para>
8964         </listitem>
8965         <listitem>
8966           <para>Added new parameters
8967           <parameter>body.start.indent</parameter> and
8968           <parameter>body.end.indent</parameter> to the
8969           <parameter>set.flow.properties template</parameter>.</para>
8970         </listitem>
8971         <listitem>
8972           <para>Added support for <tag class="attribute">xml:id</tag></para>
8973         </listitem>
8974         <listitem>
8975           <para>Added support for
8976           <tag>refdescriptor</tag>.</para>
8977         </listitem>
8978         <listitem>
8979           <para>Added support for multiple <tag>refnamediv</tag>s.</para>
8980         </listitem>
8981         <listitem>
8982           <para>Added <parameter>index.entry.properties</parameter>
8983           attribute-set to support customization of index
8984           entries.</para>
8985         </listitem>
8986         <listitem>
8987           <para>Added <parameter>set.flow.properties
8988           template</parameter> call to each <tag>fo:flow</tag>
8989           to support customizations entry point.</para>
8990         </listitem>
8991         <listitem>
8992           <para>Add support for <literal>@floatstyle</literal> in
8993           <tag>figure</tag></para>
8994         </listitem>
8995         <listitem>
8996           <para>Moved hardcoded properties for index division titles
8997           to the <parameter>index.div.title.properties</parameter>
8998           attribute-set.</para>
8999         </listitem>
9000         <listitem>
9001           <para>Added support for
9002           <tag>table-layout</tag>="<tag class="attvalue">auto</tag>" for XEP.</para>
9003         </listitem>
9004         <listitem>
9005           <para>Added <parameter>index.div.title.properties</parameter>
9006           attribute-set.</para>
9007         </listitem>
9008         <listitem>
9009           <para><parameter>$verbose</parameter> parameter is now
9010           passed to most elements.</para>
9011         </listitem>
9012         <listitem>
9013           <para>Added <tag>refentry</tag> to
9014           <tag>toc</tag> in <tag>part</tag>, as it is
9015           permitted by the DocBook schema/DTD.</para>
9016         </listitem>
9017         <listitem>
9018           <para>Added backmatter elements and
9019           <tag>article</tag> to <tag>toc</tag> in
9020           <tag>part</tag>, since they are permitted by the
9021           DocBook schema/DTD.</para>
9022         </listitem>
9023         <listitem>
9024           <para>Added <tag class="attribute">mode</tag>="<tag class="attvalue">toc</tag>" for
9025           <tag>simplesect</tag>, since it is now permitted in
9026           the <tag>toc</tag> if
9027           <parameter>simplesect.in.toc</parameter> is set.</para>
9028         </listitem>
9029         <listitem>
9030           <para>Moved hard-coded properties to
9031           <parameter>nongraphical.admonintion.properties</parameter>
9032           and <parameter>graphical.admonition.properties</parameter>
9033           attribute sets.</para>
9034         </listitem>
9035         <listitem>
9036           <para>Added support for <literal>sidebar-width</literal> and
9037           <literal>float-type</literal> processing instructions in
9038           <tag>sidebar</tag>.</para>
9039         </listitem>
9040         <listitem>
9041           <para>For tables with HTML markup elements, added support
9042           for <literal>dbfo bgcolor</literal> PI, the attribute-sets
9043           named <parameter>table.properties</parameter>,
9044           <parameter>informaltable.properties</parameter>,
9045           <parameter>table.table.properties</parameter>, and
9046           <parameter>table.cell.padding</parameter>. Also added
9047           support for the templates named
9048           <parameter>table.cell.properties</parameter> and
9049           <parameter>table.cell.block.properties</parameter> so that
9050           tabstyles can be implemented. Also added support for tables
9051           containing only <tag>tr</tag> instead of
9052           <tag>tbody</tag> with <tag>tr</tag>.</para>
9053         </listitem>
9054         <listitem>
9055           <para>Added new paramater
9056           <parameter>hyphenate.verbatim.characters</parameter> which
9057           can specify characters after which a line break can occur in
9058           verbatim environments.  This parameter can be used to extend
9059           the initial set of characters which contain only space and
9060           non-breakable space.</para>
9061         </listitem>
9062         <listitem>
9063           <para>Added <parameter>itemizedlist.label.markup</parameter> to enable
9064           selection of different bullet symbol. Also added several
9065           potential bullet characters, commented out by default.</para>
9066         </listitem>
9067         <listitem>
9068           <para>Enabled all id's in XEP output for external olinking.</para>
9069         </listitem>
9070       </itemizedlist>
9071
9072       <itemizedlist xml:id="V1680_HTML">
9073         <title>HTML</title>
9074         <listitem>
9075           <para>Added support for
9076           <tag>refdescriptor</tag>.</para>
9077         </listitem>
9078         <listitem>
9079           <para>Added support for multiple <tag>refnamediv</tag>s.</para>
9080         </listitem>
9081         <listitem>
9082           <para>Added support for <tag class="attribute">xml:id</tag></para>
9083         </listitem>
9084         <listitem>
9085           <para><tag>refsynopsisdiv</tag> as a section for
9086           counting section levels</para>
9087         </listitem>
9088       </itemizedlist>
9089       <itemizedlist xml:id="V1680_images">
9090         <title>Images</title>
9091         <listitem>
9092           <para>Added new SVG admonition graphics and navigation images.</para>
9093         </listitem>
9094       </itemizedlist>
9095     </para>
9096   </sect1>
9097   <!-- end of notes for 1.68.0 release -->
9098
9099   <sect1 xml:id="V1672">
9100     <title>Release 1.67.2</title>
9101     <para>This release fixes a table bug introduced in the 1.67.1
9102     release.</para>
9103   </sect1>
9104   <sect1 xml:id="V1671">
9105     <title>Release 1.67.1</title>
9106     <para>This release includes a number of bug fixes.</para>
9107      <para>The following lists provide details about API and feature changes.
9108       <itemizedlist xml:id="V1671_FO">
9109         <title>FO</title>
9110         <listitem>
9111           <para>Tables: Inherited cell properties are now passed to the
9112           <literal>table.cell.properties</literal> template so they can
9113           be overridden by a customization.</para>
9114         </listitem>
9115         <listitem>
9116           <para>Tables: Added support for bgcolor PI on table row
9117           element.</para>
9118         </listitem>
9119         <listitem>
9120           <para>TOCs: Added new parameter
9121           <parameter>simplesect.in.toc</parameter>; default value of
9122           <literal>0</literal> causes simplesect to be omitted from TOCs; to
9123           cause <tag>simplesect</tag> to be included in TOCs, you
9124           must set the value of <parameter>simplesect.in.toc</parameter> to
9125           <literal>1</literal>.Comment from Norm:
9126
9127             <blockquote>
9128               <para><emphasis>Simplesect elements aren't supposed to
9129               appear in the ToC at all... The use case for simplesect
9130               is when, for example, every chapter in a book ends with
9131               "Exercises" or "For More Information" sections and you
9132               don't want those to appear in the ToC.</emphasis></para>
9133             </blockquote>
9134             </para>
9135         </listitem>
9136         <listitem>
9137           <para>Sections: Reverted change that caused a variable reference
9138           to be used in a template match and rewrote code to preserve
9139           intended semantics.</para>
9140         </listitem>
9141         <listitem>
9142           <para>Lists: Added workaround to prevent "* 0.60 + 1em" garbage in
9143           list output from PassiveTeX</para>
9144         </listitem>
9145         <listitem>
9146           <para>Moved the literal attributes from
9147           <parameter>component.title</parameter> to the
9148           <parameter>component.title.properties</parameter> attribute-set so
9149           they can be customized.</para>
9150         </listitem>
9151         <listitem>
9152           <para>Lists: Added <tag>glossdef</tag>'s first
9153           <tag>para</tag> to special handling in
9154           <literal>fo:list-item-body</literal>.</para>
9155         </listitem>
9156       </itemizedlist>
9157
9158       <itemizedlist xml:id="V1671_HTML">
9159         <title>HTML</title>
9160         <listitem>
9161           <para>TOCs: Added new parameter
9162           <parameter>simplesect.in.toc</parameter>; for details, see
9163           the list of <xref linkend="V1671_FO"/> changes for this
9164           release.</para>
9165         </listitem>
9166         <listitem>
9167           <para>Indexing: Added new parameter
9168           <parameter>index.prefer.titleabbrev</parameter>; when set to
9169           <literal>1</literal>, index references will use
9170           <tag>titleabbrev</tag> instead of
9171           <tag>title</tag> when available.</para>
9172         </listitem>
9173       </itemizedlist>
9174       <itemizedlist xml:id="V1671_HELP">
9175         <title>HTML Help</title>
9176         <listitem>
9177           <para>Added support for generating windows-1252-encoded
9178           output using Saxon; for more details, see the list of <xref linkend="V1671_EXT"/> changes for this release.</para>
9179         </listitem>
9180       </itemizedlist>
9181       <itemizedlist xml:id="V1671_MAN">
9182         <title>man pages</title>
9183         <listitem>
9184           <para>Replaced named/numeric character-entity references for
9185           non-breaking space with groff equivalent (backslash-tilde).</para>
9186         </listitem>
9187       </itemizedlist>
9188       <itemizedlist xml:id="V1671_EXT">
9189         <title>XSL Java extensions</title>
9190         <listitem>
9191           <para>Saxon extensions: Added the
9192           <classname>Windows1252</classname> class.  It extends Saxon
9193           6.5.x with the windows-1252 character set, which is
9194           particularly useful when generating HTML Help for Western
9195           European Languages (code from
9196           <personname><firstname>Pontus</firstname>
9197           <surname>Haglund</surname></personname> and contributed to the
9198           DocBook community by Sectra AB, Sweden).</para>
9199           <para>To use:
9200           <orderedlist>
9201             <listitem>
9202               <para>Make sure that the Saxon 6.5.x jar file and the jar file for
9203               the DocBook XSL Java extensions are in your <envar>CLASSPATH</envar></para>
9204             </listitem>
9205             <listitem>
9206               <para>Create a DocBook XSL customization layer -- a file named
9207               <filename>mystylesheet.xsl</filename> or whatever -- that, at a
9208               minimum, contains the following:
9209               <screen>  &lt;xsl:stylesheet
9210     xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
9211     version='1.0'&gt;
9212     &lt;xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/&gt;
9213     &lt;xsl:output method="html" encoding="WINDOWS-1252" indent="no"/&gt;
9214     &lt;xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"&gt;&lt;/xsl:param&gt;
9215     &lt;xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"&gt;&lt;/xsl:param&gt;
9216     &lt;xsl:param name="saxon.character.representation" select="'native'"&gt;&lt;/xsl:param&gt;
9217   &lt;/xsl:stylesheet&gt;</screen>
9218               </para>
9219               <para>Invoke Saxon with the
9220               <literal>encoding.windows-1252</literal> Java system property set
9221               to <literal>com.nwalsh.saxon.Windows1252</literal>; for example
9222               <screen>  java \
9223     -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
9224   com.icl.saxon.StyleSheet \
9225   mydoc.xml mystylesheet.xsl</screen>
9226
9227               Or, for a more complete "real world" case showing other
9228               options you'll typically want to use:
9229               <screen>  java \
9230     -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
9231     -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \
9232     -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \
9233     -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \
9234   com.icl.saxon.StyleSheet \
9235     -x org.apache.xml.resolver.tools.ResolvingXMLReader \
9236     -y org.apache.xml.resolver.tools.ResolvingXMLReader \
9237     -r org.apache.xml.resolver.tools.CatalogResolver \
9238   mydoc.xml mystylesheet.xsl</screen>
9239
9240               In both cases, the "mystylesheet.xsl" file should be a
9241               DocBook customization layer containing the parameters
9242               show in step 2.</para>
9243             </listitem>
9244           </orderedlist>
9245           </para>
9246         </listitem>
9247         <listitem>
9248           <para>Saxon extensions: Removed Saxon 8 extensions from release package</para>
9249         </listitem>
9250       </itemizedlist>
9251     </para>
9252   </sect1>
9253 <sect1 xml:id="V1670">
9254   <title>Release 1.67.0</title>
9255   <itemizedlist>
9256   <listitem>
9257     <para>A number of important bug fixes.</para>
9258   </listitem>
9259   <listitem>
9260     <para>Added Saxon8 extensions</para>
9261   </listitem>
9262   <listitem>
9263     <para>Enabled <literal>dbfo table-width</literal> on
9264     <tag>entrytbl</tag> in FO output</para>
9265   </listitem>
9266   <listitem>
9267     <para>Added support for <literal>role=strong</literal> on
9268     <tag>emphasis</tag> in FO output</para>
9269   </listitem>
9270   <listitem>
9271     <para>Added new FO parameter
9272     <parameter>hyphenate.verbatim</parameter> that can be used to turn
9273     on "intelligent" wrapping of verbatim environments.</para>
9274   </listitem>
9275   <listitem>
9276     <para>Replaced all <literal>&lt;tt&gt;&lt;/tt&gt;</literal> output with
9277     <literal>&lt;code&gt;&lt;/code&gt;</literal></para>
9278   </listitem>
9279   <listitem>
9280     <para>Changed <literal>admon.graphic.width</literal> template to a
9281     mode so that different admonitions can have different graphical
9282     widths.</para>
9283   </listitem>
9284   <listitem>
9285     <para>Deprecated the HTML <parameter>shade.verbatim</parameter>
9286     parameter (use CSS instead)</para>
9287   </listitem>
9288   <listitem>
9289     <para>Wrapped ToC
9290     <tag>refentrytitle</tag>/<tag>refname</tag> and
9291     <tag>refpurpose</tag> in span with class values. This
9292     makes it possible to style them using a CSS stylesheet.</para>
9293   </listitem>
9294   <listitem>
9295     <para>Use <literal>strong/em</literal> instead of
9296     <literal>b/i</literal> in HTML output</para>
9297   </listitem>
9298   <listitem>
9299     <para>Added support for converting <tag>Emphasis</tag> to
9300     groff italic and <tag>Emphasis role='bold'</tag> to
9301     bold. Controlled by
9302     <parameter>emphasis.propagates.style</parameter> param, but not
9303     documented yet using litprog system. Will do that next (planning
9304     to add some other parameter-controllable options for hyphenation
9305     and handling of line spacing).</para>
9306   </listitem>
9307   <listitem>
9308     <para><parameter>callout.graphics.number.limit.xml</parameter>
9309     param: Changed the default from <literal>10</literal> to
9310     <literal>15</literal>.</para>
9311   </listitem>
9312   <listitem>
9313     <para><parameter>verbatim.properties</parameter>: Added
9314     <literal>hyphenate=false</literal></para>
9315   </listitem>
9316   <listitem>
9317     <para>Saxon and Xalan Text.java extensions: Added support for
9318     <methodname>URIResolver()</methodname> on insertfile href's</para>
9319   </listitem>
9320   <listitem>
9321     <para>Added generated <filename>RELEASE-NOTES.txt</filename>
9322     file.</para>
9323   </listitem>
9324   <listitem>
9325     <para>Added <filename>INSTALL</filename> file (executable file for
9326     generating catalog.xml)</para>
9327   </listitem>
9328   <listitem>
9329     <para>Removed obsolete <filename>tools</filename> directory from
9330     package</para>
9331   </listitem>
9332 </itemizedlist>
9333 </sect1>
9334 <sect1 xml:id="V1661">
9335 <title>Release 1.66.1</title>
9336   <itemizedlist>
9337 <listitem>
9338 <para>A number of important bug fixes.
9339 </para>
9340 </listitem>
9341 <listitem>
9342 <para>
9343 Now <literal>xml:base</literal> attributes that are generated by an
9344 XInclude processor are resolved for image files.
9345 </para>
9346 </listitem>
9347 <listitem>
9348 <para>
9349 Rewrote olink templates to support several new features.
9350 </para>
9351 <itemizedlist>
9352 <listitem>
9353 <para>
9354 Extended full olink support to FO output.
9355 </para>
9356 </listitem>
9357 <listitem>
9358 <para>
9359 Add support for <literal>xrefstyle</literal> attribute in olinks.
9360 </para>
9361 </listitem>
9362 <listitem>
9363 <para>
9364 New parameters to support new olink features:
9365 <parameter>insert.olink.page.number</parameter>, <parameter>insert.olink.pdf.frag</parameter>,
9366 <parameter>olink.debug</parameter>, <parameter>olink.lang.fallback.sequence</parameter>, <parameter>olink.properties</parameter>,
9367 <parameter>prefer.internal.olink</parameter>.
9368 See the reference page for each parameter for more
9369 information.</para>
9370 </listitem>
9371 </itemizedlist>
9372 </listitem> 
9373 <listitem>
9374 <para>
9375 Added  <parameter>index.on.type</parameter> parameter for new <tag class="attribute">type</tag>
9376 attribute introduced in DocBook 4.3 for indexterms and index.
9377 This allows you to create multiple indices containing
9378 different categories of entries.
9379 For users of 4.2 and earlier, you can use the new parameter <parameter>index.on.role</parameter>
9380 instead.
9381 </para>
9382 </listitem>
9383 <listitem>
9384 <para>
9385 Added new
9386 <parameter>section.autolabel.max.depth</parameter> parameter to turn off section numbering
9387 below a certain depth.
9388 This permits you to number major section levels and leave minor
9389 section levels unnumbered.</para>
9390 </listitem> 
9391 <listitem>
9392 <para>
9393 Added <parameter>footnote.sep.leader.properties</parameter> attribute set to format
9394 the line separating footnotes in printed output.
9395 </para>
9396 </listitem>
9397 <listitem>
9398 <para>
9399 Added parameter <parameter>img.src.path</parameter> as a prefix to HTML img src
9400 attributes.
9401 The prefix is added to whatever path is already generated by the
9402 stylesheet for each image file.</para>
9403 </listitem> 
9404 <listitem>
9405 <para>
9406 Added new attribute-sets
9407 <parameter>informalequation.properties</parameter>,
9408 <parameter>informalexample.properties</parameter>,
9409 <parameter>informalfigure.properties</parameter>, and <parameter>informaltable.properties</parameter>,
9410 so each such element type can be formatted
9411 individually if needed.
9412 </para>
9413 </listitem>
9414 <listitem>
9415 <para>
9416 Add <parameter>component.label.includes.part.label</parameter>
9417 parameter to add any  part number to chapter, appendix
9418 and other component labels when
9419 the <parameter>label.from.part</parameter> parameter  is nonzero.
9420 This permits you to distinguish multiple chapters with the same
9421 chapter number in cross references and the TOC.</para>
9422 </listitem>
9423 <listitem>
9424 <para>
9425 Added <parameter>chunk.separate.lots</parameter> parameter for HTML output.
9426 This parameter lets you generate separate chunk files for each LOT
9427 (list of tables, list of figures, etc.).</para>
9428 </listitem>
9429 <listitem>
9430 <para>Added several table features:</para>
9431 <itemizedlist>
9432 <listitem>
9433 <para>
9434 Added <parameter>table.table.properties</parameter> attribute set to add
9435 properties to the fo:table element.
9436 </para>
9437 </listitem>
9438 <listitem>
9439 <para>
9440 Added placeholder templates named <literal>table.cell.properties</literal>
9441 and <literal>table.cell.block.properties</literal> to enable adding properties
9442 to any <tag>fo:table-cell</tag> or the cell's <tag>fo:block</tag>, respectively.
9443  These templates are a start for implementing table styles.</para>
9444 </listitem>
9445 </itemizedlist>
9446 </listitem>
9447 <listitem>
9448 <para>
9449 Added new attribute
9450 set <parameter>component.title.properties</parameter> for easy modifications of
9451 component's title formatting in FO output.
9452 </para>
9453 </listitem>
9454 <listitem>
9455 <para>
9456 Added Saxon support for an <tag class="attribute">encoding</tag> attribute on the <tag class="element">textdata</tag> element. Added new parameter
9457 <parameter>textdata.default.encoding</parameter> which specifies encoding when
9458 <tag class="attribute">encoding</tag> attribute on
9459 <tag class="element">textdata</tag> is missing.
9460 </para>
9461 </listitem>
9462 <listitem>
9463 <para>
9464 Template <literal>label.this.section</literal> now controls whole
9465 section label, not only sub-label which corresponds to
9466 particular label. Former behaviour was IMHO bug as it was
9467 not usable.
9468 </para>
9469 </listitem>
9470 <listitem>
9471 <para>
9472 Formatting in titleabbrev for TOC and headers
9473 is preserved when there are no hotlink elements in the title. Formerly the title showed only the text of the title, no font changes or other markup.
9474 </para>
9475 </listitem>
9476 <listitem>
9477 <para>
9478 Added <literal>intial.page.number</literal> template to set the <literal>initial-page-number
9479 property</literal> for page sequences in print output.
9480 Customizing this template lets you change when page numbering restarts. This is similar to the <literal>format.page.number</literal> template that lets you change how the page number formatting changes in the output.
9481 </para>
9482 </listitem>
9483 <listitem>
9484 <para>
9485 Added <literal>force.page.count</literal> template to set the force-page-count
9486 property for page sequences in print output.
9487 This is similar to the <literal>format.page.number</literal> template.
9488 </para>
9489 </listitem>
9490 <listitem>
9491 <para>
9492 Sort language for localized index sorting in <filename>autoidx-ng.xsl</filename> is now taken from document 
9493 lang, not from system environment.
9494 </para>
9495 </listitem>
9496 <listitem>
9497 <para>
9498 Numbering and formatting of normal
9499 and ulink footnotes (if turned on) has been unified.
9500 Now ulink footnotes are mixed in with any other footnotes.</para>
9501 </listitem> 
9502 <listitem>
9503 <para>
9504 Added support for <tag>renderas</tag> attribute in section and
9505 sect1 et al.
9506 This permits you to render a given section title as if it were a different level.</para>
9507 </listitem>
9508 <listitem>
9509 <para>
9510 Added support for <tag>label</tag> attribute in footnote to manually
9511 supply the footnote mark.
9512 </para>
9513 </listitem>
9514 <listitem>
9515 <para>
9516 Added support for DocBook 4.3 <tag>corpcredit</tag> element.
9517 </para>
9518 </listitem>
9519 <listitem>
9520 <para>
9521 Added support for a <literal>dbfo keep-together</literal> PI for
9522 formal objects (table, figure, example, equation, programlisting).  That permits a formal object to be kept together if it is not already, or to be broken if it
9523 is very long and the
9524 default keep-together is not appropriate.
9525 </para>
9526 </listitem>
9527 <listitem>
9528 <para>
9529 For graphics files, made file extension matching case
9530 insensitive, and updated the list of graphics extensions.
9531 </para>
9532 </listitem>
9533 <listitem>
9534 <para>
9535 Allow <tag>calloutlist</tag> to have block content before
9536 the first callout
9537 </para>
9538 </listitem>
9539 <listitem>
9540 <para>
9541 Added <literal>dbfo-need</literal> processing instruction to provide
9542 soft page breaks.
9543 </para>
9544 </listitem> 
9545 <listitem>
9546 <para>
9547 Added implementation of existing but unused
9548 <parameter>default.image.width</parameter> parameter for graphics.
9549 </para>
9550 </listitem>
9551 <listitem>
9552 <para>
9553 Support DocBook NG <tag>tag</tag> inline element.
9554 </para>
9555 </listitem> 
9556 <listitem>
9557 <para>
9558 It appears that XEP now supports Unicode characters in
9559 bookmarks. There is no further need to strip accents from
9560 characters.
9561 </para>
9562 </listitem>
9563 <listitem>
9564 <para>
9565 Make <tag>segmentedlist</tag> HTML markup
9566 more semantic and available to CSS styles.
9567 </para>
9568 </listitem>
9569 <listitem>
9570 <para>
9571 Added <literal>user.preroot</literal> placeholder template to
9572 permit xsl-stylesheet and other PIs and comments to be
9573 output before the HTML root element.
9574 </para>
9575 </listitem>
9576 <listitem>
9577 <para>
9578 Non-chunked legalnotice now gets an &lt;a
9579 name="id"&gt; element in HTML output
9580 so it can be referenced with xref or link.
9581 </para>
9582 </listitem>
9583 <listitem>
9584 <para>
9585 In chunked HTML output, changed <literal>link rel="home"</literal> to <literal>rel="start"</literal>,
9586 and <literal>link rel="previous"</literal> to <literal>rel="prev"</literal>, per W3C HTML 4.01
9587 spec.
9588 </para>
9589 </listitem>
9590 <listitem>
9591 <para>
9592 Added several patches to htmlhelp from W. Borgert
9593 </para>
9594 </listitem> 
9595 <listitem>
9596 <para>
9597 Added Bosnian locale file as common/bs.xml.
9598 </para>
9599 </listitem> 
9600 </itemizedlist>
9601 </sect1>
9602 <sect1 xml:id="V1650">
9603 <title>Release 1.65.0</title> 
9604 <itemizedlist>
9605 <listitem>
9606 <para>A number of important bug fixes.
9607 </para>
9608 </listitem> 
9609 <listitem>
9610 <para>Added a workaround to allow these stylesheets to process DocBook NG
9611 documents. (It’s a hack that pre-processes the document to strip off the
9612 namespace and then uses <function>exsl:node-set</function> to process
9613 the result.)
9614 </para>
9615 </listitem> 
9616 <listitem>
9617 <para>Added alternative indexing mechanism which has better
9618 internationalization support. New indexing method allows grouping of
9619 accented letters like e, é, ë into the same group under letter "e". It
9620 can also treat special letters (e.g. "ch") as one character and place
9621 them in the correct position (e.g. between "h" and "i" in Czech
9622 language).</para> 
9623 <para>In order to use this mechanism you must create customization
9624 layer which imports some base stylesheet (like
9625 <filename>fo/docbook.xsl</filename>,
9626 <filename>html/chunk.xsl</filename>) and then includes appropriate
9627 stylesheet with new indexing code
9628 (<filename>fo/autoidx-ng.xsl</filename> or
9629 <filename>html/autoidx-ng.xsl</filename>). For example:</para> 
9630 <programlisting>&lt;xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
9631                 version="1.0"&gt;
9632
9633 &lt;xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/&gt;
9634 &lt;xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/&gt;
9635
9636 &lt;/xsl:stylesheet&gt;</programlisting>
9637 <para>New method is known to work with Saxon and it should also work
9638 with xsltproc 1.1.1 and later. Currently supported languages are
9639 English, Czech, German, French, Spanish and Danish.</para> 
9640 </listitem> 
9641 </itemizedlist> 
9642 </sect1>
9643 <sect1 xml:id="V1641">
9644 <title>Release 1.64.1</title> 
9645 <itemizedlist>
9646 <para>General bug fixes and improvements. Sorry about the failure to produce
9647 an updated release notes file for 1.62.0—1.63.2</para> 
9648 <listitem>
9649 <para>In the course of fixing bug #849787, wrapping Unicode callouts
9650 with an appropriate font change in the Xalan extensions, I discovered
9651 that the Xalan APIs have changed a bit. So <filename>xalan2.jar</filename>
9652 will work with older Xalan 2 implementations, <filename>xalan25.jar</filename>
9653 works with Xalan 2.5.</para>
9654 </listitem>
9655 </itemizedlist> 
9656 </sect1>
9657 <sect1 xml:id="V1610">
9658 <title>Release 1.61.0</title> 
9659 <itemizedlist>
9660 <para>Lots of bug fixes and improvements.</para> 
9661 <listitem>
9662 <para>Initial support for timestamp PI. From now you
9663   can use &lt;?dbtimestamp format="Y-m-d H:M:S"?&gt; to get current
9664   datetime in your document. Added localization support for datetime PI
9665 </para>
9666 </listitem> 
9667 <listitem>
9668 <para>Added level 6 to test for <tag>section</tag> depth in
9669 section.level template so that
9670 section.title.level6.properties will be used for sections
9671 that are 6 deep or deeper. This should also cause a h6 to be
9672 created in html output.
9673 </para>
9674 </listitem> 
9675 <listitem>
9676 <para>Don't use SVG graphics if <parameter>use.svg</parameter>=0
9677 </para>
9678 </listitem> 
9679 <listitem>
9680 <para>Now uses number-and-title-template for sections
9681   only if <parameter>section.autolabel</parameter> is not zero.
9682 </para>
9683 </listitem> 
9684 <listitem>
9685 <para>Added missing 'english-language-name' attribute to
9686 the l10n element, and the missing 'style' attribute to the
9687 template element so the current gentext documents will
9688 validate.
9689 </para>
9690 </listitem> 
9691 <listitem>
9692 <para>Corrected several references to parameter
9693   <parameter>qanda.defaultlabel</parameter> that were missing the "$".
9694 </para>
9695 </listitem> 
9696 <listitem>
9697 <para>Now accepts <parameter>admon.textlabel</parameter> parameter to turn off
9698   Note, Warning, etc. label.
9699 </para>
9700 </listitem> 
9701 <listitem>
9702 <para>FeatReq #684561: support more XEP metadata
9703 </para>
9704 </listitem> 
9705 <listitem>
9706 <para>Added hyphenation support. Added support for <tag>coref</tag>.
9707 Added <tag>beginpage</tag> support. (does nothing; see TDG).
9708 </para>
9709 </listitem> 
9710 <listitem>
9711 <para>Added support for
9712 hyphenation-character, hyphenation-push-character-count, and
9713 hyphenation-remain-character-count
9714 </para>
9715 </listitem> 
9716 <listitem>
9717 <para>Added <parameter>root.properties</parameter>,
9718 <parameter>ebnf.assignment</parameter>,
9719 and <parameter>ebnf.statement.terminator</parameter>
9720 </para>
9721 </listitem> 
9722 <listitem>
9723 <para>Support bgcolor PI in table cells; make sure
9724 rowsep and colsep don't have any effect on the last row or
9725 column
9726 </para>
9727 </listitem> 
9728 <listitem>
9729 <para>Handle <tag>othercredit</tag> on titlepage a little
9730 better
9731 </para>
9732 </listitem> 
9733 <listitem>
9734 <para>Applied fix from Jeff Beal that fixed the bug
9735 that put secondary page numbers on primary entries. Same
9736 with tertiary page numbers on secondary entries.
9737 </para>
9738 </listitem> 
9739 <listitem>
9740 <para>Added definition of missing variable
9741 <parameter>collection</parameter>.
9742 </para>
9743 </listitem> 
9744 <listitem>
9745 <para>Make <tag>footnote</tag> formatting 'normal' even when it
9746 occurs in a context that has special formatting
9747 </para>
9748 </listitem> 
9749 <listitem>
9750 <para>Added warning when <parameter>glossary.collection</parameter> is not
9751 blank, but it cannot open the specified file.
9752 </para>
9753 </listitem> 
9754 <listitem>
9755 <para>Pick up the frame attribute on <tag>table</tag> and
9756 <tag>informaltable</tag>.
9757 </para>
9758 </listitem> 
9759 <listitem>
9760 <para><tag>indexdiv</tag>/<tag>title</tag>
9761 in non-autogenerated indexes are
9762 now picked up.
9763 </para>
9764 </listitem> 
9765 <listitem>
9766 <para>Removed (unused)
9767 component.title.properties
9768 </para>
9769 </listitem> 
9770 <listitem>
9771 <para>Move IDs from
9772 page-sequences down to titlepage blocks
9773 </para>
9774 </listitem> 
9775 <listitem>
9776 <para>Use
9777 proportional-column-width(1) on more <tag>table</tag>s.
9778 </para>
9779 <para>Use proportional-column-width() for
9780 header/footer tables; suppress relative-align when when
9781 using FOP
9782 </para>
9783 </listitem> 
9784 <listitem>
9785 <para>Check for <parameter>glossterm.auto.link</parameter> when linking
9786 firstterms; don't output gl. prefix on glossterm links
9787 </para>
9788 </listitem> 
9789 <listitem>
9790 <para>Generate Part ToCs
9791 </para>
9792 </listitem> 
9793 <listitem>
9794 <para>Support <tag>glossary</tag>, <tag>bibliography</tag>,
9795 and <tag>index</tag> in component ToCs.
9796 </para>
9797 </listitem> 
9798 <listitem>
9799 <para>Refactored chunking code so that
9800 customization of chunk algorithm and chunk elements is more
9801 practical
9802 </para>
9803 </listitem> 
9804 <listitem>
9805 <para>Support <tag>textobject</tag>/<tag>phrase</tag>
9806 on <tag>inlinemediaobject</tag>.
9807 </para>
9808 </listitem> 
9809 <listitem>
9810 <para>Support 'start' PI on ordered lists
9811 </para>
9812 </listitem> 
9813 <listitem>
9814 <para>Fixed test of $toc PI to turn on qandaset TOC.
9815 </para>
9816 </listitem> 
9817 <listitem>
9818 <para>Added process.chunk.footnotes to sect2 through
9819 5 to fix bug of missing footnotes when chunk level greater
9820 than 1.
9821 </para>
9822 </listitem> 
9823 <listitem>
9824 <para>Added
9825 paramater <parameter>toc.max.depth</parameter> which controls maximal depth of ToC
9826 as requested by PHP-DOC group.
9827 </para>
9828 </listitem> 
9829 <listitem>
9830 <para>Exempted <tag>titleabbrev</tag> from preamble processing in
9831 lists, and fixed variablelist preamble code to use the same
9832 syntax as the other lists.
9833 </para>
9834 </listitem> 
9835 <listitem>
9836 <para>Added support for elements between variablelist
9837 and first varlistentry since DocBook 4.2 supports that now.
9838 </para>
9839 </listitem>
9840 </itemizedlist> 
9841 </sect1>
9842 <sect1 xml:id="V1601">
9843 <title>Release 1.60.1</title> 
9844 <itemizedlist>
9845 <para>Lots of bug fixes.</para> 
9846 <listitem>
9847 <para>The format of the <filename>titlepage.templates.xml</filename> files and
9848 the stylesheet that transforms them have been significantly changed. All of the
9849 attributes used to control the templates are now namespace qualified. So what
9850 used to be:</para> 
9851 <programlisting>&lt;t:titlepage element="article" wrapper="fo:block"&gt;</programlisting>
9852 <para>is now:</para> 
9853 <programlisting>&lt;t:titlepage t:element="article" t:wrapper="fo:block"&gt;</programlisting>
9854 <para>Attributes from other namespaces (including those that are unqualified) are
9855 now copied directly through. In practice, this means that the names that used
9856 to be <quote>fo:</quote> qualified:</para> 
9857 <programlisting>&lt;title named-template="component.title"
9858        param:node="ancestor-or-self::article[1]"
9859        fo:text-align="center"
9860        fo:keep-with-next="always"
9861        fo:font-size="&amp;hsize5;"
9862        fo:font-weight="bold"
9863        fo:font-family="{$title.font.family}"/&gt;</programlisting>
9864 <para>are now unqualified:</para> 
9865 <programlisting>&lt;title t:named-template="component.title"
9866        param:node="ancestor-or-self::article[1]"
9867        text-align="center"
9868        keep-with-next="always"
9869        font-size="&amp;hsize5;"
9870        font-weight="bold"
9871        font-family="{$title.font.family}"/&gt;</programlisting>
9872 <para>The <tag>t:titlepage</tag> and <tag>t:titlepage-content</tag>
9873 elements both generate wrappers now. And unqualified attributes on those elements
9874 are passed through. This means that you can now make the title font apply to
9875 ane entire titlepage and make the entire <quote>recto</quote>
9876 titlepage centered by specifying the font and alignment on the those elements:</para> 
9877 <programlisting>&lt;t:titlepage t:element="article" t:wrapper="fo:block"
9878              font-family="{$title.font.family}"&gt;
9879
9880   &lt;t:titlepage-content t:side="recto"
9881              text-align="center"&gt;</programlisting>
9882
9883
9884
9885
9886
9887 </listitem> 
9888 <listitem>
9889 <para>Support use of <tag>titleabbrev</tag> in running
9890 headers and footers.
9891 </para>
9892 </listitem> 
9893 <listitem>
9894 <para>Added (experimental) <parameter>xref.with.number.and.title</parameter>
9895 parameter to enable number/title cross references even when the
9896 default would
9897 be just the number.
9898 </para>
9899 </listitem> 
9900 <listitem>
9901 <para>Generate <tag>part</tag> ToCs if they're requested.
9902 </para>
9903 </listitem> 
9904 <listitem>
9905 <para>Use proportional-column-width() in header/footer tables.
9906 </para>
9907 </listitem> 
9908 <listitem>
9909 <para>Handle alignment correctly when <tag>screenshot</tag>
9910 wraps a graphic in a <tag>figure</tag>.
9911 </para>
9912 </listitem> 
9913 <listitem>
9914 <para>Format <tag>chapter</tag> and <tag>appendix</tag>
9915 cross references consistently.
9916 </para>
9917 </listitem> 
9918 <listitem>
9919 <para>Attempt to support tables with multiple <tag>tgroup</tag>s
9920 in FO.
9921 </para>
9922 </listitem> 
9923 <listitem>
9924 <para>Output <tag>fo:table-columns</tag> in
9925 <tag>simplelist</tag> tables.
9926 </para>
9927 </listitem> 
9928 <listitem>
9929 <para>Use <filename>titlepage.templates.xml</filename> for
9930 <tag>indexdiv</tag> and <tag>glossdiv</tag> formatting.
9931 </para>
9932 </listitem> 
9933 <listitem>
9934 <para>Improve support for new bibliography elements.
9935 </para>
9936 </listitem> 
9937 <listitem>
9938 <para>Added
9939 <parameter>footnote.number.format</parameter>,
9940 <parameter>table.footnote.number.format</parameter>,
9941 <parameter>footnote.number.symbols</parameter>, and
9942 <parameter>table.footnote.number.symbols</parameter> for better control of
9943 footnote markers.
9944 </para>
9945 </listitem> 
9946 <listitem>
9947 <para>Added <tag>glossentry.show.acronyms</tag>.
9948 </para>
9949 </listitem> 
9950 <listitem>
9951 <para>Suppress the draft-mode page masters when
9952 <parameter>draft-mode</parameter> is <quote>no</quote>.
9953 </para>
9954 </listitem> 
9955 <listitem>
9956 <para>Make blank pages verso not recto. D'Oh!
9957 </para>
9958 </listitem> 
9959 <listitem>
9960 <para>Improved formatting of <tag>ulink</tag> footnotes.
9961 </para>
9962 </listitem> 
9963 <listitem>
9964 <para>Fixed bugs in graphic width/height calculations.
9965 </para>
9966 </listitem> 
9967 <listitem>
9968 <para>Added class attributes to inline elements.
9969 </para>
9970 </listitem> 
9971 <listitem>
9972 <para>Don't add <quote>.html</quote> to the filenames identified
9973 with the <quote>dbhtml</quote> PI.
9974 </para>
9975 </listitem> 
9976 <listitem>
9977 <para>Don't force a ToC when sections contain <tag>refentry</tag>s.
9978 </para>
9979 </listitem> 
9980 <listitem>
9981 <para>Make section title sizes a function of the
9982 <parameter>body.master.size</parameter>.
9983 </para>
9984 </listitem> 
9985 </itemizedlist> 
9986 </sect1>
9987 <sect1 xml:id="V1592">
9988 <title>Release 1.59.2</title> 
9989 <itemizedlist>
9990 <para>The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail.
9991 </para> 
9992 <listitem>
9993 <para>Removed the region-name from the region-body of blank pages. There's
9994 no reason to give the body of blank pages a unique name and doing so causes
9995 a mismatch that FOP detects.
9996 </para>
9997 </listitem> 
9998 <listitem>
9999 <para>Output IDs for the first paragraphs in listitems.
10000 </para>
10001 </listitem> 
10002 <listitem>
10003 <para>Fixed some small bugs in the handling of page numbers in double-sided mode.
10004 </para>
10005 </listitem> 
10006 <listitem>
10007 <para>Attempt to prevent duplicated IDs from being produced when
10008 <tag class="attribute">endterm</tag> on <tag>xref</tag> points
10009 to something with nested structure.
10010 </para>
10011 </listitem> 
10012 <listitem>
10013 <para>Fix aligment problems in <tag>equation</tag>s.
10014 </para>
10015 </listitem> 
10016 <listitem>
10017 <para>Output the type attribute on unordered lists (UL) in HTML only if
10018 the css.decoration parameter is true.
10019 </para>
10020 </listitem> 
10021 <listitem>
10022 <para>Calculate the font size in formal.title.properties so that it's 1.2 times
10023 the base font size, not a fixed "12pt".
10024 </para>
10025 </listitem>
10026 </itemizedlist> 
10027 </sect1>
10028 <sect1 xml:id="V1591">
10029 <title>Release 1.59.1</title> 
10030 <itemizedlist>
10031 <para>The 1.59.1 fixes a few bugs.
10032 </para> 
10033 <listitem>
10034 <para>Added Bulgarian localization.
10035 </para>
10036 </listitem> 
10037 <listitem>
10038 <para>Indexing improvements; localize book indexes to books but allow setindex
10039 to index an entire set.
10040 </para>
10041 </listitem> 
10042 <listitem>
10043 <para>The default value for rowsep and colsep is now "1" as per CALS.
10044 </para>
10045 </listitem> 
10046 <listitem>
10047 <para>Added support for <tag>titleabbrev</tag> (use them for cross
10048 references).
10049 </para>
10050 </listitem> 
10051 <listitem>
10052 <para>Improvements to <tag>mediaobject</tag> for selecting print vs. online
10053 images.
10054 </para>
10055 </listitem> 
10056 <listitem>
10057 <para>Added seperate property sets for <tag>figure</tag>s,
10058 <tag>example</tag>s, <tag>equation</tag>s, <tag>tables</tag>s,
10059 and <tag>procedure</tag>s.
10060 </para>
10061 </listitem> 
10062 <listitem>
10063 <para>Make <tag>lineannotation</tag>s italic.
10064 </para>
10065 </listitem> 
10066 <listitem>
10067 <para>Support <tag class="attribute">xrefstyle</tag> attribute.
10068 </para>
10069 </listitem> 
10070 <listitem>
10071 <para>Make <tag class="attribute">endterm</tag> on
10072 <tag>xref</tag> higher priority than
10073 <tag class="attribute">xreflabel</tag> target.
10074 </para>
10075 </listitem> 
10076 <listitem>
10077 <para>Glossary formatting improvements.
10078 </para>
10079 </listitem>
10080 </itemizedlist> 
10081 </sect1>
10082 <sect1 xml:id="V1580">
10083 <title>Release 1.58.0</title> 
10084 <itemizedlist>
10085 <para>The 1.58.0 adds some initial support for extensions in xsltproc, adds
10086 a few features, and fixes bugs.
10087 </para> 
10088 <listitem>
10089 <para>This release contains the first attempt at extension support for xsltproc.
10090 The only extension available to date is the one that adjusts table column widths.
10091 Run <filename>extensions/xsltproc/python/xslt.py</filename>.
10092 </para>
10093 </listitem> 
10094 <listitem>
10095 <para>Fixed bugs in calculation of adjusted column widths to correct for rounding
10096 errors.
10097 </para>
10098 </listitem> 
10099 <listitem>
10100 <para>Support nested <tag>refsection</tag> elements correctly.
10101 </para>
10102 </listitem> 
10103 <listitem>
10104 <para>Reworked <literal>gentext.template</literal> to take context into consideration.
10105 The name of elements in localization files is now an xpath-like context list, not
10106 just a simple name.
10107 </para>
10108 </listitem> 
10109 <listitem>
10110 <para>Made some improvements to bibliography formatting.
10111 </para>
10112 </listitem> 
10113 <listitem>
10114 <para>Improved graphical formatting of admonitions.
10115 </para>
10116 </listitem> 
10117 <listitem>
10118 <para>Added support for <tag>entrytbl</tag>.
10119 </para>
10120 </listitem> 
10121 <listitem>
10122 <para>Support spanning index terms.
10123 </para>
10124 </listitem> 
10125 <listitem>
10126 <para>Support <tag>bibliosource</tag>.
10127 </para>
10128 </listitem>
10129 </itemizedlist> 
10130 </sect1>
10131 <sect1 xml:id="V1570">
10132 <title>Release 1.57.0</title>
10133 <itemizedlist>
10134 <listitem>
10135 <para>The 1.57.0 release wasn't documented here. Oops.
10136 </para>
10137 </listitem>
10138 </itemizedlist> 
10139 </sect1>
10140 <sect1 xml:id="V1560">
10141 <title>Release 1.56.0</title> 
10142 <itemizedlist>
10143 <para>The 1.56.0 release fixes bugs.
10144 </para> 
10145 <listitem>
10146 <para>Reworked chunking. <emphasis>This will break all existing customizations
10147 layers that change the chunking algorithm.</emphasis> If you're customizing chunking,
10148 look at the new <quote>content</quote> parameter that's passed to
10149 <literal>process-chunk-element</literal> and friends.
10150 </para>
10151 </listitem> 
10152 <listitem>
10153 <para>Support continued and inherited numeration in <tag>orderedlist</tag>
10154 formatting for FOs.
10155 </para>
10156 </listitem> 
10157 <listitem>
10158 <para>Added Thai localization.
10159 </para>
10160 </listitem> 
10161 <listitem>
10162 <para>Tweaked stylesheet documentation stylesheets to link to TDG and
10163 the parameter references.
10164 </para>
10165 </listitem> 
10166 <listitem>
10167 <para>Allow title on tables of contents ("Table of Contents") to be optional.
10168 Added new keyword to <parameter>generate.toc</parameter>.
10169 Support tables of contents on sections.
10170 </para>
10171 </listitem> 
10172 <listitem>
10173 <para>Made separate parameters for table borders and table cell borders:
10174 <parameter>table.frame.border.color</parameter>,
10175 <parameter>table.frame.border.style</parameter>,
10176 <parameter>table.frame.border.thickness</parameter>,
10177 <parameter>table.cell.border.color</parameter>,
10178 <parameter>table.cell.border.style</parameter>, and
10179 <parameter>table.cell.border.thickness</parameter>.
10180 </para>
10181 </listitem> 
10182 <listitem>
10183 <para>Suppress formatting of <quote>endofrange</quote> <tag>indexterm</tag>s.
10184 This is only half-right. They should generate a range, but I haven't figured out how
10185 to do that yet.
10186 </para>
10187 </listitem> 
10188 <listitem>
10189 <para>Support <tag>revdescription</tag>. (Bug #582192)
10190 </para>
10191 </listitem> 
10192 <listitem>
10193 <para>Added <parameter>default.float.class</parameter> and fixed figure
10194 floats. (Bug #497603)
10195 </para>
10196 </listitem> 
10197 <listitem>
10198 <para>Fixed formatting of <tag>sbr</tag> in FOs.
10199 </para>
10200 </listitem> 
10201 <listitem>
10202 <para>Added context to the <quote>missing template</quote> error message.
10203 </para>
10204 </listitem> 
10205 <listitem>
10206 <para>Process <tag>arg</tag> correctly in a <tag>group</tag>.
10207 (Bug #605150)
10208 </para>
10209 </listitem> 
10210 <listitem>
10211 <para>Removed 'keep-with-next' from <parameter>formal.title.properties</parameter>
10212 attribute set now that the stylesheets support the option of putting
10213 such titles below the object. Now the $placement value determines if
10214 'keep-with-next' or 'keep-with-previous' is used in the title block.
10215 </para>
10216 </listitem> 
10217 <listitem>
10218 <para>Wrap <quote>url()</quote> around external-destinations when appropriate.
10219 </para>
10220 </listitem> 
10221 <listitem>
10222 <para>Fixed typo in compact list spacing. (Bug #615464)
10223 </para>
10224 </listitem> 
10225 <listitem>
10226 <para>Removed spurious hash in anchor name. (Bug #617717)
10227 </para>
10228 </listitem> 
10229 <listitem>
10230 <para>Address is now displayed verbatim on title pages. (Bug #618600)
10231 </para>
10232 </listitem> 
10233 <listitem>
10234 <para>The <parameter>bridgehead.in.toc</parameter> parameter is now properly
10235 supported.
10236 </para>
10237 </listitem> 
10238 <listitem>
10239 <para>Improved effectiveness of HTML cleanup by increasing the number
10240 of places where it is used. Improve use of HTML cleanup in XHTML stylesheets.
10241 </para>
10242 </listitem> 
10243 <listitem>
10244 <para>Support table of contents for <tag>appendix</tag> in
10245 <tag>article</tag>. (Bug #596599)
10246 </para>
10247 </listitem> 
10248 <listitem>
10249 <para>Don't duplicate footnotes in <tag>bibliography</tag>s and
10250 <tag>glossary</tag>s. (Bug #583282)
10251 </para>
10252 </listitem> 
10253 <listitem>
10254 <para>Added <parameter>default.image.width</parameter>. (Bug #516859)
10255 </para>
10256 </listitem> 
10257 <listitem>
10258 <para>Totally reworked <tag>funcsynopsis</tag> code; it now
10259 supports a 'tabular' presentation style for 'wide' prototypes; see
10260 <parameter>funcsynopsis.tabular.threshold</parameter>. (HTML only
10261 right now, I think, FO support, uh, real soon now.)
10262 </para>
10263 </listitem> 
10264 <listitem>
10265 <para>Reworked support for difference marking; toned down the colors a bit
10266 and added a <quote>system.head.content</quote> template so that the diff CSS
10267 wasn't overriding <quote>user.head.content</quote>. (Bug #610660)
10268 </para>
10269 </listitem> 
10270 <listitem>
10271 <para>Added call to the <quote>*.head.content</quote> elements when writing
10272 out long description chunks.
10273 </para>
10274 </listitem> 
10275 <listitem>
10276 <para>Make sure <tag>legalnotice</tag> link is correct even when
10277 chunking to a different <parameter>base.dir</parameter>.
10278 </para>
10279 </listitem> 
10280 <listitem>
10281 <para>Use CSS to set viewport characteristics if
10282 <parameter>css.decoration</parameter> is non-zero, use div instead of p for making
10283 graphic a block element; make figure <tag>title</tag>s the
10284 default alt
10285 text for images in a <tag>figure</tag>.</para>
10286 </listitem> 
10287 <listitem>
10288 <para>Added space-after to <parameter>list.block.spacing</parameter>.
10289 </para>
10290 </listitem> 
10291 <listitem>
10292 <para>Reworked section.level template to give <quote>correct</quote> answer
10293 instead of being off by one.
10294 </para>
10295 </listitem> 
10296 <listitem>
10297 <para>When processing tables, use the <tag class="attribute">tabstyle</tag>
10298 attribute as the division class.
10299 </para>
10300 </listitem> 
10301 <listitem>
10302 <para>Fixed bug in <filename>html2xhtml.xsl</filename> that was causing the
10303 XHTML chunker to output HTML instead of XHTML.
10304 </para>
10305 </listitem>
10306 </itemizedlist> 
10307 </sect1>
10308 <sect1 xml:id="VOlder">
10309   <title>Older releases</title>
10310   <para>To view the release notes for older releases, see <uri xlink:href="http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml">http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml</uri>. Be
10311   aware that there were no release notes for releases prior to the
10312   1.50.0 release.</para>
10313 </sect1>
10314 <sect1 xml:id="dot0">
10315   <title>About dot-zero releases</title>
10316     <para>DocBook Project “dot zero” releases should be
10317     considered <emphasis>experimental</emphasis> and are always
10318     followed by stable “dot one plus” releases, usually within
10319     two or three weeks. Please help to ensure the stability of
10320     “dot one plus” releases by carefully testing each
10321     “dot zero” release and reporting back about any
10322     problems you find. </para>
10323     <para>It is not recommended that you use a “dot zero”
10324     release in a production system. Instead, you should wait for
10325     the “dot one” or greater versions.</para>
10326   </sect1>
10327 </article>