1 <article xmlns="http://docbook.org/ns/docbook"
\r
2 xmlns:xlink="http://www.w3.org/1999/xlink"
\r
3 xmlns:xi="http://www.w3.org/2001/XInclude"
\r
4 xml:lang="en" xml:id="releasenotes"
\r
8 <title>Release Notes for the DocBook XSL Stylesheets</title>
\r
9 <pubdate><?dbtimestamp format="Y-m-d"?></pubdate>
\r
10 <releaseinfo role="cvs">$Revision: 8504 $ $Date: 2009-07-21 07:22:11 -0700 (Tue, 21 Jul 2009) $</releaseinfo>
\r
11 <!-- * <author><orgname>DocBook Project Development Team</orgname></author> -->
\r
13 <para condition="dot-zero;dot-one-plus">This release-notes
\r
14 document is available in the following formats:
\r
16 xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.html"
\r
19 xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.pdf"
\r
22 xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.txt"
\r
23 >plain text</link>; it provides a per-release list
\r
24 of enhancements and changes to the stylesheets’ public APIs
\r
25 (user-configurable parameters) and excludes descriptions of most
\r
26 bug fixes. For a complete list of all changes (including all bug
\r
27 fixes) that have been made since the previous release, see the
\r
28 separate <link xlink:href="NEWS">NEWS</link> (plain text) or <link
\r
29 xlink:href="NEWS.html">NEWS.html</link> files. Also available:
\r
31 xlink:href="http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/xsl/?view=log"
\r
32 >hyperlinked change history</link> (warning: big file) of all
\r
33 changes made over the entire history of the codebase.</para>
\r
34 <para condition="dot-zero">As with all DocBook Project <link
\r
35 linkend="dot0">dot-zero</link> releases, this is an
\r
36 experimental release. It will be followed shortly by a stable
\r
38 <para condition="dot-one-plus">As with all DocBook Project “dot
\r
39 one plus” releases, this release aspires to be stable (in
\r
40 contrast to <link linkend="dot0">dot-zero</link> releases, which
\r
41 are experimental).</para>
\r
42 <para condition="snapshot">This is a pre-release “snapshot” of the
\r
43 DocBook XSL Stylesheets. The change information in the first
\r
44 section of this file
\r
45 (for “<xi:include href="NEWS.xml" xpointer="xpointer(/article/sect1/title/text())"/>”) is
\r
46 auto-generated from change descriptions stored in the project
\r
47 source-code repository.</para>
\r
48 <para condition="snapshot">That means the first section contains
\r
49 descriptions both of bug fixes and of feature changes. The
\r
50 remaining sections are manually edited changelog subsets that
\r
51 exclude bug-fix descriptions – that is, trimmed down to just those
\r
52 those descriptions that document enhancements and changes to the
\r
53 public APIs (user-configurable parameters).</para>
\r
57 <sect1 condition="snapshot" xml:id="current">
\r
58 <xi:include href="NEWS.xml" xpointer="xpointer(/article/sect1/*)"/>
\r
60 <sect1 xml:id="rn_V1.75.2">
\r
61 <title>Release Notes: 1.75.2</title>
\r
62 <para>The following is a list of changes that have been made
\r
63 since the 1.75.1 release.</para>
\r
65 <sect2 xml:id="rn_V1.75.2_Gentext">
\r
66 <title>Gentext</title>
\r
67 <para>The following changes have been made to the
\r
68 <filename>gentext</filename> code
\r
69 since the 1.75.1 release.</para>
\r
72 <para><literal>dleidert: locale/ja.xml</literal></para><screen><phrase role="commit-message">Improved Japanese translation for Note(s). Closes bug #2823965.</phrase></screen>
\r
75 <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>
\r
78 <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>
\r
81 <para><literal>Robert Stayton: locale/is.xml</literal></para><screen><phrase role="commit-message">New Icelandic locale file.</phrase></screen>
\r
84 </sect2><!--end of Gentext changes for 1.75.2-->
\r
86 <sect2 xml:id="rn_V1.75.2_Common">
\r
87 <title>Common</title>
\r
88 <para>The following changes have been made to the
\r
89 <filename>common</filename> code
\r
90 since the 1.75.1 release.</para>
\r
93 <para><literal>Norman Walsh: stripns.xsl</literal></para><screen><phrase role="commit-message">Support more downconvert cases</phrase></screen>
\r
96 <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>
\r
99 </sect2><!--end of Common changes for 1.75.2-->
\r
101 <sect2 xml:id="rn_V1.75.2_FO">
\r
103 <para>The following changes have been made to the
\r
104 <filename>fo</filename> code
\r
105 since the 1.75.1 release.</para>
\r
108 <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>
\r
111 </sect2><!--end of FO changes for 1.75.2-->
\r
113 <sect2 xml:id="rn_V1.75.2_HTML">
\r
114 <title>HTML</title>
\r
115 <para>The following changes have been made to the
\r
116 <filename>html</filename> code
\r
117 since the 1.75.1 release.</para>
\r
120 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Output "<tag>Copyright</tag>" heading in XHTML too.</phrase></screen>
\r
123 <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>
\r
126 <para><literal>Norman Walsh: htmltbl.xsl</literal></para><screen><phrase role="commit-message">Remove ambiguity wrt @span, @rowspan, and @colspan</phrase></screen>
\r
129 </sect2><!--end of HTML changes for 1.75.2-->
\r
131 <sect2 xml:id="rn_V1.75.2_Manpages">
\r
132 <title>Manpages</title>
\r
133 <para>The following changes have been made to the
\r
134 <filename>manpages</filename> code
\r
135 since the 1.75.1 release.</para>
\r
138 <para><literal>Mauritz Jeanson: endnotes.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space() for ulink content. Closes bug #2793877.</phrase></screen>
\r
141 <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>
\r
144 </sect2><!--end of Manpages changes for 1.75.2-->
\r
146 <sect2 xml:id="rn_V1.75.2_Epub">
\r
147 <title>Epub</title>
\r
148 <para>The following changes have been made to the
\r
149 <filename>epub</filename> code
\r
150 since the 1.75.1 release.</para>
\r
153 <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>
\r
156 <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>
\r
159 </sect2><!--end of Epub changes for 1.75.2-->
\r
161 <sect2 xml:id="rn_V1.75.2_Profiling">
\r
162 <title>Profiling</title>
\r
163 <para>The following changes have been made to the
\r
164 <filename>profiling</filename> code
\r
165 since the 1.75.1 release.</para>
\r
168 <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>
\r
171 </sect2><!--end of Profiling changes for 1.75.2-->
\r
173 <sect2 xml:id="rn_V1.75.2_XSL-Saxon">
\r
174 <title>XSL-Saxon</title>
\r
175 <para>The following changes have been made to the
\r
176 <filename>xsl-saxon</filename> code
\r
177 since the 1.75.1 release.</para>
\r
180 <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>
\r
183 </sect2><!--end of XSL-Saxon changes for 1.75.2-->
\r
185 <sect2 xml:id="rn_V1.75.2_XSL-Xalan">
\r
186 <title>XSL-Xalan</title>
\r
187 <para>The following changes have been made to the
\r
188 <filename>xsl-xalan</filename> code
\r
189 since the 1.75.1 release.</para>
\r
192 <para><literal>Mauritz Jeanson: nbproject/project.xml</literal></para><screen><phrase role="commit-message">Added missing NetBeans configuration.</phrase></screen>
\r
195 </sect2><!--end of XSL-Xalan changes for 1.75.2-->
\r
200 <sect1 xml:id="rn_V1.75.1">
\r
201 <title>Release Notes: 1.75.1</title>
\r
202 <para>This release includes bug fixes.</para>
\r
204 <para>The following is a list of changes that have been made since the 1.75.0 release.</para>
\r
207 <sect2 xml:id="rn_V1.75.1_FO">
\r
209 <para>The following changes have been made to the <filename>fo</filename> code since the 1.75.0 release.</para>
\r
212 <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>
\r
215 <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>
\r
218 </sect2><!--end of FO changes for 1.75.1-->
\r
220 <sect2 xml:id="rn_V1.75.1_HTML">
\r
221 <title>HTML</title>
\r
222 <para>The following changes have been made to the
\r
223 <filename>html</filename> code
\r
224 since the 1.75.0 release.</para>
\r
227 <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>
\r
230 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed bug 2789678: apply-templates line accidentally deleted.</phrase></screen>
\r
233 </sect2><!--end of HTML changes for 1.75.1-->
\r
235 <sect2 xml:id="rn_V1.75.1_Epub">
\r
236 <title>Epub</title>
\r
237 <para>The following changes have been made to the
\r
238 <filename>epub</filename> code
\r
239 since the 1.75.0 release.</para>
\r
242 <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>
\r
245 <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>
\r
248 <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>
\r
251 </sect2><!--end of Epub changes for 1.75.1-->
\r
253 <sect2 xml:id="rn_V1.75.1_Params">
\r
254 <title>Params</title>
\r
255 <para>The following changes have been made to the
\r
256 <filename>params</filename> code
\r
257 since the 1.75.0 release.</para>
\r
260 <para><literal>Mauritz Jeanson: highlight.source.xml</literal></para><screen><phrase role="commit-message">Updated documentation to reflect changes made in r8419.</phrase></screen>
\r
263 </sect2><!--end of Params changes for 1.75.1-->
\r
268 <sect1 xml:id="V1.75.0">
\r
269 <title>Release Notes: 1.75.0</title>
\r
270 <para>This release includes important bug fixes and adds the following
\r
271 significant feature changes:
\r
274 <term>Gentext</term>
\r
275 <listitem><para>Modifications to translations have been made. </para></listitem>
\r
279 <term>Common</term>
\r
281 <para>Added support for some format properties on tables using
\r
282 HTML <tag>table</tag> markup. </para>
\r
283 <para>Added two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections
\r
284 and numbered questions can be distinguished. Satisfies
\r
285 Feature Request #1539045.</para>
\r
286 <para>Added code to handle <tag>acknowledgements</tag> in <tag>book</tag> and part. The element is processed
\r
287 similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
\r
288 any dedications.</para>
\r
295 <para>The inclusion of highlighting code has been simplified.</para>
\r
296 <para>Add support for pgwide on informal objects.</para>
\r
297 <para>Added a new parameter, <parameter>bookmarks.collapse</parameter>, that controls the initial <tag>state</tag> of the bookmark tree. Closes FR #1792326.</para>
\r
298 <para>Add support for more dbfo processing instructions.</para>
\r
299 <para>Add new <parameter>variablelist.term.properties</parameter> to format terms, per request # 1968513.</para>
\r
300 <para>Add support for @width on <tag>screen</tag> and <tag>programlisting</tag>, fixes bug #2012736.</para>
\r
301 <para>Add support for writing-mode="rl-tb" (right-to-left) in FO outputs. </para>
\r
302 <para>Add <parameter>writing.mode</parameter> param for FO output.</para>
\r
308 <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>
\r
309 <para>Inclusion of highlighting code was simplified. Only one import is now necessary.</para>
\r
310 <para>Add new param <parameter>index.links.to.section</parameter>.</para>
\r
311 <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>
\r
317 <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>
\r
318 <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>
\r
319 <para>Added DocBook <tag>subjectset</tag> -> OPF dc:<tag>subject</tag> mapping and tests</para>
\r
320 <para>Added DocBook <tag>date</tag> -> OPF dc:date mapping and tests</para>
\r
321 <para>Added DocBook <tag>abstract</tag> -> OPF dc:description mapping and tests</para>
\r
322 <para>Added --output option to dbtoepub based on user request</para>
\r
327 <term>HTMLHelp</term>
\r
329 <para>Add support for generating <tag>olink</tag> target <tag>database</tag> for htmlhelp files.</para></listitem>
\r
334 <term>Params</term>
\r
336 <para>Add default setting for @rules attribute on HTML markup tables.</para>
\r
337 <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>
\r
338 <para>Add new <parameter>variablelist.term.properties</parameter> to format terms, per request # 1968513.</para>
\r
339 <para>Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections and numbered questions can be distinguished. Satisfies Feature Request #1539045.</para>
\r
340 <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>
\r
341 <para>New attribute list for <tag>glossentry</tag> in <tag>glossary</tag>.</para>
\r
342 <para>New parameter to support @width on <tag>programlisting</tag> and <tag>screen</tag>.</para>
\r
343 <para>Add attribute-sets for formatting <tag>glossary</tag> terms and defs.</para>
\r
347 <term>Highlighting</term>
\r
349 <para>Inclusion of highlighting code was simplified. Only one import is now necessary.</para>
\r
357 <para>The following is a list of changes that have been made
\r
358 since the 1.74.3 release.</para>
\r
360 <sect2 xml:id="rn_V1.75.0_Gentext">
\r
361 <title>Gentext</title>
\r
362 <para>The following changes have been made to the
\r
363 <filename>gentext</filename> code
\r
364 since the 1.74.3 release.</para>
\r
367 <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>
\r
370 <para><literal>Robert Stayton: locale/es.xml</literal></para><screen><phrase role="commit-message">Fix spelling errors in <tag>Acknowledgements</tag> entries.</phrase></screen>
\r
373 <para><literal>Robert Stayton: locale/es.xml</literal></para><screen><phrase role="commit-message">Check in translations for 4 elements submitted through docbook-apps
\r
374 message of 14 April 2009.</phrase></screen>
\r
377 <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>
\r
380 <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>
\r
383 <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>
\r
386 <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>
\r
389 <para><literal>Robert Stayton: locale/ru.xml</literal></para><screen><phrase role="commit-message">Checkin typo fix submitted in bug #2453406.</phrase></screen>
\r
392 </sect2><!--end of Gentext changes for 1.75.0-->
\r
394 <sect2 xml:id="rn_V1.75.0_Common">
\r
395 <title>Common</title>
\r
396 <para>The following changes have been made to the
\r
397 <filename>common</filename> code
\r
398 since the 1.74.3 release.</para>
\r
401 <para><literal>Robert Stayton: gentext.xsl</literal></para><screen><phrase role="commit-message">Fix extra generated space when xrefstyle includes 'nopage'.</phrase></screen>
\r
404 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support for some format properties on tables using
\r
405 HTML <tag>table</tag> markup. These include:
\r
406 - frame attribute on <tag>table</tag> (or uses $default.table.frame parameter).
\r
407 - rules attribute on <tag>table</tag> (or uses $default.table.rules parameter).
\r
408 - align attribute on <tag>td</tag> and <tag>th</tag>
\r
409 - valign attribute on <tag>td</tag> and <tag>th</tag>
\r
410 - colspan on <tag>td</tag> and <tag>th</tag>
\r
411 - rowspan on <tag>td</tag> and <tag>th</tag>
\r
412 - bgcolor on <tag>td</tag> and <tag>th</tag></phrase></screen>
\r
415 <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
\r
416 customization easier, per Feature Request 1828608.</phrase></screen>
\r
419 <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>
\r
420 generated from a <parameter>glossary.collection</parameter>.</phrase></screen>
\r
423 <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>
\r
426 <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>
\r
429 <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))".
\r
430 This enables proper formatting of inline elements in titles in TOCs,
\r
431 as long as these inlines don't have id or xml:id attributes.</phrase></screen>
\r
434 <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
\r
435 and numbered questions can be distinguished. Satisfies
\r
436 Feature Request #1539045.</phrase></screen>
\r
439 <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
\r
440 so Xalan bug is isolated.</phrase></screen>
\r
443 <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Added fixes for bugs #2112656 and #1759205:
\r
444 1. Reverted mistaken commits r7485 and r7523.
\r
445 2. Updated the template with match="<tag>link</tag>" and mode="no.anchor.mode" so that
\r
446 @endterm is used if it exists and if the <tag>link</tag> has no content.</phrase></screen>
\r
449 <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
\r
450 similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
\r
451 any dedications.</phrase></screen>
\r
454 <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>
\r
457 <para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787167 incorrect hot text for some olinks.</phrase></screen>
\r
460 <para><literal>Robert Stayton: common.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1669654 Broken output if <tag>copyright</tag> <<tag>year</tag>> contains a range.</phrase></screen>
\r
463 <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>
\r
466 </sect2><!--end of Common changes for 1.75.0-->
\r
468 <sect2 xml:id="rn_V1.75.0_FO">
\r
470 <para>The following changes have been made to the
\r
471 <filename>fo</filename> code
\r
472 since the 1.74.3 release.</para>
\r
475 <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>
\r
478 <para><literal>Robert Stayton: fop1.xsl</literal></para><screen><phrase role="commit-message">Add the new fop extensions namespace declaration, in case FOP
\r
479 extension functions are used.</phrase></screen>
\r
482 <para><literal>Robert Stayton: formal.xsl</literal></para><screen><phrase role="commit-message">Add support for pgwide on informal objects.</phrase></screen>
\r
485 <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Fixed spurious closing <tag>quote</tag> on line 134.</phrase></screen>
\r
488 <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
\r
489 new $exsl.node.set.available param in test.</phrase></screen>
\r
492 <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>
\r
495 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Fixed doc bug for row-height.</phrase></screen>
\r
498 <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>
\r
501 <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
\r
502 HTML <tag>table</tag> markup. These include:
\r
503 - frame attribute on <tag>table</tag> (or uses $default.table.frame parameter).
\r
504 - rules attribute on <tag>table</tag> (or uses $default.table.rules parameter).
\r
505 - align attribute on <tag>td</tag> and <tag>th</tag>
\r
506 - valign attribute on <tag>td</tag> and <tag>th</tag>
\r
507 - colspan on <tag>td</tag> and <tag>th</tag>
\r
508 - rowspan on <tag>td</tag> and <tag>th</tag>
\r
509 - bgcolor on <tag>td</tag> and <tag>th</tag></phrase></screen>
\r
512 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support bgcolor in <tag>td</tag> and <tag>th</tag>
\r
513 elements in HTML <tag>table</tag> markup.</phrase></screen>
\r
516 <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>
\r
517 elements in HTML <tag>table</tag> markup.</phrase></screen>
\r
520 <para><literal>Robert Stayton: param.xweb</literal></para><screen><phrase role="commit-message">Fix working of page-master left and right margins.</phrase></screen>
\r
523 <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>
\r
526 <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>
\r
529 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Add support for dbfo keep-together processing instruction for
\r
530 entire list instances.</phrase></screen>
\r
533 <para><literal>Robert Stayton: lists.xsl; block.xsl</literal></para><screen><phrase role="commit-message">Add support fo dbfo keep-together processing instruction to
\r
534 more blocks like list items and paras.</phrase></screen>
\r
537 <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>
\r
540 <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">In simple.xlink, rearrange order of processing.</phrase></screen>
\r
543 <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>
\r
546 <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
\r
547 other types of linking besides otherterm.</phrase></screen>
\r
550 <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>
\r
553 <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>
\r
554 so other element's titles will not be affected.</phrase></screen>
\r
557 <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>
\r
560 <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>
\r
563 <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
\r
564 extra processing of multiple editors. Fixes bug 2687842.</phrase></screen>
\r
567 <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
\r
568 now outputs that ID, so that <tag>index</tag> entries can be cross referenced to.</phrase></screen>
\r
571 <para><literal>Mauritz Jeanson: synop.xsl</literal></para><screen><phrase role="commit-message">Added modeless template for ooclass|oointerface|ooexception.
\r
572 Closes bug #1623468.</phrase></screen>
\r
575 <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>
\r
578 <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
\r
579 the <tag>link</tag> text if it has one.</phrase></screen>
\r
582 <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
\r
583 they can be <tag>xref</tag>'ed to.</phrase></screen>
\r
586 <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>.
\r
587 This assumes the <tag>author</tag> specifies something using xrefstyle since
\r
588 the elements don't have ordinary <tag>link</tag> text.</phrase></screen>
\r
591 <para><literal>Robert Stayton: toc.xsl</literal></para><screen><phrase role="commit-message">Fix bug in new <tag>toc</tag> templates.</phrase></screen>
\r
594 <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
\r
595 similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
\r
596 any dedications.</phrase></screen>
\r
599 <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>
\r
600 in all permitted contexts. Same for lot elements.
\r
601 This fixes bug #1595969 for FO outputs.</phrase></screen>
\r
604 <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>
\r
607 <para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Removed duplicate (<parameter>monospace.font.family</parameter>).</phrase></screen>
\r
610 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add <parameter>glossentry.list.item.properties</parameter>.</phrase></screen>
\r
613 <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>
\r
616 <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"
\r
617 when text direction is right to left because all program languages
\r
618 are left-to-right.</phrase></screen>
\r
621 <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>
\r
624 <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>
\r
627 <para><literal>Mauritz Jeanson: block.xsl</literal></para><screen><phrase role="commit-message">Added support for <tag>acknowledgements</tag> in <tag>article</tag>.
\r
628 Support in <tag>book</tag>/part remains to be added.</phrase></screen>
\r
631 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787167 incorrect hot text for some olinks.</phrase></screen>
\r
634 <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>
\r
637 <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.
\r
638 Changed instances of margin-left to margin-{$direction.align.start}
\r
639 and margin-right to margin-{$direction.align.end}. Those direction.align
\r
640 params are computed from the writing mode value in each locale's
\r
641 gentext key named 'writing-mode', introduced in 1.74.3 to add
\r
642 right-to-left support to HTML outputs.</phrase></screen>
\r
645 <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>
\r
648 <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>
\r
651 <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>
\r
652 instead of <tag>question</tag>, if available. For DocBook 5, use the <tag>info</tag> versions.</phrase></screen>
\r
655 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add better pointer to README for XSLTHL</phrase></screen>
\r
658 <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>
\r
661 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
\r
664 </sect2><!--end of FO changes for 1.75.0-->
\r
666 <sect2 xml:id="rn_V1.75.0_HTML">
\r
667 <title>HTML</title>
\r
668 <para>The following changes have been made to the
\r
669 <filename>html</filename> code
\r
670 since the 1.74.3 release.</para>
\r
673 <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
\r
674 div element for lists.</phrase></screen>
\r
677 <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
\r
678 to support dir, lang, and <tag>title</tag> attributes in html output for all elements.
\r
679 Fulfills feature request #1993833.</phrase></screen>
\r
682 <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
\r
683 when target html is in a subdirectory and dbhtml <tag>filename</tag> used.</phrase></screen>
\r
686 <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>
\r
689 <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
\r
690 new $exsl.node.set.available param in test.</phrase></screen>
\r
693 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Fixed doc bug for row-height.</phrase></screen>
\r
696 <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>
\r
699 <para><literal>Robert Stayton: lists.xsl; html.xsl; block.xsl</literal></para><screen><phrase role="commit-message">More elements get common.html.attributes.
\r
700 Added locale.html.attributes template which does the lang,
\r
701 dir, and <tag>title</tag> attributes, but not the class attribute
\r
702 (used on <tag>para</tag>, for example).</phrase></screen>
\r
705 <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
\r
706 easier customization.</phrase></screen>
\r
709 <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>
\r
712 <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">In simple.xlink, rearrange order of processing.</phrase></screen>
\r
715 <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>
\r
718 <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
\r
719 class, <tag>title</tag>, lang, and dir for most elements.
\r
720 Started adding it to some list and block elements.</phrase></screen>
\r
723 <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
\r
724 and numbered questions can be distinguished. Satisfies
\r
725 Feature Request #1539045.</phrase></screen>
\r
728 <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>
\r
731 <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
\r
732 duplicate entries with different ids can still have an id output.</phrase></screen>
\r
735 <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>
\r
738 <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
\r
739 the <tag>index</tag> <tag>entry</tag>, so that one could <tag>link</tag> to an <tag>index</tag> <tag>entry</tag>.
\r
740 You can't <tag>link</tag> to the id on an <tag>indexterm</tag> because that is
\r
741 used to place the main <tag>anchor</tag> in the text flow.</phrase></screen>
\r
744 <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
\r
745 precise links to indexterms in HTML output rather than to
\r
746 the <tag>section</tag> <tag>title</tag>.</phrase></screen>
\r
749 <para><literal>Mauritz Jeanson: synop.xsl</literal></para><screen><phrase role="commit-message">Added modeless template for ooclass|oointerface|ooexception.
\r
750 Closes bug #1623468.</phrase></screen>
\r
753 <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>,
\r
754 because it may be referenced in a <tag>TOC</tag> or <tag>xref</tag>.
\r
755 Before, the <tag>anchor</tag> was output by the <tag>title</tag>, but there was no
\r
756 <tag>anchor</tag> if there was no <tag>title</tag>.</phrase></screen>
\r
759 <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>
\r
762 <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
\r
763 the <tag>link</tag> text if it has one.</phrase></screen>
\r
766 <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>
\r
767 in a <tag>qandaentry</tag>, so such can be used for the <tag>alt</tag> text of an <tag>xref</tag>
\r
768 to a <tag>qandaentry</tag>.</phrase></screen>
\r
771 <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>,
\r
772 most useful when an xrefstyle is used.</phrase></screen>
\r
775 <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>
\r
776 in all permitted contexts. Same for lot elements.
\r
777 This fixes bug #1595969 for HTML outputs.</phrase></screen>
\r
780 <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
\r
781 similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
\r
782 any dedications.</phrase></screen>
\r
785 <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
\r
786 nesting of elements and <tag>seeie</tag> and <tag>seealsoie</tag>, as reported in
\r
787 bug # 1168912.</phrase></screen>
\r
790 <para><literal>Robert Stayton: autotoc.xsl</literal></para><screen><phrase role="commit-message">Fix <tag>simplesect</tag> in <tag>toc</tag> problem.</phrase></screen>
\r
793 <para><literal>Robert Stayton: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add support for @width per bug report #2012736.</phrase></screen>
\r
796 <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>
\r
799 <para><literal>Robert Stayton: param.xweb</literal></para><screen><phrase role="commit-message">Move writing-mode param.</phrase></screen>
\r
802 <para><literal>Keith Fahlgren: refentry.xsl</literal></para><screen><phrase role="commit-message">Remove a nesting of <p> inside <p> for <tag>refclass</tag> (made XHTML* invalid, made HTML silly)</phrase></screen>
\r
805 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1945872 to allow passthrough of colwidth values to
\r
806 HTML <tag>table</tag> when no <parameter>tablecolumns.extension</parameter> is available and
\r
807 when no instance of * appears in the <tag>table</tag>'s colspecs.</phrase></screen>
\r
810 <para><literal>Mauritz Jeanson: block.xsl</literal></para><screen><phrase role="commit-message">Added support for <tag>acknowledgements</tag> in <tag>article</tag>.
\r
811 Support in <tag>book</tag>/part remains to be added.</phrase></screen>
\r
814 <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>
\r
817 <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>
\r
818 instead of <tag>question</tag>, if available. For DocBook 5, use the <tag>info</tag> versions.</phrase></screen>
\r
821 <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>
\r
824 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add better pointer to README for XSLTHL</phrase></screen>
\r
827 <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>
\r
830 <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>
\r
833 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
\r
836 </sect2><!--end of HTML changes for 1.75.0-->
\r
838 <sect2 xml:id="rn_V1.75.0_Manpages">
\r
839 <title>Manpages</title>
\r
840 <para>The following changes have been made to the
\r
841 <filename>manpages</filename> code
\r
842 since the 1.74.3 release.</para>
\r
845 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Convert function-available test for node-set() <tag>function</tag> to
\r
846 test of $exsl.node.set.available param.</phrase></screen>
\r
849 <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>
\r
852 </sect2><!--end of Manpages changes for 1.75.0-->
\r
854 <sect2 xml:id="rn_V1.75.0_Epub">
\r
855 <title>ePub</title>
\r
856 <para>The following changes have been made to the
\r
857 <filename>epub</filename> code
\r
858 since the 1.74.3 release.</para>
\r
861 <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>
\r
864 <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>
\r
867 <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>
\r
870 <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>
\r
873 <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Be a little bit more nuanced about dates</phrase></screen>
\r
876 <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> -> OPF dc:<tag>subject</tag> mapping and tests</phrase></screen>
\r
879 <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> -> OPF dc:date mapping and tests</phrase></screen>
\r
882 <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> -> OPF dc:description mapping and tests</phrase></screen>
\r
885 <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
\r
886 to dc:creator element.</phrase></screen>
\r
889 <para><literal>Keith Fahlgren: bin/dbtoepub</literal></para><screen><phrase role="commit-message">Adding --output option to dbtoepub based on user request</phrase></screen>
\r
892 <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>
\r
895 <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 <p> inside <p> for <tag>refclass</tag> (made XHTML* invalid, made HTML silly)</phrase></screen>
\r
898 <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 <a>s added inside <<tag>blockquote</tag>>; This potentially causes another problem (where something is referenced by has no <tag>anchor</tag>, but someone reporting that should cause the whole <a id='thing'/> thing to be reconsidered with modern browsers in mind.</phrase></screen>
\r
901 </sect2><!--end of Epub changes for 1.75.0-->
\r
903 <sect2 xml:id="rn_V1.75.0_HTMLHelp">
\r
904 <title>HTMLHelp</title>
\r
905 <para>The following changes have been made to the
\r
906 <filename>htmlhelp</filename> code
\r
907 since the 1.74.3 release.</para>
\r
910 <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>
\r
913 </sect2><!--end of HTMLHelp changes for 1.75.0-->
\r
916 <sect2 xml:id="rn_V1.75.0_Params">
\r
917 <title>Params</title>
\r
918 <para>The following changes have been made to the
\r
919 <filename>params</filename> code
\r
920 since the 1.74.3 release.</para>
\r
923 <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>
\r
926 <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>
\r
927 of the bookmark tree. When the parameter has a non-zero value (the default),
\r
928 only the top-level bookmarks are displayed initially. Otherwise, the whole
\r
929 tree of bookmarks is displayed.
\r
931 This is implemented for FOP 0.9X. Closes FR #1792326.</phrase></screen>
\r
934 <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
\r
935 request # 1968513.</phrase></screen>
\r
938 <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
\r
939 and numbered questions can be distinguished. Satisfies
\r
940 Feature Request #1539045.</phrase></screen>
\r
943 <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>
\r
946 <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.
\r
947 If it is ever fixed in Xalan, just fix it here.</phrase></screen>
\r
950 <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
\r
951 a <tag>section</tag> <tag>title</tag> or to the precise location of the
\r
952 <tag>indexterm</tag>.</phrase></screen>
\r
955 <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>
\r
958 <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>
\r
961 <para><literal>Mauritz Jeanson: highlight.source.xml</literal></para><screen><phrase role="commit-message">Updated and reorganized the description.</phrase></screen>
\r
964 <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>
\r
967 <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
\r
968 writing mode.</phrase></screen>
\r
971 <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>
\r
974 <para><literal>Robert Stayton: glossterm.separation.xml</literal></para><screen><phrase role="commit-message">Clarify the description.</phrase></screen>
\r
977 <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>
\r
980 </sect2><!--end of Params changes for 1.75.0-->
\r
982 <sect2 xml:id="rn_V1.75.0_Highlighting">
\r
983 <title>Highlighting</title>
\r
984 <para>The following changes have been made to the
\r
985 <filename>highlighting</filename> code
\r
986 since the 1.74.3 release.</para>
\r
989 <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>
\r
992 <para><literal>Keith Fahlgren: README</literal></para><screen><phrase role="commit-message">Adding XSLTHL readme</phrase></screen>
\r
995 <para><literal>Keith Fahlgren: common.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
\r
998 </sect2><!--end of Highlighting changes for 1.75.0-->
\r
1000 <sect2 xml:id="rn_V1.75.0_XSL-Saxon">
\r
1001 <title>XSL-Saxon</title>
\r
1002 <para>The following changes have been made to the
\r
1003 <filename>xsl-saxon</filename> code
\r
1004 since the 1.74.3 release.</para>
\r
1007 <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.
\r
1008 Hopefully this closes bug #894805.</phrase></screen>
\r
1011 </sect2><!--end of XSL-Saxon changes for 1.75.0-->
\r
1013 <sect2 xml:id="rn_V1.75.0_XSL-Xalan">
\r
1014 <title>XSL-Xalan</title>
\r
1015 <para>The following changes have been made to the
\r
1016 <filename>xsl-xalan</filename> code
\r
1017 since the 1.74.3 release.</para>
\r
1020 <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.
\r
1021 Hopefully this closes bug #894805.</phrase></screen>
\r
1024 </sect2><!--end of XSL-Xalan changes for 1.75.0-->
\r
1029 <sect1 xml:id="V1.74.3">
\r
1030 <title>Release Notes: 1.74.3</title>
\r
1031 <para>This release fixes some bugs in the 1.74.2 release.</para>
\r
1032 <para>See <filename>highlighting/README</filename> for XSLTHL usage instructions.</para>
\r
1034 <sect1 xml:id="V1.74.2">
\r
1035 <title>Release Notes: 1.74.2</title>
\r
1036 <para>This release fixes some bugs in the 1.74.1 release.</para>
\r
1039 <sect1 xml:id="V1.74.1">
\r
1040 <title>Release Notes: 1.74.1</title>
\r
1041 <para>This release includes important bug fixes and adds the following
\r
1042 significant feature changes:
\r
1045 <term>Gentext</term>
\r
1046 <listitem><para>Kirghiz locale added and Chinese translations have been simplified.</para></listitem>
\r
1047 <listitem><para>Somme support for gentext and right-to-left languages has been added.</para></listitem>
\r
1051 <listitem><para>Various bugs have been resolved. </para> </listitem>
\r
1052 <listitem><para>Support for a new processing instruction: <markup>dbfo funcsynopsis-style</markup> has been added. </para> </listitem>
\r
1053 <listitem><para>Added new param <parameter>email.mailto.enabled</parameter> for FO output. Patch from Paolo Borelli. </para>
\r
1055 <listitem><para>Support for documented metadata in fop1 mode has been added. </para>
\r
1060 <term>Highlighting</term>
\r
1061 <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>
\r
1066 <term>Manpages</term>
\r
1067 <listitem><para>Added man.output.better.ps.enabled param (zero default). It non-zero, no such
\r
1068 markup is embedded in generated man pages, and no enhancements are
\r
1069 included in the PostScript output generated from those man pages
\r
1070 by the man -Tps <tag>command</tag>.</para></listitem>
\r
1077 <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>
\r
1079 <para>Added a new top-level stylesheet module, chunk-changebars.xsl, to be
\r
1080 used for generating chunked output with highlighting based on change
\r
1081 (@revisionflag) markup. The module imports/includes the standard chunking
\r
1082 and changebars templates and contains additional logic for chunked output.
\r
1083 See FRs #1015180 and #1819915.</para>
\r
1090 <para>Covers now look better in Adobe Digital Editions thanks to a patch from Paul Norton of Adobe</para>
\r
1092 <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>
\r
1093 <listitem><para>Cover markup now carries more reliably into files destined for .mobi and the Kindle.</para> </listitem>
\r
1094 <listitem><para><markup>dc:identifiers</markup> are now generated from more types of numbering schemes. </para></listitem>
\r
1095 <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>
\r
1097 <para>Primitive support for embedding a single font added.</para>
\r
1100 <para>Support for embedding a CSS customizations added.</para>
\r
1106 <term>Roundtrip</term>
\r
1109 <para>Support for imagedata-metadata and <tag>table</tag> as images added.</para>
\r
1112 <para>Support for imagedata-metadata and <tag>legalnotice</tag> as images added.</para>
\r
1117 <term>Params</term>
\r
1118 <listitem><para><parameter>man.output.better.ps.enabled</parameter> added for Manpages output </para></listitem>
\r
1120 <para><parameter>writing.mode.xml</parameter> added to set text direction.</para>
\r
1123 <para>Added new param <parameter>email.mailto.enabled</parameter> for FO output.
\r
1124 Patch from Paolo Borelli. Closes #2086321.</para>
\r
1127 <para><parameter>highlight.source</parameter> upgraded to support the latest version of XSLTHL 2.0.</para>
\r
1136 <para>The following is a list of changes that have been made since the 1.74.0 release.</para>
\r
1139 <sect2 xml:id="summary_V1.74.1_Gentext">
\r
1140 <title>Gentext</title>
\r
1141 <para>The following changes have been made to the <filename>gentext</filename> code since the 1.74.0 release.</para>
\r
1144 <para><literal>Michael(tm) Smith: locale/ky.xml; Makefile</literal></para><screen><phrase role="commit-message">new Kirghiz locale from Ilyas Bakirov</phrase></screen>
\r
1147 <para><literal>Mauritz Jeanson: locale/en.xml</literal></para><screen><phrase role="commit-message">Added "<tag>Acknowledgements</tag>".</phrase></screen>
\r
1150 <para><literal>Dongsheng Song: locale/zh_cn.xml</literal></para><screen><phrase role="commit-message">Simplified Chinese translation.</phrase></screen>
\r
1153 <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>
\r
1156 </sect2><!--end of Gentext changes for 1.74.1-->
\r
1158 <sect2 xml:id="summary_V1.74.1_FO">
\r
1160 <para>The following changes have been made to the <filename>fo</filename> code since the 1.74.0 release.</para>
\r
1163 <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>
\r
1166 <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>
\r
1169 <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.
\r
1170 Closes bug #1838213.</phrase></screen>
\r
1173 <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.
\r
1174 Patch from Paolo Borelli. Closes #2086321.</phrase></screen>
\r
1177 <para><literal>Mauritz Jeanson: docbook.xsl</literal></para><screen><phrase role="commit-message">Added support for document metadata for fop1 (patch #2067318).</phrase></screen>
\r
1180 <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
\r
1181 -- nested markup in highlited code is now processed
\r
1182 -- it is no longer needed to specify path XSLTHL configuration file using Java property
\r
1183 -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
\r
1186 </sect2><!--end of FO changes for 1.74.1-->
\r
1188 <sect2 xml:id="summary_V1.74.1_HTML">
\r
1189 <title>HTML</title>
\r
1190 <para>The following changes have been made to the <filename>html</filename> code since the 1.74.0 release.</para>
\r
1193 <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>
\r
1196 <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
\r
1197 used for generating chunked output with highlighting based on change
\r
1198 (@revisionflag) markup. The module imports/includes the standard chunking
\r
1199 and changebars templates and contains additional logic for chunked output.
\r
1200 See FRs #1015180 and #1819915.</phrase></screen>
\r
1203 </sect2><!--end of HTML changes for 1.74.1-->
\r
1205 <sect2 xml:id="summary_V1.74.1_Manpages">
\r
1206 <title>Manpages</title>
\r
1207 <para>The following changes have been made to the <filename>manpages</filename> code since the 1.74.0 release.</para>
\r
1210 <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:
\r
1212 purpose is to explicitly tell AT&T troff that the page needs to be
\r
1213 pre-processed through tbl(1); groff can <tag>figure</tag> it out
\r
1214 automatically, but apparently AT&T troff needs to be explicitly told</phrase></screen>
\r
1217 </sect2><!--end of Manpages changes for 1.74.1-->
\r
1219 <sect2 xml:id="summary_V1.74.1_Epub">
\r
1220 <title>ePub</title>
\r
1221 <para>The following changes have been made to the <filename>epub</filename> code since the 1.74.0 release.</para>
\r
1224 <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>
\r
1227 <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
\r
1228 DocBook 5.0's <<tag>cover</tag>> now has some limited support:
\r
1230 - should <tag>reference</tag> a <tag>cover</tag> in the OPF guide for a DocBook 5.0 test document</phrase></screen>
\r
1233 <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).
\r
1236 - should include at least one dc:identifier
\r
1237 - should include an ISBN as URN for dc:identifier if an ISBN was in the metadata
\r
1238 - should include an ISSN as URN for dc:identifier if an ISSN was in the metadata
\r
1239 - should include an <tag>biblioid</tag> as a dc:identifier if an <tag>biblioid</tag> was in the metadata
\r
1240 - 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>
\r
1243 <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
\r
1244 we always send out one and only one h1 in each XHTML chunk.
\r
1247 - should include one and only one <h1> in each HTML file in rendered ePub files
\r
1248 for <<tag>book</tag>>s
\r
1249 - should include one and only one <h1> in each HTML file in rendered ePub files
\r
1250 for <<tag>book</tag>>s even if they do not have <tag>section</tag> markup</phrase></screen>
\r
1253 <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>
\r
1256 <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>
\r
1259 <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>
\r
1262 <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 & dbtoepub:
\r
1263 -c, --css [FILE] Use FILE for CSS on generated XHTML.
\r
1268 - should include a CSS <tag>link</tag> in HTML files when a CSS file has been provided
\r
1269 - should include CSS file in .epub when a CSS file has been provided
\r
1270 - should include a CSS <tag>link</tag> in OPF file when a CSS file has been provided</phrase></screen>
\r
1273 </sect2><!--end of Epub changes for 1.74.1-->
\r
1275 <sect2 xml:id="summary_V1.74.1_Roundtrip">
\r
1276 <title>Roundtrip</title>
\r
1277 <para>The following changes have been made to the
\r
1278 <filename>roundtrip</filename> code
\r
1279 since the 1.74.0 release.</para>
\r
1282 <para><literal>Steve Ball: blocks2dbk.xsl; template.xml; template.dot</literal></para><screen><phrase role="commit-message">added support for imagedata-metadata
\r
1283 added support for <tag>table</tag> as images</phrase></screen>
\r
1286 <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>
\r
1289 <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>
\r
1292 <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>
\r
1295 <para><literal>Steve Ball: specifications.xml; supported.xml; blocks2dbk.xsl; wordml2normalise.xsl; dbk2w⋯</literal></para><screen><phrase role="commit-message">Updated specification.
\r
1296 to-DocBook: add cols attribute to <tag>tgroup</tag>
\r
1297 from-DocBook: fix for <tag>blockquote</tag> <tag>title</tag></phrase></screen>
\r
1300 </sect2><!--end of Roundtrip changes for 1.74.1-->
\r
1302 <sect2 xml:id="summary_V1.74.1_Params">
\r
1303 <title>Params</title>
\r
1304 <para>The following changes have been made to the <filename>params</filename> since the 1.74.0 release.</para>
\r
1307 <para>The change was to add man.output.better.ps.enabled parameter, with
\r
1308 its default value set to zero.
\r
1310 If the value of the man.output.better.ps.enabled parameter is
\r
1311 non-zero, certain markup is embedded in each generated man page
\r
1312 such that PostScript output from the man -Tps <tag>command</tag> for that
\r
1313 page will include a number of enhancements designed to improve the
\r
1314 quality of that output.
\r
1316 If man.output.better.ps.enabled is zero (the default), no such
\r
1317 markup is embedded in generated man pages, and no enhancements are
\r
1318 included in the PostScript output generated from those man pages
\r
1319 by the man -Tps <tag>command</tag>.
\r
1321 WARNING: The enhancements provided by this parameter rely on
\r
1322 features that are specific to groff (GNU troff) and that are not
\r
1323 part of "classic" AT&T troff or any of its derivatives. Therefore,
\r
1324 any man pages you generate with this parameter enabled will be
\r
1325 readable only on systems on which the groff (GNU troff) program is
\r
1326 installed, such as GNU/Linux systems. The pages will not not be
\r
1327 readable on systems on with the classic troff (AT&T troff) <tag>command</tag>
\r
1330 NOTE: The value of this parameter only affects PostScript output
\r
1331 generated from the man <tag>command</tag>. It has no effect on output
\r
1332 generated using the FO backend.
\r
1334 <tag>TIP</tag>: You can generate PostScript output for any man page by
\r
1335 running the following <tag>command</tag>:
\r
1337 man FOO -Tps > FOO.ps
\r
1339 You can then generate PDF output by running the following <tag>command</tag>:
\r
1341 ps2pdf FOO.ps</para>
\r
1344 <para><literal>Robert Stayton: writing.mode.xml</literal></para><screen><phrase role="commit-message">writing mode param used to set text direction.</phrase></screen>
\r
1347 <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.
\r
1348 Patch from Paolo Borelli. Closes #2086321.</phrase></screen>
\r
1351 <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
\r
1352 -- nested markup in highlited code is now processed
\r
1353 -- it is no longer needed to specify path XSLTHL configuration file using Java property
\r
1354 -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
\r
1357 </sect2><!--end of Params changes for 1.74.1-->
\r
1359 <sect2 xml:id="summary_V1.74.1_Highlighting">
\r
1360 <title>Highlighting</title>
\r
1361 <para>The following changes have been made to the
\r
1362 <filename>highlighting</filename> code
\r
1363 since the 1.74.0 release.</para>
\r
1366 <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
\r
1367 -- nested markup in highlited code is now processed
\r
1368 -- it is no longer needed to specify path XSLTHL configuration file using Java property
\r
1369 -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
\r
1372 </sect2><!--end of Highlighting changes for 1.74.1-->
\r
1377 <sect1 xml:id="V1.74.0">
\r
1378 <title>Release Notes: 1.74.0</title>
\r
1379 <para>This release includes important bug fixes and adds the following
\r
1380 significant feature changes:
\r
1383 <term>.epub target</term>
\r
1384 <listitem><para>Paul Norton (Adobe) and Keith Fahlgren(O'Reilly Media) have donated code that generates <filename>.epub</filename> documents from
\r
1385 DocBook input. An alpha-reference implementation in Ruby has also been provided.</para>
\r
1386 <para>.epub is an open standard of the The International Digital Publishing Forum (IDPF),
\r
1387 a the trade and standards association for the digital publishing industry. </para>
\r
1388 <para>Read more about this target in <filename>epub/README</filename>
\r
1389 </para></listitem>
\r
1393 <term>XHTML 1.1 target</term>
\r
1394 <listitem><para>To support .epub output, a strict XHTML 1.1 target has been added. The stylesheets for this output are
\r
1395 generated and are quite similar to the XHTML target.</para></listitem>
\r
1398 <term>Gentext updates</term>
\r
1399 <listitem><para>A number of locales have been updated.</para></listitem>
\r
1402 <term>Roundtrip improvements</term>
\r
1403 <listitem><para>Table, figure, template syncronization, and character style improvements have been made for WordML & Pages. Support added for OpenOffice.org.</para></listitem>
\r
1408 <term>First implementation of a libxslt extension</term>
\r
1410 <para>A stylesheet extension for libxslt, written in Python, has been added.
\r
1411 The extension is a function for adjusting column widths in CALS tables. See
\r
1412 <filename>extensions/README.LIBXSLT</filename> for more information.</para>
\r
1418 <para>The following is a list of changes that have been made
\r
1419 since the 1.73.2 release.</para>
\r
1421 <sect2 xml:id="V1.74.0_Gentext">
\r
1422 <title>Gentext</title>
\r
1423 <para>The following changes have been made to the
\r
1424 <filename>gentext</filename> code
\r
1425 since the 1.73.2 release.</para>
\r
1428 <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>
\r
1431 <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>
\r
1434 <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>
\r
1437 <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>
\r
1440 <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
\r
1441 before.</phrase></screen>
\r
1444 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">"no" locale is now "nb"</phrase></screen>
\r
1447 <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>
\r
1450 <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
\r
1451 Norwegian Bokmål is "nb" (not "no") and has been for quite some
\r
1452 time now...</phrase></screen>
\r
1455 <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
\r
1456 that the actual glyphs so up when you edit it in a text editor
\r
1457 (instead of the character references).</phrase></screen>
\r
1460 <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>
\r
1463 <para><literal>Michael(tm) Smith: locale/it.xml</literal></para><screen><phrase role="commit-message">Changes from Federico Zenith</phrase></screen>
\r
1466 <para><literal>Dongsheng Song: locale/zh_cn.xml</literal></para><screen><phrase role="commit-message">Added missing translations.</phrase></screen>
\r
1469 </sect2><!--end of Gentext changes for 1.74.0-->
\r
1471 <sect2 xml:id="V1.74.0_Common">
\r
1472 <title>Common</title>
\r
1473 <para>The following changes have been made to the
\r
1474 <filename>common</filename> code
\r
1475 since the 1.73.2 release.</para>
\r
1478 <para><literal>Michael(tm) Smith: l10n.xsl</literal></para><screen><phrase role="commit-message">Added new template "l10.language.name" for retrieving the
\r
1479 English-language name of the lang setting of the current document.
\r
1480 Closes #1916837. Thanks to Simon Kennedy.</phrase></screen>
\r
1483 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">fixed syntax error</phrase></screen>
\r
1486 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">fixed a couple of typos</phrase></screen>
\r
1489 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">refined handling of cases where refentry "source" or "manual"
\r
1490 metadata is missing or when we use fallback content instead. We
\r
1491 now report a Warning if we use fallback content.</phrase></screen>
\r
1494 <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
\r
1495 "source" or "manual" metadata fields</phrase></screen>
\r
1498 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Made reporting of missing refentry metadata more quiet:
\r
1500 - we no longer report anything if usable-but-not-preferred
\r
1501 metadata is found; we just quietly use whatever we manage to
\r
1504 - we now only report missing "source" metadata if the refentry
\r
1505 is missing BOTH "source name" and "version" metadata; if it
\r
1506 has one but not the other, we use whichever one it has and
\r
1507 don't report anything as missing
\r
1509 The above changes were made because testing with some "real world"
\r
1510 source reveals that some authors are intentionally choosing to use
\r
1511 "non preferred" markup for some metadata, and also choosing to
\r
1512 omit "source name" or "version" metadata in there DocBook XML. So
\r
1513 it does no good to give them pedantic reminders about what they
\r
1516 Also, changed code to cause "fixme" text to be inserted in output
\r
1517 in particular cases:
\r
1519 - if we can't manage to find any "source" metadata at all, we
\r
1520 now put fixme text into the output
\r
1522 - if we can't manage to find any "manual" metadata a all, we
\r
1523 now put fixme text into the output
\r
1525 The "source" and "manual" metadata is necessary information, so
\r
1526 buy putting the fixme stuff in the output, we alert users to the
\r
1527 need problem of it being missing.</phrase></screen>
\r
1530 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">When generating manpages output, we no longer report anything if
\r
1531 the refentry source is missing date or pubdate content. In
\r
1532 practice, many users intentionally omit the date from the source
\r
1533 because they explicitly want it to be generated.</phrase></screen>
\r
1536 <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>
\r
1539 <para><literal>Michael(tm) Smith: common.xsl</literal></para><screen><phrase role="commit-message">Added support for orgname in authorgroup. Thanks to Camille
\r
1540 Bégnis.</phrase></screen>
\r
1543 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">"no" locale is now "nb"</phrase></screen>
\r
1546 <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
\r
1547 work with <link> elements). As far as I can tell, this template is no longer needed.</phrase></screen>
\r
1550 <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>
\r
1553 <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).
\r
1554 Having xref in title is not a problem as long as the target is not an ancestor element.
\r
1555 Closes bug #1838136.
\r
1557 Note that an xref that is in a title and whose target is an ancestor element is still not
\r
1558 rendered in the TOC. This could be considered a bug, but on the other hand I cannot really
\r
1559 see the point in having such an xref in a document.</phrase></screen>
\r
1562 <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
\r
1563 apply-templates" problems when processing xrefs or links in no.anchor.mode mode.
\r
1564 Hopefully, this closes bug #1811721.</phrase></screen>
\r
1567 <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>
\r
1570 <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Process <link> in no.anchor.mode mode with the same template as <xref>.
\r
1571 Closes bug #1759205 (Empty link in no.anchor.mode mode).</phrase></screen>
\r
1574 <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
\r
1575 of <title>. Previously, having inline elements with @id/@xml:id in <title>s
\r
1576 resulted in anchors both in the TOC and in the main flow. Closes bug #1797492.</phrase></screen>
\r
1579 </sect2><!--end of Common changes for 1.74.0-->
\r
1581 <sect2 xml:id="V1.74.0_FO">
\r
1583 <para>The following changes have been made to the
\r
1584 <filename>fo</filename> code
\r
1585 since the 1.73.2 release.</para>
\r
1587 <listitem> <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Updated documentation for keep-together.</phrase></screen> </listitem>
\r
1588 <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>
\r
1590 <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>
\r
1593 <para><literal>Robert Stayton: index.xsl</literal></para><screen><phrase role="commit-message">Fixed non-working inline.or.block template for indexterm wrappers.
\r
1594 Add fop1 to list of processors using inline.or.block.</phrase></screen>
\r
1597 <para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1891965 (colsep in entytbl not working).</phrase></screen>
\r
1600 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added support for title in revhistory. Closes bug #1842847.</phrase></screen>
\r
1603 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Small doc cleanup (dbfo float-type).</phrase></screen>
\r
1606 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Insert commas between multiple copyright holders.</phrase></screen>
\r
1609 <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>
\r
1612 <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>
\r
1615 <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>
\r
1618 <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,
\r
1619 and the "hot text" is the biblioid itself enclosed in brackets.</phrase></screen>
\r
1622 <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>
\r
1625 <para><literal>Mauritz Jeanson: docbook.xsl</literal></para><screen><phrase role="commit-message">Updated message about unmatched element.</phrase></screen>
\r
1628 <para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Added link to profiling chapter of TCG.</phrase></screen>
\r
1631 <para><literal>Mauritz Jeanson: refentry.xsl</literal></para><screen><phrase role="commit-message">Fixed typo (refsynopsysdiv -> refsynopsisdiv).</phrase></screen>
\r
1634 <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>
\r
1637 <para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Added support for MathML in imagedata.</phrase></screen>
\r
1640 <para><literal>Michael(tm) Smith: math.xsl</literal></para><screen><phrase role="commit-message">Removed unnecessary extra test condition in test express that
\r
1641 checks for passivetex.</phrase></screen>
\r
1644 <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
\r
1645 passivetex. Closes #1806899. Thanks to Justus Piater.</phrase></screen>
\r
1648 <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
\r
1649 generate.toc='article/appendix toc'. Closes bug #1669658.</phrase></screen>
\r
1652 <para><literal>Dongsheng Song: biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Change encoding from "windows-1250" to "UTF-8".</phrase></screen>
\r
1655 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Updated documentation for dbfo_label-width.</phrase></screen>
\r
1658 <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>
\r
1661 <para><literal>Robert Stayton: biblio.xsl</literal></para><screen><phrase role="commit-message">Support finding glossary database entries inside bibliodivs.</phrase></screen>
\r
1664 <para><literal>Robert Stayton: formal.xsl</literal></para><screen><phrase role="commit-message">Complete support for <?dbfo pgwide="1"?> for informal
\r
1665 elements too.</phrase></screen>
\r
1668 <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
\r
1669 a table may break (depending on the PI value) at a page break. This was needed
\r
1670 since the outer fo:block that surrounds fo:table has keep-together.within-column="always"
\r
1671 by default, which prevents the table from breaking. Closes bug #1740964 (Titled
\r
1672 table does not respect dbfo PI).</phrase></screen>
\r
1675 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Added a few missing @role="tcg".</phrase></screen>
\r
1678 <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>
\r
1681 <para><literal>Mauritz Jeanson: autoidx.xsl</literal></para><screen><phrase role="commit-message">Removed the [&scope;] predicate from the target variable in the template with name="reference".
\r
1682 This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
\r
1683 with index.on.type=1. Closes bug #1680836.</phrase></screen>
\r
1686 <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
\r
1687 hyperlinks (elements marked up with xlink:href attributes) in the
\r
1688 same way as URLs for ulinks are already handled (which is to say,
\r
1689 either inline or as numbered footnotes).
\r
1691 Background on this change:
\r
1692 DocBook 5 allows "ubiquitous" linking, which means you can make
\r
1693 any element a hyperlink just by adding an xlink:href attribute to
\r
1694 it, with the value set to an external URL. That's in contrast to
\r
1695 DocBook 4, which only allows you to use specific elements (e.g.,
\r
1696 the link and ulink elements) to mark up hyperlinks.
\r
1698 The existing FO stylesheets have a mechanism for handling display
\r
1699 of URLs for hyperlinks that are marked up with ulink, but they did
\r
1700 not handle display of URLs for elements that were marked up with
\r
1701 xlink:href attributes. This change adds handling for those other
\r
1702 elements, enabling the URLs they link to be displayed either
\r
1703 inline or as numbered footnotes (depending on what values the user
\r
1704 has the ulink.show and ulink.footnotes params set to).
\r
1706 Note that this change only adds URL display support for elements
\r
1707 that call the simple.xlink template -- which currently is most
\r
1708 (but not all) inline elements.
\r
1710 This change also moves the URL display handling out of the ulink
\r
1711 template and into a new "hyperlink.url.display" named template;
\r
1712 the ulink template and the simple.xlink named template now both
\r
1713 call the hyperlink.url.display template.
\r
1715 Warning: In the stylesheet code that determines what footnote
\r
1716 number to assign to each footnote or external hyperlink, there is
\r
1717 an XPath expression for determining whether a particular
\r
1718 xlink:href instance is an external hyperlink; that expression is
\r
1719 necessarily a bit complicated and further testing may reveal that
\r
1720 it doesn't handle all cases as expected -- so some refinements to
\r
1721 it may need to be done later.
\r
1723 Closes #1785519. Thanks to Ken Morse for reporting and
\r
1724 troubleshooting the problem.</phrase></screen>
\r
1727 </sect2><!--end of FO changes for 1.74.0-->
\r
1729 <sect2 xml:id="V1.74.0_HTML">
\r
1730 <title>HTML</title>
\r
1731 <para>The following changes have been made to the
\r
1732 <filename>html</filename> code
\r
1733 since the 1.73.2 release.</para>
\r
1735 <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>
\r
1736 <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>
\r
1737 <listitem> <para><literal>Keith Fahlgren: biblio.xsl</literal></para><screen><phrase role="commit-message">Add anchors to bibliodivs</phrase></screen> </listitem>
\r
1739 <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
\r
1740 and Keith Fahlgren of O'Reilly.</phrase></screen>
\r
1741 <para>This change includes new code for generating the XHTML 1.1 target sanely.</para>
\r
1744 <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
\r
1745 Object Identifiers). See FR #1934434 and http://doi.org.
\r
1747 To do: 1) Add support for FO output. 2) Figure out how @class="doi" should be handled
\r
1748 for bibliorelation, bibliosource and citebiblioid.</phrase></screen>
\r
1751 <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>
\r
1754 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">Added checks and hacks to various makefiles to enable building
\r
1755 under Cygwin. This stuff is ugly and maybe not worth the mess and
\r
1756 trouble, but does seem to work as expected and not break anything
\r
1757 else.</phrase></screen>
\r
1760 <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">added "exslt" namespace binding to html/docbook.xsl file (in
\r
1761 addition to existing "exsl" binding. reason is because lack of it
\r
1762 seems to cause processing problems when using the profiled
\r
1763 version of the stylsheet</phrase></screen>
\r
1766 <para><literal>Norman Walsh: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Rename link</phrase></screen>
\r
1769 <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>
\r
1772 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Simplified and streamlined handling of output for ANSI-style
\r
1773 funcprototype output, to correct a problem that was causing type
\r
1774 data to be lost in the output parameter definitions. For example,
\r
1775 for an instance like this:
\r
1776 <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
\r
1777 ... the brackets (indicating an array type) were being dropped.</phrase></screen>
\r
1780 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Changed HTML handling of K&R-style paramdef output. The parameter
\r
1781 definitions are no longer output in a table (though the prototype
\r
1782 still is). The reason for the change is that the
\r
1783 kr-tabular-funcsynopsis-mode template was causing type data to be
\r
1784 lost in the output parameter definitions. For example, for an
\r
1785 instance like this:
\r
1786 <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
\r
1787 ... the brackets (indicating an array type) were being dropped.
\r
1788 The easiest way to deal with the problem is to not try to chop up
\r
1789 the parameter definitions and display them in table format, but to
\r
1790 instead just output them as-is. May not look quite as pretty, but
\r
1791 at least we can be sure no information is being lost...</phrase></screen>
\r
1794 <para><literal>Michael(tm) Smith: pi.xsl</literal></para><screen><phrase role="commit-message">updated wording of doc for funcsynopsis-style PI</phrase></screen>
\r
1797 <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
\r
1798 being used in the code and hasn't been since mid 2006.</phrase></screen>
\r
1801 <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>
\r
1804 <para><literal>Mauritz Jeanson: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Added missing space.</phrase></screen>
\r
1807 <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>
\r
1810 <para><literal>Michael(tm) Smith: pi.xsl</literal></para><screen><phrase role="commit-message">Moved dbhtml_stop-chunking embedded doc into alphabetical order,
\r
1811 fixed text of TCG section it see-also'ed.</phrase></screen>
\r
1814 <para><literal>David Cramer: pi.xsl</literal></para><screen><phrase role="commit-message">Added support for <?dbhtml stop-chunking?> processing instruction</phrase></screen>
\r
1817 <para><literal>David Cramer: chunk-common.xsl; pi.xsl</literal></para><screen><phrase role="commit-message">Added support for <?dbhtml stop-chunking?> processing instruction</phrase></screen>
\r
1820 <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>
\r
1823 <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,
\r
1824 and the "hot text" is the biblioid itself enclosed in brackets.</phrase></screen>
\r
1827 <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"
\r
1828 values are supported (corresponding to values of "_blank" and "_top" for the
\r
1829 ulink.target parameter). I have assumed that @xlink:show should override ulink.target
\r
1830 for external URI links. This closes bugs #1762023 and #1727498.</phrase></screen>
\r
1833 <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>
\r
1836 <para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Added link to profiling chapter of TCG.</phrase></screen>
\r
1839 <para><literal>Dongsheng Song: biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Change encoding from "windows-1250" to "UTF-8".</phrase></screen>
\r
1842 <para><literal>Robert Stayton: biblio.xsl</literal></para><screen><phrase role="commit-message">Add support in biblio collection to entries in bibliodivs.</phrase></screen>
\r
1845 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Added missing @role="tcg".</phrase></screen>
\r
1848 <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
\r
1849 parameter as well as the dbhtml_filename PI are taken into account. A new named
\r
1850 template in titlepage.xsl is used to compute the filename.</phrase></screen>
\r
1853 <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):
\r
1854 The "ln-" prefix is output only when the legalnotice doesn't have an
\r
1855 @id/@xml:id, in which case the stylesheets generate an ID value,
\r
1856 resulting in a filename like "ln-7e0fwgj.html". This is useful because
\r
1857 without the prefix, you wouldn't know that the file contained a legalnotice.
\r
1858 The same logic is also applied to revhistory, using an "rh-" prefix.</phrase></screen>
\r
1861 <para><literal>Mauritz Jeanson: autoidx.xsl</literal></para><screen><phrase role="commit-message">Removed the [&scope;] predicate from the target variable in the template with name="reference".
\r
1862 This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
\r
1863 with index.on.type=1. Closes bug #1680836.</phrase></screen>
\r
1866 <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
\r
1867 <link href"..."> that is output by make.legalnotice.head.links (chunk-common.xsl).
\r
1868 Modified the href attribute on the legalnotice link.
\r
1869 Closes bug #1790495.</phrase></screen>
\r
1872 </sect2><!--end of HTML changes for 1.74.0-->
\r
1874 <sect2 xml:id="V1.74.0_Manpages">
\r
1875 <title>Manpages</title>
\r
1876 <para>The following changes have been made to the
\r
1877 <filename>manpages</filename> code
\r
1878 since the 1.73.2 release.</para>
\r
1881 <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">slightly adjusted spacing around admonition markers</phrase></screen>
\r
1884 <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
\r
1885 make the indenting of their child content less severe</phrase></screen>
\r
1888 <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>
\r
1891 <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>
\r
1894 <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>
\r
1897 <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">For PS/non-TTY output, display footnote/endnote numbers in
\r
1898 superscript.</phrase></screen>
\r
1901 <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,
\r
1902 and synopfragment such that they now look correct in non-TTY/PS
\r
1903 output. We now use the groff \w escape to hang by the actual width
\r
1904 -- in the current font -- of the command, funcdef, or
\r
1905 synopfragment references number (as opposed to hanging by the
\r
1906 number of characters). This rendering in TTY output remains the
\r
1907 same, since the width in monospaced TTY output is the same as the
\r
1908 number of characters.
\r
1910 Also, created new synopsis-block-start and synopsis-block-end
\r
1911 templates to use for cmdsynopsis and funcsynopsis instead of the
\r
1912 corresponding verbatim-* templates.
\r
1914 Along with those changes, also corrected a problem that caused the
\r
1915 content of synopfragment to be dropped, and made a
\r
1916 vertical-spacing change to adjust spacing around table titles and
\r
1917 among sibling synopfragment instances.</phrase></screen>
\r
1920 <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>
\r
1923 <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
\r
1924 in italic (despite the fact that man guidelines say we should)</phrase></screen>
\r
1927 <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">put filename output in monospace instead of italic</phrase></screen>
\r
1930 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">put cmdsynopsis in monospace</phrase></screen>
\r
1933 <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">removed template match for literal. template matches for monospace
\r
1934 inlines are all imported from the HTML stylesheet</phrase></screen>
\r
1937 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">don't indent verbatim environments that are descendants of
\r
1938 refsynopsisdiv, not put backgrounds behind them</phrase></screen>
\r
1941 <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
\r
1942 inline monospace instances in the git man pages to be set in
\r
1943 monospace (since DocBook XML source for git docs is generated with
\r
1944 asciidoc and asciidoc consistently outputs only <literal> for
\r
1945 inline monospace (not <command> or <code> or anything else).
\r
1946 Of course this only affects non-TTY output...</phrase></screen>
\r
1949 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">Added inline.monoseq named template.</phrase></screen>
\r
1952 <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
\r
1953 font-family value when setting blocks of text in code font; just
\r
1954 use \F[] .fam with no arg to switch back</phrase></screen>
\r
1957 <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
\r
1958 renders content marked up with the .URL macro)</phrase></screen>
\r
1961 <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,
\r
1962 changed the default font formatting for links to bold.</phrase></screen>
\r
1965 <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
\r
1966 base URL for relative links (for ulink, @xlink:href, imagedata,
\r
1967 audiodata, videodata) shown in the generated NOTES section of
\r
1968 man-page output. The value of man.base.url.for.relative.links is
\r
1969 prepended to any relative URI that is a value of ulink url,
\r
1970 xlink:href, or fileref attribute.
\r
1972 If you use relative URIs in link sources in your DocBook refentry
\r
1973 source, and you leave man.base.url.for.relative.links unset, the
\r
1974 relative links will appear "as is" in the NOTES section of any
\r
1975 man-page output generated from your source. That's probably not
\r
1976 what you want, because such relative links are only usable in the
\r
1977 context of HTML output. So, to make the links meaningful and
\r
1978 usable in the context of man-page output, set a value for
\r
1979 man.base.url.for.relative.links that points
\r
1980 to the online version of HTML output generated from your DocBook
\r
1981 refentry source. For example:
\r
1983 <xsl:param name="man.base.url.for.relative.links"
\r
1984 >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param></phrase></screen>
\r
1987 <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">If a source refentry contains a Documentation or DOCUMENTATION
\r
1988 section, don't report it as having missing AUTHOR information.
\r
1989 Also, if missing a contrib/personblurb for a person or org, report
\r
1990 pointers to http://docbook.sf.net/el/personblurb and to
\r
1991 http://docbook.sf.net/el/contrib</phrase></screen>
\r
1994 <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
\r
1995 personblurb or contrib, report it to the user (because that means
\r
1996 we have no information about that author|editor|othercredit to
\r
1997 display in the generated AUTHOR|AUTHORS section...)</phrase></screen>
\r
2000 <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
\r
2001 a fixme in the output</phrase></screen>
\r
2004 <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
\r
2005 section. Thanks to Daniel Leidert and the fglrx docs for exposing
\r
2006 the bug.</phrase></screen>
\r
2009 <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,
\r
2010 suppress the .sp or .PP that would normally be output (because in
\r
2011 those cases, the output goes into a table cell, and the .sp or .PP
\r
2012 markup causes a spurious linebreak before it when displayed</phrase></screen>
\r
2015 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Added support for rendering co callouts and calloutlist instances.
\r
2016 So you can now use simple callouts -- marking up programlisting
\r
2017 and such with co instances -- and have the callouts displayed in
\r
2018 man-page output. ("simple callouts" means using co@id and
\r
2019 callout@arearefs pointing to co@id instances; in man/roff output,
\r
2020 we can't/don't support markup that uses areaset and area)</phrase></screen>
\r
2023 <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
\r
2024 text node or a paragraph</phrase></screen>
\r
2027 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">put verbatim environments in slightly smaller font in non-TTY
\r
2028 output</phrase></screen>
\r
2031 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">minor whitespace-only reformatting of lists.xsl source</phrase></screen>
\r
2034 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Made refinements/fixes to output of orderedlist and itemizedlist
\r
2035 -- in part, to get mysql man pages to display correctly. This
\r
2036 change causes a "\c" continuation marker to be added between
\r
2037 listitem markers and contents (to ensure that the content remains
\r
2038 on the same line as the marker when displayed)</phrase></screen>
\r
2041 <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
\r
2042 sibling content following it (not just if that sibling content is
\r
2043 a text node)</phrase></screen>
\r
2046 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">refined spacing around titles for admonitions</phrase></screen>
\r
2049 <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
\r
2050 after the opening tag. Assumption is that users generally don't
\r
2051 want that linebreak to appear in output, so we do some groff
\r
2052 hackery to mess with vertical spacing and close the space.</phrase></screen>
\r
2055 <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">indexterm instances now produce groff comments like this:
\r
2057 .\" primary: secondary: tertiary
\r
2059 remark instances, if non-empty, now produce groff comments</phrase></screen>
\r
2062 <para><literal>Michael(tm) Smith: charmap.groff.xsl; other.xsl</literal></para><screen><phrase role="commit-message">convert no-break space character to groff "\ \&" (instead of just
\r
2063 "\ "). the reason is that if a space occurs at the end of a line,
\r
2064 our processing causes it to be eaten. a real-world case of this is
\r
2065 the mysql(1) man page. appending the "\&" prevents that</phrase></screen>
\r
2068 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">output "sp" before simpara output, not after it (outputting it
\r
2069 after results in undesirable whitespace in particular cases; for
\r
2070 example, in the hg/mercurial docs</phrase></screen>
\r
2073 <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"
\r
2074 between synopsis fragments with call to pinch.together instead</phrase></screen>
\r
2077 <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"
\r
2078 hack), and "sp 1" after all tables (instead of just "sp"</phrase></screen>
\r
2081 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">created title-preamble template for suppressing line spacing after
\r
2082 headings</phrase></screen>
\r
2085 <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">further refinement of indenting in AUTHORS section</phrase></screen>
\r
2088 <para><literal>Michael(tm) Smith: block.xsl; other.xsl</literal></para><screen><phrase role="commit-message">refined handling of admonitions</phrase></screen>
\r
2091 <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>
\r
2094 <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
\r
2095 instead.</phrase></screen>
\r
2098 <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>
\r
2101 <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>
\r
2104 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">Reworked output for admonitions (caution, important, note, tip,
\r
2105 warning). In TTY output, admonitions now get indented. In non-TTY
\r
2106 output, a colored marker (yellow) is displayed next to them.</phrase></screen>
\r
2109 <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
\r
2110 a block of text.</phrase></screen>
\r
2113 <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
\r
2114 from nested-section-title template. This allows the bolding to
\r
2115 also be used by the template for formatting admonitions</phrase></screen>
\r
2118 <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>
\r
2121 <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>
\r
2124 <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
\r
2125 output</phrase></screen>
\r
2128 <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
\r
2129 the handling of charmap subsets to differentiate between English
\r
2130 and non-English source.
\r
2132 This way charmap subsets are now handled is this:
\r
2134 If the value of the man.charmap.use.subset parameter is non-zero,
\r
2135 and your DocBook source is not written in English (that is, if its
\r
2136 lang or xml:lang attribute has a value other than en), then the
\r
2137 character-map subset specified by the man.charmap.subset.profile
\r
2138 parameter is used instead of the full roff character map.
\r
2140 Otherwise, if the lang or xml:lang attribute on the root element
\r
2141 in your DocBook source or on the first refentry element in your
\r
2142 source has the value en or if it has no lang or xml:lang
\r
2143 attribute, then the character-map subset specified by the
\r
2144 man.charmap.subset.profile.english parameter is used instead of
\r
2145 man.charmap.subset.profile.
\r
2147 The difference between the two subsets is that
\r
2148 man.charmap.subset.profile provides mappings for characters in
\r
2149 Western European languages that are not part of the Roman
\r
2150 (English) alphabet (ASCII character set).</phrase></screen>
\r
2153 <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">Various updates, mainly related to uppercasing SH titles:
\r
2155 - added a "Language: " metadata line to the top comment area of
\r
2156 output man pages, to indicate the language the page is in
\r
2158 - added a "toupper" macro of doing locale-aware uppercasing of
\r
2159 SH titles and cross-references to SH titles; the mechanism
\r
2160 relies on the uppercase.alpha and lowercase.alpha DocBook
\r
2161 gentext keys to do locale-aware uppercasing based on the
\r
2162 language the page is written in
\r
2164 - added a "string.shuffle" template, which provides a library
\r
2165 function for "shuffling" two strings together into a single
\r
2166 string; it takes the first character for the first string, the
\r
2167 first character from second string, etc. The only current use
\r
2168 for it is to generate the argument for the groff tr request
\r
2169 that does string uppercasing.
\r
2171 - added make.tr.uppercase.arg and make.tr.normalcase.arg named
\r
2172 templates for use in generating groff code for uppercasing and
\r
2173 "normal"-casing SH titles
\r
2175 - made the BB/BE "background drawing" macros have effect only in
\r
2178 - output a few comments in the top part of source</phrase></screen>
\r
2181 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">removed some leftover kruft</phrase></screen>
\r
2184 <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
\r
2185 in the refname(s) with underscores. This ensures that tools like
\r
2186 lexgrog(1) will be able to parse the name (lexgrog won't parse
\r
2187 names that contain spaces).</phrase></screen>
\r
2190 <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
\r
2191 content starts. (We now have a few of macro definitions at the
\r
2192 start of the source, so putting this comment in helps those that
\r
2193 might be viewing the source.)</phrase></screen>
\r
2196 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">refined mechanism for generating SH titles</phrase></screen>
\r
2199 <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.
\r
2200 This means that generated Finnish man pages will no longer contain
\r
2201 any raw accented characters -- they'll instead by marked up with
\r
2202 groff escapes.</phrase></screen>
\r
2205 <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
\r
2206 dots to be output just as "\." -- instead needs to be "\&." (which
\r
2207 is what it will be now, after this change)</phrase></screen>
\r
2210 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Changed backend handling for generating titles for SH sections and
\r
2211 for cross-references to those sections. This should have no effect
\r
2212 on TTY output (behavior should remain the same hopefully) but
\r
2213 results in titles in normal case (instead of uppercase) in PS
\r
2214 output.</phrase></screen>
\r
2217 <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">use make.subheading template to make subheadings for AUTHORS and
\r
2218 COPYRIGHT sections (instead of harcoding roff markup)</phrase></screen>
\r
2221 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">put code font around programlisting etc.</phrase></screen>
\r
2224 <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
\r
2225 code font</phrase></screen>
\r
2228 <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">use the make.subheading template to generated SH subheading for
\r
2229 endnotes section.</phrase></screen>
\r
2232 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Added some templates for generating if-then-else conditional
\r
2233 markup in groff, so let's use those instead of hard-coding it in
\r
2234 multiple places...</phrase></screen>
\r
2237 <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
\r
2238 from "man -l -Tps" look better. The current changes:
\r
2240 - render synopsis and verbatim sections in a monospace/code font
\r
2242 - put a light-grey background behind all programlisting, screen,
\r
2243 and literallayout instances
\r
2245 - prevent SH heads in PS output from being rendered in uppercase
\r
2246 (as they are in console output)
\r
2248 - also display xrefs to SH heads in PS output in normal case
\r
2249 (instead of uppercase)
\r
2251 - draw a line under SH heads in PS output
\r
2253 The changes made to the code to support the above features were:
\r
2255 - added some embedded/custom macros: one for conditionally
\r
2256 upper-casing SH x-refs, one for redefining the SH macro
\r
2257 itself, with some conditional handling for PS output, and
\r
2258 finally a macro for putting a background/screen (filled box)
\r
2259 around a block of text (e.g., a program listing) in PS output
\r
2261 - added utility templates for wrapping blocks of text in code
\r
2262 font; also templates for inline code font</phrase></screen>
\r
2265 <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>
\r
2268 <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
\r
2269 orderedlist output for TTY. Existing code seemed to have been
\r
2270 causing an extra undesirable space to appear.</phrase></screen>
\r
2273 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Wrapped some roff conditionals around roff markup for orderedlist
\r
2274 and itemizedlist output, so that the lists look acceptable in PS
\r
2275 output as well as TTY.</phrase></screen>
\r
2278 <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
\r
2279 manpages output as the funcsynopsis.style parameter has in HTML
\r
2280 output -- except that its default value is 'ansi' instead of 'kr'.</phrase></screen>
\r
2283 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Reworked handling of K&R funcprototype output. It no longer relies
\r
2284 on the HTML kr-tabular templates, but instead just does direct
\r
2285 transformation to roff. For K&R output, it displays the paramdef
\r
2286 output in an indented list following the prototype.</phrase></screen>
\r
2289 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Properly integrated handling for K&R output into manpages
\r
2290 stylesheet. The choice between K&R output and ANSI output is
\r
2291 currently controlled through use of the (HTML) funcsynopsis.style
\r
2292 parameter. Note that because the mechanism does currently rely on
\r
2293 funcsynopsis.style, the default in manpages output is now K&R
\r
2294 (because that's the default of that param). But I suppose I ought
\r
2295 to create a man.funcsynopsis.style and make the default for that
\r
2296 ANSI (to preserve the existing default behavior).</phrase></screen>
\r
2299 <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">added manpages/pi.xsl file</phrase></screen>
\r
2302 <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
\r
2303 doc build.</phrase></screen>
\r
2306 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Fixed regression that caused an unescaped dash to be output
\r
2307 between refname and refpurpose content. Closes bug #1894244.
\r
2308 Thanks to Daniel Leidert.</phrase></screen>
\r
2311 <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">Fixed problem with dots being escaped in filenames of generated
\r
2312 man files. Closes #1827195. Thanks to Daniel Leidert.</phrase></screen>
\r
2315 <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">Added support for processing structfield (was appearing in roff
\r
2316 output surrounded by HTML <em> tags; fixed so that it gets roff
\r
2317 ital markup). Closes bug #1858329. Thanks to Sam Varshavchik.</phrase></screen>
\r
2320 </sect2><!--end of Manpages changes for 1.74.0-->
\r
2322 <sect2 xml:id="V1.74.0_Epub">
\r
2323 <title>Epub</title>
\r
2324 <para>The following changes have been made to the
\r
2325 <filename>epub</filename> code
\r
2326 since the 1.73.2 release.</para>
\r
2328 <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>
\r
2329 <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>
\r
2330 <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>
\r
2331 <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>
\r
2332 <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>
\r
2334 <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
\r
2335 and Keith Fahlgren of O'Reilly.</phrase></screen>
\r
2338 <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">== General epub test support
\r
2340 $ spec -O ~/.spec.opts spec/epub_spec.rb
\r
2343 - should be able to be created
\r
2344 - should fail on a nonexistent file
\r
2345 - should be able to render to a file
\r
2346 - should create a file after rendering
\r
2347 - should have the correct mimetype after rendering
\r
2348 - should be valid .epub after rendering an article
\r
2349 - should be valid .epub after rendering an article without sections
\r
2350 - should be valid .epub after rendering a book
\r
2351 - should be valid .epub after rendering a book even if it has one graphic
\r
2352 - should be valid .epub after rendering a book even if it has many graphics
\r
2353 - should be valid .epub after rendering a book even if it has many duplicated graphics
\r
2354 - should report an empty file as invalid
\r
2355 - should confirm that a valid .epub file is valid
\r
2356 - should not include PDFs in rendered epub files as valid image inclusions
\r
2357 - should include a TOC link in rendered epub files for <book>s
\r
2359 Finished in 20.608395 seconds
\r
2361 15 examples, 0 failures
\r
2364 == Verbose epub test coverage against _all_ of the testdocs
\r
2366 Fails on only (errors truncated):
\r
2368 '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
\r
2369 '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
\r
2372 Finished in 629.89194 seconds
\r
2374 224 examples, 15 failures
\r
2376 224 examples, 15 failures yields 6% failure rate</phrase></screen>
\r
2379 </sect2><!--end of Epub changes for 1.74.0-->
\r
2381 <sect2 xml:id="V1.74.0_HTMLHelp">
\r
2382 <title>HTMLHelp</title>
\r
2383 <para>The following changes have been made to the
\r
2384 <filename>htmlhelp</filename> code
\r
2385 since the 1.73.2 release.</para>
\r
2388 <para><literal>Mauritz Jeanson: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
\r
2389 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
\r
2390 This makes chunk.quietly=1 suppress chunk filename messages also for help
\r
2391 support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
\r
2394 </sect2><!--end of HTMLHelp changes for 1.74.0-->
\r
2396 <sect2 xml:id="V1.74.0_Eclipse">
\r
2397 <title>Eclipse</title>
\r
2398 <para>The following changes have been made to the
\r
2399 <filename>eclipse</filename> code
\r
2400 since the 1.73.2 release.</para>
\r
2403 <para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Use sortas attributes (if they exist) when sorting indexterms</phrase></screen>
\r
2406 <para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added support for indexterm/see in eclipse index.xml</phrase></screen>
\r
2409 <para><literal>Mauritz Jeanson: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added <xsl:with-param name="quiet" select="$chunk.quietly"/>
\r
2410 to helpidx template.</phrase></screen>
\r
2413 <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>
\r
2416 <para><literal>Mauritz Jeanson: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
\r
2417 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
\r
2418 This makes chunk.quietly=1 suppress chunk filename messages also for help
\r
2419 support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
\r
2422 </sect2><!--end of Eclipse changes for 1.74.0-->
\r
2424 <sect2 xml:id="V1.74.0_JavaHelp">
\r
2425 <title>JavaHelp</title>
\r
2426 <para>The following changes have been made to the
\r
2427 <filename>javahelp</filename> code
\r
2428 since the 1.73.2 release.</para>
\r
2431 <para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
\r
2432 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
\r
2433 This makes chunk.quietly=1 suppress chunk filename messages also for help
\r
2434 support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
\r
2437 </sect2><!--end of JavaHelp changes for 1.74.0-->
\r
2439 <sect2 xml:id="V1.74.0_Roundtrip">
\r
2440 <title>Roundtrip</title>
\r
2441 <para>The following changes have been made to the
\r
2442 <filename>roundtrip</filename> code
\r
2443 since the 1.73.2 release.</para>
\r
2446 <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>
\r
2449 <para><literal>Mauritz Jeanson: supported.xml</literal></para><screen><phrase role="commit-message">Changed @cols to 5.</phrase></screen>
\r
2452 <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>
\r
2455 <para><literal>Steve Ball: supported.xml</literal></para><screen><phrase role="commit-message">Added support for edition.</phrase></screen>
\r
2458 <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>
\r
2461 <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>
\r
2464 <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>
\r
2467 <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>
\r
2470 <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>
\r
2473 <para><literal>Steve Ball: blocks2dbk.xsl</literal></para><screen><phrase role="commit-message">added support for explicit emphasis character styles</phrase></screen>
\r
2476 <para><literal>Steve Ball: wordml2normalise.xsl</literal></para><screen><phrase role="commit-message">added support for customisation in image handling</phrase></screen>
\r
2479 <para><literal>Steve Ball: blocks2dbk.xsl</literal></para><screen><phrase role="commit-message">Added inlinemediaobject support for metadata.</phrase></screen>
\r
2482 <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>
\r
2485 </sect2><!--end of Roundtrip changes for 1.74.0-->
\r
2487 <sect2 xml:id="V1.74.0_Slides">
\r
2488 <title>Slides</title>
\r
2489 <para>The following changes have been made to the
\r
2490 <filename>slides</filename> code
\r
2491 since the 1.73.2 release.</para>
\r
2494 <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
\r
2495 under Cygwin. This stuff is ugly and maybe not worth the mess and
\r
2496 trouble, but does seem to work as expected and not break anything
\r
2497 else.</phrase></screen>
\r
2500 <para><literal>Jirka Kosek: html/plain.xsl</literal></para><screen><phrase role="commit-message">Added support for showing foil number</phrase></screen>
\r
2503 </sect2><!--end of Slides changes for 1.74.0-->
\r
2505 <sect2 xml:id="V1.74.0_Website">
\r
2506 <title>Website</title>
\r
2507 <para>The following changes have been made to the
\r
2508 <filename>website</filename> code
\r
2509 since the 1.73.2 release.</para>
\r
2512 <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>
\r
2515 </sect2><!--end of Website changes for 1.74.0-->
\r
2517 <sect2 xml:id="V1.74.0_Params">
\r
2518 <title>Params</title>
\r
2519 <para>The following changes have been made to the
\r
2520 <filename>params</filename> code
\r
2521 since the 1.73.2 release.</para>
\r
2523 <listitem> <para><literal>Keith Fahlgren: epub.autolabel.xml</literal></para><screen><phrase role="commit-message">New parameter for epub, epub.autolabel</phrase></screen> </listitem>
\r
2525 <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>
\r
2528 <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>
\r
2531 <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>
\r
2534 <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,
\r
2535 changed the default font formatting for links to bold.</phrase></screen>
\r
2538 <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
\r
2539 base URL for relative links (for ulink, @xlink:href, imagedata,
\r
2540 audiodata, videodata) shown in the generated NOTES section of
\r
2541 man-page output. The value of man.base.url.for.relative.links is
\r
2542 prepended to any relative URI that is a value of ulink url,
\r
2543 xlink:href, or fileref attribute.
\r
2545 If you use relative URIs in link sources in your DocBook refentry
\r
2546 source, and you leave man.base.url.for.relative.links unset, the
\r
2547 relative links will appear "as is" in the NOTES section of any
\r
2548 man-page output generated from your source. That's probably not
\r
2549 what you want, because such relative links are only usable in the
\r
2550 context of HTML output. So, to make the links meaningful and
\r
2551 usable in the context of man-page output, set a value for
\r
2552 man.base.url.for.relative.links that points
\r
2553 to the online version of HTML output generated from your DocBook
\r
2554 refentry source. For example:
\r
2556 <xsl:param name="man.base.url.for.relative.links"
\r
2557 >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param></phrase></screen>
\r
2560 <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
\r
2561 line of whitespace from being inserted after programlisting etc.
\r
2562 in certain cases)</phrase></screen>
\r
2565 <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
\r
2566 "source" or "manual" metadata fields</phrase></screen>
\r
2569 <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
\r
2570 man.charmap.subset.profile.english param</phrase></screen>
\r
2573 <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
\r
2574 the handling of charmap subsets to differentiate between English
\r
2575 and non-English source.
\r
2577 This way charmap subsets are now handled is this:
\r
2579 If the value of the man.charmap.use.subset parameter is non-zero,
\r
2580 and your DocBook source is not written in English (that is, if its
\r
2581 lang or xml:lang attribute has a value other than en), then the
\r
2582 character-map subset specified by the man.charmap.subset.profile
\r
2583 parameter is used instead of the full roff character map.
\r
2585 Otherwise, if the lang or xml:lang attribute on the root element
\r
2586 in your DocBook source or on the first refentry element in your
\r
2587 source has the value en or if it has no lang or xml:lang
\r
2588 attribute, then the character-map subset specified by the
\r
2589 man.charmap.subset.profile.english parameter is used instead of
\r
2590 man.charmap.subset.profile.
\r
2592 The difference between the two subsets is that
\r
2593 man.charmap.subset.profile provides mappings for characters in
\r
2594 Western European languages that are not part of the Roman
\r
2595 (English) alphabet (ASCII character set).</phrase></screen>
\r
2598 <para><literal>Michael(tm) Smith: man.charmap.subset.profile.xml</literal></para><screen><phrase role="commit-message">Added to default charmap used by manpages:
\r
2600 - the "letters" part of the 'C1 Controls And Latin-1 Supplement
\r
2601 (Latin-1 Supplement)' Unicode block
\r
2602 - Latin Extended-A block (but not all of the characters from
\r
2603 that block have mappings in groff, so some of them are still
\r
2604 passed through as-is)
\r
2606 The effects of this change are that in man pages generated for
\r
2607 most Western European languages and for Finnish, all characters
\r
2608 not part of the Roman alphabet are (e.g., "accented" characters)
\r
2609 are converted to groff escapes.
\r
2611 Previously, by default we passed through those characters as is
\r
2612 (and users needed to use the full charmap if they wanted to have
\r
2613 those characters converted).
\r
2615 As a result of this change, man pages generated for Western
\r
2616 European languages will be viewable in some environments in which
\r
2617 they are not viewable if the "raw" non-Roman characters are in them.</phrase></screen>
\r
2620 <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>
\r
2623 <para><literal>Mauritz Jeanson: default.table.width.xml</literal></para><screen><phrase role="commit-message">Clarified PI usage.</phrase></screen>
\r
2626 <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
\r
2627 manpages output as the funcsynopsis.style parameter has in HTML
\r
2628 output -- except that its default value is 'ansi' instead of 'kr'.</phrase></screen>
\r
2631 <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
\r
2632 being used in the code and hasn't been since mid 2006.</phrase></screen>
\r
2635 <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
\r
2636 default value for tables.</phrase></screen>
\r
2639 <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>
\r
2642 <para><literal>Mauritz Jeanson: manifest.in.base.dir.xml</literal></para><screen><phrase role="commit-message">Wording fixes.</phrase></screen>
\r
2645 <para><literal>Mauritz Jeanson: header.content.properties.xml; footer.content.properties.xml</literal></para><screen><phrase role="commit-message">Added refpurpose.</phrase></screen>
\r
2648 <para><literal>Mauritz Jeanson: ulink.footnotes.xml; ulink.show.xml</literal></para><screen><phrase role="commit-message">Updated for DocBook 5.</phrase></screen>
\r
2651 <para><literal>Mauritz Jeanson: index.method.xml; glossterm.auto.link.xml</literal></para><screen><phrase role="commit-message">Spelling and wording fixes.</phrase></screen>
\r
2654 <para><literal>Mauritz Jeanson: callout.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Clarifed available graphics formats and extensions.</phrase></screen>
\r
2657 <para><literal>Mauritz Jeanson: footnote.sep.leader.properties.xml</literal></para><screen><phrase role="commit-message">Corrected refpurpose.</phrase></screen>
\r
2660 <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>
\r
2663 <para><literal>Mauritz Jeanson: img.src.path.xml</literal></para><screen><phrase role="commit-message">img.src.path works with inlinegraphic too.</phrase></screen>
\r
2666 <para><literal>Mauritz Jeanson: saxon.character.representation.xml</literal></para><screen><phrase role="commit-message">Added TCG link.</phrase></screen>
\r
2669 <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
\r
2670 there was a risk of misunderstanding how it works.</phrase></screen>
\r
2673 </sect2><!--end of Params changes for 1.74.0-->
\r
2675 <sect2 xml:id="V1.74.0_Profiling">
\r
2676 <title>Profiling</title>
\r
2677 <para>The following changes have been made to the
\r
2678 <filename>profiling</filename> code
\r
2679 since the 1.73.2 release.</para>
\r
2682 <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>
\r
2685 <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
\r
2686 they can be more easily customized.</phrase></screen>
\r
2689 </sect2><!--end of Profiling changes for 1.74.0-->
\r
2692 <sect2 xml:id="V1.74.0_Tools">
\r
2693 <title>Tools</title>
\r
2694 <para>The following changes have been made to the
\r
2695 <filename>tools</filename> code
\r
2696 since the 1.73.2 release.</para>
\r
2699 <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
\r
2700 an input format</phrase></screen>
\r
2703 <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>
\r
2706 <para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">Reworked handling of K&R funcprototype output. It no longer relies
\r
2707 on the HTML kr-tabular templates, but instead just does direct
\r
2708 transformation to roff. For K&R output, it displays the paramdef
\r
2709 output in an indented list following the prototype.</phrase></screen>
\r
2712 <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
\r
2713 reference documentation.</phrase></screen>
\r
2716 <para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">use .BI handling in K&R funsynopsis output for manpages, just as
\r
2717 we do already of ANSI output</phrase></screen>
\r
2720 <para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">Implemented initial support for handling tabular K&R output of
\r
2721 funcprototype in manpages output. Accomplished by adding more
\r
2722 templates to the intermediate HTML-to-roff stylesheet that the
\r
2723 build uses to create the manpages/html-synop.xsl stylesheet.</phrase></screen>
\r
2726 <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
\r
2727 import profile-docbook.xsl, so that we can do profiling of release
\r
2728 notes. Corrected some problems in the target for the release-notes
\r
2729 HTML build.</phrase></screen>
\r
2732 </sect2><!--end of Tools changes for 1.74.0-->
\r
2734 <sect2 xml:id="V1.74.0_Extensions">
\r
2735 <title>Extensions</title>
\r
2736 <para>The following changes have been made to the
\r
2737 <filename>extensions</filename> code
\r
2738 since the 1.73.2 release.</para>
\r
2740 <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>
\r
2742 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">moved extensions build targets from master xsl/Makefile to
\r
2743 xsl/extensions/Makefile</phrase></screen>
\r
2746 <para><literal>Michael(tm) Smith: .cvsignore</literal></para><screen><phrase role="commit-message">re-adding empty extensions subdir</phrase></screen>
\r
2749 </sect2><!--end of Extensions changes for 1.74.0-->
\r
2751 <sect2 xml:id="V1.74.0_XSL-Saxon">
\r
2752 <title>XSL-Saxon</title>
\r
2753 <para>The following changes have been made to the
\r
2754 <filename>xsl-saxon</filename> code
\r
2755 since the 1.73.2 release.</para>
\r
2758 <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
\r
2759 recent change to snapshot build infrastructure</phrase></screen>
\r
2762 <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
\r
2763 references. Closes #1792043. Thanks to Daniel Leidert.</phrase></screen>
\r
2766 <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>
\r
2769 <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>
\r
2772 </sect2><!--end of XSL-Saxon changes for 1.74.0-->
\r
2774 <sect2 xml:id="V1.74.0_XSL-Xalan">
\r
2775 <title>XSL-Xalan</title>
\r
2776 <para>The following changes have been made to the
\r
2777 <filename>xsl-xalan</filename> code
\r
2778 since the 1.73.2 release.</para>
\r
2781 <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
\r
2782 recent change to snapshot build infrastructure</phrase></screen>
\r
2785 <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
\r
2786 references. Closes #1792043. Thanks to Daniel Leidert.</phrase></screen>
\r
2789 <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>
\r
2792 <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>
\r
2795 </sect2><!--end of XSL-Xalan changes for 1.74.0-->
\r
2797 <sect2 xml:id="V1.74.0_XSL-libxslt">
\r
2798 <title>XSL-libxslt</title>
\r
2799 <para>The following changes have been made to the
\r
2800 <filename>xsl-libxslt</filename> code
\r
2801 since the 1.73.2 release.</para>
\r
2804 <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.
\r
2805 Some unnecessary semicolons removed.</phrase></screen>
\r
2808 <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).
\r
2809 Replaced deprecated functions from the string module with string methods.</phrase></screen>
\r
2812 <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>
\r
2815 <para><literal>Mauritz Jeanson: python/README</literal></para><screen><phrase role="commit-message">Tweaked the text a little.</phrase></screen>
\r
2818 </sect2><!--end of XSL-libxslt changes for 1.74.0-->
\r
2822 <sect1 xml:id="V1.73.2">
\r
2823 <title>Release Notes: 1.73.2</title>
\r
2824 <para>This is solely a minor bug-fix update to the 1.73.1 release.
\r
2825 It fixes a packaging error in the 1.73.1 package, as well as a
\r
2826 bug in footnote handling in FO output.</para>
\r
2829 <sect1 xml:id="V1.73.1">
\r
2830 <title>Release: 1.73.1</title>
\r
2831 <para>This is mostly a bug-fix update to the 1.73.0 release.</para>
\r
2833 <sect2 xml:id="V1.73.1_Gentext">
\r
2834 <title>Gentext</title>
\r
2835 <para>The following changes have been made to the
\r
2836 <filename>gentext</filename> code
\r
2837 since the 1.73.0 release.</para>
\r
2840 <para><literal>Mauritz Jeanson: locale/de.xml</literal></para><screen><phrase role="commit-message">Applied patch #1766009.</phrase></screen>
\r
2843 <para><literal>Michael(tm) Smith: locale/lv.xml</literal></para><screen><phrase role="commit-message">Added localization for <tag>ProductionSet</tag>.</phrase></screen>
\r
2846 </sect2><!--end of Gentext changes for 1.73.1-->
\r
2848 <sect2 xml:id="V1.73.1_FO">
\r
2850 <para>The following changes have been made to the
\r
2851 <filename>fo</filename> code
\r
2852 since the 1.73.0 release.</para>
\r
2855 <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,
\r
2856 a width attribute is output on all corresponding fo:tables. Previously,
\r
2857 there was a test prohibiting this (and a comment saying that outputting more
\r
2858 than one width attribute will cause an error). But this seems to be no longer
\r
2859 relevant; it is not a problem with FOP 0.93 or XEP 4.10. Closes bug #1760559.</phrase></screen>
\r
2862 <para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Replaced useless <a> elements with warning messages (textinsert extension).</phrase></screen>
\r
2865 <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
\r
2866 references in the <tag>index</tag> can be created. Closes bug #1775086.</phrase></screen>
\r
2869 </sect2><!--end of FO changes for 1.73.1-->
\r
2871 <sect2 xml:id="V1.73.1_HTML">
\r
2872 <title>HTML</title>
\r
2873 <para>The following changes have been made to the
\r
2874 <filename>html</filename> code
\r
2875 since the 1.73.0 release.</para>
\r
2878 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added <xsl:call-template name="process.footnotes"/> to <tag>abstract</tag> template
\r
2879 so that footnotes in <tag>info</tag>/<tag>abstract</tag> are processed. Closes bug #1760907.</phrase></screen>
\r
2882 <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
\r
2883 <tag>funcsynopsis</tag> elements, such that a@id instances are generated for
\r
2884 them if they are descendants of any element containing a dbcmdlist
\r
2885 or dbfunclist PI. Also, update the embedded <tag>reference</tag> docs for the
\r
2886 dbcmdlist and dbfunclist PIs to make it clear that they can be
\r
2887 used within any element for which <tag>cmdsynopsis</tag> or <tag>funcsynopsis</tag> are
\r
2888 valid children.</phrase></screen>
\r
2891 <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
\r
2892 generated for output of informal objects. Thanks to Sam Steingold
\r
2893 for reporting.</phrase></screen>
\r
2896 <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>
\r
2899 <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
\r
2900 in the same way as for <tag>revhistory</tag> chunks. Using <xsl:apply-templates
\r
2901 mode="chunk-filename" select="."/> did not work for single-page output since
\r
2902 the template with that mode is in chunk-code.xsl.</phrase></screen>
\r
2905 <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).
\r
2906 Added support for MathML in <tag>imagedata</tag>.</phrase></screen>
\r
2909 <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).
\r
2910 (The two templates matching 'dbhh' are still in htmlhelp-common.xsl).</phrase></screen>
\r
2913 </sect2><!--end of HTML changes for 1.73.1-->
\r
2915 <sect2 xml:id="V1.73.1_Manpages">
\r
2916 <title>Manpages</title>
\r
2917 <para>The following changes have been made to the
\r
2918 <filename>manpages</filename> code
\r
2919 since the 1.73.0 release.</para>
\r
2922 <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">In manpages output, generate warnings about notesources with
\r
2923 non-para children only if the notesource is a <tag>footnote</tag> or
\r
2924 <tag>annotation</tag>. Thanks to Sam Steingold for reporting problems with
\r
2925 the existing handling.</phrase></screen>
\r
2928 </sect2><!--end of Manpages changes for 1.73.1-->
\r
2930 <sect2 xml:id="V1.73.1_HTMLHelp">
\r
2931 <title>HTMLHelp</title>
\r
2932 <para>The following changes have been made to the
\r
2933 <filename>htmlhelp</filename> code
\r
2934 since the 1.73.0 release.</para>
\r
2937 <para><literal>Michael(tm) Smith: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
\r
2938 eclipse, and javahelp stylesheets.</phrase></screen>
\r
2941 </sect2><!--end of HTMLHelp changes for 1.73.1-->
\r
2943 <sect2 xml:id="V1.73.1_Eclipse">
\r
2944 <title>Eclipse</title>
\r
2945 <para>The following changes have been made to the
\r
2946 <filename>eclipse</filename> code
\r
2947 since the 1.73.0 release.</para>
\r
2950 <para><literal>Michael(tm) Smith: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
\r
2951 eclipse, and javahelp stylesheets.</phrase></screen>
\r
2954 </sect2><!--end of Eclipse changes for 1.73.1-->
\r
2956 <sect2 xml:id="V1.73.1_JavaHelp">
\r
2957 <title>JavaHelp</title>
\r
2958 <para>The following changes have been made to the
\r
2959 <filename>javahelp</filename> code
\r
2960 since the 1.73.0 release.</para>
\r
2963 <para><literal>Michael(tm) Smith: javahelp.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
\r
2964 eclipse, and javahelp stylesheets.</phrase></screen>
\r
2967 </sect2><!--end of JavaHelp changes for 1.73.1-->
\r
2969 <sect2 xml:id="V1.73.1_Roundtrip">
\r
2970 <title>Roundtrip</title>
\r
2971 <para>The following changes have been made to the
\r
2972 <filename>roundtrip</filename> code
\r
2973 since the 1.73.0 release.</para>
\r
2976 <para><literal>Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; pages2normalise.xsl</literal></para><screen><phrase role="commit-message">Modularised blocks2dbk to allow customisation,
\r
2977 Added support for tables to pages2normalise</phrase></screen>
\r
2980 </sect2><!--end of Roundtrip changes for 1.73.1-->
\r
2982 <sect2 xml:id="V1.73.1_Params">
\r
2983 <title>Params</title>
\r
2984 <para>The following changes have been made to the
\r
2985 <filename>params</filename> code
\r
2986 since the 1.73.0 release.</para>
\r
2989 <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
\r
2990 a <tag>procedure</tag> does not need to be kept together by default.</phrase></screen>
\r
2993 <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>
\r
2996 </sect2><!--end of Params changes for 1.73.1-->
\r
2999 <sect1 xml:id="V1.73.0">
\r
3000 <title>Release: 1.73.0</title>
\r
3001 <para>This release includes important bug fixes and adds the following
\r
3002 significant feature changes:
\r
3005 <term>New localizations and localization updates</term>
\r
3007 <para>We added two new localizations: Latvian and
\r
3008 Esperanto, and made updates to the Czech, Chinese
\r
3009 Simplified, Mongolian, Serbian, Italian, and Ukrainian
\r
3010 localizations.</para>
\r
3014 <term>ISO690 citation style for bibliography output.</term>
\r
3017 <parameter>bibliography.style</parameter> parameter to
\r
3018 <literal>iso690</literal> to use ISO690 style.</para>
\r
3022 <term>New documentation for processing instructions (PI)</term>
\r
3024 <para>The reference documentation that ships with the
\r
3025 release now includes <link
\r
3026 xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/pi/"
\r
3027 >documentation on all PIs</link> that you can use to
\r
3028 control output from the stylesheets.</para>
\r
3032 <term>New profiling parameters for <literal>audience</literal> and <literal>wordsize</literal></term>
\r
3034 <para>You can now do profiling based on the values of the
\r
3035 <literal>audience</literal> and
\r
3036 <literal>wordsize</literal> attributes.</para>
\r
3040 <term>Changes to man-page output</term>
\r
3042 <para>The manpages stylesheet now supports single-pass
\r
3043 profiling and single-pass DocBook 5 namespace stripping
\r
3044 (just as the HTML and FO stylesheets also do). Also, added
\r
3045 handling for <tag>mediaobject</tag> &
\r
3046 <tag>inlinemediaobject</tag>. (Each <tag>imagedata</tag>,
\r
3047 <tag>audiodata</tag>, or <tag>videodata</tag> element
\r
3048 within a <tag>mediaobject</tag> or inline
\r
3049 <tag>mediaobject</tag> is now treated as a "notesource"
\r
3050 and so handled in much the same way as links and
\r
3051 <tag>annotation</tag>/<tag>alt</tag>/<tag>footnote</tag>
\r
3052 are in manpages output.) And added the
\r
3053 <parameter>man.authors.section.enabled</parameter> and
\r
3054 <parameter>man.copyright.section.enabled</parameter>
\r
3055 parameters to enable control over whether output includes
\r
3056 auto-generated <literal>AUTHORS</literal> and
\r
3057 <literal>COPYRIGHT</literal> sections.</para>
\r
3061 <term>Highlighting support for C</term>
\r
3063 <para>The highlighting mechanism for generating
\r
3064 syntax-highlighted code snippets in output now supports C
\r
3065 code listings (along with Java, PHP, XSLT, and others).</para>
\r
3069 <term>Experimental <literal>docbook-xsl-update script</literal></term>
\r
3071 <para>We added an experimental <literal>docbook-xsl-update
\r
3072 script</literal>, the purpose of which is to facilitate
\r
3073 easy sync-up to the latest docbook-xsl snapshot (by means
\r
3080 <sect2 xml:id="V1.73.0_Gentext">
\r
3081 <title>Gentext</title>
\r
3082 <para>The following changes have been made to the
\r
3083 <filename>gentext</filename> code
\r
3084 since the 1.72.0 release.</para>
\r
3087 <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>
\r
3090 <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>
\r
3093 <para><literal>Jirka Kosek: locale/cs.xml</literal></para><screen><phrase role="commit-message">Added missing translations</phrase></screen>
\r
3096 <para><literal>Robert Stayton: locale/eo.xml</literal></para><screen><phrase role="commit-message">New locale for Esperanto.</phrase></screen>
\r
3099 <para><literal>Robert Stayton: locale/mn.xml</literal></para><screen><phrase role="commit-message">Update from Ganbold Tsagaankhuu.</phrase></screen>
\r
3102 <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>
\r
3105 <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>
\r
3108 <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>
\r
3111 <para><literal>Robert Stayton: locale/it.xml</literal></para><screen><phrase role="commit-message">Improved version from contributor.</phrase></screen>
\r
3114 <para><literal>Mauritz Jeanson: locale/uk.xml</literal></para><screen><phrase role="commit-message">Applied patch 1592083.</phrase></screen>
\r
3117 </sect2><!--end of Gentext changes for 1.73.0-->
\r
3118 <sect2 xml:id="V1.73.0_Common">
\r
3119 <title>Common</title>
\r
3120 <para>The following changes have been made to the
\r
3121 <filename>common</filename> code
\r
3122 since the 1.72.0 release.</para>
\r
3125 <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>
\r
3126 (when it appears at the component level) is now affected by the
\r
3127 <parameter>label.from.part</parameter> param, just as <tag>preface</tag>, <tag>chapter</tag>, and <tag>appendix</tag>.</phrase></screen>
\r
3130 <para><literal>Michael(tm) Smith: common.xsl</literal></para><screen><phrase role="commit-message">Added support to the HTML stylesheets for proper processing of
\r
3131 <tag>orgname</tag> as a child of <tag>author</tag>.</phrase></screen>
\r
3134 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Refined logging output of <tag>refentry</tag> metadata-gathering template;
\r
3135 for some cases of "missing" elements (<tag>refmiscinfo</tag> stuff, etc.),
\r
3136 the log messages now include URL to corresponding page in the
\r
3137 Definitive Guide (TDG).</phrase></screen>
\r
3140 <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>
\r
3143 <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
\r
3144 contain <tag>info</tag>/<tag>title</tag> descendants but no <tag>title</tag> children.
\r
3146 This should be further refined so that it handles any *<tag>info</tag>
\r
3147 elements. And there are probably some other places where similar
\r
3148 handling for *<tag>info</tag>/<tag>title</tag> should be added.</phrase></screen>
\r
3151 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Modified <xsl:when> in datetime.format template to work
\r
3152 around Xalan bug.</phrase></screen>
\r
3155 </sect2><!--end of Common changes for 1.73.0-->
\r
3156 <sect2 xml:id="V1.73.0_FO">
\r
3158 <para>The following changes have been made to the
\r
3159 <filename>fo</filename> code
\r
3160 since the 1.72.0 release.</para>
\r
3163 <para><literal>Robert Stayton: component.xsl</literal></para><screen><phrase role="commit-message">Add parameters to the page.sequence utility template.</phrase></screen>
\r
3166 <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>.
\r
3167 Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
\r
3170 <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>
\r
3173 <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>
\r
3176 <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>
\r
3179 <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Make citations numbered if <parameter>bibliography.numbered</parameter> != 0.</phrase></screen>
\r
3182 <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>
\r
3185 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added <parameter>callout.icon.size</parameter> parameter.</phrase></screen>
\r
3188 <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>
\r
3191 <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>
\r
3194 <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>
\r
3197 <para><literal>Robert Stayton: division.xsl</literal></para><screen><phrase role="commit-message">Refactored the big <tag>book</tag> template into smaller pieces.
\r
3198 Used the "page.sequence" utility template in
\r
3199 component.xsl to shorten the <tag>toc</tag> piece.
\r
3200 Added placeholder templates for front.cover and back.cover.</phrase></screen>
\r
3203 <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
\r
3204 pgwide spans inside sections.</phrase></screen>
\r
3207 <para><literal>Robert Stayton: param.xweb; param.ent; component.xsl</literal></para><screen><phrase role="commit-message">Add component.titlepage.properties attribute-set to
\r
3208 support span="all" and other properties.</phrase></screen>
\r
3211 <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.
\r
3212 Add keep-with-next to table.row.properties when <tag>row</tag> is in <tag>thead</tag>.</phrase></screen>
\r
3215 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support for <parameter>default.table.frame</parameter> parameter.
\r
3216 Fix bug 1575446 rowsep last check for @morerows.</phrase></screen>
\r
3219 <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>
\r
3222 <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>
\r
3225 <para><literal>Jirka Kosek: lists.xsl</literal></para><screen><phrase role="commit-message">Added missing attribute set for <tag>procedure</tag></phrase></screen>
\r
3228 <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.
\r
3229 New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
\r
3230 The code was provided by Jana Dvorakova</phrase></screen>
\r
3233 <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>
\r
3236 <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>
\r
3239 </sect2><!--end of FO changes for 1.73.0-->
\r
3240 <sect2 xml:id="V1.73.0_HTML">
\r
3241 <title>HTML</title>
\r
3242 <para>The following changes have been made to the
\r
3243 <filename>html</filename> code
\r
3244 since the 1.72.0 release.</para>
\r
3247 <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
\r
3248 regular "parameter machinery".</phrase></screen>
\r
3251 <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>,
\r
3252 <tag>tip</tag> admonitions: We now output and HTML h3 head only if
\r
3253 <parameter>admon.textlabel</parameter> is non-zero or if the admonition actually contains
\r
3254 a <tag>title</tag>; otherwise, we don't output an h3 head at all.
\r
3255 (Previously, we were outputting an empty h3 if the <parameter>admon.textlabel</parameter>
\r
3256 was zero and if the admonition had no title.)</phrase></screen>
\r
3259 <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>.
\r
3260 Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
\r
3263 <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.
\r
3264 This (hopefully) closes bug #1671052.</phrase></screen>
\r
3267 <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
\r
3268 dbfunclist and dbcmdlist PIs.</phrase></screen>
\r
3271 <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
\r
3272 to work. Restored dbhtml-dir template back to pi.xsl.</phrase></screen>
\r
3275 <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>.
\r
3276 If non-zero, in output of the <tag>abstract</tag> element on titlepages,
\r
3277 display of the <tag>abstract</tag> <tag>title</tag> is suppressed.
\r
3278 Because sometimes you really don't want or need that <tag>title</tag>
\r
3279 there...</phrase></screen>
\r
3282 <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
\r
3283 into separate HTML output files, and <parameter>use.id.as.filename</parameter> is
\r
3284 non-zero, if a <tag>mediaobject</tag> has an ID, use that ID as the basename
\r
3285 for the long-description file (otherwise, we generate an ID for it
\r
3286 and use that ID as the basename for the file).
\r
3287 The parallels the recent change made to cause IDs for <tag>legalnotice</tag>
\r
3288 instances to be used as basenames for <tag>legalnotice</tag> chunks.
\r
3289 Also, made some minor refinements to the recent changes for
\r
3290 <tag>legalnotice</tag> chunk handling.</phrase></screen>
\r
3293 <para><literal>Michael(tm) Smith: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added support to the HTML stylesheets for proper processing of
\r
3294 <tag>orgname</tag> as a child of <tag>author</tag>.</phrase></screen>
\r
3297 <para><literal>Michael(tm) Smith: chunk-code.xsl</literal></para><screen><phrase role="commit-message">When $generate.legalnotice.link is non-zero and
\r
3298 $use.id.as.filename is also non-zero, if a <tag>legalnotice</tag> has an ID,
\r
3299 then instead of assigning the "ln-<generatedID>" basename to the
\r
3300 output file for that <tag>legalnotice</tag>, just use its real ID as the
\r
3301 basename for the file -- as we do when chunking other elements
\r
3302 that have IDs.</phrase></screen>
\r
3305 <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>
\r
3308 <para><literal>David Cramer: lists.xsl</literal></para><screen><phrase role="commit-message">Added <p> 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>
\r
3311 <para><literal>David Cramer: qandaset.xsl</literal></para><screen><phrase role="commit-message">Added <p> 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>
\r
3314 <para><literal>David Cramer: lists.xsl</literal></para><screen><phrase role="commit-message">Added <p> element around callouts to avoid misalignment of <tag>callout</tag> and <tag>listitem</tag> in xhtml (non-quirks mode) output</phrase></screen>
\r
3317 <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Make citations numbered if <parameter>bibliography.numbered</parameter> != 0.</phrase></screen>
\r
3320 <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>
\r
3323 <para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add support for xlink olinks.</phrase></screen>
\r
3326 <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>
\r
3329 <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
\r
3330 chunk-common.xsl and all match templates to chunk-code.xsl, in
\r
3331 order to enable better chunk customization.
\r
3332 See the comments in chunk.xsl for more details.</phrase></screen>
\r
3335 <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>
\r
3338 <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>
\r
3341 <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.
\r
3342 New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
\r
3343 The code was provided by Jana Dvorakova</phrase></screen>
\r
3346 <para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add call to class.attribute to <a> output elements so they can
\r
3347 have a class value too.</phrase></screen>
\r
3350 <para><literal>Mauritz Jeanson: glossary.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1644881:
\r
3351 * Added curly braces around all $language attribute values.
\r
3352 * Moved declaration of language variable to top level of stylesheet.
\r
3353 Tested with Xalan, Saxon, and xsltproc.</phrase></screen>
\r
3356 </sect2><!--end of HTML changes for 1.73.0-->
\r
3357 <sect2 xml:id="V1.73.0_Manpages">
\r
3358 <title>Manpages</title>
\r
3359 <para>The following changes have been made to the
\r
3360 <filename>manpages</filename> code
\r
3361 since the 1.72.0 release.</para>
\r
3364 <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
\r
3365 <parameter>man.copyright.section.enabled</parameter> parameters. Set those to zero when
\r
3366 you want to suppress display of the auto-generated AUTHORS and
\r
3367 <tag>COPYRIGHT</tag> sections. Closes request #1467806. Thanks to Daniel
\r
3368 Leidert.</phrase></screen>
\r
3371 <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
\r
3372 are any <tag>Refentry</tag> chilren in current doc, and made it
\r
3373 namespace-agnostic. Reason for that is because the test otherwise
\r
3374 won't work when it is copied over into the generated
\r
3375 profile-docbook.xsl stylesheet.</phrase></screen>
\r
3378 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">Added a manpages/profile-docbook.xsl file to enable single-pass
\r
3379 profiling for manpages output.</phrase></screen>
\r
3382 <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
\r
3383 place they are in in document order. Closes #1690539. Thanks to
\r
3384 Daniel Leidert for reporting.</phrase></screen>
\r
3387 <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">Restored support for single-pass namespace stripping to manpages
\r
3388 stylesheet.</phrase></screen>
\r
3391 <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
\r
3392 output. Should be transparent to users, but...
\r
3394 This touches handling of all bold and italic/underline output. The
\r
3395 exact change is that the mode="bold" and mode="italic" utility
\r
3396 templates were changed to named templates. (I think maybe I've
\r
3397 changed it back and forth from mode to named before, so this is
\r
3398 maybe re-reverting it yet again).
\r
3400 Anyway, the reason for the change is that the templates are
\r
3401 sometimes call on dynamically node-sets, and using modes to format
\r
3402 those doesn't allow passing <tag>info</tag> about the current/real context
\r
3403 node from the source (not the node-set created by the stylesheet)
\r
3404 to that formatting stage.
\r
3406 The named templates allow the context to be passed in as a
\r
3407 parameter, so that the bold/ital formatting template can use
\r
3408 context-aware condition checking.
\r
3410 This was basically necessary in order to suppress bold formatting
\r
3411 in titles, which otherwise gets screwed up because of the numbnut
\r
3412 way that roff handles nested bold/ital.
\r
3414 Closes #1674534). Much thanks to Daniel Leidert, whose in his
\r
3415 docbook-xsl bug-finding kung-fu has achieved Grand Master status.</phrase></screen>
\r
3418 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">Fixed handling of example instances by adding the example element
\r
3419 to the same template we use for processing <tag>figure</tag>. Closes
\r
3420 #1674538. Thanks to Daniel Leidert.</phrase></screen>
\r
3423 <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
\r
3424 is, only generate lang-qualified file-/pathnames for non-English).</phrase></screen>
\r
3427 <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.)
\r
3428 that have something other than <tag>para</tag> as a child.
\r
3430 The numbered-with-hanging-indent formatting that's used for
\r
3431 rendering endnotes in the NOTES <tag>section</tag> of man pages places some
\r
3432 limits/assumptions on how the DocBook source is marked up; namely,
\r
3433 for notesources (<tag>footnote</tag>, <tag>annotation</tag>, etc.) that can contain
\r
3434 block-level children, if the they have a block-level child such as
\r
3435 a <tag>table</tag> or <tag>itemizedlist</tag> or <tag>orderedlist</tag> that is the first child of
\r
3436 a <tag>footnote</tag>, we have no way of rendering/indenting its content
\r
3437 properly in the endnotes list.
\r
3439 Thus, the manpages stylesheet not emits a warning message for that
\r
3440 case, and suggests the "fix" (which is to wrap the <tag>table</tag> or
\r
3441 <tag>itemizedlist</tag> or whatever in a <tag>para</tag> that has some preferatory text.</phrase></screen>
\r
3444 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">Added support to mixed-block template for handling tables in
\r
3445 mixed-blocks (e.g., as child of <tag>para</tag>) correctly.</phrase></screen>
\r
3448 <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
\r
3449 out of the well-intentioned (but it now appears,
\r
3450 misguided) "marker" mechanism (introduced in the 1.72.0
\r
3451 release) -- which made use of alternative "marker"
\r
3452 characters as internal representations of those
\r
3453 characters, and then replaced them just prior to
\r
3454 serialization -- and back into what's basically the
\r
3455 system that was used prior to the 1.69.0 release; that
\r
3456 is, into a part of stylesheet code that gets executed
\r
3457 at the beginning of processing -- before any other roff
\r
3458 markup up is. This change obviates the need for the
\r
3459 marker system. It also requires a lot less RAM during
\r
3460 processing (for large files, the marker mechanism
\r
3461 ending up requiring gigabytes of memory).
\r
3463 Closes bug #1661177. Thanks to Scott Smedley for
\r
3464 providing a test case (the fvwm man page) that exposed
\r
3465 the problem with the marker mechanism.
\r
3467 Also moved the mechanism for converting non-breaking
\r
3468 spaces back into the same <tag>area</tag> of the stylesheet code.</phrase></screen>
\r
3471 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed problem with incorrect formatting of nested <tag>variablelist</tag>.
\r
3472 Closes bug #1650931. Thanks to Daniel "Eagle Eye" Leidert.</phrase></screen>
\r
3475 <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
\r
3476 preceded by a blank line. This fixes a regression that occurred
\r
3477 when instances of the TP macro that were use in a previous
\r
3478 versions of the list-handling code were switched to RS/RE (because
\r
3479 TP doesn't support nesting). TP automatically generates a blank
\r
3480 line, but RS doesn't. So I added a .sp before each .RS</phrase></screen>
\r
3483 <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
\r
3484 out-of-line content:
\r
3486 - Added handling for <tag>mediaobject</tag> & <tag>inlinemediaobject</tag>.
\r
3487 Each <tag>imagedata</tag>, <tag>audiodata</tag>, or <tag>videodata</tag> element
\r
3488 within a <tag>mediaobject</tag> or inline <tag>mediaobject</tag> is now
\r
3489 treated as a "notesource" and so handled in much the
\r
3490 same way as links and <tag>annotation</tag>/<tag>alt</tag>/footnotes.
\r
3492 That means a numbered marker is generated inline to
\r
3493 mark the place in the main flow where the <tag>imagedata</tag>,
\r
3494 <tag>audiodata</tag>, or <tag>videodata</tag> element occurs, and a
\r
3495 corresponding numbered endnote for it is generated in
\r
3496 the endnotes list at the end of the man page; the
\r
3497 endnote contains the URL from the fileref attribute
\r
3498 of the <tag>imagedata</tag>, <tag>audiodata</tag>, or <tag>videodata</tag> element.
\r
3500 For mediobject and <tag>inlinemediaobject</tag> instances that
\r
3501 have a <tag>textobject</tag> child, the <tag>textobject</tag> is displayed
\r
3502 within the main text flow.
\r
3504 - Renamed several man.link.* params to man.endnotes.*,
\r
3505 to reflect that fact that the endnotes list now
\r
3506 contains more than just links. Also did similar
\r
3507 renaming for a number of stylesheet-internal vars.
\r
3509 - Added support for xlink:href (along with existing
\r
3510 support for the legacy ulink element).
\r
3512 - Cleaned up and streamlined the endnotes-handling
\r
3513 code. It's still messy and klunky and the basic
\r
3514 mechanism it uses is very inefficent for documents
\r
3515 that contain a lot of notesources, but at least it's
\r
3516 a bit better than it was.</phrase></screen>
\r
3519 </sect2><!--end of Manpages changes for 1.73.0-->
\r
3520 <sect2 xml:id="V1.73.0_Eclipse">
\r
3521 <title>Eclipse</title>
\r
3522 <para>The following changes have been made to the
\r
3523 <filename>eclipse</filename> code
\r
3524 since the 1.72.0 release.</para>
\r
3527 <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>
\r
3530 <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. <<tag>title</tag>> Foo</<tag>title</tag>>) in the source</phrase></screen>
\r
3533 </sect2><!--end of Eclipse changes for 1.73.0-->
\r
3534 <sect2 xml:id="V1.73.0_JavaHelp">
\r
3535 <title>JavaHelp</title>
\r
3536 <para>The following changes have been made to the
\r
3537 <filename>javahelp</filename> code
\r
3538 since the 1.72.0 release.</para>
\r
3541 <para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Implemented FR #1230233 (sorted <tag>index</tag> in javahelp).</phrase></screen>
\r
3544 <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.
\r
3545 Added support for <tag>glossary</tag> and <tag>bibliography</tag> in <tag>toc</tag> and map files.</phrase></screen>
\r
3548 </sect2><!--end of JavaHelp changes for 1.73.0-->
\r
3549 <sect2 xml:id="V1.73.0_Roundtrip">
\r
3550 <title>Roundtrip</title>
\r
3551 <para>The following changes have been made to the
\r
3552 <filename>roundtrip</filename> code
\r
3553 since the 1.72.0 release.</para>
\r
3556 <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>
\r
3559 <para><literal>Steve Ball: template-pages.xml; dbk2wp.xsl; sections-spec.xml</literal></para><screen><phrase role="commit-message">fixed bugs</phrase></screen>
\r
3562 </sect2><!--end of Roundtrip changes for 1.73.0-->
\r
3563 <sect2 xml:id="V1.73.0_Params">
\r
3564 <title>Params</title>
\r
3565 <para>The following changes have been made to the
\r
3566 <filename>params</filename> code
\r
3567 since the 1.72.0 release.</para>
\r
3570 <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>
\r
3573 <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>
\r
3576 <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
\r
3577 regular "parameter machinery".</phrase></screen>
\r
3580 <para><literal>Mauritz Jeanson: generate.id.attributes.xml</literal></para><screen><phrase role="commit-message">Added <tag>refpurpose</tag> text.</phrase></screen>
\r
3583 <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>
\r
3586 <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,
\r
3587 as pointed out by Dave Pawson.</phrase></screen>
\r
3590 <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>
\r
3591 (when it appears at the component level) is now affected by the
\r
3592 <parameter>label.from.part</parameter> param, just as <tag>preface</tag>, <tag>chapter</tag>, and <tag>appendix</tag>.</phrase></screen>
\r
3595 <para><literal>Mauritz Jeanson: callout.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Clarified that 'extension' refers to file names.</phrase></screen>
\r
3598 <para><literal>Michael(tm) Smith: abstract.notitle.enabled.xml</literal></para><screen><phrase role="commit-message">Added new param <parameter>abstract.notitle.enabled</parameter>.
\r
3599 If non-zero, in output of the <tag>abstract</tag> element on titlepages,
\r
3600 display of the <tag>abstract</tag> <tag>title</tag> is suppressed.
\r
3601 Because sometimes you really don't want or need that <tag>title</tag>
\r
3602 there...</phrase></screen>
\r
3605 <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
\r
3606 because of another recent change to suppress bold markup in .SH
\r
3607 output, we no longer need to add a workaround for the accidental
\r
3608 uppercasing of roff escapes that occurred previously.</phrase></screen>
\r
3611 <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>
\r
3614 <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>
\r
3617 <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>
\r
3620 <para><literal>Robert Stayton: callout.icon.size.xml</literal></para><screen><phrase role="commit-message">Set size of <tag>callout</tag> graphics.</phrase></screen>
\r
3623 <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>
\r
3626 <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>
\r
3629 <para><literal>Robert Stayton: section.container.element.xml</literal></para><screen><phrase role="commit-message">Support spans in sections for certain processors.</phrase></screen>
\r
3632 <para><literal>Robert Stayton: component.titlepage.properties.xml</literal></para><screen><phrase role="commit-message">Empty attribute set for top level component titlepage block.
\r
3633 Allows setting a span on <tag>title</tag> <tag>info</tag>.</phrase></screen>
\r
3636 <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>
\r
3639 <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>
\r
3642 <para><literal>Robert Stayton: id.warnings.xml</literal></para><screen><phrase role="commit-message">Turn off <parameter>id.warnings</parameter> by default.</phrase></screen>
\r
3645 <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.
\r
3646 New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
\r
3647 The code was provided by Jana Dvorakova</phrase></screen>
\r
3650 <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>
\r
3653 </sect2><!--end of Params changes for 1.73.0-->
\r
3654 <sect2 xml:id="V1.73.0_Highlighting">
\r
3655 <title>Highlighting</title>
\r
3656 <para>The following changes have been made to the
\r
3657 <filename>highlighting</filename> code
\r
3658 since the 1.72.0 release.</para>
\r
3661 <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>
\r
3664 </sect2><!--end of Highlighting changes for 1.73.0-->
\r
3665 <sect2 xml:id="V1.73.0_Profiling">
\r
3666 <title>Profiling</title>
\r
3667 <para>The following changes have been made to the
\r
3668 <filename>profiling</filename> code
\r
3669 since the 1.72.0 release.</para>
\r
3672 <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>
\r
3675 </sect2><!--end of Profiling changes for 1.73.0-->
\r
3676 <sect2 xml:id="V1.73.0_Lib">
\r
3677 <title>Lib</title>
\r
3678 <para>The following changes have been made to the
\r
3679 <filename>lib</filename> code
\r
3680 since the 1.72.0 release.</para>
\r
3683 <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
\r
3684 it can do both right/left padding.</phrase></screen>
\r
3687 </sect2><!--end of Lib changes for 1.73.0-->
\r
3688 <sect2 xml:id="V1.73.0_Tools">
\r
3689 <title>Tools</title>
\r
3690 <para>The following changes have been made to the
\r
3691 <filename>tools</filename> code
\r
3692 since the 1.72.0 release.</para>
\r
3695 <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
\r
3696 docbook-xsl-update script to the docbook-xsl distro, the purpose
\r
3697 of which is to facilitate easy sync-up to the latest docbook-xsl
\r
3698 snapshot (by means of rsync).</phrase></screen>
\r
3701 </sect2><!--end of Tools changes for 1.73.0-->
\r
3702 <sect2 xml:id="V1.73.0_XSL-Saxon">
\r
3703 <title>XSL-Saxon</title>
\r
3704 <para>The following changes have been made to the
\r
3705 <filename>xsl-saxon</filename> code
\r
3706 since the 1.72.0 release.</para>
\r
3709 <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
\r
3710 parameter is used for FO output (where SVG now is the default graphics format for callouts).</phrase></screen>
\r
3713 <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.
\r
3714 These patches enable cross-references to callouts placed by <tag>area</tag> coordinates.
\r
3715 It works for graphic, unicode and text callouts.
\r
3716 Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
\r
3719 <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>
\r
3722 </sect2><!--end of XSL-Saxon changes for 1.73.0-->
\r
3723 <sect2 xml:id="V1.73.0_XSL-Xalan">
\r
3724 <title>XSL-Xalan</title>
\r
3725 <para>The following changes have been made to the
\r
3726 <filename>xsl-xalan</filename> code
\r
3727 since the 1.72.0 release.</para>
\r
3730 <para><literal>Michael(tm) Smith: Makefile; xalan2</literal></para><screen><phrase role="commit-message">Turned off xalan2.jar build. This removes DocBook XSL
\r
3731 Java extensions support for versions of Xalan prior to
\r
3732 Xalan 2.7. If you are currently using the extensions
\r
3733 with an earlier version of Xalan, you need to upgrade
\r
3734 to Xalan 2.7.</phrase></screen>
\r
3737 <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
\r
3738 parameter is used for FO output (where SVG now is the default graphics format for callouts).</phrase></screen>
\r
3741 <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.
\r
3742 These patches enable cross-references to callouts placed by <tag>area</tag> coordinates.
\r
3743 It works for graphic, unicode and text callouts.
\r
3744 Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
\r
3747 <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>
\r
3750 </sect2><!--end of XSL-Saxon changes for 1.73.0-->
\r
3751 </sect1><!--end of changes for the 1.73.0 release-->
\r
3753 <sect1 xml:id="V1.72.0">
\r
3754 <title>Release: 1.72.0</title>
\r
3755 <para>This release includes important bug fixes and adds the following
\r
3756 significant feature changes:
\r
3759 <term>Automatic sorting of glossary entries</term>
\r
3761 <para>The HTML and FO stylesheets now support automatic sorting
\r
3762 of <tag>glossary</tag> entries. To enable glossary sorting, set
\r
3763 the value of the <parameter>glossary.sort </parameter> parameter
\r
3764 to <code>1</code> (by default, it’s value is
\r
3765 <code>0</code>). When you enable glossary sorting,
\r
3766 <tag>glossentry</tag> elements within a <tag> glossary</tag>,
\r
3767 <tag>glossdiv</tag>, or <tag>glosslist</tag> are sorted on the
\r
3768 <tag>glossterm</tag>, using the current language setting. If you
\r
3769 don’t enable glossary sorting, then the order of
\r
3770 <tag>glossentry</tag> elements is left “as is” — that is, they
\r
3771 are not sorted but are instead just displayed in document
\r
3776 <term>WordML renamed to Roundtrip, OpenOffice support added</term>
\r
3778 <para>Stylesheets for “roundtrip” conversion between documents in
\r
3779 OpenOffice format (ODF) and DocBook XML have been added to the set
\r
3780 of stylesheets that formerly had the collective title
\r
3781 <wordasword>WordML</wordasword>, and that set of stylesheets has
\r
3782 been renamed to <wordasword>Roundtrip</wordasword> to better
\r
3783 reflect the actual scope and purpose of its contents.</para>
\r
3784 <para>So the DocBook XSL Stylesheets now support roundtrip
\r
3785 conversion (with certain limitations) of WordML, OpenOffice, and
\r
3786 Apple Pages documents to and from DocBook XML.</para>
\r
3790 <term>Including QandASet questions in TOCs</term>
\r
3792 <para>The HTML stylesheet now provides support for including
\r
3793 <tag>QandASet</tag> <tag>question</tag>s in the document TOC. To
\r
3794 enable display of <tag>question</tag>s in the document TOC, set
\r
3795 the value of the <parameter>qanda.in.toc</parameter> to
\r
3796 <code>1</code> (by default, it’s <code>0</code>). When you
\r
3797 enable <parameter>qanda.in.toc</parameter>, then the generated
\r
3798 table of contents for a document will include
\r
3799 <tag>qandaset</tag> titles, <tag>qandadiv</tag> titles, and
\r
3800 <tag>question</tag> elements. The default value of zero
\r
3801 excludes them from the TOC.
\r
3803 <para>The <parameter>qanda.in.toc</parameter> parameter does
\r
3804 not affect any tables of contents that may be generated
\r
3805 <emphasis>within</emphasis> a <tag>qandaset</tag> or
\r
3806 <tag>qandadiv</tag> (only in the document TOC).</para>
\r
3812 <term>Language identifier in man-page filenames and pathnames</term>
\r
3814 <para>Added new parameter <parameter
\r
3815 >man.output.lang.in.name.enabled</parameter>, which controls whether
\r
3816 a language identifier is included in man-page filenames and
\r
3817 pathnames. It works like this:</para>
\r
3819 <para>If the value of <parameter
\r
3820 >man.output.lang.in.name.enabled</parameter> is non-zero,
\r
3821 man-page files are output with a language identifier included in
\r
3822 their filenames or pathnames as follows:</para>
\r
3825 <listitem><para>if
\r
3826 <parameter>man.output.subdirs.enabled</parameter> is non-zero,
\r
3827 each file is output to, e.g., a
\r
3828 <filename>/$lang/man8/foo.8</filename> pathname</para></listitem>
\r
3830 <listitem><para>if
\r
3831 <parameter>man.output.subdirs.enabled</parameter> is zero,
\r
3832 each file is output with a <tag>foo.$lang.8</tag>
\r
3833 filename</para></listitem>
\r
3839 <term><parameter>index.page.number.properties</parameter> property set</term>
\r
3841 <para>For FO output, use the
\r
3842 <parameter>index.page.number.properties</parameter> to control
\r
3843 formatting of page numbers in <tag>index</tag> output — to (for
\r
3844 example) to display page numbers in <tag>index</tag> output in a
\r
3845 different color (to indicate that they are links).</para>
\r
3849 <term>Crop marks in output from Antenna House XSL Formatter</term>
\r
3851 <para>Support has been added for generating crop marks in
\r
3852 print/PDF output generated using Antenna House XSL Formatter</para>
\r
3856 <term>More string-substitution hooks in manpages output</term>
\r
3858 <para>The <parameter>man.string.subst.map.local.pre</parameter>
\r
3859 and <parameter>man.string.subst.map.local.post</parameter>
\r
3860 parameters have been added to enable easier control over
\r
3861 custom string substitutions.</para>
\r
3865 <term>Moved verbatim properties to attribute-set</term>
\r
3867 <para>The hardcoded properties used in verbatim elements (literallayout,
\r
3868 programlisting, screen) were moved to the verbatim.properties
\r
3869 attribute-set so they can be more easily customized.</para>
\r
3873 <term>enhanced simple.xlink template</term>
\r
3875 <para>Now the simple.xlink template in inline.xsl works with
\r
3876 cross reference elements xref and link as well. Also, more elements
\r
3877 call simple.xlink, which enables DB5 xlink functionality.
\r
3882 <term>DocBook 5 compatibility</term>
\r
3884 <para>Stylesheets now consistently support DocBook 5 attributes
\r
3885 (such as xml:id). Also, DocBook 5 info elements are now checked
\r
3886 along with other *info elements, and the use of name() function
\r
3887 was replaced by local-name() so it also matches on DocBook 5 elements.
\r
3888 These changes enable reusing the stylesheets with DocBook 5
\r
3889 documents with minimal fixup.
\r
3894 <term>HTML class attributes now handled in class.attribute mode </term>
\r
3896 <para>The HTML class attributes were formerly hardcoded to the
\r
3897 element name. Now the class attribute is generated by applying
\r
3898 templates in class.attribute mode so class attribute names
\r
3899 can be customized. The default is still the element name.</para>
\r
3903 <term>arabic-indic numbering enabled in autolabels</term>
\r
3905 <para>Numbering of chapter, sections, and pages can now use
\r
3906 arabic-indic numbering when number format is set to 'arabicindic' or
\r
3907 to ١.</para>
\r
3911 The following is a detailed list of changes (not
\r
3912 including bug fixes) that have been made since the 1.71.1
\r
3915 <sect2 xml:id="V1.72.0_Common">
\r
3916 <title>Common</title>
\r
3917 <para>The following changes have been made to the
\r
3918 <filename>common</filename> code
\r
3919 since the 1.71.1 release.</para>
\r
3922 <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>
\r
3925 <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>
\r
3928 <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>
\r
3931 <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>
\r
3934 <literallayout><phrase role="commit-message">Add utility template tabstyle to return the tabstyle from
\r
3935 any <tag>table</tag> element.<alt>M: /trunk/xsl/common/table.xsl - Robert Stayton</alt></phrase></literallayout>
\r
3938 </sect2><!--end of Common changes for 1.72.0-->
\r
3940 <sect2 xml:id="V1.72.0_FO">
\r
3942 <para>The following changes have been made to the
\r
3943 <filename>fo</filename> code
\r
3944 since the 1.71.1 release.</para>
\r
3947 <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>
\r
3950 <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>
\r
3953 <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>
\r
3956 <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>
\r
3959 <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>
\r
3962 <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>
\r
3965 <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>
\r
3968 <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>
\r
3971 </sect2><!--end of FO changes for 1.72.0-->
\r
3973 <sect2 xml:id="V1.72.0_HTML">
\r
3974 <title>HTML</title>
\r
3975 <para>The following changes have been made to the
\r
3976 <filename>html</filename> code
\r
3977 since the 1.71.1 release.</para>
\r
3980 <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>
\r
3983 <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>
\r
3986 <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>
\r
3989 <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>
\r
3992 <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>
\r
3995 <literallayout><phrase role="commit-message">Convert all class attributes to use the class.attribute mode
\r
3996 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>
\r
3999 <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>
\r
4002 <literallayout><phrase role="commit-message">Added simple.xlink to most remaining inlines.
\r
4003 Changed class attributes to applying class.attributes mode.<alt>M: /trunk/xsl/html/inline.xsl - Robert Stayton</alt></phrase></literallayout>
\r
4006 <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>
\r
4009 <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>
\r
4012 <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>
\r
4015 <literallayout><phrase role="commit-message">Use new link.title.attribute now.<alt>M: /trunk/xsl/html/xref.xsl - Robert Stayton</alt></phrase></literallayout>
\r
4018 <literallayout><phrase role="commit-message">Rewrote simple.xlink to handle linkend also.
\r
4019 Better computation of <tag>title</tag> attribute on <tag>link</tag> too.<alt>M: /trunk/xsl/html/inline.xsl - Robert Stayton</alt></phrase></literallayout>
\r
4022 <literallayout><phrase role="commit-message">Handle Xalan quirk as special case.<alt>M: /trunk/xsl/html/db5strip.xsl - Robert Stayton</alt></phrase></literallayout>
\r
4025 <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>
\r
4028 <literallayout><phrase role="commit-message">Fixed imagemaps so they work properly going from calspair coords
\r
4029 to HTML <tag>area</tag> coords.<alt>M: /trunk/xsl/html/graphics.xsl - Robert Stayton</alt></phrase></literallayout>
\r
4032 </sect2><!--end of HTML changes for 1.72.0-->
\r
4034 <sect2 xml:id="V1.72.0_Manpages">
\r
4035 <title>Manpages</title>
\r
4036 <para>The following changes have been made to the
\r
4037 <filename>manpages</filename> code
\r
4038 since the 1.71.1 release.</para>
\r
4041 <literallayout><phrase role="commit-message">Added doc for <parameter>man.output.lang.in.name.enabled</parameter> parameter. This
\r
4042 checkin completes support for writing file/pathnames for man-pages
\r
4043 with $lang include in the names. Closes #1585967. knightly
\r
4044 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>
\r
4047 <literallayout><phrase role="commit-message">Added new param <parameter>man.output.lang.in.name.enabled</parameter>, which
\r
4048 controls whether $LANG value is included in manpages
\r
4049 filenames and pathnames. It works like this:
\r
4051 If the value of <parameter>man.output.lang.in.name.enabled</parameter> is non-zero,
\r
4052 man-page files are output with the $lang value included in
\r
4053 their filenames or pathnames as follows;
\r
4055 - if <parameter>man.output.subdirs.enabled</parameter> is non-zero, each file is
\r
4056 output to, e.g., a /$lang/man8/foo.8 pathname
\r
4058 - if <parameter>man.output.subdirs.enabled</parameter> is zero, each file is output
\r
4059 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>
\r
4062 <literallayout><phrase role="commit-message">Use "\e" instead of "\\" for backslash output, because the
\r
4063 groff docs say that's the correct thing to do; also because
\r
4064 testing (thanks, Paul Dubois) shows that "\\" doesn't always
\r
4065 work as expected; for example, "\\" within a <tag>table</tag> seems to
\r
4066 mess things up.<alt>M: /trunk/xsl/manpages/charmap.groff.xsl - Michael(tm) Smith</alt></phrase></literallayout>
\r
4069 <literallayout><phrase role="commit-message">Added the <parameter>man.string.subst.map.local.pre</parameter> and
\r
4070 <parameter>man.string.subst.map.local.post</parameter> parameters. Those parameters
\r
4071 enable local additions and changes to string-substitution mappings
\r
4072 without the need to change the value of <parameter>man.string.subst.map</parameter>
\r
4073 parameter (which is for standard system mappings). Closes
\r
4074 #1456738. Thanks to Sam Steingold for constructing a true
\r
4075 stylesheet torture test (the clisp docs) that exposed the need for
\r
4076 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>
\r
4079 <literallayout><phrase role="commit-message">Added the Markup element to the list of elements that get output
\r
4080 in bold. Thanks to Eric S. Raymond.<alt>M: /trunk/xsl/manpages/inline.xsl - Michael(tm) Smith</alt></phrase></literallayout>
\r
4083 <literallayout><phrase role="commit-message">Replaced all dots in roff requests with U+2302 ("house"
\r
4084 character), and added escaping in output for all instances of dot
\r
4085 that are not in roff requests. This fixes the problem case where a
\r
4086 string beginning with a dot (for example, the string ".bashrc")
\r
4087 might occur at the beginning of a line in output, in which case
\r
4088 would mistakenly get interpreted as a roff request. Thanks to Eric
\r
4089 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>
\r
4092 <literallayout><phrase role="commit-message">Made change to ensure that list content nested in
\r
4093 <tag>itemizedlist</tag> and <tag>orderedlist</tag> instances is properly indented. This
\r
4094 is a switch from using .TP to format those lists to using .RS/.RE
\r
4095 to format them instead (because .TP does not allow nesting). Closes bug #1602616.
\r
4096 Thanks to Daniel Leidert.<alt>M: /trunk/xsl/manpages/lists.xsl - Michael(tm) Smith</alt></phrase></literallayout>
\r
4099 </sect2><!--end of Manpages changes for 1.72.0-->
\r
4101 <sect2 xml:id="V1.72.0_Params">
\r
4102 <title>Params</title>
\r
4103 <para>The following changes have been made to the
\r
4104 <filename>params</filename> code
\r
4105 since the 1.71.1 release.</para>
\r
4108 <literallayout><phrase role="commit-message">Added doc for <parameter>man.output.lang.in.name.enabled</parameter> parameter. This
\r
4109 checkin completes support for writing file/pathnames for man-pages
\r
4110 with $lang include in the names. Closes #1585967. knightly
\r
4111 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>
\r
4114 <literallayout><phrase role="commit-message">Added new param <parameter>man.output.lang.in.name.enabled</parameter>, which
\r
4115 controls whether $LANG value is included in manpages
\r
4116 filenames and pathnames. It works like this:
\r
4118 If the value of <parameter>man.output.lang.in.name.enabled</parameter> is non-zero,
\r
4119 man-page files are output with the $lang value included in
\r
4120 their filenames or pathnames as follows;
\r
4122 - if <parameter>man.output.subdirs.enabled</parameter> is non-zero, each file is
\r
4123 output to, e.g., a /$lang/man8/foo.8 pathname
\r
4125 - if <parameter>man.output.subdirs.enabled</parameter> is zero, each file is output
\r
4126 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>
\r
4129 <literallayout><phrase role="commit-message">Added the <parameter>man.string.subst.map.local.pre</parameter> and
\r
4130 <parameter>man.string.subst.map.local.post</parameter> parameters. Those parameters
\r
4131 enable local additions and changes to string-substitution mappings
\r
4132 without the need to change the value of <parameter>man.string.subst.map</parameter>
\r
4133 parameter (which is for standard system mappings). Closes
\r
4134 #1456738. Thanks to Sam Steingold for constructing a true
\r
4135 stylesheet torture test (the clisp docs) that exposed the need for
\r
4136 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>
\r
4139 <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>
\r
4142 <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>
\r
4145 <literallayout><phrase role="commit-message">Move show-destination="replace" property from template to attribute-set
\r
4146 so it can be customized.<alt>M: /trunk/xsl/params/olink.properties.xml - Robert Stayton</alt></phrase></literallayout>
\r
4149 <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>
\r
4152 <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>
\r
4155 <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>
\r
4158 </sect2><!--end of Params changes for 1.72.0-->
\r
4160 <sect2 xml:id="V1.72.0_Template">
\r
4161 <title>Template</title>
\r
4162 <para>The following changes have been made to the
\r
4163 <filename>template</filename> code
\r
4164 since the 1.71.1 release.</para>
\r
4167 <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>
\r
4170 </sect2><!--end of Template changes for 1.72.0-->
\r
4172 <sect2 xml:id="V1.72.0_Roundtrip">
\r
4173 <title>Roundtrip</title>
\r
4174 <para>The following changes have been made to the
\r
4175 <filename>roundtrip</filename> code
\r
4176 since the 1.71.1 release.</para>
\r
4179 <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>
\r
4182 </sect2><!--end of Roundtrip changes for 1.72.0-->
\r
4183 </sect1><!--end of V1.72.0-->
\r
4185 <sect1 xml:id="V1.71.1">
\r
4186 <title>Release: 1.71.1</title>
\r
4187 <para>This is a minor update to the 1.71.0 release. Along with a
\r
4188 number of bug fixes, it includes two feature changes:
\r
4192 <para>Added support for profiling based on <tag
\r
4193 class="attribute">xml:lang</tag> and <tag
\r
4194 class="attribute">status</tag> attributes.</para>
\r
4197 <para>Added initial support in manpages output for
\r
4198 <tag>footnote</tag>, <tag>annotation</tag>, and <tag>alt</tag>
\r
4199 instances. Basically, they all now get handled the same way
\r
4200 <tag>ulink</tag> instances are. They are treated as a class as
\r
4201 "note sources": A numbered marker is generated at the place in the
\r
4202 main text flow where they occur, then their contents are displayed
\r
4203 in an endnotes section at the end of the man page.</para>
\r
4208 <sect2 xml:id="V1.71.1_Common">
\r
4209 <title>Common</title>
\r
4210 <para>The following changes have been made to the
\r
4211 <filename>common</filename> code
\r
4212 since the 1.71.1 release.</para>
\r
4215 <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>
\r
4218 <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>
\r
4221 </sect2><!--end of Common changes for 1.71.1-->
\r
4223 <sect2 xml:id="V1.71.1_FO">
\r
4225 <para>The following changes have been made to the
\r
4226 <filename>fo</filename> code
\r
4227 since the 1.71.1 release.</para>
\r
4230 <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>
\r
4233 <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>
\r
4236 <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>
\r
4239 </sect2><!--end of FO changes for 1.71.1-->
\r
4241 <sect2 xml:id="V1.71.1_HTML">
\r
4242 <title>HTML</title>
\r
4243 <para>The following changes have been made to the
\r
4244 <filename>html</filename> code
\r
4245 since the 1.71.1 release.</para>
\r
4248 <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>
\r
4251 <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>
\r
4254 <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>
\r
4257 <literallayout><phrase role="commit-message">Made changes in namespace declarations to prevent xmllint's
\r
4258 canonicalizer from treating them as relative namespace URIs.
\r
4260 - Changed xmlns:k="java:com.isogen.saxoni18n.Saxoni18nService"
\r
4261 to xmlns:k="http://www.isogen.com/functions/com.isogen.saxoni18n.Saxoni18nService";
\r
4262 Saxon accepts either form
\r
4263 (see http://www.saxonica.com/documentation/extensibility/functions.html);
\r
4264 to Saxon, "the part of the URI before the final '/' is immaterial".
\r
4266 - Changed, e.g. xmlns:xverb="com.nwalsh.xalan.Verbatim" to
\r
4267 xmlns:xverb="xalan://com.nwalsh.xalan.Verbatim"; Xalan accepts
\r
4269 (see http://xml.apache.org/xalan-j/extensions.html#java-namespace-declare);
\r
4270 just as Saxon does, it will "simply use the string to the
\r
4271 right of the rightmost forward slash as the Java class name".
\r
4273 - Changed xmlns:xalanredirect="org.apache.xalan.xslt.extensions.Redirect"
\r
4274 to xmlns:redirect="http://xml.apache.org/xalan/redirect", and
\r
4275 adjusted associated code to make the current Xalan redirect spec.
\r
4276 (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>
\r
4279 <literallayout><phrase role="commit-message">Added the <parameter>html.append</parameter> and <parameter>chunk.append</parameter> parameters. By default, the
\r
4280 value of both is empty; but the internal DocBook XSL stylesheets
\r
4281 build sets their value to "<xsl:text>&#x0a;</xsl:text>", in order
\r
4282 to ensure that all files in the docbook-xsl-doc package end in a
\r
4283 newline character. (Because diff and some other tools may emit
\r
4284 error messages and/or not behave as expected when processing
\r
4285 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>
\r
4288 </sect2><!--end of HTML changes for 1.71.1-->
\r
4290 <sect2 xml:id="V1.71.1_Highlighting">
\r
4291 <title>Highlighting</title>
\r
4292 <para>The following changes have been made to the
\r
4293 <filename>highlighting</filename> code
\r
4294 since the 1.71.1 release.</para>
\r
4297 <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>
\r
4300 </sect2><!--end of Highlighting changes for 1.71.1-->
\r
4302 <sect2 xml:id="V1.71.1_Manpages">
\r
4303 <title>Manpages</title>
\r
4304 <para>The following changes have been made to the
\r
4305 <filename>manpages</filename> code
\r
4306 since the 1.71.1 release.</para>
\r
4309 <literallayout><phrase role="commit-message">Added initial support in manpages output for <tag>footnote</tag>, <tag>annotation</tag>,
\r
4310 and <tag>alt</tag> instances. Basically, they all now get handled the same
\r
4311 way ulink instances are. They are treated as a class as "note
\r
4312 sources": A numbered marker is generated at the place in the main
\r
4313 text flow where they occur, then their contents are displayed in
\r
4314 an endnotes <tag>section</tag> at the end of the man page (currently titled
\r
4315 REFERENCES, for English output, but will be changed to NOTES).
\r
4317 This support is not yet complete. It works for most "normal"
\r
4318 cases, but probably mishandles a good number of cases. More
\r
4319 testing will be needed to expose the problems. It may well also
\r
4320 introduce some bugs and regressions in other areas, including
\r
4321 basic paragraph handling, handling of "mixed block" content,
\r
4322 handling of other indented content, and handling of authorblurb
\r
4323 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>
\r
4326 </sect2><!--end of Manpages changes for 1.71.1-->
\r
4328 <sect2 xml:id="V1.71.1_Params">
\r
4329 <title>Params</title>
\r
4330 <para>The following changes have been made to the
\r
4331 <filename>params</filename> code
\r
4332 since the 1.71.1 release.</para>
\r
4335 <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>
\r
4338 <literallayout><phrase role="commit-message">Added the <parameter>html.append</parameter> and <parameter>chunk.append</parameter> parameters. By default, the
\r
4339 value of both is empty; but the internal DocBook XSL stylesheets
\r
4340 build sets their value to "<xsl:text>&#x0a;</xsl:text>", in order
\r
4341 to ensure that all files in the docbook-xsl-doc <tag>package</tag> end in a
\r
4342 newline character. (Because diff and some other tools may emit
\r
4343 error messages and/or not behave as expected when processing
\r
4344 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>
\r
4347 </sect2><!--end of Params changes for 1.71.1-->
\r
4349 <sect2 xml:id="V1.71.1_Profiling">
\r
4350 <title>Profiling</title>
\r
4351 <para>The following changes have been made to the
\r
4352 <filename>profiling</filename> code
\r
4353 since the 1.71.1 release.</para>
\r
4356 <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>
\r
4359 </sect2><!--end of Profiling changes for 1.71.1-->
\r
4363 <sect1 xml:id="V1.71.0">
\r
4364 <title>Release: 1.71.0</title>
\r
4365 <para>This is mainly a bug fix release, but it also includes two
\r
4366 significant feature changes:
\r
4369 <term>Highlighting support added</term>
\r
4371 <para>The stylesheets now include support for source-code
\r
4372 highlighting in output of programlisting instances (controlled
\r
4373 through the <parameter>highlight.source</parameter>
\r
4374 parameter). The Java-based implementation requires Saxon and
\r
4375 makes use of <link
\r
4376 xlink:href="http://molhanec.net/"><person><personname
\r
4377 ><firstname>Michal</firstname><surname
\r
4378 >Molhanec</surname></personname></person></link>’s <link
\r
4379 xlink:href="http://sourceforge.net/projects/xslthl"
\r
4380 >XSLTHL</link>. More details are available at Jirka Kosek’s
\r
4381 website: <blockquote ><simpara ><link
\r
4382 xlink:href="http://xmlguru.cz/2006/07/docbook-syntax-highlighting"/></simpara
\r
4383 ></blockquote> The support is currently limited to highlighting
\r
4384 of XML, Java, PHP, Delphi, Modula-2 sources, and INI
\r
4389 <term>Changes to autoindexing</term>
\r
4391 <para>The templates that handle alternative indexing methods
\r
4392 were reworked to avoid errors produced by certain processors not
\r
4393 being able to tolerate the presence of unused functions. With
\r
4394 this release, none of the code for the 'kimber' or 'kosek'
\r
4395 methods is included in the default stylesheets. In order to use
\r
4396 one of those methods, your customization layer must import one
\r
4397 of the optional stylesheet modules:</para>
\r
4401 <simpara>html/autoidx-kosek.xsl</simpara>
\r
4404 <simpara>html/autoidx-kimber.xsl</simpara>
\r
4407 <simpara>fo/autoidx-kosek.xsl</simpara>
\r
4410 <simpara>fo/autoidx-kimber.xsl</simpara>
\r
4413 See the <parameter>index.method</parameter> parameter
\r
4414 reference page for more information.
\r
4416 <para>Two other changes to note:
\r
4419 <simpara>The default indexing method now can handle accented
\r
4420 characters in latin-based alphabets, not just English. This
\r
4421 means accented latin letters will group and sort with their
\r
4422 unaccented counterpart.</simpara>
\r
4425 <simpara>The default value for the
\r
4426 <parameter>index.method</parameter> parameter was changed
\r
4427 from 'english' to 'basic' because now the default method can
\r
4428 handle latin-based alphabets, not just English.</simpara>
\r
4435 The following is a list of changes that have
\r
4436 been made since the 1.70.1 release.</para>
\r
4438 <sect2 xml:id="V1.71.0_Common">
\r
4439 <title>Common</title>
\r
4440 <para>The following changes have been made to the
\r
4441 <filename>common</filename> code
\r
4442 since the 1.70.1 release.</para>
\r
4446 <literallayout><phrase role="commit-message">Added <parameter>reference.autolabel</parameter> parameter for controlling labels on
\r
4447 <tag>reference</tag> output.<alt>M: /trunk/xsl/common/labels.xsl - Michael(tm) Smith</alt></phrase></literallayout>
\r
4450 <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>
\r
4453 <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>
\r
4456 <literallayout><phrase role="commit-message">Support startinglinenumber on <tag>orderedlist</tag><alt>M: /trunk/xsl/common/common.xsl - Norman Walsh</alt></phrase></literallayout>
\r
4459 </sect2><!--end of Common changes for 1.71.0-->
\r
4461 <sect2 xml:id="V1.71.0_Extensions">
\r
4462 <title>Extensions</title>
\r
4463 <para>The following changes have been made to the
\r
4464 <filename>extensions</filename> code
\r
4465 since the 1.70.1 release.</para>
\r
4468 <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>
\r
4471 </sect2><!--end of Extensions changes for 1.71.0-->
\r
4473 <sect2 xml:id="V1.71.0_FO">
\r
4475 <para>The following changes have been made to the
\r
4476 <filename>fo</filename> code
\r
4477 since the 1.70.1 release.</para>
\r
4481 <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>
\r
4485 <literallayout><phrase role="commit-message">Support titlecase "Java", "Perl", and "IDL" as values for the
\r
4486 language attribute on <tag>classsynopsis</tag>, etc. (instead of just
\r
4487 lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
\r
4488 (instead of just "cpp").
\r
4490 Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
\r
4491 to "Brian A. Vanderburg II".<alt>M: /trunk/xsl/fo/synop.xsl - Michael(tm) Smith</alt></phrase></literallayout>
\r
4495 <literallayout><phrase role="commit-message">Added support for the <parameter>reference.autolabel</parameter> param in (X)HTML and FO
\r
4496 output.<alt>M: /trunk/xsl/fo/param.xweb; M: /trunk/xsl/fo/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
\r
4500 <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>
\r
4504 <literallayout><phrase role="commit-message">Rearranged templates for the 3 indexing methods
\r
4505 and changed method named 'english' to 'basic'.<alt>M: /trunk/xsl/fo/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
\r
4508 <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>
\r
4512 <literallayout><phrase role="commit-message">Turn off blank-body for <parameter>fop1.extensions</parameter> too since fop 0.92
\r
4513 does not support it either.<alt>M: /trunk/xsl/fo/pagesetup.xsl - Robert Stayton</alt></phrase></literallayout>
\r
4517 <literallayout><phrase role="commit-message">Add Xalan variant to test for exslt:node-set <tag>function</tag>.
\r
4518 Xalan can use <tag>function</tag> named node-set(), but doesn't
\r
4519 recognize it using function-available().<alt>M: /trunk/xsl/fo/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
\r
4523 <literallayout><phrase role="commit-message">Added support to FO stylesheets for handling instances of <tag>Org</tag>
\r
4524 where it occurs outside of *<tag>info</tag> content. In HTML stylesheets,
\r
4525 moved handling of <tag>Org</tag> out of info.xsl and into inline.xsl. In both
\r
4526 FO and HTML stylesheets, added support for correctly processing
\r
4527 <tag>Affiliation</tag> and <tag>Jobtitle</tag>.<alt>M: /trunk/xsl/fo/inline.xsl - Michael(tm) Smith</alt></phrase></literallayout>
\r
4530 <literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
\r
4531 <tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
\r
4532 instances, and removed some debugging stuff that was generated in
\r
4533 manpages output to mark the ends of sections.<alt>M: /trunk/xsl/fo/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
\r
4536 <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
\r
4537 default), delimiters are generated around e-mail addresses (output
\r
4538 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>
\r
4542 <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>
\r
4545 <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>
\r
4548 </sect2><!--end of FO changes for 1.71.0-->
\r
4550 <sect2 xml:id="V1.71.0_HTML">
\r
4551 <title>HTML</title>
\r
4552 <para>The following changes have been made to the
\r
4553 <filename>html</filename> code
\r
4554 since the 1.70.1 release.</para>
\r
4558 <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>
\r
4561 <literallayout><phrase role="commit-message">Support titlecase "Java", "Perl", and "IDL" as values for the
\r
4562 language attribute on <tag>classsynopsis</tag>, etc. (instead of just
\r
4563 lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
\r
4564 (instead of just "cpp").
\r
4566 Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
\r
4567 to "Brian A. Vanderburg II".<alt>M: /trunk/xsl/html/synop.xsl - Michael(tm) Smith</alt></phrase></literallayout>
\r
4571 <literallayout><phrase role="commit-message">Added support for the <parameter>reference.autolabel</parameter> param in (X)HTML and FO
\r
4572 output.<alt>M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
\r
4575 <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>
\r
4579 <literallayout><phrase role="commit-message">Rearranged templates for the 3 indexing methods
\r
4580 and changed method named 'english' to 'basic'.<alt>M: /trunk/xsl/html/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
\r
4583 <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>
\r
4587 <literallayout><phrase role="commit-message">Added several new HTML parameters for controlling appearance of
\r
4588 content on HTML <tag>title</tag> pages:
\r
4590 <parameter>contrib.inline.enabled</parameter>:
\r
4591 If non-zero (the default), output of the <tag>contrib</tag> element is
\r
4592 displayed as inline content rather than as block content.
\r
4594 <parameter>othercredit.like.author.enabled</parameter>:
\r
4595 If non-zero, output of the <tag>othercredit</tag> element on titlepages is
\r
4596 displayed in the same style as <tag>author</tag> and <tag>editor</tag> output. If zero
\r
4597 (the default), <tag>othercredit</tag> output is displayed using a style
\r
4598 different than that of <tag>author</tag> and <tag>editor</tag>.
\r
4600 <parameter>blurb.on.titlepage.enabled</parameter>:
\r
4601 If non-zero, output from authorblurb and <tag>personblurb</tag> elements is
\r
4602 displayed on <tag>title</tag> pages. If zero (the default), output from
\r
4603 those elements is suppressed on <tag>title</tag> pages (unless you are
\r
4604 using a titlepage customization that causes them to be included).
\r
4606 <parameter>editedby.enabled</parameter>
\r
4607 If non-zero (the default), a localized Edited by heading is
\r
4608 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>
\r
4612 <literallayout><phrase role="commit-message">Add Xalan variant to test for exslt:node-set <tag>function</tag>.
\r
4613 Xalan can use <tag>function</tag> named node-set(), but doesn't
\r
4614 recognize it using function-available().<alt>M: /trunk/xsl/html/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
\r
4618 <literallayout><phrase role="commit-message">Added support to FO stylesheets for handling instances of <tag>Org</tag>
\r
4619 where it occurs outside of *<tag>info</tag> content. In HTML stylesheets,
\r
4620 moved handling of <tag>Org</tag> out of info.xsl and into inline.xsl. In both
\r
4621 FO and HTML stylesheets, added support for correctly processing
\r
4622 <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>
\r
4625 <literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
\r
4626 <tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
\r
4627 instances, and removed some debugging stuff that was generated in
\r
4628 manpages output to mark the ends of sections.<alt>M: /trunk/xsl/html/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
\r
4631 <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
\r
4632 default), delimiters are generated around e-mail addresses (output
\r
4633 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>
\r
4637 <literallayout><phrase role="commit-message">Added <parameter>qanda.nested.in.toc</parameter> param. Default value is zero. If
\r
4638 non-zero, instances of "nested" <tag>Qandaentry</tag> (ones that are children
\r
4639 of <tag>Answer</tag> elements) are displayed in the <tag>TOC</tag>. Closes patch 1509018
\r
4640 (from Daniel Leidert). Currently on affects HTML output (no patch
\r
4641 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>
\r
4646 <literallayout><phrase role="commit-message">Improved handling of relative locations generated files<alt>M: /trunk/xsl/html/html.xsl - Jirka Kosek</alt></phrase></literallayout>
\r
4650 <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>
\r
4653 <literallayout><phrase role="commit-message">Support <tag>org</tag><alt>M: /trunk/xsl/html/info.xsl - Norman Walsh</alt></phrase></literallayout>
\r
4656 <literallayout><phrase role="commit-message">Support <tag>person</tag><alt>M: /trunk/xsl/html/inline.xsl - Norman Walsh</alt></phrase></literallayout>
\r
4659 <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>
\r
4662 </sect2><!--end of HTML changes for 1.71.0-->
\r
4664 <sect2 xml:id="V1.71.0_Highlighting">
\r
4665 <title>Highlighting</title>
\r
4666 <para>The following changes have been made to the
\r
4667 <filename>highlighting</filename> code
\r
4668 since the 1.70.1 release.</para>
\r
4672 <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>
\r
4675 </sect2><!--end of Highlighting changes for 1.71.0-->
\r
4677 <sect2 xml:id="V1.71.0_Manpages">
\r
4678 <title>Manpages</title>
\r
4679 <para>The following changes have been made to the
\r
4680 <filename>manpages</filename> code
\r
4681 since the 1.70.1 release.</para>
\r
4685 <literallayout><phrase role="commit-message">Suppress <tag>footnote</tag> markers and output warning that footnotes are
\r
4686 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>
\r
4690 <literallayout><phrase role="commit-message">Handle instances of <tag>address</tag>/<tag>otheraddr</tag>/ulink in <tag>author</tag> et al in the
\r
4691 same way as <tag>email</tag> instances; that is, display them on the same
\r
4692 linke as the <tag>author</tag>, <tag>editor</tag>, etc., name.<alt>M: /trunk/xsl/manpages/info.xsl - Michael(tm) Smith</alt></phrase></literallayout>
\r
4695 <literallayout><phrase role="commit-message">Don't number or link-list any Ulink instance whose string value is
\r
4696 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>
\r
4700 <literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
\r
4701 <tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
\r
4702 instances, and removed some debugging stuff that was generated in
\r
4703 manpages output to mark the ends of sections.<alt>M: /trunk/xsl/manpages/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
\r
4706 <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
\r
4707 default), delimiters are generated around e-mail addresses (output
\r
4708 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>
\r
4712 <literallayout><phrase role="commit-message">In manpages output, if the last/nearest *<tag>info</tag> element for
\r
4713 particular <tag>Refentry</tag> has multiple <tag>Copyright</tag> and/or <tag>Legalnotice</tag>
\r
4714 children, process them all (not just the first ones). Closes bug
\r
4715 1524576. Thanks to Sam Steingold for the report and to Daniel
\r
4716 Leidert for providing a patch.<alt>M: /trunk/xsl/manpages/info.xsl - Michael(tm) Smith</alt></phrase></literallayout>
\r
4720 </sect2><!--end of Manpages changes for 1.71.0-->
\r
4722 <sect2 xml:id="V1.71.0_Params">
\r
4723 <title>Params</title>
\r
4724 <para>The following changes have been made to the
\r
4725 <filename>params</filename> code
\r
4726 since the 1.70.1 release.</para>
\r
4729 <literallayout><phrase role="commit-message">Added <parameter>reference.autolabel</parameter> parameter for controlling labels on
\r
4730 <tag>reference</tag> output.<alt>A: /trunk/xsl/params/reference.autolabel.xml - Michael(tm) Smith</alt></phrase></literallayout>
\r
4733 <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>
\r
4736 <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>
\r
4739 <literallayout><phrase role="commit-message">Added several new HTML parameters for controlling appearance of
\r
4740 content on HTML <tag>title</tag> pages:
\r
4742 <parameter>contrib.inline.enabled</parameter>:
\r
4743 If non-zero (the default), output of the <tag>contrib</tag> element is
\r
4744 displayed as inline content rather than as block content.
\r
4746 <parameter>othercredit.like.author.enabled</parameter>:
\r
4747 If non-zero, output of the <tag>othercredit</tag> element on titlepages is
\r
4748 displayed in the same style as <tag>author</tag> and <tag>editor</tag> output. If zero
\r
4749 (the default), <tag>othercredit</tag> output is displayed using a style
\r
4750 different than that of <tag>author</tag> and <tag>editor</tag>.
\r
4752 <parameter>blurb.on.titlepage.enabled</parameter>:
\r
4753 If non-zero, output from authorblurb and <tag>personblurb</tag> elements is
\r
4754 displayed on <tag>title</tag> pages. If zero (the default), output from
\r
4755 those elements is suppressed on <tag>title</tag> pages (unless you are
\r
4756 using a titlepage customization that causes them to be included).
\r
4758 <parameter>editedby.enabled</parameter>
\r
4759 If non-zero (the default), a localized Edited by heading is
\r
4760 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>
\r
4763 <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
\r
4764 default), delimiters are generated around e-mail addresses (output
\r
4765 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>
\r
4769 <literallayout><phrase role="commit-message">Added <parameter>qanda.nested.in.toc</parameter> param. Default value is zero. If
\r
4770 non-zero, instances of "nested" <tag>Qandaentry</tag> (ones that are children
\r
4771 of <tag>Answer</tag> elements) are displayed in the <tag>TOC</tag>. Closes patch 1509018
\r
4772 (from Daniel Leidert). Currently on affects HTML output (no patch
\r
4773 for FO output provided).<alt>A: /trunk/xsl/params/qanda.nested.in.toc.xml - Michael(tm) Smith</alt></phrase></literallayout>
\r
4777 <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>
\r
4780 </sect2><!--end of Params changes for 1.71.0-->
\r
4782 <sect2 xml:id="V1.71.0_Tools">
\r
4783 <title>Tools</title>
\r
4784 <para>The following changes have been made to the
\r
4785 <filename>tools</filename> code
\r
4786 since the 1.70.1 release.</para>
\r
4790 <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>
\r
4793 <literallayout><phrase role="commit-message">Added param and attribute set to example makefile, for getting
\r
4794 wrapping in verbatims in FO output.<alt>M: /trunk/xsl/tools/make/Makefile.DocBook - Michael(tm) Smith</alt></phrase></literallayout>
\r
4797 <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>
\r
4800 <literallayout><phrase role="commit-message">Added Makefile.paramDoc file, for creating versions of param.xsl
\r
4801 files with doc embedded.<alt>A: /trunk/xsl/tools/make/Makefile.paramDoc - Michael(tm) Smith</alt></phrase></literallayout>
\r
4804 <literallayout><phrase role="commit-message">Added variable to example makefile for controlling whether HTML or
\r
4805 XHTML is generated.<alt>M: /trunk/xsl/tools/make/Makefile.DocBook - Michael(tm) Smith</alt></phrase></literallayout>
\r
4809 </sect2><!--end of Tools changes for 1.71.0-->
\r
4812 <sect1 xml:id="V1701">
\r
4813 <title>Release: 1.70.1</title>
\r
4815 <para>This is a stable release of the 1.70 stylesheets. It includes only a
\r
4816 few small changes from 1.70.0.</para>
\r
4818 <para>The following is a list of changes that have been made
\r
4819 since the 1.70.0 release.</para>
\r
4821 <sect2 xml:id="V1701_FO">
\r
4823 <para>The following changes have been made to the
\r
4824 <filename>fo</filename> code
\r
4825 since the 1.70.0 release.</para>
\r
4827 <listitem role="commit-message">
\r
4828 <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>
\r
4829 <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>
\r
4831 <listitem role="commit-message">
\r
4832 <para>Support DBv5 revisions with full author name (not only authorinitials)</para>
\r
4833 <para role="commit-changes">Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek</para>
\r
4836 </sect2><!--end of FO changes for 1.70.1-->
\r
4838 <sect2 xml:id="V1701_HTML">
\r
4839 <title>HTML</title>
\r
4840 <para>The following changes have been made to the
\r
4841 <filename>html</filename> code
\r
4842 since the 1.70.0 release.</para>
\r
4844 <listitem role="commit-message">
\r
4845 <para>Support DBv5 revisions with full author name (not only authorinitials)</para>
\r
4846 <para role="commit-changes">Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek</para>
\r
4849 </sect2><!--end of HTML changes for 1.70.1-->
\r
4851 <sect2 xml:id="V1701_HTMLHelp">
\r
4852 <title>HTMLHelp</title>
\r
4853 <para>The following changes have been made to the
\r
4854 <filename>htmlhelp</filename> code
\r
4855 since the 1.70.0 release.</para>
\r
4857 <listitem role="commit-message">
\r
4858 <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>
\r
4859 <para role="commit-changes">Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek</para>
\r
4861 <listitem role="commit-message">
\r
4862 <para>Support chunk.tocs.and.lots in HTML Help</para>
\r
4863 <para role="commit-changes">Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek</para>
\r
4866 </sect2><!--end of HTMLHelp changes for 1.70.1-->
\r
4868 <sect2 xml:id="V1701_Params">
\r
4869 <title>Params</title>
\r
4870 <para>The following changes have been made to the
\r
4871 <filename>params</filename> code
\r
4872 since the 1.70.0 release.</para>
\r
4874 <listitem role="commit-message">
\r
4875 <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>
\r
4876 <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>
\r
4879 </sect2><!--end of Params changes for 1.70.1-->
\r
4883 <sect1 xml:id="V1700">
\r
4884 <title>Release: 1.70.0</title>
\r
4885 <para>As with all DocBook Project <link linkend="dot0">dot-zero</link>
\r
4886 releases, this is an experimental release. It will be followed shortly
\r
4887 by a stable release.</para>
\r
4889 <para>This release adds a number of new features,
\r
4894 <para>support for selecting alternative index-collation methods
\r
4895 (in particular, support for using a collation library developed by
\r
4896 Eliot Kimber)</para>
\r
4899 <para>improved handling of DocBook 5 document instances (through a
\r
4900 namespace-stripping mechanism)</para>
\r
4903 <para>full support for CALS and HTML tables in manpages
\r
4907 <para>a mechanism for preserving relative URIs in documents that
\r
4908 make use of XInclude</para>
\r
4911 <para>support for the "new" <literal>.90</literal> version of
\r
4915 <para>enhanced capabilities for controlling formatting of lists in HTML
\r
4916 and FO output</para>
\r
4919 <para>autogeneration of AUTHOR and COPYRIGHT sections in manpages
\r
4923 <para>support for generating crop marks in FO/PDF output</para>
\r
4926 <para>support for qandaset as a root element in FO output</para>
\r
4929 <para>support for floatstyle and orient on all table types</para>
\r
4932 <para>support for floatstyle in figure, and example</para>
\r
4935 <para>pgwide.properties attribute-set supports extending figure,
\r
4936 example and table into the left indent area instead of spanning
\r
4937 multiple columns.</para>
\r
4940 <para>The following is a detailed list of enhancements and API
\r
4941 changes that have been made since the 1.69.1 release.</para>
\r
4943 <sect2 xml:id="V1700_Common">
\r
4944 <title>Common</title>
\r
4945 <para>The following changes have been made to the
\r
4946 <filename>common</filename> code
\r
4947 since the 1.69.1 release.</para>
\r
4949 <listitem role="commit-message">
\r
4950 <para>Add the xsl:key for the kimber
\r
4951 indexing method.</para>
\r
4952 <para role="commit-changes">Modified: common/autoidx-ng.xsl,1.2 - Robert
\r
4955 <listitem role="commit-message">
\r
4956 <para>Add support for
\r
4957 <tag>qandaset</tag>.</para>
\r
4958 <para role="commit-changes">Modified: common/labels.xsl,1.37;
\r
4959 common/subtitles.xsl,1.7; common/titles.xsl,1.35 - Robert
\r
4962 <listitem role="commit-message">
\r
4963 <para>Support dbhtml/dbfo start PI for
\r
4964 <tag>orderedlist</tag> numbering in both HTML and
\r
4966 <para role="commit-changes">Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman
\r
4969 <listitem role="commit-message">
\r
4972 <para role="commit-changes">Modified: common/stripns.xsl,1.12 - Robert
\r
4975 <listitem role="commit-message">
\r
4976 <para>Changed content model of text
\r
4977 element to ANY rather than #PCDATA because they could contain
\r
4979 <para role="commit-changes">Modified: common/targetdatabase.dtd,1.7 - Robert
\r
4982 <listitem role="commit-message">
\r
4984 <tag>refentry</tag>.meta.get.quietly param.</para>
\r
4985 <para>If zero (the
\r
4986 default), notes and warnings about "missing" markup are generated
\r
4987 during gathering of <tag>refentry</tag> metadata. If
\r
4988 non-zero, the metadata is gathered "quietly" -- that is, the
\r
4989 notes and warnings are suppressed.</para>
\r
4990 <para>NOTE: If you are
\r
4991 processing a large amount of <tag>refentry</tag> content, you
\r
4992 may be able to speed up processing significantly by setting a
\r
4993 non-zero value for
\r
4994 <tag>refentry</tag>.meta.get.quietly.</para>
\r
4995 <para role="commit-changes">Modified: common/refentry.xsl,1.17;
\r
4996 manpages/param.ent,1.15; manpages/param.xweb,1.17;
\r
4997 params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
\r
5000 <listitem role="commit-message">
\r
5001 <para>After namespace stripping, the
\r
5002 source document is the temporary tree created by the stripping
\r
5003 process and it has the wrong base <tag>URI</tag> for relative
\r
5004 references. Earlier versions of this code used to try to fix that
\r
5005 by patching the elements with relative @fileref attributes. That
\r
5006 was inadequate because it calculated an absolute base <tag>URI</tag>
\r
5007 without considering that there might be xml:base attributes
\r
5008 already in effect. It seems obvious now that the right thing to
\r
5009 do is simply to put the xml:base on the root of the document. And
\r
5010 that seems to work.</para>
\r
5011 <para role="commit-changes">Modified: common/stripns.xsl,1.7 - Norman
\r
5014 <listitem role="commit-message">
\r
5015 <para>Added support for "software" and
\r
5016 "sectdesc" class values on <tag>refmiscinfo</tag>; "software" is
\r
5017 treated identically to "source", and "setdesc" is treated
\r
5018 identically to "manual".</para>
\r
5019 <para role="commit-changes">Modified: common/refentry.xsl,1.10;
\r
5020 params/man.th.extra2.max.length.xml,1.3;
\r
5021 params/refentry.source.name.profile.xml,1.4 - Michael(tm)
\r
5024 <listitem role="commit-message">
\r
5025 <para>Added support for DocBook 5
\r
5026 namespace-stripping in manpages stylesheet. Closes request
\r
5028 <para role="commit-changes">Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 -
\r
5029 Michael(tm) Smith</para>
\r
5031 <listitem role="commit-message">
\r
5032 <para>Added <xsl:template
\r
5033 match="/"> to make stripns.xsl usable as a standalone
\r
5034 stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that
\r
5035 DocBook XSLT drivers that include this stylesheet all override
\r
5036 the match="/" template.</para>
\r
5037 <para role="commit-changes">Modified: common/stripns.xsl,1.4 - Michael(tm)
\r
5040 <listitem role="commit-message">
\r
5041 <para>Number figures, examples, and
\r
5042 tables from <tag>book</tag> if there is no prefix (i.e. if
\r
5043 <parameter>chapter.autolabel</parameter> is set to 0). This avoids
\r
5044 having the list of figures where the figures mysteriously restart
\r
5045 their numeration periodically when
\r
5046 <parameter>chapter.autolabel</parameter> is set to
\r
5048 <para role="commit-changes">Modified: common/labels.xsl,1.36 - David Cramer</para>
\r
5050 <listitem role="commit-message">
\r
5051 <para>Add <tag>task</tag> template in
\r
5052 <tag>title</tag>.markup mode.</para>
\r
5053 <para role="commit-changes">Modified: common/titles.xsl,1.34 - Robert
\r
5056 <listitem role="commit-message">
\r
5057 <para>Add children (with ids) of formal
\r
5058 objects to target data.</para>
\r
5059 <para role="commit-changes">Modified: common/targets.xsl,1.10 - Robert
\r
5062 <listitem role="commit-message">
\r
5063 <para>Added support for case when
\r
5064 <tag>personname</tag> doesn't contain specific name markup (as allowed
\r
5065 in DocBook 5.0)</para>
\r
5066 <para role="commit-changes">Modified: common/common.xsl,1.54 - Jirka
\r
5070 </sect2><!--end of Common changes for snapshot_2006-05-15_0803-->
\r
5072 <sect2 xml:id="V1700_Extensions">
\r
5073 <title>Extensions</title>
\r
5074 <para>The following changes have been made to the
\r
5075 <filename>extensions</filename> code
\r
5076 since the 1.69.1 release.</para>
\r
5078 <listitem role="commit-message">
\r
5079 <para>Support Xalan
\r
5081 <para role="commit-changes">Modified: extensions/xalan27/.cvsignore,1.1;
\r
5082 extensions/xalan27/build.xml,1.1;
\r
5083 extensions/xalan27/nbproject/.cvsignore,1.1;
\r
5084 extensions/xalan27/nbproject/build-impl.xml,1.1;
\r
5085 extensions/xalan27/nbproject/genfiles.properties,1.1;
\r
5086 extensions/xalan27/nbproject/project.properties,1.1;
\r
5087 extensions/xalan27/nbproject/project.xml,1.1;
\r
5088 extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1;
\r
5089 extensions/xalan27/src/com/nwalsh/xalan/Callout.java,1.1;
\r
5090 extensions/xalan27/src/com/nwalsh/xalan/FormatCallout.java,1.1;
\r
5091 extensions/xalan27/src/com/nwalsh/xalan/FormatDingbatCallout.java,1.1;
\r
5092 extensions/xalan27/src/com/nwalsh/xalan/FormatGraphicCallout.java,1.1;
\r
5093 extensions/xalan27/src/com/nwalsh/xalan/FormatTextCallout.java,1.1;
\r
5094 extensions/xalan27/src/com/nwalsh/xalan/FormatUnicodeCallout.java,1.1;
\r
5095 extensions/xalan27/src/com/nwalsh/xalan/Func.java,1.1;
\r
5096 extensions/xalan27/src/com/nwalsh/xalan/ImageIntrinsics.java,1.1;
\r
5097 extensions/xalan27/src/com/nwalsh/xalan/Params.java,1.1;
\r
5098 extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1;
\r
5099 extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1;
\r
5100 extensions/xalan27/src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman
\r
5103 <listitem role="commit-message">
\r
5104 <para>Handle the case where the imageFn
\r
5105 is actually a <tag>URI</tag>. This still needs
\r
5107 <para role="commit-changes">Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4
\r
5108 - Norman Walsh</para>
\r
5111 </sect2><!--end of Extensions changes for snapshot_2006-05-15_0803-->
\r
5113 <sect2 xml:id="V1700_FO">
\r
5115 <para>The following changes have been made to the
\r
5116 <filename>fo</filename> code
\r
5117 since the 1.69.1 release.</para>
\r
5119 <listitem role="commit-message">
\r
5120 <para>Adapted to the new indexing
\r
5121 code. Now works just like a wrapper that calls kosek indexing method,
\r
5122 originally implemented here.</para>
\r
5123 <para role="commit-changes">Modified: fo/autoidx-ng.xsl,1.5 - Jirka
\r
5126 <listitem role="commit-message">
\r
5127 <para>Added parameters for header/footer
\r
5128 <tag>table</tag> minimum height.</para>
\r
5129 <para role="commit-changes">Modified: fo/pagesetup.xsl,1.60;
\r
5130 fo/param.ent,1.100; fo/param.xweb,1.113 - Robert
\r
5133 <listitem role="commit-message">
\r
5134 <para>Add the <tag>index</tag>.method
\r
5136 <para role="commit-changes">Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert
\r
5139 <listitem role="commit-message">
\r
5140 <para>Integrate support for three
\r
5141 indexing methods: - the original English-only method. -
\r
5142 Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's
\r
5143 method using Saxon extensions. Use the '<tag>index</tag>.method'
\r
5144 parameter to select.</para>
\r
5145 <para role="commit-changes">Modified: fo/autoidx.xsl,1.38 - Robert
\r
5148 <listitem role="commit-message">
\r
5149 <para>Add support for <tag>TOC</tag> for
\r
5150 <tag>qandaset</tag> in fo output.</para>
\r
5151 <para role="commit-changes">Modified: fo/autotoc.xsl,1.30;
\r
5152 fo/qandaset.xsl,1.20 - Robert Stayton</para>
\r
5154 <listitem role="commit-message">
\r
5155 <para>Added parameter
\r
5156 <parameter>ulink.hyphenate</parameter>.chars. Added parameter
\r
5157 insert.<tag>link</tag>.page.number.</para>
\r
5158 <para role="commit-changes">Modified: fo/param.ent,1.98;
\r
5159 fo/param.xweb,1.111 - Robert Stayton</para>
\r
5161 <listitem role="commit-message">
\r
5162 <para>Implemented feature request
\r
5163 #942524 to add insert.<tag>link</tag>.page.number to allow link
\r
5164 element cross references to have a page number.</para>
\r
5165 <para role="commit-changes">Modified: fo/xref.xsl,1.67 -
\r
5166 Robert Stayton</para>
\r
5168 <listitem role="commit-message">
\r
5169 <para>Add support for
\r
5170 <parameter>ulink.hyphenate</parameter>.chars so more characters
\r
5171 can be break points in urls.</para>
\r
5172 <para role="commit-changes">Modified: fo/xref.xsl,1.66 - Robert
\r
5175 <listitem role="commit-message">
\r
5176 <para>Implemented patch #1075144 to make
\r
5177 the url text in a ulink in FO output an active <tag>link</tag> as
\r
5179 <para role="commit-changes">Modified: fo/xref.xsl,1.65 - Robert Stayton</para>
\r
5181 <listitem role="commit-message">
\r
5182 <para><tag>table</tag> footnotes now
\r
5183 have their own <tag>table</tag>.<tag>footnote</tag>.properties
\r
5184 attribute set.</para>
\r
5185 <para role="commit-changes">Modified: fo/footnote.xsl,1.23 - Robert
\r
5188 <listitem role="commit-message">
\r
5189 <para>Add <tag>qandaset</tag> to
\r
5190 root.elements.</para>
\r
5191 <para role="commit-changes">Modified: fo/docbook.xsl,1.41 - Robert
\r
5194 <listitem role="commit-message">
\r
5195 <para>Added mode="page.sequence" to make
\r
5196 it easier to put content into a page sequence. First used for
\r
5197 <tag>qandaset</tag>.</para>
\r
5198 <para role="commit-changes">Modified: fo/component.xsl,1.37 - Robert
\r
5201 <listitem role="commit-message">
\r
5202 <para>Implemented feature request
\r
5203 #1434408 to support formatting
\r
5204 of <tag>biblioentry</tag>.</para>
\r
5205 <para role="commit-changes">Modified: fo/biblio.xsl,1.35 - Robert
\r
5208 <listitem role="commit-message">
\r
5210 <tag>biblioentry</tag>.properties.</para>
\r
5211 <para role="commit-changes">Modified: fo/param.ent,1.97;
\r
5212 fo/param.xweb,1.110 - Robert Stayton</para>
\r
5214 <listitem role="commit-message">
\r
5215 <para>Support PTC/Arbortext
\r
5217 <para role="commit-changes">Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman
\r
5220 <listitem role="commit-message">
\r
5222 <tag>table</tag>.<tag>footnote</tag>.properties to permit
\r
5223 <tag>table</tag> footnotes to format differently from regular
\r
5225 <para role="commit-changes">Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert
\r
5228 <listitem role="commit-message">
\r
5229 <para>Refactored <tag>table</tag>
\r
5230 templates to unify their processing and support all options in
\r
5231 all types. Now <tag>table</tag> and <tag>informaltable</tag>, in
\r
5232 both Cals and Html markup, use the same templates where possible,
\r
5233 and all support pgwide, rotation, and floats. There is also a
\r
5234 placeholder <tag>table</tag>.container template to
\r
5235 support wrapping a <tag>table</tag> in a layout <tag>table</tag>,
\r
5236 so the XEP <tag>table</tag> <tag>title</tag> "continued"
\r
5237 extension can be more easily implemented.</para>
\r
5238 <para role="commit-changes">Modified: fo/formal.xsl,1.52;
\r
5239 fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 - Robert
\r
5242 <listitem role="commit-message">
\r
5243 <para>Added new attribute set
\r
5244 <tag>toc</tag>.line.properties for controlling appearance of lines in
\r
5246 <para role="commit-changes">Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95;
\r
5247 fo/param.xweb,1.108 - Jirka Kosek</para>
\r
5249 <listitem role="commit-message">
\r
5250 <para>Added support for float to example
\r
5251 and <tag>equation</tag>. Added support for pgwide to
\r
5252 <tag>figure</tag>, example, and <tag>equation</tag> (the latter
\r
5253 two via a dbfo pgwide="1" processing
\r
5254 instruction).</para>
\r
5255 <para role="commit-changes">Modified: fo/formal.xsl,1.51 - Robert
\r
5258 <listitem role="commit-message">
\r
5259 <para>Add pgwide.properties
\r
5260 attribute-set.</para>
\r
5261 <para role="commit-changes">Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert
\r
5264 <listitem role="commit-message">
\r
5265 <para>Added <tag>refclass</tag>.suppress
\r
5267 <para>If the value of <tag>refclass</tag>.suppress is
\r
5268 non-zero, then display <tag>refclass</tag> contents is suppressed
\r
5269 in output. Affects HTML and FO output
\r
5271 <para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
\r
5272 html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
\r
5275 <listitem role="commit-message">
\r
5276 <para>Improved support for
\r
5277 <tag>task</tag> subelements</para>
\r
5278 <para role="commit-changes">Modified: fo/task.xsl,1.3; html/task.xsl,1.3 -
\r
5279 Jirka Kosek</para>
\r
5281 <listitem role="commit-message">
\r
5282 <para>Adjusted spacing around
\r
5283 K&R-formatted <tag>Funcdef</tag> and <tag>Paramdef</tag>
\r
5284 output such that it can more easily be discerned where one ends
\r
5285 and the other begins. Closes #1213264.</para>
\r
5286 <para role="commit-changes">Modified: fo/synop.xsl,1.18 -
\r
5287 Michael(tm) Smith</para>
\r
5289 <listitem role="commit-message">
\r
5290 <para>Made handling of
\r
5291 paramdef/parameter in FO output consistent with that in HTML and
\r
5292 manpages output. Closes #1213259.</para>
\r
5293 <para role="commit-changes">Modified: fo/synop.xsl,1.17 - Michael(tm)
\r
5296 <listitem role="commit-message">
\r
5297 <para>Made handling of
\r
5298 <tag>Refnamediv</tag> consistent with formatting in HTML
\r
5299 and manpages output; specifically, changed so that
\r
5300 <tag>Refname</tag> (comma-separated list of multiple instances
\r
5301 found) is used (instead of <tag>Refentrytitle</tag> as
\r
5302 previously), then em-dash, then the <tag>Refpurpose</tag>. Closes
\r
5304 <para role="commit-changes">Modified: fo/refentry.xsl,1.30 - Michael(tm)
\r
5307 <listitem role="commit-message">
\r
5308 <para>Added output of
\r
5309 <tag>Releaseinfo</tag> to recto titlepage ("<tag>copyright</tag>"
\r
5310 page) for <tag>Book</tag> in FO output. This makes it consistent
\r
5311 with HTML output. Closes #1327034. Thanks to Paul DuBois for
\r
5313 <para role="commit-changes">Modified: fo/titlepage.templates.xml,1.28 - Michael(tm)
\r
5316 <listitem role="commit-message">
\r
5317 <para>Added condition for setting
\r
5318 block-progression-dimension.minimum on table-row, instead of
\r
5319 height, when <parameter>fop1.extensions</parameter> is
\r
5320 non-zero. For an explanation of the reason for the change,
\r
5321 <tag>see</tag>: http://wiki.apache.org/xmlgraphics-fop/Troubleshooting/CommonLogMessages</para>
\r
5322 <para role="commit-changes">Modified: fo/pagesetup.xsl,1.59
\r
5323 - Michael(tm) Smith</para>
\r
5325 <listitem role="commit-message">
\r
5327 <tag>refclass</tag>.suppress param for suppressing display
\r
5328 of <tag>Refclass</tag> in HTML and FO output. Did not add it to
\r
5329 manpages because manpages stylesheet is currently just silently
\r
5330 ignoring <tag>Refclass</tag> anyway. Closes request
\r
5331 #1461065. Thanks to Davor Ocelic (docelic) for
\r
5333 <para role="commit-changes">Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 -
\r
5334 Michael(tm) Smith</para>
\r
5336 <listitem role="commit-message">
\r
5337 <para>Add support for keep-together PI
\r
5338 to informal objects.</para>
\r
5339 <para role="commit-changes">Modified: fo/formal.xsl,1.50 - Robert
\r
5342 <listitem role="commit-message">
\r
5343 <para>Add support for
\r
5344 <parameter>fop1.extensions</parameter>.</para>
\r
5345 <para role="commit-changes">Modified: fo/formal.xsl,1.49;
\r
5346 fo/graphics.xsl,1.44; fo/table.xsl,1.47 - Robert
\r
5349 <listitem role="commit-message">
\r
5350 <para>Add support for fop1
\r
5352 <para role="commit-changes">Modified: fo/docbook.xsl,1.39 - Robert
\r
5355 <listitem role="commit-message">
\r
5356 <para>Add fop1.extentions parameter to
\r
5357 add support for fop development version.</para>
\r
5358 <para role="commit-changes">Modified: fo/param.ent,1.92;
\r
5359 fo/param.xweb,1.105 - Robert Stayton</para>
\r
5361 <listitem role="commit-message">
\r
5362 <para>Start supporting fop development
\r
5363 version, which will become fop version 1.</para>
\r
5364 <para role="commit-changes">Modified: fo/fop1.xsl,1.1 -
\r
5365 Robert Stayton</para>
\r
5367 <listitem role="commit-message">
\r
5368 <para>Add template for <tag>task</tag>
\r
5369 in mode="xref-to".</para>
\r
5370 <para role="commit-changes">Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert
\r
5373 <listitem role="commit-message">
\r
5374 <para><tag>table</tag> footnotes now
\r
5375 also get <tag>footnote</tag>.properties
\r
5376 attribute-set.</para>
\r
5377 <para role="commit-changes">Modified: fo/footnote.xsl,1.22 - Robert
\r
5380 <listitem role="commit-message">
\r
5381 <para>Added <tag>index</tag>.separator
\r
5382 named template to compute the separator punctuation based on
\r
5384 <para role="commit-changes">Modified: fo/autoidx.xsl,1.36 - Robert Stayton</para>
\r
5386 <listitem role="commit-message">
\r
5387 <para>Added support for <tag>link</tag>,
\r
5388 <tag>olink</tag>, and <tag>xref</tag> within OO
\r
5389 <tag>Classsynopsis</tag> and children. (Because DocBook NG/5
\r
5390 allows it).</para>
\r
5391 <para role="commit-changes">Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm)
\r
5394 <listitem role="commit-message">
\r
5395 <para>Support <tag>date</tag> as an
\r
5397 <para role="commit-changes">Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman
\r
5400 <listitem role="commit-message">
\r
5401 <para>Added new parameter
\r
5402 <parameter>keep.relative.image.uris</parameter></para>
\r
5403 <para role="commit-changes">Modified: fo/param.ent,1.91;
\r
5404 fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
\r
5405 params/keep.relative.image.uris.xml,1.1 - Norman
\r
5408 <listitem role="commit-message">
\r
5409 <para>Map Unicode space characters
\r
5410 U+2000-U+200A to fo:leaders.</para>
\r
5411 <para role="commit-changes">Modified: fo/docbook.xsl,1.38;
\r
5412 fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 - Jirka
\r
5415 <listitem role="commit-message">
\r
5416 <para>Output a real em dash for em-dash
\r
5417 dingbat (instead of two hypens).</para>
\r
5418 <para role="commit-changes">Modified: fo/fo.xsl,1.7 - Michael(tm)
\r
5421 <listitem role="commit-message">
\r
5422 <para>Support default <tag>label</tag>
\r
5423 width parameters for itemized and ordered lists</para>
\r
5424 <para role="commit-changes">Modified: fo/lists.xsl,1.64;
\r
5425 fo/param.ent,1.90; fo/param.xweb,1.103;
\r
5426 params/itemizedlist.label.width.xml,1.1;
\r
5427 params/orderedlist.label.width.xml,1.1 - Norman
\r
5430 <listitem role="commit-message">
\r
5431 <para>Generate localized
\r
5432 <tag>title</tag> for <tag>Refsynopsisdiv</tag> if no
\r
5433 appropriate <tag>Title</tag> descendant found in source. Closes
\r
5434 #1212398. This change makes behavior for the <tag>Synopsis</tag>
\r
5435 <tag>title</tag> consistent with the behavior of HTML and
\r
5436 manpages output.</para>
\r
5438 xsl:use-attribute-sets="normal.<tag>para</tag>.spacing" to
\r
5439 block generated for <tag>Cmdsynopsis</tag> output. Previously,
\r
5440 that block had no spacing at all specified, which resulted it
\r
5441 being crammed up to closely to the <tag>Synopsis</tag>
\r
5443 <para role="commit-changes">Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm)
\r
5446 <listitem role="commit-message">
\r
5447 <para>Added parameters to support
\r
5448 localization of <tag>index</tag>
\r
5449 item punctuation.</para>
\r
5450 <para role="commit-changes">Modified: fo/autoidx.xsl,1.35 - Robert
\r
5453 <listitem role="commit-message">
\r
5455 <parameter>index.number.separator</parameter>,
\r
5456 <parameter>index.range.separator</parameter>,
\r
5457 and <parameter>index.term.separator</parameter> parameters to
\r
5458 support localization of punctuation in <tag>index</tag>
\r
5460 <para role="commit-changes">Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert
\r
5463 <listitem role="commit-message">
\r
5464 <para>Added "Cross References"
\r
5465 <tag>section</tag> in HTML doc (for consistency with the FO
\r
5466 doc). Also, moved the existing FO "Cross
\r
5467 References" <tag>section</tag> to follow the "Linking"
\r
5468 <tag>section</tag>.</para>
\r
5469 <para role="commit-changes">Modified: fo/param.xweb,1.101; html/param.xweb,1.95 -
\r
5470 Michael(tm) Smith</para>
\r
5472 <listitem role="commit-message">
\r
5473 <para>Added ID attribues to all
\r
5474 <tag>Reference</tag> elements (e.g., id="tables" for the doc for
\r
5475 <tag>section</tag> on <tag>Table</tag> params). So pages for
\r
5476 all subsections of ref docs now have stable filenames instead
\r
5477 of arbitrary generated filenames.</para>
\r
5478 <para role="commit-changes">Modified: fo/param.xweb,1.100;
\r
5479 html/param.xweb,1.94 - Michael(tm) Smith</para>
\r
5481 <listitem role="commit-message">
\r
5482 <para>Added two new parameters for
\r
5483 handling of multi-term
\r
5484 <tag>varlistentry</tag> elements:</para>
\r
5485 <para><parameter>variablelist.term.break.after</parameter>:
\r
5486 When the <parameter>variablelist.term.break.after</parameter> is
\r
5487 non-zero, it will generate a line break after each
\r
5488 <tag>term</tag> multi-term
\r
5489 <tag>varlistentry</tag>.</para>
\r
5490 <para><parameter>variablelist.term.separator</parameter>:
\r
5491 When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
\r
5492 elements, the string specified in the value of the
\r
5493 <parameter>variablelist.term.separator</parameter> parameter is
\r
5494 placed after each <tag>term</tag> except the last. The default
\r
5495 is ", " (a comma followed by a space). To suppress rendering of
\r
5496 the separator, set the value of
\r
5497 <parameter>variablelist.term.separator</parameter> to the empty
\r
5498 string ("").</para>
\r
5499 <para>These parameters are primarily intended to be
\r
5500 useful if you have multi-term varlistentries that have long
\r
5502 <para>Closes #1306676. Thanks to Sam Steingold for
\r
5503 providing an example "lots of long terms" doc that demonstrated
\r
5504 the value of having these options.</para>
\r
5506 normalize-space() call to processing of each
\r
5507 <tag>term</tag>.</para>
\r
5508 <para>This change affects all output formats
\r
5509 (HTML, PDF, manpages). The default behavior should pretty much
\r
5510 remain the same as before, but it is possible (as always) that
\r
5511 the change may introduce some
\r
5512 new bugginess.</para>
\r
5513 <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
\r
5514 fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
\r
5515 html/param.xweb,1.93; manpages/lists.xsl,1.22;
\r
5516 manpages/param.ent,1.14; manpages/param.xweb,1.16;
\r
5517 params/variablelist.term.break.after.xml,1.1;
\r
5518 params/variablelist.term.separator.xml,1.1 - Michael(tm)
\r
5521 <listitem role="commit-message">
\r
5522 <para>Add <tag>sidebar</tag> titlepage
\r
5523 placeholder attset for styles.</para>
\r
5524 <para role="commit-changes">Modified: fo/titlepage.xsl,1.37 - Robert
\r
5527 <listitem role="commit-message">
\r
5528 <para>Add titlepage for
\r
5529 <tag>sidebar</tag>.</para>
\r
5530 <para role="commit-changes">Modified: fo/titlepage.templates.xml,1.27 - Robert
\r
5533 <listitem role="commit-message">
\r
5534 <para>Implemented RFE
\r
5536 <para>Added bunch of new parameters (attribute sets)
\r
5537 that affect list presentation: list.block.properties,
\r
5538 <tag>itemizedlist</tag>.properties, <tag>orderedlist</tag>.properties,
\r
5539 <tag>itemizedlist</tag>.<tag>label</tag>.properties and
\r
5540 <tag>orderedlist</tag>.<tag>label</tag>.properties. Default behaviour
\r
5541 of stylesheets has not been changed but further customizations will be
\r
5542 much more easier.</para>
\r
5543 <para role="commit-changes">Modified: fo/lists.xsl,1.61; fo/param.ent,1.87;
\r
5544 fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1;
\r
5545 params/itemizedlist.properties.xml,1.1;
\r
5546 params/list.block.properties.xml,1.1;
\r
5547 params/orderedlist.label.properties.xml,1.1;
\r
5548 params/orderedlist.properties.xml,1.1 - Jirka
\r
5551 <listitem role="commit-message">
\r
5552 <para>Implemented RFE
\r
5554 <para>You can enable crop marks in your document by
\r
5555 setting crop.marks=1 and xep.extensions=1. Appearance of crop
\r
5556 marks can be controlled by parameters
\r
5557 <parameter>crop.mark.bleed</parameter> (6pt),
\r
5558 <parameter>crop.mark.offset</parameter> (24pt) and
\r
5559 <parameter>crop.mark.width</parameter> (0.5pt).</para>
\r
5561 is new named template called user-xep-pis. You can overwrite it in
\r
5562 order to produce some PIs that can control XEP as described in
\r
5563 http://www.renderx.com/reference.html#Output_Formats</para>
\r
5564 <para role="commit-changes">Modified: fo/docbook.xsl,1.36;
\r
5565 fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23;
\r
5566 params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1;
\r
5567 params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka
\r
5571 </sect2><!--end of FO changes for snapshot_2006-05-15_0803-->
\r
5573 <sect2 xml:id="V1700_HTML">
\r
5574 <title>HTML</title>
\r
5575 <para>The following changes have been made to the
\r
5576 <filename>html</filename> code
\r
5577 since the 1.69.1 release.</para>
\r
5579 <listitem role="commit-message">
\r
5581 <tag>index</tag>.method parameter and three
\r
5583 <para role="commit-changes">Modified: html/autoidx.xsl,1.28 - Robert
\r
5586 <listitem role="commit-message">
\r
5587 <para>added <tag>index</tag>.method
\r
5588 parameter to support 3 indexing methods.</para>
\r
5589 <para role="commit-changes">Modified: html/param.ent,1.94;
\r
5590 html/param.xweb,1.103 - Robert Stayton</para>
\r
5592 <listitem role="commit-message">
\r
5593 <para>Implemented feature request
\r
5594 #1072510 as a processing instruction to permit including external
\r
5595 HTML content into HTML output.</para>
\r
5596 <para role="commit-changes">Modified: html/pi.xsl,1.9 - Robert
\r
5599 <listitem role="commit-message">
\r
5600 <para>Added new parameter
\r
5601 <parameter>chunk.tocs.and.lots</parameter>.has.<tag>title</tag> which
\r
5602 controls presence of <tag>title</tag> in a separate chunk with
\r
5603 ToC/LoT. Disabling <tag>title</tag> can be very useful if you are
\r
5604 generating frameset output (well, yes those frames, but some customers
\r
5605 really want them ;-).</para>
\r
5606 <para role="commit-changes">Modified: html/chunk-code.xsl,1.15;
\r
5607 html/param.ent,1.93; html/param.xweb,1.102;
\r
5608 params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
\r
5611 <listitem role="commit-message">
\r
5612 <para>Support dbhtml/dbfo start PI for
\r
5613 <tag>orderedlist</tag> numbering in both HTML and
\r
5615 <para role="commit-changes">Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman
\r
5618 <listitem role="commit-message">
\r
5619 <para>Allow <tag>ToC</tag> without
\r
5620 <tag>title</tag> also for set and
\r
5621 <tag>book</tag>.</para>
\r
5622 <para role="commit-changes">Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 -
\r
5623 Jirka Kosek</para>
\r
5625 <listitem role="commit-message">
\r
5626 <para>Implemented floats uniformly for
\r
5627 <tag>figure</tag>, example, <tag>equation</tag>
\r
5628 and <tag>informalfigure</tag>, <tag>informalexample</tag>, and
\r
5629 <tag>informalequation</tag>.</para>
\r
5630 <para role="commit-changes">Modified: html/formal.xsl,1.22 - Robert
\r
5633 <listitem role="commit-message">
\r
5635 autotoc.<tag>label</tag>.in.hyperlink param.</para>
\r
5636 <para>If the value
\r
5637 of autotoc.<tag>label</tag>.in.hyperlink is non-zero, labels
\r
5638 are included in hyperlinked titles in the <tag>TOC</tag>. If it
\r
5639 is instead zero, labels are still displayed prior to the
\r
5640 hyperlinked titles, but are not hyperlinked along with the
\r
5642 <para>Closes patch #1065868. Thanks to anatoly techtonik
\r
5643 for the patch.</para>
\r
5644 <para role="commit-changes">Modified: html/autotoc.xsl,1.36; html/param.ent,1.92;
\r
5645 html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 -
\r
5646 Michael(tm) Smith</para>
\r
5648 <listitem role="commit-message">
\r
5649 <para>Added two new params:
\r
5650 html.head.<tag>legalnotice</tag>.<tag>link</tag>.types
\r
5651 and html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple.</para>
\r
5653 the value of the <parameter>generate.legalnotice.link</parameter> is
\r
5654 non-zero, then the stylesheet generates (in the head
\r
5655 <tag>section</tag> of the HTML source) either a single HTML
\r
5656 <tag>link</tag> element or, if the value of
\r
5657 the html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple is
\r
5658 non-zero, one <tag>link</tag> element for each <tag>link</tag>
\r
5659 type specified. Each <tag>link</tag> has the
\r
5660 following attributes:</para>
\r
5661 <para> - a rel attribute whose value
\r
5662 is derived from the value of
\r
5663 html.head.<tag>legalnotice</tag>.<tag>link</tag>.types</para>
\r
5665 an href attribute whose value is set to the URL of the file
\r
5666 containing the <tag>legalnotice</tag></para>
\r
5667 <para> - a <tag>title</tag>
\r
5668 attribute whose value is set to the <tag>title</tag> of the
\r
5669 corresponding <tag>legalnotice</tag> (or a <tag>title</tag>
\r
5670 programatically determined by the stylesheet)</para>
\r
5673 <para> <<tag>link</tag> rel="<tag>copyright</tag>"
\r
5674 href="ln-id2524073.html" title="Legal Notice"></para>
\r
5676 #1476450. Thanks to Sam Steingold.</para>
\r
5677 <para role="commit-changes">Modified: html/chunk-common.xsl,1.45;
\r
5678 html/param.ent,1.91; html/param.xweb,1.100;
\r
5679 params/generate.legalnotice.link.xml,1.4;
\r
5680 params/html.head.legalnotice.link.multiple.xml,1.1;
\r
5681 params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm)
\r
5684 <listitem role="commit-message">
\r
5685 <para>Added <tag>refclass</tag>.suppress
\r
5687 <para>If the value of <tag>refclass</tag>.suppress is
\r
5688 non-zero, then display <tag>refclass</tag> contents is suppressed
\r
5689 in output. Affects HTML and FO output
\r
5691 <para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
\r
5692 html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
\r
5695 <listitem role="commit-message">
\r
5696 <para>Improved support for
\r
5697 <tag>task</tag> subelements</para>
\r
5698 <para role="commit-changes">Modified: fo/task.xsl,1.3; html/task.xsl,1.3 -
\r
5699 Jirka Kosek</para>
\r
5701 <listitem role="commit-message">
\r
5703 <tag>refclass</tag>.suppress param for suppressing display
\r
5704 of <tag>Refclass</tag> in HTML and FO output. Did not add it to
\r
5705 manpages because manpages stylesheet is currently just silently
\r
5706 ignoring <tag>Refclass</tag> anyway. Closes request
\r
5707 #1461065. Thanks to Davor Ocelic (docelic) for
\r
5709 <para role="commit-changes">Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 -
\r
5710 Michael(tm) Smith</para>
\r
5712 <listitem role="commit-message">
\r
5713 <para>Process <tag>alt</tag> text with
\r
5714 normalize-space(). Replace tab indents with
\r
5716 <para role="commit-changes">Modified: html/graphics.xsl,1.57 - Robert
\r
5719 <listitem role="commit-message">
\r
5720 <para>Content of <tag>citation</tag>
\r
5721 element is automatically linked to the bibliographic <tag>entry</tag>
\r
5722 with the corresponding <tag>abbrev</tag>.</para>
\r
5723 <para role="commit-changes">Modified: html/biblio.xsl,1.26;
\r
5724 html/inline.xsl,1.47; html/xref.xsl,1.58 - Jirka
\r
5727 <listitem role="commit-message">
\r
5728 <para>Add template for <tag>task</tag>
\r
5729 in mode="xref-to".</para>
\r
5730 <para role="commit-changes">Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert
\r
5733 <listitem role="commit-message">
\r
5734 <para>Suppress ID warnings if the
\r
5735 .warnings parameter is 0</para>
\r
5736 <para role="commit-changes">Modified: html/html.xsl,1.17 - Norman
\r
5739 <listitem role="commit-message">
\r
5740 <para>Add support for floatstyle to
\r
5741 <tag>figure</tag>.</para>
\r
5742 <para role="commit-changes">Modified: html/formal.xsl,1.21 - Robert
\r
5745 <listitem role="commit-message">
\r
5746 <para>Handling of <tag>xref</tag> to
\r
5747 area/areaset need support in extensions code also. I currently have no
\r
5748 time to touch extensions code, so code is here to be enabled when
\r
5749 extension is fixed also.</para>
\r
5750 <para role="commit-changes">Modified: html/xref.xsl,1.56 - Jirka
\r
5753 <listitem role="commit-message">
\r
5754 <para>Added 3 parameters for overriding
\r
5755 gentext for <tag>index</tag>
\r
5756 punctuation.</para>
\r
5757 <para role="commit-changes">Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert
\r
5760 <listitem role="commit-message">
\r
5761 <para>Added parameters to support
\r
5762 localization of <tag>index</tag> item punctuation. Added
\r
5763 <tag>index</tag>.separator named template to compute
\r
5764 the separator punctuation based on
\r
5766 <para role="commit-changes">Modified: html/autoidx.xsl,1.27 - Robert
\r
5769 <listitem role="commit-message">
\r
5770 <para>Added a <div
\r
5771 class="{$class}-contents"> wrapper around output of contents
\r
5772 of all formal objects. Also, added an optional <br
\r
5773 class="{class}-break"/> linebreak after all formal
\r
5775 <para>WARNING: Because this change places an additional
\r
5776 DIV between the DIV wrapper for the <tag>equation</tag> and the
\r
5777 <tag>equation</tag> contents, it may break some existing CSS
\r
5778 stylesheets that have been created with the assumption that there
\r
5779 would never be an intervening DIV there.</para>
\r
5780 <para>The following is
\r
5781 an example of what <tag>Equation</tag> output looks like as a
\r
5782 result of the changes described above.</para>
\r
5784 class="<tag>equation</tag>"> <a name="three"
\r
5785 id="three"></a></para>
\r
5787 class="<tag>title</tag>"><b>(1.3)</b></p></para>
\r
5789 <div class="equation-contents"> <span
\r
5790 class="<tag>mathphrase</tag>">1+1=3</span>
\r
5791 </div> </div><br
\r
5792 class="equation-break"></para>
\r
5793 <para>Rationale: These changes allow
\r
5794 CSS control of the placement of the formal-object
\r
5795 <tag>title</tag> relative to the formal-object
\r
5796 contents. For example, using the CSS "float" <tag>property</tag>
\r
5797 enables the <tag>title</tag> and contents to be rendered on the
\r
5798 same line. Example stylesheet:</para>
\r
5799 <para> .<tag>equation</tag>
\r
5800 { margin-top: 20px; margin-bottom: 20px; }
\r
5801 .equation-contents { float: left; }</para>
\r
5803 .<tag>equation</tag> .<tag>title</tag> { margin-top: 0;
\r
5804 float: right; margin-right: 200px; }</para>
\r
5806 .<tag>equation</tag> .<tag>title</tag> b { font-weight:
\r
5808 <para> .equation-break { clear: both;
\r
5810 <para>Note that the purpose of the ".equation-break" class is
\r
5811 to provide a way to clear off the floats.</para>
\r
5813 to instead have the <tag>equation</tag> <tag>title</tag> rendered to
\r
5814 the left of the <tag>equation</tag> contents, you can do
\r
5815 something like this:</para>
\r
5816 <para> .<tag>equation</tag> {
\r
5817 margin-top: 20px; width: 300px; margin-bottom: 20px;
\r
5818 } .equation-contents { float: right; }</para>
\r
5820 .<tag>equation</tag> .<tag>title</tag> { margin-top: 0;
\r
5821 float: left; margin-right: 200px; }</para>
\r
5823 .<tag>equation</tag> .<tag>title</tag> b { font-weight:
\r
5825 <para> .equation-break { clear: both;
\r
5827 <para role="commit-changes">Modified: html/formal.xsl,1.20 - Michael(tm) Smith</para>
\r
5829 <listitem role="commit-message">
\r
5830 <para>Added a chunker.output.quiet
\r
5831 top-level parameter so that the chunker can be made quiet by
\r
5833 <para role="commit-changes">Modified: html/chunker.xsl,1.26 - Norman Walsh</para>
\r
5835 <listitem role="commit-message">
\r
5836 <para>Added support for <tag>link</tag>,
\r
5837 <tag>olink</tag>, and <tag>xref</tag> within OO
\r
5838 <tag>Classsynopsis</tag> and children. (Because DocBook NG/5
\r
5839 allows it).</para>
\r
5840 <para role="commit-changes">Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm)
\r
5843 <listitem role="commit-message">
\r
5844 <para>New parameter:
\r
5845 <parameter>id.warnings</parameter>. If non-zero, warnings are
\r
5846 generated for titled objects that don't have titles. True by default;
\r
5847 I wonder if this will be too aggressive?</para>
\r
5848 <para role="commit-changes">Modified: html/biblio.xsl,1.25;
\r
5849 html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19;
\r
5850 html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16;
\r
5851 html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22;
\r
5852 html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman
\r
5855 <listitem role="commit-message">
\r
5857 <parameter>keep.relative.image.uris</parameter> parameter is true,
\r
5858 don't use the absolute <tag>URI</tag> (as calculated from xml:base) in
\r
5859 the img src attribute, us the value the <tag>author</tag>
\r
5860 specified. Note that we still have to calculate the absolute
\r
5861 <tag>filename</tag> for use in the image intrinsics
\r
5863 <para role="commit-changes">Modified: html/graphics.xsl,1.56 - Norman
\r
5866 <listitem role="commit-message">
\r
5867 <para>Support <tag>date</tag> as an
\r
5869 <para role="commit-changes">Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman
\r
5872 <listitem role="commit-message">
\r
5873 <para>Added new parameter
\r
5874 <parameter>keep.relative.image.uris</parameter></para>
\r
5875 <para role="commit-changes">Modified: fo/param.ent,1.91;
\r
5876 fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
\r
5877 params/keep.relative.image.uris.xml,1.1 - Norman
\r
5880 <listitem role="commit-message">
\r
5881 <para>Added two new parameters for
\r
5882 handling of multi-term
\r
5883 <tag>varlistentry</tag> elements:</para>
\r
5884 <para><parameter>variablelist.term.break.after</parameter>:
\r
5885 When the <parameter>variablelist.term.break.after</parameter> is
\r
5886 non-zero, it will generate a line break after each
\r
5887 <tag>term</tag> multi-term
\r
5888 <tag>varlistentry</tag>.</para>
\r
5889 <para><parameter>variablelist.term.separator</parameter>:
\r
5890 When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
\r
5891 elements, the string specified in the value of the
\r
5892 <parameter>variablelist.term.separator</parameter> parameter is
\r
5893 placed after each <tag>term</tag> except the last. The default
\r
5894 is ", " (a comma followed by a space). To suppress rendering of
\r
5895 the separator, set the value of
\r
5896 <parameter>variablelist.term.separator</parameter> to the empty
\r
5897 string ("").</para>
\r
5898 <para>These parameters are primarily intended to be
\r
5899 useful if you have multi-term varlistentries that have long
\r
5901 <para>Closes #1306676. Thanks to Sam Steingold for
\r
5902 providing an example "lots of long terms" doc that demonstrated
\r
5903 the value of having these options.</para>
\r
5905 normalize-space() call to processing of each
\r
5906 <tag>term</tag>.</para>
\r
5907 <para>This change affects all output formats
\r
5908 (HTML, PDF, manpages). The default behavior should pretty much
\r
5909 remain the same as before, but it is possible (as always) that
\r
5910 the change may introduce some
\r
5911 new bugginess.</para>
\r
5912 <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
\r
5913 fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
\r
5914 html/param.xweb,1.93; manpages/lists.xsl,1.22;
\r
5915 manpages/param.ent,1.14; manpages/param.xweb,1.16;
\r
5916 params/variablelist.term.break.after.xml,1.1;
\r
5917 params/variablelist.term.separator.xml,1.1 - Michael(tm)
\r
5920 <listitem role="commit-message">
\r
5921 <para>Added "wrapper-name" param to
\r
5922 inline.charseq named template, enabling it to output inlines
\r
5923 other than just "span". <tag>Acronym</tag> and <tag>Abbrev</tag>
\r
5924 templates now use inline.charseq to output HTML
\r
5925 "<tag>acronym</tag>" and "abbr" elements (instead of
\r
5926 "span"). Closes #1305468. Thanks to Sam Steingold for suggesting
\r
5927 the change.</para>
\r
5928 <para role="commit-changes">Modified: html/inline.xsl,1.45 - Michael(tm)
\r
5932 </sect2><!--end of HTML changes for snapshot_2006-05-15_0803-->
\r
5934 <sect2 xml:id="V1700_Manpages">
\r
5935 <title>Manpages</title>
\r
5936 <para>The following changes have been made to the
\r
5937 <filename>manpages</filename> code
\r
5938 since the 1.69.1 release.</para>
\r
5940 <listitem role="commit-message">
\r
5941 <para>Added the following
\r
5943 <para> - man.indent.width (string-valued) -
\r
5944 man.indent.refsect (boolean) - man.indent.blurbs (boolean)
\r
5945 - man.indent.lists (boolean) - man.indent.verbatims
\r
5947 <para>Note that in earlier snapshots, man.indent.width
\r
5948 was named man.indentation.default.value and the boolean params
\r
5949 had names like man.indentation.*.adjust. Also the
\r
5950 man.indent.blurbs param was called man.indentation.authors.adjust
\r
5951 (or something).</para>
\r
5952 <para>The behavior now is: If the value of a
\r
5953 particular man.indent.* boolean param is non-zero, the
\r
5954 corresponding contents (refsect*, list items,
\r
5955 authorblurb/personblurb, vervatims) are displayed with a left
\r
5956 margin indented by a width equal to the value
\r
5957 of man.indent.width.</para>
\r
5958 <para role="commit-changes">Modified: params/man.indent.blurbs.xml,1.1;
\r
5959 manpages/docbook.xsl,1.74; manpages/info.xsl,1.20;
\r
5960 manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
\r
5961 manpages/param.ent,1.22; manpages/param.xweb,1.24;
\r
5962 manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1;
\r
5963 params/man.indent.refsect.xml,1.1;
\r
5964 params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 -
\r
5965 Michael(tm) Smith</para>
\r
5967 <listitem role="commit-message">
\r
5969 man.<tag>table</tag>.footnotes.divider param.</para>
\r
5971 <tag>table</tag> that contains footenotes, the string specified
\r
5972 by the man.<tag>table</tag>.footnotes.divider parameter is output
\r
5973 before the list of footnotes for the
\r
5974 <tag>table</tag>.</para>
\r
5975 <para role="commit-changes">Modified: manpages/docbook.xsl,1.73;
\r
5976 manpages/links.xsl,1.6; manpages/param.ent,1.21;
\r
5977 manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 -
\r
5978 Michael(tm) Smith</para>
\r
5980 <listitem role="commit-message">
\r
5982 man.output.in.separate.dir,
\r
5983 man.output.<parameter>base.dir</parameter>,
\r
5984 and man.output.subdirs.enabled parameters.</para>
\r
5986 man.output.<parameter>base.dir</parameter> parameter specifies the
\r
5987 base directory into which man-page files are
\r
5988 output. The man.output.subdirs.enabled parameter controls whether
\r
5989 the files are output in subdirectories within the base
\r
5991 <para>The values of the
\r
5992 man.output.<parameter>base.dir</parameter>
\r
5993 and man.output.subdirs.enabled parameters are used only if the
\r
5994 value of man.output.in.separate.dir parameter is non-zero. If the
\r
5995 value of man.output.in.separate.dir is zero, man-page files are
\r
5996 not output in a separate
\r
5998 <para role="commit-changes">Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20;
\r
5999 manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1;
\r
6000 params/man.output.in.separate.dir.xml,1.1;
\r
6001 params/man.output.subdirs.enabled.xml,1.1 - Michael(tm)
\r
6004 <listitem role="commit-message">
\r
6006 man.font.<tag>table</tag>.headings and
\r
6007 man.font.<tag>table</tag>.<tag>title</tag> params, for
\r
6008 controlling font in <tag>table</tag> headings and
\r
6010 <para role="commit-changes">Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19;
\r
6011 manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1;
\r
6012 params/man.font.table.title.xml,1.1 - Michael(tm)
\r
6015 <listitem role="commit-message">
\r
6017 man.font.<tag>funcsynopsisinfo</tag> and
\r
6018 man.font.<tag>funcprototype</tag> params, for specifying the roff
\r
6019 font (for example, BI, B, I) for <tag>funcsynopsisinfo</tag> and
\r
6020 <tag>funcprototype</tag> output.</para>
\r
6021 <para role="commit-changes">Modified: manpages/block.xsl,1.19;
\r
6022 manpages/docbook.xsl,1.69; manpages/param.ent,1.18;
\r
6023 manpages/param.xweb,1.20; manpages/synop.xsl,1.29;
\r
6024 manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1;
\r
6025 params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm)
\r
6028 <listitem role="commit-message">
\r
6030 man.<tag>segtitle</tag>.suppress param.</para>
\r
6031 <para>If the value of
\r
6032 man.<tag>segtitle</tag>.suppress is non-zero, then display
\r
6033 of <tag>segtitle</tag> contents is suppressed in
\r
6035 <para role="commit-changes">Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17;
\r
6036 manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 -
\r
6037 Michael(tm) Smith</para>
\r
6039 <listitem role="commit-message">
\r
6041 man.output.<parameter>manifest</parameter>.enabled and
\r
6042 man.output.manifest.<tag>filename</tag> params.</para>
\r
6044 man.output.<parameter>manifest</parameter>.enabled is non-zero, a list
\r
6045 of filenames for man pages generated by the stylesheet
\r
6046 transformation is written to the file named by
\r
6047 man.output.<parameter>manifest</parameter>.<tag>filename</tag></para>
\r
6048 <para role="commit-changes">Modified: manpages/docbook.xsl,1.67;
\r
6049 manpages/other.xsl,1.19; manpages/param.ent,1.16;
\r
6050 manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1;
\r
6051 params/man.output.manifest.filename.xml,1.1;
\r
6052 tools/make/Makefile.DocBook,1.4 - Michael(tm)
\r
6055 <listitem role="commit-message">
\r
6057 <tag>refentry</tag>.meta.get.quietly param.</para>
\r
6058 <para>If zero (the
\r
6059 default), notes and warnings about "missing" markup are generated
\r
6060 during gathering of <tag>refentry</tag> metadata. If
\r
6061 non-zero, the metadata is gathered "quietly" -- that is, the
\r
6062 notes and warnings are suppressed.</para>
\r
6063 <para>NOTE: If you are
\r
6064 processing a large amount of <tag>refentry</tag> content, you
\r
6065 may be able to speed up processing significantly by setting a
\r
6066 non-zero value for
\r
6067 <tag>refentry</tag>.meta.get.quietly.</para>
\r
6068 <para role="commit-changes">Modified: common/refentry.xsl,1.17;
\r
6069 manpages/param.ent,1.15; manpages/param.xweb,1.17;
\r
6070 params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
\r
6073 <listitem role="commit-message">
\r
6074 <para>Changed names of all boolean
\r
6075 indentation params to man.indent.* Also discarded individual
\r
6076 man.indent.*.value params and switched to just using a common
\r
6077 man.indent.width param (3n by default).</para>
\r
6078 <para role="commit-changes">Modified: manpages/docbook.xsl,1.66;
\r
6079 manpages/info.xsl,1.19; manpages/lists.xsl,1.29;
\r
6080 manpages/other.xsl,1.18; manpages/refentry.xsl,1.13 - Michael(tm)
\r
6083 <listitem role="commit-message">
\r
6084 <para>Added boolean
\r
6085 man.output.in.separate.dir param, to control whether or not man
\r
6086 files are output in separate directory.</para>
\r
6087 <para role="commit-changes">Modified: manpages/docbook.xsl,1.65;
\r
6088 manpages/utility.xsl,1.14 - Michael(tm) Smith</para>
\r
6090 <listitem role="commit-message">
\r
6091 <para>Added options for controlling
\r
6092 indentation of verbatim output. Controlled through the
\r
6093 man.indentation.verbatims.adjust
\r
6094 and man.indentation.verbatims.value params. Closes
\r
6096 <para role="commit-changes">Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 -
\r
6097 Michael(tm) Smith</para>
\r
6099 <listitem role="commit-message">
\r
6100 <para>Added options for controlling
\r
6101 indentation in lists and in *blurb output in the AUTHORS
\r
6102 <tag>section</tag>. Controlled through
\r
6103 the man.indentation.lists.adjust,
\r
6104 man.indentation.lists.value, man.indentation.authors.adjust, and
\r
6105 man.indentation.authors.value parameters. Default is 3 characters
\r
6106 (instead of the roff default of 8 characters). Closes
\r
6108 <para>Also, removed the indent that was being set on
\r
6109 <tag>informalexample</tag> outuput. I will instead add an option
\r
6110 for indenting verbatims, which I think is what the
\r
6111 <tag>informalexample</tag> indent was intended
\r
6112 for originally.</para>
\r
6113 <para role="commit-changes">Modified: manpages/block.xsl,1.14;
\r
6114 manpages/docbook.xsl,1.63; manpages/info.xsl,1.18;
\r
6115 manpages/lists.xsl,1.28 - Michael(tm) Smith</para>
\r
6117 <listitem role="commit-message">
\r
6118 <para>Changed line-spacing call before
\r
6119 <tag>synopfragment</tag> to use ".sp -1n" ("n" units specified)
\r
6120 instead of plain ".sp -1"</para>
\r
6121 <para role="commit-changes">Modified: manpages/synop.xsl,1.28 - Michael(tm)
\r
6124 <listitem role="commit-message">
\r
6125 <para>Added support for writing man
\r
6126 files into a specific output directory and into appropriate
\r
6127 subdirectories within that output directory. Controlled through
\r
6128 the man.<parameter>base.dir</parameter> parameter (similar to the
\r
6129 <parameter>base.dir</parameter> support in the HTML stylesheet) and
\r
6130 the man.subdirs.enabled parameter, which automatically determines
\r
6131 the name of an appropriate subdir (for example, man/man7,
\r
6132 man/man1, etc.) based on the <tag>section</tag> number/manvolnum
\r
6133 of the source <tag>Refentry</tag>.</para>
\r
6134 <para>Closes #1255036 and
\r
6135 #1170317. Thanks to Denis Bradford for the original feature
\r
6136 request, and to Costin Stroie for submitting a patch that was
\r
6137 very helpful in implementing the
\r
6139 <para role="commit-changes">Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 -
\r
6140 Michael(tm) Smith</para>
\r
6142 <listitem role="commit-message">
\r
6143 <para>Refined XPath statements and
\r
6144 notification messages for <tag>refentry</tag> metadata
\r
6146 <para role="commit-changes">Modified: common/common.xsl,1.59; common/refentry.xsl,1.14;
\r
6147 manpages/docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm)
\r
6150 <listitem role="commit-message">
\r
6151 <para>Added support for
\r
6152 <tag>copyright</tag> and <tag>legalnotice</tag>. The manpages
\r
6153 stylesheets now output a <tag>COPYRIGHT</tag> <tag>section</tag>,
\r
6154 after the AUTHORS <tag>section</tag>, if a <tag>copyright</tag>
\r
6155 or <tag>legalnotice</tag> is found in the source. The
\r
6156 <tag>section</tag> contains the <tag>copyright</tag> contents followed
\r
6157 by the <tag>legalnotice</tag> contents. Closes
\r
6159 <para role="commit-changes">Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 -
\r
6160 Michael(tm) Smith</para>
\r
6162 <listitem role="commit-message">
\r
6163 <para>Drastically reworked all of the
\r
6164 XPath expressions used in <tag>refentry</tag> metadata gathering
\r
6165 -- completely removed $parentinfo and turned $info into a set of
\r
6166 nodes that includes the *info contents of the <tag>Refentry</tag>
\r
6167 plus the *info contents all all of its ancestor elements. The
\r
6168 basic XPath expression now used throughout is (using the example
\r
6169 of checking for a <tag>date</tag>):</para>
\r
6171 (($info[//date])[last()]/date)[1].</para>
\r
6172 <para>That selects the "last"
\r
6173 *info/date <tag>date</tag> in document order -- that is, the one
\r
6174 eitther on the <tag>Refentry</tag> itself or on the
\r
6175 closest ancestor to the <tag>Refentry</tag>.</para>
\r
6177 likely this change may break some things; may need to pick up
\r
6178 some pieces later.</para>
\r
6179 <para>Also, changed the default value for the
\r
6180 <parameter>man.th.extra2.max.length</parameter> from 40 to
\r
6182 <para role="commit-changes">Modified: common/common.xsl,1.58; common/refentry.xsl,1.7;
\r
6183 params/man.th.extra2.max.length.xml,1.2;
\r
6184 params/refentry.date.profile.xml,1.2;
\r
6185 params/refentry.manual.profile.xml,1.2;
\r
6186 params/refentry.source.name.profile.xml,1.2;
\r
6187 params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58;
\r
6188 manpages/other.xsl,1.15 - Michael(tm) Smith</para>
\r
6190 <listitem role="commit-message">
\r
6191 <para>Added support for DocBook 5
\r
6192 namespace-stripping in manpages stylesheet. Closes request
\r
6194 <para role="commit-changes">Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 -
\r
6195 Michael(tm) Smith</para>
\r
6197 <listitem role="commit-message">
\r
6198 <para>Fixed handling of <tag>table</tag>
\r
6199 footnotes. With this checkin, the <tag>table</tag> support in the
\r
6200 manpages stylesheet is now basically feature complete. So this
\r
6201 change closes request #619532, "No support for tables" -- the
\r
6202 oldest currently open manpages feature request, submitted by Ben
\r
6203 Secrest (blsecres) on 2002-10-07. Congratulations to me [patting
\r
6204 myself on the back].</para>
\r
6205 <para role="commit-changes">Modified: manpages/block.xsl,1.11;
\r
6206 manpages/docbook.xsl,1.55; manpages/table.xsl,1.15 - Michael(tm)
\r
6209 <listitem role="commit-message">
\r
6210 <para>Added handling for
\r
6211 <tag>table</tag> titles. Also fixed handling of nested tables;
\r
6212 nest tables are now "extracted" and displayed just after their
\r
6213 parent tables.</para>
\r
6214 <para role="commit-changes">Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14
\r
6215 - Michael(tm) Smith</para>
\r
6217 <listitem role="commit-message">
\r
6218 <para>Added option for turning off bold
\r
6219 formatting in <tag>Funcsynopsis</tag>. Boldface formatting in
\r
6220 <tag>function</tag> <tag>synopsis</tag> is mandated in the
\r
6221 man(7) man page and is used almost universally in existing man
\r
6222 pages. Despite that, it really does look like crap to have an
\r
6223 entire <tag>Funcsynopsis</tag> output in bold, so I added params
\r
6224 for turning off the bold formatting and/or replacing it with a
\r
6225 different roff special font (e.g., "RI" for alternating
\r
6226 roman/italic instead of the default "BI" for alternating
\r
6227 bold/italic). The new params
\r
6228 are "man.<tag>funcprototype</tag>.font" and
\r
6229 "man.<tag>funcsynopsisinfo</tag>.font". To be documented
\r
6231 <para>Closes #1452247. Thanks to Joe Orton for the feature
\r
6233 <para role="commit-changes">Modified: params/man.string.subst.map.xml,1.16;
\r
6234 manpages/block.xsl,1.10; manpages/docbook.xsl,1.51;
\r
6235 manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm)
\r
6238 <listitem role="commit-message">
\r
6239 <para>Use AUTHORS instead of
\r
6240 <tag>AUTHOR</tag> if we have multiple people to attribute. Also,
\r
6241 fixed checking such that we generate
\r
6242 <tag>author</tag> <tag>section</tag> even if we don't have an
\r
6243 <tag>author</tag> (as long as there is at least one other
\r
6244 person/entity we can put in the
\r
6245 <tag>section</tag>). Also adjusted assembly of content for
\r
6246 <tag>Author</tag> metainfo field such that we now not only use
\r
6247 <tag>author</tag>, but try to find a "best match" if we can't
\r
6248 find an <tag>author</tag> name to put there.</para>
\r
6250 #1233592. Thanks to Sam Steingold for the
\r
6252 <para role="commit-changes">Modified: manpages/info.xsl,1.12 - Michael(tm)
\r
6255 <listitem role="commit-message">
\r
6256 <para>Changes for request #1243027,
\r
6257 "Impove handling of <tag>AUTHOR</tag> <tag>section</tag>." This
\r
6258 adds support for <tag>Collab</tag>, Corpauthor, Corpcredt,
\r
6259 <tag>Orgname</tag>, <tag>Publishername</tag>, and
\r
6260 <tag>Publisher</tag>. Also adds support for output
\r
6261 of <tag>Affiliation</tag> and its children, and support for using
\r
6262 gentext strings for auto-attributing roles (<tag>Author</tag>,
\r
6263 <tag>Editor</tag>, <tag>Publisher</tag>, Translator, etc.). Also
\r
6264 did a lot of code cleanup and modularization of all the
\r
6265 <tag>AUTHOR</tag> handling code. And fixed a bug that was causing
\r
6266 <tag>Author</tag> <tag>info</tag> to not be picked up correctly
\r
6267 for metainfo comment we embed in man-page
\r
6269 <para role="commit-changes">Modified: manpages/info.xsl,1.11 - Michael(tm)
\r
6272 <listitem role="commit-message">
\r
6273 <para>Support bold output for
\r
6274 "<tag>emphasis</tag> remap='B'". (because Eric Raymond's
\r
6275 doclifter(1) tool converts groff source marked up with ".B"
\r
6276 request or "\fB" escapes to DocBook "<tag>emphasis</tag>
\r
6277 remap='B'".)</para>
\r
6278 <para role="commit-changes">Modified: manpages/inline.xsl,1.14 - Michael(tm)
\r
6281 <listitem role="commit-message">
\r
6282 <para>Added support for
\r
6283 <tag>Segmentedlist</tag>. Details: Output is tabular, with no
\r
6284 option for "list" type output. Output for <tag>Segtitle</tag>
\r
6285 elements can be supressed by
\r
6286 setting man.<tag>segtitle</tag>.suppress. If <tag>Segtitle</tag>
\r
6287 content is output, it is rendered in italic type (not bold
\r
6288 because not all terminals support bold and so italic ensures the
\r
6289 stand out on those terminals). Extra space (.sp line) at end of
\r
6290 <tag>table</tag> code ensures that it gets handled correctly in
\r
6291 the case where its source is the child of a <tag>Para</tag>.
\r
6292 Closes feature-request #1400097. Thanks to Daniel Leidert for the
\r
6293 patch and push, and to Alastair Rankine for filing the original
\r
6294 feature request.</para>
\r
6295 <para role="commit-changes">Modified: manpages/lists.xsl,1.23;
\r
6296 manpages/utility.xsl,1.10 - Michael(tm) Smith</para>
\r
6298 <listitem role="commit-message">
\r
6299 <para>Improved handling or
\r
6300 Author/Editor/Othercredit.</para>
\r
6301 <para>Reworked content of
\r
6302 (non-visible) comment added at top of each page (metadata
\r
6304 <para>Added support for generating a
\r
6305 <parameter>manifest</parameter> file (useful for cleaning up
\r
6306 after builds, etc.)</para>
\r
6307 <para role="commit-changes">Modified: manpages/docbook.xsl,1.46;
\r
6308 manpages/info.xsl,1.9; manpages/other.xsl,1.12;
\r
6309 manpages/utility.xsl,1.6 - Michael(tm) Smith</para>
\r
6311 <listitem role="commit-message">
\r
6312 <para>Added two new parameters for
\r
6313 handling of multi-term
\r
6314 <tag>varlistentry</tag> elements:</para>
\r
6315 <para><parameter>variablelist.term.break.after</parameter>:
\r
6316 When the <parameter>variablelist.term.break.after</parameter> is
\r
6317 non-zero, it will generate a line break after each
\r
6318 <tag>term</tag> multi-term
\r
6319 <tag>varlistentry</tag>.</para>
\r
6320 <para><parameter>variablelist.term.separator</parameter>:
\r
6321 When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
\r
6322 elements, the string specified in the value of the
\r
6323 <parameter>variablelist.term.separator</parameter> parameter is
\r
6324 placed after each <tag>term</tag> except the last. The default
\r
6325 is ", " (a comma followed by a space). To suppress rendering of
\r
6326 the separator, set the value of
\r
6327 <parameter>variablelist.term.separator</parameter> to the empty
\r
6328 string ("").</para>
\r
6329 <para>These parameters are primarily intended to be
\r
6330 useful if you have multi-term varlistentries that have long
\r
6332 <para>Closes #1306676. Thanks to Sam Steingold for
\r
6333 providing an example "lots of long terms" doc that demonstrated
\r
6334 the value of having these options.</para>
\r
6336 normalize-space() call to processing of each
\r
6337 <tag>term</tag>.</para>
\r
6338 <para>This change affects all output formats
\r
6339 (HTML, PDF, manpages). The default behavior should pretty much
\r
6340 remain the same as before, but it is possible (as always) that
\r
6341 the change may introduce some
\r
6342 new bugginess.</para>
\r
6343 <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
\r
6344 fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
\r
6345 html/param.xweb,1.93; manpages/lists.xsl,1.22;
\r
6346 manpages/param.ent,1.14; manpages/param.xweb,1.16;
\r
6347 params/variablelist.term.break.after.xml,1.1;
\r
6348 params/variablelist.term.separator.xml,1.1 - Michael(tm)
\r
6352 </sect2><!--end of Manpages changes for snapshot_2006-05-15_0803-->
\r
6354 <sect2 xml:id="V1700_Params">
\r
6355 <title>Params</title>
\r
6356 <para>The following changes have been made to the
\r
6357 <filename>params</filename> code
\r
6358 since the 1.69.1 release.</para>
\r
6360 <listitem role="commit-message">
\r
6361 <para>New parameters to set
\r
6362 header/footer <tag>table</tag> minimum
\r
6364 <para role="commit-changes">Modified: params/footer.table.height.xml,1.1;
\r
6365 params/header.table.height.xml,1.1 - Robert
\r
6368 <listitem role="commit-message">
\r
6369 <para>Support multiple indexing methods
\r
6370 for different languages.</para>
\r
6371 <para role="commit-changes">Modified: params/index.method.xml,1.1 - Robert
\r
6374 <listitem role="commit-message">
\r
6375 <para>Remove <tag>qandaset</tag> and
\r
6376 <tag>qandadiv</tag> from <parameter>generate.toc</parameter> for fo
\r
6377 output because formerly it wasn't working, but now it is and
\r
6378 the default behavior should stay the
\r
6380 <para role="commit-changes">Modified: params/generate.toc.xml,1.8 - Robert
\r
6383 <listitem role="commit-message">
\r
6384 <para>add support for page number
\r
6385 references to <tag>link</tag> element
\r
6387 <para role="commit-changes">Modified: params/insert.link.page.number.xml,1.1 - Robert
\r
6390 <listitem role="commit-message">
\r
6391 <para>Add support for more characters to
\r
6392 hyphen on when <parameter>ulink.hyphenate</parameter> is turned
\r
6394 <para role="commit-changes">Modified: params/ulink.hyphenate.chars.xml,1.1;
\r
6395 params/ulink.hyphenate.xml,1.3 - Robert Stayton</para>
\r
6397 <listitem role="commit-message">
\r
6398 <para>New attribute-set to format
\r
6399 <tag>biblioentry</tag> and
\r
6400 <tag>bibliomixed</tag>.</para>
\r
6401 <para role="commit-changes">Modified: params/biblioentry.properties.xml,1.1 -
\r
6402 Robert Stayton</para>
\r
6404 <listitem role="commit-message">
\r
6405 <para>Added new parameter
\r
6406 <parameter>chunk.tocs.and.lots</parameter>.has.<tag>title</tag> which
\r
6407 controls presence of <tag>title</tag> in a separate chunk with
\r
6408 ToC/LoT. Disabling <tag>title</tag> can be very useful if you are
\r
6409 generating frameset output (well, yes those frames, but some customers
\r
6410 really want them ;-).</para>
\r
6411 <para role="commit-changes">Modified: html/chunk-code.xsl,1.15;
\r
6412 html/param.ent,1.93; html/param.xweb,1.102;
\r
6413 params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
\r
6416 <listitem role="commit-message">
\r
6417 <para>Added new attribute set
\r
6418 <tag>toc</tag>.line.properties for controlling appearance of lines in
\r
6420 <para role="commit-changes">Modified: params/toc.line.properties.xml,1.1 - Jirka
\r
6423 <listitem role="commit-message">
\r
6424 <para>Allow <tag>table</tag> footnotes
\r
6425 to have different properties from regular
\r
6427 <para role="commit-changes">Modified: params/table.footnote.properties.xml,1.1 - Robert
\r
6430 <listitem role="commit-message">
\r
6431 <para>Set properties for pgwide="1"
\r
6433 <para role="commit-changes">Modified: params/pgwide.properties.xml,1.1 - Robert
\r
6436 <listitem role="commit-message">
\r
6438 autotoc.<tag>label</tag>.in.hyperlink param.</para>
\r
6439 <para>If the value
\r
6440 of autotoc.<tag>label</tag>.in.hyperlink is non-zero, labels
\r
6441 are included in hyperlinked titles in the <tag>TOC</tag>. If it
\r
6442 is instead zero, labels are still displayed prior to the
\r
6443 hyperlinked titles, but are not hyperlinked along with the
\r
6445 <para>Closes patch #1065868. Thanks to anatoly techtonik
\r
6446 for the patch.</para>
\r
6447 <para role="commit-changes">Modified: html/autotoc.xsl,1.36; html/param.ent,1.92;
\r
6448 html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 -
\r
6449 Michael(tm) Smith</para>
\r
6451 <listitem role="commit-message">
\r
6452 <para>Added two new params:
\r
6453 html.head.<tag>legalnotice</tag>.<tag>link</tag>.types
\r
6454 and html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple.</para>
\r
6456 the value of the <parameter>generate.legalnotice.link</parameter> is
\r
6457 non-zero, then the stylesheet generates (in the head
\r
6458 <tag>section</tag> of the HTML source) either a single HTML
\r
6459 <tag>link</tag> element or, if the value of
\r
6460 the html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple is
\r
6461 non-zero, one <tag>link</tag> element for each <tag>link</tag>
\r
6462 type specified. Each <tag>link</tag> has the
\r
6463 following attributes:</para>
\r
6464 <para> - a rel attribute whose value
\r
6465 is derived from the value of
\r
6466 html.head.<tag>legalnotice</tag>.<tag>link</tag>.types</para>
\r
6468 an href attribute whose value is set to the URL of the file
\r
6469 containing the <tag>legalnotice</tag></para>
\r
6470 <para> - a <tag>title</tag>
\r
6471 attribute whose value is set to the <tag>title</tag> of the
\r
6472 corresponding <tag>legalnotice</tag> (or a <tag>title</tag>
\r
6473 programatically determined by the stylesheet)</para>
\r
6476 <para> <<tag>link</tag> rel="<tag>copyright</tag>"
\r
6477 href="ln-id2524073.html" title="Legal Notice"></para>
\r
6479 #1476450. Thanks to Sam Steingold.</para>
\r
6480 <para role="commit-changes">Modified: html/chunk-common.xsl,1.45;
\r
6481 html/param.ent,1.91; html/param.xweb,1.100;
\r
6482 params/generate.legalnotice.link.xml,1.4;
\r
6483 params/html.head.legalnotice.link.multiple.xml,1.1;
\r
6484 params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm)
\r
6487 <listitem role="commit-message">
\r
6488 <para>Added the following
\r
6490 <para> - man.indent.width (string-valued) -
\r
6491 man.indent.refsect (boolean) - man.indent.blurbs (boolean)
\r
6492 - man.indent.lists (boolean) - man.indent.verbatims
\r
6494 <para>Note that in earlier snapshots, man.indent.width
\r
6495 was named man.indentation.default.value and the boolean params
\r
6496 had names like man.indentation.*.adjust. Also the
\r
6497 man.indent.blurbs param was called man.indentation.authors.adjust
\r
6498 (or something).</para>
\r
6499 <para>The behavior now is: If the value of a
\r
6500 particular man.indent.* boolean param is non-zero, the
\r
6501 corresponding contents (refsect*, list items,
\r
6502 authorblurb/personblurb, vervatims) are displayed with a left
\r
6503 margin indented by a width equal to the value
\r
6504 of man.indent.width.</para>
\r
6505 <para role="commit-changes">Modified: params/man.indent.blurbs.xml,1.1;
\r
6506 manpages/docbook.xsl,1.74; manpages/info.xsl,1.20;
\r
6507 manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
\r
6508 manpages/param.ent,1.22; manpages/param.xweb,1.24;
\r
6509 manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1;
\r
6510 params/man.indent.refsect.xml,1.1;
\r
6511 params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 -
\r
6512 Michael(tm) Smith</para>
\r
6514 <listitem role="commit-message">
\r
6516 man.<tag>table</tag>.footnotes.divider param.</para>
\r
6518 <tag>table</tag> that contains footenotes, the string specified
\r
6519 by the man.<tag>table</tag>.footnotes.divider parameter is output
\r
6520 before the list of footnotes for the
\r
6521 <tag>table</tag>.</para>
\r
6522 <para role="commit-changes">Modified: manpages/docbook.xsl,1.73;
\r
6523 manpages/links.xsl,1.6; manpages/param.ent,1.21;
\r
6524 manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 -
\r
6525 Michael(tm) Smith</para>
\r
6527 <listitem role="commit-message">
\r
6529 man.output.in.separate.dir,
\r
6530 man.output.<parameter>base.dir</parameter>,
\r
6531 and man.output.subdirs.enabled parameters.</para>
\r
6533 man.output.<parameter>base.dir</parameter> parameter specifies the
\r
6534 base directory into which man-page files are
\r
6535 output. The man.output.subdirs.enabled parameter controls whether
\r
6536 the files are output in subdirectories within the base
\r
6538 <para>The values of the
\r
6539 man.output.<parameter>base.dir</parameter>
\r
6540 and man.output.subdirs.enabled parameters are used only if the
\r
6541 value of man.output.in.separate.dir parameter is non-zero. If the
\r
6542 value of man.output.in.separate.dir is zero, man-page files are
\r
6543 not output in a separate
\r
6545 <para role="commit-changes">Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20;
\r
6546 manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1;
\r
6547 params/man.output.in.separate.dir.xml,1.1;
\r
6548 params/man.output.subdirs.enabled.xml,1.1 - Michael(tm)
\r
6551 <listitem role="commit-message">
\r
6553 man.font.<tag>table</tag>.headings and
\r
6554 man.font.<tag>table</tag>.<tag>title</tag> params, for
\r
6555 controlling font in <tag>table</tag> headings and
\r
6557 <para role="commit-changes">Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19;
\r
6558 manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1;
\r
6559 params/man.font.table.title.xml,1.1 - Michael(tm)
\r
6562 <listitem role="commit-message">
\r
6564 man.font.<tag>funcsynopsisinfo</tag> and
\r
6565 man.font.<tag>funcprototype</tag> params, for specifying the roff
\r
6566 font (for example, BI, B, I) for <tag>funcsynopsisinfo</tag> and
\r
6567 <tag>funcprototype</tag> output.</para>
\r
6568 <para role="commit-changes">Modified: manpages/block.xsl,1.19;
\r
6569 manpages/docbook.xsl,1.69; manpages/param.ent,1.18;
\r
6570 manpages/param.xweb,1.20; manpages/synop.xsl,1.29;
\r
6571 manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1;
\r
6572 params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm)
\r
6575 <listitem role="commit-message">
\r
6576 <para>Changed to select="0" in
\r
6577 <tag>refclass</tag>.suppress (instead of
\r
6578 ..>0</..)</para>
\r
6579 <para role="commit-changes">Modified: params/refclass.suppress.xml,1.3 - Michael(tm)
\r
6582 <listitem role="commit-message">
\r
6584 man.<tag>segtitle</tag>.suppress param.</para>
\r
6585 <para>If the value of
\r
6586 man.<tag>segtitle</tag>.suppress is non-zero, then display
\r
6587 of <tag>segtitle</tag> contents is suppressed in
\r
6589 <para role="commit-changes">Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17;
\r
6590 manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 -
\r
6591 Michael(tm) Smith</para>
\r
6593 <listitem role="commit-message">
\r
6595 man.output.<parameter>manifest</parameter>.enabled and
\r
6596 man.output.manifest.<tag>filename</tag> params.</para>
\r
6598 man.output.<parameter>manifest</parameter>.enabled is non-zero, a list
\r
6599 of filenames for man pages generated by the stylesheet
\r
6600 transformation is written to the file named by
\r
6601 man.output.<parameter>manifest</parameter>.<tag>filename</tag></para>
\r
6602 <para role="commit-changes">Modified: manpages/docbook.xsl,1.67;
\r
6603 manpages/other.xsl,1.19; manpages/param.ent,1.16;
\r
6604 manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1;
\r
6605 params/man.output.manifest.filename.xml,1.1;
\r
6606 tools/make/Makefile.DocBook,1.4 - Michael(tm)
\r
6609 <listitem role="commit-message">
\r
6610 <para>Added <tag>refclass</tag>.suppress
\r
6612 <para>If the value of <tag>refclass</tag>.suppress is
\r
6613 non-zero, then display <tag>refclass</tag> contents is suppressed
\r
6614 in output. Affects HTML and FO output
\r
6616 <para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
\r
6617 html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
\r
6620 <listitem role="commit-message">
\r
6622 <tag>refentry</tag>.meta.get.quietly param.</para>
\r
6623 <para>If zero (the
\r
6624 default), notes and warnings about "missing" markup are generated
\r
6625 during gathering of <tag>refentry</tag> metadata. If
\r
6626 non-zero, the metadata is gathered "quietly" -- that is, the
\r
6627 notes and warnings are suppressed.</para>
\r
6628 <para>NOTE: If you are
\r
6629 processing a large amount of <tag>refentry</tag> content, you
\r
6630 may be able to speed up processing significantly by setting a
\r
6631 non-zero value for
\r
6632 <tag>refentry</tag>.meta.get.quietly.</para>
\r
6633 <para role="commit-changes">Modified: common/refentry.xsl,1.17;
\r
6634 manpages/param.ent,1.15; manpages/param.xweb,1.17;
\r
6635 params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
\r
6638 <listitem role="commit-message">
\r
6639 <para>Added support for "software" and
\r
6640 "sectdesc" class values on <tag>refmiscinfo</tag>; "software" is
\r
6641 treated identically to "source", and "setdesc" is treated
\r
6642 identically to "manual".</para>
\r
6643 <para role="commit-changes">Modified: common/refentry.xsl,1.10;
\r
6644 params/man.th.extra2.max.length.xml,1.3;
\r
6645 params/refentry.source.name.profile.xml,1.4 - Michael(tm)
\r
6648 <listitem role="commit-message">
\r
6649 <para>Drastically reworked all of the
\r
6650 XPath expressions used in <tag>refentry</tag> metadata gathering
\r
6651 -- completely removed $parentinfo and turned $info into a set of
\r
6652 nodes that includes the *info contents of the <tag>Refentry</tag>
\r
6653 plus the *info contents all all of its ancestor elements. The
\r
6654 basic XPath expression now used throughout is (using the example
\r
6655 of checking for a <tag>date</tag>):</para>
\r
6657 (($info[//date])[last()]/date)[1].</para>
\r
6658 <para>That selects the "last"
\r
6659 *info/date <tag>date</tag> in document order -- that is, the one
\r
6660 eitther on the <tag>Refentry</tag> itself or on the
\r
6661 closest ancestor to the <tag>Refentry</tag>.</para>
\r
6663 likely this change may break some things; may need to pick up
\r
6664 some pieces later.</para>
\r
6665 <para>Also, changed the default value for the
\r
6666 <parameter>man.th.extra2.max.length</parameter> from 40 to
\r
6668 <para role="commit-changes">Modified: common/common.xsl,1.58; common/refentry.xsl,1.7;
\r
6669 params/man.th.extra2.max.length.xml,1.2;
\r
6670 params/refentry.date.profile.xml,1.2;
\r
6671 params/refentry.manual.profile.xml,1.2;
\r
6672 params/refentry.source.name.profile.xml,1.2;
\r
6673 params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58;
\r
6674 manpages/other.xsl,1.15 - Michael(tm) Smith</para>
\r
6676 <listitem role="commit-message">
\r
6677 <para>Added option for turning off bold
\r
6678 formatting in <tag>Funcsynopsis</tag>. Boldface formatting in
\r
6679 <tag>function</tag> <tag>synopsis</tag> is mandated in the
\r
6680 man(7) man page and is used almost universally in existing man
\r
6681 pages. Despite that, it really does look like crap to have an
\r
6682 entire <tag>Funcsynopsis</tag> output in bold, so I added params
\r
6683 for turning off the bold formatting and/or replacing it with a
\r
6684 different roff special font (e.g., "RI" for alternating
\r
6685 roman/italic instead of the default "BI" for alternating
\r
6686 bold/italic). The new params
\r
6687 are "man.<tag>funcprototype</tag>.font" and
\r
6688 "man.<tag>funcsynopsisinfo</tag>.font". To be documented
\r
6690 <para>Closes #1452247. Thanks to Joe Orton for the feature
\r
6692 <para role="commit-changes">Modified: params/man.string.subst.map.xml,1.16;
\r
6693 manpages/block.xsl,1.10; manpages/docbook.xsl,1.51;
\r
6694 manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm)
\r
6697 <listitem role="commit-message">
\r
6698 <para><parameter>fop.extensions</parameter> now only
\r
6699 for FOP version 0.20.5 and earlier.</para>
\r
6700 <para role="commit-changes">Modified: params/fop.extensions.xml,1.4
\r
6701 - Robert Stayton</para>
\r
6703 <listitem role="commit-message">
\r
6704 <para>Support for fop1 different from
\r
6705 fop 0.20.5 and earlier.</para>
\r
6706 <para role="commit-changes">Modified: params/fop1.extensions.xml,1.1 - Robert
\r
6709 <listitem role="commit-message">
\r
6710 <para>Reset default value to empty
\r
6711 string so template uses gentext first, then the parameter value
\r
6712 if not empty.</para>
\r
6713 <para role="commit-changes">Modified: params/index.number.separator.xml,1.2;
\r
6714 params/index.range.separator.xml,1.2;
\r
6715 params/index.term.separator.xml,1.2 - Robert
\r
6718 <listitem role="commit-message">
\r
6719 <para>New parameter:
\r
6720 <parameter>id.warnings</parameter>. If non-zero, warnings are
\r
6721 generated for titled objects that don't have titles. True by default;
\r
6722 I wonder if this will be too aggressive?</para>
\r
6723 <para role="commit-changes">Modified: html/biblio.xsl,1.25;
\r
6724 html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19;
\r
6725 html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16;
\r
6726 html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22;
\r
6727 html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman
\r
6730 <listitem role="commit-message">
\r
6731 <para>Added new parameter
\r
6732 <parameter>keep.relative.image.uris</parameter></para>
\r
6733 <para role="commit-changes">Modified: fo/param.ent,1.91;
\r
6734 fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
\r
6735 params/keep.relative.image.uris.xml,1.1 - Norman
\r
6738 <listitem role="commit-message">
\r
6739 <para>Support default <tag>label</tag>
\r
6740 width parameters for itemized and ordered lists</para>
\r
6741 <para role="commit-changes">Modified: fo/lists.xsl,1.64;
\r
6742 fo/param.ent,1.90; fo/param.xweb,1.103;
\r
6743 params/itemizedlist.label.width.xml,1.1;
\r
6744 params/orderedlist.label.width.xml,1.1 - Norman
\r
6747 <listitem role="commit-message">
\r
6748 <para>Added parameters to localize
\r
6749 punctuation in indexes.</para>
\r
6750 <para role="commit-changes">Modified: params/index.number.separator.xml,1.1;
\r
6751 params/index.range.separator.xml,1.1;
\r
6752 params/index.term.separator.xml,1.1 - Robert
\r
6755 <listitem role="commit-message">
\r
6756 <para>Added two new parameters for
\r
6757 handling of multi-term
\r
6758 <tag>varlistentry</tag> elements:</para>
\r
6759 <para><parameter>variablelist.term.break.after</parameter>:
\r
6760 When the <parameter>variablelist.term.break.after</parameter> is
\r
6761 non-zero, it will generate a line break after each
\r
6762 <tag>term</tag> multi-term
\r
6763 <tag>varlistentry</tag>.</para>
\r
6764 <para><parameter>variablelist.term.separator</parameter>:
\r
6765 When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
\r
6766 elements, the string specified in the value of the
\r
6767 <parameter>variablelist.term.separator</parameter> parameter is
\r
6768 placed after each <tag>term</tag> except the last. The default
\r
6769 is ", " (a comma followed by a space). To suppress rendering of
\r
6770 the separator, set the value of
\r
6771 <parameter>variablelist.term.separator</parameter> to the empty
\r
6772 string ("").</para>
\r
6773 <para>These parameters are primarily intended to be
\r
6774 useful if you have multi-term varlistentries that have long
\r
6776 <para>Closes #1306676. Thanks to Sam Steingold for
\r
6777 providing an example "lots of long terms" doc that demonstrated
\r
6778 the value of having these options.</para>
\r
6780 normalize-space() call to processing of each
\r
6781 <tag>term</tag>.</para>
\r
6782 <para>This change affects all output formats
\r
6783 (HTML, PDF, manpages). The default behavior should pretty much
\r
6784 remain the same as before, but it is possible (as always) that
\r
6785 the change may introduce some
\r
6786 new bugginess.</para>
\r
6787 <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
\r
6788 fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
\r
6789 html/param.xweb,1.93; manpages/lists.xsl,1.22;
\r
6790 manpages/param.ent,1.14; manpages/param.xweb,1.16;
\r
6791 params/variablelist.term.break.after.xml,1.1;
\r
6792 params/variablelist.term.separator.xml,1.1 - Michael(tm)
\r
6795 <listitem role="commit-message">
\r
6796 <para>Convert 'no' to string in default
\r
6798 <para role="commit-changes">Modified: params/olink.doctitle.xml,1.4 - Robert
\r
6801 <listitem role="commit-message">
\r
6802 <para>Implemented RFE
\r
6804 <para>Added bunch of new parameters (attribute sets)
\r
6805 that affect list presentation: list.block.properties,
\r
6806 <tag>itemizedlist</tag>.properties, <tag>orderedlist</tag>.properties,
\r
6807 <tag>itemizedlist</tag>.<tag>label</tag>.properties and
\r
6808 <tag>orderedlist</tag>.<tag>label</tag>.properties. Default behaviour
\r
6809 of stylesheets has not been changed but further customizations will be
\r
6810 much more easier.</para>
\r
6811 <para role="commit-changes">Modified: fo/lists.xsl,1.61; fo/param.ent,1.87;
\r
6812 fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1;
\r
6813 params/itemizedlist.properties.xml,1.1;
\r
6814 params/list.block.properties.xml,1.1;
\r
6815 params/orderedlist.label.properties.xml,1.1;
\r
6816 params/orderedlist.properties.xml,1.1 - Jirka
\r
6819 <listitem role="commit-message">
\r
6820 <para>Implemented RFE
\r
6822 <para>You can enable crop marks in your document by
\r
6823 setting crop.marks=1 and xep.extensions=1. Appearance of crop
\r
6824 marks can be controlled by parameters
\r
6825 <parameter>crop.mark.bleed</parameter> (6pt),
\r
6826 <parameter>crop.mark.offset</parameter> (24pt) and
\r
6827 <parameter>crop.mark.width</parameter> (0.5pt).</para>
\r
6829 is new named template called user-xep-pis. You can overwrite it in
\r
6830 order to produce some PIs that can control XEP as described in
\r
6831 http://www.renderx.com/reference.html#Output_Formats</para>
\r
6832 <para role="commit-changes">Modified: fo/docbook.xsl,1.36;
\r
6833 fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23;
\r
6834 params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1;
\r
6835 params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka
\r
6838 <listitem role="commit-message">
\r
6839 <para>Changed short descriptions in doc
\r
6840 for *autolabel* params to match new autolabel
\r
6842 <para role="commit-changes">Modified: params/appendix.autolabel.xml,1.5;
\r
6843 params/chapter.autolabel.xml,1.4; params/part.autolabel.xml,1.5;
\r
6844 params/preface.autolabel.xml,1.4 - Michael(tm)
\r
6848 </sect2><!--end of Params changes for snapshot_2006-05-15_0803-->
\r
6850 <sect2 xml:id="V1700_Profiling">
\r
6851 <title>Profiling</title>
\r
6852 <para>The following changes have been made to the
\r
6853 <filename>profiling</filename> code
\r
6854 since the 1.69.1 release.</para>
\r
6856 <listitem role="commit-message">
\r
6857 <para>Profiling now works together with
\r
6858 namespace stripping (V5 documents). Namespace striping should work
\r
6859 with all stylesheets named profile-, even if they are not supporting
\r
6860 namespace stripping in a non-profiling
\r
6862 <para role="commit-changes">Modified: profiling/profile-mode.xsl,1.4;
\r
6863 profiling/xsl2profile.xsl,1.7 - Jirka Kosek</para>
\r
6865 <listitem role="commit-message">
\r
6866 <para>Moved profiling stage out of
\r
6867 templates. This make possible to reuse profiled content by several
\r
6868 templates and still maintaing node indentity (needed for example for
\r
6869 HTML Help where content is processed multiple times).</para>
\r
6871 don't know why this was not on the top level before. Maybe some XSLT
\r
6872 processors choked on it. I hope this will be OK
\r
6874 <para role="commit-changes">Modified: profiling/xsl2profile.xsl,1.5 - Jirka
\r
6878 </sect2><!--end of Profiling changes for snapshot_2006-05-15_0803-->
\r
6880 <sect2 xml:id="V1700_Tools">
\r
6881 <title>Tools</title>
\r
6882 <para>The following changes have been made to the
\r
6883 <filename>tools</filename> code
\r
6884 since the 1.69.1 release.</para>
\r
6886 <listitem role="commit-message">
\r
6887 <para>Moved Makefile.DocBook from
\r
6888 <tag>contrib</tag> module to xsl
\r
6890 <para role="commit-changes">Modified: tools/make/Makefile.DocBook,1.1 - Michael(tm)
\r
6894 </sect2><!--end of Tools changes for snapshot_2006-05-15_0803-->
\r
6896 <sect2 xml:id="V1700_WordML">
\r
6897 <title>WordML</title>
\r
6898 <para>The following changes have been made to the
\r
6899 <filename>wordml</filename> code
\r
6900 since the 1.69.1 release.</para>
\r
6902 <listitem role="commit-message">
\r
6903 <para>added <tag>contrib</tag> element,
\r
6904 better handling of default paragraph
\r
6906 <para role="commit-changes">Modified: wordml/pages-normalise.xsl,1.6; wordml/supported.xml,1.2;
\r
6907 wordml/wordml-final.xsl,1.14 - Steve Ball</para>
\r
6909 <listitem role="commit-message">
\r
6911 <tag>bridgehead</tag></para>
\r
6912 <para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.6;
\r
6913 wordml/docbook.xsl,1.17; wordml/pages-normalise.xsl,1.5;
\r
6914 wordml/template-pages.xml,1.7; wordml/template.dot,1.4;
\r
6915 wordml/template.xml,1.14; wordml/wordml-final.xsl,1.13 - Steve
\r
6918 <listitem role="commit-message">
\r
6919 <para>added blocks stylesheet to support
\r
6920 bibliographies, glossaries and qandasets</para>
\r
6921 <para role="commit-changes">Modified: wordml/Makefile,1.4;
\r
6922 wordml/README,1.3; wordml/blocks-spec.xml,1.1;
\r
6923 wordml/docbook-pages.xsl,1.5; wordml/docbook.xsl,1.16;
\r
6924 wordml/pages-normalise.xsl,1.4; wordml/sections-spec.xml,1.3;
\r
6925 wordml/specifications.xml,1.13; wordml/template-pages.xml,1.6;
\r
6926 wordml/template.dot,1.3; wordml/template.xml,1.13;
\r
6927 wordml/wordml-blocks.xsl,1.1; wordml/wordml-final.xsl,1.12;
\r
6928 wordml/wordml-sections.xsl,1.3 - Steve Ball</para>
\r
6930 <listitem role="commit-message">
\r
6931 <para>added <tag>mediaobject</tag>
\r
6932 <tag>caption</tag></para>
\r
6933 <para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.4;
\r
6934 wordml/docbook.xsl,1.15; wordml/specifications.xml,1.12;
\r
6935 wordml/template-pages.xml,1.5; wordml/template.dot,1.2;
\r
6936 wordml/template.xml,1.12; wordml/wordml-final.xsl,1.11 - Steve
\r
6939 <listitem role="commit-message">
\r
6942 <para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.3; wordml/docbook.xsl,1.14;
\r
6943 wordml/pages-normalise.xsl,1.3; wordml/specifications.xml,1.11;
\r
6944 wordml/template-pages.xml,1.4; wordml/wordml-final.xsl,1.10 - Steve
\r
6947 <listitem role="commit-message">
\r
6948 <para>added Word template
\r
6950 <para role="commit-changes">Modified: wordml/template.dot,1.1 - Steve Ball</para>
\r
6952 <listitem role="commit-message">
\r
6953 <para>added <tag>abstract</tag>, fixed
\r
6954 <tag>itemizedlist</tag>, ulink</para>
\r
6955 <para role="commit-changes">Modified: wordml/specifications.xml,1.10;
\r
6956 wordml/wordml-final.xsl,1.9 - Steve Ball</para>
\r
6958 <listitem role="commit-message">
\r
6959 <para>fixed Makefile added many
\r
6960 features to Pages support added <tag>revhistory</tag>, inlines,
\r
6961 highlights, <tag>abstract</tag></para>
\r
6962 <para role="commit-changes">Modified: wordml/Makefile,1.2;
\r
6963 wordml/docbook-pages.xsl,1.2; wordml/pages-normalise.xsl,1.2;
\r
6964 wordml/sections-spec.xml,1.2; wordml/specifications.xml,1.9;
\r
6965 wordml/template-pages.xml,1.3; wordml/template.xml,1.11;
\r
6966 wordml/wordml-final.xsl,1.8; wordml/wordml-sections.xsl,1.2 - Steve
\r
6969 <listitem role="commit-message">
\r
6970 <para>fixed handling linebreaks when
\r
6971 generating WordML added Apple Pages
\r
6973 <para role="commit-changes">Modified: wordml/docbook.xsl,1.13; wordml/template-pages.xml,1.2 -
\r
6977 </sect2><!--end of WordML changes for snapshot_2006-05-15_0803-->
\r
6980 <sect1 xml:id="V1691">
\r
6981 <title>Release 1.69.1</title>
\r
6982 <para>This release is a minor bug-fix update to the 1.69.0
\r
6983 release. Along with bug fixes, it includes one
\r
6984 configuration-parameter change: The default value of the
\r
6985 <parameter>annotation.support</parameter> parameter is now
\r
6986 <literal>0</literal> (off). The reason for that change is that
\r
6987 there have been reports that <tag>annotation</tag> handling is
\r
6988 causing a significant performance degradation in processing of
\r
6989 large documents with <command>xsltproc</command>.</para>
\r
6991 <!-- end of notes for 1.69.1 release -->
\r
6993 <sect1 xml:id="V1690">
\r
6994 <title>Release 1.69.0</title>
\r
6995 <para>The release includes major feature changes,
\r
6996 particularly in the <link linkend="V1690_MAN">manpages
\r
6997 stylesheets</link>, as well as a large number of bug fixes.</para>
\r
6999 <para>As with all DocBook Project <quote>dot zero</quote> releases, this is an
\r
7000 <link linkend="dot0">experimental release </link>.</para>
\r
7002 <sect2 xml:id="V1690_COMMON">
\r
7003 <title>Common</title>
\r
7006 <para>This release adds localizations for the following
\r
7008 <simplelist type="inline">
\r
7009 <?dbchoice choice="and"?>
\r
7010 <member>Albanian</member>
\r
7011 <member>Amharic</member>
\r
7012 <member>Azerbaijani</member>
\r
7013 <member>Hindi</member>
\r
7014 <member>Irish (Gaelic)</member>
\r
7015 <member>Gujarati</member>
\r
7016 <member>Kannada</member>
\r
7017 <member>Mongolian</member>
\r
7018 <member>Oriya</member>
\r
7019 <member>Punjabi</member>
\r
7020 <member>Tagalog</member>
\r
7021 <member>Tamil</member>
\r
7022 <member>Welsh</member>
\r
7023 </simplelist>.</para>
\r
7026 <para>Added support for specifying number format for auto
\r
7027 labels for <tag>chapter</tag>, <tag>appendix</tag>,
\r
7028 <tag>part</tag>, and <tag>preface</tag>. Contolled with the
\r
7029 <parameter>appendix.autolabel</parameter>,
\r
7030 <parameter>chapter.autolabel</parameter>,
\r
7031 <parameter>part.autolabel</parameter>, and
\r
7032 <parameter>preface.autolabel</parameter> parameters.</para>
\r
7035 <para>Added basic support for <tag>biblioref</tag> cross
\r
7036 referencing.</para>
\r
7039 <para>Added support for <tag class="attribute">align</tag>
\r
7040 on <tag>caption</tag> in <tag>mediaobject</tag>.</para>
\r
7043 <para>Added support for processing documents that use the
\r
7044 DocBook V5 namespace.</para>
\r
7047 <para>Added support for <tag>termdef</tag> and
\r
7048 <tag>mathphrase</tag>.</para>
\r
7051 <para>EXPERIMENTAL: Incorporated the Slides and Website
\r
7052 stylesheets into the DocBook XSL stylesheets package. So,
\r
7053 for example, Website documents can now be processed using
\r
7054 the following URI for the driver Website
\r
7055 <filename>tabular.xsl</filename> file: <literallayout class="monospaced"><uri>http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl</uri></literallayout></para>
\r
7058 <para>A <tag>procedure</tag> without a <tag>title</tag> is
\r
7059 now treated as an <quote>informal</quote> procedure (meaning
\r
7060 that it is not added to any generated <quote>list of
\r
7061 procedures</quote> and has no affect on numbering of
\r
7062 generated labels for other procedures).</para>
\r
7065 <para><tag>docname</tag> is no longer added to
\r
7066 <tag>olink</tag> when pointing to a root element.</para>
\r
7068 <!-- ======================================================= -->
\r
7070 <para>Added support for generation of choice separator in
\r
7071 inline simplelist. This enables auto-generation of an
\r
7072 appropriate localized <quote>choice separator</quote> (for
\r
7073 example, <quote>and</quote> or <quote>or</quote>) before the
\r
7074 final item in an inline <tag>simplelist</tag>.</para>
\r
7075 <para>To indicate that you want a choice separator
\r
7076 generated for a particular list, you need to put a processing
\r
7077 instruction (PI) of the form
\r
7078 <tag class="xmlpi">dbchoice choice="foo"</tag> as a
\r
7079 child of the list. For example:
\r
7080 <literallayout class="monospaced"> <para>Choose from
\r
7081 ONE and ONLY ONE of the following:
\r
7082 <simplelist type="inline">
\r
7083 <?dbchoice choice="or" ?>
\r
7084 <member>A</member>
\r
7085 <member>B</member>
\r
7086 <member>C</member>.</simplelist></para></literallayout>
\r
7088 Output (for English):
\r
7090 <para>Choose from ONE and only ONE of the
\r
7091 following choices: A, B, or C.</para>
\r
7093 As a temporary workaround for the fact that most of the
\r
7094 DocBook non-English locale files don't have a localization for
\r
7095 the word <quote>or</quote>, you can put in a literal string to
\r
7096 be used; example for French: <tag class="pi">dbchoice choice="ou"</tag>. That is, use
\r
7097 <quote>ou</quote> instead of <quote>or</quote>.</para>
\r
7101 <sect2 xml:id="V1690_FO">
\r
7105 <para> Added <literal>content-type</literal> property to
\r
7106 <literal>external-graphic</literal> element, based on
\r
7107 <tag>imagedata</tag> <tag class="attribute">format</tag>
\r
7111 <para>Added support for generating
\r
7112 <literal><rx:meta-field creator="$VERSION"/></literal>
\r
7113 field for XEP output. This makes the DocBook XSL
\r
7114 stylesheet version information available through the
\r
7115 <guimenu>Document Properties</guimenu> menu in Acrobat
\r
7116 Reader and other PDF viewers.</para>
\r
7119 <para>Trademark symbol handling made consistent with
\r
7120 handling of same in HTML stylesheets. Prior to this change,
\r
7121 if you processed a document that contained no value for the
\r
7122 <tag class="attribute">class</tag> attribute on the
\r
7123 <tag>trademark</tag> element, the HTML stylesheets would
\r
7124 default to rendering a superscript <literal>TM
\r
7125 </literal>symbol after the <tag>trademark</tag> contents,
\r
7126 but the FO stylesheets would render nothing.</para>
\r
7129 <para>Added support for generating XEP bookmarks for
\r
7130 <tag>refentry</tag>.</para>
\r
7133 <para>Added support for HTML markup <tag>table</tag> <tag class="attribute">border</tag> attribute, applied to each
\r
7134 table cell.</para>
\r
7137 <para>The <function>table.width</function> template can now
\r
7138 sum column specs if none use <literal>%</literal> or
\r
7139 <literal>*</literal>.</para>
\r
7142 <para>Added <literal>fox:destination</literal> extension
\r
7143 inside <literal>fox:outline</literal> to support linking to
\r
7144 internal destinations.</para>
\r
7147 <para>Added support for customizing
\r
7148 <literal>abstract</literal> with property sets. Controlled
\r
7149 with the <parameter>abstract.properties</parameter> and
\r
7150 <parameter>abstract.title.properties</parameter>
\r
7151 parameters.</para>
\r
7154 <para>Add <tag>footnote</tag>s in <tag>table</tag> title to
\r
7155 table footnote set, and add support for table footnotes to
\r
7156 HTML table markup.</para>
\r
7159 <para>Added support for <tag>title</tag> in
\r
7160 <tag>glosslist</tag>.</para>
\r
7163 <para>Added support for <tag>itemizedlist</tag> symbol
\r
7164 <literal>none</literal>.</para>
\r
7167 <para>Implemented the new
\r
7168 <parameter>graphical.admonition.properties</parameter> and
\r
7169 <parameter>nongraphical.admonition.properties</parameter>
\r
7170 attribute sets.</para>
\r
7173 <para>Added <tag class="attribute">id</tag> to
\r
7174 <tag>formalpara</tag> and some other blocks that were
\r
7175 missing it.</para>
\r
7178 <para>Changed the anchor template to output
\r
7179 <literal>fo:inline</literal> instead of
\r
7180 <literal>fo:wrapper</literal>.</para>
\r
7183 <para>Added support for <parameter>toc.max.depth</parameter>
\r
7189 <sect2 xml:id="V1690_HELP">
\r
7190 <title>Help</title>
\r
7193 <para>Eclipse Help: Added support for generating olink
\r
7199 <sect2 xml:id="V1690_HTML">
\r
7200 <title>HTML</title>
\r
7203 <para>Added a first cut at support in HTML output for
\r
7204 DocBook 5 style <tag>annotation</tag>s. Controlled using the
\r
7205 <parameter>annotation.support</parameter> parameter, and
\r
7206 implemented using JavaScript and CSS styling. For more
\r
7207 details, see the documentation for the
\r
7208 <parameter>annotation.js</parameter>,
\r
7209 <parameter>annotation.css</parameter>,
\r
7210 <parameter>annotation.graphic.open</parameter>, and
\r
7211 <parameter>annotation.graphic.close</parameter>
\r
7212 parameters.</para>
\r
7215 <para>Generate client-side image map for
\r
7216 <tag>imageobjectco</tag> with areas using
\r
7217 <literal>calspair</literal> units</para>
\r
7220 <para>Added support for <tag class="xmlpi">img.src.path</tag> PI.</para>
\r
7223 <para>Added support for passing
\r
7224 <parameter>img.src.path</parameter> to DocBook Java XSLT
\r
7225 image extensions when appropriate. Controlled using the
\r
7226 <parameter>graphicsize.use.img.src.path</parameter>
\r
7230 <para>Added support for (not
\r
7231 valid for DocBook 4) <tag class="attribute">xlink:href</tag>
\r
7232 on <tag>area</tag> and (not valid for DocBook 4)
\r
7233 <tag>alt</tag> in <tag>area</tag>.</para>
\r
7236 <para>Added new parameter
\r
7237 <parameter>default.table.frame</parameter> to control table
\r
7238 framing if there is no <tag class="attribute">frame</tag>
\r
7239 attribute on a table.</para>
\r
7242 <para>Added initial, experimental support for generating
\r
7243 content for the HTML <literal>title</literal> attribute from
\r
7244 content of the <tag>alt</tag> element. This change adds
\r
7245 support for the following inline elements only (none of them
\r
7246 are block elements):
\r
7247 <simplelist type="inline">
\r
7248 <?dbchoice choice="and"?>
\r
7249 <member><tag>abbrev</tag></member>
\r
7250 <member><tag>accel</tag></member>
\r
7251 <member><tag>acronym</tag></member>
\r
7252 <member><tag>action</tag></member>
\r
7253 <member><tag>application</tag></member>
\r
7254 <member><tag>authorinitials</tag></member>
\r
7255 <member><tag>beginpage</tag></member>
\r
7256 <member><tag>citation</tag></member>
\r
7257 <member><tag>citerefentry</tag></member>
\r
7258 <member><tag>citetitle</tag></member>
\r
7259 <member><tag>city</tag></member>
\r
7260 <member><tag>classname</tag></member>
\r
7261 <member><tag>code</tag></member>
\r
7262 <member><tag>command</tag></member>
\r
7263 <member><tag>computeroutput</tag></member>
\r
7264 <member><tag>constant</tag></member>
\r
7265 <member><tag>country</tag></member>
\r
7266 <member><tag>database</tag></member>
\r
7267 <member><tag>email</tag></member>
\r
7268 <member><tag>envar</tag></member>
\r
7269 <member><tag>errorcode</tag></member>
\r
7270 <member><tag>errorname</tag></member>
\r
7271 <member><tag>errortext</tag></member>
\r
7272 <member><tag>errortype</tag></member>
\r
7273 <member><tag>exceptionname</tag></member>
\r
7274 <member><tag>fax</tag></member>
\r
7275 <member><tag>filename</tag></member>
\r
7276 <member><tag>firstname</tag></member>
\r
7277 <member><tag>firstterm</tag></member>
\r
7278 <member><tag>foreignphrase</tag></member>
\r
7279 <member><tag>function</tag></member>
\r
7280 <member><tag>glossterm</tag></member>
\r
7281 <member><tag>guibutton</tag></member>
\r
7282 <member><tag>guiicon</tag></member>
\r
7283 <member><tag>guilabel</tag></member>
\r
7284 <member><tag>guimenu</tag></member>
\r
7285 <member><tag>guimenuitem</tag></member>
\r
7286 <member><tag>guisubmenu</tag></member>
\r
7287 <member><tag>hardware</tag></member>
\r
7288 <member><tag>honorific</tag></member>
\r
7289 <member><tag>interface</tag></member>
\r
7290 <member><tag>interfacename</tag></member>
\r
7291 <member><tag>keycap</tag></member>
\r
7292 <member><tag>keycode</tag></member>
\r
7293 <member><tag>keysym</tag></member>
\r
7294 <member><tag>lineage</tag></member>
\r
7295 <member><tag>lineannotation</tag></member>
\r
7296 <member><tag>literal</tag></member>
\r
7297 <member><tag>markup</tag></member>
\r
7298 <member><tag>medialabel</tag></member>
\r
7299 <member><tag>methodname</tag></member>
\r
7300 <member><tag>mousebutton</tag></member>
\r
7301 <member><tag>option</tag></member>
\r
7302 <member><tag>optional</tag></member>
\r
7303 <member><tag>otheraddr</tag></member>
\r
7304 <member><tag>othername</tag></member>
\r
7305 <member><tag>package</tag></member>
\r
7306 <member><tag>parameter</tag></member>
\r
7307 <member><tag>personname</tag></member>
\r
7308 <member><tag>phone</tag></member>
\r
7309 <member><tag>pob</tag></member>
\r
7310 <member><tag>postcode</tag></member>
\r
7311 <member><tag>productname</tag></member>
\r
7312 <member><tag>productnumber</tag></member>
\r
7313 <member><tag>prompt</tag></member>
\r
7314 <member><tag>property</tag></member>
\r
7315 <member><tag>quote</tag></member>
\r
7316 <member><tag>refentrytitle</tag></member>
\r
7317 <member><tag>remark</tag></member>
\r
7318 <member><tag>replaceable</tag></member>
\r
7319 <member><tag>returnvalue</tag></member>
\r
7320 <member><tag>tag</tag></member>
\r
7321 <member><tag>shortcut</tag></member>
\r
7322 <member><tag>state</tag></member>
\r
7323 <member><tag>street</tag></member>
\r
7324 <member><tag>structfield</tag></member>
\r
7325 <member><tag>structname</tag></member>
\r
7326 <member><tag>subscript</tag></member>
\r
7327 <member><tag>superscript</tag></member>
\r
7328 <member><tag>surname</tag></member>
\r
7329 <member><tag>symbol</tag></member>
\r
7330 <member><tag>systemitem</tag></member>
\r
7331 <member><tag>tag</tag></member>
\r
7332 <member><tag>termdef</tag></member>
\r
7333 <member><tag>token</tag></member>
\r
7334 <member><tag>trademark</tag></member>
\r
7335 <member><tag>type</tag></member>
\r
7336 <member><tag>uri</tag></member>
\r
7337 <member><tag>userinput</tag></member>
\r
7338 <member><tag>varname</tag></member>
\r
7339 <member><tag>wordasword</tag></member>
\r
7344 <para>Added support for chunking <tag>revhistory</tag> into
\r
7345 separate file (similar to the support for doing same with
\r
7346 <tag>legalnotice</tag>). Patch from Thomas
\r
7347 Schraitle. Controlled through <parameter>new
\r
7348 generate.revhistory.link</parameter> parameter.</para>
\r
7351 <para>l10n.xsl: Made language codes RFC compliant. Added a
\r
7352 new boolean config parameter,
\r
7353 <parameter>l10n.lang.value.rfc.compliant</parameter>. If it
\r
7354 is non-zero (the default), any underscore in a language code
\r
7355 will be converted to a hyphen in HTML output. If it is zero,
\r
7356 the language code will be left as-is.</para>
\r
7360 <sect2 xml:id="V1690_MAN">
\r
7361 <title>man</title>
\r
7362 <para>This release closes out 44 manpages stylesheet bug reports
\r
7363 and feature requests. It adds more than 35 new configuration
\r
7364 parameters for controlling aspects of man-page output --
\r
7365 including hyphenation and justification, handling of links,
\r
7366 conversion of Unicode characters, and contents of man-page
\r
7367 headers and footers.</para>
\r
7369 <!-- ======================================================= -->
\r
7371 <para>New options for globally disabling/enabling
\r
7372 hyphenation and justification:
\r
7373 <parameter>man.justify</parameter> and
\r
7374 <parameter>man.hyphenate</parameter>.</para>
\r
7375 <para>Note that the default
\r
7376 for the both of those is zero (off), because justified text
\r
7377 looks good only when it is also hyphenated; to quote the
\r
7378 <quote>Hyphenation</quote> node from the groff info page:
\r
7380 <para><emphasis>Since the odds are not great for finding a
\r
7381 set of words, for every output line, which fit nicely on a
\r
7382 line without inserting excessive amounts of space between
\r
7383 words, `gtroff' hyphenates words so that it can justify
\r
7384 lines without inserting too much space between
\r
7385 words.</emphasis></para>
\r
7387 The problem is that groff can end up hyphenating a lot of
\r
7388 things that you don't want hyphenated (variable names and
\r
7389 command names, for example). Keeping both justification and
\r
7390 hyphenation disabled ensures that hyphens won't get inserted
\r
7391 where you don't want to them, and you don't end up with
\r
7392 lines containing excessive amounts of space between
\r
7393 words. These default settings run counter to how most
\r
7394 existing man pages are formatted. But there are some notable
\r
7395 exceptions, such as the perl man pages.</para>
\r
7398 <para> Added parameters for controlling hyphenation of
\r
7399 computer inlines, filenames, and URLs. By default, even when
\r
7400 hyphenation is enabled (globally), hyphenation is now
\r
7401 suppressed for "computer inlines" (currently, just
\r
7402 <tag>classname</tag>, <tag>constant</tag>, <tag>envar</tag>,
\r
7403 <tag>errorcode</tag>, <tag>option</tag>,
\r
7404 <tag>replaceable</tag>, <tag>userinput</tag>,
\r
7405 <tag>type</tag>, and <tag>varname</tag>, and for
\r
7406 <tag>filenames</tag>, and for URLs from <tag>link</tag>. It
\r
7407 can be (re)enabled using the
\r
7408 <parameter>man.hyphenate.computer.inlines</parameter>,
\r
7409 <parameter>man.hyphenate.filenames</parameter>, and
\r
7410 <parameter>man.hyphenate.urls parameters</parameter>.</para>
\r
7412 <!-- ======================================================= -->
\r
7414 <para>Implemented a new system for replacing Unicode
\r
7415 characters. There are two parts to the new system: a
\r
7416 <quote>string substitution map</quote> for doing
\r
7417 <quote>essential</quote> replacements, and a
\r
7418 <quote>character map</quote> that can optionally be disabled
\r
7419 and enabled.</para>
\r
7420 <para>The new system fixes all open bugs that had to do with
\r
7421 literal Unicode numbered entities such as &#8220; and
\r
7422 &#8221; showing up in output, and greatly expands the
\r
7423 ability of the stylesheets to generate <quote>good</quote> roff
\r
7424 equivalents for Unicode symbols and special
\r
7425 characters.</para>
\r
7426 <para>Here are some details...</para>
\r
7427 <para>The previous manpages mechanism for replacing Unicode
\r
7428 symbols and special characters with roff equivalents (the
\r
7429 <function>replace-entities</function> template) was not
\r
7430 scalable and not complete. The mechanism handled a somewhat
\r
7431 arbitrary selection of less than 20 or so Unicode
\r
7432 characters. But there are potentially more than
\r
7433 <emphasis>800</emphasis> Unicode special characters that
\r
7434 have some groff equivalent they can be mapped to. And there
\r
7435 are about 34 symbols in the Latin-1 (ISO-8859-1) block
\r
7436 alone. Users might reasonably expect that if they include
\r
7437 any of those Latin-1 characters in their DocBook source
\r
7438 documents, they will get correctly converted to known roff
\r
7439 equivalents in output.</para>
\r
7440 <para>In addition to those common symbols, certain users may
\r
7441 have a need to use symbols from other Unicode blocks. Say,
\r
7442 somebody who is documenting an application related to math
\r
7443 might need to use a bunch of symbols from the
\r
7444 <quote>Mathematical Operators</quote> Unicode block (there
\r
7445 are about 65 characters in that block that have reasonable
\r
7446 roff equivalents). Or somebody else might really like
\r
7447 Dingbats -- such as the checkmark character -- and so might
\r
7448 use a bunch of things from the <quote>Dingbat</quote> block
\r
7449 (141 characters in that that have roff equivalents or that
\r
7450 can at least be <quote>degraded</quote> somewhat gracefully
\r
7451 into roff).</para>
\r
7452 <para>So, the old <function>replace-entities</function>
\r
7453 mechanism was replaced with a completely different mechanism
\r
7454 that is based on use of two <quote>maps</quote>: a
\r
7455 <quote>substitution map</quote> and a <quote>character
\r
7456 map</quote> (the latter in a format compliant with the XSLT
\r
7457 2.0 spec and therefore completely <quote>forward
\r
7458 compatible</quote> with XSLT 2.0).</para>
\r
7459 <para>The substitution map is controlled through the
\r
7460 <parameter>man.string.subst.map</parameter> parameter, and
\r
7461 is used to replace things like the backslash character
\r
7462 (which needs special handling to prevent it from being
\r
7463 interpreted as a roff escape). The substitution map cannot
\r
7464 be disabled, because disabling it will cause the output to
\r
7465 be broken. However, you can add to it and change it if
\r
7468 <para>The <quote>character map</quote> mechanism, on the
\r
7469 other hand, can be completely disabled. It is enabled by
\r
7470 default, and, by default, does replacement of all Latin-1
\r
7471 symbols, along with most special spaces, dashes, and quotes
\r
7472 (about 75 characters by default). Also, you can optionally
\r
7473 enable a <quote>full</quote> character map that provides
\r
7474 support for converting all 800 or so of the characters that
\r
7475 have some reasonable groff equivalent.</para>
\r
7477 <para>The character-map mechanism is controlled through the
\r
7478 following parameters:
\r
7481 <term><parameter>man.charmap.enabled</parameter></term>
\r
7482 <listitem><para>turns character-map support
\r
7483 on/off</para></listitem>
\r
7486 <term><parameter>man.charmap.use.subset</parameter></term>
\r
7487 <listitem><para>specifies that a subset of the character
\r
7488 map is used instead of the full map</para></listitem>
\r
7491 <term><parameter>man.charmap.subset.profile</parameter></term>
\r
7492 <listitem><para>specifies profile of character-map
\r
7493 subset</para></listitem>
\r
7496 <term><parameter>man.charmap.uri</parameter></term>
\r
7497 <listitem><para>specifies an alternate character map to
\r
7498 use instead of the <quote>standard</quote> character map
\r
7499 provided in the distribution</para></listitem>
\r
7504 <!-- ======================================================= -->
\r
7506 <para>Implemented out-of-line handling of display of URLs
\r
7507 for links (currently, only for <tag>ulink</tag>). This gives
\r
7508 you three choices for handling of links:
\r
7511 <para>Number and list links. Each link is numbered
\r
7512 inline, with a number in square brackets preceding the
\r
7513 link contents, and a numbered list of all links is added
\r
7514 to the end of the document.</para>
\r
7517 <para>Only list links. Links are not numbered, but an
\r
7518 (unnumbered) list of links is added to the end of the
\r
7522 <para>Suppress links. Don't number links and don't add
\r
7523 any list of links to the end of the document.</para>
\r
7526 You can also choose whether links should be underlined. The
\r
7527 default is <quote>the works</quote> -- list, number, and
\r
7528 underline links. You can use the
\r
7529 <parameter>man.links.list.enabled</parameter>, <parameter>
\r
7530 man.links.are.numbered</parameter>, and
\r
7531 <parameter>man.links.are.underlined</parameter> parameters
\r
7532 to change the defaults. The default heading for the link
\r
7533 list is REFERENCES. You can be change that using the
\r
7534 <parameter>man.links.list.heading</parameter>
\r
7538 <para>Changed default output encoding to UTF-8. <emphasis role="bold">This does not mean that man pages are output in
\r
7539 raw UTF-8</emphasis>, because the character map is applied
\r
7540 before final output, causing all UTF-8 characters covered in
\r
7541 the map to be converted to roff equivalents.</para>
\r
7543 <!-- ======================================================= -->
\r
7545 <para>Added support for processing <tag>refsect3</tag> and
\r
7546 <tag>formalpara</tag> and nested <tag>refsection</tag>
\r
7547 elements, down to any arbitrary level of nesting.</para>
\r
7549 <!-- ======================================================= -->
\r
7551 <para>Output of the <literal>NAME</literal> and
\r
7552 <literal>SYNOPSIS</literal> and <literal>AUTHOR</literal>
\r
7553 headings and the headings for admonitions (<tag>note</tag>,
\r
7554 <tag>caution</tag>, etc.) are no longer hard-coded for
\r
7555 English. Instead, headings are generated for those in the
\r
7556 correct locale (just as the FO and HTML stylesheets
\r
7559 <!-- ======================================================= -->
\r
7561 <para>Re-worked mechanism for assembling page
\r
7562 headers/footers (the contents of the <literal>.TH</literal>
\r
7563 macro <quote>title line</quote>).</para>
\r
7565 <para>Here are some details...</para>
\r
7567 <para>All man pages contain a <literal>.TH</literal> roff
\r
7568 macro whose contents are used for rendering the <quote>title
\r
7569 line</quote> displayed in the header and footer of each
\r
7570 page. Here are a couple of examples of real-world man pages
\r
7571 that have useful page headers/footers: <literallayout class="monospaced">
\r
7572 gtk-options(7) GTK+ User's Manual gtk-options(7) <-- header
\r
7573 GTK+ 1.2 2003-10-20 gtk-options(7) <-- footer
\r
7575 svgalib(7) Svgalib User Manual svgalib(7) <-- header
\r
7576 Svgalib 1.4.1 16 December 1999 svgalib(7) <-- footer</literallayout></para>
\r
7578 <para>And here are the terms with which the
\r
7579 <literal>groff_man(7)</literal> man page refers to the
\r
7580 various parts of the header/footer: <literallayout class="monospaced">
\r
7581 title(section) extra3 title(section) <- header
\r
7582 extra2 extra1 title(section) <- footer</literallayout></para>
\r
7583 <para> Or, using the names with which the <literal>man(7)</literal>
\r
7584 man page refers to those same fields: <literallayout class="monospaced">
\r
7585 title(section) manual title(section) <- page header
\r
7586 source date title(section) <- page footer</literallayout></para>
\r
7588 <para>The easiest way to control the contents of those
\r
7589 fields is to mark up your <tag>refentry</tag> content like
\r
7590 the following (note that this is a <quote>minimal</quote>
\r
7591 example). <programlisting>
\r
7594 <date>2003-10-20</date> <co xml:id="V1690_date-co" linkends="V1690_date"/>
\r
7597 <refentrytitle>gtk-options</refentrytitle> <co xml:id="V1690_title-co" linkends="V1690_title"/>
\r
7598 <manvolnum>7</manvolnum> <co xml:id="V1690_manvolnum-co" linkends="V1690_manvolnum"/>
\r
7599 <refmiscinfo class="source-name">GTK+</refmiscinfo> <co xml:id="V1690_source-name-co" linkends="V1690_source-name"/>
\r
7600 <refmiscinfo class="version">1.2</refmiscinfo> <co xml:id="V1690_version-co" linkends="V1690_version"/>
\r
7601 <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> <co xml:id="V1690_manual-co" linkends="V1690_manual"/>
\r
7603 <refnamediv>
\r
7604 <refname>gtk-options</refname>
\r
7605 <refpurpose>Standard Command Line Options for GTK+ Programs</refpurpose>
\r
7606 </refnamediv>
\r
7608 <title>Description</title>
\r
7609 <para>This manual page describes the command line options, which
\r
7610 are common to all GTK+ based applications.</para>
\r
7612 </refentry></programlisting>
\r
7614 <callout arearefs="V1690_date-co" xml:id="V1690_date">
\r
7615 <para>Sets the <quote>date</quote> part of the header/footer.</para>
\r
7617 <callout arearefs="V1690_title-co" xml:id="V1690_title">
\r
7618 <para>Sets the <quote>title</quote> part.</para>
\r
7620 <callout arearefs="V1690_manvolnum-co" xml:id="V1690_manvolnum">
\r
7621 <para>Sets the <quote>section</quote> part.</para>
\r
7623 <callout arearefs="V1690_source-name-co" xml:id="V1690_source-name">
\r
7624 <para>Sets the <quote>source name</quote> part.</para>
\r
7626 <callout arearefs="V1690_version-co" xml:id="V1690_version">
\r
7627 <para>Sets the <quote>version</quote> part.</para>
\r
7629 <callout arearefs="V1690_manual-co" xml:id="V1690_manual">
\r
7630 <para>Sets the <quote>manual</quote> part.</para>
\r
7634 <para>Below are explanations of the steps the stylesheets
\r
7635 take to attempt to assemble and display
\r
7636 <quote>good</quote> headers and footer. [In the
\r
7637 descriptions, note that <replaceable>*info</replaceable>
\r
7638 is the <tag>refentry</tag> <quote>info</quote> child
\r
7639 (whatever its name), and
\r
7640 <replaceable>parentinfo</replaceable> is the
\r
7641 <quote>info</quote> child of its parent (again, whatever
\r
7645 <term>extra1 field (date)</term>
\r
7647 <para>Content of the <quote>extra1</quote> field is
\r
7648 what shows up in the <emphasis role="bold">center
\r
7649 footer</emphasis> position of each page. The
\r
7650 <literal>man(7)</literal> man page describes it as
\r
7651 <quote>the date of the last revision</quote>.</para>
\r
7652 <para>To provide this content, if the
\r
7653 <parameter>refentry.date.profile.enabled</parameter>
\r
7654 is non-zero, the stylesheets check the value of
\r
7655 <parameter>refentry.date.profile</parameter>.</para>
\r
7656 <para>Otherwise, by default, they check for a
\r
7657 <tag>date</tag> or <tag>pubdate</tag> not only in the
\r
7658 <replaceable>*info</replaceable> contents, but also in
\r
7659 the <replaceable>parentinfo</replaceable>
\r
7661 <para>If a date cannot be found, the stylesheets now
\r
7662 automatically generate a localized <quote>long
\r
7663 format</quote> date, ensuring that this field always
\r
7664 has content in output.</para>
\r
7665 <para>However, if for some reason you want to suppress
\r
7666 this field, you can do so by setting a non-zero value
\r
7667 for <parameter>man.th.extra1.suppress</parameter>.</para>
\r
7671 <term>extra2 field (source)</term>
\r
7673 <para>On Linux systems and on systems with a modern
\r
7674 groff, the content of the <quote>extra2</quote> field
\r
7675 are what shows up in the <emphasis role="bold">left
\r
7676 footer</emphasis> position of each page.</para>
\r
7678 <para>The <literal>man(7)</literal> man page describes
\r
7679 this as <quote>the source of the command</quote>, and
\r
7680 provides the following examples:
\r
7683 <para>For binaries, use somwething like: GNU,
\r
7684 NET-2, SLS Distribution, MCC Distribution.</para>
\r
7687 <para>For system calls, use the version of the
\r
7688 kernel that you are currently looking at: Linux
\r
7692 <para>For library calls, use the source of the
\r
7693 function: GNU, BSD 4.3, Linux DLL 4.4.1.</para>
\r
7698 <para>In practice, there are many pages that simply
\r
7699 have a version number in the <quote>source</quote>
\r
7700 field. So, it looks like what we have is a two-part
\r
7702 <replaceable>Name</replaceable> <replaceable>Version</replaceable>,
\r
7708 <para>product name (e.g., BSD) or org. name
\r
7709 (e.g., GNU)</para>
\r
7713 <term>Version</term>
\r
7715 <para>version name</para>
\r
7719 Each part is optional. If the
\r
7720 <replaceable>Name</replaceable> is a product name,
\r
7721 then the <replaceable>Version</replaceable> is
\r
7722 probably the version of the product. Or there may be
\r
7723 no <replaceable>Name</replaceable>, in which case, if
\r
7724 there is a <replaceable>Version</replaceable>, it is
\r
7725 probably the version of the item itself, not the
\r
7726 product it is part of. Or, if the
\r
7727 <replaceable>Name</replaceable> is an organization
\r
7728 name, then there probably will be no
\r
7729 <replaceable>Version</replaceable>.
\r
7731 <para>To provide this content, if the
\r
7732 <parameter>refentry.source.name.profile.enabled</parameter>
\r
7734 <parameter>refentry.version.profile.enabled</parameter>
\r
7735 parameter are non-zero, the stylesheets check the
\r
7736 value of <parameter>refentry.source.name.profile</parameter>
\r
7737 <parameter>refentry.version.profile</parameter>.</para>
\r
7739 <para>Otherwise, by default, they check the following
\r
7740 places, in the following order:
\r
7743 <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productnumber</tag></literallayout>
\r
7746 <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productnumber</tag></literallayout>
\r
7749 <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag>[@class = 'version']</literallayout>
\r
7752 <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>productnumber</tag></literallayout>
\r
7755 <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productname</tag></literallayout>
\r
7758 <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>productname</tag></literallayout>
\r
7761 <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag></literallayout>
\r
7764 <para>[nothing found, so leave it empty]</para>
\r
7771 <term>extra3 field</term>
\r
7773 <para>On Linux systems and on systems with a modern
\r
7774 groff, the content of the <quote>extra3</quote> field
\r
7775 are what shows up in the <emphasis role="bold">center
\r
7776 header</emphasis> position of each page. Some man
\r
7777 pages have <quote>extra2</quote> content, some
\r
7778 don't. If a particular man page has it, it is most
\r
7779 often <quote>context</quote> data about some larger
\r
7780 system the documented item belongs to (for example,
\r
7781 the name or description of a group of related
\r
7782 applications). The stylesheets now check the following
\r
7783 places, in the following order, to look for content to
\r
7784 add to the <quote>extra3</quote> field.</para>
\r
7787 <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>title</tag></literallayout>
\r
7790 <literallayout class="monospaced">parent's <tag>title</tag></literallayout>
\r
7793 <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag></literallayout>
\r
7796 <para>[nothing found, so leave it empty]</para>
\r
7804 <!-- ======================================================= -->
\r
7806 <para>Reworked <replaceable>*info</replaceable> gathering. For
\r
7807 each <tag>refentry</tag> found, the stylesheets now cache its
\r
7808 <replaceable>*info</replaceable> content, then check for any
\r
7809 valid parent of it that might have metainfo content and cache
\r
7810 that, if found; they then then do all further matches against
\r
7811 those node-sets (rather than re-selecting the original
\r
7812 <replaceable>*info</replaceable> nodes each time they are
\r
7815 <!-- ======================================================= -->
\r
7817 <para>New option for breaking strings after forward
\r
7818 slashes. This enables long URLs and pathnames to be broken
\r
7819 across lines. Controlled through
\r
7820 <parameter>man.break.after.slash</parameter> parameter.</para>
\r
7822 <!-- ======================================================= -->
\r
7824 <para>Output for servicemark and trademark are now
\r
7825 <literal>(SM)</literal> and <literal>(TM)</literal>. There is
\r
7826 a groff <literal>"\(tm"</literal> escape, but output from that
\r
7827 is not acceptable.</para>
\r
7829 <!-- ======================================================= -->
\r
7831 <para>New option for controlling the length of the title
\r
7832 part of the <literal>.TH</literal> title line. Controlled
\r
7833 through the <parameter>man.th.title.max.length</parameter>
\r
7836 <!-- ======================================================= -->
\r
7838 <para>New option for specifying output encoding of each man
\r
7839 page; controlled with
\r
7840 <parameter>man.output.encoding</parameter> (similar to the
\r
7841 HTML <parameter>chunker.output.encoding </parameter>
\r
7842 parameter).</para>
\r
7844 <!-- ======================================================= -->
\r
7846 <para>New option for suppressing filename messages when
\r
7847 generating output; controlled with
\r
7848 <parameter>man.output.quietly</parameter> (similar to the HTML
\r
7849 <parameter>chunk.quietly</parameter> parameter).</para>
\r
7851 <!-- ======================================================= -->
\r
7853 <para>The text of cross-references to first-level
\r
7854 <tag>refentry</tag> (<tag>refsect1</tag>, top-level
\r
7855 <tag>refsection</tag>, <tag>refnamediv</tag>, and
\r
7856 <tag>refsynopsisdiv</tag>) are now capitalized.</para>
\r
7858 <!-- ======================================================= -->
\r
7860 <para>Cross-references to <tag>refnamediv</tag> now use the
\r
7861 localized <literal>NAME</literal> title instead of using the
\r
7862 first <tag>refname</tag> child. This makes the output
\r
7863 inconsistent with HTML and FO output, but for man-page output,
\r
7864 it seems to make better sense to have the
\r
7865 <literal>NAME</literal>. (It may actually make better sense to
\r
7866 do it that way in HTML and FO output as well...)</para>
\r
7868 <!-- ======================================================= -->
\r
7870 <para>Added support for processing <tag>funcparams</tag>.</para>
\r
7872 <!-- ======================================================= -->
\r
7874 <para>Removed the space that was being output between
\r
7875 <tag>funcdef</tag> and <tag>paramdef</tag>; example: was:
\r
7876 <literal>float rand (void)</literal>; now:
\r
7877 <literal>float rand(void)</literal></para>
\r
7879 <!-- ======================================================= -->
\r
7881 <para>Turned off bold formatting for the <tag>type</tag>
\r
7882 element when it occurs within a <tag>funcdef</tag> or
\r
7883 <tag>paramdef</tag></para>
\r
7885 <!-- ======================================================= -->
\r
7887 <para>Corrected rendering of <tag>simplelist</tag>. Any
\r
7888 <literal><simplelist type="inline"</literal> instance
\r
7889 is now rendered as a comma-separated list (also with an
\r
7890 optional localized <quote>and</quote> or <quote>or</quote> before the last item -- see
\r
7891 description elsewhere in these release notes). Any simplelist
\r
7892 instance whose <tag class="attribute">type</tag> is not
\r
7893 <literal>inline</literal> is rendered as a one-column vertical
\r
7894 list (ignoring the values of the <tag class="attribute">type</tag> and <tag class="attribute">columns</tag> attributes if present)</para>
\r
7896 <!-- ======================================================= -->
\r
7898 <para>Comment added at top of roff source for each page now
\r
7899 includes DocBook XSL stylesheets version number (as in the
\r
7900 HTML stylesheets)</para>
\r
7902 <!-- ======================================================= -->
\r
7904 <para>Made change to prevent <quote>sticky</quote> fonts
\r
7905 changes. Now, when the manpages stylesheets encounter node
\r
7906 sets that need to be boldfaced or italicized, they put the
\r
7907 <literal>\fBfoo\fR</literal> and <literal>\fIbar\fR</literal>
\r
7908 groff bold/italic instructions separately around each node in
\r
7912 <para>synop.xsl: Boldface everything in
\r
7913 <tag>funcsynopsis</tag> output except parameters (which are in
\r
7914 ital). The <literal>man(7)</literal> man page says:
\r
7916 <para>For functions, the arguments are always specified
\r
7917 using italics, even in the SYNOPSIS section, where the rest
\r
7918 of the function is specified in bold.</para>
\r
7920 A look through the contents of the
\r
7921 <filename>man/man2</filename> directory shows that most
\r
7922 (all) existing pages do follow this <quote>everything in
\r
7923 funcsynopsis bold</quote> rule. That means the
\r
7924 <tag>type</tag> content and any punctuation (parens,
\r
7925 semicolons, <tag>vararg</tag>s) also must be bolded.</para>
\r
7927 <!-- ======================================================= -->
\r
7929 <para>Removed code for adding backslashes before periods/dots
\r
7930 in roff source, because backslashes in front of periods/dots
\r
7931 in roff source are needed only in the very rare case where a
\r
7932 period is the very first character in a line, without any
\r
7933 space in front of it. A better way to deal with that rare case
\r
7934 is for you to add a zero-width space in front of the offending
\r
7935 dot(s) in your source</para>
\r
7937 <!-- ======================================================= -->
\r
7939 <para>Removed special handling of the <tag>quote</tag>
\r
7940 element. That was hard-coded to cause anything marked up with
\r
7941 the <tag>quote</tag> element to be output preceded by two
\r
7942 backticks and followed by two apostrophes -- that is, that
\r
7943 old-school kludge for generating <quote>curly</quote> quotes in Emacs and
\r
7944 in X-Windows fonts. While Emacs still seems to support that, I
\r
7945 don't think X-Windows has for a long time now. And, anyway, it
\r
7946 looks (and has always looked) like crap when viewed on a
\r
7947 normal tty/console. In addition, it breaks localiztion of
\r
7948 <tag>quote</tag>. By default, <tag>quote</tag> content is
\r
7949 output with localized quotation marks, which, depending on the
\r
7950 locale, may or may not be left and right double quotation
\r
7953 <!-- ======================================================= -->
\r
7955 <para>Changed mappings for left and right single quotation
\r
7956 marks. Those had previously been incorrectly mapped to the
\r
7957 backtick (&#96;) and apostrophe (&39;) characters (for
\r
7958 kludgy reasons -- see above). They are now correctly mapped to
\r
7959 the <literal>\(oq</literal> and <literal>\(cq</literal> roff
\r
7960 escapes. If you want the old (broken) behavior, you need to
\r
7961 manually change the mappings for those in the value of the
\r
7962 <parameter>man.string.subst.map</parameter> parameter.</para>
\r
7965 <para>Removed <filename>xref.xsl</filename> file. Now, of the
\r
7966 various cross-reference elements, only the <tag>ulink</tag>
\r
7967 element is handled differently; the rest are handled exactly
\r
7968 as the HTML stylesheets handle them, except that no hypertext
\r
7969 links are generated. (Because there is no equivalent hypertext
\r
7970 mechanism is man pages.)</para>
\r
7972 <!-- ======================================================= -->
\r
7974 <para>New option for making <quote>subheading dividers</quote> in generated
\r
7975 roff source. The dividers are not visible in the rendered man
\r
7976 page; they are just there to make the source
\r
7977 readable. Controlled using
\r
7978 <parameter>man.subheading.divider</parameter>.</para>
\r
7980 <!-- ======================================================= -->
\r
7982 <para>Fixed many places where too much space was being added
\r
7983 between lines.</para>
\r
7986 <!-- end of MAN changes for 1.69.0 release -->
\r
7989 <!-- end of notes for 1.69.0 release -->
\r
7991 <sect1 xml:id="V1681">
\r
7992 <title>Release 1.68.1</title>
\r
7993 <para>The release adds localization support for Farsi (thanks to
\r
7994 Sina Heshmati) and improved support for the XLink-based DocBook NG
\r
7995 <tag>db:link</tag> element. Other than that, it is a minor
\r
7996 bug-fix update to the 1.68.0 release. The main thing it fixes is a
\r
7997 build error that caused the XSLT Java extensions to be jarred up
\r
7998 with the wrong package structure. Thanks to Jens Stavnstrup for
\r
7999 quickly reporting the problem, and to Mauritz Jeanson for
\r
8000 investigating and finding the cause.</para>
\r
8002 <!-- end of notes for 1.68.1 release -->
\r
8004 <sect1 xml:id="V1680">
\r
8005 <title>Release 1.68.0</title>
\r
8006 <para>This release includes some features changes, particularly
\r
8007 for FO/PDF output, and a number of bug fixes.
\r
8008 <itemizedlist xml:id="V1680_FO">
\r
8011 <para>Moved footnote properties to attribute-sets.</para>
\r
8014 <para>Added support for side floats, margin notes, and
\r
8015 custom floats.</para>
\r
8018 <para>Added new parameters
\r
8019 <parameter>body.start.indent</parameter> and
\r
8020 <parameter>body.end.indent</parameter> to the
\r
8021 <parameter>set.flow.properties template</parameter>.</para>
\r
8024 <para>Added support for <tag class="attribute">xml:id</tag></para>
\r
8027 <para>Added support for
\r
8028 <tag>refdescriptor</tag>.</para>
\r
8031 <para>Added support for multiple <tag>refnamediv</tag>s.</para>
\r
8034 <para>Added <parameter>index.entry.properties</parameter>
\r
8035 attribute-set to support customization of index
\r
8039 <para>Added <parameter>set.flow.properties
\r
8040 template</parameter> call to each <tag>fo:flow</tag>
\r
8041 to support customizations entry point.</para>
\r
8044 <para>Add support for <literal>@floatstyle</literal> in
\r
8045 <tag>figure</tag></para>
\r
8048 <para>Moved hardcoded properties for index division titles
\r
8049 to the <parameter>index.div.title.properties</parameter>
\r
8050 attribute-set.</para>
\r
8053 <para>Added support for
\r
8054 <tag>table-layout</tag>="<tag class="attvalue">auto</tag>" for XEP.</para>
\r
8057 <para>Added <parameter>index.div.title.properties</parameter>
\r
8058 attribute-set.</para>
\r
8061 <para><parameter>$verbose</parameter> parameter is now
\r
8062 passed to most elements.</para>
\r
8065 <para>Added <tag>refentry</tag> to
\r
8066 <tag>toc</tag> in <tag>part</tag>, as it is
\r
8067 permitted by the DocBook schema/DTD.</para>
\r
8070 <para>Added backmatter elements and
\r
8071 <tag>article</tag> to <tag>toc</tag> in
\r
8072 <tag>part</tag>, since they are permitted by the
\r
8073 DocBook schema/DTD.</para>
\r
8076 <para>Added <tag class="attribute">mode</tag>="<tag class="attvalue">toc</tag>" for
\r
8077 <tag>simplesect</tag>, since it is now permitted in
\r
8078 the <tag>toc</tag> if
\r
8079 <parameter>simplesect.in.toc</parameter> is set.</para>
\r
8082 <para>Moved hard-coded properties to
\r
8083 <parameter>nongraphical.admonintion.properties</parameter>
\r
8084 and <parameter>graphical.admonition.properties</parameter>
\r
8085 attribute sets.</para>
\r
8088 <para>Added support for <literal>sidebar-width</literal> and
\r
8089 <literal>float-type</literal> processing instructions in
\r
8090 <tag>sidebar</tag>.</para>
\r
8093 <para>For tables with HTML markup elements, added support
\r
8094 for <literal>dbfo bgcolor</literal> PI, the attribute-sets
\r
8095 named <parameter>table.properties</parameter>,
\r
8096 <parameter>informaltable.properties</parameter>,
\r
8097 <parameter>table.table.properties</parameter>, and
\r
8098 <parameter>table.cell.padding</parameter>. Also added
\r
8099 support for the templates named
\r
8100 <parameter>table.cell.properties</parameter> and
\r
8101 <parameter>table.cell.block.properties</parameter> so that
\r
8102 tabstyles can be implemented. Also added support for tables
\r
8103 containing only <tag>tr</tag> instead of
\r
8104 <tag>tbody</tag> with <tag>tr</tag>.</para>
\r
8107 <para>Added new paramater
\r
8108 <parameter>hyphenate.verbatim.characters</parameter> which
\r
8109 can specify characters after which a line break can occur in
\r
8110 verbatim environments. This parameter can be used to extend
\r
8111 the initial set of characters which contain only space and
\r
8112 non-breakable space.</para>
\r
8115 <para>Added <parameter>itemizedlist.label.markup</parameter> to enable
\r
8116 selection of different bullet symbol. Also added several
\r
8117 potential bullet characters, commented out by default.</para>
\r
8120 <para>Enabled all id's in XEP output for external olinking.</para>
\r
8124 <itemizedlist xml:id="V1680_HTML">
\r
8125 <title>HTML</title>
\r
8127 <para>Added support for
\r
8128 <tag>refdescriptor</tag>.</para>
\r
8131 <para>Added support for multiple <tag>refnamediv</tag>s.</para>
\r
8134 <para>Added support for <tag class="attribute">xml:id</tag></para>
\r
8137 <para><tag>refsynopsisdiv</tag> as a section for
\r
8138 counting section levels</para>
\r
8141 <itemizedlist xml:id="V1680_images">
\r
8142 <title>Images</title>
\r
8144 <para>Added new SVG admonition graphics and navigation images.</para>
\r
8149 <!-- end of notes for 1.68.0 release -->
\r
8151 <sect1 xml:id="V1672">
\r
8152 <title>Release 1.67.2</title>
\r
8153 <para>This release fixes a table bug introduced in the 1.67.1
\r
8156 <sect1 xml:id="V1671">
\r
8157 <title>Release 1.67.1</title>
\r
8158 <para>This release includes a number of bug fixes.</para>
\r
8159 <para>The following lists provide details about API and feature changes.
\r
8160 <itemizedlist xml:id="V1671_FO">
\r
8163 <para>Tables: Inherited cell properties are now passed to the
\r
8164 <literal>table.cell.properties</literal> template so they can
\r
8165 be overridden by a customization.</para>
\r
8168 <para>Tables: Added support for bgcolor PI on table row
\r
8172 <para>TOCs: Added new parameter
\r
8173 <parameter>simplesect.in.toc</parameter>; default value of
\r
8174 <literal>0</literal> causes simplesect to be omitted from TOCs; to
\r
8175 cause <tag>simplesect</tag> to be included in TOCs, you
\r
8176 must set the value of <parameter>simplesect.in.toc</parameter> to
\r
8177 <literal>1</literal>.Comment from Norm:
\r
8180 <para><emphasis>Simplesect elements aren't supposed to
\r
8181 appear in the ToC at all... The use case for simplesect
\r
8182 is when, for example, every chapter in a book ends with
\r
8183 "Exercises" or "For More Information" sections and you
\r
8184 don't want those to appear in the ToC.</emphasis></para>
\r
8189 <para>Sections: Reverted change that caused a variable reference
\r
8190 to be used in a template match and rewrote code to preserve
\r
8191 intended semantics.</para>
\r
8194 <para>Lists: Added workaround to prevent "* 0.60 + 1em" garbage in
\r
8195 list output from PassiveTeX</para>
\r
8198 <para>Moved the literal attributes from
\r
8199 <parameter>component.title</parameter> to the
\r
8200 <parameter>component.title.properties</parameter> attribute-set so
\r
8201 they can be customized.</para>
\r
8204 <para>Lists: Added <tag>glossdef</tag>'s first
\r
8205 <tag>para</tag> to special handling in
\r
8206 <literal>fo:list-item-body</literal>.</para>
\r
8210 <itemizedlist xml:id="V1671_HTML">
\r
8211 <title>HTML</title>
\r
8213 <para>TOCs: Added new parameter
\r
8214 <parameter>simplesect.in.toc</parameter>; for details, see
\r
8215 the list of <xref linkend="V1671_FO"/> changes for this
\r
8219 <para>Indexing: Added new parameter
\r
8220 <parameter>index.prefer.titleabbrev</parameter>; when set to
\r
8221 <literal>1</literal>, index references will use
\r
8222 <tag>titleabbrev</tag> instead of
\r
8223 <tag>title</tag> when available.</para>
\r
8226 <itemizedlist xml:id="V1671_HELP">
\r
8227 <title>HTML Help</title>
\r
8229 <para>Added support for generating windows-1252-encoded
\r
8230 output using Saxon; for more details, see the list of <xref linkend="V1671_EXT"/> changes for this release.</para>
\r
8233 <itemizedlist xml:id="V1671_MAN">
\r
8234 <title>man pages</title>
\r
8236 <para>Replaced named/numeric character-entity references for
\r
8237 non-breaking space with groff equivalent (backslash-tilde).</para>
\r
8240 <itemizedlist xml:id="V1671_EXT">
\r
8241 <title>XSL Java extensions</title>
\r
8243 <para>Saxon extensions: Added the
\r
8244 <classname>Windows1252</classname> class. It extends Saxon
\r
8245 6.5.x with the windows-1252 character set, which is
\r
8246 particularly useful when generating HTML Help for Western
\r
8247 European Languages (code from
\r
8248 <personname><firstname>Pontus</firstname>
\r
8249 <surname>Haglund</surname></personname> and contributed to the
\r
8250 DocBook community by Sectra AB, Sweden).</para>
\r
8254 <para>Make sure that the Saxon 6.5.x jar file and the jar file for
\r
8255 the DocBook XSL Java extensions are in your <envar>CLASSPATH</envar></para>
\r
8258 <para>Create a DocBook XSL customization layer -- a file named
\r
8259 <filename>mystylesheet.xsl</filename> or whatever -- that, at a
\r
8260 minimum, contains the following:
\r
8261 <screen> <xsl:stylesheet
\r
8262 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
\r
8264 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/>
\r
8265 <xsl:output method="html" encoding="WINDOWS-1252" indent="no"/>
\r
8266 <xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"></xsl:param>
\r
8267 <xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"></xsl:param>
\r
8268 <xsl:param name="saxon.character.representation" select="'native'"></xsl:param>
\r
8269 </xsl:stylesheet></screen>
\r
8271 <para>Invoke Saxon with the
\r
8272 <literal>encoding.windows-1252</literal> Java system property set
\r
8273 to <literal>com.nwalsh.saxon.Windows1252</literal>; for example
\r
8275 -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
\r
8276 com.icl.saxon.StyleSheet \
\r
8277 mydoc.xml mystylesheet.xsl</screen>
\r
8279 Or, for a more complete "real world" case showing other
\r
8280 options you'll typically want to use:
\r
8282 -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
\r
8283 -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \
\r
8284 -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \
\r
8285 -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \
\r
8286 com.icl.saxon.StyleSheet \
\r
8287 -x org.apache.xml.resolver.tools.ResolvingXMLReader \
\r
8288 -y org.apache.xml.resolver.tools.ResolvingXMLReader \
\r
8289 -r org.apache.xml.resolver.tools.CatalogResolver \
\r
8290 mydoc.xml mystylesheet.xsl</screen>
\r
8292 In both cases, the "mystylesheet.xsl" file should be a
\r
8293 DocBook customization layer containing the parameters
\r
8294 show in step 2.</para>
\r
8300 <para>Saxon extensions: Removed Saxon 8 extensions from release package</para>
\r
8305 <sect1 xml:id="V1670">
\r
8306 <title>Release 1.67.0</title>
\r
8309 <para>A number of important bug fixes.</para>
\r
8312 <para>Added Saxon8 extensions</para>
\r
8315 <para>Enabled <literal>dbfo table-width</literal> on
\r
8316 <tag>entrytbl</tag> in FO output</para>
\r
8319 <para>Added support for <literal>role=strong</literal> on
\r
8320 <tag>emphasis</tag> in FO output</para>
\r
8323 <para>Added new FO parameter
\r
8324 <parameter>hyphenate.verbatim</parameter> that can be used to turn
\r
8325 on "intelligent" wrapping of verbatim environments.</para>
\r
8328 <para>Replaced all <literal><tt></tt></literal> output with
\r
8329 <literal><code></code></literal></para>
\r
8332 <para>Changed <literal>admon.graphic.width</literal> template to a
\r
8333 mode so that different admonitions can have different graphical
\r
8337 <para>Deprecated the HTML <parameter>shade.verbatim</parameter>
\r
8338 parameter (use CSS instead)</para>
\r
8342 <tag>refentrytitle</tag>/<tag>refname</tag> and
\r
8343 <tag>refpurpose</tag> in span with class values. This
\r
8344 makes it possible to style them using a CSS stylesheet.</para>
\r
8347 <para>Use <literal>strong/em</literal> instead of
\r
8348 <literal>b/i</literal> in HTML output</para>
\r
8351 <para>Added support for converting <tag>Emphasis</tag> to
\r
8352 groff italic and <tag>Emphasis role='bold'</tag> to
\r
8353 bold. Controlled by
\r
8354 <parameter>emphasis.propagates.style</parameter> param, but not
\r
8355 documented yet using litprog system. Will do that next (planning
\r
8356 to add some other parameter-controllable options for hyphenation
\r
8357 and handling of line spacing).</para>
\r
8360 <para><parameter>callout.graphics.number.limit.xml</parameter>
\r
8361 param: Changed the default from <literal>10</literal> to
\r
8362 <literal>15</literal>.</para>
\r
8365 <para><parameter>verbatim.properties</parameter>: Added
\r
8366 <literal>hyphenate=false</literal></para>
\r
8369 <para>Saxon and Xalan Text.java extensions: Added support for
\r
8370 <methodname>URIResolver()</methodname> on insertfile href's</para>
\r
8373 <para>Added generated <filename>RELEASE-NOTES.txt</filename>
\r
8377 <para>Added <filename>INSTALL</filename> file (executable file for
\r
8378 generating catalog.xml)</para>
\r
8381 <para>Removed obsolete <filename>tools</filename> directory from
\r
8386 <sect1 xml:id="V1661">
\r
8387 <title>Release 1.66.1</title>
\r
8390 <para>A number of important bug fixes.
\r
8395 Now <literal>xml:base</literal> attributes that are generated by an
\r
8396 XInclude processor are resolved for image files.
\r
8401 Rewrote olink templates to support several new features.
\r
8406 Extended full olink support to FO output.
\r
8411 Add support for <literal>xrefstyle</literal> attribute in olinks.
\r
8416 New parameters to support new olink features:
\r
8417 <parameter>insert.olink.page.number</parameter>, <parameter>insert.olink.pdf.frag</parameter>,
\r
8418 <parameter>olink.debug</parameter>, <parameter>olink.lang.fallback.sequence</parameter>, <parameter>olink.properties</parameter>,
\r
8419 <parameter>prefer.internal.olink</parameter>.
\r
8420 See the reference page for each parameter for more
\r
8421 information.</para>
\r
8427 Added <parameter>index.on.type</parameter> parameter for new <tag class="attribute">type</tag>
\r
8428 attribute introduced in DocBook 4.3 for indexterms and index.
\r
8429 This allows you to create multiple indices containing
\r
8430 different categories of entries.
\r
8431 For users of 4.2 and earlier, you can use the new parameter <parameter>index.on.role</parameter>
\r
8438 <parameter>section.autolabel.max.depth</parameter> parameter to turn off section numbering
\r
8439 below a certain depth.
\r
8440 This permits you to number major section levels and leave minor
\r
8441 section levels unnumbered.</para>
\r
8445 Added <parameter>footnote.sep.leader.properties</parameter> attribute set to format
\r
8446 the line separating footnotes in printed output.
\r
8451 Added parameter <parameter>img.src.path</parameter> as a prefix to HTML img src
\r
8453 The prefix is added to whatever path is already generated by the
\r
8454 stylesheet for each image file.</para>
\r
8458 Added new attribute-sets
\r
8459 <parameter>informalequation.properties</parameter>,
\r
8460 <parameter>informalexample.properties</parameter>,
\r
8461 <parameter>informalfigure.properties</parameter>, and <parameter>informaltable.properties</parameter>,
\r
8462 so each such element type can be formatted
\r
8463 individually if needed.
\r
8468 Add <parameter>component.label.includes.part.label</parameter>
\r
8469 parameter to add any part number to chapter, appendix
\r
8470 and other component labels when
\r
8471 the <parameter>label.from.part</parameter> parameter is nonzero.
\r
8472 This permits you to distinguish multiple chapters with the same
\r
8473 chapter number in cross references and the TOC.</para>
\r
8477 Added <parameter>chunk.separate.lots</parameter> parameter for HTML output.
\r
8478 This parameter lets you generate separate chunk files for each LOT
\r
8479 (list of tables, list of figures, etc.).</para>
\r
8482 <para>Added several table features:</para>
\r
8486 Added <parameter>table.table.properties</parameter> attribute set to add
\r
8487 properties to the fo:table element.
\r
8492 Added placeholder templates named <literal>table.cell.properties</literal>
\r
8493 and <literal>table.cell.block.properties</literal> to enable adding properties
\r
8494 to any <tag>fo:table-cell</tag> or the cell's <tag>fo:block</tag>, respectively.
\r
8495 These templates are a start for implementing table styles.</para>
\r
8501 Added new attribute
\r
8502 set <parameter>component.title.properties</parameter> for easy modifications of
\r
8503 component's title formatting in FO output.
\r
8508 Added Saxon support for an <tag class="attribute">encoding</tag> attribute on the <tag class="element">textdata</tag> element. Added new parameter
\r
8509 <parameter>textdata.default.encoding</parameter> which specifies encoding when
\r
8510 <tag class="attribute">encoding</tag> attribute on
\r
8511 <tag class="element">textdata</tag> is missing.
\r
8516 Template <literal>label.this.section</literal> now controls whole
\r
8517 section label, not only sub-label which corresponds to
\r
8518 particular label. Former behaviour was IMHO bug as it was
\r
8524 Formatting in titleabbrev for TOC and headers
\r
8525 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.
\r
8530 Added <literal>intial.page.number</literal> template to set the <literal>initial-page-number
\r
8531 property</literal> for page sequences in print output.
\r
8532 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.
\r
8537 Added <literal>force.page.count</literal> template to set the force-page-count
\r
8538 property for page sequences in print output.
\r
8539 This is similar to the <literal>format.page.number</literal> template.
\r
8544 Sort language for localized index sorting in <filename>autoidx-ng.xsl</filename> is now taken from document
\r
8545 lang, not from system environment.
\r
8550 Numbering and formatting of normal
\r
8551 and ulink footnotes (if turned on) has been unified.
\r
8552 Now ulink footnotes are mixed in with any other footnotes.</para>
\r
8556 Added support for <tag>renderas</tag> attribute in section and
\r
8558 This permits you to render a given section title as if it were a different level.</para>
\r
8562 Added support for <tag>label</tag> attribute in footnote to manually
\r
8563 supply the footnote mark.
\r
8568 Added support for DocBook 4.3 <tag>corpcredit</tag> element.
\r
8573 Added support for a <literal>dbfo keep-together</literal> PI for
\r
8574 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
\r
8575 is very long and the
\r
8576 default keep-together is not appropriate.
\r
8581 For graphics files, made file extension matching case
\r
8582 insensitive, and updated the list of graphics extensions.
\r
8587 Allow <tag>calloutlist</tag> to have block content before
\r
8593 Added <literal>dbfo-need</literal> processing instruction to provide
\r
8599 Added implementation of existing but unused
\r
8600 <parameter>default.image.width</parameter> parameter for graphics.
\r
8605 Support DocBook NG <tag>tag</tag> inline element.
\r
8610 It appears that XEP now supports Unicode characters in
\r
8611 bookmarks. There is no further need to strip accents from
\r
8617 Make <tag>segmentedlist</tag> HTML markup
\r
8618 more semantic and available to CSS styles.
\r
8623 Added <literal>user.preroot</literal> placeholder template to
\r
8624 permit xsl-stylesheet and other PIs and comments to be
\r
8625 output before the HTML root element.
\r
8630 Non-chunked legalnotice now gets an <a
\r
8631 name="id"> element in HTML output
\r
8632 so it can be referenced with xref or link.
\r
8637 In chunked HTML output, changed <literal>link rel="home"</literal> to <literal>rel="start"</literal>,
\r
8638 and <literal>link rel="previous"</literal> to <literal>rel="prev"</literal>, per W3C HTML 4.01
\r
8644 Added several patches to htmlhelp from W. Borgert
\r
8649 Added Bosnian locale file as common/bs.xml.
\r
8654 <sect1 xml:id="V1650">
\r
8655 <title>Release 1.65.0</title>
\r
8658 <para>A number of important bug fixes.
\r
8662 <para>Added a workaround to allow these stylesheets to process DocBook NG
\r
8663 documents. (It’s a hack that pre-processes the document to strip off the
\r
8664 namespace and then uses <function>exsl:node-set</function> to process
\r
8669 <para>Added alternative indexing mechanism which has better
\r
8670 internationalization support. New indexing method allows grouping of
\r
8671 accented letters like e, é, ë into the same group under letter "e". It
\r
8672 can also treat special letters (e.g. "ch") as one character and place
\r
8673 them in the correct position (e.g. between "h" and "i" in Czech
\r
8674 language).</para>
\r
8675 <para>In order to use this mechanism you must create customization
\r
8676 layer which imports some base stylesheet (like
\r
8677 <filename>fo/docbook.xsl</filename>,
\r
8678 <filename>html/chunk.xsl</filename>) and then includes appropriate
\r
8679 stylesheet with new indexing code
\r
8680 (<filename>fo/autoidx-ng.xsl</filename> or
\r
8681 <filename>html/autoidx-ng.xsl</filename>). For example:</para>
\r
8682 <programlisting><xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
\r
8685 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/>
\r
8686 <xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/>
\r
8688 </xsl:stylesheet></programlisting>
\r
8689 <para>New method is known to work with Saxon and it should also work
\r
8690 with xsltproc 1.1.1 and later. Currently supported languages are
\r
8691 English, Czech, German, French, Spanish and Danish.</para>
\r
8695 <sect1 xml:id="V1641">
\r
8696 <title>Release 1.64.1</title>
\r
8698 <para>General bug fixes and improvements. Sorry about the failure to produce
\r
8699 an updated release notes file for 1.62.0—1.63.2</para>
\r
8701 <para>In the course of fixing bug #849787, wrapping Unicode callouts
\r
8702 with an appropriate font change in the Xalan extensions, I discovered
\r
8703 that the Xalan APIs have changed a bit. So <filename>xalan2.jar</filename>
\r
8704 will work with older Xalan 2 implementations, <filename>xalan25.jar</filename>
\r
8705 works with Xalan 2.5.</para>
\r
8709 <sect1 xml:id="V1610">
\r
8710 <title>Release 1.61.0</title>
\r
8712 <para>Lots of bug fixes and improvements.</para>
\r
8714 <para>Initial support for timestamp PI. From now you
\r
8715 can use <?dbtimestamp format="Y-m-d H:M:S"?> to get current
\r
8716 datetime in your document. Added localization support for datetime PI
\r
8720 <para>Added level 6 to test for <tag>section</tag> depth in
\r
8721 section.level template so that
\r
8722 section.title.level6.properties will be used for sections
\r
8723 that are 6 deep or deeper. This should also cause a h6 to be
\r
8724 created in html output.
\r
8728 <para>Don't use SVG graphics if <parameter>use.svg</parameter>=0
\r
8732 <para>Now uses number-and-title-template for sections
\r
8733 only if <parameter>section.autolabel</parameter> is not zero.
\r
8737 <para>Added missing 'english-language-name' attribute to
\r
8738 the l10n element, and the missing 'style' attribute to the
\r
8739 template element so the current gentext documents will
\r
8744 <para>Corrected several references to parameter
\r
8745 <parameter>qanda.defaultlabel</parameter> that were missing the "$".
\r
8749 <para>Now accepts <parameter>admon.textlabel</parameter> parameter to turn off
\r
8750 Note, Warning, etc. label.
\r
8754 <para>FeatReq #684561: support more XEP metadata
\r
8758 <para>Added hyphenation support. Added support for <tag>coref</tag>.
\r
8759 Added <tag>beginpage</tag> support. (does nothing; see TDG).
\r
8763 <para>Added support for
\r
8764 hyphenation-character, hyphenation-push-character-count, and
\r
8765 hyphenation-remain-character-count
\r
8769 <para>Added <parameter>root.properties</parameter>,
\r
8770 <parameter>ebnf.assignment</parameter>,
\r
8771 and <parameter>ebnf.statement.terminator</parameter>
\r
8775 <para>Support bgcolor PI in table cells; make sure
\r
8776 rowsep and colsep don't have any effect on the last row or
\r
8781 <para>Handle <tag>othercredit</tag> on titlepage a little
\r
8786 <para>Applied fix from Jeff Beal that fixed the bug
\r
8787 that put secondary page numbers on primary entries. Same
\r
8788 with tertiary page numbers on secondary entries.
\r
8792 <para>Added definition of missing variable
\r
8793 <parameter>collection</parameter>.
\r
8797 <para>Make <tag>footnote</tag> formatting 'normal' even when it
\r
8798 occurs in a context that has special formatting
\r
8802 <para>Added warning when <parameter>glossary.collection</parameter> is not
\r
8803 blank, but it cannot open the specified file.
\r
8807 <para>Pick up the frame attribute on <tag>table</tag> and
\r
8808 <tag>informaltable</tag>.
\r
8812 <para><tag>indexdiv</tag>/<tag>title</tag>
\r
8813 in non-autogenerated indexes are
\r
8818 <para>Removed (unused)
\r
8819 component.title.properties
\r
8823 <para>Move IDs from
\r
8824 page-sequences down to titlepage blocks
\r
8829 proportional-column-width(1) on more <tag>table</tag>s.
\r
8831 <para>Use proportional-column-width() for
\r
8832 header/footer tables; suppress relative-align when when
\r
8837 <para>Check for <parameter>glossterm.auto.link</parameter> when linking
\r
8838 firstterms; don't output gl. prefix on glossterm links
\r
8842 <para>Generate Part ToCs
\r
8846 <para>Support <tag>glossary</tag>, <tag>bibliography</tag>,
\r
8847 and <tag>index</tag> in component ToCs.
\r
8851 <para>Refactored chunking code so that
\r
8852 customization of chunk algorithm and chunk elements is more
\r
8857 <para>Support <tag>textobject</tag>/<tag>phrase</tag>
\r
8858 on <tag>inlinemediaobject</tag>.
\r
8862 <para>Support 'start' PI on ordered lists
\r
8866 <para>Fixed test of $toc PI to turn on qandaset TOC.
\r
8870 <para>Added process.chunk.footnotes to sect2 through
\r
8871 5 to fix bug of missing footnotes when chunk level greater
\r
8877 paramater <parameter>toc.max.depth</parameter> which controls maximal depth of ToC
\r
8878 as requested by PHP-DOC group.
\r
8882 <para>Exempted <tag>titleabbrev</tag> from preamble processing in
\r
8883 lists, and fixed variablelist preamble code to use the same
\r
8884 syntax as the other lists.
\r
8888 <para>Added support for elements between variablelist
\r
8889 and first varlistentry since DocBook 4.2 supports that now.
\r
8894 <sect1 xml:id="V1601">
\r
8895 <title>Release 1.60.1</title>
\r
8897 <para>Lots of bug fixes.</para>
\r
8899 <para>The format of the <filename>titlepage.templates.xml</filename> files and
\r
8900 the stylesheet that transforms them have been significantly changed. All of the
\r
8901 attributes used to control the templates are now namespace qualified. So what
\r
8902 used to be:</para>
\r
8903 <programlisting><t:titlepage element="article" wrapper="fo:block"></programlisting>
\r
8904 <para>is now:</para>
\r
8905 <programlisting><t:titlepage t:element="article" t:wrapper="fo:block"></programlisting>
\r
8906 <para>Attributes from other namespaces (including those that are unqualified) are
\r
8907 now copied directly through. In practice, this means that the names that used
\r
8908 to be <quote>fo:</quote> qualified:</para>
\r
8909 <programlisting><title named-template="component.title"
\r
8910 param:node="ancestor-or-self::article[1]"
\r
8911 fo:text-align="center"
\r
8912 fo:keep-with-next="always"
\r
8913 fo:font-size="&hsize5;"
\r
8914 fo:font-weight="bold"
\r
8915 fo:font-family="{$title.font.family}"/></programlisting>
\r
8916 <para>are now unqualified:</para>
\r
8917 <programlisting><title t:named-template="component.title"
\r
8918 param:node="ancestor-or-self::article[1]"
\r
8919 text-align="center"
\r
8920 keep-with-next="always"
\r
8921 font-size="&hsize5;"
\r
8922 font-weight="bold"
\r
8923 font-family="{$title.font.family}"/></programlisting>
\r
8924 <para>The <tag>t:titlepage</tag> and <tag>t:titlepage-content</tag>
\r
8925 elements both generate wrappers now. And unqualified attributes on those elements
\r
8926 are passed through. This means that you can now make the title font apply to
\r
8927 ane entire titlepage and make the entire <quote>recto</quote>
\r
8928 titlepage centered by specifying the font and alignment on the those elements:</para>
\r
8929 <programlisting><t:titlepage t:element="article" t:wrapper="fo:block"
\r
8930 font-family="{$title.font.family}">
\r
8932 <t:titlepage-content t:side="recto"
\r
8933 text-align="center"></programlisting>
\r
8941 <para>Support use of <tag>titleabbrev</tag> in running
\r
8942 headers and footers.
\r
8946 <para>Added (experimental) <parameter>xref.with.number.and.title</parameter>
\r
8947 parameter to enable number/title cross references even when the
\r
8949 be just the number.
\r
8953 <para>Generate <tag>part</tag> ToCs if they're requested.
\r
8957 <para>Use proportional-column-width() in header/footer tables.
\r
8961 <para>Handle alignment correctly when <tag>screenshot</tag>
\r
8962 wraps a graphic in a <tag>figure</tag>.
\r
8966 <para>Format <tag>chapter</tag> and <tag>appendix</tag>
\r
8967 cross references consistently.
\r
8971 <para>Attempt to support tables with multiple <tag>tgroup</tag>s
\r
8976 <para>Output <tag>fo:table-columns</tag> in
\r
8977 <tag>simplelist</tag> tables.
\r
8981 <para>Use <filename>titlepage.templates.xml</filename> for
\r
8982 <tag>indexdiv</tag> and <tag>glossdiv</tag> formatting.
\r
8986 <para>Improve support for new bibliography elements.
\r
8991 <parameter>footnote.number.format</parameter>,
\r
8992 <parameter>table.footnote.number.format</parameter>,
\r
8993 <parameter>footnote.number.symbols</parameter>, and
\r
8994 <parameter>table.footnote.number.symbols</parameter> for better control of
\r
8999 <para>Added <tag>glossentry.show.acronyms</tag>.
\r
9003 <para>Suppress the draft-mode page masters when
\r
9004 <parameter>draft-mode</parameter> is <quote>no</quote>.
\r
9008 <para>Make blank pages verso not recto. D'Oh!
\r
9012 <para>Improved formatting of <tag>ulink</tag> footnotes.
\r
9016 <para>Fixed bugs in graphic width/height calculations.
\r
9020 <para>Added class attributes to inline elements.
\r
9024 <para>Don't add <quote>.html</quote> to the filenames identified
\r
9025 with the <quote>dbhtml</quote> PI.
\r
9029 <para>Don't force a ToC when sections contain <tag>refentry</tag>s.
\r
9033 <para>Make section title sizes a function of the
\r
9034 <parameter>body.master.size</parameter>.
\r
9039 <sect1 xml:id="V1592">
\r
9040 <title>Release 1.59.2</title>
\r
9042 <para>The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail.
\r
9045 <para>Removed the region-name from the region-body of blank pages. There's
\r
9046 no reason to give the body of blank pages a unique name and doing so causes
\r
9047 a mismatch that FOP detects.
\r
9051 <para>Output IDs for the first paragraphs in listitems.
\r
9055 <para>Fixed some small bugs in the handling of page numbers in double-sided mode.
\r
9059 <para>Attempt to prevent duplicated IDs from being produced when
\r
9060 <tag class="attribute">endterm</tag> on <tag>xref</tag> points
\r
9061 to something with nested structure.
\r
9065 <para>Fix aligment problems in <tag>equation</tag>s.
\r
9069 <para>Output the type attribute on unordered lists (UL) in HTML only if
\r
9070 the css.decoration parameter is true.
\r
9074 <para>Calculate the font size in formal.title.properties so that it's 1.2 times
\r
9075 the base font size, not a fixed "12pt".
\r
9080 <sect1 xml:id="V1591">
\r
9081 <title>Release 1.59.1</title>
\r
9083 <para>The 1.59.1 fixes a few bugs.
\r
9086 <para>Added Bulgarian localization.
\r
9090 <para>Indexing improvements; localize book indexes to books but allow setindex
\r
9091 to index an entire set.
\r
9095 <para>The default value for rowsep and colsep is now "1" as per CALS.
\r
9099 <para>Added support for <tag>titleabbrev</tag> (use them for cross
\r
9104 <para>Improvements to <tag>mediaobject</tag> for selecting print vs. online
\r
9109 <para>Added seperate property sets for <tag>figure</tag>s,
\r
9110 <tag>example</tag>s, <tag>equation</tag>s, <tag>tables</tag>s,
\r
9111 and <tag>procedure</tag>s.
\r
9115 <para>Make <tag>lineannotation</tag>s italic.
\r
9119 <para>Support <tag class="attribute">xrefstyle</tag> attribute.
\r
9123 <para>Make <tag class="attribute">endterm</tag> on
\r
9124 <tag>xref</tag> higher priority than
\r
9125 <tag class="attribute">xreflabel</tag> target.
\r
9129 <para>Glossary formatting improvements.
\r
9134 <sect1 xml:id="V1580">
\r
9135 <title>Release 1.58.0</title>
\r
9137 <para>The 1.58.0 adds some initial support for extensions in xsltproc, adds
\r
9138 a few features, and fixes bugs.
\r
9141 <para>This release contains the first attempt at extension support for xsltproc.
\r
9142 The only extension available to date is the one that adjusts table column widths.
\r
9143 Run <filename>extensions/xsltproc/python/xslt.py</filename>.
\r
9147 <para>Fixed bugs in calculation of adjusted column widths to correct for rounding
\r
9152 <para>Support nested <tag>refsection</tag> elements correctly.
\r
9156 <para>Reworked <literal>gentext.template</literal> to take context into consideration.
\r
9157 The name of elements in localization files is now an xpath-like context list, not
\r
9158 just a simple name.
\r
9162 <para>Made some improvements to bibliography formatting.
\r
9166 <para>Improved graphical formatting of admonitions.
\r
9170 <para>Added support for <tag>entrytbl</tag>.
\r
9174 <para>Support spanning index terms.
\r
9178 <para>Support <tag>bibliosource</tag>.
\r
9183 <sect1 xml:id="V1570">
\r
9184 <title>Release 1.57.0</title>
\r
9187 <para>The 1.57.0 release wasn't documented here. Oops.
\r
9192 <sect1 xml:id="V1560">
\r
9193 <title>Release 1.56.0</title>
\r
9195 <para>The 1.56.0 release fixes bugs.
\r
9198 <para>Reworked chunking. <emphasis>This will break all existing customizations
\r
9199 layers that change the chunking algorithm.</emphasis> If you're customizing chunking,
\r
9200 look at the new <quote>content</quote> parameter that's passed to
\r
9201 <literal>process-chunk-element</literal> and friends.
\r
9205 <para>Support continued and inherited numeration in <tag>orderedlist</tag>
\r
9206 formatting for FOs.
\r
9210 <para>Added Thai localization.
\r
9214 <para>Tweaked stylesheet documentation stylesheets to link to TDG and
\r
9215 the parameter references.
\r
9219 <para>Allow title on tables of contents ("Table of Contents") to be optional.
\r
9220 Added new keyword to <parameter>generate.toc</parameter>.
\r
9221 Support tables of contents on sections.
\r
9225 <para>Made separate parameters for table borders and table cell borders:
\r
9226 <parameter>table.frame.border.color</parameter>,
\r
9227 <parameter>table.frame.border.style</parameter>,
\r
9228 <parameter>table.frame.border.thickness</parameter>,
\r
9229 <parameter>table.cell.border.color</parameter>,
\r
9230 <parameter>table.cell.border.style</parameter>, and
\r
9231 <parameter>table.cell.border.thickness</parameter>.
\r
9235 <para>Suppress formatting of <quote>endofrange</quote> <tag>indexterm</tag>s.
\r
9236 This is only half-right. They should generate a range, but I haven't figured out how
\r
9241 <para>Support <tag>revdescription</tag>. (Bug #582192)
\r
9245 <para>Added <parameter>default.float.class</parameter> and fixed figure
\r
9246 floats. (Bug #497603)
\r
9250 <para>Fixed formatting of <tag>sbr</tag> in FOs.
\r
9254 <para>Added context to the <quote>missing template</quote> error message.
\r
9258 <para>Process <tag>arg</tag> correctly in a <tag>group</tag>.
\r
9263 <para>Removed 'keep-with-next' from <parameter>formal.title.properties</parameter>
\r
9264 attribute set now that the stylesheets support the option of putting
\r
9265 such titles below the object. Now the $placement value determines if
\r
9266 'keep-with-next' or 'keep-with-previous' is used in the title block.
\r
9270 <para>Wrap <quote>url()</quote> around external-destinations when appropriate.
\r
9274 <para>Fixed typo in compact list spacing. (Bug #615464)
\r
9278 <para>Removed spurious hash in anchor name. (Bug #617717)
\r
9282 <para>Address is now displayed verbatim on title pages. (Bug #618600)
\r
9286 <para>The <parameter>bridgehead.in.toc</parameter> parameter is now properly
\r
9291 <para>Improved effectiveness of HTML cleanup by increasing the number
\r
9292 of places where it is used. Improve use of HTML cleanup in XHTML stylesheets.
\r
9296 <para>Support table of contents for <tag>appendix</tag> in
\r
9297 <tag>article</tag>. (Bug #596599)
\r
9301 <para>Don't duplicate footnotes in <tag>bibliography</tag>s and
\r
9302 <tag>glossary</tag>s. (Bug #583282)
\r
9306 <para>Added <parameter>default.image.width</parameter>. (Bug #516859)
\r
9310 <para>Totally reworked <tag>funcsynopsis</tag> code; it now
\r
9311 supports a 'tabular' presentation style for 'wide' prototypes; see
\r
9312 <parameter>funcsynopsis.tabular.threshold</parameter>. (HTML only
\r
9313 right now, I think, FO support, uh, real soon now.)
\r
9317 <para>Reworked support for difference marking; toned down the colors a bit
\r
9318 and added a <quote>system.head.content</quote> template so that the diff CSS
\r
9319 wasn't overriding <quote>user.head.content</quote>. (Bug #610660)
\r
9323 <para>Added call to the <quote>*.head.content</quote> elements when writing
\r
9324 out long description chunks.
\r
9328 <para>Make sure <tag>legalnotice</tag> link is correct even when
\r
9329 chunking to a different <parameter>base.dir</parameter>.
\r
9333 <para>Use CSS to set viewport characteristics if
\r
9334 <parameter>css.decoration</parameter> is non-zero, use div instead of p for making
\r
9335 graphic a block element; make figure <tag>title</tag>s the
\r
9337 text for images in a <tag>figure</tag>.</para>
\r
9340 <para>Added space-after to <parameter>list.block.spacing</parameter>.
\r
9344 <para>Reworked section.level template to give <quote>correct</quote> answer
\r
9345 instead of being off by one.
\r
9349 <para>When processing tables, use the <tag class="attribute">tabstyle</tag>
\r
9350 attribute as the division class.
\r
9354 <para>Fixed bug in <filename>html2xhtml.xsl</filename> that was causing the
\r
9355 XHTML chunker to output HTML instead of XHTML.
\r
9360 <sect1 xml:id="VOlder">
\r
9361 <title>Older releases</title>
\r
9362 <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
\r
9363 aware that there were no release notes for releases prior to the
\r
9364 1.50.0 release.</para>
\r
9366 <sect1 xml:id="dot0">
\r
9367 <title>About dot-zero releases</title>
\r
9368 <para>DocBook Project “dot zero” releases should be
\r
9369 considered <emphasis>experimental</emphasis> and are always
\r
9370 followed by stable “dot one plus” releases, usually within
\r
9371 two or three weeks. Please help to ensure the stability of
\r
9372 “dot one plus” releases by carefully testing each
\r
9373 “dot zero” release and reporting back about any
\r
9374 problems you find. </para>
\r
9375 <para>It is not recommended that you use a “dot zero”
\r
9376 release in a production system. Instead, you should wait for
\r
9377 the “dot one” or greater versions.</para>
\r
projects / working / Evergreen.git / blob