RELEASE-NOTES.xml

   1 <article xmlns="http://docbook.org/ns/docbook"
   2   xmlns:xlink="http://www.w3.org/1999/xlink"
   3   xmlns:xi="http://www.w3.org/2001/XInclude"
   4   xml:lang="en" xml:id="releasenotes"
   5   version="5.0">
   6
   7 <info>
   8   <title>Release Notes for the DocBook XSL Stylesheets</title>
   9   <pubdate><?dbtimestamp format="Y-m-d"?></pubdate>
  10   <releaseinfo role="cvs">$Revision: 9401 $ $Date: 2012-06-04 21:47:26 +0000 (Mon, 04 Jun 2012) $</releaseinfo>
  11   <!-- * <author><orgname>DocBook Project Development Team</orgname></author> -->
  12 <abstract>
  13 <para condition="dot-zero;dot-one-plus">This release-notes
  14   document is available in the following formats:
  15   <link
  16     xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.html"
  17     >HTML</link>,
  18   <link
  19     xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.pdf"
  20     >PDF</link>,
  21   <link
  22     xlink:href="http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.txt"
  23     >plain text</link>; it provides a per-release list
  24 of enhancements and changes to the stylesheets’ public APIs
  25 (user-configurable parameters) and excludes descriptions of most
  26 bug fixes. For a complete list of all changes (including all bug
  27 fixes) that have been made since the previous release, see the
  28 separate <link xlink:href="NEWS">NEWS</link> (plain text) or <link
  29   xlink:href="NEWS.html">NEWS.html</link> files. Also available:
  30 An online <link
  31   xlink:href="http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/xsl/?view=log"
  32   >hyperlinked change history</link> (warning: big file) of all
  33 changes made over the entire history of the codebase.</para>
  34 <para condition="dot-zero">As with all DocBook Project <link
  35     linkend="dot0">dot-zero</link> releases, this is an
  36   experimental release. It will be followed shortly by a stable
  37   release.</para>
  38 <para condition="dot-one-plus">As with all DocBook Project “dot
  39   one plus” releases, this release aspires to be stable (in
  40   contrast to <link linkend="dot0">dot-zero</link> releases, which
  41   are experimental).</para>
  42 <para condition="snapshot">This is a pre-release “snapshot” of the
  43 DocBook XSL Stylesheets. The change information in the first
  44 section of this file
  45 (for “<xi:include href="NEWS.xml" xpointer="xpointer(/article/sect1/title/text())"/>”) is
  46 auto-generated from change descriptions stored in the project
  47 source-code repository.</para>
  48 <para condition="snapshot">That means the first section contains
  49 descriptions both of bug fixes and of feature changes. The
  50 remaining sections are manually edited changelog subsets that
  51 exclude bug-fix descriptions – that is, trimmed down to just those
  52 those descriptions that document enhancements and changes to the
  53 public APIs (user-configurable parameters).</para>
  54 </abstract>
  55 </info>
  56
  57 <sect1 condition="snapshot" xml:id="current">
  58   <xi:include href="NEWS.xml" xpointer="xpointer(/article/sect1/*)"/>
  59 </sect1>
  60
  61 <sect1 xml:id="V1.78.1">
  62 <title>Release Notes: 1.78.1</title>
  63 <para>The following is a list of changes that have been made
  64         since the 1.78.0 release.</para>
  65
  66 <sect2 xml:id="V1.78.1_Common">
  67 <title>Common</title>
  68 <para>The following changes have been made to the
  69             <filename>common</filename> code
  70             since the 1.78.0 release.</para>
  71 <itemizedlist>
  72 <listitem>
  73 <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Make sure part and set <tag>titleabbrev</tag> are used in mode="titleabbrev.markup"</phrase></screen>
  74 </listitem>
  75 <listitem>
  76 <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Add empty default template for <tag>titleabbrev</tag> since it is always processed in a mode.</phrase></screen>
  77 </listitem>
  78 <listitem>
  79 <para><literal>Robert Stayton: gentext.xsl</literal></para><screen><phrase role="commit-message">Make consistent handling of <tag>titleabbrev</tag> in xrefs.</phrase></screen>
  80 </listitem>
  81 <listitem>
  82 <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">for missing <tag>title</tag> in <tag>xref</tag>, provide parent information of target to help locate problem element.
  83 Process <tag>bridgehead</tag> in mode="title.markup", not normal mode.</phrase></screen>
  84 </listitem>
  85 <listitem>
  86 <para><literal>Jirka Kosek: l10n.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #3598963</phrase></screen>
  87 </listitem>
  88 <listitem>
  89 <para><literal>Robert Stayton: gentext.xsl; labels.xsl</literal></para><screen><phrase role="commit-message">Make sure bridgeheads are not numbered in all contexts, including html <tag>title</tag> attributes.</phrase></screen>
  90 </listitem>
  91 </itemizedlist>
  92 </sect2><!--end of Common changes for 1.78.1-->
  93
  94 <sect2 xml:id="V1.78.1_FO">
  95 <title>FO</title>
  96 <para>The following changes have been made to the
  97             <filename>fo</filename> code
  98             since the 1.78.0 release.</para>
  99 <itemizedlist>
 100 <listitem>
 101 <para><literal>Robert Stayton: division.xsl</literal></para><screen><phrase role="commit-message">Fix bug where part <tag>TOC</tag> not generated when <tag>partintro</tag> is present.</phrase></screen>
 102 </listitem>
 103 <listitem>
 104 <para><literal>Jirka Kosek: xref.xsl</literal></para><screen><phrase role="commit-message">Footnotes can't be placed into fo:float</phrase></screen>
 105 </listitem>
 106 <listitem>
 107 <para><literal>Robert Stayton: titlepage.templates.xml</literal></para><screen><phrase role="commit-message">Remove margin-left when start-indent is used because they interfere
 108 with each other.</phrase></screen>
 109 </listitem>
 110 <listitem>
 111 <para><literal>Robert Stayton: fo.xsl; pagesetup.xsl</literal></para><screen><phrase role="commit-message">Use dingbat.fontset rather than <parameter>dingbat.font.family</parameter> so it falls
 112 back to <tag>symbol</tag> font if glyph not found, like other font properties.</phrase></screen>
 113 </listitem>
 114 <listitem>
 115 <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Change last instance of inline.charseq in inline <tag>glossterm</tag> to
 116 inline.italicseq so it is consistent with the others.</phrase></screen>
 117 </listitem>
 118 <listitem>
 119 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Make consistent handling of <tag>titleabbrev</tag> in xrefs.</phrase></screen>
 120 </listitem>
 121 </itemizedlist>
 122 </sect2><!--end of FO changes for 1.78.1-->
 123
 124 <sect2 xml:id="V1.78.1_HTML">
 125 <title>HTML</title>
 126 <para>The following changes have been made to the
 127             <filename>html</filename> code
 128             since the 1.78.0 release.</para>
 129 <itemizedlist>
 130 <listitem>
 131 <para><literal>Robert Stayton: admon.xsl</literal></para><screen><phrase role="commit-message">Turn off $admon.style if $make.clean.html is set to non-zero.</phrase></screen>
 132 </listitem>
 133 <listitem>
 134 <para><literal>Jirka Kosek: highlight.xsl</literal></para><screen><phrase role="commit-message">Added new definitions for syntax highlighting</phrase></screen>
 135 </listitem>
 136 <listitem>
 137 <para><literal>Robert Stayton: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Make active.olink.hrefs param work for chunked output too.</phrase></screen>
 138 </listitem>
 139 <listitem>
 140 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Make consistent handling of <tag>titleabbrev</tag> in xrefs.</phrase></screen>
 141 </listitem>
 142 <listitem>
 143 <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Add round() <tag>function</tag> when pixel counts are used for image width and height.</phrase></screen>
 144 </listitem>
 145 <listitem>
 146 <para><literal>Robert Stayton: glossary.xsl</literal></para><screen><phrase role="commit-message">fix missing class and id attributes on <tag>glossterm</tag> and <tag>glossdef</tag>.</phrase></screen>
 147 </listitem>
 148 <listitem>
 149 <para><literal>Robert Stayton: autoidx.xsl</literal></para><screen><phrase role="commit-message">Fix bug where prefer.index.titleabbrev ignored <tag>info</tag>/<tag>titleabbrev</tag>.</phrase></screen>
 150 </listitem>
 151 </itemizedlist>
 152 </sect2><!--end of HTML changes for 1.78.1-->
 153
 154 <sect2 xml:id="V1.78.1_Manpages">
 155 <title>Manpages</title>
 156 <para>The following changes have been made to the
 157             <filename>manpages</filename> code
 158             since the 1.78.0 release.</para>
 159 <itemizedlist>
 160 <listitem>
 161 <para><literal>Robert Stayton: utility.xsl</literal></para><screen><phrase role="commit-message">Fix bug 3599520: spurious newline in <tag>para</tag> when starts with
 162 whitespace and inline element.</phrase></screen>
 163 </listitem>
 164 </itemizedlist>
 165 </sect2><!--end of Manpages changes for 1.78.1-->
 166
 167 <sect2 xml:id="V1.78.1_Webhelp">
 168 <title>Webhelp</title>
 169 <para>The following changes have been made to the
 170             <filename>webhelp</filename> code
 171             since the 1.78.0 release.</para>
 172 <itemizedlist>
 173 <listitem>
 174 <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Fix test for <parameter>webhelp.include.search.tab</parameter> param</phrase></screen>
 175 </listitem>
 176 <listitem>
 177 <para><literal>David Cramer: Makefile.sample</literal></para><screen><phrase role="commit-message">Webhelp: Fix order of args to xsltproc</phrase></screen>
 178 </listitem>
 179 <listitem>
 180 <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: Turn on xinclude-test.xml in readme to demo xinclude functionality</phrase></screen>
 181 </listitem>
 182 <listitem>
 183 <para><literal>David Cramer: Makefile; Makefile.sample</literal></para><screen><phrase role="commit-message">Webhelp: In Makefiles, do xinclude in first pass at document</phrase></screen>
 184 </listitem>
 185 </itemizedlist>
 186 </sect2><!--end of Webhelp changes for 1.78.1-->
 187
 188 <sect2 xml:id="V1.78.1_Params">
 189 <title>Params</title>
 190 <para>The following changes have been made to the
 191             <filename>params</filename> code
 192             since the 1.78.0 release.</para>
 193 <itemizedlist>
 194 <listitem>
 195 <para><literal>David Cramer: webhelp.include.search.tab.xml</literal></para><screen><phrase role="commit-message">Webhelp: Fix test for <parameter>webhelp.include.search.tab</parameter> param</phrase></screen>
 196 </listitem>
 197 <listitem>
 198 <para><literal>Robert Stayton: article.appendix.title.properties.xml</literal></para><screen><phrase role="commit-message">Remove unneeded margin-left property from <tag>article</tag> <tag>appendix</tag> <tag>title</tag>.
 199 It interferes with the start-indent property.</phrase></screen>
 200 </listitem>
 201 </itemizedlist>
 202 </sect2><!--end of Params changes for 1.78.1-->
 203
 204 <sect2 xml:id="V1.78.1_Highlighting">
 205 <title>Highlighting</title>
 206 <para>The following changes have been made to the
 207             <filename>highlighting</filename> code
 208             since the 1.78.0 release.</para>
 209 <itemizedlist>
 210 <listitem>
 211 <para><literal>Jirka Kosek: c-hl.xml; cpp-hl.xml; sql2003-hl.xml; php-hl.xml; upc-hl.xml; bourne-hl.xml; ⋯</literal></para><screen><phrase role="commit-message">Added new definitions for syntax highlighting</phrase></screen>
 212 </listitem>
 213 </itemizedlist>
 214 </sect2><!--end of Highlighting changes for 1.78.1-->
 215
 216 </sect1>
 217 <sect1 xml:id="V1.78.0">
 218 <title>Release Notes: 1.78.0</title>
 219 <para>The following is a list of changes that have been made
 220         since the 1.77.1 release.</para>
 221
 222 <sect2 xml:id="V1.78.0_Gentext">
 223 <title>Gentext</title>
 224 <para>The following changes have been made to the
 225             <filename>gentext</filename> code
 226             since the 1.77.1 release.</para>
 227 <itemizedlist>
 228 <listitem>
 229 <para><literal>Mauritz Jeanson: locale/nn.xml; locale/nb.xml</literal></para><screen><phrase role="commit-message">Bug #3556630: Updated nb and nn locale files.</phrase></screen>
 230 </listitem>
 231 <listitem>
 232 <para><literal>Mauritz Jeanson: locale/README</literal></para><screen><phrase role="commit-message">Bug #3556628: Updated information in README.</phrase></screen>
 233 </listitem>
 234 <listitem>
 235 <para><literal>tom_schr: locale/de.xml</literal></para><screen><phrase role="commit-message">Added <tag>keycap</tag> context from RFE#3540451 to support @function attribute</phrase></screen>
 236 </listitem>
 237 <listitem>
 238 <para><literal>tom_schr: locale/en.xml</literal></para><screen><phrase role="commit-message">Added <tag>keycap</tag> context from RFE#3540451 to support @function attribute</phrase></screen>
 239 </listitem>
 240 <listitem>
 241 <para><literal>Robert Stayton: locale/en.xml</literal></para><screen><phrase role="commit-message">Add support for <tag>title</tag> element in <tag>screenshot</tag>, now allowed in DocBook 5.</phrase></screen>
 242 </listitem>
 243 </itemizedlist>
 244 </sect2><!--end of Gentext changes for 1.78.0-->
 245
 246 <sect2 xml:id="V1.78.0_Common">
 247 <title>Common</title>
 248 <para>The following changes have been made to the
 249             <filename>common</filename> code
 250             since the 1.77.1 release.</para>
 251 <itemizedlist>
 252 <listitem>
 253 <para><literal>Robert Stayton: titles.xsl</literal></para><screen><phrase role="commit-message">Corrected template for <tag>bridgehead</tag> in mode="title.markup" to
 254 process its children in normal mode.</phrase></screen>
 255 </listitem>
 256 <listitem>
 257 <para><literal>Robert Stayton: labels.xsl</literal></para><screen><phrase role="commit-message">Convert hard wired xsl:number for <tag>production</tag> into a template
 258 with mode="label.markup" to be consistent with other element numbering.</phrase></screen>
 259 </listitem>
 260 <listitem>
 261 <para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Remove all references and code for obsolete <tag>olink</tag> attributes
 262 @linkmode @targetdocent and @localinfo.</phrase></screen>
 263 </listitem>
 264 <listitem>
 265 <para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Add parameter '<parameter>activate.external.olinks</parameter>' to allow making
 266 external olinks inactive, as for epub output.</phrase></screen>
 267 </listitem>
 268 </itemizedlist>
 269 </sect2><!--end of Common changes for 1.78.0-->
 270
 271 <sect2 xml:id="V1.78.0_FO">
 272 <title>FO</title>
 273 <para>The following changes have been made to the
 274             <filename>fo</filename> code
 275             since the 1.77.1 release.</para>
 276 <itemizedlist>
 277 <listitem>
 278 <para><literal>Robert Stayton: pagesetup.xsl</literal></para><screen><phrase role="commit-message">Change initial page number for <tag>book</tag> from 1 to auto so front
 279 <tag>cover</tag> and <tag>title</tag> pages are sequential, and so that <tag>book</tag> inside
 280 set will continue numbering.</phrase></screen>
 281 </listitem>
 282 <listitem>
 283 <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Add missing closing <tag>tag</tag> for xsl:choose in new template.</phrase></screen>
 284 </listitem>
 285 <listitem>
 286 <para><literal>Robert Stayton: param.xweb; param.ent; pagesetup.xsl</literal></para><screen><phrase role="commit-message">Add <parameter>force.blank.pages</parameter> parameter to allow turning off blank
 287 pages in <parameter>double.sided</parameter> output.</phrase></screen>
 288 </listitem>
 289 <listitem>
 290 <para><literal>Robert Stayton: lists.xsl; callout.xsl</literal></para><screen><phrase role="commit-message">Implement active links between <tag>co</tag> and <tag>callout</tag> elements for
 291 PDF output, linking in both directions.</phrase></screen>
 292 </listitem>
 293 <listitem>
 294 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Fix typo to replace "ro" with "<tag>row</tag>" in three places.</phrase></screen>
 295 </listitem>
 296 <listitem>
 297 <para><literal>Robert Stayton: ebnf.xsl</literal></para><screen><phrase role="commit-message">Convert hard wired xsl:number for <tag>production</tag> into a template
 298 with mode="label.markup" to be consistent with other element numbering.</phrase></screen>
 299 </listitem>
 300 <listitem>
 301 <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Make comma inserted after <tag>function</tag>/parameter or <tag>function</tag>/<tag>replaceable</tag>
 302 conditional on $function.parens to be consistent with the <tag>function</tag> template.</phrase></screen>
 303 </listitem>
 304 <listitem>
 305 <para><literal>tom_schr: inline.xsl</literal></para><screen><phrase role="commit-message">Added new inline.sansseq template for consistency reasons.
 306 Makes it easier for customization layers: Just use
 307   &lt;xsl:call-template name="inline.sansseq"/&gt;
 308 to change to sans serif font, but also takes into account
 309 XLinks and direction of text.</phrase></screen>
 310 </listitem>
 311 <listitem>
 312 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Remove all references and code for obsolete <tag>olink</tag> attributes
 313 @linkmode @targetdocent and @localinfo.</phrase></screen>
 314 </listitem>
 315 <listitem>
 316 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Remove <parameter>passivetex.extensions</parameter> code.</phrase></screen>
 317 </listitem>
 318 <listitem>
 319 <para><literal>Robert Stayton: spaces.xsl; autotoc.xsl; docbook.xsl; division.xsl; table.xsl; sections.xs⋯</literal></para><screen><phrase role="commit-message">Remove all passivetex code because it is obsolete.</phrase></screen>
 320 </listitem>
 321 <listitem>
 322 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add parameter '<parameter>activate.external.olinks</parameter>' to allow making
 323 external olinks inactive, as for epub output.</phrase></screen>
 324 </listitem>
 325 <listitem>
 326 <para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">Added support for keep-together PI on <tag>informaltable</tag>. Closes bug #3555609.</phrase></screen>
 327 </listitem>
 328 <listitem>
 329 <para><literal>tom_schr: verbatim.xsl</literal></para><screen><phrase role="commit-message">Fixed subtle typo when calling lastLineNumber template: must be $listing instead of listing</phrase></screen>
 330 </listitem>
 331 <listitem>
 332 <para><literal>tom_schr: autoidx.xsl</literal></para><screen><phrase role="commit-message">Fixed typo: fole -&gt; role attribute for <tag>phrase</tag></phrase></screen>
 333 </listitem>
 334 <listitem>
 335 <para><literal>tom_schr: inline.xsl</literal></para><screen><phrase role="commit-message">Added support for @function attribute in <tag>keycap</tag> (uses <tag>keycap</tag> context
 336 from language files) =&gt; fixes RFE#3540451
 337 If @function is set and <tag>keycap</tag> is empty, then template will use the
 338 content from the <tag>keycap</tag> context, otherwise it will use just the given
 339 text</phrase></screen>
 340 </listitem>
 341 <listitem>
 342 <para><literal>Robert Stayton: graphics.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>title</tag> element in <tag>screenshot</tag>, now allowed in DocBook 5.</phrase></screen>
 343 </listitem>
 344 <listitem>
 345 <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Restore formatting of <tag>figure</tag>/<tag>caption</tag> that was broken in 1.77.1.</phrase></screen>
 346 </listitem>
 347 </itemizedlist>
 348 </sect2><!--end of FO changes for 1.78.0-->
 349
 350 <sect2 xml:id="V1.78.0_HTML">
 351 <title>HTML</title>
 352 <para>The following changes have been made to the
 353             <filename>html</filename> code
 354             since the 1.77.1 release.</para>
 355 <itemizedlist>
 356 <listitem>
 357 <para><literal>David Cramer: autotoc.xsl</literal></para><screen><phrase role="commit-message">Fixing bug where toc.title.p and nodes params had not been declared inside manual-toc template</phrase></screen>
 358 </listitem>
 359 <listitem>
 360 <para><literal>Robert Stayton: autotoc.xsl</literal></para><screen><phrase role="commit-message">Add 'toc.list.attributes' template to insert class and other
 361 attributes on the top level list element in a <tag>table</tag> of contents.</phrase></screen>
 362 </listitem>
 363 <listitem>
 364 <para><literal>Robert Stayton: block.xsl</literal></para><screen><phrase role="commit-message">Fix bug 3590039 <tag>abstract</tag>/<tag>title</tag> not rendered.</phrase></screen>
 365 </listitem>
 366 <listitem>
 367 <para><literal>Jirka Kosek: chunk-common.xsl; footnote.xsl</literal></para><screen><phrase role="commit-message">Fixed positioning of <tag>footnote</tag> separate when CSS decoration is used.</phrase></screen>
 368 </listitem>
 369 <listitem>
 370 <para><literal>Robert Stayton: ebnf.xsl</literal></para><screen><phrase role="commit-message">Convert hard wired xsl:number for <tag>production</tag> into a template
 371 with mode="label.markup" to be consistent with other element numbering.</phrase></screen>
 372 </listitem>
 373 <listitem>
 374 <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Make comma inserted after <tag>function</tag>/parameter or <tag>function</tag>/<tag>replaceable</tag>
 375 conditional on $function.parens to be consistent with the <tag>function</tag> template.</phrase></screen>
 376 </listitem>
 377 <listitem>
 378 <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>mediaobject</tag>/<tag>alt</tag>, with precedence over
 379 <tag>mediaobject</tag>/<tag>textobject</tag>/<tag>phrase</tag>.</phrase></screen>
 380 </listitem>
 381 <listitem>
 382 <para><literal>Robert Stayton: param.xweb</literal></para><screen><phrase role="commit-message">Remove src:fragref elements for deleted obsolete <tag>olink</tag> params.</phrase></screen>
 383 </listitem>
 384 <listitem>
 385 <para><literal>Robert Stayton: chunker.xsl</literal></para><screen><phrase role="commit-message">Fix bug #3563697 where template make-relative-filename was using a
 386 global param chunk.base.dir instead of its local param <parameter>base.dir</parameter>.  Now it uses <parameter>base.dir</parameter>.</phrase></screen>
 387 </listitem>
 388 <listitem>
 389 <para><literal>Robert Stayton: param.xweb; param.ent; xref.xsl</literal></para><screen><phrase role="commit-message">Remove all references and code for obsolete <tag>olink</tag> attributes
 390 @linkmode @targetdocent and @localinfo.</phrase></screen>
 391 </listitem>
 392 <listitem>
 393 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add parameter '<parameter>activate.external.olinks</parameter>' to allow making
 394 external olinks inactive, as for epub output.</phrase></screen>
 395 </listitem>
 396 <listitem>
 397 <para><literal>stefan: graphics.xsl</literal></para><screen><phrase role="commit-message">Add hook for customization.</phrase></screen>
 398 </listitem>
 399 <listitem>
 400 <para><literal>tom_schr: docbook.xsl</literal></para><screen><phrase role="commit-message">Splitting head.content into smaller chunks of templates.
 401 See https://lists.oasis-open.org/archives/docbook-apps/201209/msg00037.html</phrase></screen>
 402 </listitem>
 403 <listitem>
 404 <para><literal>tom_schr: verbatim.xsl</literal></para><screen><phrase role="commit-message">Fixed subtle typo when calling lastLineNumber template: must be $listing instead of listing</phrase></screen>
 405 </listitem>
 406 <listitem>
 407 <para><literal>Robert Stayton: footnote.xsl</literal></para><screen><phrase role="commit-message">Fix bug in <tag>footnote</tag> <tag>link</tag> introduced in 1.77.1.</phrase></screen>
 408 </listitem>
 409 <listitem>
 410 <para><literal>Robert Stayton: formal.xsl; htmltbl.xsl</literal></para><screen><phrase role="commit-message">Resolve conflict of duplicate ids on html <tag>table</tag> with <tag>caption</tag>.
 411 Wrap a div with class and id attribute around html <tag>table</tag> without <tag>caption</tag>.</phrase></screen>
 412 </listitem>
 413 <listitem>
 414 <para><literal>Robert Stayton: component.xsl</literal></para><screen><phrase role="commit-message">Remove call to 'generate.id' template in &lt;h1&gt; in component.title because the
 415 id is already generated for the parent div element.</phrase></screen>
 416 </listitem>
 417 <listitem>
 418 <para><literal>Robert Stayton: chunker.xsl</literal></para><screen><phrase role="commit-message">Set omit-xml-declaration to 'yes' for write.text.chunk template, since a text
 419 file should never have an xml declaration.</phrase></screen>
 420 </listitem>
 421 <listitem>
 422 <para><literal>tom_schr: inline.xsl</literal></para><screen><phrase role="commit-message">Added support for @function attribute in <tag>keycap</tag> (uses <tag>keycap</tag> context
 423 from language files) =&gt; fixes RFE#3540451
 424 If @function is set and <tag>keycap</tag> is empty, then template will use the
 425 content from the <tag>keycap</tag> context, otherwise it will use just the given
 426 text</phrase></screen>
 427 </listitem>
 428 <listitem>
 429 <para><literal>David Cramer: docbook.xsl</literal></para><screen><phrase role="commit-message">Also set the <tag>title</tag> param in head.content since it's sometimes
 430 called without that param being passed in. Use the passed-in
 431 value in user.head.title.</phrase></screen>
 432 </listitem>
 433 <listitem>
 434 <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Restore missing <tag>title</tag> param on 'head.content' template, and passed
 435 it along to user.head.title. That param
 436 is used for certain special chunkings such as Long Descriptions.</phrase></screen>
 437 </listitem>
 438 <listitem>
 439 <para><literal>Robert Stayton: graphics.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>title</tag> in <tag>screenshot</tag>, available since DocBook 5.</phrase></screen>
 440 </listitem>
 441 <listitem>
 442 <para><literal>David Cramer: docbook.xsl</literal></para><screen><phrase role="commit-message">HTML: Add hook for easily customizing html/head/<tag>title</tag></phrase></screen>
 443 </listitem>
 444 </itemizedlist>
 445 </sect2><!--end of HTML changes for 1.78.0-->
 446
 447 <sect2 xml:id="V1.78.0_Manpages">
 448 <title>Manpages</title>
 449 <para>The following changes have been made to the
 450             <filename>manpages</filename> code
 451             since the 1.77.1 release.</para>
 452 <itemizedlist>
 453 <listitem>
 454 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Add a line break at start of <tag>variablelist</tag> to fix bug #3595156.</phrase></screen>
 455 </listitem>
 456 <listitem>
 457 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Better fix for bug #3545150 by putting the <tag>title</tag> with the step number
 458 rather than before it.</phrase></screen>
 459 </listitem>
 460 <listitem>
 461 <para><literal>Robert Stayton: utility.xsl</literal></para><screen><phrase role="commit-message">Add 'content' param to template name inline.monoseq to support
 462 <tag>email</tag> format, fixing bug #3524417.</phrase></screen>
 463 </listitem>
 464 <listitem>
 465 <para><literal>Robert Stayton: utility.xsl</literal></para><screen><phrase role="commit-message">Fix bug #3512473 where an inline <tag>synopsis</tag> element produced
 466 an extra line break in nroff output.</phrase></screen>
 467 </listitem>
 468 <listitem>
 469 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Fix bug 3545150 where <tag>procedure</tag>/step/<tag>title</tag> not rendered in man pages.</phrase></screen>
 470 </listitem>
 471 </itemizedlist>
 472 </sect2><!--end of Manpages changes for 1.78.0-->
 473
 474 <sect2 xml:id="V1.78.0_Roundtrip">
 475 <title>Roundtrip</title>
 476 <para>The following changes have been made to the
 477             <filename>roundtrip</filename> code
 478             since the 1.77.1 release.</para>
 479 <itemizedlist>
 480 <listitem>
 481 <para><literal>Robert Stayton: dbk2wordml.xsl</literal></para><screen><phrase role="commit-message">Fix bug #3297553 error in Word metadata elements from including
 482 WordML markup instead of just text.</phrase></screen>
 483 </listitem>
 484 </itemizedlist>
 485 </sect2><!--end of Roundtrip changes for 1.78.0-->
 486
 487 <sect2 xml:id="V1.78.0_Slides">
 488 <title>Slides</title>
 489 <para>The following changes have been made to the
 490             <filename>slides</filename> code
 491             since the 1.77.1 release.</para>
 492 <itemizedlist>
 493 <listitem>
 494 <para><literal>gaborkovesdan: xhtml/plain.xsl</literal></para><screen><phrase role="commit-message">- Use real push-style processing in the foil/foilgroup page content, which
 495   allows better customization in general (e.g. you can add PI templates)
 496   and also let us render scattered speakernotes/handoutnotes if that is
 497   desired</phrase></screen>
 498 </listitem>
 499 <listitem>
 500 <para><literal>gaborkovesdan: xhtml/Makefile</literal></para><screen><phrase role="commit-message">- Titlepage markup belongs to the XHTML namespace</phrase></screen>
 501 </listitem>
 502 <listitem>
 503 <para><literal>gaborkovesdan: xhtml/plain.xsl</literal></para><screen><phrase role="commit-message">- Remove now unnecessary template redefinition</phrase></screen>
 504 </listitem>
 505 <listitem>
 506 <para><literal>gaborkovesdan: xhtml/plain.xsl</literal></para><screen><phrase role="commit-message">- Generate valid links from cross-references</phrase></screen>
 507 </listitem>
 508 <listitem>
 509 <para><literal>gaborkovesdan: xhtml/plain.xsl</literal></para><screen><phrase role="commit-message">- Do not add fallbacks for EXSLT extensions, the main DocBook XSL stylesheets
 510   do not do that either</phrase></screen>
 511 </listitem>
 512 <listitem>
 513 <para><literal>Robert Stayton: schema/relaxng/slides.rnc</literal></para><screen><phrase role="commit-message">Update the import path for docbook.rnc after the slides directory was moved.</phrase></screen>
 514 </listitem>
 515 <listitem>
 516 <para><literal>stefan: xhtml/plain.xsl</literal></para><screen><phrase role="commit-message">Add missing stylesheet.</phrase></screen>
 517 </listitem>
 518 <listitem>
 519 <para><literal>stefan: schema/xsd/Makefile; schema/Makefile; schema/relaxng/Makefile</literal></para><screen><phrase role="commit-message">Adjust Makefiles.</phrase></screen>
 520 </listitem>
 521 <listitem>
 522 <para><literal>stefan: locatingrules.xml; RELEASE-NOTES.xml; doc; images; locatingrules.xml; Makefile; im⋯</literal></para><screen><phrase role="commit-message">Moved many files from slides/ to xsl/slides/</phrase></screen>
 523 </listitem>
 524 <listitem>
 525 <para><literal>stefan: fo/param.xweb; xhtml/Makefile; xhtml/param.xweb; fo/Makefile</literal></para><screen><phrase role="commit-message">Separate slides package.</phrase></screen>
 526 </listitem>
 527 <listitem>
 528 <para><literal>stefan: Makefile</literal></para><screen><phrase role="commit-message">A bit of cleanup...</phrase></screen>
 529 </listitem>
 530 <listitem>
 531 <para><literal>stefan: xhtml/Makefile; fo/Makefile</literal></para><screen><phrase role="commit-message">Add to 'clean' target.</phrase></screen>
 532 </listitem>
 533 <listitem>
 534 <para><literal>David Cramer: Makefile</literal></para><screen><phrase role="commit-message">Slides: Change html to xhtml passim.</phrase></screen>
 535 </listitem>
 536 <listitem>
 537 <para><literal>David Cramer: xhtml</literal></para><screen><phrase role="commit-message">Adding items to svn ignore for slides</phrase></screen>
 538 </listitem>
 539 <listitem>
 540 <para><literal>stefan: slidy</literal></para><screen><phrase role="commit-message">Import slidy from vendor branch.</phrase></screen>
 541 </listitem>
 542 <listitem>
 543 <para><literal>stefan: s5</literal></para><screen><phrase role="commit-message">Import s5 from vendor branch.</phrase></screen>
 544 </listitem>
 545 <listitem>
 546 <para><literal>stefan: Makefile; common/common.xsl; common; fo/param.ent; graphics; xhtml/Makefile.param;⋯</literal></para><screen><phrase role="commit-message">Merge Slides GSoC project to trunk.</phrase></screen>
 547 </listitem>
 548 </itemizedlist>
 549 </sect2><!--end of Slides changes for 1.78.0-->
 550
 551 <sect2 xml:id="V1.78.0_Webhelp">
 552 <title>Webhelp</title>
 553 <para>The following changes have been made to the
 554             <filename>webhelp</filename> code
 555             since the 1.77.1 release.</para>
 556 <itemizedlist>
 557 <listitem>
 558 <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: More doc updates</phrase></screen>
 559 </listitem>
 560 <listitem>
 561 <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: Documentation updates.</phrase></screen>
 562 </listitem>
 563 <listitem>
 564 <para><literal>David Cramer: template/content; Makefile; Makefile.sample; build.xml; template/search</literal></para><screen><phrase role="commit-message">Webhelp: Improving sample Makefile to allow for profiling params and other params, removing content dir from template and making related adjustments in Makefile and build.xml</phrase></screen>
 565 </listitem>
 566 <listitem>
 567 <para><literal>David Cramer: Makefile.sample</literal></para><screen><phrase role="commit-message">Attempting to include sample Makefile in webhelp output dir</phrase></screen>
 568 </listitem>
 569 <listitem>
 570 <para><literal>David Cramer: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Webhelp: Do not display <tag>sidebar</tag> if js is disabled in browser since it will not be functional</phrase></screen>
 571 </listitem>
 572 <listitem>
 573 <para><literal>Jirka Kosek: build.xml</literal></para><screen><phrase role="commit-message">Xerces must be on the classpath in order to XInclude work</phrase></screen>
 574 </listitem>
 575 <listitem>
 576 <para><literal>David Cramer: Makefile</literal></para><screen><phrase role="commit-message">Adding generated files to various clean targets.</phrase></screen>
 577 </listitem>
 578 <listitem>
 579 <para><literal>David Cramer: build.properties</literal></para><screen><phrase role="commit-message">Webhelp: By default don't validate against dtd when using ant build</phrase></screen>
 580 </listitem>
 581 <listitem>
 582 <para><literal>David Cramer: Makefile</literal></para><screen><phrase role="commit-message">Webhelp: By default only exclude ix01.html from search in Makefile</phrase></screen>
 583 </listitem>
 584 <listitem>
 585 <para><literal>David Cramer: template/common/jquery/jquery-ui-1.8.2.custom.min.js; template/common/jquery⋯</literal></para><screen><phrase role="commit-message">Webhelp: Reverting last commit</phrase></screen>
 586 </listitem>
 587 <listitem>
 588 <para><literal>David Cramer: template/common/jquery/jquery-ui-1.8.2.custom.min.js; template/common/jquery⋯</literal></para><screen><phrase role="commit-message">Webhelp: Removing two more unused jquery files</phrase></screen>
 589 </listitem>
 590 <listitem>
 591 <para><literal>David Cramer: template/common/jquery/jquery-1.4.2.min.js</literal></para><screen><phrase role="commit-message">Webhelp: Removing old, unused jquery file</phrase></screen>
 592 </listitem>
 593 <listitem>
 594 <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Fix header logo <tag>link</tag></phrase></screen>
 595 </listitem>
 596 <listitem>
 597 <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Fix bad <tag>link</tag> to favicon.ico</phrase></screen>
 598 </listitem>
 599 <listitem>
 600 <para><literal>David Cramer: template/common/jquery/jquery-1.7.2.min.js; template/common/main.js; templat⋯</literal></para><screen><phrase role="commit-message">First part of the GSoC 2012 work by Arun and Visitha:
 601
 602 Visitha Baddegama
 603 Remove content folder from Webhelp output
 604 Build Webhelp using GNU Make/without ant
 605 Support a parameterized list of files to exclude while indexing
 606 Improve information message for browser with JavaScript disabled
 607 Support searching for terms with punctuation like build.xml
 608
 609 Arun Bharadwaj
 610 Make it possible to include the doc <tag>title</tag> in head/<tag>title</tag> and
 611  not in the search results
 612 Improve performance in IE 8/9
 613 Expandable <tag>TOC</tag> pane
 614 Information message for browser with JavaScript disabled</phrase></screen>
 615 </listitem>
 616 <listitem>
 617 <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Use user.head.title to add <tag>title</tag> to webhelp pages,
 618 but do not yet add the <tag>book</tag> <tag>title</tag> to the page <tag>title</tag>.</phrase></screen>
 619 </listitem>
 620 <listitem>
 621 <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Revert 9433. We need to fix the indexer before we can include the document <tag>title</tag> in the html/head/<tag>title</tag></phrase></screen>
 622 </listitem>
 623 <listitem>
 624 <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Append document <tag>title</tag> to html/head/title</phrase></screen>
 625 </listitem>
 626 <listitem>
 627 <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: fix missing <tag>reference</tag> to ie.css</phrase></screen>
 628 </listitem>
 629 </itemizedlist>
 630 </sect2><!--end of Webhelp changes for 1.78.0-->
 631
 632 <sect2 xml:id="V1.78.0_Params">
 633 <title>Params</title>
 634 <para>The following changes have been made to the
 635             <filename>params</filename> code
 636             since the 1.77.1 release.</para>
 637 <itemizedlist>
 638 <listitem>
 639 <para><literal>Robert Stayton: page.height.portrait.xml; page.width.portrait.xml</literal></para><screen><phrase role="commit-message">Add USlegal and USlegallandscape.</phrase></screen>
 640 </listitem>
 641 <listitem>
 642 <para><literal>Robert Stayton: force.blank.pages.xml</literal></para><screen><phrase role="commit-message">Improve the description.</phrase></screen>
 643 </listitem>
 644 <listitem>
 645 <para><literal>Robert Stayton: page.margin.outer.xml; writing.mode.xml; double.sided.xml; page.margin.inn⋯</literal></para><screen><phrase role="commit-message">Improve the description.</phrase></screen>
 646 </listitem>
 647 <listitem>
 648 <para><literal>Robert Stayton: force.blank.pages.xml</literal></para><screen><phrase role="commit-message">New param to control generating blank even-numbered pages.</phrase></screen>
 649 </listitem>
 650 <listitem>
 651 <para><literal>Robert Stayton: passivetex.extensions.xml</literal></para><screen><phrase role="commit-message">Indicate that passivetex is no longer supported.</phrase></screen>
 652 </listitem>
 653 <listitem>
 654 <para><literal>Robert Stayton: footnote.properties.xml</literal></para><screen><phrase role="commit-message">Fix bug #3555628 where a <tag>footnote</tag> inside a <tag>blockquote</tag> inherits the end-indent from the <tag>blockquote</tag>.</phrase></screen>
 655 </listitem>
 656 <listitem>
 657 <para><literal>stefan: foil.page-sequence.properties.xml; handoutnotes.properties.xml; slidy.duration.xml⋯</literal></para><screen><phrase role="commit-message">Merge Slides GSoC project to trunk.</phrase></screen>
 658 </listitem>
 659 <listitem>
 660 <para><literal>Robert Stayton: activate.external.olinks.xml</literal></para><screen><phrase role="commit-message">Add parameter '<parameter>activate.external.olinks</parameter>' to allow making
 661 external olinks inactive, as for epub output.</phrase></screen>
 662 </listitem>
 663 </itemizedlist>
 664 </sect2><!--end of Params changes for 1.78.0-->
 665
 666 <sect2 xml:id="V1.78.0_Profiling">
 667 <title>Profiling</title>
 668 <para>The following changes have been made to the
 669             <filename>profiling</filename> code
 670             since the 1.77.1 release.</para>
 671 <itemizedlist>
 672 <listitem>
 673 <para><literal>Robert Stayton: xsl2profile.xsl</literal></para><screen><phrase role="commit-message">Test for @xml:id as well as @id for $rootid.</phrase></screen>
 674 </listitem>
 675 </itemizedlist>
 676 </sect2><!--end of Profiling changes for 1.78.0-->
 677
 678 <sect2 xml:id="V1.78.0_Tools">
 679 <title>Tools</title>
 680 <para>The following changes have been made to the
 681             <filename>tools</filename> code
 682             since the 1.77.1 release.</para>
 683 <itemizedlist>
 684 <listitem>
 685 <para><literal>David Cramer: bin/docbook-xsl-update</literal></para><screen><phrase role="commit-message">s/VERSION/VERSION.xsl/ again.</phrase></screen>
 686 </listitem>
 687 <listitem>
 688 <para><literal>David Cramer: xsl/build/xsl-param-link.xsl; xsl/build/make-xsl-params.xsl</literal></para><screen><phrase role="commit-message">Slides: Change html to xhtml passim.</phrase></screen>
 689 </listitem>
 690 </itemizedlist>
 691 </sect2><!--end of Tools changes for 1.78.0-->
 692
 693 <sect2 xml:id="V1.78.0_Template">
 694 <title>Template</title>
 695 <para>The following changes have been made to the
 696             <filename>template</filename> code
 697             since the 1.77.1 release.</para>
 698 <itemizedlist>
 699 <listitem>
 700 <para><literal>Jirka Kosek: titlepage.xsl</literal></para><screen><phrase role="commit-message">Autoguess of proper parameter settings</phrase></screen>
 701 </listitem>
 702 </itemizedlist>
 703 </sect2><!--end of Template changes for 1.78.0-->
 704
 705 </sect1>
 706
 707 <sect1 xml:id="V1.77.0">
 708 <title>Release Notes: 1.77.1</title>
 709 <para>The following list summarizes the major changes that have been made
 710         since the 1.76.1 release.  It is followed by sections detailing changes to individual files
 711 from the SVN checkin logs, edited to remove housekeeping changes and bug fixes.
 712 See the NEWS.xml file for a complete unedited  list of SVN changes.</para>
 713 <itemizedlist>
 714   <listitem><para>Gentext</para>
 715 <variablelist><varlistentry>
 716             <term>webhelp</term>
 717             <listitem>
 718                 <para>Many improvements to the generated text for webhelp output.</para>
 719             </listitem>
 720         </varlistentry></variablelist>
 721   </listitem>
 722   <listitem><para>Common</para><variablelist>
 723                     <varlistentry>
 724                         <term>Support more media types</term>
 725                         <listitem>
 726                             <para>Expanded list of supported filename extensions for media to include video and audio, mostly for HTML5 and EPUB3 outputs.</para>
 727                         </listitem>
 728                     </varlistentry>
 729                     <varlistentry>
 730                         <term>Topic element</term>
 731                         <listitem>
 732                             <para>Add basic support for new <literal>topic</literal> element, which is available in DocBook 5.1. Generally a topic element will be used with <literal>assembly</literal> and may be transformed to some other hierarchical element during processing, but it can also be formatted as a plain topic.</para>
 733                         </listitem>
 734                     </varlistentry>
 735                 </variablelist></listitem>
 736
 737
 738 <listitem><para>FO</para><variablelist>
 739                     <varlistentry>
 740                         <term>Add para.properties attribute-set</term>
 741                         <listitem>
 742                             <para>Add a <literal>para.properties</literal> attribute-set that applies only to para elements. That allows still using <literal>normal.para.spacing</literal> attribute-set for many block elements for uniform spacing, but allows separate formatting of para elements.</para>
 743                         </listitem>
 744                     </varlistentry>
 745                     <varlistentry>
 746                         <term>List of titles in article</term>
 747                         <listitem>
 748                             <para>Add support for List of Tables, List of Figures, etc. for articles and other component-level elements. Includes a new template for each in <filename>autotoc.xsl</filename>, new attribute-sets in <filename>titlepage.xsl</filename>, and new entries in the <filename>titlepage.templates.xml</filename> file tu support customization.</para>
 749                         </listitem>
 750                     </varlistentry>
 751                     <varlistentry>
 752                         <term>Customizing links in FO</term>
 753                         <listitem>
 754                             <para>Add template mode <literal>simple.xlink.properties</literal> to allow
 755 easy customization of formatting of links generated
 756 from elements  that use
 757 the xlink attributes. This extends link formatting beyond that of <literal>xref</literal>, <literal>link</literal>, and <literal>olink</literal> which use <literal>xref.properties</literal> attribute-set.</para>
 758                         </listitem>
 759                     </varlistentry>
 760                     <varlistentry>
 761                         <term>Table caption</term>
 762                         <listitem>
 763                             <para>The caption element in an HTML table is now handled like a title in a CALS table, using the <literal>formal.object.title</literal> template with all its features, including placement.  Now <literal>caption</literal> template in <literal>mode="htmlTable"</literal> does nothing, because
 764 caption handled by <literal>formal.object.title</literal> template.  Also adds support for table <literal>caption</literal> element in a CALS table, placing it after the table.</para>
 765                         </listitem>
 766                     </varlistentry>
 767                     <varlistentry>
 768                         <term>Graphics attribute handling</term>
 769                         <listitem>
 770                             <para>Refactored the big <literal>process.image</literal> template to use individual templates such as <literal>image.width</literal> for most attributes to allow easier customization of individual properties.</para>
 771                         </listitem>
 772                     </varlistentry>
 773                     <varlistentry>
 774                         <term>Side regions</term>
 775                         <listitem>
 776                             <para>Add support for side page regions in addition to header and footer regions. This feature lets you add running content to the side margins, and by default the content is rotated 90 degrees.  Adds new templates named <literal>running.side.content</literal>, <literal>region.inner</literal> and <literal>region.outer</literal>; new template modes <literal><literal>region.inner.mode</literal> and <literal>region.outer.mode</literal>; </literal>new parameters named <literal>region.inner.extent</literal>, <literal>region.outer.extent</literal>, <literal>body.margin.inner</literal>, <literal>body.margin.outer</literal>,  and <literal>side.region.precedence</literal>; and new attribute-sets named <literal>inner.region.content.properties</literal>, <literal>outer.region.content.properties</literal>, <literal>region.inner.properties</literal>, and <literal>region.outer.properties</literal>.</para>
 777                         </listitem>
 778                     </varlistentry>
 779                     <varlistentry>
 780                         <term>Callout formatting</term>
 781                         <listitem>
 782                             <para>Add new attribute-sets for <literal>calloutlist</literal>.</para>
 783                         </listitem>
 784                     </varlistentry>
 785                     <varlistentry>
 786                         <term>Topic element</term>
 787                         <listitem>
 788                             <para>Add basic support for formatting a topic element, which is available in DocBook 5.1.</para>
 789                         </listitem>
 790                     </varlistentry>
 791                 </variablelist></listitem>
 792
 793             <listitem><para>HTML</para>
 794
 795                 <variablelist><varlistentry>
 796                         <term>HTML5</term>
 797                         <listitem>
 798                             <para>Add variables to the base HTML stylesheets that can be adjusted for the HTML5 stylesheets.</para>
 799                         </listitem>
 800                     </varlistentry>
 801                     <varlistentry>
 802                         <term>Insert Javascript reference</term>
 803                         <listitem>
 804                             <para>Add support for <literal>html.script</literal> param to insert reference to a Javascript file.</para>
 805                         </listitem>
 806                     </varlistentry>
 807                     <varlistentry>
 808                         <term>Namespace for titlepage mechanism.</term>
 809                         <listitem>
 810                             <para>Titlepage mechanism is now namespace aware to support XHTML.</para>
 811                         </listitem>
 812                     </varlistentry>
 813                     <varlistentry>
 814                         <term>Chunked filename prefix</term>
 815                         <listitem>
 816                             <para>New param named <literal>chunked.filename.prefix</literal> lets you add a filename prefix to each chunked file. This replaces the buggy practice of adding such a prefix to the <literal>base.dir</literal> param.  Now the <literal>base.dir</literal> param will always have a trailing slash added if it is not present, so you no longer have to remember to add it to the param value.</para>
 817                         </listitem>
 818                     </varlistentry>
 819                     <varlistentry>
 820                         <term>Generate id attributes</term>
 821                         <listitem>
 822                             <para>The stylesheet param <literal>generate.id.attributes</literal> already existed but was incompletely implemented.  Now when it is set to 1, only <literal>id</literal> attributes should be output, not <literal>&lt;a name&gt;</literal> named anchors.</para>
 823                         </listitem>
 824                     </varlistentry>
 825                     <varlistentry>
 826                         <term>Generate consistent id attributes</term>
 827                         <listitem>
 828                             <para>New  <literal>generate.consistent.ids</literal> parameter which allows generating a more stable id values based on XPath rather than the <literal>generate-id()</literal> function, which may not produce consistent values between runs.  Stable output ids allow you to make stable links to generated content from the outside.</para>
 829                         </listitem>
 830                     </varlistentry>
 831                     <varlistentry>
 832                         <term>Topic element</term>
 833                         <listitem>
 834                             <para>Add basic support for formatting a topic element, which is available in DocBook 5.1. Generally a topic element will be used with assembly and may be transformed to some other hierarchical element during processing, but it can also be formatted as a plain topic.</para>
 835                         </listitem>
 836                     </varlistentry>
 837                 </variablelist>
 838             </listitem>
 839
 840             <listitem><para>Webhelp</para>
 841                 <variablelist>
 842                     <varlistentry>
 843                         <term>Webhelp refactored</term>
 844                         <listitem>
 845                             <para>Webhelp templates refactored to better support customization.</para>
 846                         </listitem>
 847                     </varlistentry>
 848                     <varlistentry>
 849                         <term>Added documentation.</term>
 850                         <listitem>
 851                             <para>More and better documentation added.</para>
 852                         </listitem>
 853                     </varlistentry>
 854                     <varlistentry>
 855                         <term>Webhelp generated text</term>
 856                         <listitem>
 857                             <para>Many improvements to the generated text for webhelp output.</para>
 858                         </listitem>
 859                     </varlistentry>
 860                 </variablelist>
 861             </listitem>
 862             <listitem><para>XHTML5</para>
 863                 <para>New stylesheets to generate HTML5 output, in an  XML serialization. These templates are a customization layer on top of the XHTML stylesheet files.</para>
 864             </listitem>
 865
 866            <listitem><para>EPUB3</para>
 867                 <para>New stylesheets to generate EPUB3 output. These templates are a customization layer on top of the xhtml5 stylesheet files.</para>
 868             </listitem>
 869
 870             <listitem><para>Assembly</para>
 871                 <para>New <literal>assembly.xsl</literal> stylesheet to convert a DocBook 5.1 assembly into a standard DocBook 5 document.  Also includes a <literal>topic-maker-chunk.xsl</literal> stylesheet that can convert a DocBook 5 book or article document into an assembly with a collection of modular files, including converting some elements to topic files.</para>
 872             </listitem>
 873     </itemizedlist>
 874 <sect2 xml:id="rnV1.77_Gentext">
 875 <title>Gentext</title>
 876 <para>The following changes have been made to the
 877             <filename>gentext</filename> code
 878             since the 1.76.1 release.</para>
 879 <itemizedlist>
 880 <listitem>
 881 <para><literal>stefanhinz: locale/de.xml</literal></para><screen><phrase role="commit-message">Translated German WebHelp strings</phrase></screen>
 882 </listitem>
 883 <listitem>
 884 <para><literal>David Cramer: locale/zh.xml; locale/en.xml; locale/fr.xml; locale/de.xml; locale/ja.xml</literal></para><screen><phrase role="commit-message">Webhelp: Update non-en gentext strings</phrase></screen>
 885 </listitem>
 886 <listitem>
 887 <para><literal>Robert Stayton: locale/en.xml</literal></para><screen><phrase role="commit-message">Add topic to title-numbered context.</phrase></screen>
 888 </listitem>
 889 <listitem>
 890 <para><literal>Robert Stayton: locale/en.xml</literal></para><screen><phrase role="commit-message">Add basic topic element templates.</phrase></screen>
 891 </listitem>
 892 <listitem>
 893 <para><literal>Mauritz Jeanson: locale/el.xml</literal></para><screen><phrase role="commit-message">Updated gentext for quotation marks. Fixes bug #3512440.</phrase></screen>
 894 </listitem>
 895 <listitem>
 896 <para><literal>Jirka Kosek: locale/cs.xml</literal></para><screen><phrase role="commit-message">Adding missing context for webhelp</phrase></screen>
 897 </listitem>
 898 <listitem>
 899 <para><literal>David Cramer: locale/en.xml</literal></para><screen><phrase role="commit-message">Fixing syntax of webhelp gentext entries</phrase></screen>
 900 </listitem>
 901 <listitem>
 902 <para><literal>David Cramer: locale/en.xml</literal></para><screen><phrase role="commit-message">Moving webhelp gentext strings into a context</phrase></screen>
 903 </listitem>
 904 <listitem>
 905 <para><literal>tom_schr: locale/zh.xml; locale/en.xml; locale/cs.xml; locale/fr.xml; locale/de.xml; local⋯</literal></para><screen><phrase role="commit-message">Moved language specific of WebHelp to gentext/locale/ as discussed with
 906 Stefan following the "minimal intrusive approach". :)
 907 In the long run, maybe moving the text into a context, not sure.</phrase></screen>
 908 </listitem>
 909
 910 <listitem>
 911 <para><literal>Jirka Kosek: locale/ru.xml</literal></para><screen><phrase role="commit-message">Aligned capitalization of first letters with English original</phrase></screen>
 912 </listitem>
 913 </itemizedlist>
 914 </sect2><!--end of Gentext changes for snapshot_-->
 915
 916 <sect2 xml:id="VrnV1.77_Common">
 917 <title>Common</title>
 918 <para>The following changes have been made to the
 919             <filename>common</filename> code
 920             since the 1.76.1 release.</para>
 921 <itemizedlist>
 922 <listitem>
 923 <para><literal>Robert Stayton: common.xsl</literal></para><screen><phrase role="commit-message">In "select.mediaobject.index" template, add selection of <tag>videoobject</tag>
 924 and <tag>audioobject</tag> since now supported in HTML5.</phrase></screen>
 925 </listitem>
 926 <listitem>
 927 <para><literal>Robert Stayton: labels.xsl; titles.xsl; entities.ent; targets.xsl; subtitles.xsl; gentext.⋯</literal></para><screen><phrase role="commit-message">Add basic support for new &lt;topic&gt; element.</phrase></screen>
 928 </listitem>
 929 <listitem>
 930 <para><literal>Robert Stayton: common.xsl</literal></para><screen><phrase role="commit-message">Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.</phrase></screen>
 931 </listitem>
 932 <listitem>
 933 <para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Generate error message if <tag>olink</tag> data in targetset is in a namespace.</phrase></screen>
 934 </listitem>
 935 <listitem>
 936 <para><literal>Robert Stayton: common.xsl</literal></para><screen><phrase role="commit-message">Add support for <parameter>generate.consistent.ids</parameter> parameter.</phrase></screen>
 937 </listitem>
 938 <listitem>
 939 <para><literal>Robert Stayton: subtitles.xsl</literal></para><screen><phrase role="commit-message">Add verbose param to subtitle.markup templates to allow its
 940 error message to be ignored.
 941 Add that param to fop1.xsl <tag>application</tag> of subtitle.markup
 942 to avoid unnecessary error message in document information.</phrase></screen>
 943 </listitem>
 944 <listitem>
 945 <para><literal>Robert Stayton: labels.xsl</literal></para><screen><phrase role="commit-message">Add empty templates for <tag>glossdiv</tag>, <tag>glosslist</tag>, and <tag>glossentry</tag> in
 946 mode="label.markup".</phrase></screen>
 947 </listitem>
 948 </itemizedlist>
 949 </sect2><!--end of Common changes for snapshot_-->
 950
 951 <sect2 xml:id="rnV1.77_FO">
 952 <title>FO</title>
 953 <para>The following changes have been made to the
 954             <filename>fo</filename> code
 955             since the 1.76.1 release.</para>
 956 <itemizedlist>
 957 <listitem>
 958 <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">qualify <tag>caption</tag> template to <tag>mediaobject</tag>/<tag>caption</tag> so not confused with <tag>table</tag>/<tag>caption</tag>.</phrase></screen>
 959 </listitem>
 960 <listitem>
 961 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add template to process <tag>table</tag>/<tag>caption</tag> element.</phrase></screen>
 962 </listitem>
 963 <listitem>
 964 <para><literal>Robert Stayton: titlepage.xsl; autotoc.xsl; component.xsl; xref.xsl; titlepage.templates.x⋯</literal></para><screen><phrase role="commit-message">Add basic support for new &lt;topic&gt; element.</phrase></screen>
 965 </listitem>
 966 <listitem>
 967 <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.</phrase></screen>
 968 </listitem>
 969 <listitem>
 970 <para><literal>Robert Stayton: titlepage.xsl</literal></para><screen><phrase role="commit-message">Add default style att-sets for component.list.of.titles, etc.</phrase></screen>
 971 </listitem>
 972 <listitem>
 973 <para><literal>Robert Stayton: autotoc.xsl; component.xsl; titlepage.templates.xml</literal></para><screen><phrase role="commit-message">Add make.component.tocs to support lists of tables, etc. for
 974 <tag>article</tag> and other components.  Added component.list.of.tables to
 975 titlepage.templates.xml to format the <tag>title</tag>.</phrase></screen>
 976 </listitem>
 977 <listitem>
 978 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new <parameter>para.properties</parameter> attribute-set for paragraphs.</phrase></screen>
 979 </listitem>
 980 <listitem>
 981 <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">Add template mode 'simple.xlink.properties' to allow
 982 easy customization of formatting of links generated
 983 from elements other than <tag>xref</tag>, <tag>link</tag>, and <tag>olink</tag> using
 984 the xlink attributes.</phrase></screen>
 985 </listitem>
 986 <listitem>
 987 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add <parameter>table.caption.properties</parameter> to format <tag>table</tag> captions.</phrase></screen>
 988 </listitem>
 989 <listitem>
 990 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>caption</tag> in a CALS <tag>table</tag>.</phrase></screen>
 991 </listitem>
 992 <listitem>
 993 <para><literal>Robert Stayton: graphics.xsl; math.xsl</literal></para><screen><phrase role="commit-message">Refactored the 'process.image' template to create modular
 994 templates for each attribute so they can be individually
 995 customized.  Also merged in support for embedded svg and
 996 mml content so they can have image attributes too.</phrase></screen>
 997 </listitem>
 998 <listitem>
 999 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Check in new params for FO side regions in page masters.</phrase></screen>
1000 </listitem>
1001 <listitem>
1002 <para><literal>Robert Stayton: titlepage.xsl; titlepage.templates.xml</literal></para><screen><phrase role="commit-message">Add support for <tag>itermset</tag> in <tag>info</tag> elements, using titlepage mechanism
1003 to ensure entries are placed inside page-sequence.</phrase></screen>
1004 </listitem>
1005 <listitem>
1006 <para><literal>Robert Stayton: pagesetup.xsl</literal></para><screen><phrase role="commit-message">Add support for side body margins and side static content regions.
1007 Fixes bug 3389931.</phrase></screen>
1008 </listitem>
1009 <listitem>
1010 <para><literal>Robert Stayton: param.xweb; param.ent; task.xsl</literal></para><screen><phrase role="commit-message">Add attribute-set <parameter>task.properties</parameter> to <tag>task</tag> element to
1011 support customization.</phrase></screen>
1012 </listitem>
1013 <listitem>
1014 <para><literal>Robert Stayton: lists.xsl; param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new attribute-sets <parameter>calloutlist.properties</parameter> and <parameter>callout.properties</parameter>
1015 to  better support customization of calloutlists, fixing bug 3160341.</phrase></screen>
1016 </listitem>
1017 <listitem>
1018 <para><literal>Jirka Kosek: Makefile</literal></para><screen><phrase role="commit-message">Titlepage mechanism is now namespace aware to support XHTML. Please note that when generating titlepage template stylesheets you have to pass FO or XHTML namespace inside ns parameter. For HTML parameter should be empty.</phrase></screen>
1019 </listitem>
1020 <listitem>
1021 <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Allow selection by role for multiple <tag>imageobject</tag> elements
1022 within an <tag>imageobjectco</tag>, which since Docbook 5 allows multiple imageobjects.</phrase></screen>
1023 </listitem>
1024 <listitem>
1025 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added template for collabname. Fixes bug #3414436.</phrase></screen>
1026 </listitem>
1027 <listitem>
1028 <para><literal>David Cramer: verbatim.xsl</literal></para><screen><phrase role="commit-message">Support the keep-together processing-instruction on <tag>programlisting</tag>, <tag>screen</tag>, <tag>synopsis</tag>, and <tag>literallayout</tag>. Tracker id #3396906.</phrase></screen>
1029 </listitem>
1030 <listitem>
1031 <para><literal>Robert Stayton: pagesetup.xsl</literal></para><screen><phrase role="commit-message">Pass the pageclass, sequence, and gentext-key to the template
1032 named header.footer.widths to enable further customization
1033 based on page master.</phrase></screen>
1034 </listitem>
1035 <listitem>
1036 <para><literal>Jirka Kosek: xref.xsl</literal></para><screen><phrase role="commit-message">hyphenation of URL content must be disabled for <tag>link</tag>, not only for ulink because od DB5</phrase></screen>
1037 </listitem>
1038 <listitem>
1039 <para><literal>Jirka Kosek: xref.xsl</literal></para><screen><phrase role="commit-message">URLs shouldn't be hyphenated as normal text</phrase></screen>
1040 </listitem>
1041 <listitem>
1042 <para><literal>Jirka Kosek: callout.xsl</literal></para><screen><phrase role="commit-message">Added support for alternative circled numbers</phrase></screen>
1043 </listitem>
1044 <listitem>
1045 <para><literal>Mauritz Jeanson: axf.xsl; fop1.xsl; xep.xsl</literal></para><screen><phrase role="commit-message">Added support for <tag>author</tag>/<tag>orgname</tag> in document metadata. Closes bug #3132862.</phrase></screen>
1046 </listitem>
1047 <listitem>
1048 <para><literal>Robert Stayton: component.xsl</literal></para><screen><phrase role="commit-message">Add template for <tag>article</tag>/<tag>colophon</tag> to avoid nested page-sequence.</phrase></screen>
1049 </listitem>
1050 </itemizedlist>
1051 </sect2><!--end of FO changes for snapshot_-->
1052
1053 <sect2 xml:id="rnV1.77_HTML">
1054 <title>HTML</title>
1055 <para>The following changes have been made to the
1056             <filename>html</filename> code
1057             since the 1.76.1 release.</para>
1058 <itemizedlist>
1059 <listitem>
1060 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Add support for using <tag>info</tag>/<tag>title</tag> as well as <tag>title</tag> in target element.</phrase></screen>
1061 </listitem>
1062 <listitem>
1063 <para><literal>Robert Stayton: component.xsl</literal></para><screen><phrase role="commit-message">Enable support for html5 features, including using &lt;<tag>section</tag>&gt; instead of
1064 &lt;div&gt; for certain elements, and setting heading level to &lt;h1&gt; for chapters.
1065 These features are not changed in the base html stylesheet for backwards
1066 compatibility.</phrase></screen>
1067 </listitem>
1068 <listitem>
1069 <para><literal>Robert Stayton: docbook.css.xml</literal></para><screen><phrase role="commit-message">Add style for <tag>footnote</tag> rule.</phrase></screen>
1070 </listitem>
1071 <listitem>
1072 <para><literal>Robert Stayton: biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Add support for <tag>subtitle</tag> inside <tag>info</tag>.</phrase></screen>
1073 </listitem>
1074 <listitem>
1075 <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Add call to new 'root.attributes' placeholder template to allow
1076 adding attributes to the &lt;html&gt; output element.</phrase></screen>
1077 </listitem>
1078 <listitem>
1079 <para><literal>Robert Stayton: inline.xsl; titlepage.xsl; formal.xsl; division.xsl; toc.xsl; sections.xsl⋯</literal></para><screen><phrase role="commit-message">Finish implementation of <parameter>generate.id.attributes</parameter> for all elements
1080 using the template named id.attribute.</phrase></screen>
1081 </listitem>
1082 <listitem>
1083 <para><literal>Robert Stayton: autotoc.xsl; chunktoc.xsl; titlepage.xsl; chunk-code.xsl; changebars.xsl; ⋯</literal></para><screen><phrase role="commit-message">Add basic support for new &lt;topic&gt; element.</phrase></screen>
1084 </listitem>
1085 <listitem>
1086 <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.</phrase></screen>
1087 </listitem>
1088 <listitem>
1089 <para><literal>Robert Stayton: callout.xsl; verbatim.xsl</literal></para><screen><phrase role="commit-message">Restore <tag>programlisting</tag> to use &lt;pre&gt; instead of &lt;div&gt; and instead
1090 wrap <tag>callout</tag> img elements in &lt;span&gt; to make valid HTML.</phrase></screen>
1091 </listitem>
1092 <listitem>
1093 <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Turn off img longdesc attribute because not supported by browsers.</phrase></screen>
1094 </listitem>
1095 <listitem>
1096 <para><literal>Robert Stayton: footnote.xsl</literal></para><screen><phrase role="commit-message">Move square brackets and &lt;sup&gt; inside &lt;a&gt; element for <tag>footnote</tag>
1097 marks to fix display problems in some browsers.</phrase></screen>
1098 </listitem>
1099 <listitem>
1100 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add new params <parameter>html.script</parameter> and <parameter>html.script.type</parameter> to support
1101 Javascript references.</phrase></screen>
1102 </listitem>
1103 <listitem>
1104 <para><literal>Robert Stayton: chunk-common.xsl; chunktoc.xsl; titlepage.xsl; chunker.xsl; chunk-code.xsl⋯</literal></para><screen><phrase role="commit-message">Add support for <parameter>chunked.filename.prefix</parameter> param.
1105 Make sure <parameter>base.dir</parameter> value has a trailing slash in
1106 the chunk.base.dir internal param used by the templates.</phrase></screen>
1107 </listitem>
1108 <listitem>
1109 <para><literal>Robert Stayton: formal.xsl; htmltbl.xsl</literal></para><screen><phrase role="commit-message">Now handles <tag>caption</tag> in html markup <tag>table</tag> like <tag>title</tag>,
1110 so formal.object.title is used with all its features, including
1111 formatting and placement.
1112 Added htmlTable.with.caption template to handle the wrapper, and
1113 left htmlTable template unchanged.
1114 Now <tag>caption</tag> template in mode="htmlTable" does nothing, because
1115 <tag>caption</tag> handled by formal.object.title template.</phrase></screen>
1116 </listitem>
1117 <listitem>
1118 <para><literal>Robert Stayton: html.xsl</literal></para><screen><phrase role="commit-message">Turn off generating the <tag>title</tag> attribute for block and hierarchical elements.
1119 Should only be used for inline elements, usually using the <tag>alt</tag> element.
1120 Also used for links to show the target <tag>title</tag>.</phrase></screen>
1121 </listitem>
1122 <listitem>
1123 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">The spacing="compact" attribute on lists in HTML no longer outputs compact="compact"
1124 (or just "compact" in the case of Saxon 6), since that attribute is
1125 deprecated and improperly supported.  Instead, the output uses a
1126 multiple class attribute such as class="<tag>orderedlist</tag> compact".
1127 Use CSS to style such lists without margin above.</phrase></screen>
1128 </listitem>
1129 <listitem>
1130 <para><literal>Robert Stayton: graphics.xsl</literal></para><screen><phrase role="commit-message">Allow selection by role for multiple <tag>imageobject</tag> elements
1131 within an <tag>imageobjectco</tag>, which since Docbook 5 allows multiple imageobjects.</phrase></screen>
1132 </listitem>
1133 <listitem>
1134 <para><literal>Robert Stayton: pi.xsl</literal></para><screen><phrase role="commit-message">Improve doc descriptions of dbhtml <tag>filename</tag> and dir.</phrase></screen>
1135 </listitem>
1136 <listitem>
1137 <para><literal>Robert Stayton: autoidx.xsl</literal></para><screen><phrase role="commit-message">Add <tag>setindex</tag> to context param in mode="<tag>reference</tag>" to better
1138 support <tag>setindex</tag>.</phrase></screen>
1139 </listitem>
1140 <listitem>
1141 <para><literal>Robert Stayton: autotoc.xsl</literal></para><screen><phrase role="commit-message">Support set as child of set in set.toc template.</phrase></screen>
1142 </listitem>
1143 <listitem>
1144 <para><literal>Robert Stayton: qandaset.xsl</literal></para><screen><phrase role="commit-message">Change <tag>question</tag> and <tag>title</tag> templates to replace hard-coded
1145 class="local-name()" with mode="class.attribute" to support customization
1146 of class values.</phrase></screen>
1147 </listitem>
1148 <listitem>
1149 <para><literal>Norman Walsh: chunktoc.xsl</literal></para><screen><phrase role="commit-message">Separate <tag>book</tag> appendixes from <tag>article</tag> appendixes (so that they can be customized independently)</phrase></screen>
1150 </listitem>
1151 <listitem>
1152 <para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Added condition to prevent "Failed to interpret image" messages (SVG is not supported
1153 by the graphic size extension).</phrase></screen>
1154 </listitem>
1155 </itemizedlist>
1156 </sect2><!--end of HTML changes for snapshot_-->
1157
1158
1159 <sect2 xml:id="rnV1.77_Epub">
1160 <title>Epub</title>
1161 <para>The following changes have been made to the
1162             <filename>epub</filename> code
1163             since the 1.76.1 release.</para>
1164 <itemizedlist>
1165 <listitem>
1166 <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Replace $base.dir with $chunk.base.dir to ensure trailing slash in place.</phrase></screen>
1167 </listitem>
1168 </itemizedlist>
1169 </sect2><!--end of Epub changes for snapshot_-->
1170
1171 <sect2 xml:id="rnV1.77_HTMLHelp">
1172 <title>HTMLHelp</title>
1173 <para>The following changes have been made to the
1174             <filename>htmlhelp</filename> code
1175             since the 1.76.1 release.</para>
1176 <itemizedlist>
1177 <listitem>
1178 <para><literal>Robert Stayton: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Change $base.dir to $chunk.base.dir to ensure trailing slash in place.</phrase></screen>
1179 </listitem>
1180 </itemizedlist>
1181 </sect2><!--end of HTMLHelp changes for snapshot_-->
1182
1183 <sect2 xml:id="rnV1.77_Eclipse">
1184 <title>Eclipse</title>
1185 <para>The following changes have been made to the
1186             <filename>eclipse</filename> code
1187             since the 1.76.1 release.</para>
1188 <itemizedlist>
1189 <listitem>
1190 <para><literal>Robert Stayton: eclipse.xsl; eclipse3.xsl</literal></para><screen><phrase role="commit-message">Use $chunk.base.dir instead of $base.dir to ensure trailing slash is in place.</phrase></screen>
1191 </listitem>
1192 </itemizedlist>
1193 </sect2><!--end of Eclipse changes for snapshot_-->
1194
1195 <sect2 xml:id="rnV1.77_">
1196 <title>JavaHelp</title>
1197 <para>The following changes have been made to the
1198             <filename>javahelp</filename> code
1199             since the 1.76.1 release.</para>
1200 <itemizedlist>
1201 <listitem>
1202 <para><literal>Robert Stayton: javahelp.xsl</literal></para><screen><phrase role="commit-message">Change $base.dir to $chunk.base.dir to ensure trailing slash is present.</phrase></screen>
1203 </listitem>
1204 <listitem>
1205 <para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Replaced empty header.navigation and footer.navigation templates with parameter <parameter>suppress.navigation</parameter>=1,
1206 which simplifies customization. See bug #3310904.</phrase></screen>
1207 </listitem>
1208 </itemizedlist>
1209 </sect2><!--end of JavaHelp changes for snapshot_-->
1210
1211 <sect2 xml:id="rnV1.77_Webhelp">
1212 <title>Webhelp</title>
1213 <para>The following changes have been made to the
1214             <filename>webhelp</filename> code
1215             since the 1.76.1 release.</para>
1216 <itemizedlist>
1217 <listitem>
1218 <para><literal>David Cramer: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Webhelp: Adding print-only css rules</phrase></screen>
1219 </listitem>
1220 <listitem>
1221 <para><literal>David Cramer: template/common/main.js</literal></para><screen><phrase role="commit-message">Webhelp: Arun's fix for bug where heading was partially hidden by header in some situations.</phrase></screen>
1222 </listitem>
1223 <listitem>
1224 <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: turn off autolabeling by default</phrase></screen>
1225 </listitem>
1226 <listitem>
1227 <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Import xhtml base stylesheets</phrase></screen>
1228 </listitem>
1229 <listitem>
1230 <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: <tag>Link</tag> to the DocBook <tag>reference</tag> docs from the webhelp readme</phrase></screen>
1231 </listitem>
1232 <listitem>
1233 <para><literal>David Cramer: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Use gentext value for noscript warning</phrase></screen>
1234 </listitem>
1235 <listitem>
1236 <para><literal>David Cramer: Makefile</literal></para><screen><phrase role="commit-message">Webhelp: Delete tempfile after DocBook xsl build</phrase></screen>
1237 </listitem>
1238 <listitem>
1239 <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Webhelp: moving parameters into the standard location so they will be part of the parameter <tag>reference</tag></phrase></screen>
1240 </listitem>
1241 <listitem>
1242 <para><literal>David Cramer: xsl/webhelp.xsl; xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Webhelp: moving parameters into the standard location so they will be part of the parameter <tag>reference</tag></phrase></screen>
1243 </listitem>
1244 <listitem>
1245 <para><literal>David Cramer: template/common/main.js</literal></para><screen><phrase role="commit-message">Webhelp: tweaking scrolldown offset for anchors</phrase></screen>
1246 </listitem>
1247 <listitem>
1248 <para><literal>David Cramer: docsrc/images; docsrc/images/sample.jpg; docsrc/readme.xml; template/content⋯</literal></para><screen><phrase role="commit-message">Webhelp: updating docs. Ant version, install instructions, handling of images.</phrase></screen>
1249 </listitem>
1250 <listitem>
1251 <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Patch from Arun Bharadwaj to display message if JavaScript is disabled</phrase></screen>
1252 </listitem>
1253 <listitem>
1254 <para><literal>David Cramer: template/content/search/nwSearchFnt.js</literal></para><screen><phrase role="commit-message">Patch from Arun Bharadwaj to strip quotes from search query strings</phrase></screen>
1255 </listitem>
1256 <listitem>
1257 <para><literal>Robert Stayton: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Add basic support for new &lt;topic&gt; element.</phrase></screen>
1258 </listitem>
1259 <listitem>
1260 <para><literal>Jirka Kosek: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Put back old extensibility point.
1261
1262 Guys, please don't remove existing extensibility points like named templates, it will break existing customizations.</phrase></screen>
1263 </listitem>
1264 <listitem>
1265 <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Moving webhelp gentext strings into a context</phrase></screen>
1266 </listitem>
1267 <listitem>
1268 <para><literal>tom_schr: param.ent</literal></para><screen><phrase role="commit-message">Disabled branding and brandname entities for the time being</phrase></screen>
1269 </listitem>
1270 <listitem>
1271 <para><literal>tom_schr: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Prepared WebHelp <tag>reference</tag> documentation :)
1272 Not clear about parameters brandname and branding: Should they renamed
1273 to "webhelp.branding" and "webhelp.brandname"?
1274 Currently, docsrc/reference.xml contains only a comment for the WebHelp
1275 ref doc to be non-intrusive.
1276 Idea is to enable it when it is ready</phrase></screen>
1277 </listitem>
1278 <listitem>
1279 <para><literal>tom_schr: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Moved language specific of WebHelp to gentext/locale/ as discussed with
1280 Stefan following the "minimal intrusive approach". :)
1281 In the long run, maybe moving the text into a context, not sure.</phrase></screen>
1282 </listitem>
1283 <listitem>
1284 <para><literal>David Cramer: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Webhelp: Lower the minimum width of content pane</phrase></screen>
1285 </listitem>
1286 <listitem>
1287 <para><literal>kasunbg: xsl/webhelp.xsl; template/common/main.js</literal></para><screen><phrase role="commit-message">If an user moved to another page by clicking on a <tag>toc</tag> <tag>link</tag>, and then clicked on #searchDiv,
1288 search should be performed if the cookie textToSearch is not empty.</phrase></screen>
1289 </listitem>
1290 <listitem>
1291 <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Left align titles in nav header. Display  for all but the topmost page</phrase></screen>
1292 </listitem>
1293 <listitem>
1294 <para><literal>David Cramer: template/content/search/stemmers/en_stemmer.js; docsrc/xinclude-test.xml</literal></para><screen><phrase role="commit-message">Webhelp: Cleanup related to en_stemmer.js changes</phrase></screen>
1295 </listitem>
1296 <listitem>
1297 <para><literal>David Cramer: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Webhelp: Don't put borders around <tag>qandaset</tag> list</phrase></screen>
1298 </listitem>
1299 <listitem>
1300 <para><literal>David Cramer: template/common/main.js</literal></para><screen><phrase role="commit-message">Webhelp: Avoid unnecessary scroll ups when <tag>anchor</tag> is clicked on</phrase></screen>
1301 </listitem>
1302 <listitem>
1303 <para><literal>David Cramer: build.properties</literal></para><screen><phrase role="commit-message">Webhelp: Show footer nav by default</phrase></screen>
1304 </listitem>
1305 <listitem>
1306 <para><literal>David Cramer: build.properties; build.xml</literal></para><screen><phrase role="commit-message">Webhelp: Support setting <parameter>suppress.footer.navigation</parameter> from build.properties</phrase></screen>
1307 </listitem>
1308 <listitem>
1309 <para><literal>David Cramer: build.properties; build.xml</literal></para><screen><phrase role="commit-message">Webhelp: Support <parameter>admon.graphics</parameter> param in build.properties</phrase></screen>
1310 </listitem>
1311 <listitem>
1312 <para><literal>David Cramer: docsrc/xinclude-test.xml; docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: Adding xinclude example to the demo/readme doc</phrase></screen>
1313 </listitem>
1314 <listitem>
1315 <para><literal>David Cramer: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Webhelp: Remove border around <tag>table</tag> used to format <tag>callout</tag> list</phrase></screen>
1316 </listitem>
1317 <listitem>
1318 <para><literal>David Cramer: xsl/webhelp.xsl; template/common/images/admon/tip.png; template/common/image⋯</literal></para><screen><phrase role="commit-message">Webhelp: Support admon graphics (still off by default)</phrase></screen>
1319 </listitem>
1320 <listitem>
1321 <para><literal>David Cramer: xsl/webhelp.xsl; template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Webhelp: Turn on navfooter and fix related css</phrase></screen>
1322 </listitem>
1323 <listitem>
1324 <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Webhelp: Fix error about undeclared doc.title param</phrase></screen>
1325 </listitem>
1326 <listitem>
1327 <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: Adding some test search terms to the readme</phrase></screen>
1328 </listitem>
1329 <listitem>
1330 <para><literal>David Cramer: template/content/search/stemmers/en_stemmer.js</literal></para><screen><phrase role="commit-message">Handle exceptional cases listed in the Porter 2 stemming algo</phrase></screen>
1331 </listitem>
1332 <listitem>
1333 <para><literal>David Cramer: template/content/search/stemmers/en_stemmer.js</literal></para><screen><phrase role="commit-message">Webhelp: adding special case word 'say' to en js stemmer</phrase></screen>
1334 </listitem>
1335 <listitem>
1336 <para><literal>David Cramer: template/content/search/stemmers/en_stemmer.js</literal></para><screen><phrase role="commit-message">Webhelp: Refine stemming of terms that end in (only stem if there's a consonant before the -y)</phrase></screen>
1337 </listitem>
1338 <listitem>
1339 <para><literal>David Cramer: template/content/search/stemmers/en_stemmer.js; template/content/search/nwSe⋯</literal></para><screen><phrase role="commit-message">Webhelp: fixed bug where words like key, day, and nucleus, were not found due to differences in the way the client stemmer and indexer stemmed words</phrase></screen>
1340 </listitem>
1341 <listitem>
1342 <para><literal>David Cramer: build.xml</literal></para><screen><phrase role="commit-message">Webhelp: Support xinclude and two-pass profiling in build.xml</phrase></screen>
1343 </listitem>
1344 <listitem>
1345 <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Fix bad <tag>link</tag> to default topic.</phrase></screen>
1346 </listitem>
1347 <listitem>
1348 <para><literal>kasunbg: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Automatically limit the size of the search description to something 140 characters</phrase></screen>
1349 </listitem>
1350 <listitem>
1351 <para><literal>kasunbg: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">removing outline in 'contents' and 'search' buttons that is visible when clicked. tabindex for <tag>SIDEBAR</tag> button.</phrase></screen>
1352 </listitem>
1353 <listitem>
1354 <para><literal>kasunbg: xsl/webhelp.xsl; build.xml</literal></para><screen><phrase role="commit-message">Webhelp ant script changes - HTML transformation support for WebHelp - Uses Tagsoup for parsing the bad html.
1355 tagsoup-1.2.1.jar is added to trunk/xsl-webhelpindexer/lib/</phrase></screen>
1356 </listitem>
1357 <listitem>
1358 <para><literal>kasunbg: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">proper support for saxon xhtml transformation.</phrase></screen>
1359 </listitem>
1360 <listitem>
1361 <para><literal>kasunbg: template/common/images/callouts/10.png; template/common/images/callouts/11.png; t⋯</literal></para><screen><phrase role="commit-message">webhelp - adding callouts</phrase></screen>
1362 </listitem>
1363 <listitem>
1364 <para><literal>kasunbg: xsl/webhelp.xsl; template/common/main.js; template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">webhelp - animations for show/hide <tag>Sidebar</tag></phrase></screen>
1365 </listitem>
1366 <listitem>
1367 <para><literal>kasunbg: build.properties</literal></para><screen><phrase role="commit-message">commenting about brand and brandname</phrase></screen>
1368 </listitem>
1369 <listitem>
1370 <para><literal>kasunbg: Makefile</literal></para><screen><phrase role="commit-message">parameterized MAKE for webhelp</phrase></screen>
1371 </listitem>
1372 <listitem>
1373 <para><literal>kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css; build.properties; build.xml</literal></para><screen><phrase role="commit-message">webhelp xsl customization - logo</phrase></screen>
1374 </listitem>
1375 <listitem>
1376 <para><literal>kasunbg: template/content/search/nwSearchFnt.js</literal></para><screen><phrase role="commit-message">remove some JS warninings</phrase></screen>
1377 </listitem>
1378 <listitem>
1379 <para><literal>kasunbg: template/content/search/nwSearchFnt.js</literal></para><screen><phrase role="commit-message">Fix for missing "No results found for..." bug</phrase></screen>
1380 </listitem>
1381 <listitem>
1382 <para><literal>kasunbg: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">commented about the importance of the order of css contents. Order is <tag>important</tag> between the in-html-file css and the linked css files. Some css declarations in jquery-ui-1.8.2.custom.css are over-ridden. If that's a concern, just remove the additional css contents inside these default jquery css files. I thought of keeping them intact for easier maintenance.</phrase></screen>
1383 </listitem>
1384 <listitem>
1385 <para><literal>Jirka Kosek: xsl/webhelp.xsl; template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Minor cleanup, added extensibility hook, some styling moved into CSS for easier customization</phrase></screen>
1386 </listitem>
1387 <listitem>
1388 <para><literal>David Cramer: template/content/search/nwSearchFnt.js</literal></para><screen><phrase role="commit-message">Removing onclick that came from Oxygen's dita stuff</phrase></screen>
1389 </listitem>
1390 <listitem>
1391 <para><literal>kasunbg: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">webhelp - documenting about features</phrase></screen>
1392 </listitem>
1393 <listitem>
1394 <para><literal>kasunbg: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">webhelp search text box</phrase></screen>
1395 </listitem>
1396 <listitem>
1397 <para><literal>kasunbg: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">adding header background image</phrase></screen>
1398 </listitem>
1399 <listitem>
1400 <para><literal>kasunbg: xsl/webhelp.xsl; template/common/images/header-bg.png</literal></para><screen><phrase role="commit-message">new header background image</phrase></screen>
1401 </listitem>
1402 <listitem>
1403 <para><literal>kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">fix left navigation</phrase></screen>
1404 </listitem>
1405 <listitem>
1406 <para><literal>kasunbg: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">some css</phrase></screen>
1407 </listitem>
1408 <listitem>
1409 <para><literal>kasunbg: build.xml</literal></para><screen><phrase role="commit-message">Adding html.extension property</phrase></screen>
1410 </listitem>
1411 <listitem>
1412 <para><literal>kasunbg: template/common/css/positioning.css; build.properties; build.xml</literal></para><screen><phrase role="commit-message">webhelp - Adding enable.stemming, toc.file build properties</phrase></screen>
1413 </listitem>
1414 <listitem>
1415 <para><literal>David Cramer: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Make the webhelp banner slightly larger.</phrase></screen>
1416 </listitem>
1417 <listitem>
1418 <para><literal>David Cramer: template/common/main.js; template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Adjust colors and positioning of header and search/<tag>toc</tag> tabs</phrase></screen>
1419 </listitem>
1420 <listitem>
1421 <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Only put doc <tag>title</tag> in header</phrase></screen>
1422 </listitem>
1423 <listitem>
1424 <para><literal>David Cramer: template/common/css/positioning.css; template/common/images/main_bg_fade.png</literal></para><screen><phrase role="commit-message">Adjusting default color of the header</phrase></screen>
1425 </listitem>
1426 <listitem>
1427 <para><literal>kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">adjustments to header <tag>title</tag>. Now output in Opera looks good.</phrase></screen>
1428 </listitem>
1429 <listitem>
1430 <para><literal>kasunbg: template/common/images/sidebar.png; template/content/search/punctuation.props; te⋯</literal></para><screen><phrase role="commit-message">deleting svn:executable flag from webhelp files</phrase></screen>
1431 </listitem>
1432 <listitem>
1433 <para><literal>kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css; template/common/images/sear⋯</literal></para><screen><phrase role="commit-message">Customized the left navagation headers; Contents and Search.
1434 Adding custom css for the current redmond ui of jquery-ui. These override jquery-ui's default css customizations. These are supposed to take precedence.</phrase></screen>
1435 </listitem>
1436 <listitem>
1437 <para><literal>kasunbg: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">typo fix</phrase></screen>
1438 </listitem>
1439 <listitem>
1440 <para><literal>kasunbg: template/common/images/next-arrow.png; xsl/webhelp.xsl; template/common/main.js; ⋯</literal></para><screen><phrase role="commit-message">UI improvements.
1441         Moved search highligher to search tab.
1442         Added nice icons for navigation buttons etc.
1443         Removed footer navigation
1444         Corrected tree colorings
1445         Overall, some css magic</phrase></screen>
1446 </listitem>
1447 <listitem>
1448 <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Added <tag>listitem</tag> thinking SyncRO Soft for their contributions.</phrase></screen>
1449 </listitem>
1450 <listitem>
1451 <para><literal>kasunbg: build.xml</literal></para><screen><phrase role="commit-message">support for default classpath for Gentoo Linux</phrase></screen>
1452 </listitem>
1453 <listitem>
1454 <para><literal>kasunbg: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">webhelp - some updates to the documentation about search</phrase></screen>
1455 </listitem>
1456 <listitem>
1457 <para><literal>kasunbg: template/common/css/positioning.css</literal></para><screen><phrase role="commit-message">Fix for issue 'Keep "search" &amp; "contents" titles always visible in webhelp - ID: 3403438'</phrase></screen>
1458 </listitem>
1459 <listitem>
1460 <para><literal>David Cramer: template/common/images/starsSmall.png</literal></para><screen><phrase role="commit-message">Changed icons used to show search weightings from stars to boxes so they won't look like user ratings</phrase></screen>
1461 </listitem>
1462 <listitem>
1463 <para><literal>David Cramer: xsl/webhelp.xsl; template/common/main.js; template/common/images/starsSmall.⋯</literal></para><screen><phrase role="commit-message">Merged Oxygen webhelp improvements (search weightings etc) into trunk: -r9031:9039</phrase></screen>
1464 </listitem>
1465 <listitem>
1466 <para><literal>kasunbg: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">webhelp documentation - search indexing, faq</phrase></screen>
1467 </listitem>
1468 <listitem>
1469 <para><literal>kasunbg: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">update webhelp documentation</phrase></screen>
1470 </listitem>
1471 <listitem>
1472 <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Fixed bug where <parameter>webhelp.default.topic</parameter> was not being used if it was set</phrase></screen>
1473 </listitem>
1474 <listitem>
1475 <para><literal>David Cramer: xsl/webhelp.xsl; template/content/search/nwSearchFnt.js</literal></para><screen><phrase role="commit-message">Localize string in nwSearchFnt.js file</phrase></screen>
1476 </listitem>
1477 <listitem>
1478 <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Added tabindex attributes to make tab order in UI more logical in webhelp.</phrase></screen>
1479 </listitem>
1480 <listitem>
1481 <para><literal>David Cramer: template/common/main.js</literal></para><screen><phrase role="commit-message">Fixed bug where anchors in pages landed beneath the banner.</phrase></screen>
1482 </listitem>
1483 <listitem>
1484 <para><literal>kasunbg: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Added more comments to the xsl/webhelp/xsl/webhelp.xsl file. Removed some clutter.</phrase></screen>
1485 </listitem>
1486 <listitem>
1487 <para><literal>David Cramer: template/common/main.js</literal></para><screen><phrase role="commit-message">Fixed problem reported in IE 8. See tracker id # 373747.</phrase></screen>
1488 </listitem>
1489 <listitem>
1490 <para><literal>David Cramer: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Addressed tracker #3247166 by removing hard-coded <tag>reference</tag> to ch01.html.</phrase></screen>
1491 </listitem>
1492 <listitem>
1493 <para><literal>kasunbg: build.xml</literal></para><screen><phrase role="commit-message">Changed the webhelp build.xml to reflect the changes to xsl-webhelpindexer.
1494 Added classpaths for xercesImpl and xml-api jars to the indexer. Paths added for *nix environments, need to look at how the current system behaves in Windows. Discussion: http://lists.oasis-open.org/archives/docbook-apps/201011/msg00116.html</phrase></screen>
1495 </listitem>
1496 <listitem>
1497 <para><literal>kasunbg: template/common/images/loading.gif; template/common/jquery/treeview/jquery.treevi⋯</literal></para><screen><phrase role="commit-message">webhelp: Removing some unnecessary JQuery JS files</phrase></screen>
1498 </listitem>
1499 <listitem>
1500 <para><literal>kasunbg: template/common/main.js</literal></para><screen><phrase role="commit-message">webhelp: Usability improvement - when click on a node in the <tag>TOC</tag> tree, the child nodes will auto populate now.</phrase></screen>
1501 </listitem>
1502 <listitem>
1503 <para><literal>kasunbg: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Added google translated localizations for Japanese, German, French, and Chinese. The translations might not be pretty accurate.
1504 Better translations are appreciated.</phrase></screen>
1505 </listitem>
1506 <listitem>
1507 <para><literal>kasunbg: docsrc/readme.xml; template/content/images; template/content/images/sample.jpg</literal></para><screen><phrase role="commit-message">Added documentation for how to add images to WebHelp</phrase></screen>
1508 </listitem>
1509 <listitem>
1510 <para><literal>Jirka Kosek: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Added more customization hooks
1511 Search code output only when search tab is active
1512 Added cs localization</phrase></screen>
1513 </listitem>
1514 <listitem>
1515 <para><literal>Jirka Kosek: xsl/webhelp.xsl</literal></para><screen><phrase role="commit-message">Added parameter <parameter>webhelp.common.dir</parameter> for specifying location of common files (JS+CSS)
1516 Added hooks for adding additional user defined tabs</phrase></screen>
1517 </listitem>
1518 </itemizedlist>
1519 </sect2><!--end of Webhelp changes for snapshot_-->
1520
1521 <sect2 xml:id="rnV1.77_Params">
1522 <title>Params</title>
1523 <para>The following changes have been made to the
1524             <filename>params</filename> code
1525             since the 1.76.1 release.</para>
1526 <itemizedlist>
1527 <listitem>
1528 <para><literal>David Cramer: webhelp.indexer.language.xml</literal></para><screen><phrase role="commit-message">Webhelp: Fixing list of supported languages</phrase></screen>
1529 </listitem>
1530 <listitem>
1531 <para><literal>David Cramer: webhelp.indexer.language.xml</literal></para><screen><phrase role="commit-message">Webhelp: Correct language code in docs for Chinese</phrase></screen>
1532 </listitem>
1533 <listitem>
1534 <para><literal>Mauritz Jeanson: admon.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Added list of graphics formats.</phrase></screen>
1535 </listitem>
1536 <listitem>
1537 <para><literal>Mauritz Jeanson: passivetex.extensions.xml</literal></para><screen><phrase role="commit-message">Updated <tag>link</tag>.</phrase></screen>
1538 </listitem>
1539 <listitem>
1540 <para><literal>tom_schr: webhelp.indexer.language.xml; webhelp.default.topic.xml; webhelp.tree.cookie.id.⋯</literal></para><screen><phrase role="commit-message">Prepared WebHelp <tag>reference</tag> documentation :)
1541 Not clear about parameters brandname and branding: Should they renamed
1542 to "webhelp.branding" and "webhelp.brandname"?
1543 Currently, docsrc/reference.xml contains only a comment for the WebHelp
1544 ref doc to be non-intrusive.
1545 Idea is to enable it when it is ready</phrase></screen>
1546 </listitem>
1547 <listitem>
1548 <para><literal>Robert Stayton: glossary.collection.xml</literal></para><screen><phrase role="commit-message">Add <tag>info</tag> about relative paths.</phrase></screen>
1549 </listitem>
1550 <listitem>
1551 <para><literal>Robert Stayton: para.properties.xml</literal></para><screen><phrase role="commit-message">Special attribute-set for <tag>para</tag> only.</phrase></screen>
1552 </listitem>
1553 <listitem>
1554 <para><literal>Robert Stayton: table.caption.properties.xml</literal></para><screen><phrase role="commit-message">To format <tag>table</tag> captions.</phrase></screen>
1555 </listitem>
1556 <listitem>
1557 <para><literal>Robert Stayton: html.script.type.xml; html.script.xml</literal></para><screen><phrase role="commit-message">Add support for specifying javascript references like css references.</phrase></screen>
1558 </listitem>
1559 <listitem>
1560 <para><literal>Robert Stayton: body.margin.outer.xml; region.outer.extent.xml; body.margin.inner.xml; reg⋯</literal></para><screen><phrase role="commit-message">Add support for side regions in FO output.</phrase></screen>
1561 </listitem>
1562 <listitem>
1563 <para><literal>Robert Stayton: chunked.filename.prefix.xml</literal></para><screen><phrase role="commit-message">New param <parameter>chunked.filename.prefix</parameter> to separate any such prefix from
1564 the <parameter>base.dir</parameter> param, which helps fix bug 3087359.</phrase></screen>
1565 </listitem>
1566 <listitem>
1567 <para><literal>Robert Stayton: generate.consistent.ids.xml</literal></para><screen><phrase role="commit-message">New param to support replacing generate-id() with xsl:number
1568 for more consistent id values.</phrase></screen>
1569 </listitem>
1570 <listitem>
1571 <para><literal>Robert Stayton: task.properties.xml</literal></para><screen><phrase role="commit-message">Allow <tag>task</tag> to be customized more easily.</phrase></screen>
1572 </listitem>
1573 <listitem>
1574 <para><literal>Robert Stayton: calloutlist.properties.xml; callout.properties.xml</literal></para><screen><phrase role="commit-message">Support better customization of <tag>callout</tag> lists.</phrase></screen>
1575 </listitem>
1576 <listitem>
1577 <para><literal>Jirka Kosek: callout.unicode.start.character.xml</literal></para><screen><phrase role="commit-message">Added support for alternative circled numbers</phrase></screen>
1578 </listitem>
1579 <listitem>
1580 <para><literal>David Cramer: example.properties.xml</literal></para><screen><phrase role="commit-message">Made <parameter>example.properties</parameter> use keep-together='auto' like table.properies to avoid problems where example/<tag>programlisting</tag> takes more than one page</phrase></screen>
1581 </listitem>
1582 <listitem>
1583 <para><literal>Mauritz Jeanson: graphicsize.extension.xml</literal></para><screen><phrase role="commit-message">Added <tag>info</tag> about supported image formats.</phrase></screen>
1584 </listitem>
1585 </itemizedlist>
1586 </sect2><!--end of Params changes for snapshot_-->
1587
1588 <sect2 xml:id="rnV1.77_Highlighting">
1589 <title>Highlighting</title>
1590 <para>The following changes have been made to the
1591             <filename>highlighting</filename> code
1592             since the 1.76.1 release.</para>
1593 <itemizedlist>
1594 <listitem>
1595 <para><literal>Jirka Kosek: csharp-hl.xml</literal></para><screen><phrase role="commit-message">Added LINQ keywords</phrase></screen>
1596 </listitem>
1597 <listitem>
1598 <para><literal>Jirka Kosek: delphi-hl.xml</literal></para><screen><phrase role="commit-message">Additional keywords from Yuri Zhilin</phrase></screen>
1599 </listitem>
1600 </itemizedlist>
1601 </sect2><!--end of Highlighting changes for snapshot_-->
1602
1603 <sect2 xml:id="rnV1.77_Profiling">
1604 <title>Profiling</title>
1605 <para>The following changes have been made to the
1606             <filename>profiling</filename> code
1607             since the 1.76.1 release.</para>
1608 <itemizedlist>
1609 <listitem>
1610 <para><literal>David Cramer: profile-mode.xsl</literal></para><screen><phrase role="commit-message">When profile.* params only consist of space characters, then ignore them.</phrase></screen>
1611 </listitem>
1612 </itemizedlist>
1613 </sect2><!--end of Profiling changes for snapshot_-->
1614
1615 <sect2 xml:id="rnV1.77_Lib">
1616 <title>Lib</title>
1617 <para>The following changes have been made to the
1618             <filename>lib</filename> code
1619             since the 1.76.1 release.</para>
1620 <itemizedlist>
1621 <listitem>
1622 <para><literal>Robert Stayton: lib.xweb</literal></para><screen><phrase role="commit-message">Added two utility templates to make lib.xsl work
1623 without <tag>reference</tag> to other modules since it is used
1624 that way with profiling/xsl2profile.xsl.</phrase></screen>
1625 </listitem>
1626 <listitem>
1627 <para><literal>Robert Stayton: lib.xweb</literal></para><screen><phrase role="commit-message">Fix trim.common.uri.paths to first resolve any ../ in
1628 the paths.</phrase></screen>
1629 </listitem>
1630 </itemizedlist>
1631 </sect2><!--end of Lib changes for snapshot_-->
1632
1633 <sect2 xml:id="rnV1.77_Template">
1634 <title>Template</title>
1635 <para>The following changes have been made to the
1636             <filename>template</filename> code
1637             since the 1.76.1 release.</para>
1638 <itemizedlist>
1639 <listitem>
1640 <para><literal>Jirka Kosek: titlepage.xsl</literal></para><screen><phrase role="commit-message">Titlepage mechanism is now namespace aware to support XHTML. Please note that when generating titlepage template stylesheets you have to pass FO or XHTML namespace inside ns parameter. For HTML parameter should be empty.</phrase></screen>
1641 </listitem>
1642 </itemizedlist>
1643 </sect2><!--end of Template changes for snapshot_-->
1644
1645 <sect2 xml:id="rnV1.77_Extensions">
1646 <title>Extensions</title>
1647 <para>The following changes have been made to the
1648             <filename>extensions</filename> code
1649             since the 1.76.1 release.</para>
1650 <itemizedlist>
1651 <listitem>
1652 <para><literal>kasunbg: Makefile</literal></para><screen><phrase role="commit-message">webhelp - Adding enable.stemming, toc.file build properties</phrase></screen>
1653 </listitem>
1654 <listitem>
1655 <para><literal>David Cramer: Makefile</literal></para><screen><phrase role="commit-message">Attempt to convince Makefile that webhelpindexer is dirty</phrase></screen>
1656 </listitem>
1657 </itemizedlist>
1658 </sect2><!--end of Extensions changes for snapshot_-->
1659
1660 <sect2 xml:id="rnV1.77_XSL-Saxon">
1661 <title>XSL-Saxon</title>
1662 <para>The following changes have been made to the
1663             <filename>xsl-saxon</filename> code
1664             since the 1.76.1 release.</para>
1665 <itemizedlist>
1666 <listitem>
1667 <para><literal>Mauritz Jeanson: src/com/nwalsh/saxon/Verbatim.java; src/com/nwalsh/saxon/FormatGraphicCal⋯</literal></para><screen><phrase role="commit-message">Added fixes to ensure that generated XHTML markup for callouts is in the proper namespace.</phrase></screen>
1668 </listitem>
1669 </itemizedlist>
1670 </sect2><!--end of XSL-Saxon changes for snapshot_-->
1671
1672 </sect1>
1673 <sect1 xml:id="V1.77.1">
1674 <title>Release Notes: 1.77.1</title>
1675 <para>The following is a list of changes that have been made
1676         since the 1.77.0 release.</para>
1677
1678 <sect2 xml:id="Vsnapshot_9396_FO">
1679 <title>FO</title>
1680 <para>The following changes have been made to the
1681             <filename>fo</filename> code
1682             since the 1.77.0 release.</para>
1683 <itemizedlist>
1684 <listitem>
1685 <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
1686 from the <tag>filename</tag>.</phrase></screen>
1687 </listitem>
1688 <listitem>
1689 <para><literal>Robert Stayton: block.xsl</literal></para><screen><phrase role="commit-message">In <tag>sidebar</tag>, turn off space before first <tag>para</tag> if there is no <tag>title</tag>.</phrase></screen>
1690 </listitem>
1691 <listitem>
1692 <para><literal>Robert Stayton: math.xsl</literal></para><screen><phrase role="commit-message">Restored templates for mml:* elements that were accidentally deleted.</phrase></screen>
1693 </listitem>
1694 </itemizedlist>
1695 </sect2><!--end of FO changes for snapshot_9396-->
1696
1697 <sect2 xml:id="Vsnapshot_9396_HTML">
1698 <title>HTML</title>
1699 <para>The following changes have been made to the
1700             <filename>html</filename> code
1701             since the 1.77.0 release.</para>
1702 <itemizedlist>
1703 <listitem>
1704 <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
1705 from the <tag>filename</tag>.</phrase></screen>
1706 </listitem>
1707 <listitem>
1708 <para><literal>Robert Stayton: sections.xsl</literal></para><screen><phrase role="commit-message">Use $div.element variable in place of div to support html5 <tag>section</tag> element.
1709 output</phrase></screen>
1710 </listitem>
1711 <listitem>
1712 <para><literal>Robert Stayton: autoidx.xsl</literal></para><screen><phrase role="commit-message">Fix bug 3528673, missing "separator" param on template with
1713 match="<tag>indexterm</tag>" mode="<tag>reference</tag>".  That param is passed
1714 for endofrange processing to output the range separator.</phrase></screen>
1715 </listitem>
1716 </itemizedlist>
1717 </sect2><!--end of HTML changes for snapshot_9396-->
1718
1719 <sect2 xml:id="Vsnapshot_9396_Roundtrip">
1720 <title>Roundtrip</title>
1721 <para>The following changes have been made to the
1722             <filename>roundtrip</filename> code
1723             since the 1.77.0 release.</para>
1724 <itemizedlist>
1725 <listitem>
1726 <para><literal>Robert Stayton: dbk2ooo.xsl; dbk2pages.xsl; dbk2wordml.xsl; dbk2wp.xsl</literal></para><screen><phrase role="commit-message">Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
1727 from the <tag>filename</tag>.</phrase></screen>
1728 </listitem>
1729 </itemizedlist>
1730 </sect2><!--end of Roundtrip changes for snapshot_9396-->
1731
1732 <sect2 xml:id="Vsnapshot_9396_Slides">
1733 <title>Slides</title>
1734 <para>The following changes have been made to the
1735             <filename>slides</filename> code
1736             since the 1.77.0 release.</para>
1737 <itemizedlist>
1738 <listitem>
1739 <para><literal>Robert Stayton: html/slides-common.xsl</literal></para><screen><phrase role="commit-message">Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
1740 from the <tag>filename</tag>.</phrase></screen>
1741 </listitem>
1742 </itemizedlist>
1743 </sect2><!--end of Slides changes for snapshot_9396-->
1744
1745 <sect2 xml:id="Vsnapshot_9396_Website">
1746 <title>Website</title>
1747 <para>The following changes have been made to the
1748             <filename>website</filename> code
1749             since the 1.77.0 release.</para>
1750 <itemizedlist>
1751 <listitem>
1752 <para><literal>Robert Stayton: website-common.xsl</literal></para><screen><phrase role="commit-message">Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
1753 from the <tag>filename</tag>.</phrase></screen>
1754 </listitem>
1755 </itemizedlist>
1756 </sect2><!--end of Website changes for snapshot_9396-->
1757
1758 <sect2 xml:id="Vsnapshot_9396_Webhelp">
1759 <title>Webhelp</title>
1760 <para>The following changes have been made to the
1761             <filename>webhelp</filename> code
1762             since the 1.77.0 release.</para>
1763 <itemizedlist>
1764 <listitem>
1765 <para><literal>kasunbg: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">updated webhelp documentation</phrase></screen>
1766 </listitem>
1767 <listitem>
1768 <para><literal>kasunbg: template/content/search/nwSearchFnt.js; xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">Removed the script htmlFileList.js since it's content is in htmlFileInfoList.js</phrase></screen>
1769 </listitem>
1770 <listitem>
1771 <para><literal>Robert Stayton: xsl/webhelp-common.xsl</literal></para><screen><phrase role="commit-message">In the &lt;h1&gt; output, replace call to 'get.doc.title' with
1772 mode="title.markup" because get.doc.title returns only
1773 the string value of the <tag>title</tag>, losing any markup such
1774 as &lt;<tag>trademark</tag>&gt; or &lt;<tag>superscript</tag>&gt;.</phrase></screen>
1775 </listitem>
1776 <listitem>
1777 <para><literal>kasunbg: template/common/css/positioning.css; template/content/search/nwSearchFnt.js</literal></para><screen><phrase role="commit-message">Remove unnecessary bits of code from webhelp</phrase></screen>
1778 </listitem>
1779 <listitem>
1780 <para><literal>David Cramer: docsrc/readme.xml</literal></para><screen><phrase role="commit-message">Webhelp: Minor edits to the readme</phrase></screen>
1781 </listitem>
1782 <listitem>
1783 <para><literal>David Cramer: xsl/webhelp.xsl; xsl/titlepage.templates.xsl; xsl/titlepage.templates.xml</literal></para><screen><phrase role="commit-message">Webhelp: Suppress abstracts from titlepages. These are used to create the search result summary sentence and should not be shown</phrase></screen>
1784 </listitem>
1785 <listitem>
1786 <para><literal>David Cramer: build.xml</literal></para><screen><phrase role="commit-message">Webhelp: calculate path to profile.xsl from main build.xml file</phrase></screen>
1787 </listitem>
1788 </itemizedlist>
1789 </sect2><!--end of Webhelp changes for snapshot_9396-->
1790
1791 </sect1>
1792 <sect1 xml:id="V1.76.1">
1793 <title>Release Notes: 1.76.1</title>
1794 <para>The following is a list of changes that have been made
1795         since the 1.76.0 release.</para>
1796
1797 <sect2 xml:id="rnV1.76.1_FO">
1798 <title>FO</title>
1799 <para>The following changes have been made to the
1800             <filename>fo</filename> code
1801             since the 1.76.0 release.</para>
1802 <itemizedlist>
1803 <listitem>
1804 <para><literal>Robert Stayton: docbook.xsl; xref.xsl; fop1.xsl</literal></para><screen><phrase role="commit-message">Apply patch to support named destination in fop1.xsl, per Sourceforge
1805 bug report #3029845.</phrase></screen>
1806 </listitem>
1807 </itemizedlist>
1808 </sect2><!--end of FO changes for 1.76.1-->
1809
1810 <sect2 xml:id="rnV1.76.1_HTML">
1811 <title>HTML</title>
1812 <para>The following changes have been made to the <filename>html</filename> code since the 1.76.0 release.</para>
1813 <itemizedlist>
1814 <listitem>
1815 <para><literal>Keith Fahlgren: highlight.xsl</literal></para><screen><phrase role="commit-message">Implementing handling for &lt;b&gt; and &lt;i&gt;: transform to &lt;strong&gt; and &lt;em&gt; for XHTML outputs and do not use in the highliting output (per Mauritz Jeanson)</phrase></screen>
1816 </listitem>
1817 </itemizedlist>
1818 </sect2><!--end of HTML changes for 1.76.1-->
1819
1820 <sect2 xml:id="rnV1.76.1_Params">
1821 <title>Params</title>
1822 <para>The following changes have been made to the
1823             <filename>params</filename> code
1824             since the 1.76.0 release.</para>
1825 <itemizedlist>
1826 <listitem>
1827 <para><literal>Robert Stayton: draft.mode.xml</literal></para><screen><phrase role="commit-message">Change default for <parameter>draft.mode</parameter> to 'no'.</phrase></screen>
1828 </listitem>
1829 </itemizedlist>
1830 </sect2><!--end of Params changes for 1.76.1-->
1831
1832
1833 </sect1>
1834   <sect1 xml:id="V1.76.0">
1835     <title>Release Notes: 1.76.0</title>
1836 <para>This release includes important bug fixes and adds the following
1837 significant feature changes:</para>
1838 <variablelist>
1839 <varlistentry>
1840 <term>Webhelp</term>
1841 <listitem><para>A new browser-based, cross-platform help format with full-text search and other features typically found in help systems. See <filename>webhelp/docs/content/ch01.html</filename> for more information and a demo. </para></listitem>
1842
1843 </varlistentry>
1844
1845 <varlistentry>
1846 <term>Gentext</term>
1847 <listitem><para>Many updates and additions to translation/locales thanks to Red Hat, the Fedora Project, and other contributors.</para></listitem>
1848 </varlistentry>
1849 <varlistentry>
1850 <term>Common</term>
1851 <listitem><para>Faster localization support, as language files are loaded on demand.</para></listitem>
1852
1853 </varlistentry>
1854             <varlistentry>
1855             <term>FO</term>
1856             <listitem><para>Support for SVG content in <tag>imagedata</tag> added.</para></listitem>
1857 </varlistentry>
1858             <varlistentry>
1859             <term>HTML</term>
1860             <listitem><para>Output improved when using '<parameter>make.clean.html</parameter>' and a stock CSS file is now provided.</para></listitem>
1861 </varlistentry>
1862 <varlistentry>
1863 <term>EPUB</term>
1864 <listitem><para>A number of improvements to NCX, cover and image selection, and XHTML 1.1 element choices</para></listitem>
1865 </varlistentry>
1866
1867 </variablelist>
1868
1869     <para>The following is a list of changes that have been made since the 1.75.2 release.</para>
1870     <sect2 xml:id="rnV1.76.0_Gentext">
1871       <title>Gentext</title>
1872       <para>The following changes have been made to the <filename>gentext</filename> code since the 1.75.2 release.</para>
1873       <itemizedlist>
1874         <listitem>
1875           <para>
1876             <literal>rlandmann: locale/fa.xml</literal>
1877           </para>
1878           <screen>
1879             <phrase role="commit-message">Update to Persian translation from the Fedora Project</phrase>
1880           </screen>
1881         </listitem>
1882         <listitem>
1883           <para>
1884             <literal>rlandmann: locale/nds.xml</literal>
1885           </para>
1886           <screen>
1887             <phrase role="commit-message">Locale for Low German</phrase>
1888           </screen>
1889         </listitem>
1890         <listitem>
1891           <para>
1892             <literal>Mauritz Jeanson: locale/ka.xml; Makefile</literal>
1893           </para>
1894           <screen>
1895             <phrase role="commit-message">Added support for Georgian based on patch #2917147.</phrase>
1896           </screen>
1897         </listitem>
1898         <listitem>
1899           <para>
1900             <literal>rlandmann: locale/nl.xml; locale/ja.xml</literal>
1901           </para>
1902           <screen>
1903             <phrase role="commit-message">Updated translations from Red Hat and the Fedora Project</phrase>
1904           </screen>
1905         </listitem>
1906         <listitem>
1907           <para>
1908             <literal>rlandmann: locale/bs.xml; locale/ru.xml; locale/hr.xml</literal>
1909           </para>
1910           <screen>
1911             <phrase role="commit-message">Updated locales from Red Hat and the Fedora Project</phrase>
1912           </screen>
1913         </listitem>
1914         <listitem>
1915           <para>
1916             <literal>rlandmann: locale/pt.xml; locale/cs.xml; locale/es.xml; locale/bg.xml; locale/nl.xml; loca⋯</literal>
1917           </para>
1918           <screen>
1919             <phrase role="commit-message">Updated translations from Red Hat and the Fedora Project</phrase>
1920           </screen>
1921         </listitem>
1922         <listitem>
1923           <para>
1924             <literal>rlandmann: locale/as.xml; locale/bn_IN.xml; locale/ast.xml; locale/ml.xml; locale/te.xml; ⋯</literal>
1925           </para>
1926           <screen>
1927             <phrase role="commit-message">New translations from Red Hat and the Fedora Project</phrase>
1928           </screen>
1929         </listitem>
1930         <listitem>
1931           <para>
1932             <literal>rlandmann: locale/pt.xml; locale/ca.xml; locale/da.xml; locale/sr.xml; locale/ru.xml; loca⋯</literal>
1933           </para>
1934           <screen>
1935             <phrase role="commit-message">Updated translations from Red Hat and the Fedora Project</phrase>
1936           </screen>
1937         </listitem>
1938       </itemizedlist>
1939     </sect2>
1940     <!--end of Gentext changes for 1.76.0-->
1941     <sect2 xml:id="rnV1.76.0_Common">
1942       <title>Common</title>
1943       <para>The following changes have been made to the <filename>common</filename> code since the 1.75.2 release.</para>
1944       <itemizedlist>
1945         <listitem>
1946           <para>
1947             <literal>Mauritz Jeanson: common.xsl</literal>
1948           </para>
1949           <screen>
1950             <phrase role="commit-message">Fixed bug in output-orderedlist-starting-number template (@startingnumber did not work for FO).</phrase>
1951           </screen>
1952         </listitem>
1953         <listitem>
1954           <para>
1955             <literal>Mauritz Jeanson: gentext.xsl</literal>
1956           </para>
1957           <screen>
1958             <phrase role="commit-message">Added fix to catch ID also of descendants of <tag>listitem</tag>. Closes bug #2955077.</phrase>
1959           </screen>
1960         </listitem>
1961         <listitem>
1962           <para>
1963             <literal>Jirka Kosek: l10n.xsl</literal>
1964           </para>
1965           <screen>
1966             <phrase role="commit-message">Stripped down, faster version of gentext.template is used when there is no localization customization.</phrase>
1967           </screen>
1968         </listitem>
1969         <listitem>
1970           <para>
1971             <literal>Mauritz Jeanson: stripns.xsl</literal>
1972           </para>
1973           <screen>
1974             <phrase role="commit-message">Added fix that preserves <tag>link</tag>/@role (makes links in the <tag>reference</tag> documentation
1975 with @role="tcg" work).</phrase>
1976           </screen>
1977         </listitem>
1978         <listitem>
1979           <para>
1980             <literal>Mauritz Jeanson: l10n.xsl</literal>
1981           </para>
1982           <screen>
1983             <phrase role="commit-message">Fixed bugs related to manpages and L10n.</phrase>
1984           </screen>
1985         </listitem>
1986         <listitem>
1987           <para>
1988             <literal>Jirka Kosek: entities.ent; autoidx-kosek.xsl</literal>
1989           </para>
1990           <screen>
1991             <phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
1992           </screen>
1993         </listitem>
1994         <listitem>
1995           <para>
1996             <literal>Jirka Kosek: l10n.xsl; l10n.dtd; l10n.xml; autoidx-kosek.xsl</literal>
1997           </para>
1998           <screen>
1999             <phrase role="commit-message">Refactored localization support. Language files are loaded on demand. Speedup is about 30%.</phrase>
2000           </screen>
2001         </listitem>
2002         <listitem>
2003           <para>
2004             <literal>Jirka Kosek: l10n.xsl</literal>
2005           </para>
2006           <screen>
2007             <phrase role="commit-message">Added xsl:keys for improved performance of localization texts look up. Performance gain around 15%.</phrase>
2008           </screen>
2009         </listitem>
2010         <listitem>
2011           <para>
2012             <literal>Mauritz Jeanson: titles.xsl</literal>
2013           </para>
2014           <screen>
2015             <phrase role="commit-message">Fixed bug #2912677 (error with <tag>xref</tag> in <tag>title</tag>).</phrase>
2016           </screen>
2017         </listitem>
2018         <listitem>
2019           <para>
2020             <literal>Robert Stayton: olink.xsl</literal>
2021           </para>
2022           <screen>
2023             <phrase role="commit-message">Fix bug in xrefstyle "<tag>title</tag>" handling introduced with
2024 the 'insert.targetdb.data' template.</phrase>
2025           </screen>
2026         </listitem>
2027         <listitem>
2028           <para>
2029             <literal>Robert Stayton: gentext.xsl</literal>
2030           </para>
2031           <screen>
2032             <phrase role="commit-message">Fix bug in <tag>xref</tag> to <tag>equation</tag> without <tag>title</tag> to use context="xref-number" instead
2033 of "xref-number-and-title".</phrase>
2034           </screen>
2035         </listitem>
2036         <listitem>
2037           <para>
2038             <literal>Robert Stayton: labels.xsl</literal>
2039           </para>
2040           <screen>
2041             <phrase role="commit-message">Number all equations in one sequence, with or without <tag>title</tag>.</phrase>
2042           </screen>
2043         </listitem>
2044         <listitem>
2045           <para>
2046             <literal>Robert Stayton: entities.ent</literal>
2047           </para>
2048           <screen>
2049             <phrase role="commit-message">Fix bug #2896909 where duplicate @sortas on indexterms caused
2050 some indexterms to drop out of <tag>index</tag>.</phrase>
2051           </screen>
2052         </listitem>
2053         <listitem>
2054           <para>
2055             <literal>Robert Stayton: stripns.xsl</literal>
2056           </para>
2057           <screen>
2058             <phrase role="commit-message">Expand the "Stripping namespace ..." message to advise users to
2059 use the namespaced stylesheets.</phrase>
2060           </screen>
2061         </listitem>
2062         <listitem>
2063           <para>
2064             <literal>Robert Stayton: stripns.xsl</literal>
2065           </para>
2066           <screen>
2067             <phrase role="commit-message">need a local version of $exsl.node.set.available variable because
2068 this module imported many places.</phrase>
2069           </screen>
2070         </listitem>
2071         <listitem>
2072           <para>
2073             <literal>Mauritz Jeanson: olink.xsl</literal>
2074           </para>
2075           <screen>
2076             <phrase role="commit-message">Added /node() to the select expression that is used to compute the <tag>title</tag> text
2077 so that no &lt;ttl&gt; elements end up in the output. Closes bug #2830119.</phrase>
2078           </screen>
2079         </listitem>
2080       </itemizedlist>
2081     </sect2>
2082     <!--end of Common changes for 1.76.0-->
2083     <sect2 xml:id="rnV1.76.0_FO">
2084       <title>FO</title>
2085       <para>The following changes have been made to the
2086             <filename>fo</filename> code
2087             since the 1.75.2 release.</para>
2088       <itemizedlist>
2089         <listitem>
2090           <para>
2091             <literal>Robert Stayton: table.xsl</literal>
2092           </para>
2093           <screen>
2094             <phrase role="commit-message">Fix bug 2979166 able - Attribute @rowheader not working</phrase>
2095           </screen>
2096         </listitem>
2097         <listitem>
2098           <para>
2099             <literal>Mauritz Jeanson: inline.xsl</literal>
2100           </para>
2101           <screen>
2102             <phrase role="commit-message">Improved <tag>glossterm</tag> auto-linking by using keys. The old code was inefficient when processing documents
2103 with many inline glossterms.</phrase>
2104           </screen>
2105         </listitem>
2106         <listitem>
2107           <para>
2108             <literal>Robert Stayton: titlepage.xsl</literal>
2109           </para>
2110           <screen>
2111             <phrase role="commit-message">Fix bug 2805530 <tag>author</tag>/<tag>orgname</tag> not appearing on <tag>title</tag> page.</phrase>
2112           </screen>
2113         </listitem>
2114         <listitem>
2115           <para>
2116             <literal>Mauritz Jeanson: graphics.xsl</literal>
2117           </para>
2118           <screen>
2119             <phrase role="commit-message">Added support for SVG content in <tag>imagedata</tag> (inspired by patch #2909154).</phrase>
2120           </screen>
2121         </listitem>
2122         <listitem>
2123           <para>
2124             <literal>Mauritz Jeanson: table.xsl</literal>
2125           </para>
2126           <screen>
2127             <phrase role="commit-message">Removed superfluous test used when computing column-width. Closes bug #3000898.</phrase>
2128           </screen>
2129         </listitem>
2130         <listitem>
2131           <para>
2132             <literal>Mauritz Jeanson: inline.xsl</literal>
2133           </para>
2134           <screen>
2135             <phrase role="commit-message">Added missing &lt;xsl:call-template name="<tag>anchor</tag>"/&gt;. Closes bug #2998567.</phrase>
2136           </screen>
2137         </listitem>
2138         <listitem>
2139           <para>
2140             <literal>Mauritz Jeanson: lists.xsl</literal>
2141           </para>
2142           <screen>
2143             <phrase role="commit-message">Added table-layout="fixed" on <tag>segmentedlist</tag> <tag>table</tag> (required by XSL spec when  proportional-column-width() is used).</phrase>
2144           </screen>
2145         </listitem>
2146         <listitem>
2147           <para>
2148             <literal>Jirka Kosek: autoidx-kosek.xsl</literal>
2149           </para>
2150           <screen>
2151             <phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
2152           </screen>
2153         </listitem>
2154         <listitem>
2155           <para>
2156             <literal>Jirka Kosek: index.xsl</literal>
2157           </para>
2158           <screen>
2159             <phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
2160           </screen>
2161         </listitem>
2162         <listitem>
2163           <para>
2164             <literal>Robert Stayton: xref.xsl</literal>
2165           </para>
2166           <screen>
2167             <phrase role="commit-message">Fix bug in <tag>olink</tag> template when an <tag>olink</tag> has an id.
2168 Add warning message with id value when trying to <tag>link</tag>
2169 to an element that has no generated text.</phrase>
2170           </screen>
2171         </listitem>
2172         <listitem>
2173           <para>
2174             <literal>Mauritz Jeanson: refentry.xsl</literal>
2175           </para>
2176           <screen>
2177             <phrase role="commit-message">Fixed bug #2930968 (<tag>indexterm</tag> in <tag>refmeta</tag> not handled correctly).</phrase>
2178           </screen>
2179         </listitem>
2180         <listitem>
2181           <para>
2182             <literal>Robert Stayton: block.xsl</literal>
2183           </para>
2184           <screen>
2185             <phrase role="commit-message">fix bug 2949567 <tag>title</tag> in <tag>revhistory</tag> breaks FO transform.</phrase>
2186           </screen>
2187         </listitem>
2188         <listitem>
2189           <para>
2190             <literal>Robert Stayton: glossary.xsl</literal>
2191           </para>
2192           <screen>
2193             <phrase role="commit-message">Output id attributes on <tag>glossdiv</tag> blocks so they can be added to
2194 xrefs or <tag>TOC</tag>.</phrase>
2195           </screen>
2196         </listitem>
2197         <listitem>
2198           <para>
2199             <literal>Jirka Kosek: xref.xsl</literal>
2200           </para>
2201           <screen>
2202             <phrase role="commit-message">Enabled hyphenation of URLs when ulink content is the same as <tag>link</tag> target</phrase>
2203           </screen>
2204         </listitem>
2205         <listitem>
2206           <para>
2207             <literal>Robert Stayton: table.xsl</literal>
2208           </para>
2209           <screen>
2210             <phrase role="commit-message">Apply patch to turn off <tag>row</tag> recursion if no @morerows attributes present.
2211 This will enable very large tables without <tag>row</tag> spanning to
2212 process without running into recursion limits.</phrase>
2213           </screen>
2214         </listitem>
2215         <listitem>
2216           <para>
2217             <literal>Robert Stayton: formal.xsl</literal>
2218           </para>
2219           <screen>
2220             <phrase role="commit-message">Format <tag>equation</tag> without <tag>title</tag> using <tag>table</tag> layout with <tag>equation</tag> number
2221 next to the <tag>equation</tag>.</phrase>
2222           </screen>
2223         </listitem>
2224         <listitem>
2225           <para>
2226             <literal>Robert Stayton: param.xweb; param.ent</literal>
2227           </para>
2228           <screen>
2229             <phrase role="commit-message">Add <parameter>equation.number.properties</parameter>.</phrase>
2230           </screen>
2231         </listitem>
2232       </itemizedlist>
2233     </sect2>
2234     <!--end of FO changes for 1.76.0-->
2235     <sect2 xml:id="rnV1.76.0_HTML">
2236       <title>HTML</title>
2237       <para>The following changes have been made to the
2238             <filename>html</filename> code
2239             since the 1.75.2 release.</para>
2240       <itemizedlist>
2241         <listitem>
2242           <para>
2243             <literal>Mauritz Jeanson: block.xsl</literal>
2244           </para>
2245           <screen>
2246             <phrase role="commit-message">Modified <tag>acknowledgements</tag> template to avoid invalid output (&lt;p&gt; in &lt;p&gt;).</phrase>
2247           </screen>
2248         </listitem>
2249         <listitem>
2250           <para>
2251             <literal>Mauritz Jeanson: titlepage.xsl</literal>
2252           </para>
2253           <screen>
2254             <phrase role="commit-message">Added default <tag>sidebar</tag> attribute-sets.</phrase>
2255           </screen>
2256         </listitem>
2257         <listitem>
2258           <para>
2259             <literal>Robert Stayton: table.xsl</literal>
2260           </para>
2261           <screen>
2262             <phrase role="commit-message">Fix bug 2979166 able - Attribute @rowheader not working</phrase>
2263           </screen>
2264         </listitem>
2265         <listitem>
2266           <para>
2267             <literal>Robert Stayton: footnote.xsl</literal>
2268           </para>
2269           <screen>
2270             <phrase role="commit-message">Fix bug 3033191 footnotes in html tables.</phrase>
2271           </screen>
2272         </listitem>
2273         <listitem>
2274           <para>
2275             <literal>Mauritz Jeanson: inline.xsl</literal>
2276           </para>
2277           <screen>
2278             <phrase role="commit-message">Improved <tag>glossterm</tag> auto-linking by using keys. The old code was inefficient when processing documents
2279 with many inline glossterms.</phrase>
2280           </screen>
2281         </listitem>
2282         <listitem>
2283           <para>
2284             <literal>Robert Stayton: docbook.css.xml; verbatim.xsl</literal>
2285           </para>
2286           <screen>
2287             <phrase role="commit-message">Fix bug 2844927 Validity error for <tag>callout</tag> bugs.</phrase>
2288           </screen>
2289         </listitem>
2290         <listitem>
2291           <para>
2292             <literal>Robert Stayton: formal.xsl</literal>
2293           </para>
2294           <screen>
2295             <phrase role="commit-message">Convert formal.object.heading to respect <parameter>make.clean.html</parameter> param.</phrase>
2296           </screen>
2297         </listitem>
2298         <listitem>
2299           <para>
2300             <literal>Robert Stayton: titlepage.templates.xml; block.xsl</literal>
2301           </para>
2302           <screen>
2303             <phrase role="commit-message">Fix bug 2840768 <tag>sidebar</tag> without <tag>title</tag> inserts empty b <tag>tag</tag>.</phrase>
2304           </screen>
2305         </listitem>
2306         <listitem>
2307           <para>
2308             <literal>Mauritz Jeanson: docbook.xsl</literal>
2309           </para>
2310           <screen>
2311             <phrase role="commit-message">Moved the template that outputs &lt;base&gt; so that the base URI also applies to relative CSS paths that come later.
2312 See patch #2896121.</phrase>
2313           </screen>
2314         </listitem>
2315         <listitem>
2316           <para>
2317             <literal>Jirka Kosek: autoidx-kosek.xsl</literal>
2318           </para>
2319           <screen>
2320             <phrase role="commit-message">Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.</phrase>
2321           </screen>
2322         </listitem>
2323         <listitem>
2324           <para>
2325             <literal>Robert Stayton: chunk-code.xsl</literal>
2326           </para>
2327           <screen>
2328             <phrase role="commit-message">fix bug 2948363 generated <tag>filename</tag> for <tag>refentry</tag> not unique, when
2329 used in a set.</phrase>
2330           </screen>
2331         </listitem>
2332         <listitem>
2333           <para>
2334             <literal>Robert Stayton: component.xsl</literal>
2335           </para>
2336           <screen>
2337             <phrase role="commit-message">Fix missing "<tag>Chapter</tag> n" <tag>label</tag> when use <tag>chapter</tag>/<tag>info</tag>/<tag>title</tag>.</phrase>
2338           </screen>
2339         </listitem>
2340         <listitem>
2341           <para>
2342             <literal>Robert Stayton: table.xsl</literal>
2343           </para>
2344           <screen>
2345             <phrase role="commit-message"><tag>Row</tag> recursion turned off if no @morerows attributes in the <tag>table</tag>.
2346 This will prevent failure on long <tag>table</tag> (with no @morerows) due
2347 to excessive depth of recursion.</phrase>
2348           </screen>
2349         </listitem>
2350         <listitem>
2351           <para>
2352             <literal>Robert Stayton: autotoc.xsl; docbook.css.xml</literal>
2353           </para>
2354           <screen>
2355             <phrase role="commit-message">Support <parameter>make.clean.html</parameter> in autotoc.xsl.</phrase>
2356           </screen>
2357         </listitem>
2358         <listitem>
2359           <para>
2360             <literal>Robert Stayton: docbook.css.xml; block.xsl</literal>
2361           </para>
2362           <screen>
2363             <phrase role="commit-message">Add support for <parameter>make.clean.html</parameter> setting in block elements.</phrase>
2364           </screen>
2365         </listitem>
2366         <listitem>
2367           <para>
2368             <literal>Robert Stayton: docbook.css.xml</literal>
2369           </para>
2370           <screen>
2371             <phrase role="commit-message">Stock CSS styles for DocBook HTML output when '<parameter>make.clean.html</parameter>' is non-zero.</phrase>
2372           </screen>
2373         </listitem>
2374         <listitem>
2375           <para>
2376             <literal>Robert Stayton: html.xsl</literal>
2377           </para>
2378           <screen>
2379             <phrase role="commit-message">Add templates for generating CSS files and links to them.</phrase>
2380           </screen>
2381         </listitem>
2382         <listitem>
2383           <para>
2384             <literal>Robert Stayton: param.xweb</literal>
2385           </para>
2386           <screen>
2387             <phrase role="commit-message">Fix bugs in new entity references.</phrase>
2388           </screen>
2389         </listitem>
2390         <listitem>
2391           <para>
2392             <literal>Robert Stayton: chunk-common.xsl</literal>
2393           </para>
2394           <screen>
2395             <phrase role="commit-message">List of Equations now includes on equations with titles.</phrase>
2396           </screen>
2397         </listitem>
2398         <listitem>
2399           <para>
2400             <literal>Robert Stayton: table.xsl</literal>
2401           </para>
2402           <screen>
2403             <phrase role="commit-message">If a <tag>colspec</tag> has a colname attribute, add it to the HTML <tag>col</tag>
2404 element as a class attribute so it can be styled.</phrase>
2405           </screen>
2406         </listitem>
2407         <listitem>
2408           <para>
2409             <literal>Robert Stayton: formal.xsl</literal>
2410           </para>
2411           <screen>
2412             <phrase role="commit-message">Fix bug 2825842 where <tag>table</tag> footnotes not appearing in HTML-coded <tag>table</tag>.</phrase>
2413           </screen>
2414         </listitem>
2415         <listitem>
2416           <para>
2417             <literal>Robert Stayton: chunktoc.xsl</literal>
2418           </para>
2419           <screen>
2420             <phrase role="commit-message">Fix bug #2834826 where <tag>appendix</tag> inside part was not chunked as it should be.</phrase>
2421           </screen>
2422         </listitem>
2423         <listitem>
2424           <para>
2425             <literal>Mauritz Jeanson: chunktoc.xsl</literal>
2426           </para>
2427           <screen>
2428             <phrase role="commit-message">Added missing namespace declarations. Closes bug #2890069.</phrase>
2429           </screen>
2430         </listitem>
2431         <listitem>
2432           <para>
2433             <literal>Mauritz Jeanson: footnote.xsl</literal>
2434           </para>
2435           <screen>
2436             <phrase role="commit-message">Updated the template for <tag>footnote</tag> paras to use the 'paragraph' template. Closes bug #2803739.</phrase>
2437           </screen>
2438         </listitem>
2439         <listitem>
2440           <para>
2441             <literal>Keith Fahlgren: inline.xsl; lists.xsl</literal>
2442           </para>
2443           <screen>
2444             <phrase role="commit-message">Remove &lt;b&gt; and &lt;i&gt; elements "discouraged in favor of style sheets" from
2445 XHTML, XHTML 1.1 (and therefore EPUB) outputs by changing html2xhtml.xsl.
2446
2447 Fixes bug #2873153: No &lt;b&gt; and &lt;i&gt; tags in XHTML/EPUB
2448
2449 Added regression to EPUB specs:</phrase>
2450           </screen>
2451         </listitem>
2452         <listitem>
2453           <para>
2454             <literal>Mauritz Jeanson: inline.xsl</literal>
2455           </para>
2456           <screen>
2457             <phrase role="commit-message">Fixed bug #2844916 (don't output @target if <parameter>ulink.target</parameter> is empty).</phrase>
2458           </screen>
2459         </listitem>
2460         <listitem>
2461           <para>
2462             <literal>Keith Fahlgren: autoidx.xsl</literal>
2463           </para>
2464           <screen>
2465             <phrase role="commit-message">Fix a bug when using <parameter>index.on.type</parameter>: an '<tag>index</tag> symbols' <tag>section</tag> was created
2466 even if that typed <tag>index</tag> didn't include any symbols (they were in the other types).</phrase>
2467           </screen>
2468         </listitem>
2469       </itemizedlist>
2470     </sect2>
2471     <!--end of HTML changes for 1.76.0-->
2472     <sect2 xml:id="rnV1.76.0_Manpages">
2473       <title>Manpages</title>
2474       <para>The following changes have been made to the
2475             <filename>manpages</filename> code
2476             since the 1.75.2 release.</para>
2477       <itemizedlist>
2478         <listitem>
2479           <para>
2480             <literal>Mauritz Jeanson: other.xsl</literal>
2481           </para>
2482           <screen>
2483             <phrase role="commit-message">Modified the write.stubs template so that the <tag>section</tag> directory name is not output twice. Should fix bug #2831602.
2484 Also ensured that $lang is added to the .so path (when <parameter>man.output.lang.in.name.enabled</parameter>=1).</phrase>
2485           </screen>
2486         </listitem>
2487         <listitem>
2488           <para>
2489             <literal>Mauritz Jeanson: docbook.xsl; other.xsl</literal>
2490           </para>
2491           <screen>
2492             <phrase role="commit-message">Fixed bug #2412738 (apostrophe escaping) by applying the submitted patch.</phrase>
2493           </screen>
2494         </listitem>
2495         <listitem>
2496           <para>
2497             <literal>Norman Walsh: block.xsl; endnotes.xsl</literal>
2498           </para>
2499           <screen>
2500             <phrase role="commit-message">Fix bug where <tag>simpara</tag> in <tag>footnote</tag> didn't work. Patch by Jonathan Nieder, jrnieder@gmail.com</phrase>
2501           </screen>
2502         </listitem>
2503         <listitem>
2504           <para>
2505             <literal>dleidert: lists.xsl</literal>
2506           </para>
2507           <screen>
2508             <phrase role="commit-message">Fix two indentation issues: In the first case there is no corresponding .RS
2509 macro (Debian #519438, sf.net 2793873). In the second case an .RS instead of
2510 the probably intended .sp leads to an indentation bug (Debian #527309,
2511 sf.net #2642139).</phrase>
2512           </screen>
2513         </listitem>
2514       </itemizedlist>
2515     </sect2>
2516     <!--end of Manpages changes for 1.76.0-->
2517     <sect2 xml:id="rnV1.76.0_Epub">
2518       <title>Epub</title>
2519       <para>The following changes have been made to the
2520             <filename>epub</filename> code
2521             since the 1.75.2 release.</para>
2522       <itemizedlist>
2523         <listitem>
2524           <para>
2525             <literal>Keith Fahlgren: bin/spec/examples/AMasqueOfDays.epub; docbook.xsl; bin/spec/epub_spec.rb</literal>
2526           </para>
2527           <screen>
2528             <phrase role="commit-message">Resolve some actual regressions in <tag>date</tag> output spotted by more recent versions of epubcheck</phrase>
2529           </screen>
2530         </listitem>
2531         <listitem>
2532           <para>
2533             <literal>Keith Fahlgren: docbook.xsl</literal>
2534           </para>
2535           <screen>
2536             <phrase role="commit-message">Updated <tag>mediaobject</tag> selection code that better uses roles (when available); based on contributons by  Glenn McDonald</phrase>
2537           </screen>
2538         </listitem>
2539         <listitem>
2540           <para>
2541             <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl</literal>
2542           </para>
2543           <screen>
2544             <phrase role="commit-message">Ensure that NCX documents are always outputted with a default namespace
2545 to prevent problems with the kindlegen machinery</phrase>
2546           </screen>
2547         </listitem>
2548         <listitem>
2549           <para>
2550             <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/partintro.xml; docbook.x⋯</literal>
2551           </para>
2552           <screen>
2553             <phrase role="commit-message">Adding support for partintros with sect2s, 3s, etc</phrase>
2554           </screen>
2555         </listitem>
2556         <listitem>
2557           <para>
2558             <literal>Keith Fahlgren: docbook.xsl</literal>
2559           </para>
2560           <screen>
2561             <phrase role="commit-message">Adding param to workaround horrific ADE bug with the inability to process &lt;br&gt;</phrase>
2562           </screen>
2563         </listitem>
2564         <listitem>
2565           <para>
2566             <literal>Keith Fahlgren: docbook.xsl</literal>
2567           </para>
2568           <screen>
2569             <phrase role="commit-message">Add support for <tag>authorgroup</tag>/<tag>author</tag> in OPF metadata (via Michael Wiedmann)</phrase>
2570           </screen>
2571         </listitem>
2572         <listitem>
2573           <para>
2574             <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb</literal>
2575           </para>
2576           <screen>
2577             <phrase role="commit-message">Remove &lt;b&gt; and &lt;i&gt; elements "discouraged in favor of style sheets" from
2578 XHTML, XHTML 1.1 (and therefore EPUB) outputs by changing html2xhtml.xsl.
2579
2580 Fixes bug #2873153: No &lt;b&gt; and &lt;i&gt; tags in XHTML/EPUB
2581
2582 Added regression to EPUB specs:</phrase>
2583           </screen>
2584         </listitem>
2585         <listitem>
2586           <para>
2587             <literal>Keith Fahlgren: bin/lib/docbook.rb; bin/spec/files/DejaVuSerif-Italic.otf; docbook.xsl; bi⋯</literal>
2588           </para>
2589           <screen>
2590             <phrase role="commit-message">This resolves bug #2873142, Please add support for multiple embedded fonts
2591
2592
2593 If you navigate to a checkout of DocBook-XSL and go to:
2594 xsl/epub/bin/spec/files
2595 You can now run the following <tag>command</tag>:
2596
2597 ../../dbtoepub -f DejaVuSerif.otf -f DejaVuSerif-Italic.otf -c test.css
2598 -s test_cust.xsl orm.book.001.xml
2599
2600 In dbtoepub, the following option can be used more than once:
2601 -f, --font [OTF FILE] Embed OTF FILE in .epub.
2602
2603 The underlying stylesheet now accepts a comma-separated list of font file
2604 names rather than just one as the RENAMED epub.embedded.fonts ('s' added).
2605
2606 The runnable EPUB spec now includes:
2607 - should be valid .epub after including more than one embedded font</phrase>
2608           </screen>
2609         </listitem>
2610         <listitem>
2611           <para>
2612             <literal>Keith Fahlgren: docbook.xsl</literal>
2613           </para>
2614           <screen>
2615             <phrase role="commit-message">Improve the selection of <tag>cover</tag> images when working in DocBook 4.x land (work in progress)</phrase>
2616           </screen>
2617         </listitem>
2618         <listitem>
2619           <para>
2620             <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl</literal>
2621           </para>
2622           <screen>
2623             <phrase role="commit-message">Improve the quality of the OPF spine regression by ensuring that the spine
2624 elements for deeply nested refentries are in order and adjacent to their
2625 opening wrapper XHTML chunk.</phrase>
2626           </screen>
2627         </listitem>
2628         <listitem>
2629           <para>
2630             <literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/files/orm.book.00⋯</literal>
2631           </para>
2632           <screen>
2633             <phrase role="commit-message">Add more careful handling of refentries to ensure that they always appear in the opf:spine.
2634 This was only a problem when refentries were pushed deep into the hierarchy (like inside
2635 a <tag>sect2</tag>), but presented navigational problems for many reading systems (despite the
2636 correct NCX references). This may *not* be the best solution, but attacking a better
2637 chunking strategy for refentries was too big a nut to crack at this time.</phrase>
2638           </screen>
2639         </listitem>
2640       </itemizedlist>
2641     </sect2>
2642     <!--end of Epub changes for 1.76.0-->
2643     <sect2 xml:id="rnV1.76.0_Eclipse">
2644       <title>Eclipse</title>
2645       <para>The following changes have been made to the
2646             <filename>eclipse</filename> code
2647             since the 1.75.2 release.</para>
2648       <itemizedlist>
2649         <listitem>
2650           <para>
2651             <literal>Mauritz Jeanson: eclipse3.xsl</literal>
2652           </para>
2653           <screen>
2654             <phrase role="commit-message">Added a stylesheet module that generates plug-ins conforming to the standard (OSGi-based) Eclipse 3.x
2655 architecture. The main difference to the older format is that metadata is stored in a separate
2656 <parameter>manifest</parameter> file. The module imports and extends the existing eclipse.xsl module. Based on code
2657 contributed in patch #2624668.</phrase>
2658           </screen>
2659         </listitem>
2660       </itemizedlist>
2661     </sect2>
2662     <!--end of Eclipse changes for 1.76.0-->
2663     <sect2 xml:id="rnV1.76.0_Params">
2664       <title>Params</title>
2665       <para>The following changes have been made to the
2666             <filename>params</filename> code
2667             since the 1.75.2 release.</para>
2668       <itemizedlist>
2669         <listitem>
2670           <para>
2671             <literal>Robert Stayton: draft.watermark.image.xml</literal>
2672           </para>
2673           <screen>
2674             <phrase role="commit-message">Fix bug 2922488 <parameter>draft.watermark.image</parameter> pointing to web resource.
2675 Now the value is images/draft.png, and may require customization
2676 for local resolution.</phrase>
2677           </screen>
2678         </listitem>
2679         <listitem>
2680           <para>
2681             <literal>Mauritz Jeanson: equation.number.properties.xml</literal>
2682           </para>
2683           <screen>
2684             <phrase role="commit-message">Corrected <tag>refpurpose</tag>.</phrase>
2685           </screen>
2686         </listitem>
2687         <listitem>
2688           <para>
2689             <literal>Norman Walsh: paper.type.xml</literal>
2690           </para>
2691           <screen>
2692             <phrase role="commit-message">Added USlegal and USlegallandscape paper types.</phrase>
2693           </screen>
2694         </listitem>
2695         <listitem>
2696           <para>
2697             <literal>Jirka Kosek: highlight.xslthl.config.xml</literal>
2698           </para>
2699           <screen>
2700             <phrase role="commit-message">Added note about specifying location as URL</phrase>
2701           </screen>
2702         </listitem>
2703         <listitem>
2704           <para>
2705             <literal>Robert Stayton: docbook.css.source.xml; generate.css.header.xml; custom.css.source.xml; ma⋯</literal>
2706           </para>
2707           <screen>
2708             <phrase role="commit-message">Params to support generated CSS files.</phrase>
2709           </screen>
2710         </listitem>
2711         <listitem>
2712           <para>
2713             <literal>Robert Stayton: equation.number.properties.xml</literal>
2714           </para>
2715           <screen>
2716             <phrase role="commit-message">New attribute set for numbers appearing next to equations.</phrase>
2717           </screen>
2718         </listitem>
2719       </itemizedlist>
2720     </sect2>
2721     <!--end of Params changes for 1.76.0-->
2722     <sect2 xml:id="rnV1.76.0_XSL-Xalan">
2723       <title>XSL-Xalan</title>
2724       <para>The following changes have been made to the
2725             <filename>xsl-xalan</filename> code
2726             since the 1.75.2 release.</para>
2727       <itemizedlist>
2728         <listitem>
2729           <para>
2730             <literal>dleidert: nbproject/genfiles.properties; nbproject/build-impl.xml</literal>
2731           </para>
2732           <screen>
2733             <phrase role="commit-message">Rebuild netbeans build files after adding missing Netbeans configuration to allow easier packaging for Debian.</phrase>
2734           </screen>
2735         </listitem>
2736       </itemizedlist>
2737     </sect2>
2738     <!--end of XSL-Xalan changes for 1.76.0-->
2739   </sect1>
2740 <sect1 xml:id="rn_V1.75.2">
2741 <title>Release Notes: 1.75.2</title>
2742 <para>The following is a list of changes that have been made
2743         since the 1.75.1 release.</para>
2744
2745 <sect2 xml:id="rn_V1.75.2_Gentext">
2746 <title>Gentext</title>
2747 <para>The following changes have been made to the
2748             <filename>gentext</filename> code
2749             since the 1.75.1 release.</para>
2750 <itemizedlist>
2751 <listitem>
2752 <para><literal>dleidert: locale/ja.xml</literal></para><screen><phrase role="commit-message">Improved Japanese translation for Note(s). Closes bug #2823965.</phrase></screen>
2753 </listitem>
2754 <listitem>
2755 <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>
2756 </listitem>
2757 <listitem>
2758 <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>
2759 </listitem>
2760 <listitem>
2761 <para><literal>Robert Stayton: locale/is.xml</literal></para><screen><phrase role="commit-message">New Icelandic locale file.</phrase></screen>
2762 </listitem>
2763 </itemizedlist>
2764 </sect2><!--end of Gentext changes for 1.75.2-->
2765
2766 <sect2 xml:id="rn_V1.75.2_Common">
2767 <title>Common</title>
2768 <para>The following changes have been made to the
2769             <filename>common</filename> code
2770             since the 1.75.1 release.</para>
2771 <itemizedlist>
2772 <listitem>
2773 <para><literal>Norman Walsh: stripns.xsl</literal></para><screen><phrase role="commit-message">Support more downconvert cases</phrase></screen>
2774 </listitem>
2775 <listitem>
2776 <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>
2777 </listitem>
2778 </itemizedlist>
2779 </sect2><!--end of Common changes for 1.75.2-->
2780
2781 <sect2 xml:id="rn_V1.75.2_FO">
2782 <title>FO</title>
2783 <para>The following changes have been made to the
2784             <filename>fo</filename> code
2785             since the 1.75.1 release.</para>
2786 <itemizedlist>
2787 <listitem>
2788 <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>
2789 </listitem>
2790 </itemizedlist>
2791 </sect2><!--end of FO changes for 1.75.2-->
2792
2793 <sect2 xml:id="rn_V1.75.2_HTML">
2794 <title>HTML</title>
2795 <para>The following changes have been made to the
2796             <filename>html</filename> code
2797             since the 1.75.1 release.</para>
2798 <itemizedlist>
2799 <listitem>
2800 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Output "<tag>Copyright</tag>" heading in XHTML too.</phrase></screen>
2801 </listitem>
2802 <listitem>
2803 <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>
2804 </listitem>
2805 <listitem>
2806 <para><literal>Norman Walsh: htmltbl.xsl</literal></para><screen><phrase role="commit-message">Remove ambiguity wrt @span, @rowspan, and @colspan</phrase></screen>
2807 </listitem>
2808 </itemizedlist>
2809 </sect2><!--end of HTML changes for 1.75.2-->
2810
2811 <sect2 xml:id="rn_V1.75.2_Manpages">
2812 <title>Manpages</title>
2813 <para>The following changes have been made to the
2814             <filename>manpages</filename> code
2815             since the 1.75.1 release.</para>
2816 <itemizedlist>
2817 <listitem>
2818 <para><literal>Mauritz Jeanson: endnotes.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space() for ulink content. Closes bug #2793877.</phrase></screen>
2819 </listitem>
2820 <listitem>
2821 <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>
2822 </listitem>
2823 </itemizedlist>
2824 </sect2><!--end of Manpages changes for 1.75.2-->
2825
2826 <sect2 xml:id="rn_V1.75.2_Epub">
2827 <title>Epub</title>
2828 <para>The following changes have been made to the
2829             <filename>epub</filename> code
2830             since the 1.75.1 release.</para>
2831 <itemizedlist>
2832 <listitem>
2833 <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>
2834 </listitem>
2835 <listitem>
2836 <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>
2837 </listitem>
2838 </itemizedlist>
2839 </sect2><!--end of Epub changes for 1.75.2-->
2840
2841 <sect2 xml:id="rn_V1.75.2_Profiling">
2842 <title>Profiling</title>
2843 <para>The following changes have been made to the
2844             <filename>profiling</filename> code
2845             since the 1.75.1 release.</para>
2846 <itemizedlist>
2847 <listitem>
2848 <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>
2849 </listitem>
2850 </itemizedlist>
2851 </sect2><!--end of Profiling changes for 1.75.2-->
2852
2853 <sect2 xml:id="rn_V1.75.2_XSL-Saxon">
2854 <title>XSL-Saxon</title>
2855 <para>The following changes have been made to the
2856             <filename>xsl-saxon</filename> code
2857             since the 1.75.1 release.</para>
2858 <itemizedlist>
2859 <listitem>
2860 <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>
2861 </listitem>
2862 </itemizedlist>
2863 </sect2><!--end of XSL-Saxon changes for 1.75.2-->
2864
2865 <sect2 xml:id="rn_V1.75.2_XSL-Xalan">
2866 <title>XSL-Xalan</title>
2867 <para>The following changes have been made to the
2868             <filename>xsl-xalan</filename> code
2869             since the 1.75.1 release.</para>
2870 <itemizedlist>
2871 <listitem>
2872 <para><literal>Mauritz Jeanson: nbproject/project.xml</literal></para><screen><phrase role="commit-message">Added missing NetBeans configuration.</phrase></screen>
2873 </listitem>
2874 </itemizedlist>
2875 </sect2><!--end of XSL-Xalan changes for 1.75.2-->
2876
2877 </sect1>
2878
2879
2880 <sect1 xml:id="rn_V1.75.1">
2881 <title>Release Notes: 1.75.1</title>
2882 <para>This release includes bug fixes.</para>
2883
2884 <para>The following is a list of changes that have been made since the 1.75.0 release.</para>
2885
2886
2887 <sect2 xml:id="rn_V1.75.1_FO">
2888 <title>FO</title>
2889 <para>The following changes have been made to the <filename>fo</filename> code since the 1.75.0 release.</para>
2890 <itemizedlist>
2891 <listitem>
2892 <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>
2893 </listitem>
2894 <listitem>
2895 <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>
2896 </listitem>
2897 </itemizedlist>
2898 </sect2><!--end of FO changes for 1.75.1-->
2899
2900 <sect2 xml:id="rn_V1.75.1_HTML">
2901 <title>HTML</title>
2902 <para>The following changes have been made to the
2903             <filename>html</filename> code
2904             since the 1.75.0 release.</para>
2905 <itemizedlist>
2906 <listitem>
2907 <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>
2908 </listitem>
2909 <listitem>
2910 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed bug 2789678: apply-templates line accidentally deleted.</phrase></screen>
2911 </listitem>
2912 </itemizedlist>
2913 </sect2><!--end of HTML changes for 1.75.1-->
2914
2915 <sect2 xml:id="rn_V1.75.1_Epub">
2916 <title>Epub</title>
2917 <para>The following changes have been made to the
2918             <filename>epub</filename> code
2919             since the 1.75.0 release.</para>
2920 <itemizedlist>
2921 <listitem>
2922 <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>
2923 </listitem>
2924 <listitem>
2925 <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>
2926 </listitem>
2927 <listitem>
2928 <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>
2929 </listitem>
2930 </itemizedlist>
2931 </sect2><!--end of Epub changes for 1.75.1-->
2932
2933 <sect2 xml:id="rn_V1.75.1_Params">
2934 <title>Params</title>
2935 <para>The following changes have been made to the
2936             <filename>params</filename> code
2937             since the 1.75.0 release.</para>
2938 <itemizedlist>
2939 <listitem>
2940 <para><literal>Mauritz Jeanson: highlight.source.xml</literal></para><screen><phrase role="commit-message">Updated documentation to reflect changes made in r8419.</phrase></screen>
2941 </listitem>
2942 </itemizedlist>
2943 </sect2><!--end of Params changes for 1.75.1-->
2944
2945 </sect1>
2946
2947
2948 <sect1 xml:id="V1.75.0">
2949 <title>Release Notes: 1.75.0</title>
2950 <para>This release includes important bug fixes and adds the following
2951 significant feature changes:
2952 <variablelist>
2953 <varlistentry>
2954 <term>Gentext</term>
2955 <listitem><para>Modifications to translations have been made. </para></listitem>
2956
2957 </varlistentry>
2958 <varlistentry>
2959 <term>Common</term>
2960 <listitem>
2961 <para>Added support for some format properties on tables using
2962 HTML <tag>table</tag> markup.  </para>
2963 <para>Added two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections
2964 and numbered questions can be distinguished.  Satisfies
2965 Feature Request #1539045.</para>
2966 <para>Added code to handle <tag>acknowledgements</tag> in <tag>book</tag> and part. The element is processed
2967 similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
2968 any dedications.</para>
2969 </listitem>
2970 </varlistentry>
2971
2972 <varlistentry>
2973 <term>FO</term>
2974 <listitem>
2975 <para>The inclusion of highlighting code has been simplified.</para>
2976 <para>Add support for pgwide on informal objects.</para>
2977 <para>Added a new parameter, <parameter>bookmarks.collapse</parameter>, that controls the initial <tag>state</tag> of the bookmark tree. Closes FR #1792326.</para>
2978 <para>Add support for more dbfo processing instructions.</para>
2979 <para>Add new <parameter>variablelist.term.properties</parameter> to format terms, per request # 1968513.</para>
2980 <para>Add support for @width on <tag>screen</tag> and <tag>programlisting</tag>, fixes bug #2012736.</para>
2981 <para>Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.  </para>
2982 <para>Add <parameter>writing.mode</parameter> param for FO output.</para>
2983 </listitem>
2984 </varlistentry>
2985 <varlistentry>
2986 <term>HTML</term>
2987 <listitem>
2988 <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>
2989 <para>Inclusion of highlighting code was simplified. Only one import is now necessary.</para>
2990 <para>Add new param <parameter>index.links.to.section</parameter>.</para>
2991 <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>
2992 </listitem>
2993 </varlistentry>
2994 <varlistentry>
2995 <term>ePub</term>
2996 <listitem>
2997 <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>
2998 <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>
2999 <para>Added DocBook <tag>subjectset</tag> -&gt; OPF dc:<tag>subject</tag> mapping and tests</para>
3000 <para>Added DocBook <tag>date</tag> -&gt; OPF dc:date mapping and tests</para>
3001 <para>Added DocBook <tag>abstract</tag> -&gt; OPF dc:description mapping and tests</para>
3002 <para>Added --output option to dbtoepub based on user request</para>
3003 </listitem>
3004
3005 </varlistentry>
3006 <varlistentry>
3007 <term>HTMLHelp</term>
3008 <listitem>
3009 <para>Add support for generating <tag>olink</tag> target <tag>database</tag> for htmlhelp files.</para></listitem>
3010
3011 </varlistentry>
3012
3013 <varlistentry>
3014 <term>Params</term>
3015 <listitem>
3016 <para>Add default setting for @rules attribute on HTML markup tables.</para>
3017 <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>
3018 <para>Add new <parameter>variablelist.term.properties</parameter> to format terms, per request # 1968513.</para>
3019 <para>Add two new <parameter>qanda.defaultlabel</parameter> values so that numbered sections and numbered questions can be distinguished.  Satisfies Feature Request #1539045.</para>
3020 <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>
3021 <para>New attribute list for <tag>glossentry</tag> in <tag>glossary</tag>.</para>
3022 <para>New parameter to support @width on <tag>programlisting</tag> and <tag>screen</tag>.</para>
3023 <para>Add attribute-sets for formatting <tag>glossary</tag> terms and defs.</para>
3024 </listitem>
3025 </varlistentry>
3026 <varlistentry>
3027 <term>Highlighting</term>
3028 <listitem>
3029 <para>Inclusion of highlighting code was simplified. Only one import is now necessary.</para>
3030 </listitem>
3031
3032 </varlistentry>
3033 </variablelist>
3034
3035
3036 </para>
3037 <para>The following is a list of changes that have been made
3038         since the 1.74.3 release.</para>
3039
3040 <sect2 xml:id="rn_V1.75.0_Gentext">
3041 <title>Gentext</title>
3042 <para>The following changes have been made to the
3043             <filename>gentext</filename> code
3044             since the 1.74.3 release.</para>
3045 <itemizedlist>
3046 <listitem>
3047 <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>
3048 </listitem>
3049 <listitem>
3050 <para><literal>Robert Stayton: locale/es.xml</literal></para><screen><phrase role="commit-message">Fix spelling errors in <tag>Acknowledgements</tag> entries.</phrase></screen>
3051 </listitem>
3052 <listitem>
3053 <para><literal>Robert Stayton: locale/es.xml</literal></para><screen><phrase role="commit-message">Check in translations for 4 elements submitted through docbook-apps
3054 message of 14 April 2009.</phrase></screen>
3055 </listitem>
3056 <listitem>
3057 <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>
3058 </listitem>
3059 <listitem>
3060 <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>
3061 </listitem>
3062 <listitem>
3063 <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>
3064 </listitem>
3065 <listitem>
3066 <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>
3067 </listitem>
3068 <listitem>
3069 <para><literal>Robert Stayton: locale/ru.xml</literal></para><screen><phrase role="commit-message">Checkin typo fix submitted in bug #2453406.</phrase></screen>
3070 </listitem>
3071 </itemizedlist>
3072 </sect2><!--end of Gentext changes for 1.75.0-->
3073
3074 <sect2 xml:id="rn_V1.75.0_Common">
3075 <title>Common</title>
3076 <para>The following changes have been made to the
3077             <filename>common</filename> code
3078             since the 1.74.3 release.</para>
3079 <itemizedlist>
3080 <listitem>
3081 <para><literal>Robert Stayton: gentext.xsl</literal></para><screen><phrase role="commit-message">Fix extra generated space when xrefstyle includes 'nopage'.</phrase></screen>
3082 </listitem>
3083 <listitem>
3084 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support for some format properties on tables using
3085 HTML <tag>table</tag> markup.  These include:
3086   - frame attribute on <tag>table</tag> (or uses $default.table.frame parameter).
3087   - rules attribute on <tag>table</tag> (or uses $default.table.rules parameter).
3088   - align attribute on <tag>td</tag> and <tag>th</tag>
3089   - valign attribute on <tag>td</tag> and <tag>th</tag>
3090   - colspan on <tag>td</tag> and <tag>th</tag>
3091   - rowspan on <tag>td</tag> and <tag>th</tag>
3092   - bgcolor on <tag>td</tag> and <tag>th</tag></phrase></screen>
3093 </listitem>
3094 <listitem>
3095 <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
3096 customization easier, per Feature Request 1828608.</phrase></screen>
3097 </listitem>
3098 <listitem>
3099 <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>
3100 generated from a <parameter>glossary.collection</parameter>.</phrase></screen>
3101 </listitem>
3102 <listitem>
3103 <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>
3104 </listitem>
3105 <listitem>
3106 <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>
3107 </listitem>
3108 <listitem>
3109 <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))".
3110 This enables proper formatting of inline elements in titles in TOCs,
3111 as long as these inlines don't have id or xml:id attributes.</phrase></screen>
3112 </listitem>
3113 <listitem>
3114 <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
3115 and numbered questions can be distinguished.  Satisfies
3116 Feature Request #1539045.</phrase></screen>
3117 </listitem>
3118 <listitem>
3119 <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
3120 so Xalan bug is isolated.</phrase></screen>
3121 </listitem>
3122 <listitem>
3123 <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Added fixes for bugs #2112656 and #1759205:
3124 1. Reverted mistaken commits r7485 and r7523.
3125 2. Updated the template with match="<tag>link</tag>" and mode="no.anchor.mode" so that
3126 @endterm is used if it exists and if the <tag>link</tag> has no content.</phrase></screen>
3127 </listitem>
3128 <listitem>
3129 <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
3130 similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
3131 any dedications.</phrase></screen>
3132 </listitem>
3133 <listitem>
3134 <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>
3135 </listitem>
3136 <listitem>
3137 <para><literal>Robert Stayton: olink.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787167 incorrect hot text for some olinks.</phrase></screen>
3138 </listitem>
3139 <listitem>
3140 <para><literal>Robert Stayton: common.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1669654 Broken output if <tag>copyright</tag> &lt;<tag>year</tag>&gt; contains a range.</phrase></screen>
3141 </listitem>
3142 <listitem>
3143 <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>
3144 </listitem>
3145 </itemizedlist>
3146 </sect2><!--end of Common changes for 1.75.0-->
3147
3148 <sect2 xml:id="rn_V1.75.0_FO">
3149 <title>FO</title>
3150 <para>The following changes have been made to the
3151             <filename>fo</filename> code
3152             since the 1.74.3 release.</para>
3153 <itemizedlist>
3154 <listitem>
3155 <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>
3156 </listitem>
3157 <listitem>
3158 <para><literal>Robert Stayton: fop1.xsl</literal></para><screen><phrase role="commit-message">Add the new fop extensions namespace declaration, in case FOP
3159 extension functions are used.</phrase></screen>
3160 </listitem>
3161 <listitem>
3162 <para><literal>Robert Stayton: formal.xsl</literal></para><screen><phrase role="commit-message">Add support for pgwide on informal objects.</phrase></screen>
3163 </listitem>
3164 <listitem>
3165 <para><literal>Robert Stayton: docbook.xsl</literal></para><screen><phrase role="commit-message">Fixed spurious closing <tag>quote</tag> on line 134.</phrase></screen>
3166 </listitem>
3167 <listitem>
3168 <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
3169 new $exsl.node.set.available param in test.</phrase></screen>
3170 </listitem>
3171 <listitem>
3172 <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>
3173 </listitem>
3174 <listitem>
3175 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Fixed doc bug for row-height.</phrase></screen>
3176 </listitem>
3177 <listitem>
3178 <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>
3179 </listitem>
3180 <listitem>
3181 <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
3182 HTML <tag>table</tag> markup.  These include:
3183   - frame attribute on <tag>table</tag> (or uses $default.table.frame parameter).
3184   - rules attribute on <tag>table</tag> (or uses $default.table.rules parameter).
3185   - align attribute on <tag>td</tag> and <tag>th</tag>
3186   - valign attribute on <tag>td</tag> and <tag>th</tag>
3187   - colspan on <tag>td</tag> and <tag>th</tag>
3188   - rowspan on <tag>td</tag> and <tag>th</tag>
3189   - bgcolor on <tag>td</tag> and <tag>th</tag></phrase></screen>
3190 </listitem>
3191 <listitem>
3192 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support bgcolor in <tag>td</tag> and <tag>th</tag>
3193 elements in HTML <tag>table</tag> markup.</phrase></screen>
3194 </listitem>
3195 <listitem>
3196 <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>
3197 elements in HTML <tag>table</tag> markup.</phrase></screen>
3198 </listitem>
3199 <listitem>
3200 <para><literal>Robert Stayton: param.xweb</literal></para><screen><phrase role="commit-message">Fix working of page-master left and right margins.</phrase></screen>
3201 </listitem>
3202 <listitem>
3203 <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>
3204 </listitem>
3205 <listitem>
3206 <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>
3207 </listitem>
3208 <listitem>
3209 <para><literal>Robert Stayton: lists.xsl</literal></para><screen><phrase role="commit-message">Add support for dbfo keep-together processing instruction for
3210 entire list instances.</phrase></screen>
3211 </listitem>
3212 <listitem>
3213 <para><literal>Robert Stayton: lists.xsl; block.xsl</literal></para><screen><phrase role="commit-message">Add support fo dbfo keep-together processing instruction to
3214 more blocks like list items and paras.</phrase></screen>
3215 </listitem>
3216 <listitem>
3217 <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>
3218 </listitem>
3219 <listitem>
3220 <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">In simple.xlink, rearrange order of processing.</phrase></screen>
3221 </listitem>
3222 <listitem>
3223 <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>
3224 </listitem>
3225 <listitem>
3226 <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
3227 other types of linking besides otherterm.</phrase></screen>
3228 </listitem>
3229 <listitem>
3230 <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>
3231 </listitem>
3232 <listitem>
3233 <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>
3234 so other element's titles will not be affected.</phrase></screen>
3235 </listitem>
3236 <listitem>
3237 <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>
3238 </listitem>
3239 <listitem>
3240 <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>
3241 </listitem>
3242 <listitem>
3243 <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
3244 extra processing of multiple editors. Fixes bug 2687842.</phrase></screen>
3245 </listitem>
3246 <listitem>
3247 <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
3248 now outputs that ID, so that <tag>index</tag> entries can be cross referenced to.</phrase></screen>
3249 </listitem>
3250 <listitem>
3251 <para><literal>Mauritz Jeanson: synop.xsl</literal></para><screen><phrase role="commit-message">Added modeless template for ooclass|oointerface|ooexception.
3252 Closes bug #1623468.</phrase></screen>
3253 </listitem>
3254 <listitem>
3255 <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>
3256 </listitem>
3257 <listitem>
3258 <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
3259 the <tag>link</tag> text if it has one.</phrase></screen>
3260 </listitem>
3261 <listitem>
3262 <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
3263 they can be <tag>xref</tag>'ed to.</phrase></screen>
3264 </listitem>
3265 <listitem>
3266 <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>.
3267 This assumes the <tag>author</tag> specifies something using xrefstyle since
3268 the elements don't have ordinary <tag>link</tag> text.</phrase></screen>
3269 </listitem>
3270 <listitem>
3271 <para><literal>Robert Stayton: toc.xsl</literal></para><screen><phrase role="commit-message">Fix bug in new <tag>toc</tag> templates.</phrase></screen>
3272 </listitem>
3273 <listitem>
3274 <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
3275 similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
3276 any dedications.</phrase></screen>
3277 </listitem>
3278 <listitem>
3279 <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>
3280 in all permitted contexts.  Same for lot elements.
3281 This fixes bug #1595969 for FO outputs.</phrase></screen>
3282 </listitem>
3283 <listitem>
3284 <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>
3285 </listitem>
3286 <listitem>
3287 <para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Removed duplicate (<parameter>monospace.font.family</parameter>).</phrase></screen>
3288 </listitem>
3289 <listitem>
3290 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Add <parameter>glossentry.list.item.properties</parameter>.</phrase></screen>
3291 </listitem>
3292 <listitem>
3293 <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>
3294 </listitem>
3295 <listitem>
3296 <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"
3297 when text direction is right to left because all program languages
3298 are left-to-right.</phrase></screen>
3299 </listitem>
3300 <listitem>
3301 <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>
3302 </listitem>
3303 <listitem>
3304 <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>
3305 </listitem>
3306 <listitem>
3307 <para><literal>Mauritz Jeanson: block.xsl</literal></para><screen><phrase role="commit-message">Added support for <tag>acknowledgements</tag> in <tag>article</tag>.
3308 Support in <tag>book</tag>/part remains to be added.</phrase></screen>
3309 </listitem>
3310 <listitem>
3311 <para><literal>Robert Stayton: xref.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1787167 incorrect hot text for some olinks.</phrase></screen>
3312 </listitem>
3313 <listitem>
3314 <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>
3315 </listitem>
3316 <listitem>
3317 <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.
3318 Changed instances of margin-left to margin-{$direction.align.start}
3319 and margin-right to margin-{$direction.align.end}. Those direction.align
3320 params are computed from the writing mode value in each locale's
3321 gentext key named 'writing-mode', introduced in 1.74.3 to add
3322 right-to-left support to HTML outputs.</phrase></screen>
3323 </listitem>
3324 <listitem>
3325 <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>
3326 </listitem>
3327 <listitem>
3328 <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>
3329 </listitem>
3330 <listitem>
3331 <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>
3332 instead of <tag>question</tag>, if available. For DocBook 5, use the <tag>info</tag> versions.</phrase></screen>
3333 </listitem>
3334 <listitem>
3335 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add better pointer to README for XSLTHL</phrase></screen>
3336 </listitem>
3337 <listitem>
3338 <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>
3339 </listitem>
3340 <listitem>
3341 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
3342 </listitem>
3343 </itemizedlist>
3344 </sect2><!--end of FO changes for 1.75.0-->
3345
3346 <sect2 xml:id="rn_V1.75.0_HTML">
3347 <title>HTML</title>
3348 <para>The following changes have been made to the
3349             <filename>html</filename> code
3350             since the 1.74.3 release.</para>
3351 <itemizedlist>
3352 <listitem>
3353 <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
3354 div element for lists.</phrase></screen>
3355 </listitem>
3356 <listitem>
3357 <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
3358 to support dir, lang, and <tag>title</tag> attributes in html output for all elements.
3359 Fulfills feature request #1993833.</phrase></screen>
3360 </listitem>
3361 <listitem>
3362 <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
3363 when target html is in a subdirectory and dbhtml <tag>filename</tag> used.</phrase></screen>
3364 </listitem>
3365 <listitem>
3366 <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>
3367 </listitem>
3368 <listitem>
3369 <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
3370 new $exsl.node.set.available param in test.</phrase></screen>
3371 </listitem>
3372 <listitem>
3373 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Fixed doc bug for row-height.</phrase></screen>
3374 </listitem>
3375 <listitem>
3376 <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>
3377 </listitem>
3378 <listitem>
3379 <para><literal>Robert Stayton: lists.xsl; html.xsl; block.xsl</literal></para><screen><phrase role="commit-message">More elements get common.html.attributes.
3380 Added locale.html.attributes template which does the lang,
3381 dir, and <tag>title</tag> attributes, but not the class attribute
3382 (used on <tag>para</tag>, for example).</phrase></screen>
3383 </listitem>
3384 <listitem>
3385 <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
3386 easier customization.</phrase></screen>
3387 </listitem>
3388 <listitem>
3389 <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>
3390 </listitem>
3391 <listitem>
3392 <para><literal>Robert Stayton: inline.xsl</literal></para><screen><phrase role="commit-message">In simple.xlink, rearrange order of processing.</phrase></screen>
3393 </listitem>
3394 <listitem>
3395 <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>
3396 </listitem>
3397 <listitem>
3398 <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
3399 class, <tag>title</tag>, lang, and dir for most elements.
3400 Started adding it to some list and block elements.</phrase></screen>
3401 </listitem>
3402 <listitem>
3403 <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
3404 and numbered questions can be distinguished.  Satisfies
3405 Feature Request #1539045.</phrase></screen>
3406 </listitem>
3407 <listitem>
3408 <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>
3409 </listitem>
3410 <listitem>
3411 <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
3412 duplicate entries with different ids can still have an id output.</phrase></screen>
3413 </listitem>
3414 <listitem>
3415 <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>
3416 </listitem>
3417 <listitem>
3418 <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
3419 the <tag>index</tag> <tag>entry</tag>, so that one could <tag>link</tag> to an <tag>index</tag> <tag>entry</tag>.
3420 You can't <tag>link</tag> to the id on an <tag>indexterm</tag> because that is
3421 used to place the main <tag>anchor</tag> in the text flow.</phrase></screen>
3422 </listitem>
3423 <listitem>
3424 <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
3425 precise links to indexterms in HTML output rather than to
3426 the <tag>section</tag> <tag>title</tag>.</phrase></screen>
3427 </listitem>
3428 <listitem>
3429 <para><literal>Mauritz Jeanson: synop.xsl</literal></para><screen><phrase role="commit-message">Added modeless template for ooclass|oointerface|ooexception.
3430 Closes bug #1623468.</phrase></screen>
3431 </listitem>
3432 <listitem>
3433 <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>,
3434 because it may be referenced in a <tag>TOC</tag> or <tag>xref</tag>.
3435 Before, the <tag>anchor</tag> was output by the <tag>title</tag>, but there was no
3436 <tag>anchor</tag> if there was no <tag>title</tag>.</phrase></screen>
3437 </listitem>
3438 <listitem>
3439 <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>
3440 </listitem>
3441 <listitem>
3442 <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
3443 the <tag>link</tag> text if it has one.</phrase></screen>
3444 </listitem>
3445 <listitem>
3446 <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>
3447 in a <tag>qandaentry</tag>, so such can be used for the <tag>alt</tag> text of an <tag>xref</tag>
3448 to a <tag>qandaentry</tag>.</phrase></screen>
3449 </listitem>
3450 <listitem>
3451 <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>,
3452 most useful when an xrefstyle is used.</phrase></screen>
3453 </listitem>
3454 <listitem>
3455 <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>
3456 in all permitted contexts.  Same for lot elements.
3457 This fixes bug #1595969 for HTML outputs.</phrase></screen>
3458 </listitem>
3459 <listitem>
3460 <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
3461 similarly to <tag>dedication</tag>. All <tag>acknowledgements</tag> will appear as front matter, after
3462 any dedications.</phrase></screen>
3463 </listitem>
3464 <listitem>
3465 <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
3466 nesting of elements and <tag>seeie</tag> and <tag>seealsoie</tag>, as reported in
3467 bug # 1168912.</phrase></screen>
3468 </listitem>
3469 <listitem>
3470 <para><literal>Robert Stayton: autotoc.xsl</literal></para><screen><phrase role="commit-message">Fix <tag>simplesect</tag> in <tag>toc</tag> problem.</phrase></screen>
3471 </listitem>
3472 <listitem>
3473 <para><literal>Robert Stayton: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add support for @width per bug report #2012736.</phrase></screen>
3474 </listitem>
3475 <listitem>
3476 <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>
3477 </listitem>
3478 <listitem>
3479 <para><literal>Robert Stayton: param.xweb</literal></para><screen><phrase role="commit-message">Move writing-mode param.</phrase></screen>
3480 </listitem>
3481 <listitem>
3482 <para><literal>Keith Fahlgren: refentry.xsl</literal></para><screen><phrase role="commit-message">Remove a nesting of &lt;p&gt; inside &lt;p&gt; for <tag>refclass</tag> (made XHTML* invalid, made HTML silly)</phrase></screen>
3483 </listitem>
3484 <listitem>
3485 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Fix bug #1945872 to allow passthrough of colwidth values to
3486 HTML <tag>table</tag> when no <parameter>tablecolumns.extension</parameter> is available and
3487 when no instance of * appears in the <tag>table</tag>'s colspecs.</phrase></screen>
3488 </listitem>
3489 <listitem>
3490 <para><literal>Mauritz Jeanson: block.xsl</literal></para><screen><phrase role="commit-message">Added support for <tag>acknowledgements</tag> in <tag>article</tag>.
3491 Support in <tag>book</tag>/part remains to be added.</phrase></screen>
3492 </listitem>
3493 <listitem>
3494 <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>
3495 </listitem>
3496 <listitem>
3497 <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>
3498 instead of <tag>question</tag>, if available. For DocBook 5, use the <tag>info</tag> versions.</phrase></screen>
3499 </listitem>
3500 <listitem>
3501 <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>
3502 </listitem>
3503 <listitem>
3504 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Add better pointer to README for XSLTHL</phrase></screen>
3505 </listitem>
3506 <listitem>
3507 <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>
3508 </listitem>
3509 <listitem>
3510 <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>
3511 </listitem>
3512 <listitem>
3513 <para><literal>Keith Fahlgren: verbatim.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
3514 </listitem>
3515 </itemizedlist>
3516 </sect2><!--end of HTML changes for 1.75.0-->
3517
3518 <sect2 xml:id="rn_V1.75.0_Manpages">
3519 <title>Manpages</title>
3520 <para>The following changes have been made to the
3521             <filename>manpages</filename> code
3522             since the 1.74.3 release.</para>
3523 <itemizedlist>
3524 <listitem>
3525 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Convert function-available test for node-set() <tag>function</tag> to
3526 test of $exsl.node.set.available param.</phrase></screen>
3527 </listitem>
3528 <listitem>
3529 <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>
3530 </listitem>
3531 </itemizedlist>
3532 </sect2><!--end of Manpages changes for 1.75.0-->
3533
3534 <sect2 xml:id="rn_V1.75.0_Epub">
3535 <title>ePub</title>
3536 <para>The following changes have been made to the
3537             <filename>epub</filename> code
3538             since the 1.74.3 release.</para>
3539 <itemizedlist>
3540 <listitem>
3541 <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>
3542 </listitem>
3543 <listitem>
3544 <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>
3545 </listitem>
3546 <listitem>
3547 <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>
3548 </listitem>
3549 <listitem>
3550 <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>
3551 </listitem>
3552 <listitem>
3553 <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">Be a little bit more nuanced about dates</phrase></screen>
3554 </listitem>
3555 <listitem>
3556 <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x⋯</literal></para><screen><phrase role="commit-message">Add DocBook <tag>subjectset</tag> -&gt; OPF dc:<tag>subject</tag> mapping and tests</phrase></screen>
3557 </listitem>
3558 <listitem>
3559 <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x⋯</literal></para><screen><phrase role="commit-message">Add DocBook <tag>date</tag> -&gt; OPF dc:date mapping and tests</phrase></screen>
3560 </listitem>
3561 <listitem>
3562 <para><literal>Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x⋯</literal></para><screen><phrase role="commit-message">Add DocBook <tag>abstract</tag> -&gt; OPF dc:description mapping and tests</phrase></screen>
3563 </listitem>
3564 <listitem>
3565 <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
3566 to dc:creator element.</phrase></screen>
3567 </listitem>
3568 <listitem>
3569 <para><literal>Keith Fahlgren: bin/dbtoepub</literal></para><screen><phrase role="commit-message">Adding --output option to dbtoepub based on user request</phrase></screen>
3570 </listitem>
3571 <listitem>
3572 <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>
3573 </listitem>
3574 <listitem>
3575 <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/refclass.xml</literal></para><screen><phrase role="commit-message">Remove a nesting of &lt;p&gt; inside &lt;p&gt; for <tag>refclass</tag> (made XHTML* invalid, made HTML silly)</phrase></screen>
3576 </listitem>
3577 <listitem>
3578 <para><literal>Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/blockquotepre.xml</literal></para><screen><phrase role="commit-message">Added regression test and fix for XHTML validation problem with &lt;a&gt;s added inside &lt;<tag>blockquote</tag>&gt;; This potentially causes another problem (where something is referenced by has no <tag>anchor</tag>, but someone reporting that should cause the whole &lt;a id='thing'/&gt; thing to be reconsidered with modern browsers in mind.</phrase></screen>
3579 </listitem>
3580 </itemizedlist>
3581 </sect2><!--end of Epub changes for 1.75.0-->
3582
3583 <sect2 xml:id="rn_V1.75.0_HTMLHelp">
3584 <title>HTMLHelp</title>
3585 <para>The following changes have been made to the
3586             <filename>htmlhelp</filename> code
3587             since the 1.74.3 release.</para>
3588 <itemizedlist>
3589 <listitem>
3590 <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>
3591 </listitem>
3592 </itemizedlist>
3593 </sect2><!--end of HTMLHelp changes for 1.75.0-->
3594
3595
3596 <sect2 xml:id="rn_V1.75.0_Params">
3597 <title>Params</title>
3598 <para>The following changes have been made to the
3599             <filename>params</filename> code
3600             since the 1.74.3 release.</para>
3601 <itemizedlist>
3602 <listitem>
3603 <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>
3604 </listitem>
3605 <listitem>
3606 <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>
3607 of the bookmark tree. When the parameter has a non-zero value (the default),
3608 only the top-level bookmarks are displayed initially. Otherwise, the whole
3609 tree of bookmarks is displayed.
3610
3611 This is implemented for FOP 0.9X. Closes FR #1792326.</phrase></screen>
3612 </listitem>
3613 <listitem>
3614 <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
3615 request # 1968513.</phrase></screen>
3616 </listitem>
3617 <listitem>
3618 <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
3619 and numbered questions can be distinguished.  Satisfies
3620 Feature Request #1539045.</phrase></screen>
3621 </listitem>
3622 <listitem>
3623 <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>
3624 </listitem>
3625 <listitem>
3626 <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.
3627 If it is ever fixed in Xalan, just fix it here.</phrase></screen>
3628 </listitem>
3629 <listitem>
3630 <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
3631 a <tag>section</tag> <tag>title</tag> or to the precise location of the
3632 <tag>indexterm</tag>.</phrase></screen>
3633 </listitem>
3634 <listitem>
3635 <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>
3636 </listitem>
3637 <listitem>
3638 <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>
3639 </listitem>
3640 <listitem>
3641 <para><literal>Mauritz Jeanson: highlight.source.xml</literal></para><screen><phrase role="commit-message">Updated and reorganized the description.</phrase></screen>
3642 </listitem>
3643 <listitem>
3644 <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>
3645 </listitem>
3646 <listitem>
3647 <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
3648 writing mode.</phrase></screen>
3649 </listitem>
3650 <listitem>
3651 <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>
3652 </listitem>
3653 <listitem>
3654 <para><literal>Robert Stayton: glossterm.separation.xml</literal></para><screen><phrase role="commit-message">Clarify the description.</phrase></screen>
3655 </listitem>
3656 <listitem>
3657 <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>
3658 </listitem>
3659 </itemizedlist>
3660 </sect2><!--end of Params changes for 1.75.0-->
3661
3662 <sect2 xml:id="rn_V1.75.0_Highlighting">
3663 <title>Highlighting</title>
3664 <para>The following changes have been made to the
3665             <filename>highlighting</filename> code
3666             since the 1.74.3 release.</para>
3667 <itemizedlist>
3668 <listitem>
3669 <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>
3670 </listitem>
3671 <listitem>
3672 <para><literal>Keith Fahlgren: README</literal></para><screen><phrase role="commit-message">Adding XSLTHL readme</phrase></screen>
3673 </listitem>
3674 <listitem>
3675 <para><literal>Keith Fahlgren: common.xsl</literal></para><screen><phrase role="commit-message">Alternate attempt at sanely including/excluding XSLTHT code</phrase></screen>
3676 </listitem>
3677 </itemizedlist>
3678 </sect2><!--end of Highlighting changes for 1.75.0-->
3679
3680 <sect2 xml:id="rn_V1.75.0_XSL-Saxon">
3681 <title>XSL-Saxon</title>
3682 <para>The following changes have been made to the
3683             <filename>xsl-saxon</filename> code
3684             since the 1.74.3 release.</para>
3685 <itemizedlist>
3686 <listitem>
3687 <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.
3688 Hopefully this closes bug #894805.</phrase></screen>
3689 </listitem>
3690 </itemizedlist>
3691 </sect2><!--end of XSL-Saxon changes for 1.75.0-->
3692
3693 <sect2 xml:id="rn_V1.75.0_XSL-Xalan">
3694 <title>XSL-Xalan</title>
3695 <para>The following changes have been made to the
3696             <filename>xsl-xalan</filename> code
3697             since the 1.74.3 release.</para>
3698 <itemizedlist>
3699 <listitem>
3700 <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.
3701 Hopefully this closes bug #894805.</phrase></screen>
3702 </listitem>
3703 </itemizedlist>
3704 </sect2><!--end of XSL-Xalan changes for 1.75.0-->
3705
3706
3707 </sect1>
3708
3709 <sect1 xml:id="V1.74.3">
3710 <title>Release Notes: 1.74.3</title>
3711 <para>This release fixes some bugs in the 1.74.2 release.</para>
3712 <para>See <filename>highlighting/README</filename> for XSLTHL usage instructions.</para>
3713 </sect1>
3714 <sect1 xml:id="V1.74.2">
3715 <title>Release Notes: 1.74.2</title>
3716 <para>This release fixes some bugs in the 1.74.1 release.</para>
3717 </sect1>
3718
3719 <sect1 xml:id="V1.74.1">
3720 <title>Release Notes: 1.74.1</title>
3721 <para>This release includes important bug fixes and adds the following
3722 significant feature changes:
3723 <variablelist>
3724 <varlistentry>
3725 <term>Gentext</term>
3726 <listitem><para>Kirghiz locale added and Chinese translations have been simplified.</para></listitem>
3727 <listitem><para>Somme support for gentext and right-to-left languages has been added.</para></listitem>
3728 </varlistentry>
3729 <varlistentry>
3730 <term>FO</term>
3731 <listitem><para>Various bugs have been resolved. </para> </listitem>
3732 <listitem><para>Support for a new processing instruction: <markup>dbfo funcsynopsis-style</markup> has been added.  </para> </listitem>
3733 <listitem><para>Added new param <parameter>email.mailto.enabled</parameter> for FO output. Patch from Paolo Borelli.  </para>
3734 </listitem>
3735 <listitem><para>Support for documented metadata in fop1 mode has been added. </para>
3736 </listitem>
3737
3738 </varlistentry>
3739 <varlistentry>
3740 <term>Highlighting</term>
3741 <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>
3742
3743 </varlistentry>
3744
3745 <varlistentry>
3746 <term>Manpages</term>
3747 <listitem><para>Added man.output.better.ps.enabled param (zero default). It non-zero, no such
3748 markup is embedded in generated man pages, and no enhancements are
3749 included in the PostScript output generated from those man pages
3750 by the man -Tps <tag>command</tag>.</para></listitem>
3751
3752 </varlistentry>
3753
3754
3755 <varlistentry>
3756 <term>HTML</term>
3757 <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>
3758 <listitem>
3759 <para>Added a new top-level stylesheet module, chunk-changebars.xsl, to be
3760 used for generating chunked output with highlighting based on change
3761 (@revisionflag) markup. The module imports/includes the standard chunking
3762 and changebars templates and contains additional logic for chunked output.
3763 See FRs #1015180 and #1819915.</para>
3764 </listitem>
3765
3766 </varlistentry>
3767 <varlistentry>
3768 <term>ePub</term>
3769 <listitem>
3770 <para>Covers now look better in Adobe Digital Editions thanks to a patch from Paul Norton of Adobe</para>
3771 </listitem>
3772 <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>
3773 <listitem><para>Cover markup now carries more reliably into files destined for .mobi and the Kindle.</para> </listitem>
3774 <listitem><para><markup>dc:identifiers</markup> are now generated from more types of numbering schemes. </para></listitem>
3775 <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>
3776 <listitem>
3777 <para>Primitive support for embedding a single font added.</para>
3778 </listitem>
3779 <listitem>
3780 <para>Support for embedding a CSS customizations added.</para>
3781 </listitem>
3782
3783 </varlistentry>
3784
3785 <varlistentry>
3786 <term>Roundtrip</term>
3787
3788 <listitem>
3789 <para>Support for imagedata-metadata and <tag>table</tag> as images added.</para>
3790 </listitem>
3791 <listitem>
3792 <para>Support for imagedata-metadata and <tag>legalnotice</tag> as images added.</para>
3793 </listitem>
3794 </varlistentry>
3795
3796 <varlistentry>
3797 <term>Params</term>
3798 <listitem><para><parameter>man.output.better.ps.enabled</parameter> added for Manpages output </para></listitem>
3799 <listitem>
3800 <para><parameter>writing.mode.xml</parameter> added to set text direction.</para>
3801 </listitem>
3802 <listitem>
3803 <para>Added new param <parameter>email.mailto.enabled</parameter> for FO output.
3804 Patch from Paolo Borelli. Closes #2086321.</para>
3805 </listitem>
3806 <listitem>
3807 <para><parameter>highlight.source</parameter> upgraded to support the latest version of XSLTHL 2.0.</para>
3808 </listitem>
3809
3810 </varlistentry>
3811
3812
3813
3814 </variablelist>
3815 </para>
3816 <para>The following is a list of changes that have been made since the 1.74.0 release.</para>
3817
3818
3819 <sect2 xml:id="summary_V1.74.1_Gentext">
3820 <title>Gentext</title>
3821 <para>The following changes have been made to the <filename>gentext</filename> code since the 1.74.0 release.</para>
3822 <itemizedlist>
3823 <listitem>
3824 <para><literal>Michael(tm) Smith: locale/ky.xml; Makefile</literal></para><screen><phrase role="commit-message">new Kirghiz locale from Ilyas Bakirov</phrase></screen>
3825 </listitem>
3826 <listitem>
3827 <para><literal>Mauritz Jeanson: locale/en.xml</literal></para><screen><phrase role="commit-message">Added "<tag>Acknowledgements</tag>".</phrase></screen>
3828 </listitem>
3829 <listitem>
3830 <para><literal>Dongsheng Song: locale/zh_cn.xml</literal></para><screen><phrase role="commit-message">Simplified Chinese translation.</phrase></screen>
3831 </listitem>
3832 <listitem>
3833 <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>
3834 </listitem>
3835 </itemizedlist>
3836 </sect2><!--end of Gentext changes for 1.74.1-->
3837
3838 <sect2 xml:id="summary_V1.74.1_FO">
3839 <title>FO</title>
3840 <para>The following changes have been made to the <filename>fo</filename> code since the 1.74.0 release.</para>
3841 <itemizedlist>
3842 <listitem>
3843 <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>
3844 </listitem>
3845 <listitem>
3846 <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>
3847 </listitem>
3848 <listitem>
3849 <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.
3850 Closes bug #1838213.</phrase></screen>
3851 </listitem>
3852 <listitem>
3853 <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.
3854 Patch from Paolo Borelli. Closes #2086321.</phrase></screen>
3855 </listitem>
3856 <listitem>
3857 <para><literal>Mauritz Jeanson: docbook.xsl</literal></para><screen><phrase role="commit-message">Added support for document metadata for fop1 (patch #2067318).</phrase></screen>
3858 </listitem>
3859 <listitem>
3860 <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
3861  -- nested markup in highlited code is now processed
3862  -- it is no longer needed to specify path XSLTHL configuration file using Java property
3863  -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
3864 </listitem>
3865 </itemizedlist>
3866 </sect2><!--end of FO changes for 1.74.1-->
3867
3868 <sect2 xml:id="summary_V1.74.1_HTML">
3869 <title>HTML</title>
3870 <para>The following changes have been made to the <filename>html</filename> code since the 1.74.0 release.</para>
3871 <itemizedlist>
3872 <listitem>
3873 <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>
3874 </listitem>
3875 <listitem>
3876 <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
3877 used for generating chunked output with highlighting based on change
3878 (@revisionflag) markup. The module imports/includes the standard chunking
3879 and changebars templates and contains additional logic for chunked output.
3880 See FRs #1015180 and #1819915.</phrase></screen>
3881 </listitem>
3882 </itemizedlist>
3883 </sect2><!--end of HTML changes for 1.74.1-->
3884
3885 <sect2 xml:id="summary_V1.74.1_Manpages">
3886 <title>Manpages</title>
3887 <para>The following changes have been made to the <filename>manpages</filename> code since the 1.74.0 release.</para>
3888 <itemizedlist>
3889 <listitem>
3890 <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:
3891   \" t
3892 purpose is to explicitly tell AT&amp;T troff that the page needs to be
3893 pre-processed through tbl(1); groff can <tag>figure</tag> it out
3894 automatically, but apparently AT&amp;T troff needs to be explicitly told</phrase></screen>
3895 </listitem>
3896 </itemizedlist>
3897 </sect2><!--end of Manpages changes for 1.74.1-->
3898
3899 <sect2 xml:id="summary_V1.74.1_Epub">
3900 <title>ePub</title>
3901 <para>The following changes have been made to the <filename>epub</filename> code since the 1.74.0 release.</para>
3902 <itemizedlist>
3903 <listitem>
3904 <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>
3905 </listitem>
3906 <listitem>
3907 <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
3908 DocBook 5.0's &lt;<tag>cover</tag>&gt; now has some limited support:
3909
3910 - should <tag>reference</tag> a <tag>cover</tag> in the OPF guide for a DocBook 5.0 test document</phrase></screen>
3911 </listitem>
3912 <listitem>
3913 <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).
3914
3915 Added new tests:
3916 - should include at least one dc:identifier
3917 - should include an ISBN as URN for dc:identifier if an ISBN was in the metadata
3918 - should include an ISSN as URN for dc:identifier if an ISSN was in the metadata
3919 - should include an <tag>biblioid</tag> as a dc:identifier if an <tag>biblioid</tag> was in the metadata
3920 - 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>
3921 </listitem>
3922 <listitem>
3923 <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
3924 we always send out one and only one h1 in each XHTML chunk.
3925
3926 DocBook::Epub
3927 - should include one and only one &lt;h1&gt; in each HTML file in rendered ePub files
3928 for &lt;<tag>book</tag>&gt;s
3929 - should include one and only one &lt;h1&gt; in each HTML file in rendered ePub files
3930 for &lt;<tag>book</tag>&gt;s even if they do not have <tag>section</tag> markup</phrase></screen>
3931 </listitem>
3932 <listitem>
3933 <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>
3934 </listitem>
3935 <listitem>
3936 <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>
3937 </listitem>
3938 <listitem>
3939 <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>
3940 </listitem>
3941 <listitem>
3942 <para><literal>Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/docbook.rb; bin/s⋯</literal></para><screen><phrase role="commit-message">Adding CSS support to .epub target &amp; dbtoepub:
3943     -c, --css [FILE]                 Use FILE for CSS on generated XHTML.
3944
3945
3946 DocBook::Epub
3947 ...
3948 - should include a CSS <tag>link</tag> in HTML files when a CSS file has been provided
3949 - should include CSS file in .epub when a CSS file has been provided
3950 - should include a CSS <tag>link</tag> in OPF file when a CSS file has been provided</phrase></screen>
3951 </listitem>
3952 </itemizedlist>
3953 </sect2><!--end of Epub changes for 1.74.1-->
3954
3955 <sect2 xml:id="summary_V1.74.1_Roundtrip">
3956 <title>Roundtrip</title>
3957 <para>The following changes have been made to the
3958             <filename>roundtrip</filename> code
3959             since the 1.74.0 release.</para>
3960 <itemizedlist>
3961 <listitem>
3962 <para><literal>Steve Ball: blocks2dbk.xsl; template.xml; template.dot</literal></para><screen><phrase role="commit-message">added support for imagedata-metadata
3963 added support for <tag>table</tag> as images</phrase></screen>
3964 </listitem>
3965 <listitem>
3966 <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>
3967 </listitem>
3968 <listitem>
3969 <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>
3970 </listitem>
3971 <listitem>
3972 <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>
3973 </listitem>
3974 <listitem>
3975 <para><literal>Steve Ball: specifications.xml; supported.xml; blocks2dbk.xsl; wordml2normalise.xsl; dbk2w⋯</literal></para><screen><phrase role="commit-message">Updated specification.
3976 to-DocBook: add cols attribute to <tag>tgroup</tag>
3977 from-DocBook: fix for <tag>blockquote</tag> <tag>title</tag></phrase></screen>
3978 </listitem>
3979 </itemizedlist>
3980 </sect2><!--end of Roundtrip changes for 1.74.1-->
3981
3982 <sect2 xml:id="summary_V1.74.1_Params">
3983 <title>Params</title>
3984 <para>The following changes have been made to the <filename>params</filename> since the 1.74.0 release.</para>
3985 <itemizedlist>
3986 <listitem>
3987 <para>The change was to add man.output.better.ps.enabled parameter, with
3988 its default value set to zero.
3989
3990 If the value of the man.output.better.ps.enabled parameter is
3991 non-zero, certain markup is embedded in each generated man page
3992 such that PostScript output from the man -Tps <tag>command</tag> for that
3993 page will include a number of enhancements designed to improve the
3994 quality of that output.
3995
3996 If man.output.better.ps.enabled is zero (the default), no such
3997 markup is embedded in generated man pages, and no enhancements are
3998 included in the PostScript output generated from those man pages
3999 by the man -Tps <tag>command</tag>.
4000
4001 WARNING: The enhancements provided by this parameter rely on
4002 features that are specific to groff (GNU troff) and that are not
4003 part of "classic" AT&amp;T troff or any of its derivatives. Therefore,
4004 any man pages you generate with this parameter enabled will be
4005 readable only on systems on which the groff (GNU troff) program is
4006 installed, such as GNU/Linux systems.  The pages will not not be
4007 readable on systems on with the classic troff (AT&amp;T troff) <tag>command</tag>
4008 is installed.
4009
4010 NOTE: The value of this parameter only affects PostScript output
4011 generated from the man <tag>command</tag>. It has no effect on output
4012 generated using the FO backend.
4013
4014 <tag>TIP</tag>: You can generate PostScript output for any man page by
4015 running the following <tag>command</tag>:
4016
4017 man FOO -Tps &gt; FOO.ps
4018
4019 You can then generate PDF output by running the following <tag>command</tag>:
4020
4021 ps2pdf FOO.ps</para>
4022 </listitem>
4023 <listitem>
4024 <para><literal>Robert Stayton: writing.mode.xml</literal></para><screen><phrase role="commit-message">writing mode param used to set text direction.</phrase></screen>
4025 </listitem>
4026 <listitem>
4027 <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.
4028 Patch from Paolo Borelli. Closes #2086321.</phrase></screen>
4029 </listitem>
4030 <listitem>
4031 <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
4032  -- nested markup in highlited code is now processed
4033  -- it is no longer needed to specify path XSLTHL configuration file using Java property
4034  -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
4035 </listitem>
4036 </itemizedlist>
4037 </sect2><!--end of Params changes for 1.74.1-->
4038
4039 <sect2 xml:id="summary_V1.74.1_Highlighting">
4040 <title>Highlighting</title>
4041 <para>The following changes have been made to the
4042             <filename>highlighting</filename> code
4043             since the 1.74.0 release.</para>
4044 <itemizedlist>
4045 <listitem>
4046 <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
4047  -- nested markup in highlited code is now processed
4048  -- it is no longer needed to specify path XSLTHL configuration file using Java property
4049  -- support for new languages, including Perl, Python and Ruby was added</phrase></screen>
4050 </listitem>
4051 </itemizedlist>
4052 </sect2><!--end of Highlighting changes for 1.74.1-->
4053
4054 </sect1>
4055
4056
4057 <sect1 xml:id="V1.74.0">
4058 <title>Release Notes: 1.74.0</title>
4059 <para>This release includes important bug fixes and adds the following
4060 significant feature changes:
4061 <variablelist>
4062 <varlistentry>
4063 <term>.epub target</term>
4064 <listitem><para>Paul Norton (Adobe) and Keith Fahlgren(O'Reilly Media) have donated code that generates <filename>.epub</filename> documents from
4065 DocBook input. An alpha-reference implementation in Ruby has also been provided.</para>
4066 <para>.epub is an open standard of the The International Digital Publishing Forum (IDPF),
4067 a the trade and standards association for the digital publishing industry. </para>
4068 <para>Read more about this target in <filename>epub/README</filename>
4069 </para></listitem>
4070 </varlistentry>
4071
4072 <varlistentry>
4073 <term>XHTML 1.1 target</term>
4074 <listitem><para>To support .epub output, a strict XHTML 1.1 target has been added. The stylesheets for this output are
4075 generated and are quite similar to the XHTML target.</para></listitem>
4076 </varlistentry>
4077 <varlistentry>
4078 <term>Gentext updates</term>
4079 <listitem><para>A number of locales have been updated.</para></listitem>
4080 </varlistentry>
4081 <varlistentry>
4082 <term>Roundtrip improvements</term>
4083 <listitem><para>Table, figure, template syncronization, and character style improvements have been made for WordML &amp; Pages. Support added for OpenOffice.org.</para></listitem>
4084
4085 </varlistentry>
4086
4087 <varlistentry>
4088     <term>First implementation of a libxslt extension</term>
4089     <listitem>
4090       <para>A stylesheet extension for libxslt, written in Python, has been added.
4091       The extension is a function for adjusting column widths in CALS tables. See
4092       <filename>extensions/README.LIBXSLT</filename> for more information.</para>
4093     </listitem>
4094  </varlistentry>
4095
4096 </variablelist>
4097 </para>
4098 <para>The following is a list of changes that have been made
4099         since the 1.73.2 release.</para>
4100
4101 <sect2 xml:id="V1.74.0_Gentext">
4102 <title>Gentext</title>
4103 <para>The following changes have been made to the
4104             <filename>gentext</filename> code
4105             since the 1.73.2 release.</para>
4106 <itemizedlist>
4107 <listitem>
4108 <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>
4109 </listitem>
4110 <listitem>
4111 <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>
4112 </listitem>
4113 <listitem>
4114 <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>
4115 </listitem>
4116 <listitem>
4117 <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>
4118 </listitem>
4119 <listitem>
4120 <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
4121 before.</phrase></screen>
4122 </listitem>
4123 <listitem>
4124 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">"no" locale is now "nb"</phrase></screen>
4125 </listitem>
4126 <listitem>
4127 <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>
4128 </listitem>
4129 <listitem>
4130 <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
4131 Norwegian Bokmål is "nb" (not "no") and has been for quite some
4132 time now...</phrase></screen>
4133 </listitem>
4134 <listitem>
4135 <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
4136 that the actual glyphs so up when you edit it in a text editor
4137 (instead of the character references).</phrase></screen>
4138 </listitem>
4139 <listitem>
4140 <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>
4141 </listitem>
4142 <listitem>
4143 <para><literal>Michael(tm) Smith: locale/it.xml</literal></para><screen><phrase role="commit-message">Changes from Federico Zenith</phrase></screen>
4144 </listitem>
4145 <listitem>
4146 <para><literal>Dongsheng Song: locale/zh_cn.xml</literal></para><screen><phrase role="commit-message">Added missing translations.</phrase></screen>
4147 </listitem>
4148 </itemizedlist>
4149 </sect2><!--end of Gentext changes for 1.74.0-->
4150
4151 <sect2 xml:id="V1.74.0_Common">
4152 <title>Common</title>
4153 <para>The following changes have been made to the
4154             <filename>common</filename> code
4155             since the 1.73.2 release.</para>
4156 <itemizedlist>
4157 <listitem>
4158 <para><literal>Michael(tm) Smith: l10n.xsl</literal></para><screen><phrase role="commit-message">Added new template "l10.language.name" for retrieving the
4159 English-language name of the lang setting of the current document.
4160 Closes #1916837. Thanks to Simon Kennedy.</phrase></screen>
4161 </listitem>
4162 <listitem>
4163 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">fixed syntax error</phrase></screen>
4164 </listitem>
4165 <listitem>
4166 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">fixed a couple of typos</phrase></screen>
4167 </listitem>
4168 <listitem>
4169 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">refined handling of cases where refentry "source" or "manual"
4170 metadata is missing or when we use fallback content instead. We
4171 now report a Warning if we use fallback content.</phrase></screen>
4172 </listitem>
4173 <listitem>
4174 <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
4175 "source" or "manual" metadata fields</phrase></screen>
4176 </listitem>
4177 <listitem>
4178 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Made reporting of missing refentry metadata more quiet:
4179
4180   - we no longer report anything if usable-but-not-preferred
4181     metadata is found; we just quietly use whatever we manage to
4182     find
4183
4184   - we now only report missing "source" metadata if the refentry
4185     is missing BOTH "source name" and "version" metadata; if it
4186     has one but not the other, we use whichever one it has and
4187     don't report anything as missing
4188
4189 The above changes were made because testing with some "real world"
4190 source reveals that some authors are intentionally choosing to use
4191 "non preferred" markup for some metadata, and also choosing to
4192 omit "source name" or "version" metadata in there DocBook XML. So
4193 it does no good to give them pedantic reminders about what they
4194 already know...
4195
4196 Also, changed code to cause "fixme" text to be inserted in output
4197 in particular cases:
4198
4199   - if we can't manage to find any "source" metadata at all, we
4200     now put fixme text into the output
4201
4202   - if we can't manage to find any "manual" metadata a all, we
4203     now put fixme text into the output
4204
4205 The "source" and "manual" metadata is necessary information, so
4206 buy putting the fixme stuff in the output, we alert users to the
4207 need problem of it being missing.</phrase></screen>
4208 </listitem>
4209 <listitem>
4210 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">When generating manpages output, we no longer report anything if
4211 the refentry source is missing date or pubdate content. In
4212 practice, many users intentionally omit the date from the source
4213 because they explicitly want it to be generated.</phrase></screen>
4214 </listitem>
4215 <listitem>
4216 <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>
4217 </listitem>
4218 <listitem>
4219 <para><literal>Michael(tm) Smith: common.xsl</literal></para><screen><phrase role="commit-message">Added support for orgname in authorgroup. Thanks to Camille
4220 Bégnis.</phrase></screen>
4221 </listitem>
4222 <listitem>
4223 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">"no" locale is now "nb"</phrase></screen>
4224 </listitem>
4225 <listitem>
4226 <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
4227 work with &lt;link&gt; elements). As far as I can tell, this template is no longer needed.</phrase></screen>
4228 </listitem>
4229 <listitem>
4230 <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>
4231 </listitem>
4232 <listitem>
4233 <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).
4234 Having xref in title is not a problem as long as the target is not an ancestor element.
4235 Closes bug #1838136.
4236
4237 Note that an xref that is in a title and whose target is an ancestor element is still not
4238 rendered in the TOC. This could be considered a bug, but on the other hand I cannot really
4239 see the point in having such an xref in a document.</phrase></screen>
4240 </listitem>
4241 <listitem>
4242 <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
4243 apply-templates" problems when processing xrefs or links in no.anchor.mode mode.
4244 Hopefully, this closes bug #1811721.</phrase></screen>
4245 </listitem>
4246 <listitem>
4247 <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>
4248 </listitem>
4249 <listitem>
4250 <para><literal>Mauritz Jeanson: titles.xsl</literal></para><screen><phrase role="commit-message">Process &lt;link&gt; in no.anchor.mode mode with the same template as &lt;xref&gt;.
4251 Closes bug #1759205 (Empty link in no.anchor.mode mode).</phrase></screen>
4252 </listitem>
4253 <listitem>
4254 <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
4255 of &lt;title&gt;. Previously, having inline elements with @id/@xml:id in &lt;title&gt;s
4256 resulted in anchors both in the TOC and in the main flow. Closes bug #1797492.</phrase></screen>
4257 </listitem>
4258 </itemizedlist>
4259 </sect2><!--end of Common changes for 1.74.0-->
4260
4261 <sect2 xml:id="V1.74.0_FO">
4262 <title>FO</title>
4263 <para>The following changes have been made to the
4264             <filename>fo</filename> code
4265             since the 1.73.2 release.</para>
4266 <itemizedlist>
4267 <listitem> <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Updated documentation for keep-together.</phrase></screen> </listitem>
4268 <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>
4269 <listitem>
4270 <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>
4271 </listitem>
4272 <listitem>
4273 <para><literal>Robert Stayton: index.xsl</literal></para><screen><phrase role="commit-message">Fixed non-working inline.or.block template for indexterm wrappers.
4274 Add fop1 to list of processors using inline.or.block.</phrase></screen>
4275 </listitem>
4276 <listitem>
4277 <para><literal>Mauritz Jeanson: table.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1891965 (colsep in entytbl not working).</phrase></screen>
4278 </listitem>
4279 <listitem>
4280 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added support for title in revhistory. Closes bug #1842847.</phrase></screen>
4281 </listitem>
4282 <listitem>
4283 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Small doc cleanup (dbfo float-type).</phrase></screen>
4284 </listitem>
4285 <listitem>
4286 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Insert commas between multiple copyright holders.</phrase></screen>
4287 </listitem>
4288 <listitem>
4289 <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>
4290 </listitem>
4291 <listitem>
4292 <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>
4293 </listitem>
4294 <listitem>
4295 <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>
4296 </listitem>
4297 <listitem>
4298 <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,
4299 and the "hot text" is the biblioid itself enclosed in brackets.</phrase></screen>
4300 </listitem>
4301 <listitem>
4302 <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>
4303 </listitem>
4304 <listitem>
4305 <para><literal>Mauritz Jeanson: docbook.xsl</literal></para><screen><phrase role="commit-message">Updated message about unmatched element.</phrase></screen>
4306 </listitem>
4307 <listitem>
4308 <para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Added link to profiling chapter of TCG.</phrase></screen>
4309 </listitem>
4310 <listitem>
4311 <para><literal>Mauritz Jeanson: refentry.xsl</literal></para><screen><phrase role="commit-message">Fixed typo (refsynopsysdiv -&gt; refsynopsisdiv).</phrase></screen>
4312 </listitem>
4313 <listitem>
4314 <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>
4315 </listitem>
4316 <listitem>
4317 <para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Added support for MathML in imagedata.</phrase></screen>
4318 </listitem>
4319 <listitem>
4320 <para><literal>Michael(tm) Smith: math.xsl</literal></para><screen><phrase role="commit-message">Removed unnecessary extra test condition in test express that
4321 checks for passivetex.</phrase></screen>
4322 </listitem>
4323 <listitem>
4324 <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
4325 passivetex. Closes #1806899. Thanks to Justus Piater.</phrase></screen>
4326 </listitem>
4327 <listitem>
4328 <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
4329 generate.toc='article/appendix toc'. Closes bug #1669658.</phrase></screen>
4330 </listitem>
4331 <listitem>
4332 <para><literal>Dongsheng Song: biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Change encoding from "windows-1250" to "UTF-8".</phrase></screen>
4333 </listitem>
4334 <listitem>
4335 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Updated documentation for dbfo_label-width.</phrase></screen>
4336 </listitem>
4337 <listitem>
4338 <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>
4339 </listitem>
4340 <listitem>
4341 <para><literal>Robert Stayton: biblio.xsl</literal></para><screen><phrase role="commit-message">Support finding glossary database entries inside bibliodivs.</phrase></screen>
4342 </listitem>
4343 <listitem>
4344 <para><literal>Robert Stayton: formal.xsl</literal></para><screen><phrase role="commit-message">Complete support for &lt;?dbfo pgwide="1"?&gt; for informal
4345 elements too.</phrase></screen>
4346 </listitem>
4347 <listitem>
4348 <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
4349 a table may break (depending on the PI value) at a page break. This was needed
4350 since the outer fo:block that surrounds fo:table has keep-together.within-column="always"
4351 by default, which prevents the table from breaking. Closes bug #1740964 (Titled
4352 table does not respect dbfo PI).</phrase></screen>
4353 </listitem>
4354 <listitem>
4355 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Added a few missing @role="tcg".</phrase></screen>
4356 </listitem>
4357 <listitem>
4358 <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>
4359 </listitem>
4360 <listitem>
4361 <para><literal>Mauritz Jeanson: autoidx.xsl</literal></para><screen><phrase role="commit-message">Removed the [&amp;scope;] predicate from the target variable in the template with name="reference".
4362 This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
4363 with index.on.type=1. Closes bug #1680836.</phrase></screen>
4364 </listitem>
4365 <listitem>
4366 <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
4367 hyperlinks (elements marked up with xlink:href attributes) in the
4368 same way as URLs for ulinks are already handled (which is to say,
4369 either inline or as numbered footnotes).
4370
4371 Background on this change:
4372 DocBook 5 allows "ubiquitous" linking, which means you can make
4373 any element a hyperlink just by adding an xlink:href attribute to
4374 it, with the value set to an external URL. That's in contrast to
4375 DocBook 4, which only allows you to use specific elements (e.g.,
4376 the link and ulink elements) to mark up hyperlinks.
4377
4378 The existing FO stylesheets have a mechanism for handling display
4379 of URLs for hyperlinks that are marked up with ulink, but they did
4380 not handle display of URLs for elements that were marked up with
4381 xlink:href attributes. This change adds handling for those other
4382 elements, enabling the URLs they link to be displayed either
4383 inline or as numbered footnotes (depending on what values the user
4384 has the ulink.show and ulink.footnotes params set to).
4385
4386 Note that this change only adds URL display support for elements
4387 that call the simple.xlink template -- which currently is most
4388 (but not all) inline elements.
4389
4390 This change also moves the URL display handling out of the ulink
4391 template and into a new "hyperlink.url.display" named template;
4392 the ulink template and the simple.xlink named template now both
4393 call the hyperlink.url.display template.
4394
4395 Warning: In the stylesheet code that determines what footnote
4396 number to assign to each footnote or external hyperlink, there is
4397 an XPath expression for determining whether a particular
4398 xlink:href instance is an external hyperlink; that expression is
4399 necessarily a bit complicated and further testing may reveal that
4400 it doesn't handle all cases as expected -- so some refinements to
4401 it may need to be done later.
4402
4403 Closes #1785519. Thanks to Ken Morse for reporting and
4404 troubleshooting the problem.</phrase></screen>
4405 </listitem>
4406 </itemizedlist>
4407 </sect2><!--end of FO changes for 1.74.0-->
4408
4409 <sect2 xml:id="V1.74.0_HTML">
4410 <title>HTML</title>
4411 <para>The following changes have been made to the
4412             <filename>html</filename> code
4413             since the 1.73.2 release.</para>
4414 <itemizedlist>
4415 <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>
4416 <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>
4417 <listitem> <para><literal>Keith Fahlgren: biblio.xsl</literal></para><screen><phrase role="commit-message">Add anchors to bibliodivs</phrase></screen> </listitem>
4418 <listitem>
4419 <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
4420 and Keith Fahlgren of O'Reilly.</phrase></screen>
4421 <para>This change includes new code for generating the XHTML 1.1 target sanely.</para>
4422 </listitem>
4423 <listitem>
4424 <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
4425 Object Identifiers). See FR #1934434 and http://doi.org.
4426
4427 To do: 1) Add support for FO output. 2) Figure out how @class="doi" should be handled
4428 for bibliorelation, bibliosource and citebiblioid.</phrase></screen>
4429 </listitem>
4430 <listitem>
4431 <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>
4432 </listitem>
4433 <listitem>
4434 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">Added checks and hacks to various makefiles to enable building
4435 under Cygwin. This stuff is ugly and maybe not worth the mess and
4436 trouble, but does seem to work as expected and not break anything
4437 else.</phrase></screen>
4438 </listitem>
4439 <listitem>
4440 <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">added "exslt" namespace binding to html/docbook.xsl file (in
4441 addition to existing "exsl" binding. reason is because lack of it
4442 seems to cause processing problems when using the profiled
4443 version of the stylsheet</phrase></screen>
4444 </listitem>
4445 <listitem>
4446 <para><literal>Norman Walsh: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Rename link</phrase></screen>
4447 </listitem>
4448 <listitem>
4449 <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>
4450 </listitem>
4451 <listitem>
4452 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Simplified and streamlined handling of output for ANSI-style
4453 funcprototype output, to correct a problem that was causing type
4454 data to be lost in the output parameter definitions. For example,
4455 for an instance like this:
4456   &lt;paramdef&gt;void *&lt;parameter&gt;dataptr&lt;/parameter&gt;[]&lt;/paramdef&gt;
4457 ... the brackets (indicating an array type) were being dropped.</phrase></screen>
4458 </listitem>
4459 <listitem>
4460 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Changed HTML handling of K&amp;R-style paramdef output. The parameter
4461 definitions are no longer output in a table (though the prototype
4462 still is). The reason for the change is that the
4463 kr-tabular-funcsynopsis-mode template was causing type data to be
4464 lost in the output parameter definitions. For example, for an
4465 instance like this:
4466   &lt;paramdef&gt;void *&lt;parameter&gt;dataptr&lt;/parameter&gt;[]&lt;/paramdef&gt;
4467 ... the brackets (indicating an array type) were being dropped.
4468 The easiest way to deal with the problem is to not try to chop up
4469 the parameter definitions and display them in table format, but to
4470 instead just output them as-is. May not look quite as pretty, but
4471 at least we can be sure no information is being lost...</phrase></screen>
4472 </listitem>
4473 <listitem>
4474 <para><literal>Michael(tm) Smith: pi.xsl</literal></para><screen><phrase role="commit-message">updated wording of doc for funcsynopsis-style PI</phrase></screen>
4475 </listitem>
4476 <listitem>
4477 <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
4478 being used in the code and hasn't been since mid 2006.</phrase></screen>
4479 </listitem>
4480 <listitem>
4481 <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>
4482 </listitem>
4483 <listitem>
4484 <para><literal>Mauritz Jeanson: chunk-common.xsl</literal></para><screen><phrase role="commit-message">Added missing space.</phrase></screen>
4485 </listitem>
4486 <listitem>
4487 <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>
4488 </listitem>
4489 <listitem>
4490 <para><literal>Michael(tm) Smith: pi.xsl</literal></para><screen><phrase role="commit-message">Moved dbhtml_stop-chunking embedded doc into alphabetical order,
4491 fixed text of TCG section it see-also'ed.</phrase></screen>
4492 </listitem>
4493 <listitem>
4494 <para><literal>David Cramer: pi.xsl</literal></para><screen><phrase role="commit-message">Added support for &lt;?dbhtml stop-chunking?&gt; processing instruction</phrase></screen>
4495 </listitem>
4496 <listitem>
4497 <para><literal>David Cramer: chunk-common.xsl; pi.xsl</literal></para><screen><phrase role="commit-message">Added support for &lt;?dbhtml stop-chunking?&gt; processing instruction</phrase></screen>
4498 </listitem>
4499 <listitem>
4500 <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>
4501 </listitem>
4502 <listitem>
4503 <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,
4504 and the "hot text" is the biblioid itself enclosed in brackets.</phrase></screen>
4505 </listitem>
4506 <listitem>
4507 <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"
4508 values are supported (corresponding to values of "_blank" and "_top" for the
4509 ulink.target parameter). I have assumed that @xlink:show should override ulink.target
4510 for external URI links. This closes bugs #1762023 and #1727498.</phrase></screen>
4511 </listitem>
4512 <listitem>
4513 <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>
4514 </listitem>
4515 <listitem>
4516 <para><literal>Mauritz Jeanson: param.xweb</literal></para><screen><phrase role="commit-message">Added link to profiling chapter of TCG.</phrase></screen>
4517 </listitem>
4518 <listitem>
4519 <para><literal>Dongsheng Song: biblio-iso690.xsl</literal></para><screen><phrase role="commit-message">Change encoding from "windows-1250" to "UTF-8".</phrase></screen>
4520 </listitem>
4521 <listitem>
4522 <para><literal>Robert Stayton: biblio.xsl</literal></para><screen><phrase role="commit-message">Add support in biblio collection to entries in bibliodivs.</phrase></screen>
4523 </listitem>
4524 <listitem>
4525 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Added missing @role="tcg".</phrase></screen>
4526 </listitem>
4527 <listitem>
4528 <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
4529 parameter as well as the dbhtml_filename PI are taken into account. A new named
4530 template in titlepage.xsl is used to compute the filename.</phrase></screen>
4531 </listitem>
4532 <listitem>
4533 <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):
4534 The "ln-" prefix is output only when the legalnotice doesn't have an
4535 @id/@xml:id, in which case the stylesheets generate an ID value,
4536 resulting in a filename like "ln-7e0fwgj.html". This is useful because
4537 without the prefix, you wouldn't know that the file contained a legalnotice.
4538 The same logic is also applied to revhistory, using an "rh-" prefix.</phrase></screen>
4539 </listitem>
4540 <listitem>
4541 <para><literal>Mauritz Jeanson: autoidx.xsl</literal></para><screen><phrase role="commit-message">Removed the [&amp;scope;] predicate from the target variable in the template with name="reference".
4542 This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
4543 with index.on.type=1. Closes bug #1680836.</phrase></screen>
4544 </listitem>
4545 <listitem>
4546 <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
4547 &lt;link href"..."&gt; that is output by make.legalnotice.head.links (chunk-common.xsl).
4548 Modified the href attribute on the legalnotice link.
4549 Closes bug #1790495.</phrase></screen>
4550 </listitem>
4551 </itemizedlist>
4552 </sect2><!--end of HTML changes for 1.74.0-->
4553
4554 <sect2 xml:id="V1.74.0_Manpages">
4555 <title>Manpages</title>
4556 <para>The following changes have been made to the
4557             <filename>manpages</filename> code
4558             since the 1.73.2 release.</para>
4559 <itemizedlist>
4560 <listitem>
4561 <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">slightly adjusted spacing around admonition markers</phrase></screen>
4562 </listitem>
4563 <listitem>
4564 <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
4565 make the indenting of their child content less severe</phrase></screen>
4566 </listitem>
4567 <listitem>
4568 <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>
4569 </listitem>
4570 <listitem>
4571 <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>
4572 </listitem>
4573 <listitem>
4574 <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>
4575 </listitem>
4576 <listitem>
4577 <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">For PS/non-TTY output, display footnote/endnote numbers in
4578 superscript.</phrase></screen>
4579 </listitem>
4580 <listitem>
4581 <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,
4582 and synopfragment such that they now look correct in non-TTY/PS
4583 output. We now use the groff \w escape to hang by the actual width
4584 -- in the current font -- of the command, funcdef, or
4585 synopfragment references number (as opposed to hanging by the
4586 number of characters). This rendering in TTY output remains the
4587 same, since the width in monospaced TTY output is the same as the
4588 number of characters.
4589
4590 Also, created new synopsis-block-start and synopsis-block-end
4591 templates to use for cmdsynopsis and funcsynopsis instead of the
4592 corresponding verbatim-* templates.
4593
4594 Along with those changes, also corrected a problem that caused the
4595 content of synopfragment to be dropped, and made a
4596 vertical-spacing change to adjust spacing around table titles and
4597 among sibling synopfragment instances.</phrase></screen>
4598 </listitem>
4599 <listitem>
4600 <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>
4601 </listitem>
4602 <listitem>
4603 <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
4604 in italic (despite the fact that man guidelines say we should)</phrase></screen>
4605 </listitem>
4606 <listitem>
4607 <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">put filename output in monospace instead of italic</phrase></screen>
4608 </listitem>
4609 <listitem>
4610 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">put cmdsynopsis in monospace</phrase></screen>
4611 </listitem>
4612 <listitem>
4613 <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">removed template match for literal. template matches for monospace
4614 inlines are all imported from the HTML stylesheet</phrase></screen>
4615 </listitem>
4616 <listitem>
4617 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">don't indent verbatim environments that are descendants of
4618 refsynopsisdiv, not put backgrounds behind them</phrase></screen>
4619 </listitem>
4620 <listitem>
4621 <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
4622 inline monospace instances in the git man pages to be set in
4623 monospace (since DocBook XML source for git docs is generated with
4624 asciidoc and asciidoc consistently outputs only &lt;literal&gt; for
4625 inline monospace (not &lt;command&gt; or &lt;code&gt; or anything else).
4626 Of course this only affects non-TTY output...</phrase></screen>
4627 </listitem>
4628 <listitem>
4629 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">Added inline.monoseq named template.</phrase></screen>
4630 </listitem>
4631 <listitem>
4632 <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
4633 font-family value when setting blocks of text in code font; just
4634 use \F[] .fam with no arg to switch back</phrase></screen>
4635 </listitem>
4636 <listitem>
4637 <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
4638 renders content marked up with the .URL macro)</phrase></screen>
4639 </listitem>
4640 <listitem>
4641 <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,
4642 changed the default font formatting for links to bold.</phrase></screen>
4643 </listitem>
4644 <listitem>
4645 <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
4646 base URL for relative links (for ulink, @xlink:href, imagedata,
4647 audiodata, videodata) shown in the generated NOTES section of
4648 man-page output. The value of man.base.url.for.relative.links is
4649 prepended to any relative URI that is a value of ulink url,
4650 xlink:href, or fileref attribute.
4651
4652 If you use relative URIs in link sources in your DocBook refentry
4653 source, and you leave man.base.url.for.relative.links unset, the
4654 relative links will appear "as is" in the NOTES section of any
4655 man-page output generated from your source. That's probably not
4656 what you want, because such relative links are only usable in the
4657 context of HTML output. So, to make the links meaningful and
4658 usable in the context of man-page output, set a value for
4659 man.base.url.for.relative.links that points
4660 to the online version of HTML output generated from your DocBook
4661 refentry source. For example:
4662
4663   &lt;xsl:param name="man.base.url.for.relative.links"
4664   &gt;http://www.kernel.org/pub/software/scm/git/docs/&lt;/xsl:param&gt;</phrase></screen>
4665 </listitem>
4666 <listitem>
4667 <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">If a source refentry contains a Documentation or DOCUMENTATION
4668 section, don't report it as having missing AUTHOR information.
4669 Also, if missing a contrib/personblurb for a person or org, report
4670 pointers to http://docbook.sf.net/el/personblurb and to
4671 http://docbook.sf.net/el/contrib</phrase></screen>
4672 </listitem>
4673 <listitem>
4674 <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
4675 personblurb or contrib, report it to the user (because that means
4676 we have no information about that author|editor|othercredit to
4677 display in the generated AUTHOR|AUTHORS section...)</phrase></screen>
4678 </listitem>
4679 <listitem>
4680 <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
4681 a fixme in the output</phrase></screen>
4682 </listitem>
4683 <listitem>
4684 <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
4685 section. Thanks to Daniel Leidert and the fglrx docs for exposing
4686 the bug.</phrase></screen>
4687 </listitem>
4688 <listitem>
4689 <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,
4690 suppress the .sp or .PP that would normally be output (because in
4691 those cases, the output goes into a table cell, and the .sp or .PP
4692 markup causes a spurious linebreak before it when displayed</phrase></screen>
4693 </listitem>
4694 <listitem>
4695 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Added support for rendering co callouts and calloutlist instances.
4696 So you can now use simple callouts -- marking up programlisting
4697 and such with co instances -- and have the callouts displayed in
4698 man-page output. ("simple callouts" means using co@id and
4699 callout@arearefs pointing to co@id instances; in man/roff output,
4700 we can't/don't support markup that uses areaset and area)</phrase></screen>
4701 </listitem>
4702 <listitem>
4703 <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
4704 text node or a paragraph</phrase></screen>
4705 </listitem>
4706 <listitem>
4707 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">put verbatim environments in slightly smaller font in non-TTY
4708 output</phrase></screen>
4709 </listitem>
4710 <listitem>
4711 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">minor whitespace-only reformatting of lists.xsl source</phrase></screen>
4712 </listitem>
4713 <listitem>
4714 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Made refinements/fixes to output of orderedlist and itemizedlist
4715 -- in part, to get mysql man pages to display correctly. This
4716 change causes a "\c" continuation marker to be added between
4717 listitem markers and contents (to ensure that the content remains
4718 on the same line as the marker when displayed)</phrase></screen>
4719 </listitem>
4720 <listitem>
4721 <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
4722 sibling content following it (not just if that sibling content is
4723 a text node)</phrase></screen>
4724 </listitem>
4725 <listitem>
4726 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">refined spacing around titles for admonitions</phrase></screen>
4727 </listitem>
4728 <listitem>
4729 <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
4730 after the opening tag. Assumption is that users generally don't
4731 want that linebreak to appear in output, so we do some groff
4732 hackery to mess with vertical spacing and close the space.</phrase></screen>
4733 </listitem>
4734 <listitem>
4735 <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">indexterm instances now produce groff comments like this:
4736
4737   .\" primary: secondary: tertiary
4738
4739 remark instances, if non-empty, now produce groff comments</phrase></screen>
4740 </listitem>
4741 <listitem>
4742 <para><literal>Michael(tm) Smith: charmap.groff.xsl; other.xsl</literal></para><screen><phrase role="commit-message">convert no-break space character to groff "\ \&amp;" (instead of just
4743 "\ "). the reason is that if a space occurs at the end of a line,
4744 our processing causes it to be eaten. a real-world case of this is
4745 the mysql(1) man page. appending the "\&amp;" prevents that</phrase></screen>
4746 </listitem>
4747 <listitem>
4748 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">output "sp" before simpara output, not after it (outputting it
4749 after results in undesirable whitespace in particular cases; for
4750 example, in the hg/mercurial docs</phrase></screen>
4751 </listitem>
4752 <listitem>
4753 <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"
4754 between synopsis fragments with call to pinch.together instead</phrase></screen>
4755 </listitem>
4756 <listitem>
4757 <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"
4758 hack), and "sp 1" after all tables (instead of just "sp"</phrase></screen>
4759 </listitem>
4760 <listitem>
4761 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">created title-preamble template for suppressing line spacing after
4762 headings</phrase></screen>
4763 </listitem>
4764 <listitem>
4765 <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">further refinement of indenting in AUTHORS section</phrase></screen>
4766 </listitem>
4767 <listitem>
4768 <para><literal>Michael(tm) Smith: block.xsl; other.xsl</literal></para><screen><phrase role="commit-message">refined handling of admonitions</phrase></screen>
4769 </listitem>
4770 <listitem>
4771 <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>
4772 </listitem>
4773 <listitem>
4774 <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
4775 instead.</phrase></screen>
4776 </listitem>
4777 <listitem>
4778 <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>
4779 </listitem>
4780 <listitem>
4781 <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>
4782 </listitem>
4783 <listitem>
4784 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">Reworked output for admonitions (caution, important, note, tip,
4785 warning). In TTY output, admonitions now get indented. In non-TTY
4786 output, a colored marker (yellow) is displayed next to them.</phrase></screen>
4787 </listitem>
4788 <listitem>
4789 <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
4790 a block of text.</phrase></screen>
4791 </listitem>
4792 <listitem>
4793 <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
4794 from nested-section-title template. This allows the bolding to
4795 also be used by the template for formatting admonitions</phrase></screen>
4796 </listitem>
4797 <listitem>
4798 <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>
4799 </listitem>
4800 <listitem>
4801 <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>
4802 </listitem>
4803 <listitem>
4804 <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
4805 output</phrase></screen>
4806 </listitem>
4807 <listitem>
4808 <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
4809 the handling of charmap subsets to differentiate between English
4810 and non-English source.
4811
4812 This way charmap subsets are now handled is this:
4813
4814 If the value of the man.charmap.use.subset parameter is non-zero,
4815 and your DocBook source is not written in English (that is, if its
4816 lang or xml:lang attribute has a value other than en), then the
4817 character-map subset specified by the man.charmap.subset.profile
4818 parameter is used instead of the full roff character map.
4819
4820 Otherwise, if the lang or xml:lang attribute on the root element
4821 in your DocBook source or on the first refentry element in your
4822 source has the value en or if it has no lang or xml:lang
4823 attribute, then the character-map subset specified by the
4824 man.charmap.subset.profile.english parameter is used instead of
4825 man.charmap.subset.profile.
4826
4827 The difference between the two subsets is that
4828 man.charmap.subset.profile provides mappings for characters in
4829 Western European languages that are not part of the Roman
4830 (English) alphabet (ASCII character set).</phrase></screen>
4831 </listitem>
4832 <listitem>
4833 <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">Various updates, mainly related to uppercasing SH titles:
4834
4835   - added a "Language: " metadata line to the top comment area of
4836     output man pages, to indicate the language the page is in
4837
4838   - added a "toupper" macro of doing locale-aware uppercasing of
4839     SH titles and cross-references to SH titles; the mechanism
4840     relies on the uppercase.alpha and lowercase.alpha DocBook
4841     gentext keys to do locale-aware uppercasing based on the
4842     language the page is written in
4843
4844   - added a "string.shuffle" template, which provides a library
4845     function for "shuffling" two strings together into a single
4846     string; it takes the first character for the first string, the
4847     first character from second string, etc. The only current use
4848     for it is to generate the argument for the groff tr request
4849     that does string uppercasing.
4850
4851   - added make.tr.uppercase.arg and make.tr.normalcase.arg named
4852     templates for use in generating groff code for uppercasing and
4853     "normal"-casing SH titles
4854
4855   - made the BB/BE "background drawing" macros have effect only in
4856     non-TTY output
4857
4858   - output a few comments in the top part of source</phrase></screen>
4859 </listitem>
4860 <listitem>
4861 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">removed some leftover kruft</phrase></screen>
4862 </listitem>
4863 <listitem>
4864 <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
4865 in the refname(s) with underscores. This ensures that tools like
4866 lexgrog(1) will be able to parse the name (lexgrog won't parse
4867 names that contain spaces).</phrase></screen>
4868 </listitem>
4869 <listitem>
4870 <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
4871 content starts. (We now have a few of macro definitions at the
4872 start of the source, so putting this comment in helps those that
4873 might be viewing the source.)</phrase></screen>
4874 </listitem>
4875 <listitem>
4876 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">refined mechanism for generating SH titles</phrase></screen>
4877 </listitem>
4878 <listitem>
4879 <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.
4880 This means that generated Finnish man pages will no longer contain
4881 any raw accented characters -- they'll instead by marked up with
4882 groff escapes.</phrase></screen>
4883 </listitem>
4884 <listitem>
4885 <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
4886 dots to be output just as "\." -- instead needs to be "\&amp;." (which
4887 is what it will be now, after this change)</phrase></screen>
4888 </listitem>
4889 <listitem>
4890 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Changed backend handling for generating titles for SH sections and
4891 for cross-references to those sections. This should have no effect
4892 on TTY output (behavior should remain the same hopefully) but
4893 results in titles in normal case (instead of uppercase) in PS
4894 output.</phrase></screen>
4895 </listitem>
4896 <listitem>
4897 <para><literal>Michael(tm) Smith: info.xsl</literal></para><screen><phrase role="commit-message">use make.subheading template to make subheadings for AUTHORS and
4898 COPYRIGHT sections (instead of harcoding roff markup)</phrase></screen>
4899 </listitem>
4900 <listitem>
4901 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">put code font around programlisting etc.</phrase></screen>
4902 </listitem>
4903 <listitem>
4904 <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
4905 code font</phrase></screen>
4906 </listitem>
4907 <listitem>
4908 <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">use the make.subheading template to generated SH subheading for
4909 endnotes section.</phrase></screen>
4910 </listitem>
4911 <listitem>
4912 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Added some templates for generating if-then-else conditional
4913 markup in groff, so let's use those instead of hard-coding it in
4914 multiple places...</phrase></screen>
4915 </listitem>
4916 <listitem>
4917 <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
4918 from "man -l -Tps" look better. The current changes:
4919
4920   - render synopsis and verbatim sections in a monospace/code font
4921
4922   - put a light-grey background behind all programlisting, screen,
4923     and literallayout instances
4924
4925   - prevent SH heads in PS output from being rendered in uppercase
4926     (as they are in console output)
4927
4928   - also display xrefs to SH heads in PS output in normal case
4929     (instead of uppercase)
4930
4931   - draw a line under SH heads in PS output
4932
4933 The changes made to the code to support the above features were:
4934
4935   - added some embedded/custom macros: one for conditionally
4936     upper-casing SH x-refs, one for redefining the SH macro
4937     itself, with some conditional handling for PS output, and
4938     finally a macro for putting a background/screen (filled box)
4939     around a block of text (e.g., a program listing) in PS output
4940
4941   - added utility templates for wrapping blocks of text in code
4942     font; also templates for inline code font</phrase></screen>
4943 </listitem>
4944 <listitem>
4945 <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>
4946 </listitem>
4947 <listitem>
4948 <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
4949 orderedlist output for TTY. Existing code seemed to have been
4950 causing an extra undesirable space to appear.</phrase></screen>
4951 </listitem>
4952 <listitem>
4953 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Wrapped some roff conditionals around roff markup for orderedlist
4954 and itemizedlist output, so that the lists look acceptable in PS
4955 output as well as TTY.</phrase></screen>
4956 </listitem>
4957 <listitem>
4958 <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
4959 manpages output as the funcsynopsis.style parameter has in HTML
4960 output -- except that its default value is 'ansi' instead of 'kr'.</phrase></screen>
4961 </listitem>
4962 <listitem>
4963 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Reworked handling of K&amp;R funcprototype output. It no longer relies
4964 on the HTML kr-tabular templates, but instead just does direct
4965 transformation to roff. For K&amp;R output, it displays the paramdef
4966 output in an indented list following the prototype.</phrase></screen>
4967 </listitem>
4968 <listitem>
4969 <para><literal>Michael(tm) Smith: synop.xsl</literal></para><screen><phrase role="commit-message">Properly integrated handling for K&amp;R output into manpages
4970 stylesheet. The choice between K&amp;R output and ANSI output is
4971 currently controlled through use of the (HTML) funcsynopsis.style
4972 parameter. Note that because the mechanism does currently rely on
4973 funcsynopsis.style, the default in manpages output is now K&amp;R
4974 (because that's the default of that param). But I suppose I ought
4975 to create a man.funcsynopsis.style and make the default for that
4976 ANSI (to preserve the existing default behavior).</phrase></screen>
4977 </listitem>
4978 <listitem>
4979 <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">added manpages/pi.xsl file</phrase></screen>
4980 </listitem>
4981 <listitem>
4982 <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
4983 doc build.</phrase></screen>
4984 </listitem>
4985 <listitem>
4986 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Fixed regression that caused an unescaped dash to be output
4987 between refname and refpurpose content. Closes bug #1894244.
4988 Thanks to Daniel Leidert.</phrase></screen>
4989 </listitem>
4990 <listitem>
4991 <para><literal>Michael(tm) Smith: other.xsl</literal></para><screen><phrase role="commit-message">Fixed problem with dots being escaped in filenames of generated
4992 man files. Closes #1827195. Thanks to Daniel Leidert.</phrase></screen>
4993 </listitem>
4994 <listitem>
4995 <para><literal>Michael(tm) Smith: inline.xsl</literal></para><screen><phrase role="commit-message">Added support for processing structfield (was appearing in roff
4996 output surrounded by HTML &lt;em&gt; tags; fixed so that it gets roff
4997 ital markup). Closes bug #1858329.  Thanks to Sam Varshavchik.</phrase></screen>
4998 </listitem>
4999 </itemizedlist>
5000 </sect2><!--end of Manpages changes for 1.74.0-->
5001
5002 <sect2 xml:id="V1.74.0_Epub">
5003 <title>Epub</title>
5004 <para>The following changes have been made to the
5005             <filename>epub</filename> code
5006             since the 1.73.2 release.</para>
5007 <itemizedlist>
5008 <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>
5009 <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>
5010 <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>
5011 <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>
5012 <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>
5013 <listitem>
5014 <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
5015 and Keith Fahlgren of O'Reilly.</phrase></screen>
5016 </listitem>
5017 <listitem>
5018 <para><literal>Keith Fahlgren: docbook.xsl</literal></para><screen><phrase role="commit-message">== General epub test support
5019
5020 $ spec -O ~/.spec.opts spec/epub_spec.rb
5021
5022 DocBook::Epub
5023 - should be able to be created
5024 - should fail on a nonexistent file
5025 - should be able to render to a file
5026 - should create a file after rendering
5027 - should have the correct mimetype after rendering
5028 - should be valid .epub after rendering an article
5029 - should be valid .epub after rendering an article without sections
5030 - should be valid .epub after rendering a book
5031 - should be valid .epub after rendering a book even if it has one graphic
5032 - should be valid .epub after rendering a book even if it has many graphics
5033 - should be valid .epub after rendering a book even if it has many duplicated graphics
5034 - should report an empty file as invalid
5035 - should confirm that a valid .epub file is valid
5036 - should not include PDFs in rendered epub files as valid image inclusions
5037 - should include a TOC link in rendered epub files for &lt;book&gt;s
5038
5039 Finished in 20.608395 seconds
5040
5041 15 examples, 0 failures
5042
5043
5044 == Verbose epub test coverage against _all_ of the testdocs
5045
5046 Fails on only (errors truncated):
5047 1)
5048 '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
5049 '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
5050 ....
5051
5052 Finished in 629.89194 seconds
5053
5054 224 examples, 15 failures
5055
5056 224 examples, 15 failures yields 6% failure rate</phrase></screen>
5057 </listitem>
5058 </itemizedlist>
5059 </sect2><!--end of Epub changes for 1.74.0-->
5060
5061 <sect2 xml:id="V1.74.0_HTMLHelp">
5062 <title>HTMLHelp</title>
5063 <para>The following changes have been made to the
5064             <filename>htmlhelp</filename> code
5065             since the 1.73.2 release.</para>
5066 <itemizedlist>
5067 <listitem>
5068 <para><literal>Mauritz Jeanson: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt; to calls to
5069 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
5070 This makes chunk.quietly=1 suppress chunk filename messages also for help
5071 support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
5072 </listitem>
5073 </itemizedlist>
5074 </sect2><!--end of HTMLHelp changes for 1.74.0-->
5075
5076 <sect2 xml:id="V1.74.0_Eclipse">
5077 <title>Eclipse</title>
5078 <para>The following changes have been made to the
5079             <filename>eclipse</filename> code
5080             since the 1.73.2 release.</para>
5081 <itemizedlist>
5082 <listitem>
5083 <para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Use sortas attributes (if they exist) when sorting indexterms</phrase></screen>
5084 </listitem>
5085 <listitem>
5086 <para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added support for indexterm/see in eclipse index.xml</phrase></screen>
5087 </listitem>
5088 <listitem>
5089 <para><literal>Mauritz Jeanson: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt;
5090 to helpidx template.</phrase></screen>
5091 </listitem>
5092 <listitem>
5093 <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>
5094 </listitem>
5095 <listitem>
5096 <para><literal>Mauritz Jeanson: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt; to calls to
5097 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
5098 This makes chunk.quietly=1 suppress chunk filename messages also for help
5099 support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
5100 </listitem>
5101 </itemizedlist>
5102 </sect2><!--end of Eclipse changes for 1.74.0-->
5103
5104 <sect2 xml:id="V1.74.0_JavaHelp">
5105 <title>JavaHelp</title>
5106 <para>The following changes have been made to the
5107             <filename>javahelp</filename> code
5108             since the 1.73.2 release.</para>
5109 <itemizedlist>
5110 <listitem>
5111 <para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:with-param name="quiet" select="$chunk.quietly"/&gt; to calls to
5112 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
5113 This makes chunk.quietly=1 suppress chunk filename messages also for help
5114 support files (which seems to be what one would expect). See bug #1648360.</phrase></screen>
5115 </listitem>
5116 </itemizedlist>
5117 </sect2><!--end of JavaHelp changes for 1.74.0-->
5118
5119 <sect2 xml:id="V1.74.0_Roundtrip">
5120 <title>Roundtrip</title>
5121 <para>The following changes have been made to the
5122             <filename>roundtrip</filename> code
5123             since the 1.73.2 release.</para>
5124 <itemizedlist>
5125 <listitem>
5126 <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>
5127 </listitem>
5128 <listitem>
5129 <para><literal>Mauritz Jeanson: supported.xml</literal></para><screen><phrase role="commit-message">Changed @cols to 5.</phrase></screen>
5130 </listitem>
5131 <listitem>
5132 <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>
5133 </listitem>
5134 <listitem>
5135 <para><literal>Steve Ball: supported.xml</literal></para><screen><phrase role="commit-message">Added support for edition.</phrase></screen>
5136 </listitem>
5137 <listitem>
5138 <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>
5139 </listitem>
5140 <listitem>
5141 <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>
5142 </listitem>
5143 <listitem>
5144 <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>
5145 </listitem>
5146 <listitem>
5147 <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>
5148 </listitem>
5149 <listitem>
5150 <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>
5151 </listitem>
5152 <listitem>
5153 <para><literal>Steve Ball: blocks2dbk.xsl</literal></para><screen><phrase role="commit-message">added support for explicit emphasis character styles</phrase></screen>
5154 </listitem>
5155 <listitem>
5156 <para><literal>Steve Ball: wordml2normalise.xsl</literal></para><screen><phrase role="commit-message">added support for customisation in image handling</phrase></screen>
5157 </listitem>
5158 <listitem>
5159 <para><literal>Steve Ball: blocks2dbk.xsl</literal></para><screen><phrase role="commit-message">Added inlinemediaobject support for metadata.</phrase></screen>
5160 </listitem>
5161 <listitem>
5162 <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>
5163 </listitem>
5164 </itemizedlist>
5165 </sect2><!--end of Roundtrip changes for 1.74.0-->
5166
5167 <sect2 xml:id="V1.74.0_Slides">
5168 <title>Slides</title>
5169 <para>The following changes have been made to the
5170             <filename>slides</filename> code
5171             since the 1.73.2 release.</para>
5172 <itemizedlist>
5173 <listitem>
5174 <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
5175 under Cygwin. This stuff is ugly and maybe not worth the mess and
5176 trouble, but does seem to work as expected and not break anything
5177 else.</phrase></screen>
5178 </listitem>
5179 <listitem>
5180 <para><literal>Jirka Kosek: html/plain.xsl</literal></para><screen><phrase role="commit-message">Added support for showing foil number</phrase></screen>
5181 </listitem>
5182 </itemizedlist>
5183 </sect2><!--end of Slides changes for 1.74.0-->
5184
5185 <sect2 xml:id="V1.74.0_Website">
5186 <title>Website</title>
5187 <para>The following changes have been made to the
5188             <filename>website</filename> code
5189             since the 1.73.2 release.</para>
5190 <itemizedlist>
5191 <listitem>
5192 <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>
5193 </listitem>
5194 </itemizedlist>
5195 </sect2><!--end of Website changes for 1.74.0-->
5196
5197 <sect2 xml:id="V1.74.0_Params">
5198 <title>Params</title>
5199 <para>The following changes have been made to the
5200             <filename>params</filename> code
5201             since the 1.73.2 release.</para>
5202 <itemizedlist>
5203 <listitem> <para><literal>Keith Fahlgren: epub.autolabel.xml</literal></para><screen><phrase role="commit-message">New parameter for epub, epub.autolabel</phrase></screen> </listitem>
5204 <listitem>
5205 <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>
5206 </listitem>
5207 <listitem>
5208 <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>
5209 </listitem>
5210 <listitem>
5211 <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>
5212 </listitem>
5213 <listitem>
5214 <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,
5215 changed the default font formatting for links to bold.</phrase></screen>
5216 </listitem>
5217 <listitem>
5218 <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
5219 base URL for relative links (for ulink, @xlink:href, imagedata,
5220 audiodata, videodata) shown in the generated NOTES section of
5221 man-page output. The value of man.base.url.for.relative.links is
5222 prepended to any relative URI that is a value of ulink url,
5223 xlink:href, or fileref attribute.
5224
5225 If you use relative URIs in link sources in your DocBook refentry
5226 source, and you leave man.base.url.for.relative.links unset, the
5227 relative links will appear "as is" in the NOTES section of any
5228 man-page output generated from your source. That's probably not
5229 what you want, because such relative links are only usable in the
5230 context of HTML output. So, to make the links meaningful and
5231 usable in the context of man-page output, set a value for
5232 man.base.url.for.relative.links that points
5233 to the online version of HTML output generated from your DocBook
5234 refentry source. For example:
5235
5236   &lt;xsl:param name="man.base.url.for.relative.links"
5237   &gt;http://www.kernel.org/pub/software/scm/git/docs/&lt;/xsl:param&gt;</phrase></screen>
5238 </listitem>
5239 <listitem>
5240 <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
5241 line of whitespace from being inserted after programlisting etc.
5242 in certain cases)</phrase></screen>
5243 </listitem>
5244 <listitem>
5245 <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
5246 "source" or "manual" metadata fields</phrase></screen>
5247 </listitem>
5248 <listitem>
5249 <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
5250 man.charmap.subset.profile.english param</phrase></screen>
5251 </listitem>
5252 <listitem>
5253 <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
5254 the handling of charmap subsets to differentiate between English
5255 and non-English source.
5256
5257 This way charmap subsets are now handled is this:
5258
5259 If the value of the man.charmap.use.subset parameter is non-zero,
5260 and your DocBook source is not written in English (that is, if its
5261 lang or xml:lang attribute has a value other than en), then the
5262 character-map subset specified by the man.charmap.subset.profile
5263 parameter is used instead of the full roff character map.
5264
5265 Otherwise, if the lang or xml:lang attribute on the root element
5266 in your DocBook source or on the first refentry element in your
5267 source has the value en or if it has no lang or xml:lang
5268 attribute, then the character-map subset specified by the
5269 man.charmap.subset.profile.english parameter is used instead of
5270 man.charmap.subset.profile.
5271
5272 The difference between the two subsets is that
5273 man.charmap.subset.profile provides mappings for characters in
5274 Western European languages that are not part of the Roman
5275 (English) alphabet (ASCII character set).</phrase></screen>
5276 </listitem>
5277 <listitem>
5278 <para><literal>Michael(tm) Smith: man.charmap.subset.profile.xml</literal></para><screen><phrase role="commit-message">Added to default charmap used by manpages:
5279
5280   - the "letters" part of the 'C1 Controls And Latin-1 Supplement
5281     (Latin-1 Supplement)' Unicode block
5282   - Latin Extended-A block (but not all of the characters from
5283     that block have mappings in groff, so some of them are still
5284     passed through as-is)
5285
5286 The effects of this change are that in man pages generated for
5287 most Western European languages and for Finnish, all characters
5288 not part of the Roman alphabet are (e.g., "accented" characters)
5289 are converted to groff escapes.
5290
5291 Previously, by default we passed through those characters as is
5292 (and users needed to use the full charmap if they wanted to have
5293 those characters converted).
5294
5295 As a result of this change, man pages generated for Western
5296 European languages will be viewable in some environments in which
5297 they are not viewable if the "raw" non-Roman characters are in them.</phrase></screen>
5298 </listitem>
5299 <listitem>
5300 <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>
5301 </listitem>
5302 <listitem>
5303 <para><literal>Mauritz Jeanson: default.table.width.xml</literal></para><screen><phrase role="commit-message">Clarified PI usage.</phrase></screen>
5304 </listitem>
5305 <listitem>
5306 <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
5307 manpages output as the funcsynopsis.style parameter has in HTML
5308 output -- except that its default value is 'ansi' instead of 'kr'.</phrase></screen>
5309 </listitem>
5310 <listitem>
5311 <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
5312 being used in the code and hasn't been since mid 2006.</phrase></screen>
5313 </listitem>
5314 <listitem>
5315 <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
5316 default value for tables.</phrase></screen>
5317 </listitem>
5318 <listitem>
5319 <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>
5320 </listitem>
5321 <listitem>
5322 <para><literal>Mauritz Jeanson: manifest.in.base.dir.xml</literal></para><screen><phrase role="commit-message">Wording fixes.</phrase></screen>
5323 </listitem>
5324 <listitem>
5325 <para><literal>Mauritz Jeanson: header.content.properties.xml; footer.content.properties.xml</literal></para><screen><phrase role="commit-message">Added refpurpose.</phrase></screen>
5326 </listitem>
5327 <listitem>
5328 <para><literal>Mauritz Jeanson: ulink.footnotes.xml; ulink.show.xml</literal></para><screen><phrase role="commit-message">Updated for DocBook 5.</phrase></screen>
5329 </listitem>
5330 <listitem>
5331 <para><literal>Mauritz Jeanson: index.method.xml; glossterm.auto.link.xml</literal></para><screen><phrase role="commit-message">Spelling and wording fixes.</phrase></screen>
5332 </listitem>
5333 <listitem>
5334 <para><literal>Mauritz Jeanson: callout.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Clarifed available graphics formats and extensions.</phrase></screen>
5335 </listitem>
5336 <listitem>
5337 <para><literal>Mauritz Jeanson: footnote.sep.leader.properties.xml</literal></para><screen><phrase role="commit-message">Corrected refpurpose.</phrase></screen>
5338 </listitem>
5339 <listitem>
5340 <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>
5341 </listitem>
5342 <listitem>
5343 <para><literal>Mauritz Jeanson: img.src.path.xml</literal></para><screen><phrase role="commit-message">img.src.path works with inlinegraphic too.</phrase></screen>
5344 </listitem>
5345 <listitem>
5346 <para><literal>Mauritz Jeanson: saxon.character.representation.xml</literal></para><screen><phrase role="commit-message">Added TCG link.</phrase></screen>
5347 </listitem>
5348 <listitem>
5349 <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
5350 there was a risk of misunderstanding how it works.</phrase></screen>
5351 </listitem>
5352 </itemizedlist>
5353 </sect2><!--end of Params changes for 1.74.0-->
5354
5355 <sect2 xml:id="V1.74.0_Profiling">
5356 <title>Profiling</title>
5357 <para>The following changes have been made to the
5358             <filename>profiling</filename> code
5359             since the 1.73.2 release.</para>
5360 <itemizedlist>
5361 <listitem>
5362 <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>
5363 </listitem>
5364 <listitem>
5365 <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
5366 they can be more easily customized.</phrase></screen>
5367 </listitem>
5368 </itemizedlist>
5369 </sect2><!--end of Profiling changes for 1.74.0-->
5370
5371
5372 <sect2 xml:id="V1.74.0_Tools">
5373 <title>Tools</title>
5374 <para>The following changes have been made to the
5375             <filename>tools</filename> code
5376             since the 1.73.2 release.</para>
5377 <itemizedlist>
5378 <listitem>
5379 <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
5380 an input format</phrase></screen>
5381 </listitem>
5382 <listitem>
5383 <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>
5384 </listitem>
5385 <listitem>
5386 <para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">Reworked handling of K&amp;R funcprototype output. It no longer relies
5387 on the HTML kr-tabular templates, but instead just does direct
5388 transformation to roff. For K&amp;R output, it displays the paramdef
5389 output in an indented list following the prototype.</phrase></screen>
5390 </listitem>
5391 <listitem>
5392 <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
5393 reference documentation.</phrase></screen>
5394 </listitem>
5395 <listitem>
5396 <para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">use .BI handling in K&amp;R funsynopsis output for manpages, just as
5397 we do already of ANSI output</phrase></screen>
5398 </listitem>
5399 <listitem>
5400 <para><literal>Michael(tm) Smith: xsl/build/html2roff.xsl</literal></para><screen><phrase role="commit-message">Implemented initial support for handling tabular K&amp;R output of
5401 funcprototype in manpages output. Accomplished by adding more
5402 templates to the intermediate HTML-to-roff stylesheet that the
5403 build uses to create the manpages/html-synop.xsl stylesheet.</phrase></screen>
5404 </listitem>
5405 <listitem>
5406 <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
5407 import profile-docbook.xsl, so that we can do profiling of release
5408 notes. Corrected some problems in the target for the release-notes
5409 HTML build.</phrase></screen>
5410 </listitem>
5411 </itemizedlist>
5412 </sect2><!--end of Tools changes for 1.74.0-->
5413
5414 <sect2 xml:id="V1.74.0_Extensions">
5415 <title>Extensions</title>
5416 <para>The following changes have been made to the
5417             <filename>extensions</filename> code
5418             since the 1.73.2 release.</para>
5419 <itemizedlist>
5420 <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>
5421 <listitem>
5422 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">moved extensions build targets from master xsl/Makefile to
5423 xsl/extensions/Makefile</phrase></screen>
5424 </listitem>
5425 <listitem>
5426 <para><literal>Michael(tm) Smith: .cvsignore</literal></para><screen><phrase role="commit-message">re-adding empty extensions subdir</phrase></screen>
5427 </listitem>
5428 </itemizedlist>
5429 </sect2><!--end of Extensions changes for 1.74.0-->
5430
5431 <sect2 xml:id="V1.74.0_XSL-Saxon">
5432 <title>XSL-Saxon</title>
5433 <para>The following changes have been made to the
5434             <filename>xsl-saxon</filename> code
5435             since the 1.73.2 release.</para>
5436 <itemizedlist>
5437 <listitem>
5438 <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
5439 recent change to snapshot build infrastructure</phrase></screen>
5440 </listitem>
5441 <listitem>
5442 <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
5443 references. Closes #1792043. Thanks to Daniel Leidert.</phrase></screen>
5444 </listitem>
5445 <listitem>
5446 <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>
5447 </listitem>
5448 <listitem>
5449 <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>
5450 </listitem>
5451 </itemizedlist>
5452 </sect2><!--end of XSL-Saxon changes for 1.74.0-->
5453
5454 <sect2 xml:id="V1.74.0_XSL-Xalan">
5455 <title>XSL-Xalan</title>
5456 <para>The following changes have been made to the
5457             <filename>xsl-xalan</filename> code
5458             since the 1.73.2 release.</para>
5459 <itemizedlist>
5460 <listitem>
5461 <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
5462 recent change to snapshot build infrastructure</phrase></screen>
5463 </listitem>
5464 <listitem>
5465 <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
5466 references. Closes #1792043. Thanks to Daniel Leidert.</phrase></screen>
5467 </listitem>
5468 <listitem>
5469 <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>
5470 </listitem>
5471 <listitem>
5472 <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>
5473 </listitem>
5474 </itemizedlist>
5475 </sect2><!--end of XSL-Xalan changes for 1.74.0-->
5476
5477 <sect2 xml:id="V1.74.0_XSL-libxslt">
5478 <title>XSL-libxslt</title>
5479 <para>The following changes have been made to the
5480             <filename>xsl-libxslt</filename> code
5481             since the 1.73.2 release.</para>
5482 <itemizedlist>
5483 <listitem>
5484 <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.
5485 Some unnecessary semicolons removed.</phrase></screen>
5486 </listitem>
5487 <listitem>
5488 <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).
5489 Replaced deprecated functions from the string module with string methods.</phrase></screen>
5490 </listitem>
5491 <listitem>
5492 <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>
5493 </listitem>
5494 <listitem>
5495 <para><literal>Mauritz Jeanson: python/README</literal></para><screen><phrase role="commit-message">Tweaked the text a little.</phrase></screen>
5496 </listitem>
5497 </itemizedlist>
5498 </sect2><!--end of XSL-libxslt changes for 1.74.0-->
5499
5500 </sect1>
5501
5502 <sect1 xml:id="V1.73.2">
5503 <title>Release Notes: 1.73.2</title>
5504 <para>This is solely a minor bug-fix update to the 1.73.1 release.
5505   It fixes a packaging error in the 1.73.1 package, as well as a
5506   bug in footnote handling in FO output.</para>
5507 </sect1>
5508
5509 <sect1 xml:id="V1.73.1">
5510 <title>Release: 1.73.1</title>
5511 <para>This is mostly a bug-fix update to the 1.73.0 release.</para>
5512
5513 <sect2 xml:id="V1.73.1_Gentext">
5514 <title>Gentext</title>
5515 <para>The following changes have been made to the
5516             <filename>gentext</filename> code
5517             since the 1.73.0 release.</para>
5518 <itemizedlist>
5519 <listitem>
5520 <para><literal>Mauritz Jeanson: locale/de.xml</literal></para><screen><phrase role="commit-message">Applied patch #1766009.</phrase></screen>
5521 </listitem>
5522 <listitem>
5523 <para><literal>Michael(tm) Smith: locale/lv.xml</literal></para><screen><phrase role="commit-message">Added localization for <tag>ProductionSet</tag>.</phrase></screen>
5524 </listitem>
5525 </itemizedlist>
5526 </sect2><!--end of Gentext changes for 1.73.1-->
5527
5528 <sect2 xml:id="V1.73.1_FO">
5529 <title>FO</title>
5530 <para>The following changes have been made to the
5531             <filename>fo</filename> code
5532             since the 1.73.0 release.</para>
5533 <itemizedlist>
5534 <listitem>
5535 <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,
5536 a width attribute is output on all corresponding fo:tables. Previously,
5537 there was a test prohibiting this (and a comment saying that outputting more
5538 than one width attribute will cause an error). But this seems to be no longer
5539 relevant; it is not a problem with FOP 0.93 or XEP 4.10. Closes bug #1760559.</phrase></screen>
5540 </listitem>
5541 <listitem>
5542 <para><literal>Mauritz Jeanson: graphics.xsl</literal></para><screen><phrase role="commit-message">Replaced useless &lt;a&gt; elements with warning messages (textinsert extension).</phrase></screen>
5543 </listitem>
5544 <listitem>
5545 <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
5546 references in the <tag>index</tag> can be created. Closes bug #1775086.</phrase></screen>
5547 </listitem>
5548 </itemizedlist>
5549 </sect2><!--end of FO changes for 1.73.1-->
5550
5551 <sect2 xml:id="V1.73.1_HTML">
5552 <title>HTML</title>
5553 <para>The following changes have been made to the
5554             <filename>html</filename> code
5555             since the 1.73.0 release.</para>
5556 <itemizedlist>
5557 <listitem>
5558 <para><literal>Mauritz Jeanson: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added &lt;xsl:call-template name="process.footnotes"/&gt; to <tag>abstract</tag> template
5559 so that footnotes in <tag>info</tag>/<tag>abstract</tag> are processed. Closes bug #1760907.</phrase></screen>
5560 </listitem>
5561 <listitem>
5562 <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
5563 <tag>funcsynopsis</tag> elements, such that a@id instances are generated for
5564 them if they are descendants of any element containing a dbcmdlist
5565 or dbfunclist PI. Also, update the embedded <tag>reference</tag> docs for the
5566 dbcmdlist and dbfunclist PIs to make it clear that they can be
5567 used within any element for which <tag>cmdsynopsis</tag> or <tag>funcsynopsis</tag> are
5568 valid children.</phrase></screen>
5569 </listitem>
5570 <listitem>
5571 <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
5572 generated for output of informal objects. Thanks to Sam Steingold
5573 for reporting.</phrase></screen>
5574 </listitem>
5575 <listitem>
5576 <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>
5577 </listitem>
5578 <listitem>
5579 <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
5580 in the same way as for <tag>revhistory</tag> chunks. Using &lt;xsl:apply-templates
5581 mode="chunk-filename" select="."/&gt; did not work for single-page output since
5582 the template with that mode is in chunk-code.xsl.</phrase></screen>
5583 </listitem>
5584 <listitem>
5585 <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).
5586 Added support for MathML in <tag>imagedata</tag>.</phrase></screen>
5587 </listitem>
5588 <listitem>
5589 <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).
5590 (The two templates matching 'dbhh' are still in htmlhelp-common.xsl).</phrase></screen>
5591 </listitem>
5592 </itemizedlist>
5593 </sect2><!--end of HTML changes for 1.73.1-->
5594
5595 <sect2 xml:id="V1.73.1_Manpages">
5596 <title>Manpages</title>
5597 <para>The following changes have been made to the
5598             <filename>manpages</filename> code
5599             since the 1.73.0 release.</para>
5600 <itemizedlist>
5601 <listitem>
5602 <para><literal>Michael(tm) Smith: endnotes.xsl</literal></para><screen><phrase role="commit-message">In manpages output, generate warnings about notesources with
5603 non-para children only if the notesource is a <tag>footnote</tag> or
5604 <tag>annotation</tag>. Thanks to Sam Steingold for reporting problems with
5605 the existing handling.</phrase></screen>
5606 </listitem>
5607 </itemizedlist>
5608 </sect2><!--end of Manpages changes for 1.73.1-->
5609
5610 <sect2 xml:id="V1.73.1_HTMLHelp">
5611 <title>HTMLHelp</title>
5612 <para>The following changes have been made to the
5613             <filename>htmlhelp</filename> code
5614             since the 1.73.0 release.</para>
5615 <itemizedlist>
5616 <listitem>
5617 <para><literal>Michael(tm) Smith: htmlhelp-common.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
5618 eclipse, and javahelp stylesheets.</phrase></screen>
5619 </listitem>
5620 </itemizedlist>
5621 </sect2><!--end of HTMLHelp changes for 1.73.1-->
5622
5623 <sect2 xml:id="V1.73.1_Eclipse">
5624 <title>Eclipse</title>
5625 <para>The following changes have been made to the
5626             <filename>eclipse</filename> code
5627             since the 1.73.0 release.</para>
5628 <itemizedlist>
5629 <listitem>
5630 <para><literal>Michael(tm) Smith: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
5631 eclipse, and javahelp stylesheets.</phrase></screen>
5632 </listitem>
5633 </itemizedlist>
5634 </sect2><!--end of Eclipse changes for 1.73.1-->
5635
5636 <sect2 xml:id="V1.73.1_JavaHelp">
5637 <title>JavaHelp</title>
5638 <para>The following changes have been made to the
5639             <filename>javahelp</filename> code
5640             since the 1.73.0 release.</para>
5641 <itemizedlist>
5642 <listitem>
5643 <para><literal>Michael(tm) Smith: javahelp.xsl</literal></para><screen><phrase role="commit-message">Added single-pass namespace-stripping support to the htmlhelp,
5644 eclipse, and javahelp stylesheets.</phrase></screen>
5645 </listitem>
5646 </itemizedlist>
5647 </sect2><!--end of JavaHelp changes for 1.73.1-->
5648
5649 <sect2 xml:id="V1.73.1_Roundtrip">
5650 <title>Roundtrip</title>
5651 <para>The following changes have been made to the
5652             <filename>roundtrip</filename> code
5653             since the 1.73.0 release.</para>
5654 <itemizedlist>
5655 <listitem>
5656 <para><literal>Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; pages2normalise.xsl</literal></para><screen><phrase role="commit-message">Modularised blocks2dbk to allow customisation,
5657 Added support for tables to pages2normalise</phrase></screen>
5658 </listitem>
5659 </itemizedlist>
5660 </sect2><!--end of Roundtrip changes for 1.73.1-->
5661
5662 <sect2 xml:id="V1.73.1_Params">
5663 <title>Params</title>
5664 <para>The following changes have been made to the
5665             <filename>params</filename> code
5666             since the 1.73.0 release.</para>
5667 <itemizedlist>
5668 <listitem>
5669 <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
5670 a <tag>procedure</tag> does not need to be kept together by default.</phrase></screen>
5671 </listitem>
5672 <listitem>
5673 <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>
5674 </listitem>
5675 </itemizedlist>
5676 </sect2><!--end of Params changes for 1.73.1-->
5677 </sect1>
5678
5679 <sect1 xml:id="V1.73.0">
5680 <title>Release: 1.73.0</title>
5681 <para>This release includes important bug fixes and adds the following
5682 significant feature changes:
5683 <variablelist>
5684   <varlistentry>
5685     <term>New localizations and localization updates</term>
5686     <listitem>
5687       <para>We added two new localizations: Latvian and
5688         Esperanto, and made updates to the Czech, Chinese
5689         Simplified, Mongolian, Serbian, Italian, and Ukrainian
5690         localizations.</para>
5691     </listitem>
5692   </varlistentry>
5693   <varlistentry>
5694     <term>ISO690 citation style for bibliography output.</term>
5695     <listitem>
5696       <para>Set the
5697         <parameter>bibliography.style</parameter> parameter to
5698         <literal>iso690</literal> to use ISO690 style.</para>
5699     </listitem>
5700   </varlistentry>
5701   <varlistentry>
5702     <term>New documentation for processing instructions (PI)</term>
5703     <listitem>
5704       <para>The reference documentation that ships with the
5705         release now includes <link
5706           xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/pi/"
5707           >documentation on all PIs</link> that you can use to
5708         control output from the stylesheets.</para>
5709     </listitem>
5710   </varlistentry>
5711   <varlistentry>
5712     <term>New profiling parameters for <literal>audience</literal> and <literal>wordsize</literal></term>
5713     <listitem>
5714       <para>You can now do profiling based on the values of the
5715         <literal>audience</literal> and
5716         <literal>wordsize</literal> attributes.</para>
5717     </listitem>
5718   </varlistentry>
5719   <varlistentry>
5720     <term>Changes to man-page output</term>
5721     <listitem>
5722       <para>The manpages stylesheet now supports single-pass
5723         profiling and single-pass DocBook 5 namespace stripping
5724         (just as the HTML and FO stylesheets also do). Also, added
5725         handling for <tag>mediaobject</tag> &amp;
5726         <tag>inlinemediaobject</tag>. (Each <tag>imagedata</tag>,
5727         <tag>audiodata</tag>, or <tag>videodata</tag> element
5728         within a <tag>mediaobject</tag> or inline
5729         <tag>mediaobject</tag> is now treated as a "notesource"
5730         and so handled in much the same way as links and
5731         <tag>annotation</tag>/<tag>alt</tag>/<tag>footnote</tag>
5732         are in manpages output.) And added the
5733         <parameter>man.authors.section.enabled</parameter> and
5734         <parameter>man.copyright.section.enabled</parameter>
5735         parameters to enable control over whether output includes
5736         auto-generated <literal>AUTHORS</literal> and
5737         <literal>COPYRIGHT</literal> sections.</para>
5738     </listitem>
5739   </varlistentry>
5740   <varlistentry>
5741     <term>Highlighting support for C</term>
5742     <listitem>
5743       <para>The highlighting mechanism for generating
5744         syntax-highlighted code snippets in output now supports C
5745         code listings (along with Java, PHP, XSLT, and others).</para>
5746     </listitem>
5747   </varlistentry>
5748   <varlistentry>
5749     <term>Experimental <literal>docbook-xsl-update script</literal></term>
5750     <listitem>
5751       <para>We added an experimental <literal>docbook-xsl-update
5752           script</literal>, the purpose of which is to facilitate
5753         easy sync-up to the latest docbook-xsl snapshot (by means
5754         of rsync).</para>
5755     </listitem>
5756   </varlistentry>
5757 </variablelist>
5758 </para>
5759
5760 <sect2 xml:id="V1.73.0_Gentext">
5761 <title>Gentext</title>
5762 <para>The following changes have been made to the
5763 <filename>gentext</filename> code
5764 since the 1.72.0 release.</para>
5765 <itemizedlist>
5766 <listitem>
5767 <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>
5768 </listitem>
5769 <listitem>
5770 <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>
5771 </listitem>
5772 <listitem>
5773 <para><literal>Jirka Kosek: locale/cs.xml</literal></para><screen><phrase role="commit-message">Added missing translations</phrase></screen>
5774 </listitem>
5775 <listitem>
5776 <para><literal>Robert Stayton: locale/eo.xml</literal></para><screen><phrase role="commit-message">New locale for Esperanto.</phrase></screen>
5777 </listitem>
5778 <listitem>
5779 <para><literal>Robert Stayton: locale/mn.xml</literal></para><screen><phrase role="commit-message">Update from Ganbold Tsagaankhuu.</phrase></screen>
5780 </listitem>
5781 <listitem>
5782 <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>
5783 </listitem>
5784 <listitem>
5785 <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>
5786 </listitem>
5787 <listitem>
5788 <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>
5789 </listitem>
5790 <listitem>
5791 <para><literal>Robert Stayton: locale/it.xml</literal></para><screen><phrase role="commit-message">Improved version from contributor.</phrase></screen>
5792 </listitem>
5793 <listitem>
5794 <para><literal>Mauritz Jeanson: locale/uk.xml</literal></para><screen><phrase role="commit-message">Applied patch 1592083.</phrase></screen>
5795 </listitem>
5796 </itemizedlist>
5797 </sect2><!--end of Gentext changes for 1.73.0-->
5798 <sect2 xml:id="V1.73.0_Common">
5799 <title>Common</title>
5800 <para>The following changes have been made to the
5801 <filename>common</filename> code
5802 since the 1.72.0 release.</para>
5803 <itemizedlist>
5804 <listitem>
5805 <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>
5806 (when it appears at the component level) is now affected by the
5807 <parameter>label.from.part</parameter> param, just as <tag>preface</tag>, <tag>chapter</tag>, and <tag>appendix</tag>.</phrase></screen>
5808 </listitem>
5809 <listitem>
5810 <para><literal>Michael(tm) Smith: common.xsl</literal></para><screen><phrase role="commit-message">Added support to the HTML stylesheets for proper processing of
5811 <tag>orgname</tag> as a child of <tag>author</tag>.</phrase></screen>
5812 </listitem>
5813 <listitem>
5814 <para><literal>Michael(tm) Smith: refentry.xsl</literal></para><screen><phrase role="commit-message">Refined logging output of <tag>refentry</tag> metadata-gathering template;
5815 for some cases of "missing" elements (<tag>refmiscinfo</tag> stuff, etc.),
5816 the log messages now include URL to corresponding page in the
5817 Definitive Guide (TDG).</phrase></screen>
5818 </listitem>
5819 <listitem>
5820 <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>
5821 </listitem>
5822 <listitem>
5823 <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
5824 contain <tag>info</tag>/<tag>title</tag> descendants but no <tag>title</tag> children.
5825
5826 This should be further refined so that it handles any *<tag>info</tag>
5827 elements. And there are probably some other places where similar
5828 handling for *<tag>info</tag>/<tag>title</tag> should be added.</phrase></screen>
5829 </listitem>
5830 <listitem>
5831 <para><literal>Mauritz Jeanson: pi.xsl</literal></para><screen><phrase role="commit-message">Modified &lt;xsl:when&gt; in datetime.format template to work
5832 around Xalan bug.</phrase></screen>
5833 </listitem>
5834 </itemizedlist>
5835 </sect2><!--end of Common changes for 1.73.0-->
5836 <sect2 xml:id="V1.73.0_FO">
5837 <title>FO</title>
5838 <para>The following changes have been made to the
5839 <filename>fo</filename> code
5840 since the 1.72.0 release.</para>
5841 <itemizedlist>
5842 <listitem>
5843 <para><literal>Robert Stayton: component.xsl</literal></para><screen><phrase role="commit-message">Add parameters to the page.sequence utility template.</phrase></screen>
5844 </listitem>
5845 <listitem>
5846 <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>.
5847 Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
5848 </listitem>
5849 <listitem>
5850 <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>
5851 </listitem>
5852 <listitem>
5853 <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>
5854 </listitem>
5855 <listitem>
5856 <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>
5857 </listitem>
5858 <listitem>
5859 <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Make citations numbered if <parameter>bibliography.numbered</parameter> != 0.</phrase></screen>
5860 </listitem>
5861 <listitem>
5862 <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>
5863 </listitem>
5864 <listitem>
5865 <para><literal>Robert Stayton: param.xweb; param.ent</literal></para><screen><phrase role="commit-message">Added <parameter>callout.icon.size</parameter> parameter.</phrase></screen>
5866 </listitem>
5867 <listitem>
5868 <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>
5869 </listitem>
5870 <listitem>
5871 <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>
5872 </listitem>
5873 <listitem>
5874 <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>
5875 </listitem>
5876 <listitem>
5877 <para><literal>Robert Stayton: division.xsl</literal></para><screen><phrase role="commit-message">Refactored the big <tag>book</tag> template into smaller pieces.
5878 Used the "page.sequence" utility template in
5879 component.xsl to shorten the <tag>toc</tag> piece.
5880 Added placeholder templates for front.cover and back.cover.</phrase></screen>
5881 </listitem>
5882 <listitem>
5883 <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
5884 pgwide spans inside sections.</phrase></screen>
5885 </listitem>
5886 <listitem>
5887 <para><literal>Robert Stayton: param.xweb; param.ent; component.xsl</literal></para><screen><phrase role="commit-message">Add component.titlepage.properties attribute-set to
5888 support span="all" and other properties.</phrase></screen>
5889 </listitem>
5890 <listitem>
5891 <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.
5892 Add keep-with-next to table.row.properties when <tag>row</tag> is in <tag>thead</tag>.</phrase></screen>
5893 </listitem>
5894 <listitem>
5895 <para><literal>Robert Stayton: table.xsl</literal></para><screen><phrase role="commit-message">Add support for <parameter>default.table.frame</parameter> parameter.
5896 Fix bug 1575446 rowsep last check for @morerows.</phrase></screen>
5897 </listitem>
5898 <listitem>
5899 <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>
5900 </listitem>
5901 <listitem>
5902 <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>
5903 </listitem>
5904 <listitem>
5905 <para><literal>Jirka Kosek: lists.xsl</literal></para><screen><phrase role="commit-message">Added missing attribute set for <tag>procedure</tag></phrase></screen>
5906 </listitem>
5907 <listitem>
5908 <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.
5909 New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
5910 The code was provided by Jana Dvorakova</phrase></screen>
5911 </listitem>
5912 <listitem>
5913 <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>
5914 </listitem>
5915 <listitem>
5916 <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>
5917 </listitem>
5918 </itemizedlist>
5919 </sect2><!--end of FO changes for 1.73.0-->
5920 <sect2 xml:id="V1.73.0_HTML">
5921 <title>HTML</title>
5922 <para>The following changes have been made to the
5923             <filename>html</filename> code
5924             since the 1.72.0 release.</para>
5925 <itemizedlist>
5926 <listitem>
5927 <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
5928 regular "parameter machinery".</phrase></screen>
5929 </listitem>
5930 <listitem>
5931 <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>,
5932 <tag>tip</tag> admonitions: We now output and HTML h3 head only if
5933 <parameter>admon.textlabel</parameter> is non-zero or if the admonition actually contains
5934 a <tag>title</tag>; otherwise, we don't output an h3 head at all.
5935 (Previously, we were outputting an empty h3 if the <parameter>admon.textlabel</parameter>
5936 was zero and if the admonition had no title.)</phrase></screen>
5937 </listitem>
5938 <listitem>
5939 <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>.
5940 Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
5941 </listitem>
5942 <listitem>
5943 <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.
5944 This (hopefully) closes bug #1671052.</phrase></screen>
5945 </listitem>
5946 <listitem>
5947 <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
5948 dbfunclist and dbcmdlist PIs.</phrase></screen>
5949 </listitem>
5950 <listitem>
5951 <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
5952 to work. Restored dbhtml-dir template back to pi.xsl.</phrase></screen>
5953 </listitem>
5954 <listitem>
5955 <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>.
5956 If non-zero, in output of the <tag>abstract</tag> element on titlepages,
5957 display of the <tag>abstract</tag> <tag>title</tag> is suppressed.
5958 Because sometimes you really don't want or need that <tag>title</tag>
5959 there...</phrase></screen>
5960 </listitem>
5961 <listitem>
5962 <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
5963 into separate HTML output files, and <parameter>use.id.as.filename</parameter> is
5964 non-zero, if a <tag>mediaobject</tag> has an ID, use that ID as the basename
5965 for the long-description file (otherwise, we generate an ID for it
5966 and use that ID as the basename for the file).
5967 The parallels the recent change made to cause IDs for <tag>legalnotice</tag>
5968 instances to be used as basenames for <tag>legalnotice</tag> chunks.
5969 Also, made some minor refinements to the recent changes for
5970 <tag>legalnotice</tag> chunk handling.</phrase></screen>
5971 </listitem>
5972 <listitem>
5973 <para><literal>Michael(tm) Smith: titlepage.xsl</literal></para><screen><phrase role="commit-message">Added support to the HTML stylesheets for proper processing of
5974 <tag>orgname</tag> as a child of <tag>author</tag>.</phrase></screen>
5975 </listitem>
5976 <listitem>
5977 <para><literal>Michael(tm) Smith: chunk-code.xsl</literal></para><screen><phrase role="commit-message">When $generate.legalnotice.link is non-zero and
5978 $use.id.as.filename is also non-zero, if a <tag>legalnotice</tag> has an ID,
5979 then instead of assigning the "ln-&lt;generatedID&gt;" basename to the
5980 output file for that <tag>legalnotice</tag>, just use its real ID as the
5981 basename for the file -- as we do when chunking other elements
5982 that have IDs.</phrase></screen>
5983 </listitem>
5984 <listitem>
5985 <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>
5986 </listitem>
5987 <listitem>
5988 <para><literal>David Cramer: lists.xsl</literal></para><screen><phrase role="commit-message">Added &lt;p&gt; element around <tag>term</tag> in <tag>variablelist</tag> when formatted as <tag>table</tag> to avoid misalignment of <tag>term</tag> and <tag>listitem</tag> in xhtml (non-quirks mode) output</phrase></screen>
5989 </listitem>
5990 <listitem>
5991 <para><literal>David Cramer: qandaset.xsl</literal></para><screen><phrase role="commit-message">Added &lt;p&gt; element around <tag>question</tag> and <tag>answer</tag> labels to avoid misalignment of <tag>label</tag> and <tag>listitem</tag> in xhtml (non-quirks mode) output</phrase></screen>
5992 </listitem>
5993 <listitem>
5994 <para><literal>David Cramer: lists.xsl</literal></para><screen><phrase role="commit-message">Added &lt;p&gt; element around callouts to avoid misalignment of <tag>callout</tag> and <tag>listitem</tag> in xhtml (non-quirks mode) output</phrase></screen>
5995 </listitem>
5996 <listitem>
5997 <para><literal>Mauritz Jeanson: inline.xsl</literal></para><screen><phrase role="commit-message">Make citations numbered if <parameter>bibliography.numbered</parameter> != 0.</phrase></screen>
5998 </listitem>
5999 <listitem>
6000 <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>
6001 </listitem>
6002 <listitem>
6003 <para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add support for xlink olinks.</phrase></screen>
6004 </listitem>
6005 <listitem>
6006 <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>
6007 </listitem>
6008 <listitem>
6009 <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
6010 chunk-common.xsl and all match templates to chunk-code.xsl, in
6011 order to enable better chunk customization.
6012 See the comments in chunk.xsl for more details.</phrase></screen>
6013 </listitem>
6014 <listitem>
6015 <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>
6016 </listitem>
6017 <listitem>
6018 <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>
6019 </listitem>
6020 <listitem>
6021 <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.
6022 New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
6023 The code was provided by Jana Dvorakova</phrase></screen>
6024 </listitem>
6025 <listitem>
6026 <para><literal>Robert Stayton: inline.xsl; xref.xsl</literal></para><screen><phrase role="commit-message">Add call to class.attribute to &lt;a&gt; output elements so they can
6027 have a class value too.</phrase></screen>
6028 </listitem>
6029 <listitem>
6030 <para><literal>Mauritz Jeanson: glossary.xsl</literal></para><screen><phrase role="commit-message">Fixed bug #1644881:
6031 * Added curly braces around all $language attribute values.
6032 * Moved declaration of language variable to top level of stylesheet.
6033 Tested with Xalan, Saxon, and xsltproc.</phrase></screen>
6034 </listitem>
6035 </itemizedlist>
6036 </sect2><!--end of HTML changes for 1.73.0-->
6037 <sect2 xml:id="V1.73.0_Manpages">
6038 <title>Manpages</title>
6039 <para>The following changes have been made to the
6040             <filename>manpages</filename> code
6041             since the 1.72.0 release.</para>
6042 <itemizedlist>
6043 <listitem>
6044 <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
6045 <parameter>man.copyright.section.enabled</parameter> parameters. Set those to zero when
6046 you want to suppress display of the auto-generated AUTHORS and
6047 <tag>COPYRIGHT</tag> sections. Closes request #1467806. Thanks to Daniel
6048 Leidert.</phrase></screen>
6049 </listitem>
6050 <listitem>
6051 <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
6052 are any <tag>Refentry</tag> chilren in current doc, and made it
6053 namespace-agnostic. Reason for that is because the test otherwise
6054 won't work when it is copied over into the generated
6055 profile-docbook.xsl stylesheet.</phrase></screen>
6056 </listitem>
6057 <listitem>
6058 <para><literal>Michael(tm) Smith: Makefile</literal></para><screen><phrase role="commit-message">Added a manpages/profile-docbook.xsl file to enable single-pass
6059 profiling for manpages output.</phrase></screen>
6060 </listitem>
6061 <listitem>
6062 <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
6063 place they are in in document order. Closes #1690539. Thanks to
6064 Daniel Leidert for reporting.</phrase></screen>
6065 </listitem>
6066 <listitem>
6067 <para><literal>Michael(tm) Smith: docbook.xsl</literal></para><screen><phrase role="commit-message">Restored support for single-pass namespace stripping to manpages
6068 stylesheet.</phrase></screen>
6069 </listitem>
6070 <listitem>
6071 <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
6072 output. Should be transparent to users, but...
6073
6074 This touches handling of all bold and italic/underline output. The
6075 exact change is that the mode="bold" and mode="italic" utility
6076 templates were changed to named templates. (I think maybe I've
6077 changed it back and forth from mode to named before, so this is
6078 maybe re-reverting it yet again).
6079
6080 Anyway, the reason for the change is that the templates are
6081 sometimes call on dynamically node-sets, and using modes to format
6082 those doesn't allow passing <tag>info</tag> about the current/real context
6083 node from the source (not the node-set created by the stylesheet)
6084 to that formatting stage.
6085
6086 The named templates allow the context to be passed in as a
6087 parameter, so that the bold/ital formatting template can use
6088 context-aware condition checking.
6089
6090 This was basically necessary in order to suppress bold formatting
6091 in titles, which otherwise gets screwed up because of the numbnut
6092 way that roff handles nested bold/ital.
6093
6094 Closes #1674534). Much thanks to Daniel Leidert, whose in his
6095 docbook-xsl bug-finding kung-fu has achieved Grand Master status.</phrase></screen>
6096 </listitem>
6097 <listitem>
6098 <para><literal>Michael(tm) Smith: block.xsl</literal></para><screen><phrase role="commit-message">Fixed handling of example instances by adding the example element
6099 to the same template we use for processing <tag>figure</tag>. Closes
6100 #1674538. Thanks to Daniel Leidert.</phrase></screen>
6101 </listitem>
6102 <listitem>
6103 <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
6104 is, only generate lang-qualified file-/pathnames for non-English).</phrase></screen>
6105 </listitem>
6106 <listitem>
6107 <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.)
6108 that have something other than <tag>para</tag> as a child.
6109
6110 The numbered-with-hanging-indent formatting that's used for
6111 rendering endnotes in the NOTES <tag>section</tag> of man pages places some
6112 limits/assumptions on how the DocBook source is marked up; namely,
6113 for notesources (<tag>footnote</tag>, <tag>annotation</tag>, etc.) that can contain
6114 block-level children, if the they have a block-level child such as
6115 a <tag>table</tag> or <tag>itemizedlist</tag> or <tag>orderedlist</tag> that is the first child of
6116 a <tag>footnote</tag>, we have no way of rendering/indenting its content
6117 properly in the endnotes list.
6118
6119 Thus, the manpages stylesheet not emits a warning message for that
6120 case, and suggests the "fix" (which is to wrap the <tag>table</tag> or
6121 <tag>itemizedlist</tag> or whatever in a <tag>para</tag> that has some preferatory text.</phrase></screen>
6122 </listitem>
6123 <listitem>
6124 <para><literal>Michael(tm) Smith: utility.xsl</literal></para><screen><phrase role="commit-message">Added support to mixed-block template for handling tables in
6125 mixed-blocks (e.g., as child of <tag>para</tag>) correctly.</phrase></screen>
6126 </listitem>
6127 <listitem>
6128 <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
6129 out of the well-intentioned (but it now appears,
6130 misguided) "marker" mechanism (introduced in the 1.72.0
6131 release) -- which made use of alternative "marker"
6132 characters as internal representations of those
6133 characters, and then replaced them just prior to
6134 serialization -- and back into what's basically the
6135 system that was used prior to the 1.69.0 release; that
6136 is, into a part of stylesheet code that gets executed
6137 at the beginning of processing -- before any other roff
6138 markup up is. This change obviates the need for the
6139 marker system. It also requires a lot less RAM during
6140 processing (for large files, the marker mechanism
6141 ending up requiring gigabytes of memory).
6142
6143 Closes bug #1661177. Thanks to Scott Smedley for
6144 providing a test case (the fvwm man page) that exposed
6145 the problem with the marker mechanism.
6146
6147 Also moved the mechanism for converting non-breaking
6148 spaces back into the same <tag>area</tag> of the stylesheet code.</phrase></screen>
6149 </listitem>
6150 <listitem>
6151 <para><literal>Michael(tm) Smith: lists.xsl</literal></para><screen><phrase role="commit-message">Fixed problem with incorrect formatting of nested <tag>variablelist</tag>.
6152 Closes bug #1650931. Thanks to Daniel "Eagle Eye" Leidert.</phrase></screen>
6153 </listitem>
6154 <listitem>
6155 <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
6156 preceded by a blank line. This fixes a regression that occurred
6157 when instances of the TP macro that were use in a previous
6158 versions of the list-handling code were switched to RS/RE (because
6159 TP doesn't support nesting). TP automatically generates a blank
6160 line, but RS doesn't. So I added a .sp before each .RS</phrase></screen>
6161 </listitem>
6162 <listitem>
6163 <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
6164 out-of-line content:
6165
6166 - Added handling for <tag>mediaobject</tag> &amp; <tag>inlinemediaobject</tag>.
6167   Each <tag>imagedata</tag>, <tag>audiodata</tag>, or <tag>videodata</tag> element
6168   within a <tag>mediaobject</tag> or inline <tag>mediaobject</tag> is now
6169   treated as a "notesource" and so handled in much the
6170   same way as links and <tag>annotation</tag>/<tag>alt</tag>/footnotes.
6171
6172   That means a numbered marker is generated inline to
6173   mark the place in the main flow where the <tag>imagedata</tag>,
6174   <tag>audiodata</tag>, or <tag>videodata</tag> element occurs, and a
6175   corresponding numbered endnote for it is generated in
6176   the endnotes list at the end of the man page; the
6177   endnote contains the URL from the fileref attribute
6178   of the <tag>imagedata</tag>, <tag>audiodata</tag>, or <tag>videodata</tag> element.
6179
6180   For mediobject and <tag>inlinemediaobject</tag> instances that
6181   have a <tag>textobject</tag> child, the <tag>textobject</tag> is displayed
6182   within the main text flow.
6183
6184 - Renamed several man.link.* params to man.endnotes.*,
6185   to reflect that fact that the endnotes list now
6186   contains more than just links. Also did similar
6187   renaming for a number of stylesheet-internal vars.
6188
6189 - Added support for xlink:href (along with existing
6190   support for the legacy ulink element).
6191
6192 - Cleaned up and streamlined the endnotes-handling
6193   code. It's still messy and klunky and the basic
6194   mechanism it uses is very inefficent for documents
6195   that contain a lot of notesources, but at least it's
6196   a bit better than it was.</phrase></screen>
6197 </listitem>
6198 </itemizedlist>
6199 </sect2><!--end of Manpages changes for 1.73.0-->
6200 <sect2 xml:id="V1.73.0_Eclipse">
6201 <title>Eclipse</title>
6202 <para>The following changes have been made to the
6203             <filename>eclipse</filename> code
6204             since the 1.72.0 release.</para>
6205 <itemizedlist>
6206 <listitem>
6207 <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>
6208 </listitem>
6209 <listitem>
6210 <para><literal>David Cramer: eclipse.xsl</literal></para><screen><phrase role="commit-message">Added normalize-space around  to avoid leading whitespace from appearing in the output if there's extra leading whitespace (e.g. &lt;<tag>title</tag>&gt; Foo&lt;/<tag>title</tag>&gt;) in the source</phrase></screen>
6211 </listitem>
6212 </itemizedlist>
6213 </sect2><!--end of Eclipse changes for 1.73.0-->
6214 <sect2 xml:id="V1.73.0_JavaHelp">
6215 <title>JavaHelp</title>
6216 <para>The following changes have been made to the
6217             <filename>javahelp</filename> code
6218             since the 1.72.0 release.</para>
6219 <itemizedlist>
6220 <listitem>
6221 <para><literal>Mauritz Jeanson: javahelp.xsl</literal></para><screen><phrase role="commit-message">Implemented FR #1230233 (sorted <tag>index</tag> in javahelp).</phrase></screen>
6222 </listitem>
6223 <listitem>
6224 <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.
6225 Added support for <tag>glossary</tag> and <tag>bibliography</tag> in <tag>toc</tag> and map files.</phrase></screen>
6226 </listitem>
6227 </itemizedlist>
6228 </sect2><!--end of JavaHelp changes for 1.73.0-->
6229 <sect2 xml:id="V1.73.0_Roundtrip">
6230 <title>Roundtrip</title>
6231 <para>The following changes have been made to the
6232             <filename>roundtrip</filename> code
6233             since the 1.72.0 release.</para>
6234 <itemizedlist>
6235 <listitem>
6236 <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>
6237 </listitem>
6238 <listitem>
6239 <para><literal>Steve Ball: template-pages.xml; dbk2wp.xsl; sections-spec.xml</literal></para><screen><phrase role="commit-message">fixed bugs</phrase></screen>
6240 </listitem>
6241 </itemizedlist>
6242 </sect2><!--end of Roundtrip changes for 1.73.0-->
6243 <sect2 xml:id="V1.73.0_Params">
6244 <title>Params</title>
6245 <para>The following changes have been made to the
6246             <filename>params</filename> code
6247             since the 1.72.0 release.</para>
6248 <itemizedlist>
6249 <listitem>
6250 <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>
6251 </listitem>
6252 <listitem>
6253 <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>
6254 </listitem>
6255 <listitem>
6256 <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
6257 regular "parameter machinery".</phrase></screen>
6258 </listitem>
6259 <listitem>
6260 <para><literal>Mauritz Jeanson: generate.id.attributes.xml</literal></para><screen><phrase role="commit-message">Added <tag>refpurpose</tag> text.</phrase></screen>
6261 </listitem>
6262 <listitem>
6263 <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>
6264 </listitem>
6265 <listitem>
6266 <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,
6267 as pointed out by Dave Pawson.</phrase></screen>
6268 </listitem>
6269 <listitem>
6270 <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>
6271 (when it appears at the component level) is now affected by the
6272 <parameter>label.from.part</parameter> param, just as <tag>preface</tag>, <tag>chapter</tag>, and <tag>appendix</tag>.</phrase></screen>
6273 </listitem>
6274 <listitem>
6275 <para><literal>Mauritz Jeanson: callout.graphics.extension.xml</literal></para><screen><phrase role="commit-message">Clarified that 'extension' refers to file names.</phrase></screen>
6276 </listitem>
6277 <listitem>
6278 <para><literal>Michael(tm) Smith: abstract.notitle.enabled.xml</literal></para><screen><phrase role="commit-message">Added new param <parameter>abstract.notitle.enabled</parameter>.
6279 If non-zero, in output of the <tag>abstract</tag> element on titlepages,
6280 display of the <tag>abstract</tag> <tag>title</tag> is suppressed.
6281 Because sometimes you really don't want or need that <tag>title</tag>
6282 there...</phrase></screen>
6283 </listitem>
6284 <listitem>
6285 <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
6286 because of another recent change to suppress bold markup in .SH
6287 output, we no longer need to add a workaround for the accidental
6288 uppercasing of roff escapes that occurred previously.</phrase></screen>
6289 </listitem>
6290 <listitem>
6291 <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>
6292 </listitem>
6293 <listitem>
6294 <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>
6295 </listitem>
6296 <listitem>
6297 <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>
6298 </listitem>
6299 <listitem>
6300 <para><literal>Robert Stayton: callout.icon.size.xml</literal></para><screen><phrase role="commit-message">Set size of <tag>callout</tag> graphics.</phrase></screen>
6301 </listitem>
6302 <listitem>
6303 <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>
6304 </listitem>
6305 <listitem>
6306 <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>
6307 </listitem>
6308 <listitem>
6309 <para><literal>Robert Stayton: section.container.element.xml</literal></para><screen><phrase role="commit-message">Support spans in sections for certain processors.</phrase></screen>
6310 </listitem>
6311 <listitem>
6312 <para><literal>Robert Stayton: component.titlepage.properties.xml</literal></para><screen><phrase role="commit-message">Empty attribute set for top level component titlepage block.
6313 Allows setting a span on <tag>title</tag> <tag>info</tag>.</phrase></screen>
6314 </listitem>
6315 <listitem>
6316 <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>
6317 </listitem>
6318 <listitem>
6319 <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>
6320 </listitem>
6321 <listitem>
6322 <para><literal>Robert Stayton: id.warnings.xml</literal></para><screen><phrase role="commit-message">Turn off <parameter>id.warnings</parameter> by default.</phrase></screen>
6323 </listitem>
6324 <listitem>
6325 <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.
6326 New <tag>bibliography</tag> style can be turned on by setting parameter <parameter>bibliography.style</parameter> to "iso690"
6327 The code was provided by Jana Dvorakova</phrase></screen>
6328 </listitem>
6329 <listitem>
6330 <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>
6331 </listitem>
6332 </itemizedlist>
6333 </sect2><!--end of Params changes for 1.73.0-->
6334 <sect2 xml:id="V1.73.0_Highlighting">
6335 <title>Highlighting</title>
6336 <para>The following changes have been made to the
6337             <filename>highlighting</filename> code
6338             since the 1.72.0 release.</para>
6339 <itemizedlist>
6340 <listitem>
6341 <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>
6342 </listitem>
6343 </itemizedlist>
6344 </sect2><!--end of Highlighting changes for 1.73.0-->
6345 <sect2 xml:id="V1.73.0_Profiling">
6346 <title>Profiling</title>
6347 <para>The following changes have been made to the
6348             <filename>profiling</filename> code
6349             since the 1.72.0 release.</para>
6350 <itemizedlist>
6351 <listitem>
6352 <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>
6353 </listitem>
6354 </itemizedlist>
6355 </sect2><!--end of Profiling changes for 1.73.0-->
6356 <sect2 xml:id="V1.73.0_Lib">
6357 <title>Lib</title>
6358 <para>The following changes have been made to the
6359             <filename>lib</filename> code
6360             since the 1.72.0 release.</para>
6361 <itemizedlist>
6362 <listitem>
6363 <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
6364 it can do both right/left padding.</phrase></screen>
6365 </listitem>
6366 </itemizedlist>
6367 </sect2><!--end of Lib changes for 1.73.0-->
6368 <sect2 xml:id="V1.73.0_Tools">
6369 <title>Tools</title>
6370 <para>The following changes have been made to the
6371             <filename>tools</filename> code
6372             since the 1.72.0 release.</para>
6373 <itemizedlist>
6374 <listitem>
6375 <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
6376 docbook-xsl-update script to the docbook-xsl distro, the purpose
6377 of which is to facilitate easy sync-up to the latest docbook-xsl
6378 snapshot (by means of rsync).</phrase></screen>
6379 </listitem>
6380 </itemizedlist>
6381 </sect2><!--end of Tools changes for 1.73.0-->
6382 <sect2 xml:id="V1.73.0_XSL-Saxon">
6383 <title>XSL-Saxon</title>
6384 <para>The following changes have been made to the
6385             <filename>xsl-saxon</filename> code
6386             since the 1.72.0 release.</para>
6387 <itemizedlist>
6388 <listitem>
6389 <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
6390 parameter is used for FO output (where SVG now is the default graphics format for callouts).</phrase></screen>
6391 </listitem>
6392 <listitem>
6393 <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.
6394 These patches enable cross-references to callouts placed by <tag>area</tag> coordinates.
6395 It works for graphic, unicode and text callouts.
6396 Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
6397 </listitem>
6398 <listitem>
6399 <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>
6400 </listitem>
6401 </itemizedlist>
6402 </sect2><!--end of XSL-Saxon changes for 1.73.0-->
6403 <sect2 xml:id="V1.73.0_XSL-Xalan">
6404 <title>XSL-Xalan</title>
6405 <para>The following changes have been made to the
6406             <filename>xsl-xalan</filename> code
6407             since the 1.72.0 release.</para>
6408 <itemizedlist>
6409 <listitem>
6410 <para><literal>Michael(tm) Smith: Makefile; xalan2</literal></para><screen><phrase role="commit-message">Turned off xalan2.jar build. This removes DocBook XSL
6411 Java extensions support for versions of Xalan prior to
6412 Xalan 2.7. If you are currently using the extensions
6413 with an earlier version of Xalan, you need to upgrade
6414 to Xalan 2.7.</phrase></screen>
6415 </listitem>
6416 <listitem>
6417 <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
6418 parameter is used for FO output (where SVG now is the default graphics format for callouts).</phrase></screen>
6419 </listitem>
6420 <listitem>
6421 <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.
6422 These patches enable cross-references to callouts placed by <tag>area</tag> coordinates.
6423 It works for graphic, unicode and text callouts.
6424 Part of fix for bug #1675513 (<tag>xref</tag> to <tag>area</tag> broken).</phrase></screen>
6425 </listitem>
6426 <listitem>
6427 <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>
6428 </listitem>
6429 </itemizedlist>
6430 </sect2><!--end of XSL-Saxon changes for 1.73.0-->
6431 </sect1><!--end of changes for the 1.73.0 release-->
6432
6433 <sect1 xml:id="V1.72.0">
6434 <title>Release: 1.72.0</title>
6435 <para>This release includes important bug fixes and adds the following
6436 significant feature changes:
6437 <variablelist>
6438   <varlistentry>
6439     <term>Automatic sorting of glossary entries</term>
6440     <listitem>
6441       <para>The HTML and FO stylesheets now support automatic sorting
6442       of <tag>glossary</tag> entries. To enable glossary sorting, set
6443       the value of the <parameter>glossary.sort </parameter> parameter
6444       to <code>1</code> (by default, it’s value is
6445       <code>0</code>). When you enable glossary sorting,
6446       <tag>glossentry</tag> elements within a <tag> glossary</tag>,
6447       <tag>glossdiv</tag>, or <tag>glosslist</tag> are sorted on the
6448       <tag>glossterm</tag>, using the current language setting. If you
6449       don’t enable glossary sorting, then the order of
6450       <tag>glossentry</tag> elements is left “as is” — that is, they
6451       are not sorted but are instead just displayed in document
6452       order.</para>
6453     </listitem>
6454   </varlistentry>
6455   <varlistentry>
6456     <term>WordML renamed to Roundtrip, OpenOffice support added</term>
6457     <listitem>
6458     <para>Stylesheets for “roundtrip” conversion between documents in
6459     OpenOffice format (ODF) and DocBook XML have been added to the set
6460     of stylesheets that formerly had the collective title
6461     <wordasword>WordML</wordasword>, and that set of stylesheets has
6462     been renamed to <wordasword>Roundtrip</wordasword> to better
6463     reflect the actual scope and purpose of its contents.</para>
6464     <para>So the DocBook XSL Stylesheets now support roundtrip
6465     conversion (with certain limitations) of WordML, OpenOffice, and
6466     Apple Pages documents to and from DocBook XML.</para>
6467     </listitem>
6468   </varlistentry>
6469   <varlistentry>
6470     <term>Including QandASet questions in TOCs</term>
6471     <listitem>
6472       <para>The HTML stylesheet now provides support for including
6473       <tag>QandASet</tag> <tag>question</tag>s in the document TOC. To
6474       enable display of <tag>question</tag>s in the document TOC, set
6475       the value of the <parameter>qanda.in.toc</parameter> to
6476       <code>1</code> (by default, it’s <code>0</code>). When you
6477       enable <parameter>qanda.in.toc</parameter>, then the generated
6478       table of contents for a document will include
6479       <tag>qandaset</tag> titles, <tag>qandadiv</tag> titles, and
6480       <tag>question</tag> elements. The default value of zero
6481       excludes them from the TOC.
6482       <note>
6483         <para>The <parameter>qanda.in.toc</parameter> parameter does
6484         not affect any tables of contents that may be generated
6485         <emphasis>within</emphasis> a <tag>qandaset</tag> or
6486         <tag>qandadiv</tag> (only in the document TOC).</para>
6487       </note>
6488       </para>
6489     </listitem>
6490   </varlistentry>
6491   <varlistentry>
6492     <term>Language identifier in man-page filenames and pathnames</term>
6493     <listitem>
6494       <para>Added new parameter <parameter
6495       >man.output.lang.in.name.enabled</parameter>, which controls whether
6496       a language identifier is included in man-page filenames and
6497       pathnames. It works like this:</para>
6498
6499       <para>If the value of <parameter
6500       >man.output.lang.in.name.enabled</parameter> is non-zero,
6501       man-page files are output with a language identifier included in
6502       their filenames or pathnames as follows:</para>
6503
6504       <itemizedlist>
6505         <listitem><para>if
6506         <parameter>man.output.subdirs.enabled</parameter> is non-zero,
6507         each file is output to, e.g., a
6508         <filename>/$lang/man8/foo.8</filename> pathname</para></listitem>
6509
6510         <listitem><para>if
6511         <parameter>man.output.subdirs.enabled</parameter> is zero,
6512         each file is output with a <tag>foo.$lang.8</tag>
6513         filename</para></listitem>
6514       </itemizedlist>
6515
6516     </listitem>
6517   </varlistentry>
6518   <varlistentry>
6519     <term><parameter>index.page.number.properties</parameter> property set</term>
6520     <listitem>
6521       <para>For FO output, use the
6522       <parameter>index.page.number.properties</parameter> to control
6523       formatting of page numbers in <tag>index</tag> output — to (for
6524       example) to display page numbers in <tag>index</tag> output in a
6525       different color (to indicate that they are links).</para>
6526     </listitem>
6527   </varlistentry>
6528   <varlistentry>
6529     <term>Crop marks in output from Antenna House XSL Formatter</term>
6530     <listitem>
6531       <para>Support has been added for generating crop marks in
6532       print/PDF output generated using Antenna House XSL Formatter</para>
6533     </listitem>
6534   </varlistentry>
6535   <varlistentry>
6536     <term>More string-substitution hooks in manpages output</term>
6537     <listitem>
6538       <para>The <parameter>man.string.subst.map.local.pre</parameter>
6539       and <parameter>man.string.subst.map.local.post</parameter>
6540       parameters have been added to enable easier control over
6541       custom string substitutions.</para>
6542     </listitem>
6543   </varlistentry>
6544   <varlistentry>
6545     <term>Moved verbatim properties to attribute-set</term>
6546     <listitem>
6547       <para>The hardcoded properties used in verbatim elements (literallayout,
6548       programlisting, screen) were moved to the verbatim.properties
6549       attribute-set so they can be more easily customized.</para>
6550     </listitem>
6551   </varlistentry>
6552   <varlistentry>
6553     <term>enhanced simple.xlink template</term>
6554     <listitem>
6555       <para>Now the simple.xlink template in inline.xsl works with
6556       cross reference elements xref and link as well.  Also, more elements
6557       call simple.xlink, which enables DB5 xlink functionality.
6558       </para>
6559     </listitem>
6560   </varlistentry>
6561   <varlistentry>
6562     <term>DocBook 5 compatibility</term>
6563     <listitem>
6564       <para>Stylesheets now consistently support DocBook 5 attributes
6565       (such as xml:id). Also, DocBook 5 info elements are now checked
6566       along with other *info elements, and the use of name() function
6567       was replaced by local-name() so it also matches on DocBook 5 elements.
6568       These changes enable reusing the stylesheets with DocBook 5
6569       documents with minimal fixup.
6570       </para>
6571     </listitem>
6572   </varlistentry>
6573   <varlistentry>
6574     <term>HTML class attributes now handled in class.attribute mode </term>
6575     <listitem>
6576       <para>The HTML class attributes were formerly hardcoded to the
6577       element name.  Now the class attribute is generated by applying
6578       templates in class.attribute mode so class attribute names
6579       can be customized. The default is still the element name.</para>
6580     </listitem>
6581   </varlistentry>
6582   <varlistentry>
6583     <term>arabic-indic numbering enabled in autolabels</term>
6584     <listitem>
6585       <para>Numbering of chapter, sections, and pages can now use
6586       arabic-indic numbering when number format is set to 'arabicindic' or
6587       to &#x661;.</para>
6588     </listitem>
6589   </varlistentry>
6590 </variablelist>
6591 The following is a detailed list of changes (not
6592 including bug fixes) that have been made since the 1.71.1
6593 release.</para>
6594
6595 <sect2 xml:id="V1.72.0_Common">
6596 <title>Common</title>
6597 <para>The following changes have been made to the
6598             <filename>common</filename> code
6599             since the 1.71.1 release.</para>
6600 <itemizedlist>
6601 <listitem>
6602 <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>
6603 </listitem>
6604 <listitem>
6605 <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>
6606 </listitem>
6607 <listitem>
6608 <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>
6609 </listitem>
6610 <listitem>
6611 <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>
6612 </listitem>
6613 <listitem>
6614 <literallayout><phrase role="commit-message">Add utility template tabstyle to return the tabstyle from
6615 any <tag>table</tag> element.<alt>M: /trunk/xsl/common/table.xsl - Robert Stayton</alt></phrase></literallayout>
6616 </listitem>
6617 </itemizedlist>
6618 </sect2><!--end of Common changes for 1.72.0-->
6619
6620 <sect2 xml:id="V1.72.0_FO">
6621 <title>FO</title>
6622 <para>The following changes have been made to the
6623             <filename>fo</filename> code
6624             since the 1.71.1 release.</para>
6625 <itemizedlist>
6626 <listitem>
6627 <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>
6628 </listitem>
6629 <listitem>
6630 <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>
6631 </listitem>
6632 <listitem>
6633 <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>
6634 </listitem>
6635 <listitem>
6636 <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>
6637 </listitem>
6638 <listitem>
6639 <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>
6640 </listitem>
6641 <listitem>
6642 <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>
6643 </listitem>
6644 <listitem>
6645 <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>
6646 </listitem>
6647 <listitem>
6648 <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>
6649 </listitem>
6650 </itemizedlist>
6651 </sect2><!--end of FO changes for 1.72.0-->
6652
6653 <sect2 xml:id="V1.72.0_HTML">
6654 <title>HTML</title>
6655 <para>The following changes have been made to the
6656             <filename>html</filename> code
6657             since the 1.71.1 release.</para>
6658 <itemizedlist>
6659 <listitem>
6660 <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>
6661 </listitem>
6662 <listitem>
6663 <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>
6664 </listitem>
6665 <listitem>
6666 <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>
6667 </listitem>
6668 <listitem>
6669 <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>
6670 </listitem>
6671 <listitem>
6672 <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>
6673 </listitem>
6674 <listitem>
6675 <literallayout><phrase role="commit-message">Convert all class attributes to use the class.attribute mode
6676 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>
6677 </listitem>
6678 <listitem>
6679 <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>
6680 </listitem>
6681 <listitem>
6682 <literallayout><phrase role="commit-message">Added simple.xlink to most remaining inlines.
6683 Changed class attributes to applying class.attributes mode.<alt>M: /trunk/xsl/html/inline.xsl - Robert Stayton</alt></phrase></literallayout>
6684 </listitem>
6685 <listitem>
6686 <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>
6687 </listitem>
6688 <listitem>
6689 <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>
6690 </listitem>
6691 <listitem>
6692 <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>
6693 </listitem>
6694 <listitem>
6695 <literallayout><phrase role="commit-message">Use new link.title.attribute now.<alt>M: /trunk/xsl/html/xref.xsl - Robert Stayton</alt></phrase></literallayout>
6696 </listitem>
6697 <listitem>
6698 <literallayout><phrase role="commit-message">Rewrote simple.xlink to handle linkend also.
6699 Better computation of <tag>title</tag> attribute on <tag>link</tag> too.<alt>M: /trunk/xsl/html/inline.xsl - Robert Stayton</alt></phrase></literallayout>
6700 </listitem>
6701 <listitem>
6702 <literallayout><phrase role="commit-message">Handle Xalan quirk as special case.<alt>M: /trunk/xsl/html/db5strip.xsl - Robert Stayton</alt></phrase></literallayout>
6703 </listitem>
6704 <listitem>
6705 <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>
6706 </listitem>
6707 <listitem>
6708 <literallayout><phrase role="commit-message">Fixed imagemaps so they work properly going from calspair coords
6709 to HTML <tag>area</tag> coords.<alt>M: /trunk/xsl/html/graphics.xsl - Robert Stayton</alt></phrase></literallayout>
6710 </listitem>
6711 </itemizedlist>
6712 </sect2><!--end of HTML changes for 1.72.0-->
6713
6714 <sect2 xml:id="V1.72.0_Manpages">
6715 <title>Manpages</title>
6716 <para>The following changes have been made to the
6717             <filename>manpages</filename> code
6718             since the 1.71.1 release.</para>
6719 <itemizedlist>
6720 <listitem>
6721 <literallayout><phrase role="commit-message">Added doc for <parameter>man.output.lang.in.name.enabled</parameter> parameter. This
6722 checkin completes support for writing file/pathnames for man-pages
6723 with $lang include in the names. Closes #1585967. knightly
6724 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>
6725 </listitem>
6726 <listitem>
6727 <literallayout><phrase role="commit-message">Added new param <parameter>man.output.lang.in.name.enabled</parameter>, which
6728 controls whether $LANG value is included in manpages
6729 filenames and pathnames. It works like this:
6730
6731 If the value of <parameter>man.output.lang.in.name.enabled</parameter> is non-zero,
6732 man-page files are output with the $lang value included in
6733 their filenames or pathnames as follows;
6734
6735 - if <parameter>man.output.subdirs.enabled</parameter> is non-zero, each file is
6736   output to, e.g., a /$lang/man8/foo.8 pathname
6737
6738 - if <parameter>man.output.subdirs.enabled</parameter> is zero, each file is output
6739   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>
6740 </listitem>
6741 <listitem>
6742 <literallayout><phrase role="commit-message">Use "\e" instead of "\\" for backslash output, because the
6743 groff docs say that's the correct thing to do; also because
6744 testing (thanks, Paul Dubois) shows that "\\" doesn't always
6745 work as expected; for example, "\\" within a <tag>table</tag> seems to
6746 mess things up.<alt>M: /trunk/xsl/manpages/charmap.groff.xsl - Michael(tm) Smith</alt></phrase></literallayout>
6747 </listitem>
6748 <listitem>
6749 <literallayout><phrase role="commit-message">Added the <parameter>man.string.subst.map.local.pre</parameter> and
6750 <parameter>man.string.subst.map.local.post</parameter> parameters. Those parameters
6751 enable local additions and changes to string-substitution mappings
6752 without the need to change the value of <parameter>man.string.subst.map</parameter>
6753 parameter (which is for standard system mappings). Closes
6754 #1456738. Thanks to Sam Steingold for constructing a true
6755 stylesheet torture test (the clisp docs) that exposed the need for
6756 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>
6757 </listitem>
6758 <listitem>
6759 <literallayout><phrase role="commit-message">Added the Markup element to the list of elements that get output
6760 in bold. Thanks to Eric S. Raymond.<alt>M: /trunk/xsl/manpages/inline.xsl - Michael(tm) Smith</alt></phrase></literallayout>
6761 </listitem>
6762 <listitem>
6763 <literallayout><phrase role="commit-message">Replaced all dots in roff requests with U+2302 ("house"
6764 character), and added escaping in output for all instances of dot
6765 that are not in roff requests. This fixes the problem case where a
6766 string beginning with a dot (for example, the string ".bashrc")
6767 might occur at the beginning of a line in output, in which case
6768 would mistakenly get interpreted as a roff request. Thanks to Eric
6769 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>
6770 </listitem>
6771 <listitem>
6772 <literallayout><phrase role="commit-message">Made change to ensure that list content nested in
6773 <tag>itemizedlist</tag> and <tag>orderedlist</tag> instances is properly indented. This
6774 is a switch from using .TP to format those lists to using .RS/.RE
6775 to format them instead (because .TP does not allow nesting). Closes bug #1602616.
6776 Thanks to Daniel Leidert.<alt>M: /trunk/xsl/manpages/lists.xsl - Michael(tm) Smith</alt></phrase></literallayout>
6777 </listitem>
6778 </itemizedlist>
6779 </sect2><!--end of Manpages changes for 1.72.0-->
6780
6781 <sect2 xml:id="V1.72.0_Params">
6782 <title>Params</title>
6783 <para>The following changes have been made to the
6784             <filename>params</filename> code
6785             since the 1.71.1 release.</para>
6786 <itemizedlist>
6787 <listitem>
6788 <literallayout><phrase role="commit-message">Added doc for <parameter>man.output.lang.in.name.enabled</parameter> parameter. This
6789 checkin completes support for writing file/pathnames for man-pages
6790 with $lang include in the names. Closes #1585967. knightly
6791 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>
6792 </listitem>
6793 <listitem>
6794 <literallayout><phrase role="commit-message">Added new param <parameter>man.output.lang.in.name.enabled</parameter>, which
6795 controls whether $LANG value is included in manpages
6796 filenames and pathnames. It works like this:
6797
6798 If the value of <parameter>man.output.lang.in.name.enabled</parameter> is non-zero,
6799 man-page files are output with the $lang value included in
6800 their filenames or pathnames as follows;
6801
6802 - if <parameter>man.output.subdirs.enabled</parameter> is non-zero, each file is
6803   output to, e.g., a /$lang/man8/foo.8 pathname
6804
6805 - if <parameter>man.output.subdirs.enabled</parameter> is zero, each file is output
6806   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>
6807 </listitem>
6808 <listitem>
6809 <literallayout><phrase role="commit-message">Added the <parameter>man.string.subst.map.local.pre</parameter> and
6810 <parameter>man.string.subst.map.local.post</parameter> parameters. Those parameters
6811 enable local additions and changes to string-substitution mappings
6812 without the need to change the value of <parameter>man.string.subst.map</parameter>
6813 parameter (which is for standard system mappings). Closes
6814 #1456738. Thanks to Sam Steingold for constructing a true
6815 stylesheet torture test (the clisp docs) that exposed the need for
6816 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>
6817 </listitem>
6818 <listitem>
6819 <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>
6820 </listitem>
6821 <listitem>
6822 <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>
6823 </listitem>
6824 <listitem>
6825 <literallayout><phrase role="commit-message">Move show-destination="replace" property from template to attribute-set
6826 so it can be customized.<alt>M: /trunk/xsl/params/olink.properties.xml - Robert Stayton</alt></phrase></literallayout>
6827 </listitem>
6828 <listitem>
6829 <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>
6830 </listitem>
6831 <listitem>
6832 <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>
6833 </listitem>
6834 <listitem>
6835 <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>
6836 </listitem>
6837 </itemizedlist>
6838 </sect2><!--end of Params changes for 1.72.0-->
6839
6840 <sect2 xml:id="V1.72.0_Template">
6841 <title>Template</title>
6842 <para>The following changes have been made to the
6843             <filename>template</filename> code
6844             since the 1.71.1 release.</para>
6845 <itemizedlist>
6846 <listitem>
6847 <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>
6848 </listitem>
6849 </itemizedlist>
6850 </sect2><!--end of Template changes for 1.72.0-->
6851
6852 <sect2 xml:id="V1.72.0_Roundtrip">
6853 <title>Roundtrip</title>
6854 <para>The following changes have been made to the
6855             <filename>roundtrip</filename> code
6856             since the 1.71.1 release.</para>
6857 <itemizedlist>
6858 <listitem>
6859 <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>
6860 </listitem>
6861 </itemizedlist>
6862 </sect2><!--end of Roundtrip changes for 1.72.0-->
6863 </sect1><!--end of V1.72.0-->
6864
6865 <sect1 xml:id="V1.71.1">
6866 <title>Release: 1.71.1</title>
6867 <para>This is a minor update to the 1.71.0 release. Along with a
6868 number of bug fixes, it includes two feature changes:
6869
6870 <itemizedlist>
6871   <listitem>
6872     <para>Added support for profiling based on <tag
6873     class="attribute">xml:lang</tag> and <tag
6874     class="attribute">status</tag> attributes.</para>
6875   </listitem>
6876   <listitem>
6877     <para>Added initial support in manpages output for
6878     <tag>footnote</tag>, <tag>annotation</tag>, and <tag>alt</tag>
6879     instances. Basically, they all now get handled the same way
6880     <tag>ulink</tag> instances are. They are treated as a class as
6881     "note sources": A numbered marker is generated at the place in the
6882     main text flow where they occur, then their contents are displayed
6883     in an endnotes section at the end of the man page.</para>
6884   </listitem>
6885 </itemizedlist>
6886 </para>
6887
6888 <sect2 xml:id="V1.71.1_Common">
6889 <title>Common</title>
6890 <para>The following changes have been made to the
6891             <filename>common</filename> code
6892             since the 1.71.1 release.</para>
6893 <itemizedlist>
6894 <listitem>
6895 <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>
6896 </listitem>
6897 <listitem>
6898 <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>
6899 </listitem>
6900 </itemizedlist>
6901 </sect2><!--end of Common changes for 1.71.1-->
6902
6903 <sect2 xml:id="V1.71.1_FO">
6904 <title>FO</title>
6905 <para>The following changes have been made to the
6906             <filename>fo</filename> code
6907             since the 1.71.1 release.</para>
6908 <itemizedlist>
6909 <listitem>
6910 <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>
6911 </listitem>
6912 <listitem>
6913 <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>
6914 </listitem>
6915 <listitem>
6916 <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>
6917 </listitem>
6918 </itemizedlist>
6919 </sect2><!--end of FO changes for 1.71.1-->
6920
6921 <sect2 xml:id="V1.71.1_HTML">
6922 <title>HTML</title>
6923 <para>The following changes have been made to the
6924             <filename>html</filename> code
6925             since the 1.71.1 release.</para>
6926 <itemizedlist>
6927 <listitem>
6928 <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>
6929 </listitem>
6930 <listitem>
6931 <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>
6932 </listitem>
6933 <listitem>
6934 <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>
6935 </listitem>
6936 <listitem>
6937 <literallayout><phrase role="commit-message">Made changes in namespace declarations to prevent xmllint's
6938 canonicalizer from treating them as relative namespace URIs.
6939
6940   - Changed xmlns:k="java:com.isogen.saxoni18n.Saxoni18nService"
6941     to xmlns:k="http://www.isogen.com/functions/com.isogen.saxoni18n.Saxoni18nService";
6942     Saxon accepts either form
6943     (see http://www.saxonica.com/documentation/extensibility/functions.html);
6944     to Saxon, "the part of the URI before the final '/' is immaterial".
6945
6946   - Changed, e.g. xmlns:xverb="com.nwalsh.xalan.Verbatim" to
6947     xmlns:xverb="xalan://com.nwalsh.xalan.Verbatim"; Xalan accepts
6948     either form
6949     (see http://xml.apache.org/xalan-j/extensions.html#java-namespace-declare);
6950     just as Saxon does, it will "simply use the string to the
6951     right of the rightmost forward slash as the Java class name".
6952
6953   - Changed xmlns:xalanredirect="org.apache.xalan.xslt.extensions.Redirect"
6954     to xmlns:redirect="http://xml.apache.org/xalan/redirect", and
6955     adjusted associated code to make the current Xalan redirect spec.
6956     (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>
6957 </listitem>
6958 <listitem>
6959 <literallayout><phrase role="commit-message">Added the <parameter>html.append</parameter> and <parameter>chunk.append</parameter> parameters. By default, the
6960 value of both is empty; but the internal DocBook XSL stylesheets
6961 build sets their value to "&lt;xsl:text&gt;&amp;#x0a;&lt;/xsl:text&gt;", in order
6962 to ensure that all files in the docbook-xsl-doc package end in a
6963 newline character. (Because diff and some other tools may emit
6964 error messages and/or not behave as expected when processing
6965 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>
6966 </listitem>
6967 </itemizedlist>
6968 </sect2><!--end of HTML changes for 1.71.1-->
6969
6970 <sect2 xml:id="V1.71.1_Highlighting">
6971 <title>Highlighting</title>
6972 <para>The following changes have been made to the
6973             <filename>highlighting</filename> code
6974             since the 1.71.1 release.</para>
6975 <itemizedlist>
6976 <listitem>
6977 <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>
6978 </listitem>
6979 </itemizedlist>
6980 </sect2><!--end of Highlighting changes for 1.71.1-->
6981
6982 <sect2 xml:id="V1.71.1_Manpages">
6983 <title>Manpages</title>
6984 <para>The following changes have been made to the
6985             <filename>manpages</filename> code
6986             since the 1.71.1 release.</para>
6987 <itemizedlist>
6988 <listitem>
6989 <literallayout><phrase role="commit-message">Added initial support in manpages output for <tag>footnote</tag>, <tag>annotation</tag>,
6990 and <tag>alt</tag> instances. Basically, they all now get handled the same
6991 way ulink instances are. They are treated as a class as "note
6992 sources": A numbered marker is generated at the place in the main
6993 text flow where they occur, then their contents are displayed in
6994 an endnotes <tag>section</tag> at the end of the man page (currently titled
6995 REFERENCES, for English output, but will be changed to NOTES).
6996
6997 This support is not yet complete. It works for most "normal"
6998 cases, but probably mishandles a good number of cases. More
6999 testing will be needed to expose the problems. It may well also
7000 introduce some bugs and regressions in other areas, including
7001 basic paragraph handling, handling of "mixed block" content,
7002 handling of other indented content, and handling of authorblurb
7003 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>
7004 </listitem>
7005 </itemizedlist>
7006 </sect2><!--end of Manpages changes for 1.71.1-->
7007
7008 <sect2 xml:id="V1.71.1_Params">
7009 <title>Params</title>
7010 <para>The following changes have been made to the
7011             <filename>params</filename> code
7012             since the 1.71.1 release.</para>
7013 <itemizedlist>
7014 <listitem>
7015 <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>
7016 </listitem>
7017 <listitem>
7018 <literallayout><phrase role="commit-message">Added the <parameter>html.append</parameter> and <parameter>chunk.append</parameter> parameters. By default, the
7019 value of both is empty; but the internal DocBook XSL stylesheets
7020 build sets their value to "&lt;xsl:text&gt;&amp;#x0a;&lt;/xsl:text&gt;", in order
7021 to ensure that all files in the docbook-xsl-doc <tag>package</tag> end in a
7022 newline character. (Because diff and some other tools may emit
7023 error messages and/or not behave as expected when processing
7024 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>
7025 </listitem>
7026 </itemizedlist>
7027 </sect2><!--end of Params changes for 1.71.1-->
7028
7029 <sect2 xml:id="V1.71.1_Profiling">
7030 <title>Profiling</title>
7031 <para>The following changes have been made to the
7032             <filename>profiling</filename> code
7033             since the 1.71.1 release.</para>
7034 <itemizedlist>
7035 <listitem>
7036 <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>
7037 </listitem>
7038 </itemizedlist>
7039 </sect2><!--end of Profiling changes for 1.71.1-->
7040
7041 </sect1>
7042
7043 <sect1 xml:id="V1.71.0">
7044 <title>Release: 1.71.0</title>
7045 <para>This is mainly a bug fix release, but it also includes two
7046 significant feature changes:
7047 <variablelist>
7048   <varlistentry>
7049     <term>Highlighting support added</term>
7050     <listitem>
7051       <para>The stylesheets now include support for source-code
7052       highlighting in output of programlisting instances (controlled
7053       through the <parameter>highlight.source</parameter>
7054       parameter). The Java-based implementation requires Saxon and
7055       makes use of <link
7056       xlink:href="http://molhanec.net/"><person><personname
7057       ><firstname>Michal</firstname><surname
7058       >Molhanec</surname></personname></person></link>’s <link
7059       xlink:href="http://sourceforge.net/projects/xslthl"
7060       >XSLTHL</link>. More details are available at Jirka Kosek’s
7061       website: <blockquote ><simpara ><link
7062       xlink:href="http://xmlguru.cz/2006/07/docbook-syntax-highlighting"/></simpara
7063       ></blockquote> The support is currently limited to highlighting
7064       of XML, Java, PHP, Delphi, Modula-2 sources, and INI
7065       files.</para>
7066     </listitem>
7067   </varlistentry>
7068   <varlistentry>
7069     <term>Changes to autoindexing</term>
7070     <listitem>
7071       <para>The templates that handle alternative indexing methods
7072       were reworked to avoid errors produced by certain processors not
7073       being able to tolerate the presence of unused functions.  With
7074       this release, none of the code for the 'kimber' or 'kosek'
7075       methods is included in the default stylesheets.  In order to use
7076       one of those methods, your customization layer must import one
7077       of the optional stylesheet modules:</para>
7078       <para>
7079         <itemizedlist>
7080            <listitem>
7081              <simpara>html/autoidx-kosek.xsl</simpara>
7082            </listitem>
7083            <listitem>
7084              <simpara>html/autoidx-kimber.xsl</simpara>
7085            </listitem>
7086            <listitem>
7087              <simpara>fo/autoidx-kosek.xsl</simpara>
7088            </listitem>
7089            <listitem>
7090              <simpara>fo/autoidx-kimber.xsl</simpara>
7091            </listitem>
7092         </itemizedlist>
7093         See the <parameter>index.method</parameter> parameter
7094         reference page for more information.
7095       </para>
7096       <para>Two other changes to note:
7097       <itemizedlist>
7098         <listitem>
7099           <simpara>The default indexing method now can handle accented
7100           characters in latin-based alphabets, not just English. This
7101           means accented latin letters will group and sort with their
7102           unaccented counterpart.</simpara>
7103         </listitem>
7104         <listitem>
7105           <simpara>The default value for the
7106           <parameter>index.method</parameter> parameter was changed
7107           from 'english' to 'basic' because now the default method can
7108           handle latin-based alphabets, not just English.</simpara>
7109         </listitem>
7110       </itemizedlist>
7111       </para>
7112     </listitem>
7113   </varlistentry>
7114 </variablelist>
7115 The following is a list of changes that have
7116 been made since the 1.70.1 release.</para>
7117
7118 <sect2 xml:id="V1.71.0_Common">
7119 <title>Common</title>
7120 <para>The following changes have been made to the
7121             <filename>common</filename> code
7122             since the 1.70.1 release.</para>
7123 <itemizedlist>
7124
7125 <listitem>
7126 <literallayout><phrase role="commit-message">Added <parameter>reference.autolabel</parameter> parameter for controlling labels on
7127 <tag>reference</tag> output.<alt>M: /trunk/xsl/common/labels.xsl - Michael(tm) Smith</alt></phrase></literallayout>
7128 </listitem>
7129 <listitem>
7130 <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>
7131 </listitem>
7132 <listitem>
7133 <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>
7134 </listitem>
7135 <listitem>
7136 <literallayout><phrase role="commit-message">Support startinglinenumber on <tag>orderedlist</tag><alt>M: /trunk/xsl/common/common.xsl - Norman Walsh</alt></phrase></literallayout>
7137 </listitem>
7138 </itemizedlist>
7139 </sect2><!--end of Common changes for 1.71.0-->
7140
7141 <sect2 xml:id="V1.71.0_Extensions">
7142 <title>Extensions</title>
7143 <para>The following changes have been made to the
7144             <filename>extensions</filename> code
7145             since the 1.70.1 release.</para>
7146 <itemizedlist>
7147 <listitem>
7148 <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>
7149 </listitem>
7150 </itemizedlist>
7151 </sect2><!--end of Extensions changes for 1.71.0-->
7152
7153 <sect2 xml:id="V1.71.0_FO">
7154 <title>FO</title>
7155 <para>The following changes have been made to the
7156             <filename>fo</filename> code
7157             since the 1.70.1 release.</para>
7158 <itemizedlist>
7159
7160 <listitem>
7161 <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>
7162 </listitem>
7163
7164 <listitem>
7165 <literallayout><phrase role="commit-message">Support titlecase "Java", "Perl", and "IDL" as values for the
7166 language attribute on <tag>classsynopsis</tag>, etc. (instead of just
7167 lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
7168 (instead of just "cpp").
7169
7170 Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
7171 to "Brian A. Vanderburg II".<alt>M: /trunk/xsl/fo/synop.xsl - Michael(tm) Smith</alt></phrase></literallayout>
7172 </listitem>
7173
7174 <listitem>
7175 <literallayout><phrase role="commit-message">Added support for the <parameter>reference.autolabel</parameter> param in (X)HTML and FO
7176 output.<alt>M: /trunk/xsl/fo/param.xweb; M: /trunk/xsl/fo/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
7177 </listitem>
7178
7179 <listitem>
7180 <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>
7181 </listitem>
7182
7183 <listitem>
7184 <literallayout><phrase role="commit-message">Rearranged templates for the 3 indexing methods
7185 and changed method named 'english' to 'basic'.<alt>M: /trunk/xsl/fo/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
7186 </listitem>
7187 <listitem>
7188 <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>
7189 </listitem>
7190
7191 <listitem>
7192 <literallayout><phrase role="commit-message">Turn off blank-body for <parameter>fop1.extensions</parameter> too since fop 0.92
7193 does not support it either.<alt>M: /trunk/xsl/fo/pagesetup.xsl - Robert Stayton</alt></phrase></literallayout>
7194 </listitem>
7195
7196 <listitem>
7197 <literallayout><phrase role="commit-message">Add Xalan variant to test for exslt:node-set <tag>function</tag>.
7198 Xalan can use <tag>function</tag> named node-set(), but doesn't
7199 recognize it using function-available().<alt>M: /trunk/xsl/fo/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
7200 </listitem>
7201
7202 <listitem>
7203 <literallayout><phrase role="commit-message">Added support to FO stylesheets for handling instances of <tag>Org</tag>
7204 where it occurs outside of *<tag>info</tag> content. In HTML stylesheets,
7205 moved handling of <tag>Org</tag> out of info.xsl and into inline.xsl. In both
7206 FO and HTML stylesheets, added support for correctly processing
7207 <tag>Affiliation</tag> and <tag>Jobtitle</tag>.<alt>M: /trunk/xsl/fo/inline.xsl - Michael(tm) Smith</alt></phrase></literallayout>
7208 </listitem>
7209 <listitem>
7210 <literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
7211 <tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
7212 instances, and removed some debugging stuff that was generated in
7213 manpages output to mark the ends of sections.<alt>M: /trunk/xsl/fo/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
7214 </listitem>
7215 <listitem>
7216 <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
7217 default), delimiters are generated around e-mail addresses (output
7218 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>
7219 </listitem>
7220
7221 <listitem>
7222 <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>
7223 </listitem>
7224 <listitem>
7225 <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>
7226 </listitem>
7227 </itemizedlist>
7228 </sect2><!--end of FO changes for 1.71.0-->
7229
7230 <sect2 xml:id="V1.71.0_HTML">
7231 <title>HTML</title>
7232 <para>The following changes have been made to the
7233             <filename>html</filename> code
7234             since the 1.70.1 release.</para>
7235 <itemizedlist>
7236
7237 <listitem>
7238 <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>
7239 </listitem>
7240 <listitem>
7241 <literallayout><phrase role="commit-message">Support titlecase "Java", "Perl", and "IDL" as values for the
7242 language attribute on <tag>classsynopsis</tag>, etc. (instead of just
7243 lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
7244 (instead of just "cpp").
7245
7246 Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
7247 to "Brian A. Vanderburg II".<alt>M: /trunk/xsl/html/synop.xsl - Michael(tm) Smith</alt></phrase></literallayout>
7248 </listitem>
7249
7250 <listitem>
7251 <literallayout><phrase role="commit-message">Added support for the <parameter>reference.autolabel</parameter> param in (X)HTML and FO
7252 output.<alt>M: /trunk/xsl/html/param.xweb; M: /trunk/xsl/html/param.ent - Michael(tm) Smith</alt></phrase></literallayout>
7253 </listitem>
7254 <listitem>
7255 <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>
7256 </listitem>
7257
7258 <listitem>
7259 <literallayout><phrase role="commit-message">Rearranged templates for the 3 indexing methods
7260 and changed method named 'english' to 'basic'.<alt>M: /trunk/xsl/html/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
7261 </listitem>
7262 <listitem>
7263 <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>
7264 </listitem>
7265
7266 <listitem>
7267 <literallayout><phrase role="commit-message">Added several new HTML parameters for controlling appearance of
7268 content on HTML <tag>title</tag> pages:
7269
7270 <parameter>contrib.inline.enabled</parameter>:
7271   If non-zero (the default), output of the <tag>contrib</tag> element is
7272   displayed as inline content rather than as block content.
7273
7274 <parameter>othercredit.like.author.enabled</parameter>:
7275   If non-zero, output of the <tag>othercredit</tag> element on titlepages is
7276   displayed in the same style as <tag>author</tag> and <tag>editor</tag> output. If zero
7277   (the default), <tag>othercredit</tag> output is displayed using a style
7278   different than that of <tag>author</tag> and <tag>editor</tag>.
7279
7280 <parameter>blurb.on.titlepage.enabled</parameter>:
7281   If non-zero, output from authorblurb and <tag>personblurb</tag> elements is
7282   displayed on <tag>title</tag> pages. If zero (the default), output from
7283   those elements is suppressed on <tag>title</tag> pages (unless you are
7284   using a titlepage customization that causes them to be included).
7285
7286 <parameter>editedby.enabled</parameter>
7287   If non-zero (the default), a localized Edited by heading is
7288   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>
7289 </listitem>
7290
7291 <listitem>
7292 <literallayout><phrase role="commit-message">Add Xalan variant to test for exslt:node-set <tag>function</tag>.
7293 Xalan can use <tag>function</tag> named node-set(), but doesn't
7294 recognize it using function-available().<alt>M: /trunk/xsl/html/autoidx.xsl - Robert Stayton</alt></phrase></literallayout>
7295 </listitem>
7296
7297 <listitem>
7298 <literallayout><phrase role="commit-message">Added support to FO stylesheets for handling instances of <tag>Org</tag>
7299 where it occurs outside of *<tag>info</tag> content. In HTML stylesheets,
7300 moved handling of <tag>Org</tag> out of info.xsl and into inline.xsl. In both
7301 FO and HTML stylesheets, added support for correctly processing
7302 <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>
7303 </listitem>
7304 <listitem>
7305 <literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
7306 <tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
7307 instances, and removed some debugging stuff that was generated in
7308 manpages output to mark the ends of sections.<alt>M: /trunk/xsl/html/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
7309 </listitem>
7310 <listitem>
7311 <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
7312 default), delimiters are generated around e-mail addresses (output
7313 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>
7314 </listitem>
7315
7316 <listitem>
7317 <literallayout><phrase role="commit-message">Added <parameter>qanda.nested.in.toc</parameter> param. Default value is zero. If
7318 non-zero, instances of "nested" <tag>Qandaentry</tag> (ones that are children
7319 of <tag>Answer</tag> elements) are displayed in the <tag>TOC</tag>. Closes patch 1509018
7320 (from Daniel Leidert). Currently on affects HTML output (no patch
7321 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>
7322 </listitem>
7323
7324
7325 <listitem>
7326 <literallayout><phrase role="commit-message">Improved handling of relative locations generated files<alt>M: /trunk/xsl/html/html.xsl - Jirka Kosek</alt></phrase></literallayout>
7327 </listitem>
7328
7329 <listitem>
7330 <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>
7331 </listitem>
7332 <listitem>
7333 <literallayout><phrase role="commit-message">Support <tag>org</tag><alt>M: /trunk/xsl/html/info.xsl - Norman Walsh</alt></phrase></literallayout>
7334 </listitem>
7335 <listitem>
7336 <literallayout><phrase role="commit-message">Support <tag>person</tag><alt>M: /trunk/xsl/html/inline.xsl - Norman Walsh</alt></phrase></literallayout>
7337 </listitem>
7338 <listitem>
7339 <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>
7340 </listitem>
7341 </itemizedlist>
7342 </sect2><!--end of HTML changes for 1.71.0-->
7343
7344 <sect2 xml:id="V1.71.0_Highlighting">
7345 <title>Highlighting</title>
7346 <para>The following changes have been made to the
7347             <filename>highlighting</filename> code
7348             since the 1.70.1 release.</para>
7349 <itemizedlist>
7350
7351 <listitem>
7352 <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>
7353 </listitem>
7354 </itemizedlist>
7355 </sect2><!--end of Highlighting changes for 1.71.0-->
7356
7357 <sect2 xml:id="V1.71.0_Manpages">
7358 <title>Manpages</title>
7359 <para>The following changes have been made to the
7360             <filename>manpages</filename> code
7361             since the 1.70.1 release.</para>
7362 <itemizedlist>
7363
7364 <listitem>
7365 <literallayout><phrase role="commit-message">Suppress <tag>footnote</tag> markers and output warning that footnotes are
7366 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>
7367 </listitem>
7368
7369 <listitem>
7370 <literallayout><phrase role="commit-message">Handle instances of <tag>address</tag>/<tag>otheraddr</tag>/ulink in <tag>author</tag> et al in the
7371 same way as <tag>email</tag> instances; that is, display them on the same
7372 linke as the <tag>author</tag>, <tag>editor</tag>, etc., name.<alt>M: /trunk/xsl/manpages/info.xsl - Michael(tm) Smith</alt></phrase></literallayout>
7373 </listitem>
7374 <listitem>
7375 <literallayout><phrase role="commit-message">Don't number or link-list any Ulink instance whose string value is
7376 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>
7377 </listitem>
7378
7379 <listitem>
7380 <literallayout><phrase role="commit-message">Don't output punctuation between <tag>Refname</tag> and <tag>Refpurpose</tag> if
7381 <tag>Refpurpose</tag> is empty. Also corrected handling of <tag>Refsect2</tag>/<tag>title</tag>
7382 instances, and removed some debugging stuff that was generated in
7383 manpages output to mark the ends of sections.<alt>M: /trunk/xsl/manpages/refentry.xsl - Michael(tm) Smith</alt></phrase></literallayout>
7384 </listitem>
7385 <listitem>
7386 <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
7387 default), delimiters are generated around e-mail addresses (output
7388 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>
7389 </listitem>
7390
7391 <listitem>
7392 <literallayout><phrase role="commit-message">In manpages output, if the last/nearest *<tag>info</tag> element for
7393 particular <tag>Refentry</tag> has multiple <tag>Copyright</tag> and/or <tag>Legalnotice</tag>
7394 children, process them all (not just the first ones). Closes bug
7395 1524576. Thanks to Sam Steingold for the report and to Daniel
7396 Leidert for providing a patch.<alt>M: /trunk/xsl/manpages/info.xsl - Michael(tm) Smith</alt></phrase></literallayout>
7397 </listitem>
7398
7399 </itemizedlist>
7400 </sect2><!--end of Manpages changes for 1.71.0-->
7401
7402 <sect2 xml:id="V1.71.0_Params">
7403 <title>Params</title>
7404 <para>The following changes have been made to the
7405             <filename>params</filename> code
7406             since the 1.70.1 release.</para>
7407 <itemizedlist>
7408 <listitem>
7409 <literallayout><phrase role="commit-message">Added <parameter>reference.autolabel</parameter> parameter for controlling labels on
7410 <tag>reference</tag> output.<alt>A: /trunk/xsl/params/reference.autolabel.xml - Michael(tm) Smith</alt></phrase></literallayout>
7411 </listitem>
7412 <listitem>
7413 <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>
7414 </listitem>
7415 <listitem>
7416 <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>
7417 </listitem>
7418 <listitem>
7419 <literallayout><phrase role="commit-message">Added several new HTML parameters for controlling appearance of
7420 content on HTML <tag>title</tag> pages:
7421
7422 <parameter>contrib.inline.enabled</parameter>:
7423   If non-zero (the default), output of the <tag>contrib</tag> element is
7424   displayed as inline content rather than as block content.
7425
7426 <parameter>othercredit.like.author.enabled</parameter>:
7427   If non-zero, output of the <tag>othercredit</tag> element on titlepages is
7428   displayed in the same style as <tag>author</tag> and <tag>editor</tag> output. If zero
7429   (the default), <tag>othercredit</tag> output is displayed using a style
7430   different than that of <tag>author</tag> and <tag>editor</tag>.
7431
7432 <parameter>blurb.on.titlepage.enabled</parameter>:
7433   If non-zero, output from authorblurb and <tag>personblurb</tag> elements is
7434   displayed on <tag>title</tag> pages. If zero (the default), output from
7435   those elements is suppressed on <tag>title</tag> pages (unless you are
7436   using a titlepage customization that causes them to be included).
7437
7438 <parameter>editedby.enabled</parameter>
7439   If non-zero (the default), a localized Edited by heading is
7440   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>
7441 </listitem>
7442 <listitem>
7443 <literallayout><phrase role="commit-message">Added new <parameter>email.delimiters.enabled</parameter> param. If non-zero (the
7444 default), delimiters are generated around e-mail addresses (output
7445 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>
7446 </listitem>
7447
7448 <listitem>
7449 <literallayout><phrase role="commit-message">Added <parameter>qanda.nested.in.toc</parameter> param. Default value is zero. If
7450 non-zero, instances of "nested" <tag>Qandaentry</tag> (ones that are children
7451 of <tag>Answer</tag> elements) are displayed in the <tag>TOC</tag>. Closes patch 1509018
7452 (from Daniel Leidert). Currently on affects HTML output (no patch
7453 for FO output provided).<alt>A: /trunk/xsl/params/qanda.nested.in.toc.xml - Michael(tm) Smith</alt></phrase></literallayout>
7454 </listitem>
7455
7456 <listitem>
7457 <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>
7458 </listitem>
7459 </itemizedlist>
7460 </sect2><!--end of Params changes for 1.71.0-->
7461
7462 <sect2 xml:id="V1.71.0_Tools">
7463 <title>Tools</title>
7464 <para>The following changes have been made to the
7465             <filename>tools</filename> code
7466             since the 1.70.1 release.</para>
7467 <itemizedlist>
7468
7469 <listitem>
7470 <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>
7471 </listitem>
7472 <listitem>
7473 <literallayout><phrase role="commit-message">Added param and attribute set to example makefile, for getting
7474 wrapping in verbatims in FO output.<alt>M: /trunk/xsl/tools/make/Makefile.DocBook - Michael(tm) Smith</alt></phrase></literallayout>
7475 </listitem>
7476 <listitem>
7477 <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>
7478 </listitem>
7479 <listitem>
7480 <literallayout><phrase role="commit-message">Added Makefile.paramDoc file, for creating versions of param.xsl
7481 files with doc embedded.<alt>A: /trunk/xsl/tools/make/Makefile.paramDoc - Michael(tm) Smith</alt></phrase></literallayout>
7482 </listitem>
7483 <listitem>
7484 <literallayout><phrase role="commit-message">Added variable to example makefile for controlling whether HTML or
7485 XHTML is generated.<alt>M: /trunk/xsl/tools/make/Makefile.DocBook - Michael(tm) Smith</alt></phrase></literallayout>
7486 </listitem>
7487
7488 </itemizedlist>
7489 </sect2><!--end of Tools changes for 1.71.0-->
7490 </sect1>
7491
7492 <sect1 xml:id="V1701">
7493 <title>Release: 1.70.1</title>
7494
7495 <para>This is a stable release of the 1.70 stylesheets. It includes only a
7496 few small changes from 1.70.0.</para>
7497
7498 <para>The following is a list of changes that have been made
7499         since the 1.70.0 release.</para>
7500
7501 <sect2 xml:id="V1701_FO">
7502 <title>FO</title>
7503 <para>The following changes have been made to the
7504         <filename>fo</filename> code
7505         since the 1.70.0 release.</para>
7506 <itemizedlist>
7507 <listitem role="commit-message">
7508 <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>
7509 <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>
7510 </listitem>
7511 <listitem role="commit-message">
7512 <para>Support DBv5 revisions with full author name (not only authorinitials)</para>
7513 <para role="commit-changes">Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek</para>
7514 </listitem>
7515 </itemizedlist>
7516 </sect2><!--end of FO changes for 1.70.1-->
7517
7518 <sect2 xml:id="V1701_HTML">
7519 <title>HTML</title>
7520 <para>The following changes have been made to the
7521         <filename>html</filename> code
7522         since the 1.70.0 release.</para>
7523 <itemizedlist>
7524 <listitem role="commit-message">
7525 <para>Support DBv5 revisions with full author name (not only authorinitials)</para>
7526 <para role="commit-changes">Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek</para>
7527 </listitem>
7528 </itemizedlist>
7529 </sect2><!--end of HTML changes for 1.70.1-->
7530
7531 <sect2 xml:id="V1701_HTMLHelp">
7532 <title>HTMLHelp</title>
7533 <para>The following changes have been made to the
7534         <filename>htmlhelp</filename> code
7535         since the 1.70.0 release.</para>
7536 <itemizedlist>
7537 <listitem role="commit-message">
7538 <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>
7539 <para role="commit-changes">Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek</para>
7540 </listitem>
7541 <listitem role="commit-message">
7542 <para>Support chunk.tocs.and.lots in HTML Help</para>
7543 <para role="commit-changes">Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek</para>
7544 </listitem>
7545 </itemizedlist>
7546 </sect2><!--end of HTMLHelp changes for 1.70.1-->
7547
7548 <sect2 xml:id="V1701_Params">
7549 <title>Params</title>
7550 <para>The following changes have been made to the
7551         <filename>params</filename> code
7552         since the 1.70.0 release.</para>
7553 <itemizedlist>
7554 <listitem role="commit-message">
7555 <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>
7556 <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>
7557 </listitem>
7558 </itemizedlist>
7559 </sect2><!--end of Params changes for 1.70.1-->
7560
7561 </sect1>
7562
7563 <sect1 xml:id="V1700">
7564 <title>Release: 1.70.0</title>
7565 <para>As with all DocBook Project <link linkend="dot0">dot-zero</link>
7566 releases, this is an experimental release. It will be followed shortly
7567 by a stable release.</para>
7568
7569 <para>This release adds a number of new features,
7570 including:</para>
7571
7572 <itemizedlist>
7573   <listitem>
7574     <para>support for selecting alternative index-collation methods
7575     (in particular, support for using a collation library developed by
7576     Eliot Kimber)</para>
7577   </listitem>
7578   <listitem>
7579     <para>improved handling of DocBook 5 document instances (through a
7580     namespace-stripping mechanism)</para>
7581   </listitem>
7582   <listitem>
7583     <para>full support for CALS and HTML tables in manpages
7584     output</para>
7585   </listitem>
7586   <listitem>
7587     <para>a mechanism for preserving relative URIs in documents that
7588     make use of XInclude</para>
7589   </listitem>
7590   <listitem>
7591     <para>support for the "new" <literal>.90</literal> version of
7592     FOP</para>
7593   </listitem>
7594   <listitem>
7595     <para>enhanced capabilities for controlling formatting of lists in HTML
7596     and FO output</para>
7597   </listitem>
7598   <listitem>
7599     <para>autogeneration of AUTHOR and COPYRIGHT sections in manpages
7600     output</para>
7601   </listitem>
7602   <listitem>
7603     <para>support for generating crop marks in FO/PDF output</para>
7604   </listitem>
7605   <listitem>
7606     <para>support for qandaset as a root element in FO output</para>
7607   </listitem>
7608   <listitem>
7609     <para>support for floatstyle and orient on all table types</para>
7610   </listitem>
7611   <listitem>
7612     <para>support for floatstyle in figure, and example</para>
7613   </listitem>
7614   <listitem>
7615     <para>pgwide.properties attribute-set supports extending figure,
7616       example and table into the left indent area instead of spanning
7617       multiple columns.</para>
7618   </listitem>
7619 </itemizedlist>
7620     <para>The following is a detailed list of enhancements and API
7621     changes that have been made since the 1.69.1 release.</para>
7622
7623 <sect2 xml:id="V1700_Common">
7624 <title>Common</title>
7625 <para>The following changes have been made to the
7626         <filename>common</filename> code
7627         since the 1.69.1 release.</para>
7628 <itemizedlist>
7629 <listitem role="commit-message">
7630 <para>Add the xsl:key for the kimber
7631 indexing method.</para>
7632 <para role="commit-changes">Modified: common/autoidx-ng.xsl,1.2 - Robert
7633 Stayton</para>
7634 </listitem>
7635 <listitem role="commit-message">
7636 <para>Add support for
7637 <tag>qandaset</tag>.</para>
7638 <para role="commit-changes">Modified: common/labels.xsl,1.37;
7639 common/subtitles.xsl,1.7; common/titles.xsl,1.35 - Robert
7640 Stayton</para>
7641 </listitem>
7642 <listitem role="commit-message">
7643 <para>Support dbhtml/dbfo start PI for
7644 <tag>orderedlist</tag> numbering in both HTML and
7645 FO</para>
7646 <para role="commit-changes">Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman
7647 Walsh</para>
7648 </listitem>
7649 <listitem role="commit-message">
7650 <para>Added CVS
7651 header.</para>
7652 <para role="commit-changes">Modified: common/stripns.xsl,1.12 - Robert
7653 Stayton</para>
7654 </listitem>
7655 <listitem role="commit-message">
7656 <para>Changed content model of text
7657 element to ANY rather than #PCDATA because they could contain
7658 markup.</para>
7659 <para role="commit-changes">Modified: common/targetdatabase.dtd,1.7 - Robert
7660 Stayton</para>
7661 </listitem>
7662 <listitem role="commit-message">
7663 <para>Added
7664 <tag>refentry</tag>.meta.get.quietly param.</para>
7665 <para>If zero (the
7666 default), notes and warnings about "missing" markup are generated
7667 during gathering of <tag>refentry</tag> metadata. If
7668 non-zero, the metadata is gathered "quietly" -- that is, the
7669 notes and warnings are suppressed.</para>
7670 <para>NOTE: If you are
7671 processing a large amount of <tag>refentry</tag> content,  you
7672 may be able to speed up processing significantly by  setting a
7673 non-zero value for
7674 <tag>refentry</tag>.meta.get.quietly.</para>
7675 <para role="commit-changes">Modified: common/refentry.xsl,1.17;
7676 manpages/param.ent,1.15; manpages/param.xweb,1.17;
7677 params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
7678 Smith</para>
7679 </listitem>
7680 <listitem role="commit-message">
7681 <para>After namespace stripping, the
7682 source document is the temporary tree created by the stripping
7683 process and it has the wrong base <tag>URI</tag> for relative
7684 references. Earlier versions of this code used to try to fix that
7685 by patching the elements with relative @fileref attributes. That
7686 was inadequate because it calculated an absolute base <tag>URI</tag>
7687 without considering that there might be xml:base attributes
7688 already in effect. It seems obvious now that the right thing to
7689 do is simply to put the xml:base on the root of the document. And
7690 that seems to work.</para>
7691 <para role="commit-changes">Modified: common/stripns.xsl,1.7 - Norman
7692 Walsh</para>
7693 </listitem>
7694 <listitem role="commit-message">
7695 <para>Added support for "software" and
7696 "sectdesc" class values on <tag>refmiscinfo</tag>; "software" is
7697 treated identically to "source", and "setdesc" is treated
7698 identically to "manual".</para>
7699 <para role="commit-changes">Modified: common/refentry.xsl,1.10;
7700 params/man.th.extra2.max.length.xml,1.3;
7701 params/refentry.source.name.profile.xml,1.4 - Michael(tm)
7702 Smith</para>
7703 </listitem>
7704 <listitem role="commit-message">
7705 <para>Added support for DocBook 5
7706 namespace-stripping in manpages stylesheet. Closes request
7707 #1210692.</para>
7708 <para role="commit-changes">Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 -
7709 Michael(tm) Smith</para>
7710 </listitem>
7711 <listitem role="commit-message">
7712 <para>Added &lt;xsl:template
7713 match="/"&gt; to make stripns.xsl usable as a standalone
7714 stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that
7715 DocBook XSLT drivers that include this stylesheet all override
7716 the match="/" template.</para>
7717 <para role="commit-changes">Modified: common/stripns.xsl,1.4 - Michael(tm)
7718 Smith</para>
7719 </listitem>
7720 <listitem role="commit-message">
7721 <para>Number figures, examples, and
7722 tables from <tag>book</tag> if there is no prefix (i.e. if
7723 <parameter>chapter.autolabel</parameter> is set to 0). This avoids
7724 having the list of figures where the figures mysteriously restart
7725 their numeration periodically when
7726 <parameter>chapter.autolabel</parameter> is set to
7727 0.</para>
7728 <para role="commit-changes">Modified: common/labels.xsl,1.36 - David Cramer</para>
7729 </listitem>
7730 <listitem role="commit-message">
7731 <para>Add <tag>task</tag> template in
7732 <tag>title</tag>.markup mode.</para>
7733 <para role="commit-changes">Modified: common/titles.xsl,1.34 - Robert
7734 Stayton</para>
7735 </listitem>
7736 <listitem role="commit-message">
7737 <para>Add children (with ids) of formal
7738 objects to target data.</para>
7739 <para role="commit-changes">Modified: common/targets.xsl,1.10 - Robert
7740 Stayton</para>
7741 </listitem>
7742 <listitem role="commit-message">
7743 <para>Added support for case when
7744 <tag>personname</tag> doesn't contain specific name markup (as allowed
7745 in DocBook 5.0)</para>
7746 <para role="commit-changes">Modified: common/common.xsl,1.54 - Jirka
7747 Kosek</para>
7748 </listitem>
7749 </itemizedlist>
7750 </sect2><!--end of Common changes for snapshot_2006-05-15_0803-->
7751
7752 <sect2 xml:id="V1700_Extensions">
7753 <title>Extensions</title>
7754 <para>The following changes have been made to the
7755         <filename>extensions</filename> code
7756         since the 1.69.1 release.</para>
7757 <itemizedlist>
7758 <listitem role="commit-message">
7759 <para>Support Xalan
7760 2.7</para>
7761 <para role="commit-changes">Modified: extensions/xalan27/.cvsignore,1.1;
7762 extensions/xalan27/build.xml,1.1;
7763 extensions/xalan27/nbproject/.cvsignore,1.1;
7764 extensions/xalan27/nbproject/build-impl.xml,1.1;
7765 extensions/xalan27/nbproject/genfiles.properties,1.1;
7766 extensions/xalan27/nbproject/project.properties,1.1;
7767 extensions/xalan27/nbproject/project.xml,1.1;
7768 extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1;
7769 extensions/xalan27/src/com/nwalsh/xalan/Callout.java,1.1;
7770 extensions/xalan27/src/com/nwalsh/xalan/FormatCallout.java,1.1;
7771 extensions/xalan27/src/com/nwalsh/xalan/FormatDingbatCallout.java,1.1;
7772 extensions/xalan27/src/com/nwalsh/xalan/FormatGraphicCallout.java,1.1;
7773 extensions/xalan27/src/com/nwalsh/xalan/FormatTextCallout.java,1.1;
7774 extensions/xalan27/src/com/nwalsh/xalan/FormatUnicodeCallout.java,1.1;
7775 extensions/xalan27/src/com/nwalsh/xalan/Func.java,1.1;
7776 extensions/xalan27/src/com/nwalsh/xalan/ImageIntrinsics.java,1.1;
7777 extensions/xalan27/src/com/nwalsh/xalan/Params.java,1.1;
7778 extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1;
7779 extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1;
7780 extensions/xalan27/src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman
7781 Walsh</para>
7782 </listitem>
7783 <listitem role="commit-message">
7784 <para>Handle the case where the imageFn
7785 is actually a <tag>URI</tag>. This still needs
7786 work.</para>
7787 <para role="commit-changes">Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4
7788 - Norman Walsh</para>
7789 </listitem>
7790 </itemizedlist>
7791 </sect2><!--end of Extensions changes for snapshot_2006-05-15_0803-->
7792
7793 <sect2 xml:id="V1700_FO">
7794 <title>FO</title>
7795 <para>The following changes have been made to the
7796         <filename>fo</filename> code
7797         since the 1.69.1 release.</para>
7798 <itemizedlist>
7799 <listitem role="commit-message">
7800 <para>Adapted to the new indexing
7801 code. Now works just like a wrapper that calls kosek indexing method,
7802 originally implemented here.</para>
7803 <para role="commit-changes">Modified: fo/autoidx-ng.xsl,1.5 - Jirka
7804 Kosek</para>
7805 </listitem>
7806 <listitem role="commit-message">
7807 <para>Added parameters for header/footer
7808 <tag>table</tag> minimum height.</para>
7809 <para role="commit-changes">Modified: fo/pagesetup.xsl,1.60;
7810 fo/param.ent,1.100; fo/param.xweb,1.113 - Robert
7811 Stayton</para>
7812 </listitem>
7813 <listitem role="commit-message">
7814 <para>Add the <tag>index</tag>.method
7815 parameter.</para>
7816 <para role="commit-changes">Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert
7817 Stayton</para>
7818 </listitem>
7819 <listitem role="commit-message">
7820 <para>Integrate support for three
7821 indexing methods: - the original English-only method. -
7822 Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's
7823 method using Saxon extensions. Use the '<tag>index</tag>.method'
7824 parameter to select.</para>
7825 <para role="commit-changes">Modified: fo/autoidx.xsl,1.38 - Robert
7826 Stayton</para>
7827 </listitem>
7828 <listitem role="commit-message">
7829 <para>Add support for <tag>TOC</tag> for
7830 <tag>qandaset</tag> in fo output.</para>
7831 <para role="commit-changes">Modified: fo/autotoc.xsl,1.30;
7832 fo/qandaset.xsl,1.20 - Robert Stayton</para>
7833 </listitem>
7834 <listitem role="commit-message">
7835 <para>Added parameter
7836 <parameter>ulink.hyphenate</parameter>.chars. Added parameter
7837 insert.<tag>link</tag>.page.number.</para>
7838 <para role="commit-changes">Modified: fo/param.ent,1.98;
7839 fo/param.xweb,1.111 - Robert Stayton</para>
7840 </listitem>
7841 <listitem role="commit-message">
7842 <para>Implemented feature request
7843 #942524 to add insert.<tag>link</tag>.page.number to allow link
7844 element cross references to have a page number.</para>
7845 <para role="commit-changes">Modified: fo/xref.xsl,1.67 -
7846 Robert Stayton</para>
7847 </listitem>
7848 <listitem role="commit-message">
7849 <para>Add support for
7850 <parameter>ulink.hyphenate</parameter>.chars so more characters
7851 can be break points in urls.</para>
7852 <para role="commit-changes">Modified: fo/xref.xsl,1.66 - Robert
7853 Stayton</para>
7854 </listitem>
7855 <listitem role="commit-message">
7856 <para>Implemented patch #1075144 to make
7857 the url text in a ulink in FO output an active <tag>link</tag> as
7858 well.</para>
7859 <para role="commit-changes">Modified: fo/xref.xsl,1.65 - Robert Stayton</para>
7860 </listitem>
7861 <listitem role="commit-message">
7862 <para><tag>table</tag> footnotes now
7863 have their own <tag>table</tag>.<tag>footnote</tag>.properties
7864 attribute set.</para>
7865 <para role="commit-changes">Modified: fo/footnote.xsl,1.23 - Robert
7866 Stayton</para>
7867 </listitem>
7868 <listitem role="commit-message">
7869 <para>Add <tag>qandaset</tag> to
7870 root.elements.</para>
7871 <para role="commit-changes">Modified: fo/docbook.xsl,1.41 - Robert
7872 Stayton</para>
7873 </listitem>
7874 <listitem role="commit-message">
7875 <para>Added mode="page.sequence" to make
7876 it easier to put content into a page sequence.  First used for
7877 <tag>qandaset</tag>.</para>
7878 <para role="commit-changes">Modified: fo/component.xsl,1.37 - Robert
7879 Stayton</para>
7880 </listitem>
7881 <listitem role="commit-message">
7882 <para>Implemented feature request
7883 #1434408 to support formatting
7884 of <tag>biblioentry</tag>.</para>
7885 <para role="commit-changes">Modified: fo/biblio.xsl,1.35 - Robert
7886 Stayton</para>
7887 </listitem>
7888 <listitem role="commit-message">
7889 <para>Added
7890 <tag>biblioentry</tag>.properties.</para>
7891 <para role="commit-changes">Modified: fo/param.ent,1.97;
7892 fo/param.xweb,1.110 - Robert Stayton</para>
7893 </listitem>
7894 <listitem role="commit-message">
7895 <para>Support PTC/Arbortext
7896 bookmarks</para>
7897 <para role="commit-changes">Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman
7898 Walsh</para>
7899 </listitem>
7900 <listitem role="commit-message">
7901 <para>Added
7902 <tag>table</tag>.<tag>footnote</tag>.properties to permit
7903 <tag>table</tag> footnotes to format differently from regular
7904 footnotes.</para>
7905 <para role="commit-changes">Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert
7906 Stayton</para>
7907 </listitem>
7908 <listitem role="commit-message">
7909 <para>Refactored <tag>table</tag>
7910 templates to unify their processing and support all options in
7911 all types.  Now <tag>table</tag> and <tag>informaltable</tag>, in
7912 both Cals and Html markup, use the same templates where possible,
7913 and all support pgwide, rotation, and floats. There is also a
7914 placeholder <tag>table</tag>.container template to
7915 support wrapping a <tag>table</tag> in a layout <tag>table</tag>,
7916 so the XEP <tag>table</tag> <tag>title</tag> "continued"
7917 extension can be more easily implemented.</para>
7918 <para role="commit-changes">Modified: fo/formal.xsl,1.52;
7919 fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 - Robert
7920 Stayton</para>
7921 </listitem>
7922 <listitem role="commit-message">
7923 <para>Added new attribute set
7924 <tag>toc</tag>.line.properties for controlling appearance of lines in
7925 ToC/LoT</para>
7926 <para role="commit-changes">Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95;
7927 fo/param.xweb,1.108 - Jirka Kosek</para>
7928 </listitem>
7929 <listitem role="commit-message">
7930 <para>Added support for float to example
7931 and <tag>equation</tag>. Added support for pgwide to
7932 <tag>figure</tag>, example, and <tag>equation</tag> (the latter
7933 two via a dbfo pgwide="1" processing
7934 instruction).</para>
7935 <para role="commit-changes">Modified: fo/formal.xsl,1.51 - Robert
7936 Stayton</para>
7937 </listitem>
7938 <listitem role="commit-message">
7939 <para>Add pgwide.properties
7940 attribute-set.</para>
7941 <para role="commit-changes">Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert
7942 Stayton</para>
7943 </listitem>
7944 <listitem role="commit-message">
7945 <para>Added <tag>refclass</tag>.suppress
7946 param.</para>
7947 <para>If the value of <tag>refclass</tag>.suppress is
7948 non-zero, then display <tag>refclass</tag> contents is suppressed
7949 in output. Affects HTML and FO output
7950 only.</para>
7951 <para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
7952 html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
7953 Smith</para>
7954 </listitem>
7955 <listitem role="commit-message">
7956 <para>Improved support for
7957 <tag>task</tag> subelements</para>
7958 <para role="commit-changes">Modified: fo/task.xsl,1.3; html/task.xsl,1.3 -
7959 Jirka Kosek</para>
7960 </listitem>
7961 <listitem role="commit-message">
7962 <para>Adjusted spacing around
7963 K&amp;R-formatted <tag>Funcdef</tag> and <tag>Paramdef</tag>
7964 output such that it can more easily be discerned where one ends
7965 and the other begins. Closes #1213264.</para>
7966 <para role="commit-changes">Modified: fo/synop.xsl,1.18 -
7967 Michael(tm) Smith</para>
7968 </listitem>
7969 <listitem role="commit-message">
7970 <para>Made handling of
7971 paramdef/parameter in FO output consistent with that in HTML and
7972 manpages output. Closes #1213259.</para>
7973 <para role="commit-changes">Modified: fo/synop.xsl,1.17 - Michael(tm)
7974 Smith</para>
7975 </listitem>
7976 <listitem role="commit-message">
7977 <para>Made handling of
7978 <tag>Refnamediv</tag> consistent with formatting in HTML
7979 and manpages output; specifically, changed so that
7980 <tag>Refname</tag> (comma-separated list of multiple instances
7981 found) is used (instead of <tag>Refentrytitle</tag> as
7982 previously), then em-dash, then the <tag>Refpurpose</tag>. Closes
7983 #1212562.</para>
7984 <para role="commit-changes">Modified: fo/refentry.xsl,1.30 - Michael(tm)
7985 Smith</para>
7986 </listitem>
7987 <listitem role="commit-message">
7988 <para>Added output of
7989 <tag>Releaseinfo</tag> to recto titlepage ("<tag>copyright</tag>"
7990 page) for <tag>Book</tag> in FO output. This makes it consistent
7991 with HTML output. Closes #1327034. Thanks to Paul DuBois for
7992 reporting.</para>
7993 <para role="commit-changes">Modified: fo/titlepage.templates.xml,1.28 - Michael(tm)
7994 Smith</para>
7995 </listitem>
7996 <listitem role="commit-message">
7997 <para>Added condition for setting
7998 block-progression-dimension.minimum on table-row, instead of
7999 height, when <parameter>fop1.extensions</parameter> is
8000 non-zero. For an explanation of the reason for the change,
8001 <tag>see</tag>: http://wiki.apache.org/xmlgraphics-fop/Troubleshooting/CommonLogMessages</para>
8002 <para role="commit-changes">Modified: fo/pagesetup.xsl,1.59
8003 - Michael(tm) Smith</para>
8004 </listitem>
8005 <listitem role="commit-message">
8006 <para>Added new
8007 <tag>refclass</tag>.suppress param for suppressing display
8008 of <tag>Refclass</tag> in HTML and FO output. Did not add it to
8009 manpages because manpages stylesheet is currently just silently
8010 ignoring <tag>Refclass</tag> anyway. Closes request
8011 #1461065. Thanks to Davor Ocelic (docelic) for
8012 reporting.</para>
8013 <para role="commit-changes">Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 -
8014 Michael(tm) Smith</para>
8015 </listitem>
8016 <listitem role="commit-message">
8017 <para>Add support for keep-together PI
8018 to informal objects.</para>
8019 <para role="commit-changes">Modified: fo/formal.xsl,1.50 - Robert
8020 Stayton</para>
8021 </listitem>
8022 <listitem role="commit-message">
8023 <para>Add support for
8024 <parameter>fop1.extensions</parameter>.</para>
8025 <para role="commit-changes">Modified: fo/formal.xsl,1.49;
8026 fo/graphics.xsl,1.44; fo/table.xsl,1.47 - Robert
8027 Stayton</para>
8028 </listitem>
8029 <listitem role="commit-message">
8030 <para>Add support for fop1
8031 bookmarks.</para>
8032 <para role="commit-changes">Modified: fo/docbook.xsl,1.39 - Robert
8033 Stayton</para>
8034 </listitem>
8035 <listitem role="commit-message">
8036 <para>Add fop1.extentions parameter to
8037 add support for fop development version.</para>
8038 <para role="commit-changes">Modified: fo/param.ent,1.92;
8039 fo/param.xweb,1.105 - Robert Stayton</para>
8040 </listitem>
8041 <listitem role="commit-message">
8042 <para>Start supporting fop development
8043 version, which will become fop version 1.</para>
8044 <para role="commit-changes">Modified: fo/fop1.xsl,1.1 -
8045 Robert Stayton</para>
8046 </listitem>
8047 <listitem role="commit-message">
8048 <para>Add template for <tag>task</tag>
8049 in mode="xref-to".</para>
8050 <para role="commit-changes">Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert
8051 Stayton</para>
8052 </listitem>
8053 <listitem role="commit-message">
8054 <para><tag>table</tag> footnotes now
8055 also get <tag>footnote</tag>.properties
8056 attribute-set.</para>
8057 <para role="commit-changes">Modified: fo/footnote.xsl,1.22 - Robert
8058 Stayton</para>
8059 </listitem>
8060 <listitem role="commit-message">
8061 <para>Added <tag>index</tag>.separator
8062 named template to compute the separator punctuation based on
8063 locale.</para>
8064 <para role="commit-changes">Modified: fo/autoidx.xsl,1.36 - Robert Stayton</para>
8065 </listitem>
8066 <listitem role="commit-message">
8067 <para>Added support for <tag>link</tag>,
8068 <tag>olink</tag>, and <tag>xref</tag> within OO
8069 <tag>Classsynopsis</tag> and children. (Because DocBook NG/5
8070 allows it).</para>
8071 <para role="commit-changes">Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm)
8072 Smith</para>
8073 </listitem>
8074 <listitem role="commit-message">
8075 <para>Support <tag>date</tag> as an
8076 inline</para>
8077 <para role="commit-changes">Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman
8078 Walsh</para>
8079 </listitem>
8080 <listitem role="commit-message">
8081 <para>Added new parameter
8082 <parameter>keep.relative.image.uris</parameter></para>
8083 <para role="commit-changes">Modified: fo/param.ent,1.91;
8084 fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
8085 params/keep.relative.image.uris.xml,1.1 - Norman
8086 Walsh</para>
8087 </listitem>
8088 <listitem role="commit-message">
8089 <para>Map Unicode space characters
8090 U+2000-U+200A to fo:leaders.</para>
8091 <para role="commit-changes">Modified: fo/docbook.xsl,1.38;
8092 fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 - Jirka
8093 Kosek</para>
8094 </listitem>
8095 <listitem role="commit-message">
8096 <para>Output a real em dash for em-dash
8097 dingbat (instead of two hypens).</para>
8098 <para role="commit-changes">Modified: fo/fo.xsl,1.7 - Michael(tm)
8099 Smith</para>
8100 </listitem>
8101 <listitem role="commit-message">
8102 <para>Support default <tag>label</tag>
8103 width parameters for itemized and ordered lists</para>
8104 <para role="commit-changes">Modified: fo/lists.xsl,1.64;
8105 fo/param.ent,1.90; fo/param.xweb,1.103;
8106 params/itemizedlist.label.width.xml,1.1;
8107 params/orderedlist.label.width.xml,1.1 - Norman
8108 Walsh</para>
8109 </listitem>
8110 <listitem role="commit-message">
8111 <para>Generate localized
8112 <tag>title</tag> for <tag>Refsynopsisdiv</tag> if no
8113 appropriate <tag>Title</tag> descendant found in source. Closes
8114 #1212398. This change makes behavior for the <tag>Synopsis</tag>
8115 <tag>title</tag> consistent with the behavior of HTML and
8116 manpages output.</para>
8117 <para>Also, added
8118 xsl:use-attribute-sets="normal.<tag>para</tag>.spacing" to
8119 block generated for <tag>Cmdsynopsis</tag> output. Previously,
8120 that block had no spacing at all specified, which resulted it
8121 being crammed up to closely to the <tag>Synopsis</tag>
8122 head.</para>
8123 <para role="commit-changes">Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm)
8124 Smith</para>
8125 </listitem>
8126 <listitem role="commit-message">
8127 <para>Added parameters to support
8128 localization of <tag>index</tag>
8129 item punctuation.</para>
8130 <para role="commit-changes">Modified: fo/autoidx.xsl,1.35 - Robert
8131 Stayton</para>
8132 </listitem>
8133 <listitem role="commit-message">
8134 <para>Added
8135 <parameter>index.number.separator</parameter>,
8136 <parameter>index.range.separator</parameter>,
8137 and <parameter>index.term.separator</parameter> parameters to
8138 support localization of punctuation in <tag>index</tag>
8139 entries.</para>
8140 <para role="commit-changes">Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert
8141 Stayton</para>
8142 </listitem>
8143 <listitem role="commit-message">
8144 <para>Added "Cross References"
8145 <tag>section</tag> in HTML doc (for consistency with the FO
8146 doc). Also, moved the existing FO "Cross
8147 References" <tag>section</tag> to follow the "Linking"
8148 <tag>section</tag>.</para>
8149 <para role="commit-changes">Modified: fo/param.xweb,1.101; html/param.xweb,1.95 -
8150 Michael(tm) Smith</para>
8151 </listitem>
8152 <listitem role="commit-message">
8153 <para>Added ID attribues to all
8154 <tag>Reference</tag> elements (e.g., id="tables" for the doc for
8155 <tag>section</tag> on <tag>Table</tag> params). So pages for
8156 all subsections of ref docs now have stable filenames instead
8157 of arbitrary generated filenames.</para>
8158 <para role="commit-changes">Modified: fo/param.xweb,1.100;
8159 html/param.xweb,1.94 - Michael(tm) Smith</para>
8160 </listitem>
8161 <listitem role="commit-message">
8162 <para>Added two new parameters for
8163 handling of multi-term
8164 <tag>varlistentry</tag> elements:</para>
8165 <para><parameter>variablelist.term.break.after</parameter>:
8166 When the <parameter>variablelist.term.break.after</parameter> is
8167 non-zero, it will  generate a line break after each
8168 <tag>term</tag> multi-term
8169 <tag>varlistentry</tag>.</para>
8170 <para><parameter>variablelist.term.separator</parameter>:
8171 When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
8172 elements, the string  specified in the value of the
8173 <parameter>variablelist.term.separator</parameter>  parameter is
8174 placed after each <tag>term</tag> except the last. The default
8175 is ", " (a comma followed by a space). To suppress rendering of
8176 the separator, set the value of
8177 <parameter>variablelist.term.separator</parameter> to  the empty
8178 string ("").</para>
8179 <para>These parameters are primarily intended to be
8180 useful if you have multi-term varlistentries that have long
8181 terms.</para>
8182 <para>Closes #1306676. Thanks to Sam Steingold for
8183 providing an example "lots of long terms" doc that demonstrated
8184 the value of having these options.</para>
8185 <para>Also, added
8186 normalize-space() call to processing of each
8187 <tag>term</tag>.</para>
8188 <para>This change affects all output formats
8189 (HTML, PDF, manpages). The default behavior should pretty much
8190 remain the same as before, but it is possible (as always) that
8191 the change may introduce some
8192 new bugginess.</para>
8193 <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
8194 fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
8195 html/param.xweb,1.93; manpages/lists.xsl,1.22;
8196 manpages/param.ent,1.14; manpages/param.xweb,1.16;
8197 params/variablelist.term.break.after.xml,1.1;
8198 params/variablelist.term.separator.xml,1.1 - Michael(tm)
8199 Smith</para>
8200 </listitem>
8201 <listitem role="commit-message">
8202 <para>Add <tag>sidebar</tag> titlepage
8203 placeholder attset for styles.</para>
8204 <para role="commit-changes">Modified: fo/titlepage.xsl,1.37 - Robert
8205 Stayton</para>
8206 </listitem>
8207 <listitem role="commit-message">
8208 <para>Add titlepage for
8209 <tag>sidebar</tag>.</para>
8210 <para role="commit-changes">Modified: fo/titlepage.templates.xml,1.27 - Robert
8211 Stayton</para>
8212 </listitem>
8213 <listitem role="commit-message">
8214 <para>Implemented RFE
8215 #1292615.</para>
8216 <para>Added bunch of new parameters (attribute sets)
8217 that affect list presentation: list.block.properties,
8218 <tag>itemizedlist</tag>.properties, <tag>orderedlist</tag>.properties,
8219 <tag>itemizedlist</tag>.<tag>label</tag>.properties and
8220 <tag>orderedlist</tag>.<tag>label</tag>.properties. Default behaviour
8221 of stylesheets has not been changed but further customizations will be
8222 much more easier.</para>
8223 <para role="commit-changes">Modified: fo/lists.xsl,1.61; fo/param.ent,1.87;
8224 fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1;
8225 params/itemizedlist.properties.xml,1.1;
8226 params/list.block.properties.xml,1.1;
8227 params/orderedlist.label.properties.xml,1.1;
8228 params/orderedlist.properties.xml,1.1 - Jirka
8229 Kosek</para>
8230 </listitem>
8231 <listitem role="commit-message">
8232 <para>Implemented RFE
8233 #1242092.</para>
8234 <para>You can enable crop marks in your document by
8235 setting crop.marks=1 and xep.extensions=1. Appearance of crop
8236 marks can be controlled by parameters
8237 <parameter>crop.mark.bleed</parameter> (6pt),
8238 <parameter>crop.mark.offset</parameter> (24pt) and
8239 <parameter>crop.mark.width</parameter> (0.5pt).</para>
8240 <para>Also there
8241 is new named template called user-xep-pis. You can overwrite it in
8242 order to produce some PIs that can control XEP as described in
8243 http://www.renderx.com/reference.html#Output_Formats</para>
8244 <para role="commit-changes">Modified: fo/docbook.xsl,1.36;
8245 fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23;
8246 params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1;
8247 params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka
8248 Kosek</para>
8249 </listitem>
8250 </itemizedlist>
8251 </sect2><!--end of FO changes for snapshot_2006-05-15_0803-->
8252
8253 <sect2 xml:id="V1700_HTML">
8254 <title>HTML</title>
8255 <para>The following changes have been made to the
8256         <filename>html</filename> code
8257         since the 1.69.1 release.</para>
8258 <itemizedlist>
8259 <listitem role="commit-message">
8260 <para>implemented
8261 <tag>index</tag>.method parameter and three
8262 methods.</para>
8263 <para role="commit-changes">Modified: html/autoidx.xsl,1.28 - Robert
8264 Stayton</para>
8265 </listitem>
8266 <listitem role="commit-message">
8267 <para>added <tag>index</tag>.method
8268 parameter to support 3 indexing methods.</para>
8269 <para role="commit-changes">Modified: html/param.ent,1.94;
8270 html/param.xweb,1.103 - Robert Stayton</para>
8271 </listitem>
8272 <listitem role="commit-message">
8273 <para>Implemented feature request
8274 #1072510 as a processing instruction to permit including external
8275 HTML content into HTML output.</para>
8276 <para role="commit-changes">Modified: html/pi.xsl,1.9 - Robert
8277 Stayton</para>
8278 </listitem>
8279 <listitem role="commit-message">
8280 <para>Added new parameter
8281 <parameter>chunk.tocs.and.lots</parameter>.has.<tag>title</tag> which
8282 controls presence of <tag>title</tag> in a separate chunk with
8283 ToC/LoT. Disabling <tag>title</tag> can be very useful if you are
8284 generating frameset output (well, yes those frames, but some customers
8285 really want them ;-).</para>
8286 <para role="commit-changes">Modified: html/chunk-code.xsl,1.15;
8287 html/param.ent,1.93; html/param.xweb,1.102;
8288 params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
8289 Kosek</para>
8290 </listitem>
8291 <listitem role="commit-message">
8292 <para>Support dbhtml/dbfo start PI for
8293 <tag>orderedlist</tag> numbering in both HTML and
8294 FO</para>
8295 <para role="commit-changes">Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman
8296 Walsh</para>
8297 </listitem>
8298 <listitem role="commit-message">
8299 <para>Allow <tag>ToC</tag> without
8300 <tag>title</tag> also for set and
8301 <tag>book</tag>.</para>
8302 <para role="commit-changes">Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 -
8303 Jirka Kosek</para>
8304 </listitem>
8305 <listitem role="commit-message">
8306 <para>Implemented floats uniformly for
8307 <tag>figure</tag>, example, <tag>equation</tag>
8308 and <tag>informalfigure</tag>, <tag>informalexample</tag>, and
8309 <tag>informalequation</tag>.</para>
8310 <para role="commit-changes">Modified: html/formal.xsl,1.22 - Robert
8311 Stayton</para>
8312 </listitem>
8313 <listitem role="commit-message">
8314 <para>Added the
8315 autotoc.<tag>label</tag>.in.hyperlink param.</para>
8316 <para>If the value
8317 of autotoc.<tag>label</tag>.in.hyperlink is non-zero, labels
8318 are included in hyperlinked titles in the <tag>TOC</tag>. If it
8319 is instead zero, labels are still displayed prior to the
8320 hyperlinked titles, but are not hyperlinked along with the
8321 titles.</para>
8322 <para>Closes patch #1065868. Thanks to anatoly techtonik
8323 for the patch.</para>
8324 <para role="commit-changes">Modified: html/autotoc.xsl,1.36; html/param.ent,1.92;
8325 html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 -
8326 Michael(tm) Smith</para>
8327 </listitem>
8328 <listitem role="commit-message">
8329 <para>Added two new params:
8330 html.head.<tag>legalnotice</tag>.<tag>link</tag>.types
8331 and html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple.</para>
8332 <para>If
8333 the value of the <parameter>generate.legalnotice.link</parameter> is
8334 non-zero, then the stylesheet generates (in the head
8335 <tag>section</tag> of the HTML source) either a single HTML
8336 <tag>link</tag> element or, if the value of
8337 the html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple is
8338 non-zero, one <tag>link</tag> element for each <tag>link</tag>
8339 type specified. Each <tag>link</tag> has the
8340 following attributes:</para>
8341 <para> - a rel attribute whose value
8342 is derived from the value of
8343 html.head.<tag>legalnotice</tag>.<tag>link</tag>.types</para>
8344 <para> -
8345 an href attribute whose value is set to the URL of the file
8346 containing the <tag>legalnotice</tag></para>
8347 <para> - a <tag>title</tag>
8348 attribute whose value is set to the <tag>title</tag> of the
8349 corresponding <tag>legalnotice</tag> (or a <tag>title</tag>
8350 programatically  determined by the stylesheet)</para>
8351 <para>For
8352 example:</para>
8353 <para> &lt;<tag>link</tag> rel="<tag>copyright</tag>"
8354 href="ln-id2524073.html" title="Legal Notice"&gt;</para>
8355 <para>Closes
8356 #1476450. Thanks to Sam Steingold.</para>
8357 <para role="commit-changes">Modified: html/chunk-common.xsl,1.45;
8358 html/param.ent,1.91; html/param.xweb,1.100;
8359 params/generate.legalnotice.link.xml,1.4;
8360 params/html.head.legalnotice.link.multiple.xml,1.1;
8361 params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm)
8362 Smith</para>
8363 </listitem>
8364 <listitem role="commit-message">
8365 <para>Added <tag>refclass</tag>.suppress
8366 param.</para>
8367 <para>If the value of <tag>refclass</tag>.suppress is
8368 non-zero, then display <tag>refclass</tag> contents is suppressed
8369 in output. Affects HTML and FO output
8370 only.</para>
8371 <para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
8372 html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
8373 Smith</para>
8374 </listitem>
8375 <listitem role="commit-message">
8376 <para>Improved support for
8377 <tag>task</tag> subelements</para>
8378 <para role="commit-changes">Modified: fo/task.xsl,1.3; html/task.xsl,1.3 -
8379 Jirka Kosek</para>
8380 </listitem>
8381 <listitem role="commit-message">
8382 <para>Added new
8383 <tag>refclass</tag>.suppress param for suppressing display
8384 of <tag>Refclass</tag> in HTML and FO output. Did not add it to
8385 manpages because manpages stylesheet is currently just silently
8386 ignoring <tag>Refclass</tag> anyway. Closes request
8387 #1461065. Thanks to Davor Ocelic (docelic) for
8388 reporting.</para>
8389 <para role="commit-changes">Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 -
8390 Michael(tm) Smith</para>
8391 </listitem>
8392 <listitem role="commit-message">
8393 <para>Process <tag>alt</tag> text with
8394 normalize-space(). Replace tab indents with
8395 spaces.</para>
8396 <para role="commit-changes">Modified: html/graphics.xsl,1.57 - Robert
8397 Stayton</para>
8398 </listitem>
8399 <listitem role="commit-message">
8400 <para>Content of <tag>citation</tag>
8401 element is automatically linked to the bibliographic <tag>entry</tag>
8402 with the corresponding <tag>abbrev</tag>.</para>
8403 <para role="commit-changes">Modified: html/biblio.xsl,1.26;
8404 html/inline.xsl,1.47; html/xref.xsl,1.58 - Jirka
8405 Kosek</para>
8406 </listitem>
8407 <listitem role="commit-message">
8408 <para>Add template for <tag>task</tag>
8409 in mode="xref-to".</para>
8410 <para role="commit-changes">Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert
8411 Stayton</para>
8412 </listitem>
8413 <listitem role="commit-message">
8414 <para>Suppress ID warnings if the
8415 .warnings parameter is 0</para>
8416 <para role="commit-changes">Modified: html/html.xsl,1.17 - Norman
8417 Walsh</para>
8418 </listitem>
8419 <listitem role="commit-message">
8420 <para>Add support for floatstyle to
8421 <tag>figure</tag>.</para>
8422 <para role="commit-changes">Modified: html/formal.xsl,1.21 - Robert
8423 Stayton</para>
8424 </listitem>
8425 <listitem role="commit-message">
8426 <para>Handling of <tag>xref</tag> to
8427 area/areaset need support in extensions code also. I currently have no
8428 time to touch extensions code, so code is here to be enabled when
8429 extension is fixed also.</para>
8430 <para role="commit-changes">Modified: html/xref.xsl,1.56 - Jirka
8431 Kosek</para>
8432 </listitem>
8433 <listitem role="commit-message">
8434 <para>Added 3 parameters for overriding
8435 gentext for <tag>index</tag>
8436 punctuation.</para>
8437 <para role="commit-changes">Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert
8438 Stayton</para>
8439 </listitem>
8440 <listitem role="commit-message">
8441 <para>Added parameters to support
8442 localization of <tag>index</tag> item punctuation. Added
8443 <tag>index</tag>.separator named template to compute
8444 the separator punctuation based on
8445 locale.</para>
8446 <para role="commit-changes">Modified: html/autoidx.xsl,1.27 - Robert
8447 Stayton</para>
8448 </listitem>
8449 <listitem role="commit-message">
8450 <para>Added a &lt;div
8451 class="{$class}-contents"&gt; wrapper around output of contents
8452 of all formal objects. Also, added an optional &lt;br
8453 class="{class}-break"/&gt; linebreak after all formal
8454 objects.</para>
8455 <para>WARNING: Because this change places an additional
8456 DIV between the DIV wrapper for the <tag>equation</tag> and the
8457 <tag>equation</tag> contents, it may break some existing CSS
8458 stylesheets that have been created with the assumption that there
8459 would never be an intervening DIV there.</para>
8460 <para>The following is
8461 an example of what <tag>Equation</tag> output looks like as a
8462 result of the changes described above.</para>
8463 <para> &lt;div
8464 class="<tag>equation</tag>"&gt;  &lt;a name="three"
8465 id="three"&gt;&lt;/a&gt;</para>
8466 <para> &lt;p
8467 class="<tag>title</tag>"&gt;&lt;b&gt;(1.3)&lt;/b&gt;&lt;/p&gt;</para>
8468 <para>
8469 &lt;div class="equation-contents"&gt;  &lt;span
8470 class="<tag>mathphrase</tag>"&gt;1+1=3&lt;/span&gt;
8471 &lt;/div&gt;  &lt;/div&gt;&lt;br
8472 class="equation-break"&gt;</para>
8473 <para>Rationale: These changes allow
8474 CSS control of the placement of the formal-object
8475 <tag>title</tag> relative to the formal-object
8476 contents. For example, using the CSS "float" <tag>property</tag>
8477 enables the <tag>title</tag> and contents to be rendered on the
8478 same line. Example stylesheet:</para>
8479 <para> .<tag>equation</tag>
8480 {  margin-top: 20px;  margin-bottom: 20px;  }
8481 .equation-contents {  float: left;  }</para>
8482 <para>
8483 .<tag>equation</tag> .<tag>title</tag> {  margin-top: 0;
8484 float: right;  margin-right: 200px;  }</para>
8485 <para>
8486 .<tag>equation</tag> .<tag>title</tag> b {  font-weight:
8487 normal;  }</para>
8488 <para> .equation-break {  clear: both;
8489 }</para>
8490 <para>Note that the purpose of the ".equation-break" class is
8491 to provide a way to clear off the floats.</para>
8492 <para>If you want
8493 to instead have the <tag>equation</tag> <tag>title</tag> rendered to
8494 the left of the <tag>equation</tag> contents, you can do
8495 something like this:</para>
8496 <para> .<tag>equation</tag> {
8497 margin-top: 20px;  width: 300px;  margin-bottom: 20px;
8498 }  .equation-contents {  float: right;  }</para>
8499 <para>
8500 .<tag>equation</tag> .<tag>title</tag> {  margin-top: 0;
8501 float: left;  margin-right: 200px;  }</para>
8502 <para>
8503 .<tag>equation</tag> .<tag>title</tag> b {  font-weight:
8504 normal;  }</para>
8505 <para> .equation-break {  clear: both;
8506 }</para>
8507 <para role="commit-changes">Modified: html/formal.xsl,1.20 - Michael(tm) Smith</para>
8508 </listitem>
8509 <listitem role="commit-message">
8510 <para>Added a chunker.output.quiet
8511 top-level parameter so that the chunker can be made quiet by
8512 default</para>
8513 <para role="commit-changes">Modified: html/chunker.xsl,1.26 - Norman Walsh</para>
8514 </listitem>
8515 <listitem role="commit-message">
8516 <para>Added support for <tag>link</tag>,
8517 <tag>olink</tag>, and <tag>xref</tag> within OO
8518 <tag>Classsynopsis</tag> and children. (Because DocBook NG/5
8519 allows it).</para>
8520 <para role="commit-changes">Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm)
8521 Smith</para>
8522 </listitem>
8523 <listitem role="commit-message">
8524 <para>New parameter:
8525 <parameter>id.warnings</parameter>. If non-zero, warnings are
8526 generated for titled objects that don't have titles. True by default;
8527 I wonder if this will be too aggressive?</para>
8528 <para role="commit-changes">Modified: html/biblio.xsl,1.25;
8529 html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19;
8530 html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16;
8531 html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22;
8532 html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman
8533 Walsh</para>
8534 </listitem>
8535 <listitem role="commit-message">
8536 <para>If the
8537 <parameter>keep.relative.image.uris</parameter> parameter is true,
8538 don't use the absolute <tag>URI</tag> (as calculated from xml:base) in
8539 the img src attribute, us the value the <tag>author</tag>
8540 specified. Note that we still have to calculate the absolute
8541 <tag>filename</tag> for use in the image intrinsics
8542 extension.</para>
8543 <para role="commit-changes">Modified: html/graphics.xsl,1.56 - Norman
8544 Walsh</para>
8545 </listitem>
8546 <listitem role="commit-message">
8547 <para>Support <tag>date</tag> as an
8548 inline</para>
8549 <para role="commit-changes">Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman
8550 Walsh</para>
8551 </listitem>
8552 <listitem role="commit-message">
8553 <para>Added new parameter
8554 <parameter>keep.relative.image.uris</parameter></para>
8555 <para role="commit-changes">Modified: fo/param.ent,1.91;
8556 fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
8557 params/keep.relative.image.uris.xml,1.1 - Norman
8558 Walsh</para>
8559 </listitem>
8560 <listitem role="commit-message">
8561 <para>Added two new parameters for
8562 handling of multi-term
8563 <tag>varlistentry</tag> elements:</para>
8564 <para><parameter>variablelist.term.break.after</parameter>:
8565 When the <parameter>variablelist.term.break.after</parameter> is
8566 non-zero, it will  generate a line break after each
8567 <tag>term</tag> multi-term
8568 <tag>varlistentry</tag>.</para>
8569 <para><parameter>variablelist.term.separator</parameter>:
8570 When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
8571 elements, the string  specified in the value of the
8572 <parameter>variablelist.term.separator</parameter>  parameter is
8573 placed after each <tag>term</tag> except the last. The default
8574 is ", " (a comma followed by a space). To suppress rendering of
8575 the separator, set the value of
8576 <parameter>variablelist.term.separator</parameter> to  the empty
8577 string ("").</para>
8578 <para>These parameters are primarily intended to be
8579 useful if you have multi-term varlistentries that have long
8580 terms.</para>
8581 <para>Closes #1306676. Thanks to Sam Steingold for
8582 providing an example "lots of long terms" doc that demonstrated
8583 the value of having these options.</para>
8584 <para>Also, added
8585 normalize-space() call to processing of each
8586 <tag>term</tag>.</para>
8587 <para>This change affects all output formats
8588 (HTML, PDF, manpages). The default behavior should pretty much
8589 remain the same as before, but it is possible (as always) that
8590 the change may introduce some
8591 new bugginess.</para>
8592 <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
8593 fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
8594 html/param.xweb,1.93; manpages/lists.xsl,1.22;
8595 manpages/param.ent,1.14; manpages/param.xweb,1.16;
8596 params/variablelist.term.break.after.xml,1.1;
8597 params/variablelist.term.separator.xml,1.1 - Michael(tm)
8598 Smith</para>
8599 </listitem>
8600 <listitem role="commit-message">
8601 <para>Added "wrapper-name" param to
8602 inline.charseq named template, enabling it to output inlines
8603 other than just "span". <tag>Acronym</tag> and <tag>Abbrev</tag>
8604 templates now use inline.charseq to output HTML
8605 "<tag>acronym</tag>" and "abbr" elements (instead of
8606 "span"). Closes #1305468. Thanks to Sam Steingold for suggesting
8607 the change.</para>
8608 <para role="commit-changes">Modified: html/inline.xsl,1.45 - Michael(tm)
8609 Smith</para>
8610 </listitem>
8611 </itemizedlist>
8612 </sect2><!--end of HTML changes for snapshot_2006-05-15_0803-->
8613
8614 <sect2 xml:id="V1700_Manpages">
8615 <title>Manpages</title>
8616 <para>The following changes have been made to the
8617         <filename>manpages</filename> code
8618         since the 1.69.1 release.</para>
8619 <itemizedlist>
8620 <listitem role="commit-message">
8621 <para>Added the following
8622 params:</para>
8623 <para> - man.indent.width (string-valued)  -
8624 man.indent.refsect (boolean)  - man.indent.blurbs (boolean)
8625 - man.indent.lists (boolean)  - man.indent.verbatims
8626 (boolean)</para>
8627 <para>Note that in earlier snapshots, man.indent.width
8628 was named man.indentation.default.value and the boolean params
8629 had names like man.indentation.*.adjust. Also the
8630 man.indent.blurbs param was called man.indentation.authors.adjust
8631 (or something).</para>
8632 <para>The behavior now is: If the value of a
8633 particular man.indent.* boolean param is non-zero, the
8634 corresponding contents (refsect*, list items,
8635 authorblurb/personblurb, vervatims) are displayed with a left
8636 margin indented by a width equal to the value
8637 of man.indent.width.</para>
8638 <para role="commit-changes">Modified: params/man.indent.blurbs.xml,1.1;
8639 manpages/docbook.xsl,1.74; manpages/info.xsl,1.20;
8640 manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
8641 manpages/param.ent,1.22; manpages/param.xweb,1.24;
8642 manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1;
8643 params/man.indent.refsect.xml,1.1;
8644 params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 -
8645 Michael(tm) Smith</para>
8646 </listitem>
8647 <listitem role="commit-message">
8648 <para>Added
8649 man.<tag>table</tag>.footnotes.divider param.</para>
8650 <para>In each
8651 <tag>table</tag> that contains footenotes, the string specified
8652 by the man.<tag>table</tag>.footnotes.divider parameter is output
8653 before the list of footnotes for the
8654 <tag>table</tag>.</para>
8655 <para role="commit-changes">Modified: manpages/docbook.xsl,1.73;
8656 manpages/links.xsl,1.6; manpages/param.ent,1.21;
8657 manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 -
8658 Michael(tm) Smith</para>
8659 </listitem>
8660 <listitem role="commit-message">
8661 <para>Added the
8662 man.output.in.separate.dir,
8663 man.output.<parameter>base.dir</parameter>,
8664 and man.output.subdirs.enabled parameters.</para>
8665 <para>The
8666 man.output.<parameter>base.dir</parameter> parameter specifies the
8667 base directory into which man-page files are
8668 output. The man.output.subdirs.enabled parameter controls whether
8669 the files are output in subdirectories within the base
8670 directory.</para>
8671 <para>The values of the
8672 man.output.<parameter>base.dir</parameter>
8673 and man.output.subdirs.enabled parameters are used only if the
8674 value of man.output.in.separate.dir parameter is non-zero. If the
8675 value of man.output.in.separate.dir is zero, man-page files are
8676 not output in a separate
8677 directory.</para>
8678 <para role="commit-changes">Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20;
8679 manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1;
8680 params/man.output.in.separate.dir.xml,1.1;
8681 params/man.output.subdirs.enabled.xml,1.1 - Michael(tm)
8682 Smith</para>
8683 </listitem>
8684 <listitem role="commit-message">
8685 <para>Added
8686 man.font.<tag>table</tag>.headings and
8687 man.font.<tag>table</tag>.<tag>title</tag> params, for
8688 controlling font in <tag>table</tag> headings and
8689 titles.</para>
8690 <para role="commit-changes">Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19;
8691 manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1;
8692 params/man.font.table.title.xml,1.1 - Michael(tm)
8693 Smith</para>
8694 </listitem>
8695 <listitem role="commit-message">
8696 <para>Added
8697 man.font.<tag>funcsynopsisinfo</tag> and
8698 man.font.<tag>funcprototype</tag> params, for specifying the roff
8699 font (for example, BI, B, I) for <tag>funcsynopsisinfo</tag> and
8700 <tag>funcprototype</tag> output.</para>
8701 <para role="commit-changes">Modified: manpages/block.xsl,1.19;
8702 manpages/docbook.xsl,1.69; manpages/param.ent,1.18;
8703 manpages/param.xweb,1.20; manpages/synop.xsl,1.29;
8704 manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1;
8705 params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm)
8706 Smith</para>
8707 </listitem>
8708 <listitem role="commit-message">
8709 <para>Added
8710 man.<tag>segtitle</tag>.suppress param.</para>
8711 <para>If the value of
8712 man.<tag>segtitle</tag>.suppress is non-zero, then display
8713 of <tag>segtitle</tag> contents is suppressed in
8714 output.</para>
8715 <para role="commit-changes">Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17;
8716 manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 -
8717 Michael(tm) Smith</para>
8718 </listitem>
8719 <listitem role="commit-message">
8720 <para>Added
8721 man.output.<parameter>manifest</parameter>.enabled and
8722 man.output.manifest.<tag>filename</tag> params.</para>
8723 <para>If
8724 man.output.<parameter>manifest</parameter>.enabled is non-zero, a list
8725 of filenames for man pages generated by the stylesheet
8726 transformation is written to the file named by
8727 man.output.<parameter>manifest</parameter>.<tag>filename</tag></para>
8728 <para role="commit-changes">Modified: manpages/docbook.xsl,1.67;
8729 manpages/other.xsl,1.19; manpages/param.ent,1.16;
8730 manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1;
8731 params/man.output.manifest.filename.xml,1.1;
8732 tools/make/Makefile.DocBook,1.4 - Michael(tm)
8733 Smith</para>
8734 </listitem>
8735 <listitem role="commit-message">
8736 <para>Added
8737 <tag>refentry</tag>.meta.get.quietly param.</para>
8738 <para>If zero (the
8739 default), notes and warnings about "missing" markup are generated
8740 during gathering of <tag>refentry</tag> metadata. If
8741 non-zero, the metadata is gathered "quietly" -- that is, the
8742 notes and warnings are suppressed.</para>
8743 <para>NOTE: If you are
8744 processing a large amount of <tag>refentry</tag> content,  you
8745 may be able to speed up processing significantly by  setting a
8746 non-zero value for
8747 <tag>refentry</tag>.meta.get.quietly.</para>
8748 <para role="commit-changes">Modified: common/refentry.xsl,1.17;
8749 manpages/param.ent,1.15; manpages/param.xweb,1.17;
8750 params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
8751 Smith</para>
8752 </listitem>
8753 <listitem role="commit-message">
8754 <para>Changed names of all boolean
8755 indentation params to man.indent.* Also discarded individual
8756 man.indent.*.value params and switched to just using a common
8757 man.indent.width param (3n by default).</para>
8758 <para role="commit-changes">Modified: manpages/docbook.xsl,1.66;
8759 manpages/info.xsl,1.19; manpages/lists.xsl,1.29;
8760 manpages/other.xsl,1.18; manpages/refentry.xsl,1.13 - Michael(tm)
8761 Smith</para>
8762 </listitem>
8763 <listitem role="commit-message">
8764 <para>Added boolean
8765 man.output.in.separate.dir param, to control whether or not man
8766 files are output in separate directory.</para>
8767 <para role="commit-changes">Modified: manpages/docbook.xsl,1.65;
8768 manpages/utility.xsl,1.14 - Michael(tm) Smith</para>
8769 </listitem>
8770 <listitem role="commit-message">
8771 <para>Added options for controlling
8772 indentation of verbatim output. Controlled through the
8773 man.indentation.verbatims.adjust
8774 and man.indentation.verbatims.value params. Closes
8775 #1242997</para>
8776 <para role="commit-changes">Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 -
8777 Michael(tm) Smith</para>
8778 </listitem>
8779 <listitem role="commit-message">
8780 <para>Added options for controlling
8781 indentation in lists and in *blurb output in the AUTHORS
8782 <tag>section</tag>. Controlled through
8783 the man.indentation.lists.adjust,
8784 man.indentation.lists.value, man.indentation.authors.adjust, and
8785 man.indentation.authors.value parameters. Default is 3 characters
8786 (instead of the roff default of 8 characters). Closes
8787 #1449369.</para>
8788 <para>Also, removed the indent that was being set on
8789 <tag>informalexample</tag> outuput. I will instead add an option
8790 for indenting verbatims, which I think is what the
8791 <tag>informalexample</tag> indent was intended
8792 for originally.</para>
8793 <para role="commit-changes">Modified: manpages/block.xsl,1.14;
8794 manpages/docbook.xsl,1.63; manpages/info.xsl,1.18;
8795 manpages/lists.xsl,1.28 - Michael(tm) Smith</para>
8796 </listitem>
8797 <listitem role="commit-message">
8798 <para>Changed line-spacing call before
8799 <tag>synopfragment</tag> to use ".sp -1n" ("n" units specified)
8800 instead of plain ".sp -1"</para>
8801 <para role="commit-changes">Modified: manpages/synop.xsl,1.28 - Michael(tm)
8802 Smith</para>
8803 </listitem>
8804 <listitem role="commit-message">
8805 <para>Added support for writing man
8806 files into a specific output directory and into appropriate
8807 subdirectories within that output directory. Controlled through
8808 the man.<parameter>base.dir</parameter> parameter (similar to the
8809 <parameter>base.dir</parameter> support in the HTML stylesheet) and
8810 the man.subdirs.enabled parameter, which automatically determines
8811 the name of an appropriate subdir (for example, man/man7,
8812 man/man1, etc.) based on the <tag>section</tag> number/manvolnum
8813 of the source <tag>Refentry</tag>.</para>
8814 <para>Closes #1255036 and
8815 #1170317. Thanks to Denis Bradford for the original feature
8816 request, and to Costin Stroie for submitting a patch that was
8817 very helpful in implementing the
8818 support.</para>
8819 <para role="commit-changes">Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 -
8820 Michael(tm) Smith</para>
8821 </listitem>
8822 <listitem role="commit-message">
8823 <para>Refined XPath statements and
8824 notification messages for <tag>refentry</tag> metadata
8825 handling.</para>
8826 <para role="commit-changes">Modified: common/common.xsl,1.59; common/refentry.xsl,1.14;
8827 manpages/docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm)
8828 Smith</para>
8829 </listitem>
8830 <listitem role="commit-message">
8831 <para>Added support for
8832 <tag>copyright</tag> and <tag>legalnotice</tag>. The manpages
8833 stylesheets now output a <tag>COPYRIGHT</tag> <tag>section</tag>,
8834 after the AUTHORS <tag>section</tag>, if a <tag>copyright</tag>
8835 or <tag>legalnotice</tag> is found in the source. The
8836 <tag>section</tag> contains the <tag>copyright</tag> contents followed
8837 by the <tag>legalnotice</tag> contents. Closes
8838 #1450209.</para>
8839 <para role="commit-changes">Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 -
8840 Michael(tm) Smith</para>
8841 </listitem>
8842 <listitem role="commit-message">
8843 <para>Drastically reworked all of the
8844 XPath expressions used in <tag>refentry</tag> metadata gathering
8845 -- completely removed $parentinfo and turned $info into a set of
8846 nodes that includes the *info contents of the <tag>Refentry</tag>
8847 plus the *info contents all all of its ancestor elements. The
8848 basic XPath expression now used throughout is (using the example
8849 of checking for a <tag>date</tag>):</para>
8850 <para>
8851 (($info[//date])[last()]/date)[1].</para>
8852 <para>That selects the "last"
8853 *info/date <tag>date</tag> in document order -- that is, the one
8854 eitther on the <tag>Refentry</tag> itself or on the
8855 closest ancestor to the <tag>Refentry</tag>.</para>
8856 <para>It's
8857 likely this change may break some things; may need to pick up
8858 some pieces later.</para>
8859 <para>Also, changed the default value for the
8860 <parameter>man.th.extra2.max.length</parameter> from 40 to
8861 30.</para>
8862 <para role="commit-changes">Modified: common/common.xsl,1.58; common/refentry.xsl,1.7;
8863 params/man.th.extra2.max.length.xml,1.2;
8864 params/refentry.date.profile.xml,1.2;
8865 params/refentry.manual.profile.xml,1.2;
8866 params/refentry.source.name.profile.xml,1.2;
8867 params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58;
8868 manpages/other.xsl,1.15 - Michael(tm) Smith</para>
8869 </listitem>
8870 <listitem role="commit-message">
8871 <para>Added support for DocBook 5
8872 namespace-stripping in manpages stylesheet. Closes request
8873 #1210692.</para>
8874 <para role="commit-changes">Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 -
8875 Michael(tm) Smith</para>
8876 </listitem>
8877 <listitem role="commit-message">
8878 <para>Fixed handling of <tag>table</tag>
8879 footnotes. With this checkin, the <tag>table</tag> support in the
8880 manpages stylesheet is now basically feature complete. So this
8881 change closes request #619532, "No support for tables" -- the
8882 oldest currently open manpages feature request, submitted by Ben
8883 Secrest (blsecres) on 2002-10-07. Congratulations to me [patting
8884 myself on the back].</para>
8885 <para role="commit-changes">Modified: manpages/block.xsl,1.11;
8886 manpages/docbook.xsl,1.55; manpages/table.xsl,1.15 - Michael(tm)
8887 Smith</para>
8888 </listitem>
8889 <listitem role="commit-message">
8890 <para>Added handling for
8891 <tag>table</tag> titles. Also fixed handling of nested tables;
8892 nest tables are now "extracted" and displayed just after their
8893 parent tables.</para>
8894 <para role="commit-changes">Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14
8895 - Michael(tm) Smith</para>
8896 </listitem>
8897 <listitem role="commit-message">
8898 <para>Added option for turning off bold
8899 formatting in <tag>Funcsynopsis</tag>. Boldface formatting in
8900 <tag>function</tag> <tag>synopsis</tag> is mandated in the
8901 man(7) man page and is used almost universally in existing man
8902 pages. Despite that, it really does look like crap to have an
8903 entire <tag>Funcsynopsis</tag> output in bold, so I added params
8904 for turning off the bold formatting and/or replacing it with a
8905 different roff special font (e.g., "RI" for alternating
8906 roman/italic instead of the default "BI" for alternating
8907 bold/italic). The new params
8908 are "man.<tag>funcprototype</tag>.font" and
8909 "man.<tag>funcsynopsisinfo</tag>.font". To be documented
8910 later.</para>
8911 <para>Closes #1452247. Thanks to Joe Orton for the feature
8912 request.</para>
8913 <para role="commit-changes">Modified: params/man.string.subst.map.xml,1.16;
8914 manpages/block.xsl,1.10; manpages/docbook.xsl,1.51;
8915 manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm)
8916 Smith</para>
8917 </listitem>
8918 <listitem role="commit-message">
8919 <para>Use AUTHORS instead of
8920 <tag>AUTHOR</tag> if we have multiple people to attribute. Also,
8921 fixed checking such that we generate
8922 <tag>author</tag> <tag>section</tag> even if we don't have an
8923 <tag>author</tag> (as long as there is at least one other
8924 person/entity we can put in the
8925 <tag>section</tag>). Also adjusted assembly of content for
8926 <tag>Author</tag> metainfo field such that we now not only use
8927 <tag>author</tag>, but try to find a "best match" if we can't
8928 find an <tag>author</tag> name to put there.</para>
8929 <para>Closes
8930 #1233592. Thanks to Sam Steingold for the
8931 request.</para>
8932 <para role="commit-changes">Modified: manpages/info.xsl,1.12 - Michael(tm)
8933 Smith</para>
8934 </listitem>
8935 <listitem role="commit-message">
8936 <para>Changes for request #1243027,
8937 "Impove handling of <tag>AUTHOR</tag> <tag>section</tag>." This
8938 adds support for <tag>Collab</tag>, Corpauthor, Corpcredt,
8939 <tag>Orgname</tag>, <tag>Publishername</tag>, and
8940 <tag>Publisher</tag>. Also adds support for output
8941 of <tag>Affiliation</tag> and its children, and support for using
8942 gentext strings for auto-attributing roles (<tag>Author</tag>,
8943 <tag>Editor</tag>, <tag>Publisher</tag>, Translator, etc.). Also
8944 did a lot of code cleanup and modularization of all the
8945 <tag>AUTHOR</tag> handling code. And fixed a bug that was causing
8946 <tag>Author</tag> <tag>info</tag> to not be picked up correctly
8947 for metainfo comment we embed in man-page
8948 source.</para>
8949 <para role="commit-changes">Modified: manpages/info.xsl,1.11 - Michael(tm)
8950 Smith</para>
8951 </listitem>
8952 <listitem role="commit-message">
8953 <para>Support bold output for
8954 "<tag>emphasis</tag> remap='B'". (because Eric Raymond's
8955 doclifter(1) tool converts groff source marked up with ".B"
8956 request or "\fB" escapes to DocBook "<tag>emphasis</tag>
8957 remap='B'".)</para>
8958 <para role="commit-changes">Modified: manpages/inline.xsl,1.14 - Michael(tm)
8959 Smith</para>
8960 </listitem>
8961 <listitem role="commit-message">
8962 <para>Added support for
8963 <tag>Segmentedlist</tag>. Details: Output is tabular, with no
8964 option for "list" type output. Output for <tag>Segtitle</tag>
8965 elements can be supressed by
8966 setting man.<tag>segtitle</tag>.suppress. If <tag>Segtitle</tag>
8967 content is output, it is rendered in italic type (not bold
8968 because not all terminals support bold and so italic ensures the
8969 stand out on those terminals). Extra space (.sp line) at end of
8970 <tag>table</tag> code ensures that it gets handled correctly in
8971 the case where its source is the child of a <tag>Para</tag>.
8972 Closes feature-request #1400097. Thanks to Daniel Leidert for the
8973 patch and push, and to Alastair Rankine for filing the original
8974 feature request.</para>
8975 <para role="commit-changes">Modified: manpages/lists.xsl,1.23;
8976 manpages/utility.xsl,1.10 - Michael(tm) Smith</para>
8977 </listitem>
8978 <listitem role="commit-message">
8979 <para>Improved handling or
8980 Author/Editor/Othercredit.</para>
8981 <para>Reworked content of
8982 (non-visible) comment added at top of each page (metadata
8983 stuff).</para>
8984 <para>Added support for generating a
8985 <parameter>manifest</parameter> file (useful for cleaning up
8986 after builds, etc.)</para>
8987 <para role="commit-changes">Modified: manpages/docbook.xsl,1.46;
8988 manpages/info.xsl,1.9; manpages/other.xsl,1.12;
8989 manpages/utility.xsl,1.6 - Michael(tm) Smith</para>
8990 </listitem>
8991 <listitem role="commit-message">
8992 <para>Added two new parameters for
8993 handling of multi-term
8994 <tag>varlistentry</tag> elements:</para>
8995 <para><parameter>variablelist.term.break.after</parameter>:
8996 When the <parameter>variablelist.term.break.after</parameter> is
8997 non-zero, it will  generate a line break after each
8998 <tag>term</tag> multi-term
8999 <tag>varlistentry</tag>.</para>
9000 <para><parameter>variablelist.term.separator</parameter>:
9001 When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
9002 elements, the string  specified in the value of the
9003 <parameter>variablelist.term.separator</parameter>  parameter is
9004 placed after each <tag>term</tag> except the last. The default
9005 is ", " (a comma followed by a space). To suppress rendering of
9006 the separator, set the value of
9007 <parameter>variablelist.term.separator</parameter> to  the empty
9008 string ("").</para>
9009 <para>These parameters are primarily intended to be
9010 useful if you have multi-term varlistentries that have long
9011 terms.</para>
9012 <para>Closes #1306676. Thanks to Sam Steingold for
9013 providing an example "lots of long terms" doc that demonstrated
9014 the value of having these options.</para>
9015 <para>Also, added
9016 normalize-space() call to processing of each
9017 <tag>term</tag>.</para>
9018 <para>This change affects all output formats
9019 (HTML, PDF, manpages). The default behavior should pretty much
9020 remain the same as before, but it is possible (as always) that
9021 the change may introduce some
9022 new bugginess.</para>
9023 <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
9024 fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
9025 html/param.xweb,1.93; manpages/lists.xsl,1.22;
9026 manpages/param.ent,1.14; manpages/param.xweb,1.16;
9027 params/variablelist.term.break.after.xml,1.1;
9028 params/variablelist.term.separator.xml,1.1 - Michael(tm)
9029 Smith</para>
9030 </listitem>
9031 </itemizedlist>
9032 </sect2><!--end of Manpages changes for snapshot_2006-05-15_0803-->
9033
9034 <sect2 xml:id="V1700_Params">
9035 <title>Params</title>
9036 <para>The following changes have been made to the
9037         <filename>params</filename> code
9038         since the 1.69.1 release.</para>
9039 <itemizedlist>
9040 <listitem role="commit-message">
9041 <para>New parameters to set
9042 header/footer <tag>table</tag> minimum
9043 height.</para>
9044 <para role="commit-changes">Modified: params/footer.table.height.xml,1.1;
9045 params/header.table.height.xml,1.1 - Robert
9046 Stayton</para>
9047 </listitem>
9048 <listitem role="commit-message">
9049 <para>Support multiple indexing methods
9050 for different languages.</para>
9051 <para role="commit-changes">Modified: params/index.method.xml,1.1 - Robert
9052 Stayton</para>
9053 </listitem>
9054 <listitem role="commit-message">
9055 <para>Remove <tag>qandaset</tag> and
9056 <tag>qandadiv</tag> from <parameter>generate.toc</parameter> for fo
9057 output because formerly it wasn't working, but now it is and
9058 the default behavior should stay the
9059 same.</para>
9060 <para role="commit-changes">Modified: params/generate.toc.xml,1.8 - Robert
9061 Stayton</para>
9062 </listitem>
9063 <listitem role="commit-message">
9064 <para>add support for page number
9065 references to <tag>link</tag> element
9066 too.</para>
9067 <para role="commit-changes">Modified: params/insert.link.page.number.xml,1.1 - Robert
9068 Stayton</para>
9069 </listitem>
9070 <listitem role="commit-message">
9071 <para>Add support for more characters to
9072 hyphen on when <parameter>ulink.hyphenate</parameter> is turned
9073 on.</para>
9074 <para role="commit-changes">Modified: params/ulink.hyphenate.chars.xml,1.1;
9075 params/ulink.hyphenate.xml,1.3 - Robert Stayton</para>
9076 </listitem>
9077 <listitem role="commit-message">
9078 <para>New attribute-set to format
9079 <tag>biblioentry</tag> and
9080 <tag>bibliomixed</tag>.</para>
9081 <para role="commit-changes">Modified: params/biblioentry.properties.xml,1.1 -
9082 Robert Stayton</para>
9083 </listitem>
9084 <listitem role="commit-message">
9085 <para>Added new parameter
9086 <parameter>chunk.tocs.and.lots</parameter>.has.<tag>title</tag> which
9087 controls presence of <tag>title</tag> in a separate chunk with
9088 ToC/LoT. Disabling <tag>title</tag> can be very useful if you are
9089 generating frameset output (well, yes those frames, but some customers
9090 really want them ;-).</para>
9091 <para role="commit-changes">Modified: html/chunk-code.xsl,1.15;
9092 html/param.ent,1.93; html/param.xweb,1.102;
9093 params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
9094 Kosek</para>
9095 </listitem>
9096 <listitem role="commit-message">
9097 <para>Added new attribute set
9098 <tag>toc</tag>.line.properties for controlling appearance of lines in
9099 ToC/LoT</para>
9100 <para role="commit-changes">Modified: params/toc.line.properties.xml,1.1 - Jirka
9101 Kosek</para>
9102 </listitem>
9103 <listitem role="commit-message">
9104 <para>Allow <tag>table</tag> footnotes
9105 to have different properties from regular
9106 footnotes.</para>
9107 <para role="commit-changes">Modified: params/table.footnote.properties.xml,1.1 - Robert
9108 Stayton</para>
9109 </listitem>
9110 <listitem role="commit-message">
9111 <para>Set properties for pgwide="1"
9112 objects.</para>
9113 <para role="commit-changes">Modified: params/pgwide.properties.xml,1.1 - Robert
9114 Stayton</para>
9115 </listitem>
9116 <listitem role="commit-message">
9117 <para>Added the
9118 autotoc.<tag>label</tag>.in.hyperlink param.</para>
9119 <para>If the value
9120 of autotoc.<tag>label</tag>.in.hyperlink is non-zero, labels
9121 are included in hyperlinked titles in the <tag>TOC</tag>. If it
9122 is instead zero, labels are still displayed prior to the
9123 hyperlinked titles, but are not hyperlinked along with the
9124 titles.</para>
9125 <para>Closes patch #1065868. Thanks to anatoly techtonik
9126 for the patch.</para>
9127 <para role="commit-changes">Modified: html/autotoc.xsl,1.36; html/param.ent,1.92;
9128 html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 -
9129 Michael(tm) Smith</para>
9130 </listitem>
9131 <listitem role="commit-message">
9132 <para>Added two new params:
9133 html.head.<tag>legalnotice</tag>.<tag>link</tag>.types
9134 and html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple.</para>
9135 <para>If
9136 the value of the <parameter>generate.legalnotice.link</parameter> is
9137 non-zero, then the stylesheet generates (in the head
9138 <tag>section</tag> of the HTML source) either a single HTML
9139 <tag>link</tag> element or, if the value of
9140 the html.head.<tag>legalnotice</tag>.<tag>link</tag>.multiple is
9141 non-zero, one <tag>link</tag> element for each <tag>link</tag>
9142 type specified. Each <tag>link</tag> has the
9143 following attributes:</para>
9144 <para> - a rel attribute whose value
9145 is derived from the value of
9146 html.head.<tag>legalnotice</tag>.<tag>link</tag>.types</para>
9147 <para> -
9148 an href attribute whose value is set to the URL of the file
9149 containing the <tag>legalnotice</tag></para>
9150 <para> - a <tag>title</tag>
9151 attribute whose value is set to the <tag>title</tag> of the
9152 corresponding <tag>legalnotice</tag> (or a <tag>title</tag>
9153 programatically  determined by the stylesheet)</para>
9154 <para>For
9155 example:</para>
9156 <para> &lt;<tag>link</tag> rel="<tag>copyright</tag>"
9157 href="ln-id2524073.html" title="Legal Notice"&gt;</para>
9158 <para>Closes
9159 #1476450. Thanks to Sam Steingold.</para>
9160 <para role="commit-changes">Modified: html/chunk-common.xsl,1.45;
9161 html/param.ent,1.91; html/param.xweb,1.100;
9162 params/generate.legalnotice.link.xml,1.4;
9163 params/html.head.legalnotice.link.multiple.xml,1.1;
9164 params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm)
9165 Smith</para>
9166 </listitem>
9167 <listitem role="commit-message">
9168 <para>Added the following
9169 params:</para>
9170 <para> - man.indent.width (string-valued)  -
9171 man.indent.refsect (boolean)  - man.indent.blurbs (boolean)
9172 - man.indent.lists (boolean)  - man.indent.verbatims
9173 (boolean)</para>
9174 <para>Note that in earlier snapshots, man.indent.width
9175 was named man.indentation.default.value and the boolean params
9176 had names like man.indentation.*.adjust. Also the
9177 man.indent.blurbs param was called man.indentation.authors.adjust
9178 (or something).</para>
9179 <para>The behavior now is: If the value of a
9180 particular man.indent.* boolean param is non-zero, the
9181 corresponding contents (refsect*, list items,
9182 authorblurb/personblurb, vervatims) are displayed with a left
9183 margin indented by a width equal to the value
9184 of man.indent.width.</para>
9185 <para role="commit-changes">Modified: params/man.indent.blurbs.xml,1.1;
9186 manpages/docbook.xsl,1.74; manpages/info.xsl,1.20;
9187 manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
9188 manpages/param.ent,1.22; manpages/param.xweb,1.24;
9189 manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1;
9190 params/man.indent.refsect.xml,1.1;
9191 params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 -
9192 Michael(tm) Smith</para>
9193 </listitem>
9194 <listitem role="commit-message">
9195 <para>Added
9196 man.<tag>table</tag>.footnotes.divider param.</para>
9197 <para>In each
9198 <tag>table</tag> that contains footenotes, the string specified
9199 by the man.<tag>table</tag>.footnotes.divider parameter is output
9200 before the list of footnotes for the
9201 <tag>table</tag>.</para>
9202 <para role="commit-changes">Modified: manpages/docbook.xsl,1.73;
9203 manpages/links.xsl,1.6; manpages/param.ent,1.21;
9204 manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 -
9205 Michael(tm) Smith</para>
9206 </listitem>
9207 <listitem role="commit-message">
9208 <para>Added the
9209 man.output.in.separate.dir,
9210 man.output.<parameter>base.dir</parameter>,
9211 and man.output.subdirs.enabled parameters.</para>
9212 <para>The
9213 man.output.<parameter>base.dir</parameter> parameter specifies the
9214 base directory into which man-page files are
9215 output. The man.output.subdirs.enabled parameter controls whether
9216 the files are output in subdirectories within the base
9217 directory.</para>
9218 <para>The values of the
9219 man.output.<parameter>base.dir</parameter>
9220 and man.output.subdirs.enabled parameters are used only if the
9221 value of man.output.in.separate.dir parameter is non-zero. If the
9222 value of man.output.in.separate.dir is zero, man-page files are
9223 not output in a separate
9224 directory.</para>
9225 <para role="commit-changes">Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20;
9226 manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1;
9227 params/man.output.in.separate.dir.xml,1.1;
9228 params/man.output.subdirs.enabled.xml,1.1 - Michael(tm)
9229 Smith</para>
9230 </listitem>
9231 <listitem role="commit-message">
9232 <para>Added
9233 man.font.<tag>table</tag>.headings and
9234 man.font.<tag>table</tag>.<tag>title</tag> params, for
9235 controlling font in <tag>table</tag> headings and
9236 titles.</para>
9237 <para role="commit-changes">Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19;
9238 manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1;
9239 params/man.font.table.title.xml,1.1 - Michael(tm)
9240 Smith</para>
9241 </listitem>
9242 <listitem role="commit-message">
9243 <para>Added
9244 man.font.<tag>funcsynopsisinfo</tag> and
9245 man.font.<tag>funcprototype</tag> params, for specifying the roff
9246 font (for example, BI, B, I) for <tag>funcsynopsisinfo</tag> and
9247 <tag>funcprototype</tag> output.</para>
9248 <para role="commit-changes">Modified: manpages/block.xsl,1.19;
9249 manpages/docbook.xsl,1.69; manpages/param.ent,1.18;
9250 manpages/param.xweb,1.20; manpages/synop.xsl,1.29;
9251 manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1;
9252 params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm)
9253 Smith</para>
9254 </listitem>
9255 <listitem role="commit-message">
9256 <para>Changed to select="0" in
9257 <tag>refclass</tag>.suppress (instead of
9258 ..&gt;0&lt;/..)</para>
9259 <para role="commit-changes">Modified: params/refclass.suppress.xml,1.3 - Michael(tm)
9260 Smith</para>
9261 </listitem>
9262 <listitem role="commit-message">
9263 <para>Added
9264 man.<tag>segtitle</tag>.suppress param.</para>
9265 <para>If the value of
9266 man.<tag>segtitle</tag>.suppress is non-zero, then display
9267 of <tag>segtitle</tag> contents is suppressed in
9268 output.</para>
9269 <para role="commit-changes">Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17;
9270 manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 -
9271 Michael(tm) Smith</para>
9272 </listitem>
9273 <listitem role="commit-message">
9274 <para>Added
9275 man.output.<parameter>manifest</parameter>.enabled and
9276 man.output.manifest.<tag>filename</tag> params.</para>
9277 <para>If
9278 man.output.<parameter>manifest</parameter>.enabled is non-zero, a list
9279 of filenames for man pages generated by the stylesheet
9280 transformation is written to the file named by
9281 man.output.<parameter>manifest</parameter>.<tag>filename</tag></para>
9282 <para role="commit-changes">Modified: manpages/docbook.xsl,1.67;
9283 manpages/other.xsl,1.19; manpages/param.ent,1.16;
9284 manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1;
9285 params/man.output.manifest.filename.xml,1.1;
9286 tools/make/Makefile.DocBook,1.4 - Michael(tm)
9287 Smith</para>
9288 </listitem>
9289 <listitem role="commit-message">
9290 <para>Added <tag>refclass</tag>.suppress
9291 param.</para>
9292 <para>If the value of <tag>refclass</tag>.suppress is
9293 non-zero, then display <tag>refclass</tag> contents is suppressed
9294 in output. Affects HTML and FO output
9295 only.</para>
9296 <para role="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90;
9297 html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm)
9298 Smith</para>
9299 </listitem>
9300 <listitem role="commit-message">
9301 <para>Added
9302 <tag>refentry</tag>.meta.get.quietly param.</para>
9303 <para>If zero (the
9304 default), notes and warnings about "missing" markup are generated
9305 during gathering of <tag>refentry</tag> metadata. If
9306 non-zero, the metadata is gathered "quietly" -- that is, the
9307 notes and warnings are suppressed.</para>
9308 <para>NOTE: If you are
9309 processing a large amount of <tag>refentry</tag> content,  you
9310 may be able to speed up processing significantly by  setting a
9311 non-zero value for
9312 <tag>refentry</tag>.meta.get.quietly.</para>
9313 <para role="commit-changes">Modified: common/refentry.xsl,1.17;
9314 manpages/param.ent,1.15; manpages/param.xweb,1.17;
9315 params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
9316 Smith</para>
9317 </listitem>
9318 <listitem role="commit-message">
9319 <para>Added support for "software" and
9320 "sectdesc" class values on <tag>refmiscinfo</tag>; "software" is
9321 treated identically to "source", and "setdesc" is treated
9322 identically to "manual".</para>
9323 <para role="commit-changes">Modified: common/refentry.xsl,1.10;
9324 params/man.th.extra2.max.length.xml,1.3;
9325 params/refentry.source.name.profile.xml,1.4 - Michael(tm)
9326 Smith</para>
9327 </listitem>
9328 <listitem role="commit-message">
9329 <para>Drastically reworked all of the
9330 XPath expressions used in <tag>refentry</tag> metadata gathering
9331 -- completely removed $parentinfo and turned $info into a set of
9332 nodes that includes the *info contents of the <tag>Refentry</tag>
9333 plus the *info contents all all of its ancestor elements. The
9334 basic XPath expression now used throughout is (using the example
9335 of checking for a <tag>date</tag>):</para>
9336 <para>
9337 (($info[//date])[last()]/date)[1].</para>
9338 <para>That selects the "last"
9339 *info/date <tag>date</tag> in document order -- that is, the one
9340 eitther on the <tag>Refentry</tag> itself or on the
9341 closest ancestor to the <tag>Refentry</tag>.</para>
9342 <para>It's
9343 likely this change may break some things; may need to pick up
9344 some pieces later.</para>
9345 <para>Also, changed the default value for the
9346 <parameter>man.th.extra2.max.length</parameter> from 40 to
9347 30.</para>
9348 <para role="commit-changes">Modified: common/common.xsl,1.58; common/refentry.xsl,1.7;
9349 params/man.th.extra2.max.length.xml,1.2;
9350 params/refentry.date.profile.xml,1.2;
9351 params/refentry.manual.profile.xml,1.2;
9352 params/refentry.source.name.profile.xml,1.2;
9353 params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58;
9354 manpages/other.xsl,1.15 - Michael(tm) Smith</para>
9355 </listitem>
9356 <listitem role="commit-message">
9357 <para>Added option for turning off bold
9358 formatting in <tag>Funcsynopsis</tag>. Boldface formatting in
9359 <tag>function</tag> <tag>synopsis</tag> is mandated in the
9360 man(7) man page and is used almost universally in existing man
9361 pages. Despite that, it really does look like crap to have an
9362 entire <tag>Funcsynopsis</tag> output in bold, so I added params
9363 for turning off the bold formatting and/or replacing it with a
9364 different roff special font (e.g., "RI" for alternating
9365 roman/italic instead of the default "BI" for alternating
9366 bold/italic). The new params
9367 are "man.<tag>funcprototype</tag>.font" and
9368 "man.<tag>funcsynopsisinfo</tag>.font". To be documented
9369 later.</para>
9370 <para>Closes #1452247. Thanks to Joe Orton for the feature
9371 request.</para>
9372 <para role="commit-changes">Modified: params/man.string.subst.map.xml,1.16;
9373 manpages/block.xsl,1.10; manpages/docbook.xsl,1.51;
9374 manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm)
9375 Smith</para>
9376 </listitem>
9377 <listitem role="commit-message">
9378 <para><parameter>fop.extensions</parameter> now only
9379 for FOP version 0.20.5 and earlier.</para>
9380 <para role="commit-changes">Modified: params/fop.extensions.xml,1.4
9381 - Robert Stayton</para>
9382 </listitem>
9383 <listitem role="commit-message">
9384 <para>Support for fop1 different from
9385 fop 0.20.5 and earlier.</para>
9386 <para role="commit-changes">Modified: params/fop1.extensions.xml,1.1 - Robert
9387 Stayton</para>
9388 </listitem>
9389 <listitem role="commit-message">
9390 <para>Reset default value to empty
9391 string so template uses gentext first, then the parameter value
9392 if not empty.</para>
9393 <para role="commit-changes">Modified: params/index.number.separator.xml,1.2;
9394 params/index.range.separator.xml,1.2;
9395 params/index.term.separator.xml,1.2 - Robert
9396 Stayton</para>
9397 </listitem>
9398 <listitem role="commit-message">
9399 <para>New parameter:
9400 <parameter>id.warnings</parameter>. If non-zero, warnings are
9401 generated for titled objects that don't have titles. True by default;
9402 I wonder if this will be too aggressive?</para>
9403 <para role="commit-changes">Modified: html/biblio.xsl,1.25;
9404 html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19;
9405 html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16;
9406 html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22;
9407 html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman
9408 Walsh</para>
9409 </listitem>
9410 <listitem role="commit-message">
9411 <para>Added new parameter
9412 <parameter>keep.relative.image.uris</parameter></para>
9413 <para role="commit-changes">Modified: fo/param.ent,1.91;
9414 fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96;
9415 params/keep.relative.image.uris.xml,1.1 - Norman
9416 Walsh</para>
9417 </listitem>
9418 <listitem role="commit-message">
9419 <para>Support default <tag>label</tag>
9420 width parameters for itemized and ordered lists</para>
9421 <para role="commit-changes">Modified: fo/lists.xsl,1.64;
9422 fo/param.ent,1.90; fo/param.xweb,1.103;
9423 params/itemizedlist.label.width.xml,1.1;
9424 params/orderedlist.label.width.xml,1.1 - Norman
9425 Walsh</para>
9426 </listitem>
9427 <listitem role="commit-message">
9428 <para>Added parameters to localize
9429 punctuation in indexes.</para>
9430 <para role="commit-changes">Modified: params/index.number.separator.xml,1.1;
9431 params/index.range.separator.xml,1.1;
9432 params/index.term.separator.xml,1.1 - Robert
9433 Stayton</para>
9434 </listitem>
9435 <listitem role="commit-message">
9436 <para>Added two new parameters for
9437 handling of multi-term
9438 <tag>varlistentry</tag> elements:</para>
9439 <para><parameter>variablelist.term.break.after</parameter>:
9440 When the <parameter>variablelist.term.break.after</parameter> is
9441 non-zero, it will  generate a line break after each
9442 <tag>term</tag> multi-term
9443 <tag>varlistentry</tag>.</para>
9444 <para><parameter>variablelist.term.separator</parameter>:
9445 When a <tag>varlistentry</tag> contains multiple <tag>term</tag>
9446 elements, the string  specified in the value of the
9447 <parameter>variablelist.term.separator</parameter>  parameter is
9448 placed after each <tag>term</tag> except the last. The default
9449 is ", " (a comma followed by a space). To suppress rendering of
9450 the separator, set the value of
9451 <parameter>variablelist.term.separator</parameter> to  the empty
9452 string ("").</para>
9453 <para>These parameters are primarily intended to be
9454 useful if you have multi-term varlistentries that have long
9455 terms.</para>
9456 <para>Closes #1306676. Thanks to Sam Steingold for
9457 providing an example "lots of long terms" doc that demonstrated
9458 the value of having these options.</para>
9459 <para>Also, added
9460 normalize-space() call to processing of each
9461 <tag>term</tag>.</para>
9462 <para>This change affects all output formats
9463 (HTML, PDF, manpages). The default behavior should pretty much
9464 remain the same as before, but it is possible (as always) that
9465 the change may introduce some
9466 new bugginess.</para>
9467 <para role="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88;
9468 fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86;
9469 html/param.xweb,1.93; manpages/lists.xsl,1.22;
9470 manpages/param.ent,1.14; manpages/param.xweb,1.16;
9471 params/variablelist.term.break.after.xml,1.1;
9472 params/variablelist.term.separator.xml,1.1 - Michael(tm)
9473 Smith</para>
9474 </listitem>
9475 <listitem role="commit-message">
9476 <para>Convert 'no' to string in default
9477 value.</para>
9478 <para role="commit-changes">Modified: params/olink.doctitle.xml,1.4 - Robert
9479 Stayton</para>
9480 </listitem>
9481 <listitem role="commit-message">
9482 <para>Implemented RFE
9483 #1292615.</para>
9484 <para>Added bunch of new parameters (attribute sets)
9485 that affect list presentation: list.block.properties,
9486 <tag>itemizedlist</tag>.properties, <tag>orderedlist</tag>.properties,
9487 <tag>itemizedlist</tag>.<tag>label</tag>.properties and
9488 <tag>orderedlist</tag>.<tag>label</tag>.properties. Default behaviour
9489 of stylesheets has not been changed but further customizations will be
9490 much more easier.</para>
9491 <para role="commit-changes">Modified: fo/lists.xsl,1.61; fo/param.ent,1.87;
9492 fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1;
9493 params/itemizedlist.properties.xml,1.1;
9494 params/list.block.properties.xml,1.1;
9495 params/orderedlist.label.properties.xml,1.1;
9496 params/orderedlist.properties.xml,1.1 - Jirka
9497 Kosek</para>
9498 </listitem>
9499 <listitem role="commit-message">
9500 <para>Implemented RFE
9501 #1242092.</para>
9502 <para>You can enable crop marks in your document by
9503 setting crop.marks=1 and xep.extensions=1. Appearance of crop
9504 marks can be controlled by parameters
9505 <parameter>crop.mark.bleed</parameter> (6pt),
9506 <parameter>crop.mark.offset</parameter> (24pt) and
9507 <parameter>crop.mark.width</parameter> (0.5pt).</para>
9508 <para>Also there
9509 is new named template called user-xep-pis. You can overwrite it in
9510 order to produce some PIs that can control XEP as described in
9511 http://www.renderx.com/reference.html#Output_Formats</para>
9512 <para role="commit-changes">Modified: fo/docbook.xsl,1.36;
9513 fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23;
9514 params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1;
9515 params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka
9516 Kosek</para>
9517 </listitem>
9518 <listitem role="commit-message">
9519 <para>Changed short descriptions in doc
9520 for *autolabel* params to match new autolabel
9521 behavior.</para>
9522 <para role="commit-changes">Modified: params/appendix.autolabel.xml,1.5;
9523 params/chapter.autolabel.xml,1.4; params/part.autolabel.xml,1.5;
9524 params/preface.autolabel.xml,1.4 - Michael(tm)
9525 Smith</para>
9526 </listitem>
9527 </itemizedlist>
9528 </sect2><!--end of Params changes for snapshot_2006-05-15_0803-->
9529
9530 <sect2 xml:id="V1700_Profiling">
9531 <title>Profiling</title>
9532 <para>The following changes have been made to the
9533         <filename>profiling</filename> code
9534         since the 1.69.1 release.</para>
9535 <itemizedlist>
9536 <listitem role="commit-message">
9537 <para>Profiling now works together with
9538 namespace stripping (V5 documents). Namespace striping should work
9539 with all stylesheets named profile-, even if they are not supporting
9540 namespace stripping in a non-profiling
9541 variant.</para>
9542 <para role="commit-changes">Modified: profiling/profile-mode.xsl,1.4;
9543 profiling/xsl2profile.xsl,1.7 - Jirka Kosek</para>
9544 </listitem>
9545 <listitem role="commit-message">
9546 <para>Moved profiling stage out of
9547 templates. This make possible to reuse profiled content by several
9548 templates and still maintaing node indentity (needed for example for
9549 HTML Help where content is processed multiple times).</para>
9550 <para>I
9551 don't know why this was not on the top level before. Maybe some XSLT
9552 processors choked on it. I hope this will be OK
9553 now.</para>
9554 <para role="commit-changes">Modified: profiling/xsl2profile.xsl,1.5 - Jirka
9555 Kosek</para>
9556 </listitem>
9557 </itemizedlist>
9558 </sect2><!--end of Profiling changes for snapshot_2006-05-15_0803-->
9559
9560 <sect2 xml:id="V1700_Tools">
9561 <title>Tools</title>
9562 <para>The following changes have been made to the
9563         <filename>tools</filename> code
9564         since the 1.69.1 release.</para>
9565 <itemizedlist>
9566 <listitem role="commit-message">
9567 <para>Moved Makefile.DocBook from
9568 <tag>contrib</tag> module to xsl
9569 module.</para>
9570 <para role="commit-changes">Modified: tools/make/Makefile.DocBook,1.1 - Michael(tm)
9571 Smith</para>
9572 </listitem>
9573 </itemizedlist>
9574 </sect2><!--end of Tools changes for snapshot_2006-05-15_0803-->
9575
9576 <sect2 xml:id="V1700_WordML">
9577 <title>WordML</title>
9578 <para>The following changes have been made to the
9579         <filename>wordml</filename> code
9580         since the 1.69.1 release.</para>
9581 <itemizedlist>
9582 <listitem role="commit-message">
9583 <para>added <tag>contrib</tag> element,
9584 better handling of default paragraph
9585 style</para>
9586 <para role="commit-changes">Modified: wordml/pages-normalise.xsl,1.6; wordml/supported.xml,1.2;
9587 wordml/wordml-final.xsl,1.14 - Steve Ball</para>
9588 </listitem>
9589 <listitem role="commit-message">
9590 <para>added
9591 <tag>bridgehead</tag></para>
9592 <para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.6;
9593 wordml/docbook.xsl,1.17; wordml/pages-normalise.xsl,1.5;
9594 wordml/template-pages.xml,1.7; wordml/template.dot,1.4;
9595 wordml/template.xml,1.14; wordml/wordml-final.xsl,1.13 - Steve
9596 Ball</para>
9597 </listitem>
9598 <listitem role="commit-message">
9599 <para>added blocks stylesheet to support
9600 bibliographies, glossaries and qandasets</para>
9601 <para role="commit-changes">Modified: wordml/Makefile,1.4;
9602 wordml/README,1.3; wordml/blocks-spec.xml,1.1;
9603 wordml/docbook-pages.xsl,1.5; wordml/docbook.xsl,1.16;
9604 wordml/pages-normalise.xsl,1.4; wordml/sections-spec.xml,1.3;
9605 wordml/specifications.xml,1.13; wordml/template-pages.xml,1.6;
9606 wordml/template.dot,1.3; wordml/template.xml,1.13;
9607 wordml/wordml-blocks.xsl,1.1; wordml/wordml-final.xsl,1.12;
9608 wordml/wordml-sections.xsl,1.3 - Steve Ball</para>
9609 </listitem>
9610 <listitem role="commit-message">
9611 <para>added <tag>mediaobject</tag>
9612 <tag>caption</tag></para>
9613 <para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.4;
9614 wordml/docbook.xsl,1.15; wordml/specifications.xml,1.12;
9615 wordml/template-pages.xml,1.5; wordml/template.dot,1.2;
9616 wordml/template.xml,1.12; wordml/wordml-final.xsl,1.11 - Steve
9617 Ball</para>
9618 </listitem>
9619 <listitem role="commit-message">
9620 <para>added
9621 callouts</para>
9622 <para role="commit-changes">Modified: wordml/docbook-pages.xsl,1.3; wordml/docbook.xsl,1.14;
9623 wordml/pages-normalise.xsl,1.3; wordml/specifications.xml,1.11;
9624 wordml/template-pages.xml,1.4; wordml/wordml-final.xsl,1.10 - Steve
9625 Ball</para>
9626 </listitem>
9627 <listitem role="commit-message">
9628 <para>added Word template
9629 file</para>
9630 <para role="commit-changes">Modified: wordml/template.dot,1.1 - Steve Ball</para>
9631 </listitem>
9632 <listitem role="commit-message">
9633 <para>added <tag>abstract</tag>, fixed
9634 <tag>itemizedlist</tag>, ulink</para>
9635 <para role="commit-changes">Modified: wordml/specifications.xml,1.10;
9636 wordml/wordml-final.xsl,1.9 - Steve Ball</para>
9637 </listitem>
9638 <listitem role="commit-message">
9639 <para>fixed Makefile added many
9640 features to Pages support added <tag>revhistory</tag>, inlines,
9641 highlights, <tag>abstract</tag></para>
9642 <para role="commit-changes">Modified: wordml/Makefile,1.2;
9643 wordml/docbook-pages.xsl,1.2; wordml/pages-normalise.xsl,1.2;
9644 wordml/sections-spec.xml,1.2; wordml/specifications.xml,1.9;
9645 wordml/template-pages.xml,1.3; wordml/template.xml,1.11;
9646 wordml/wordml-final.xsl,1.8; wordml/wordml-sections.xsl,1.2 - Steve
9647 Ball</para>
9648 </listitem>
9649 <listitem role="commit-message">
9650 <para>fixed handling linebreaks when
9651 generating WordML added Apple Pages
9652 support</para>
9653 <para role="commit-changes">Modified: wordml/docbook.xsl,1.13; wordml/template-pages.xml,1.2 -
9654 Steve Ball</para>
9655 </listitem>
9656 </itemizedlist>
9657 </sect2><!--end of WordML changes for snapshot_2006-05-15_0803-->
9658 </sect1>
9659
9660   <sect1 xml:id="V1691">
9661     <title>Release 1.69.1</title>
9662     <para>This release is a minor bug-fix update to the 1.69.0
9663     release. Along with bug fixes, it includes one
9664     configuration-parameter change: The default value of the
9665     <parameter>annotation.support</parameter> parameter is now
9666     <literal>0</literal> (off). The reason for that change is that
9667     there have been reports that <tag>annotation</tag> handling is
9668     causing a significant performance degradation in processing of
9669     large documents with <command>xsltproc</command>.</para>
9670   </sect1>
9671   <!-- end of notes for 1.69.1 release -->
9672
9673   <sect1 xml:id="V1690">
9674     <title>Release 1.69.0</title>
9675     <para>The release includes major feature changes,
9676     particularly in the <link linkend="V1690_MAN">manpages
9677     stylesheets</link>, as well as a large number of bug fixes.</para>
9678
9679     <para>As with all DocBook Project <quote>dot zero</quote> releases, this is an
9680     <link linkend="dot0">experimental release </link>.</para>
9681
9682     <sect2 xml:id="V1690_COMMON">
9683       <title>Common</title>
9684       <itemizedlist>
9685         <listitem>
9686           <para>This release adds localizations for the following
9687           languages:
9688             <simplelist type="inline">
9689               <?dbchoice choice="and"?>
9690               <member>Albanian</member>
9691               <member>Amharic</member>
9692               <member>Azerbaijani</member>
9693               <member>Hindi</member>
9694               <member>Irish (Gaelic)</member>
9695               <member>Gujarati</member>
9696               <member>Kannada</member>
9697               <member>Mongolian</member>
9698               <member>Oriya</member>
9699               <member>Punjabi</member>
9700               <member>Tagalog</member>
9701               <member>Tamil</member>
9702               <member>Welsh</member>
9703           </simplelist>.</para>
9704         </listitem>
9705         <listitem>
9706           <para>Added support for specifying number format for auto
9707           labels for <tag>chapter</tag>, <tag>appendix</tag>,
9708           <tag>part</tag>, and <tag>preface</tag>. Contolled with the
9709           <parameter>appendix.autolabel</parameter>,
9710           <parameter>chapter.autolabel</parameter>,
9711           <parameter>part.autolabel</parameter>, and
9712           <parameter>preface.autolabel</parameter> parameters.</para>
9713         </listitem>
9714         <listitem>
9715           <para>Added basic support for <tag>biblioref</tag> cross
9716           referencing.</para>
9717         </listitem>
9718         <listitem>
9719           <para>Added support for <tag class="attribute">align</tag>
9720           on <tag>caption</tag> in <tag>mediaobject</tag>.</para>
9721         </listitem>
9722         <listitem>
9723           <para>Added support for processing documents that use the
9724           DocBook V5 namespace.</para>
9725         </listitem>
9726         <listitem>
9727           <para>Added support for <tag>termdef</tag> and
9728           <tag>mathphrase</tag>.</para>
9729         </listitem>
9730         <listitem>
9731           <para>EXPERIMENTAL: Incorporated the Slides and Website
9732           stylesheets into the DocBook XSL stylesheets package. So,
9733           for example, Website documents can now be processed using
9734           the following URI for the driver Website
9735           <filename>tabular.xsl</filename> file: <literallayout class="monospaced"><uri>http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl</uri></literallayout></para>
9736         </listitem>
9737         <listitem>
9738           <para>A <tag>procedure</tag> without a <tag>title</tag> is
9739           now treated as an <quote>informal</quote> procedure (meaning
9740           that it is not added to any generated <quote>list of
9741           procedures</quote> and has no affect on numbering of
9742           generated labels for other procedures).</para>
9743         </listitem>
9744         <listitem>
9745           <para><tag>docname</tag> is no longer added to
9746           <tag>olink</tag> when pointing to a root element.</para>
9747         </listitem>
9748       <!-- ======================================================= -->
9749       <listitem>
9750         <para>Added support for generation of choice separator in
9751         inline simplelist. This enables auto-generation of an
9752         appropriate localized <quote>choice separator</quote> (for
9753         example, <quote>and</quote> or <quote>or</quote>) before the
9754         final item in an inline <tag>simplelist</tag>.</para>
9755         <para>To indicate that you want a choice separator
9756         generated for a particular list, you need to put a processing
9757         instruction (PI) of the form
9758         <tag class="xmlpi">dbchoice choice="foo"</tag> as a
9759         child of the list. For example:
9760         <literallayout class="monospaced">  &lt;para&gt;Choose from
9761   ONE and ONLY ONE of the following:
9762   &lt;simplelist type="inline"&gt;
9763   &lt;?dbchoice choice="or" ?&gt;
9764   &lt;member&gt;A&lt;/member&gt;
9765   &lt;member&gt;B&lt;/member&gt;
9766   &lt;member&gt;C&lt;/member&gt;.&lt;/simplelist&gt;&lt;/para&gt;</literallayout>
9767
9768         Output (for English):
9769         <blockquote>
9770           <para>Choose from ONE and only ONE of the
9771           following choices: A, B, or C.</para>
9772         </blockquote>
9773         As a temporary workaround for the fact that most of the
9774         DocBook non-English locale files don't have a localization for
9775         the word <quote>or</quote>, you can put in a literal string to
9776         be used; example for French: <tag class="pi">dbchoice choice="ou"</tag>.  That is, use
9777         <quote>ou</quote> instead of <quote>or</quote>.</para>
9778       </listitem>
9779       </itemizedlist>
9780     </sect2>
9781     <sect2 xml:id="V1690_FO">
9782       <title>FO</title>
9783       <itemizedlist>
9784         <listitem>
9785           <para> Added <literal>content-type</literal> property to
9786           <literal>external-graphic</literal> element, based on
9787           <tag>imagedata</tag> <tag class="attribute">format</tag>
9788           attribute.</para>
9789         </listitem>
9790         <listitem>
9791           <para>Added support for generating
9792           <literal>&lt;rx:meta-field creator="$VERSION"/&gt;</literal>
9793           field for XEP output. This makes the DocBook XSL
9794           stylesheet version information available through the
9795           <guimenu>Document Properties</guimenu> menu in Acrobat
9796           Reader and other PDF viewers.</para>
9797         </listitem>
9798         <listitem>
9799           <para>Trademark symbol handling made consistent with
9800           handling of same in HTML stylesheets. Prior to this change,
9801           if you processed a document that contained no value for the
9802           <tag class="attribute">class</tag> attribute on the
9803           <tag>trademark</tag> element, the HTML stylesheets would
9804           default to rendering a superscript <literal>TM
9805           </literal>symbol after the <tag>trademark</tag> contents,
9806           but the FO stylesheets would render nothing.</para>
9807         </listitem>
9808         <listitem>
9809           <para>Added support for generating XEP bookmarks for
9810           <tag>refentry</tag>.</para>
9811         </listitem>
9812         <listitem>
9813           <para>Added support for HTML markup <tag>table</tag> <tag class="attribute">border</tag> attribute, applied to each
9814           table cell.</para>
9815         </listitem>
9816         <listitem>
9817           <para>The <function>table.width</function> template can now
9818           sum column specs if none use <literal>%</literal> or
9819           <literal>*</literal>.</para>
9820         </listitem>
9821         <listitem>
9822           <para>Added <literal>fox:destination</literal> extension
9823           inside <literal>fox:outline</literal> to support linking to
9824           internal destinations.</para>
9825         </listitem>
9826         <listitem>
9827           <para>Added support for customizing
9828           <literal>abstract</literal> with property sets. Controlled
9829           with the <parameter>abstract.properties</parameter> and
9830           <parameter>abstract.title.properties</parameter>
9831           parameters.</para>
9832         </listitem>
9833         <listitem>
9834           <para>Add <tag>footnote</tag>s in <tag>table</tag> title to
9835           table footnote set, and add support for table footnotes to
9836           HTML table markup.</para>
9837         </listitem>
9838         <listitem>
9839           <para>Added support for <tag>title</tag> in
9840           <tag>glosslist</tag>.</para>
9841         </listitem>
9842         <listitem>
9843           <para>Added support for <tag>itemizedlist</tag> symbol
9844           <literal>none</literal>.</para>
9845         </listitem>
9846         <listitem>
9847           <para>Implemented the new
9848           <parameter>graphical.admonition.properties</parameter> and
9849           <parameter>nongraphical.admonition.properties</parameter>
9850           attribute sets.</para>
9851         </listitem>
9852         <listitem>
9853           <para>Added <tag class="attribute">id</tag> to
9854           <tag>formalpara</tag> and some other blocks that were
9855           missing it.</para>
9856         </listitem>
9857         <listitem>
9858           <para>Changed the anchor template to output
9859           <literal>fo:inline</literal> instead of
9860           <literal>fo:wrapper</literal>.</para>
9861         </listitem>
9862         <listitem>
9863           <para>Added support for <parameter>toc.max.depth</parameter>
9864           parameter.</para>
9865         </listitem>
9866       </itemizedlist>
9867     </sect2>
9868
9869     <sect2 xml:id="V1690_HELP">
9870       <title>Help</title>
9871       <itemizedlist>
9872         <listitem>
9873           <para>Eclipse Help: Added support for generating olink
9874           database.</para>
9875         </listitem>
9876       </itemizedlist>
9877     </sect2>
9878
9879     <sect2 xml:id="V1690_HTML">
9880       <title>HTML</title>
9881       <itemizedlist>
9882         <listitem>
9883           <para>Added a first cut at support in HTML output for
9884           DocBook 5 style <tag>annotation</tag>s. Controlled using the
9885           <parameter>annotation.support</parameter> parameter, and
9886           implemented using JavaScript and CSS styling. For more
9887           details, see the documentation for the
9888           <parameter>annotation.js</parameter>,
9889           <parameter>annotation.css</parameter>,
9890           <parameter>annotation.graphic.open</parameter>, and
9891           <parameter>annotation.graphic.close</parameter>
9892           parameters.</para>
9893         </listitem>
9894         <listitem>
9895           <para>Generate client-side image map for
9896           <tag>imageobjectco</tag> with areas using
9897           <literal>calspair</literal> units</para>
9898         </listitem>
9899         <listitem>
9900           <para>Added support for <tag class="xmlpi">img.src.path</tag> PI.</para>
9901         </listitem>
9902         <listitem>
9903           <para>Added support for passing
9904           <parameter>img.src.path</parameter> to DocBook Java XSLT
9905           image extensions when appropriate. Controlled using the
9906           <parameter>graphicsize.use.img.src.path</parameter>
9907           parameter.</para>
9908         </listitem>
9909         <listitem>
9910           <para>Added support for (not
9911           valid for DocBook 4) <tag class="attribute">xlink:href</tag>
9912           on <tag>area</tag> and (not valid for DocBook 4)
9913           <tag>alt</tag> in <tag>area</tag>.</para>
9914         </listitem>
9915         <listitem>
9916           <para>Added new parameter
9917           <parameter>default.table.frame</parameter> to control table
9918           framing if there is no <tag class="attribute">frame</tag>
9919           attribute on a table.</para>
9920         </listitem>
9921         <listitem>
9922           <para>Added initial, experimental support for generating
9923           content for the HTML <literal>title</literal> attribute from
9924           content of the <tag>alt</tag> element. This change adds
9925           support for the following inline elements only (none of them
9926           are block elements):
9927           <simplelist type="inline">
9928             <?dbchoice choice="and"?>
9929             <member><tag>abbrev</tag></member>
9930             <member><tag>accel</tag></member>
9931             <member><tag>acronym</tag></member>
9932             <member><tag>action</tag></member>
9933             <member><tag>application</tag></member>
9934             <member><tag>authorinitials</tag></member>
9935             <member><tag>beginpage</tag></member>
9936             <member><tag>citation</tag></member>
9937             <member><tag>citerefentry</tag></member>
9938             <member><tag>citetitle</tag></member>
9939             <member><tag>city</tag></member>
9940             <member><tag>classname</tag></member>
9941             <member><tag>code</tag></member>
9942             <member><tag>command</tag></member>
9943             <member><tag>computeroutput</tag></member>
9944             <member><tag>constant</tag></member>
9945             <member><tag>country</tag></member>
9946             <member><tag>database</tag></member>
9947             <member><tag>email</tag></member>
9948             <member><tag>envar</tag></member>
9949             <member><tag>errorcode</tag></member>
9950             <member><tag>errorname</tag></member>
9951             <member><tag>errortext</tag></member>
9952             <member><tag>errortype</tag></member>
9953             <member><tag>exceptionname</tag></member>
9954             <member><tag>fax</tag></member>
9955             <member><tag>filename</tag></member>
9956             <member><tag>firstname</tag></member>
9957             <member><tag>firstterm</tag></member>
9958             <member><tag>foreignphrase</tag></member>
9959             <member><tag>function</tag></member>
9960             <member><tag>glossterm</tag></member>
9961             <member><tag>guibutton</tag></member>
9962             <member><tag>guiicon</tag></member>
9963             <member><tag>guilabel</tag></member>
9964             <member><tag>guimenu</tag></member>
9965             <member><tag>guimenuitem</tag></member>
9966             <member><tag>guisubmenu</tag></member>
9967             <member><tag>hardware</tag></member>
9968             <member><tag>honorific</tag></member>
9969             <member><tag>interface</tag></member>
9970             <member><tag>interfacename</tag></member>
9971             <member><tag>keycap</tag></member>
9972             <member><tag>keycode</tag></member>
9973             <member><tag>keysym</tag></member>
9974             <member><tag>lineage</tag></member>
9975             <member><tag>lineannotation</tag></member>
9976             <member><tag>literal</tag></member>
9977             <member><tag>markup</tag></member>
9978             <member><tag>medialabel</tag></member>
9979             <member><tag>methodname</tag></member>
9980             <member><tag>mousebutton</tag></member>
9981             <member><tag>option</tag></member>
9982             <member><tag>optional</tag></member>
9983             <member><tag>otheraddr</tag></member>
9984             <member><tag>othername</tag></member>
9985             <member><tag>package</tag></member>
9986             <member><tag>parameter</tag></member>
9987             <member><tag>personname</tag></member>
9988             <member><tag>phone</tag></member>
9989             <member><tag>pob</tag></member>
9990             <member><tag>postcode</tag></member>
9991             <member><tag>productname</tag></member>
9992             <member><tag>productnumber</tag></member>
9993             <member><tag>prompt</tag></member>
9994             <member><tag>property</tag></member>
9995             <member><tag>quote</tag></member>
9996             <member><tag>refentrytitle</tag></member>
9997             <member><tag>remark</tag></member>
9998             <member><tag>replaceable</tag></member>
9999             <member><tag>returnvalue</tag></member>
10000             <member><tag>tag</tag></member>
10001             <member><tag>shortcut</tag></member>
10002             <member><tag>state</tag></member>
10003             <member><tag>street</tag></member>
10004             <member><tag>structfield</tag></member>
10005             <member><tag>structname</tag></member>
10006             <member><tag>subscript</tag></member>
10007             <member><tag>superscript</tag></member>
10008             <member><tag>surname</tag></member>
10009             <member><tag>symbol</tag></member>
10010             <member><tag>systemitem</tag></member>
10011             <member><tag>tag</tag></member>
10012             <member><tag>termdef</tag></member>
10013             <member><tag>token</tag></member>
10014             <member><tag>trademark</tag></member>
10015             <member><tag>type</tag></member>
10016             <member><tag>uri</tag></member>
10017             <member><tag>userinput</tag></member>
10018             <member><tag>varname</tag></member>
10019             <member><tag>wordasword</tag></member>
10020           </simplelist>
10021         </para>
10022         </listitem>
10023         <listitem>
10024           <para>Added support for chunking <tag>revhistory</tag> into
10025           separate file (similar to the support for doing same with
10026           <tag>legalnotice</tag>). Patch from Thomas
10027           Schraitle. Controlled through <parameter>new
10028           generate.revhistory.link</parameter> parameter.</para>
10029         </listitem>
10030         <listitem>
10031           <para>l10n.xsl: Made language codes RFC compliant. Added a
10032           new boolean config parameter,
10033           <parameter>l10n.lang.value.rfc.compliant</parameter>. If it
10034           is non-zero (the default), any underscore in a language code
10035           will be converted to a hyphen in HTML output. If it is zero,
10036           the language code will be left as-is.</para>
10037         </listitem>
10038       </itemizedlist>
10039     </sect2>
10040     <sect2 xml:id="V1690_MAN">
10041       <title>man</title>
10042       <para>This release closes out 44 manpages stylesheet bug reports
10043       and feature requests. It adds more than 35 new configuration
10044       parameters for controlling aspects of man-page output --
10045       including hyphenation and justification, handling of links,
10046       conversion of Unicode characters, and contents of man-page
10047       headers and footers.</para>
10048       <itemizedlist>
10049         <!-- ======================================================= -->
10050         <listitem>
10051           <para>New options for globally disabling/enabling
10052           hyphenation and justification:
10053           <parameter>man.justify</parameter> and
10054           <parameter>man.hyphenate</parameter>.</para>
10055           <para>Note that the default
10056           for the both of those is zero (off), because justified text
10057           looks good only when it is also hyphenated; to quote the
10058           <quote>Hyphenation</quote> node from the groff info page:
10059           <blockquote>
10060             <para><emphasis>Since the odds are not great for finding a
10061             set of words, for every output line, which fit nicely on a
10062             line without inserting excessive amounts of space between
10063             words, `gtroff' hyphenates words so that it can justify
10064             lines without inserting too much space between
10065             words.</emphasis></para>
10066           </blockquote>
10067           The problem is that groff can end up hyphenating a lot of
10068           things that you don't want hyphenated (variable names and
10069           command names, for example). Keeping both justification and
10070           hyphenation disabled ensures that hyphens won't get inserted
10071           where you don't want to them, and you don't end up with
10072           lines containing excessive amounts of space between
10073           words. These default settings run counter to how most
10074           existing man pages are formatted. But there are some notable
10075           exceptions, such as the perl man pages.</para>
10076         </listitem>
10077         <listitem>
10078           <para> Added parameters for controlling hyphenation of
10079           computer inlines, filenames, and URLs. By default, even when
10080           hyphenation is enabled (globally), hyphenation is now
10081           suppressed for "computer inlines" (currently, just
10082           <tag>classname</tag>, <tag>constant</tag>, <tag>envar</tag>,
10083           <tag>errorcode</tag>, <tag>option</tag>,
10084           <tag>replaceable</tag>, <tag>userinput</tag>,
10085           <tag>type</tag>, and <tag>varname</tag>, and for
10086           <tag>filenames</tag>, and for URLs from <tag>link</tag>. It
10087           can be (re)enabled using the
10088           <parameter>man.hyphenate.computer.inlines</parameter>,
10089           <parameter>man.hyphenate.filenames</parameter>, and
10090           <parameter>man.hyphenate.urls parameters</parameter>.</para>
10091         </listitem>
10092         <!-- ======================================================= -->
10093         <listitem>
10094           <para>Implemented a new system for replacing Unicode
10095           characters. There are two parts to the new system: a
10096           <quote>string substitution map</quote> for doing
10097           <quote>essential</quote> replacements, and a
10098           <quote>character map</quote> that can optionally be disabled
10099           and enabled.</para>
10100           <para>The new system fixes all open bugs that had to do with
10101           literal Unicode numbered entities such as &amp;#8220; and
10102           &amp;#8221; showing up in output, and greatly expands the
10103           ability of the stylesheets to generate <quote>good</quote> roff
10104           equivalents for Unicode symbols and special
10105           characters.</para>
10106           <para>Here are some details...</para>
10107           <para>The previous manpages mechanism for replacing Unicode
10108           symbols and special characters with roff equivalents (the
10109           <function>replace-entities</function> template) was not
10110           scalable and not complete. The mechanism handled a somewhat
10111           arbitrary selection of less than 20 or so Unicode
10112           characters. But there are potentially more than
10113           <emphasis>800</emphasis> Unicode special characters that
10114           have some groff equivalent they can be mapped to. And there
10115           are about 34 symbols in the Latin-1 (ISO-8859-1) block
10116           alone. Users might reasonably expect that if they include
10117           any of those Latin-1 characters in their DocBook source
10118           documents, they will get correctly converted to known roff
10119           equivalents in output.</para>
10120           <para>In addition to those common symbols, certain users may
10121           have a need to use symbols from other Unicode blocks. Say,
10122           somebody who is documenting an application related to math
10123           might need to use a bunch of symbols from the
10124           <quote>Mathematical Operators</quote> Unicode block (there
10125           are about 65 characters in that block that have reasonable
10126           roff equivalents). Or somebody else might really like
10127           Dingbats -- such as the checkmark character -- and so might
10128           use a bunch of things from the <quote>Dingbat</quote> block
10129           (141 characters in that that have roff equivalents or that
10130           can at least be <quote>degraded</quote> somewhat gracefully
10131           into roff).</para>
10132           <para>So, the old <function>replace-entities</function>
10133           mechanism was replaced with a completely different mechanism
10134           that is based on use of two <quote>maps</quote>: a
10135           <quote>substitution map</quote> and a <quote>character
10136           map</quote> (the latter in a format compliant with the XSLT
10137           2.0 spec and therefore completely <quote>forward
10138           compatible</quote> with XSLT 2.0).</para>
10139           <para>The substitution map is controlled through the
10140           <parameter>man.string.subst.map</parameter> parameter, and
10141           is used to replace things like the backslash character
10142           (which needs special handling to prevent it from being
10143           interpreted as a roff escape). The substitution map cannot
10144           be disabled, because disabling it will cause the output to
10145           be broken. However, you can add to it and change it if
10146           needed.</para>
10147
10148           <para>The <quote>character map</quote> mechanism, on the
10149           other hand, can be completely disabled. It is enabled by
10150           default, and, by default, does replacement of all Latin-1
10151           symbols, along with most special spaces, dashes, and quotes
10152           (about 75 characters by default). Also, you can optionally
10153           enable a <quote>full</quote> character map that provides
10154           support for converting all 800 or so of the characters that
10155           have some reasonable groff equivalent.</para>
10156
10157           <para>The character-map mechanism is controlled through the
10158           following parameters:
10159           <variablelist>
10160             <varlistentry>
10161               <term><parameter>man.charmap.enabled</parameter></term>
10162               <listitem><para>turns character-map support
10163               on/off</para></listitem>
10164             </varlistentry>
10165             <varlistentry>
10166               <term><parameter>man.charmap.use.subset</parameter></term>
10167               <listitem><para>specifies that a subset of the character
10168               map is used instead of the full map</para></listitem>
10169             </varlistentry>
10170             <varlistentry>
10171               <term><parameter>man.charmap.subset.profile</parameter></term>
10172               <listitem><para>specifies profile of character-map
10173               subset</para></listitem>
10174             </varlistentry>
10175             <varlistentry>
10176               <term><parameter>man.charmap.uri</parameter></term>
10177               <listitem><para>specifies an alternate character map to
10178               use instead of the <quote>standard</quote> character map
10179               provided in the distribution</para></listitem>
10180             </varlistentry>
10181           </variablelist>
10182           </para>
10183         </listitem>
10184         <!-- ======================================================= -->
10185         <listitem>
10186           <para>Implemented out-of-line handling of display of URLs
10187           for links (currently, only for <tag>ulink</tag>). This gives
10188           you three choices for handling of links:
10189           <orderedlist>
10190             <listitem>
10191               <para>Number and list links. Each link is numbered
10192               inline, with a number in square brackets preceding the
10193               link contents, and a numbered list of all links is added
10194               to the end of the document.</para>
10195             </listitem>
10196             <listitem>
10197               <para>Only list links. Links are not numbered, but an
10198               (unnumbered) list of links is added to the end of the
10199               document.</para>
10200             </listitem>
10201             <listitem>
10202               <para>Suppress links. Don't number links and don't add
10203               any list of links to the end of the document.</para>
10204             </listitem>
10205           </orderedlist>
10206           You can also choose whether links should be underlined. The
10207           default is <quote>the works</quote> -- list, number, and
10208           underline links. You can use the
10209           <parameter>man.links.list.enabled</parameter>, <parameter>
10210           man.links.are.numbered</parameter>, and
10211           <parameter>man.links.are.underlined</parameter> parameters
10212           to change the defaults. The default heading for the link
10213           list is REFERENCES. You can be change that using the
10214           <parameter>man.links.list.heading</parameter>
10215           parameter.</para>
10216         </listitem>
10217         <listitem>
10218           <para>Changed default output encoding to UTF-8. <emphasis role="bold">This does not mean that man pages are output in
10219           raw UTF-8</emphasis>, because the character map is applied
10220           before final output, causing all UTF-8 characters covered in
10221           the map to be converted to roff equivalents.</para>
10222         </listitem>
10223         <!-- ======================================================= -->
10224         <listitem>
10225           <para>Added support for processing <tag>refsect3</tag> and
10226           <tag>formalpara</tag> and nested <tag>refsection</tag>
10227           elements, down to any arbitrary level of nesting.</para>
10228         </listitem>
10229         <!-- ======================================================= -->
10230         <listitem>
10231           <para>Output of the <literal>NAME</literal> and
10232           <literal>SYNOPSIS</literal> and <literal>AUTHOR</literal>
10233           headings and the headings for admonitions (<tag>note</tag>,
10234           <tag>caution</tag>, etc.) are no longer hard-coded for
10235           English. Instead, headings are generated for those in the
10236           correct locale (just as the FO and HTML stylesheets
10237           do).</para>
10238         </listitem>
10239         <!-- ======================================================= -->
10240         <listitem>
10241           <para>Re-worked mechanism for assembling page
10242           headers/footers (the contents of the <literal>.TH</literal>
10243           macro <quote>title line</quote>).</para>
10244
10245           <para>Here are some details...</para>
10246
10247           <para>All man pages contain a <literal>.TH</literal> roff
10248           macro whose contents are used for rendering the <quote>title
10249           line</quote> displayed in the header and footer of each
10250           page. Here are a couple of examples of real-world man pages
10251           that have useful page headers/footers: <literallayout class="monospaced">
10252   gtk-options(7)    GTK+ User's Manual   gtk-options(7) &lt;-- header
10253   GTK+ 1.2              2003-10-20       gtk-options(7) &lt;-- footer
10254
10255   svgalib(7)       Svgalib User Manual       svgalib(7) &lt;-- header
10256   Svgalib 1.4.1      16 December 1999        svgalib(7) &lt;-- footer</literallayout></para>
10257
10258           <para>And here are the terms with which the
10259           <literal>groff_man(7)</literal> man page refers to the
10260           various parts of the header/footer: <literallayout class="monospaced">
10261   title(section)  extra3  title(section)  &lt;- header
10262   extra2          extra1  title(section)  &lt;- footer</literallayout></para>
10263   <para> Or, using the names with which the <literal>man(7)</literal>
10264    man page refers to those same fields: <literallayout class="monospaced">
10265   title(section)  manual  title(section)  &lt;- page header
10266   source          date    title(section)  &lt;- page footer</literallayout></para>
10267
10268             <para>The easiest way to control the contents of those
10269             fields is to mark up your <tag>refentry</tag> content like
10270             the following (note that this is a <quote>minimal</quote>
10271             example). <programlisting>
10272   &lt;refentry&gt;
10273     &lt;info&gt;
10274       &lt;date&gt;2003-10-20&lt;/date&gt; <co xml:id="V1690_date-co" linkends="V1690_date"/>
10275     &lt;/info&gt;
10276     &lt;refmeta&gt;
10277       &lt;refentrytitle&gt;gtk-options&lt;/refentrytitle&gt; <co xml:id="V1690_title-co" linkends="V1690_title"/>
10278       &lt;manvolnum&gt;7&lt;/manvolnum&gt; <co xml:id="V1690_manvolnum-co" linkends="V1690_manvolnum"/>
10279       &lt;refmiscinfo class="source-name"&gt;GTK+&lt;/refmiscinfo&gt; <co xml:id="V1690_source-name-co" linkends="V1690_source-name"/>
10280       &lt;refmiscinfo class="version"&gt;1.2&lt;/refmiscinfo&gt; <co xml:id="V1690_version-co" linkends="V1690_version"/>
10281       &lt;refmiscinfo class="manual"&gt;GTK+ User's Manual&lt;/refmiscinfo&gt; <co xml:id="V1690_manual-co" linkends="V1690_manual"/>
10282     &lt;/refmeta&gt;
10283     &lt;refnamediv&gt;
10284       &lt;refname&gt;gtk-options&lt;/refname&gt;
10285       &lt;refpurpose&gt;Standard Command Line Options for GTK+ Programs&lt;/refpurpose&gt;
10286     &lt;/refnamediv&gt;
10287     &lt;refsect1&gt;
10288       &lt;title&gt;Description&lt;/title&gt;
10289       &lt;para&gt;This manual page describes the command line options, which
10290       are common to all GTK+ based applications.&lt;/para&gt;
10291     &lt;/refsect1&gt;
10292   &lt;/refentry&gt;</programlisting>
10293   <calloutlist>
10294     <callout arearefs="V1690_date-co" xml:id="V1690_date">
10295       <para>Sets the <quote>date</quote> part of the header/footer.</para>
10296     </callout>
10297     <callout arearefs="V1690_title-co" xml:id="V1690_title">
10298       <para>Sets the <quote>title</quote> part.</para>
10299     </callout>
10300     <callout arearefs="V1690_manvolnum-co" xml:id="V1690_manvolnum">
10301       <para>Sets the <quote>section</quote> part.</para>
10302     </callout>
10303     <callout arearefs="V1690_source-name-co" xml:id="V1690_source-name">
10304       <para>Sets the <quote>source name</quote> part.</para>
10305     </callout>
10306     <callout arearefs="V1690_version-co" xml:id="V1690_version">
10307       <para>Sets the <quote>version</quote> part.</para>
10308     </callout>
10309     <callout arearefs="V1690_manual-co" xml:id="V1690_manual">
10310       <para>Sets the <quote>manual</quote> part.</para>
10311     </callout>
10312   </calloutlist>
10313             </para>
10314             <para>Below are explanations of the steps the stylesheets
10315             take to attempt to assemble and display
10316             <quote>good</quote> headers and footer. [In the
10317             descriptions, note that <replaceable>*info</replaceable>
10318             is the <tag>refentry</tag> <quote>info</quote> child
10319             (whatever its name), and
10320             <replaceable>parentinfo</replaceable> is the
10321             <quote>info</quote> child of its parent (again, whatever
10322             its name).]
10323           <variablelist>
10324             <varlistentry>
10325               <term>extra1 field (date)</term>
10326               <listitem>
10327                 <para>Content of the <quote>extra1</quote> field is
10328                 what shows up in the <emphasis role="bold">center
10329                 footer</emphasis> position of each page. The
10330                 <literal>man(7)</literal> man page describes it as
10331                 <quote>the date of the last revision</quote>.</para>
10332                 <para>To provide this content, if the
10333                 <parameter>refentry.date.profile.enabled</parameter>
10334                 is non-zero, the stylesheets check the value of
10335                 <parameter>refentry.date.profile</parameter>.</para>
10336                 <para>Otherwise, by default, they check for a
10337                 <tag>date</tag> or <tag>pubdate</tag> not only in the
10338                 <replaceable>*info</replaceable> contents, but also in
10339                 the <replaceable>parentinfo</replaceable>
10340                 contents.</para>
10341                 <para>If a date cannot be found, the stylesheets now
10342                 automatically generate a localized <quote>long
10343                 format</quote> date, ensuring that this field always
10344                 has content in output.</para>
10345                 <para>However, if for some reason you want to suppress
10346                 this field, you can do so by setting a non-zero value
10347                 for <parameter>man.th.extra1.suppress</parameter>.</para>
10348               </listitem>
10349             </varlistentry>
10350             <varlistentry>
10351               <term>extra2 field (source)</term>
10352               <listitem>
10353                 <para>On Linux systems and on systems with a modern
10354                 groff, the content of the <quote>extra2</quote> field
10355                 are what shows up in the <emphasis role="bold">left
10356                 footer</emphasis> position of each page.</para>
10357
10358                 <para>The <literal>man(7)</literal> man page describes
10359                 this as <quote>the source of the command</quote>, and
10360                 provides the following examples:
10361                 <itemizedlist>
10362                   <listitem>
10363                     <para>For binaries, use somwething like: GNU,
10364                     NET-2, SLS Distribution, MCC Distribution.</para>
10365                   </listitem>
10366                   <listitem>
10367                     <para>For system calls, use the version of the
10368                     kernel that you are currently looking at: Linux
10369                     0.99.11.</para>
10370                   </listitem>
10371                   <listitem>
10372                     <para>For library calls, use the source of the
10373                     function: GNU, BSD 4.3, Linux DLL 4.4.1.</para>
10374                   </listitem>
10375                 </itemizedlist>
10376                 </para>
10377
10378                 <para>In practice, there are many pages that simply
10379                 have a version number in the <quote>source</quote>
10380                 field. So, it looks like what we have is a two-part
10381                 field,
10382                 <replaceable>Name</replaceable> <replaceable>Version</replaceable>,
10383                 where:
10384                 <variablelist>
10385                   <varlistentry>
10386                     <term>Name</term>
10387                     <listitem>
10388                       <para>product name (e.g., BSD) or org. name
10389                       (e.g., GNU)</para>
10390                     </listitem>
10391                   </varlistentry>
10392                   <varlistentry>
10393                     <term>Version</term>
10394                     <listitem>
10395                       <para>version name</para>
10396                     </listitem>
10397                   </varlistentry>
10398                 </variablelist>
10399                 Each part is optional. If the
10400                 <replaceable>Name</replaceable> is a product name,
10401                 then the <replaceable>Version</replaceable> is
10402                 probably the version of the product. Or there may be
10403                 no <replaceable>Name</replaceable>, in which case, if
10404                 there is a <replaceable>Version</replaceable>, it is
10405                 probably the version of the item itself, not the
10406                 product it is part of. Or, if the
10407                 <replaceable>Name</replaceable> is an organization
10408                 name, then there probably will be no
10409                 <replaceable>Version</replaceable>.
10410                 </para>
10411                 <para>To provide this content, if the
10412                 <parameter>refentry.source.name.profile.enabled</parameter>
10413                 and
10414                 <parameter>refentry.version.profile.enabled</parameter>
10415                 parameter are non-zero, the stylesheets check the
10416                 value of <parameter>refentry.source.name.profile</parameter>
10417                 <parameter>refentry.version.profile</parameter>.</para>
10418
10419                 <para>Otherwise, by default, they check the following
10420                 places, in the following order:
10421                 <orderedlist>
10422                   <listitem>
10423                     <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productnumber</tag></literallayout>
10424                   </listitem>
10425                   <listitem>
10426                     <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productnumber</tag></literallayout>
10427                   </listitem>
10428                   <listitem>
10429                     <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag>[@class = 'version']</literallayout>
10430                   </listitem>
10431                   <listitem>
10432                     <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>productnumber</tag></literallayout>
10433                   </listitem>
10434                   <listitem>
10435                     <literallayout class="monospaced"><replaceable>*info</replaceable>/<tag>productname</tag></literallayout>
10436                   </listitem>
10437                   <listitem>
10438                     <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>productname</tag></literallayout>
10439                   </listitem>
10440                   <listitem>
10441                     <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag></literallayout>
10442                   </listitem>
10443                   <listitem>
10444                     <para>[nothing found, so leave it empty]</para>
10445                   </listitem>
10446                 </orderedlist>
10447                 </para>
10448               </listitem>
10449             </varlistentry>
10450             <varlistentry>
10451               <term>extra3 field</term>
10452               <listitem>
10453                 <para>On Linux systems and on systems with a modern
10454                 groff, the content of the <quote>extra3</quote> field
10455                 are what shows up in the <emphasis role="bold">center
10456                 header</emphasis> position of each page. Some man
10457                 pages have <quote>extra2</quote> content, some
10458                 don't. If a particular man page has it, it is most
10459                 often <quote>context</quote> data about some larger
10460                 system the documented item belongs to (for example,
10461                 the name or description of a group of related
10462                 applications). The stylesheets now check the following
10463                 places, in the following order, to look for content to
10464                 add to the <quote>extra3</quote> field.</para>
10465                 <orderedlist>
10466                   <listitem>
10467                     <literallayout class="monospaced"><replaceable>parentinfo</replaceable>/<tag>title</tag></literallayout>
10468                   </listitem>
10469                   <listitem>
10470                     <literallayout class="monospaced">parent's <tag>title</tag></literallayout>
10471                   </listitem>
10472                   <listitem>
10473                     <literallayout class="monospaced"><tag>refmeta</tag>/<tag>refmiscinfo</tag></literallayout>
10474                   </listitem>
10475                   <listitem>
10476                     <para>[nothing found, so leave it empty]</para>
10477                   </listitem>
10478                 </orderedlist>
10479               </listitem>
10480             </varlistentry>
10481           </variablelist>
10482         </para>
10483       </listitem>
10484       <!-- ======================================================= -->
10485       <listitem>
10486         <para>Reworked <replaceable>*info</replaceable> gathering. For
10487         each <tag>refentry</tag> found, the stylesheets now cache its
10488         <replaceable>*info</replaceable> content, then check for any
10489         valid parent of it that might have metainfo content and cache
10490         that, if found; they then then do all further matches against
10491         those node-sets (rather than re-selecting the original
10492         <replaceable>*info</replaceable> nodes each time they are
10493         needed).</para>
10494       </listitem>
10495       <!-- ======================================================= -->
10496       <listitem>
10497         <para>New option for breaking strings after forward
10498         slashes. This enables long URLs and pathnames to be broken
10499         across lines. Controlled through
10500         <parameter>man.break.after.slash</parameter> parameter.</para>
10501       </listitem>
10502       <!-- ======================================================= -->
10503       <listitem>
10504         <para>Output for servicemark and trademark are now
10505         <literal>(SM)</literal> and <literal>(TM)</literal>. There is
10506         a groff <literal>"\(tm"</literal> escape, but output from that
10507         is not acceptable.</para>
10508       </listitem>
10509       <!-- ======================================================= -->
10510       <listitem>
10511         <para>New option for controlling the length of the title
10512         part of the <literal>.TH</literal> title line. Controlled
10513         through the <parameter>man.th.title.max.length</parameter>
10514         parameter.</para>
10515       </listitem>
10516       <!-- ======================================================= -->
10517       <listitem>
10518         <para>New option for specifying output encoding of each man
10519         page; controlled with
10520         <parameter>man.output.encoding</parameter> (similar to the
10521         HTML <parameter>chunker.output.encoding </parameter>
10522         parameter).</para>
10523       </listitem>
10524       <!-- ======================================================= -->
10525      <listitem>
10526         <para>New option for suppressing filename messages when
10527         generating output; controlled with
10528         <parameter>man.output.quietly</parameter> (similar to the HTML
10529         <parameter>chunk.quietly</parameter> parameter).</para>
10530       </listitem>
10531       <!-- ======================================================= -->
10532       <listitem>
10533         <para>The text of cross-references to first-level
10534         <tag>refentry</tag> (<tag>refsect1</tag>, top-level
10535         <tag>refsection</tag>, <tag>refnamediv</tag>, and
10536         <tag>refsynopsisdiv</tag>) are now capitalized.</para>
10537       </listitem>
10538       <!-- ======================================================= -->
10539       <listitem>
10540         <para>Cross-references to <tag>refnamediv</tag> now use the
10541         localized <literal>NAME</literal> title instead of using the
10542         first <tag>refname</tag> child. This makes the output
10543         inconsistent with HTML and FO output, but for man-page output,
10544         it seems to make better sense to have the
10545         <literal>NAME</literal>. (It may actually make better sense to
10546         do it that way in HTML and FO output as well...)</para>
10547       </listitem>
10548       <!-- ======================================================= -->
10549       <listitem>
10550         <para>Added support for processing <tag>funcparams</tag>.</para>
10551       </listitem>
10552       <!-- ======================================================= -->
10553       <listitem>
10554         <para>Removed the space that was being output between
10555         <tag>funcdef</tag> and <tag>paramdef</tag>; example: was:
10556         <literal>float rand (void)</literal>; now:
10557         <literal>float rand(void)</literal></para>
10558       </listitem>
10559       <!-- ======================================================= -->
10560       <listitem>
10561         <para>Turned off bold formatting for the <tag>type</tag>
10562         element when it occurs within a <tag>funcdef</tag> or
10563         <tag>paramdef</tag></para>
10564       </listitem>
10565       <!-- ======================================================= -->
10566       <listitem>
10567         <para>Corrected rendering of <tag>simplelist</tag>. Any
10568         <literal>&lt;simplelist type="inline"</literal> instance
10569         is now rendered as a comma-separated list (also with an
10570         optional localized <quote>and</quote> or <quote>or</quote> before the last item -- see
10571         description elsewhere in these release notes). Any simplelist
10572         instance whose <tag class="attribute">type</tag> is not
10573         <literal>inline</literal> is rendered as a one-column vertical
10574         list (ignoring the values of the <tag class="attribute">type</tag> and <tag class="attribute">columns</tag> attributes if present)</para>
10575       </listitem>
10576       <!-- ======================================================= -->
10577       <listitem>
10578         <para>Comment added at top of roff source for each page now
10579         includes DocBook XSL stylesheets version number (as in the
10580         HTML stylesheets)</para>
10581       </listitem>
10582       <!-- ======================================================= -->
10583       <listitem>
10584         <para>Made change to prevent <quote>sticky</quote> fonts
10585         changes. Now, when the manpages stylesheets encounter node
10586         sets that need to be boldfaced or italicized, they put the
10587         <literal>\fBfoo\fR</literal> and <literal>\fIbar\fR</literal>
10588         groff bold/italic instructions separately around each node in
10589         the set.</para>
10590       </listitem>
10591       <listitem>
10592         <para>synop.xsl: Boldface everything in
10593         <tag>funcsynopsis</tag> output except parameters (which are in
10594         ital). The <literal>man(7)</literal> man page says:
10595         <blockquote>
10596           <para>For functions, the arguments are always specified
10597           using italics, even in the SYNOPSIS section, where the rest
10598           of the function is specified in bold.</para>
10599           </blockquote>
10600           A look through the contents of the
10601           <filename>man/man2</filename> directory shows that most
10602           (all) existing pages do follow this <quote>everything in
10603           funcsynopsis bold</quote> rule. That means the
10604           <tag>type</tag> content and any punctuation (parens,
10605           semicolons, <tag>vararg</tag>s) also must be bolded.</para>
10606       </listitem>
10607       <!-- ======================================================= -->
10608       <listitem>
10609         <para>Removed code for adding backslashes before periods/dots
10610         in roff source, because backslashes in front of periods/dots
10611         in roff source are needed only in the very rare case where a
10612         period is the very first character in a line, without any
10613         space in front of it. A better way to deal with that rare case
10614         is for you to add a zero-width space in front of the offending
10615         dot(s) in your source</para>
10616       </listitem>
10617       <!-- ======================================================= -->
10618       <listitem>
10619         <para>Removed special handling of the <tag>quote</tag>
10620         element. That was hard-coded to cause anything marked up with
10621         the <tag>quote</tag> element to be output preceded by two
10622         backticks and followed by two apostrophes -- that is, that
10623         old-school kludge for generating <quote>curly</quote> quotes in Emacs and
10624         in X-Windows fonts. While Emacs still seems to support that, I
10625         don't think X-Windows has for a long time now. And, anyway, it
10626         looks (and has always looked) like crap when viewed on a
10627         normal tty/console. In addition, it breaks localiztion of
10628         <tag>quote</tag>. By default, <tag>quote</tag> content is
10629         output with localized quotation marks, which, depending on the
10630         locale, may or may not be left and right double quotation
10631         marks.</para>
10632       </listitem>
10633       <!-- ======================================================= -->
10634       <listitem>
10635         <para>Changed mappings for left and right single quotation
10636         marks. Those had previously been incorrectly mapped to the
10637         backtick (&amp;#96;) and apostrophe (&amp;39;) characters (for
10638         kludgy reasons -- see above). They are now correctly mapped to
10639         the <literal>\(oq</literal> and <literal>\(cq</literal> roff
10640         escapes. If you want the old (broken) behavior, you need to
10641         manually change the mappings for those in the value of the
10642         <parameter>man.string.subst.map</parameter> parameter.</para>
10643       </listitem>
10644       <listitem>
10645         <para>Removed <filename>xref.xsl</filename> file. Now, of the
10646         various cross-reference elements, only the <tag>ulink</tag>
10647         element is handled differently; the rest are handled exactly
10648         as the HTML stylesheets handle them, except that no hypertext
10649         links are generated. (Because there is no equivalent hypertext
10650         mechanism is man pages.)</para>
10651       </listitem>
10652       <!-- ======================================================= -->
10653       <listitem>
10654         <para>New option for making <quote>subheading dividers</quote> in generated
10655         roff source. The dividers are not visible in the rendered man
10656         page; they are just there to make the source
10657         readable. Controlled using
10658         <parameter>man.subheading.divider</parameter>.</para>
10659       </listitem>
10660       <!-- ======================================================= -->
10661       <listitem>
10662         <para>Fixed many places where too much space was being added
10663         between lines.</para>
10664       </listitem>
10665     </itemizedlist>
10666     <!-- end of MAN changes for 1.69.0 release -->
10667   </sect2>
10668 </sect1>
10669   <!-- end of notes for 1.69.0 release -->
10670
10671   <sect1 xml:id="V1681">
10672     <title>Release 1.68.1</title>
10673     <para>The release adds localization support for Farsi (thanks to
10674     Sina Heshmati) and improved support for the XLink-based DocBook NG
10675     <tag>db:link</tag> element. Other than that, it is a minor
10676     bug-fix update to the 1.68.0 release. The main thing it fixes is a
10677     build error that caused the XSLT Java extensions to be jarred up
10678     with the wrong package structure. Thanks to Jens Stavnstrup for
10679     quickly reporting the problem, and to Mauritz Jeanson for
10680     investigating and finding the cause.</para>
10681   </sect1>
10682   <!-- end of notes for 1.68.1 release -->
10683
10684   <sect1 xml:id="V1680">
10685     <title>Release 1.68.0</title>
10686     <para>This release includes some features changes, particularly
10687     for FO/PDF output, and a number of bug fixes.
10688       <itemizedlist xml:id="V1680_FO">
10689         <title>FO</title>
10690         <listitem>
10691           <para>Moved footnote properties to attribute-sets.</para>
10692         </listitem>
10693         <listitem>
10694           <para>Added support for side floats, margin notes, and
10695           custom floats.</para>
10696         </listitem>
10697         <listitem>
10698           <para>Added new parameters
10699           <parameter>body.start.indent</parameter> and
10700           <parameter>body.end.indent</parameter> to the
10701           <parameter>set.flow.properties template</parameter>.</para>
10702         </listitem>
10703         <listitem>
10704           <para>Added support for <tag class="attribute">xml:id</tag></para>
10705         </listitem>
10706         <listitem>
10707           <para>Added support for
10708           <tag>refdescriptor</tag>.</para>
10709         </listitem>
10710         <listitem>
10711           <para>Added support for multiple <tag>refnamediv</tag>s.</para>
10712         </listitem>
10713         <listitem>
10714           <para>Added <parameter>index.entry.properties</parameter>
10715           attribute-set to support customization of index
10716           entries.</para>
10717         </listitem>
10718         <listitem>
10719           <para>Added <parameter>set.flow.properties
10720           template</parameter> call to each <tag>fo:flow</tag>
10721           to support customizations entry point.</para>
10722         </listitem>
10723         <listitem>
10724           <para>Add support for <literal>@floatstyle</literal> in
10725           <tag>figure</tag></para>
10726         </listitem>
10727         <listitem>
10728           <para>Moved hardcoded properties for index division titles
10729           to the <parameter>index.div.title.properties</parameter>
10730           attribute-set.</para>
10731         </listitem>
10732         <listitem>
10733           <para>Added support for
10734           <tag>table-layout</tag>="<tag class="attvalue">auto</tag>" for XEP.</para>
10735         </listitem>
10736         <listitem>
10737           <para>Added <parameter>index.div.title.properties</parameter>
10738           attribute-set.</para>
10739         </listitem>
10740         <listitem>
10741           <para><parameter>$verbose</parameter> parameter is now
10742           passed to most elements.</para>
10743         </listitem>
10744         <listitem>
10745           <para>Added <tag>refentry</tag> to
10746           <tag>toc</tag> in <tag>part</tag>, as it is
10747           permitted by the DocBook schema/DTD.</para>
10748         </listitem>
10749         <listitem>
10750           <para>Added backmatter elements and
10751           <tag>article</tag> to <tag>toc</tag> in
10752           <tag>part</tag>, since they are permitted by the
10753           DocBook schema/DTD.</para>
10754         </listitem>
10755         <listitem>
10756           <para>Added <tag class="attribute">mode</tag>="<tag class="attvalue">toc</tag>" for
10757           <tag>simplesect</tag>, since it is now permitted in
10758           the <tag>toc</tag> if
10759           <parameter>simplesect.in.toc</parameter> is set.</para>
10760         </listitem>
10761         <listitem>
10762           <para>Moved hard-coded properties to
10763           <parameter>nongraphical.admonintion.properties</parameter>
10764           and <parameter>graphical.admonition.properties</parameter>
10765           attribute sets.</para>
10766         </listitem>
10767         <listitem>
10768           <para>Added support for <literal>sidebar-width</literal> and
10769           <literal>float-type</literal> processing instructions in
10770           <tag>sidebar</tag>.</para>
10771         </listitem>
10772         <listitem>
10773           <para>For tables with HTML markup elements, added support
10774           for <literal>dbfo bgcolor</literal> PI, the attribute-sets
10775           named <parameter>table.properties</parameter>,
10776           <parameter>informaltable.properties</parameter>,
10777           <parameter>table.table.properties</parameter>, and
10778           <parameter>table.cell.padding</parameter>. Also added
10779           support for the templates named
10780           <parameter>table.cell.properties</parameter> and
10781           <parameter>table.cell.block.properties</parameter> so that
10782           tabstyles can be implemented. Also added support for tables
10783           containing only <tag>tr</tag> instead of
10784           <tag>tbody</tag> with <tag>tr</tag>.</para>
10785         </listitem>
10786         <listitem>
10787           <para>Added new paramater
10788           <parameter>hyphenate.verbatim.characters</parameter> which
10789           can specify characters after which a line break can occur in
10790           verbatim environments.  This parameter can be used to extend
10791           the initial set of characters which contain only space and
10792           non-breakable space.</para>
10793         </listitem>
10794         <listitem>
10795           <para>Added <parameter>itemizedlist.label.markup</parameter> to enable
10796           selection of different bullet symbol. Also added several
10797           potential bullet characters, commented out by default.</para>
10798         </listitem>
10799         <listitem>
10800           <para>Enabled all id's in XEP output for external olinking.</para>
10801         </listitem>
10802       </itemizedlist>
10803
10804       <itemizedlist xml:id="V1680_HTML">
10805         <title>HTML</title>
10806         <listitem>
10807           <para>Added support for
10808           <tag>refdescriptor</tag>.</para>
10809         </listitem>
10810         <listitem>
10811           <para>Added support for multiple <tag>refnamediv</tag>s.</para>
10812         </listitem>
10813         <listitem>
10814           <para>Added support for <tag class="attribute">xml:id</tag></para>
10815         </listitem>
10816         <listitem>
10817           <para><tag>refsynopsisdiv</tag> as a section for
10818           counting section levels</para>
10819         </listitem>
10820       </itemizedlist>
10821       <itemizedlist xml:id="V1680_images">
10822         <title>Images</title>
10823         <listitem>
10824           <para>Added new SVG admonition graphics and navigation images.</para>
10825         </listitem>
10826       </itemizedlist>
10827     </para>
10828   </sect1>
10829   <!-- end of notes for 1.68.0 release -->
10830
10831   <sect1 xml:id="V1672">
10832     <title>Release 1.67.2</title>
10833     <para>This release fixes a table bug introduced in the 1.67.1
10834     release.</para>
10835   </sect1>
10836   <sect1 xml:id="V1671">
10837     <title>Release 1.67.1</title>
10838     <para>This release includes a number of bug fixes.</para>
10839      <para>The following lists provide details about API and feature changes.
10840       <itemizedlist xml:id="V1671_FO">
10841         <title>FO</title>
10842         <listitem>
10843           <para>Tables: Inherited cell properties are now passed to the
10844           <literal>table.cell.properties</literal> template so they can
10845           be overridden by a customization.</para>
10846         </listitem>
10847         <listitem>
10848           <para>Tables: Added support for bgcolor PI on table row
10849           element.</para>
10850         </listitem>
10851         <listitem>
10852           <para>TOCs: Added new parameter
10853           <parameter>simplesect.in.toc</parameter>; default value of
10854           <literal>0</literal> causes simplesect to be omitted from TOCs; to
10855           cause <tag>simplesect</tag> to be included in TOCs, you
10856           must set the value of <parameter>simplesect.in.toc</parameter> to
10857           <literal>1</literal>.Comment from Norm:
10858
10859             <blockquote>
10860               <para><emphasis>Simplesect elements aren't supposed to
10861               appear in the ToC at all... The use case for simplesect
10862               is when, for example, every chapter in a book ends with
10863               "Exercises" or "For More Information" sections and you
10864               don't want those to appear in the ToC.</emphasis></para>
10865             </blockquote>
10866             </para>
10867         </listitem>
10868         <listitem>
10869           <para>Sections: Reverted change that caused a variable reference
10870           to be used in a template match and rewrote code to preserve
10871           intended semantics.</para>
10872         </listitem>
10873         <listitem>
10874           <para>Lists: Added workaround to prevent "* 0.60 + 1em" garbage in
10875           list output from PassiveTeX</para>
10876         </listitem>
10877         <listitem>
10878           <para>Moved the literal attributes from
10879           <parameter>component.title</parameter> to the
10880           <parameter>component.title.properties</parameter> attribute-set so
10881           they can be customized.</para>
10882         </listitem>
10883         <listitem>
10884           <para>Lists: Added <tag>glossdef</tag>'s first
10885           <tag>para</tag> to special handling in
10886           <literal>fo:list-item-body</literal>.</para>
10887         </listitem>
10888       </itemizedlist>
10889
10890       <itemizedlist xml:id="V1671_HTML">
10891         <title>HTML</title>
10892         <listitem>
10893           <para>TOCs: Added new parameter
10894           <parameter>simplesect.in.toc</parameter>; for details, see
10895           the list of <xref linkend="V1671_FO"/> changes for this
10896           release.</para>
10897         </listitem>
10898         <listitem>
10899           <para>Indexing: Added new parameter
10900           <parameter>index.prefer.titleabbrev</parameter>; when set to
10901           <literal>1</literal>, index references will use
10902           <tag>titleabbrev</tag> instead of
10903           <tag>title</tag> when available.</para>
10904         </listitem>
10905       </itemizedlist>
10906       <itemizedlist xml:id="V1671_HELP">
10907         <title>HTML Help</title>
10908         <listitem>
10909           <para>Added support for generating windows-1252-encoded
10910           output using Saxon; for more details, see the list of <xref linkend="V1671_EXT"/> changes for this release.</para>
10911         </listitem>
10912       </itemizedlist>
10913       <itemizedlist xml:id="V1671_MAN">
10914         <title>man pages</title>
10915         <listitem>
10916           <para>Replaced named/numeric character-entity references for
10917           non-breaking space with groff equivalent (backslash-tilde).</para>
10918         </listitem>
10919       </itemizedlist>
10920       <itemizedlist xml:id="V1671_EXT">
10921         <title>XSL Java extensions</title>
10922         <listitem>
10923           <para>Saxon extensions: Added the
10924           <classname>Windows1252</classname> class.  It extends Saxon
10925           6.5.x with the windows-1252 character set, which is
10926           particularly useful when generating HTML Help for Western
10927           European Languages (code from
10928           <personname><firstname>Pontus</firstname>
10929           <surname>Haglund</surname></personname> and contributed to the
10930           DocBook community by Sectra AB, Sweden).</para>
10931           <para>To use:
10932           <orderedlist>
10933             <listitem>
10934               <para>Make sure that the Saxon 6.5.x jar file and the jar file for
10935               the DocBook XSL Java extensions are in your <envar>CLASSPATH</envar></para>
10936             </listitem>
10937             <listitem>
10938               <para>Create a DocBook XSL customization layer -- a file named
10939               <filename>mystylesheet.xsl</filename> or whatever -- that, at a
10940               minimum, contains the following:
10941               <screen>  &lt;xsl:stylesheet
10942     xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
10943     version='1.0'&gt;
10944     &lt;xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/&gt;
10945     &lt;xsl:output method="html" encoding="WINDOWS-1252" indent="no"/&gt;
10946     &lt;xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"&gt;&lt;/xsl:param&gt;
10947     &lt;xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"&gt;&lt;/xsl:param&gt;
10948     &lt;xsl:param name="saxon.character.representation" select="'native'"&gt;&lt;/xsl:param&gt;
10949   &lt;/xsl:stylesheet&gt;</screen>
10950               </para>
10951               <para>Invoke Saxon with the
10952               <literal>encoding.windows-1252</literal> Java system property set
10953               to <literal>com.nwalsh.saxon.Windows1252</literal>; for example
10954               <screen>  java \
10955     -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
10956   com.icl.saxon.StyleSheet \
10957   mydoc.xml mystylesheet.xsl</screen>
10958
10959               Or, for a more complete "real world" case showing other
10960               options you'll typically want to use:
10961               <screen>  java \
10962     -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
10963     -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \
10964     -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \
10965     -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \
10966   com.icl.saxon.StyleSheet \
10967     -x org.apache.xml.resolver.tools.ResolvingXMLReader \
10968     -y org.apache.xml.resolver.tools.ResolvingXMLReader \
10969     -r org.apache.xml.resolver.tools.CatalogResolver \
10970   mydoc.xml mystylesheet.xsl</screen>
10971
10972               In both cases, the "mystylesheet.xsl" file should be a
10973               DocBook customization layer containing the parameters
10974               show in step 2.</para>
10975             </listitem>
10976           </orderedlist>
10977           </para>
10978         </listitem>
10979         <listitem>
10980           <para>Saxon extensions: Removed Saxon 8 extensions from release package</para>
10981         </listitem>
10982       </itemizedlist>
10983     </para>
10984   </sect1>
10985 <sect1 xml:id="V1670">
10986   <title>Release 1.67.0</title>
10987   <itemizedlist>
10988   <listitem>
10989     <para>A number of important bug fixes.</para>
10990   </listitem>
10991   <listitem>
10992     <para>Added Saxon8 extensions</para>
10993   </listitem>
10994   <listitem>
10995     <para>Enabled <literal>dbfo table-width</literal> on
10996     <tag>entrytbl</tag> in FO output</para>
10997   </listitem>
10998   <listitem>
10999     <para>Added support for <literal>role=strong</literal> on
11000     <tag>emphasis</tag> in FO output</para>
11001   </listitem>
11002   <listitem>
11003     <para>Added new FO parameter
11004     <parameter>hyphenate.verbatim</parameter> that can be used to turn
11005     on "intelligent" wrapping of verbatim environments.</para>
11006   </listitem>
11007   <listitem>
11008     <para>Replaced all <literal>&lt;tt&gt;&lt;/tt&gt;</literal> output with
11009     <literal>&lt;code&gt;&lt;/code&gt;</literal></para>
11010   </listitem>
11011   <listitem>
11012     <para>Changed <literal>admon.graphic.width</literal> template to a
11013     mode so that different admonitions can have different graphical
11014     widths.</para>
11015   </listitem>
11016   <listitem>
11017     <para>Deprecated the HTML <parameter>shade.verbatim</parameter>
11018     parameter (use CSS instead)</para>
11019   </listitem>
11020   <listitem>
11021     <para>Wrapped ToC
11022     <tag>refentrytitle</tag>/<tag>refname</tag> and
11023     <tag>refpurpose</tag> in span with class values. This
11024     makes it possible to style them using a CSS stylesheet.</para>
11025   </listitem>
11026   <listitem>
11027     <para>Use <literal>strong/em</literal> instead of
11028     <literal>b/i</literal> in HTML output</para>
11029   </listitem>
11030   <listitem>
11031     <para>Added support for converting <tag>Emphasis</tag> to
11032     groff italic and <tag>Emphasis role='bold'</tag> to
11033     bold. Controlled by
11034     <parameter>emphasis.propagates.style</parameter> param, but not
11035     documented yet using litprog system. Will do that next (planning
11036     to add some other parameter-controllable options for hyphenation
11037     and handling of line spacing).</para>
11038   </listitem>
11039   <listitem>
11040     <para><parameter>callout.graphics.number.limit.xml</parameter>
11041     param: Changed the default from <literal>10</literal> to
11042     <literal>15</literal>.</para>
11043   </listitem>
11044   <listitem>
11045     <para><parameter>verbatim.properties</parameter>: Added
11046     <literal>hyphenate=false</literal></para>
11047   </listitem>
11048   <listitem>
11049     <para>Saxon and Xalan Text.java extensions: Added support for
11050     <methodname>URIResolver()</methodname> on insertfile href's</para>
11051   </listitem>
11052   <listitem>
11053     <para>Added generated <filename>RELEASE-NOTES.txt</filename>
11054     file.</para>
11055   </listitem>
11056   <listitem>
11057     <para>Added <filename>INSTALL</filename> file (executable file for
11058     generating catalog.xml)</para>
11059   </listitem>
11060   <listitem>
11061     <para>Removed obsolete <filename>tools</filename> directory from
11062     package</para>
11063   </listitem>
11064 </itemizedlist>
11065 </sect1>
11066 <sect1 xml:id="V1661">
11067 <title>Release 1.66.1</title>
11068   <itemizedlist>
11069 <listitem>
11070 <para>A number of important bug fixes.
11071 </para>
11072 </listitem>
11073 <listitem>
11074 <para>
11075 Now <literal>xml:base</literal> attributes that are generated by an
11076 XInclude processor are resolved for image files.
11077 </para>
11078 </listitem>
11079 <listitem>
11080 <para>
11081 Rewrote olink templates to support several new features.
11082 </para>
11083 <itemizedlist>
11084 <listitem>
11085 <para>
11086 Extended full olink support to FO output.
11087 </para>
11088 </listitem>
11089 <listitem>
11090 <para>
11091 Add support for <literal>xrefstyle</literal> attribute in olinks.
11092 </para>
11093 </listitem>
11094 <listitem>
11095 <para>
11096 New parameters to support new olink features:
11097 <parameter>insert.olink.page.number</parameter>, <parameter>insert.olink.pdf.frag</parameter>,
11098 <parameter>olink.debug</parameter>, <parameter>olink.lang.fallback.sequence</parameter>, <parameter>olink.properties</parameter>,
11099 <parameter>prefer.internal.olink</parameter>.
11100 See the reference page for each parameter for more
11101 information.</para>
11102 </listitem>
11103 </itemizedlist>
11104 </listitem>
11105 <listitem>
11106 <para>
11107 Added  <parameter>index.on.type</parameter> parameter for new <tag class="attribute">type</tag>
11108 attribute introduced in DocBook 4.3 for indexterms and index.
11109 This allows you to create multiple indices containing
11110 different categories of entries.
11111 For users of 4.2 and earlier, you can use the new parameter <parameter>index.on.role</parameter>
11112 instead.
11113 </para>
11114 </listitem>
11115 <listitem>
11116 <para>
11117 Added new
11118 <parameter>section.autolabel.max.depth</parameter> parameter to turn off section numbering
11119 below a certain depth.
11120 This permits you to number major section levels and leave minor
11121 section levels unnumbered.</para>
11122 </listitem>
11123 <listitem>
11124 <para>
11125 Added <parameter>footnote.sep.leader.properties</parameter> attribute set to format
11126 the line separating footnotes in printed output.
11127 </para>
11128 </listitem>
11129 <listitem>
11130 <para>
11131 Added parameter <parameter>img.src.path</parameter> as a prefix to HTML img src
11132 attributes.
11133 The prefix is added to whatever path is already generated by the
11134 stylesheet for each image file.</para>
11135 </listitem>
11136 <listitem>
11137 <para>
11138 Added new attribute-sets
11139 <parameter>informalequation.properties</parameter>,
11140 <parameter>informalexample.properties</parameter>,
11141 <parameter>informalfigure.properties</parameter>, and <parameter>informaltable.properties</parameter>,
11142 so each such element type can be formatted
11143 individually if needed.
11144 </para>
11145 </listitem>
11146 <listitem>
11147 <para>
11148 Add <parameter>component.label.includes.part.label</parameter>
11149 parameter to add any  part number to chapter, appendix
11150 and other component labels when
11151 the <parameter>label.from.part</parameter> parameter  is nonzero.
11152 This permits you to distinguish multiple chapters with the same
11153 chapter number in cross references and the TOC.</para>
11154 </listitem>
11155 <listitem>
11156 <para>
11157 Added <parameter>chunk.separate.lots</parameter> parameter for HTML output.
11158 This parameter lets you generate separate chunk files for each LOT
11159 (list of tables, list of figures, etc.).</para>
11160 </listitem>
11161 <listitem>
11162 <para>Added several table features:</para>
11163 <itemizedlist>
11164 <listitem>
11165 <para>
11166 Added <parameter>table.table.properties</parameter> attribute set to add
11167 properties to the fo:table element.
11168 </para>
11169 </listitem>
11170 <listitem>
11171 <para>
11172 Added placeholder templates named <literal>table.cell.properties</literal>
11173 and <literal>table.cell.block.properties</literal> to enable adding properties
11174 to any <tag>fo:table-cell</tag> or the cell's <tag>fo:block</tag>, respectively.
11175  These templates are a start for implementing table styles.</para>
11176 </listitem>
11177 </itemizedlist>
11178 </listitem>
11179 <listitem>
11180 <para>
11181 Added new attribute
11182 set <parameter>component.title.properties</parameter> for easy modifications of
11183 component's title formatting in FO output.
11184 </para>
11185 </listitem>
11186 <listitem>
11187 <para>
11188 Added Saxon support for an <tag class="attribute">encoding</tag> attribute on the <tag class="element">textdata</tag> element. Added new parameter
11189 <parameter>textdata.default.encoding</parameter> which specifies encoding when
11190 <tag class="attribute">encoding</tag> attribute on
11191 <tag class="element">textdata</tag> is missing.
11192 </para>
11193 </listitem>
11194 <listitem>
11195 <para>
11196 Template <literal>label.this.section</literal> now controls whole
11197 section label, not only sub-label which corresponds to
11198 particular label. Former behaviour was IMHO bug as it was
11199 not usable.
11200 </para>
11201 </listitem>
11202 <listitem>
11203 <para>
11204 Formatting in titleabbrev for TOC and headers
11205 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.
11206 </para>
11207 </listitem>
11208 <listitem>
11209 <para>
11210 Added <literal>intial.page.number</literal> template to set the <literal>initial-page-number
11211 property</literal> for page sequences in print output.
11212 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.
11213 </para>
11214 </listitem>
11215 <listitem>
11216 <para>
11217 Added <literal>force.page.count</literal> template to set the force-page-count
11218 property for page sequences in print output.
11219 This is similar to the <literal>format.page.number</literal> template.
11220 </para>
11221 </listitem>
11222 <listitem>
11223 <para>
11224 Sort language for localized index sorting in <filename>autoidx-ng.xsl</filename> is now taken from document
11225 lang, not from system environment.
11226 </para>
11227 </listitem>
11228 <listitem>
11229 <para>
11230 Numbering and formatting of normal
11231 and ulink footnotes (if turned on) has been unified.
11232 Now ulink footnotes are mixed in with any other footnotes.</para>
11233 </listitem>
11234 <listitem>
11235 <para>
11236 Added support for <tag>renderas</tag> attribute in section and
11237 sect1 et al.
11238 This permits you to render a given section title as if it were a different level.</para>
11239 </listitem>
11240 <listitem>
11241 <para>
11242 Added support for <tag>label</tag> attribute in footnote to manually
11243 supply the footnote mark.
11244 </para>
11245 </listitem>
11246 <listitem>
11247 <para>
11248 Added support for DocBook 4.3 <tag>corpcredit</tag> element.
11249 </para>
11250 </listitem>
11251 <listitem>
11252 <para>
11253 Added support for a <literal>dbfo keep-together</literal> PI for
11254 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
11255 is very long and the
11256 default keep-together is not appropriate.
11257 </para>
11258 </listitem>
11259 <listitem>
11260 <para>
11261 For graphics files, made file extension matching case
11262 insensitive, and updated the list of graphics extensions.
11263 </para>
11264 </listitem>
11265 <listitem>
11266 <para>
11267 Allow <tag>calloutlist</tag> to have block content before
11268 the first callout
11269 </para>
11270 </listitem>
11271 <listitem>
11272 <para>
11273 Added <literal>dbfo-need</literal> processing instruction to provide
11274 soft page breaks.
11275 </para>
11276 </listitem>
11277 <listitem>
11278 <para>
11279 Added implementation of existing but unused
11280 <parameter>default.image.width</parameter> parameter for graphics.
11281 </para>
11282 </listitem>
11283 <listitem>
11284 <para>
11285 Support DocBook NG <tag>tag</tag> inline element.
11286 </para>
11287 </listitem>
11288 <listitem>
11289 <para>
11290 It appears that XEP now supports Unicode characters in
11291 bookmarks. There is no further need to strip accents from
11292 characters.
11293 </para>
11294 </listitem>
11295 <listitem>
11296 <para>
11297 Make <tag>segmentedlist</tag> HTML markup
11298 more semantic and available to CSS styles.
11299 </para>
11300 </listitem>
11301 <listitem>
11302 <para>
11303 Added <literal>user.preroot</literal> placeholder template to
11304 permit xsl-stylesheet and other PIs and comments to be
11305 output before the HTML root element.
11306 </para>
11307 </listitem>
11308 <listitem>
11309 <para>
11310 Non-chunked legalnotice now gets an &lt;a
11311 name="id"&gt; element in HTML output
11312 so it can be referenced with xref or link.
11313 </para>
11314 </listitem>
11315 <listitem>
11316 <para>
11317 In chunked HTML output, changed <literal>link rel="home"</literal> to <literal>rel="start"</literal>,
11318 and <literal>link rel="previous"</literal> to <literal>rel="prev"</literal>, per W3C HTML 4.01
11319 spec.
11320 </para>
11321 </listitem>
11322 <listitem>
11323 <para>
11324 Added several patches to htmlhelp from W. Borgert
11325 </para>
11326 </listitem>
11327 <listitem>
11328 <para>
11329 Added Bosnian locale file as common/bs.xml.
11330 </para>
11331 </listitem>
11332 </itemizedlist>
11333 </sect1>
11334 <sect1 xml:id="V1650">
11335 <title>Release 1.65.0</title>
11336 <itemizedlist>
11337 <listitem>
11338 <para>A number of important bug fixes.
11339 </para>
11340 </listitem>
11341 <listitem>
11342 <para>Added a workaround to allow these stylesheets to process DocBook NG
11343 documents. (It’s a hack that pre-processes the document to strip off the
11344 namespace and then uses <function>exsl:node-set</function> to process
11345 the result.)
11346 </para>
11347 </listitem>
11348 <listitem>
11349 <para>Added alternative indexing mechanism which has better
11350 internationalization support. New indexing method allows grouping of
11351 accented letters like e, é, ë into the same group under letter "e". It
11352 can also treat special letters (e.g. "ch") as one character and place
11353 them in the correct position (e.g. between "h" and "i" in Czech
11354 language).</para>
11355 <para>In order to use this mechanism you must create customization
11356 layer which imports some base stylesheet (like
11357 <filename>fo/docbook.xsl</filename>,
11358 <filename>html/chunk.xsl</filename>) and then includes appropriate
11359 stylesheet with new indexing code
11360 (<filename>fo/autoidx-ng.xsl</filename> or
11361 <filename>html/autoidx-ng.xsl</filename>). For example:</para>
11362 <programlisting>&lt;xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
11363                 version="1.0"&gt;
11364
11365 &lt;xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/&gt;
11366 &lt;xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/&gt;
11367
11368 &lt;/xsl:stylesheet&gt;</programlisting>
11369 <para>New method is known to work with Saxon and it should also work
11370 with xsltproc 1.1.1 and later. Currently supported languages are
11371 English, Czech, German, French, Spanish and Danish.</para>
11372 </listitem>
11373 </itemizedlist>
11374 </sect1>
11375 <sect1 xml:id="V1641">
11376 <title>Release 1.64.1</title>
11377 <itemizedlist>
11378 <para>General bug fixes and improvements. Sorry about the failure to produce
11379 an updated release notes file for 1.62.0—1.63.2</para>
11380 <listitem>
11381 <para>In the course of fixing bug #849787, wrapping Unicode callouts
11382 with an appropriate font change in the Xalan extensions, I discovered
11383 that the Xalan APIs have changed a bit. So <filename>xalan2.jar</filename>
11384 will work with older Xalan 2 implementations, <filename>xalan25.jar</filename>
11385 works with Xalan 2.5.</para>
11386 </listitem>
11387 </itemizedlist>
11388 </sect1>
11389 <sect1 xml:id="V1610">
11390 <title>Release 1.61.0</title>
11391 <itemizedlist>
11392 <para>Lots of bug fixes and improvements.</para>
11393 <listitem>
11394 <para>Initial support for timestamp PI. From now you
11395   can use &lt;?dbtimestamp format="Y-m-d H:M:S"?&gt; to get current
11396   datetime in your document. Added localization support for datetime PI
11397 </para>
11398 </listitem>
11399 <listitem>
11400 <para>Added level 6 to test for <tag>section</tag> depth in
11401 section.level template so that
11402 section.title.level6.properties will be used for sections
11403 that are 6 deep or deeper. This should also cause a h6 to be
11404 created in html output.
11405 </para>
11406 </listitem>
11407 <listitem>
11408 <para>Don't use SVG graphics if <parameter>use.svg</parameter>=0
11409 </para>
11410 </listitem>
11411 <listitem>
11412 <para>Now uses number-and-title-template for sections
11413   only if <parameter>section.autolabel</parameter> is not zero.
11414 </para>
11415 </listitem>
11416 <listitem>
11417 <para>Added missing 'english-language-name' attribute to
11418 the l10n element, and the missing 'style' attribute to the
11419 template element so the current gentext documents will
11420 validate.
11421 </para>
11422 </listitem>
11423 <listitem>
11424 <para>Corrected several references to parameter
11425   <parameter>qanda.defaultlabel</parameter> that were missing the "$".
11426 </para>
11427 </listitem>
11428 <listitem>
11429 <para>Now accepts <parameter>admon.textlabel</parameter> parameter to turn off
11430   Note, Warning, etc. label.
11431 </para>
11432 </listitem>
11433 <listitem>
11434 <para>FeatReq #684561: support more XEP metadata
11435 </para>
11436 </listitem>
11437 <listitem>
11438 <para>Added hyphenation support. Added support for <tag>coref</tag>.
11439 Added <tag>beginpage</tag> support. (does nothing; see TDG).
11440 </para>
11441 </listitem>
11442 <listitem>
11443 <para>Added support for
11444 hyphenation-character, hyphenation-push-character-count, and
11445 hyphenation-remain-character-count
11446 </para>
11447 </listitem>
11448 <listitem>
11449 <para>Added <parameter>root.properties</parameter>,
11450 <parameter>ebnf.assignment</parameter>,
11451 and <parameter>ebnf.statement.terminator</parameter>
11452 </para>
11453 </listitem>
11454 <listitem>
11455 <para>Support bgcolor PI in table cells; make sure
11456 rowsep and colsep don't have any effect on the last row or
11457 column
11458 </para>
11459 </listitem>
11460 <listitem>
11461 <para>Handle <tag>othercredit</tag> on titlepage a little
11462 better
11463 </para>
11464 </listitem>
11465 <listitem>
11466 <para>Applied fix from Jeff Beal that fixed the bug
11467 that put secondary page numbers on primary entries. Same
11468 with tertiary page numbers on secondary entries.
11469 </para>
11470 </listitem>
11471 <listitem>
11472 <para>Added definition of missing variable
11473 <parameter>collection</parameter>.
11474 </para>
11475 </listitem>
11476 <listitem>
11477 <para>Make <tag>footnote</tag> formatting 'normal' even when it
11478 occurs in a context that has special formatting
11479 </para>
11480 </listitem>
11481 <listitem>
11482 <para>Added warning when <parameter>glossary.collection</parameter> is not
11483 blank, but it cannot open the specified file.
11484 </para>
11485 </listitem>
11486 <listitem>
11487 <para>Pick up the frame attribute on <tag>table</tag> and
11488 <tag>informaltable</tag>.
11489 </para>
11490 </listitem>
11491 <listitem>
11492 <para><tag>indexdiv</tag>/<tag>title</tag>
11493 in non-autogenerated indexes are
11494 now picked up.
11495 </para>
11496 </listitem>
11497 <listitem>
11498 <para>Removed (unused)
11499 component.title.properties
11500 </para>
11501 </listitem>
11502 <listitem>
11503 <para>Move IDs from
11504 page-sequences down to titlepage blocks
11505 </para>
11506 </listitem>
11507 <listitem>
11508 <para>Use
11509 proportional-column-width(1) on more <tag>table</tag>s.
11510 </para>
11511 <para>Use proportional-column-width() for
11512 header/footer tables; suppress relative-align when when
11513 using FOP
11514 </para>
11515 </listitem>
11516 <listitem>
11517 <para>Check for <parameter>glossterm.auto.link</parameter> when linking
11518 firstterms; don't output gl. prefix on glossterm links
11519 </para>
11520 </listitem>
11521 <listitem>
11522 <para>Generate Part ToCs
11523 </para>
11524 </listitem>
11525 <listitem>
11526 <para>Support <tag>glossary</tag>, <tag>bibliography</tag>,
11527 and <tag>index</tag> in component ToCs.
11528 </para>
11529 </listitem>
11530 <listitem>
11531 <para>Refactored chunking code so that
11532 customization of chunk algorithm and chunk elements is more
11533 practical
11534 </para>
11535 </listitem>
11536 <listitem>
11537 <para>Support <tag>textobject</tag>/<tag>phrase</tag>
11538 on <tag>inlinemediaobject</tag>.
11539 </para>
11540 </listitem>
11541 <listitem>
11542 <para>Support 'start' PI on ordered lists
11543 </para>
11544 </listitem>
11545 <listitem>
11546 <para>Fixed test of $toc PI to turn on qandaset TOC.
11547 </para>
11548 </listitem>
11549 <listitem>
11550 <para>Added process.chunk.footnotes to sect2 through
11551 5 to fix bug of missing footnotes when chunk level greater
11552 than 1.
11553 </para>
11554 </listitem>
11555 <listitem>
11556 <para>Added
11557 paramater <parameter>toc.max.depth</parameter> which controls maximal depth of ToC
11558 as requested by PHP-DOC group.
11559 </para>
11560 </listitem>
11561 <listitem>
11562 <para>Exempted <tag>titleabbrev</tag> from preamble processing in
11563 lists, and fixed variablelist preamble code to use the same
11564 syntax as the other lists.
11565 </para>
11566 </listitem>
11567 <listitem>
11568 <para>Added support for elements between variablelist
11569 and first varlistentry since DocBook 4.2 supports that now.
11570 </para>
11571 </listitem>
11572 </itemizedlist>
11573 </sect1>
11574 <sect1 xml:id="V1601">
11575 <title>Release 1.60.1</title>
11576 <itemizedlist>
11577 <para>Lots of bug fixes.</para>
11578 <listitem>
11579 <para>The format of the <filename>titlepage.templates.xml</filename> files and
11580 the stylesheet that transforms them have been significantly changed. All of the
11581 attributes used to control the templates are now namespace qualified. So what
11582 used to be:</para>
11583 <programlisting>&lt;t:titlepage element="article" wrapper="fo:block"&gt;</programlisting>
11584 <para>is now:</para>
11585 <programlisting>&lt;t:titlepage t:element="article" t:wrapper="fo:block"&gt;</programlisting>
11586 <para>Attributes from other namespaces (including those that are unqualified) are
11587 now copied directly through. In practice, this means that the names that used
11588 to be <quote>fo:</quote> qualified:</para>
11589 <programlisting>&lt;title named-template="component.title"
11590        param:node="ancestor-or-self::article[1]"
11591        fo:text-align="center"
11592        fo:keep-with-next="always"
11593        fo:font-size="&amp;hsize5;"
11594        fo:font-weight="bold"
11595        fo:font-family="{$title.font.family}"/&gt;</programlisting>
11596 <para>are now unqualified:</para>
11597 <programlisting>&lt;title t:named-template="component.title"
11598        param:node="ancestor-or-self::article[1]"
11599        text-align="center"
11600        keep-with-next="always"
11601        font-size="&amp;hsize5;"
11602        font-weight="bold"
11603        font-family="{$title.font.family}"/&gt;</programlisting>
11604 <para>The <tag>t:titlepage</tag> and <tag>t:titlepage-content</tag>
11605 elements both generate wrappers now. And unqualified attributes on those elements
11606 are passed through. This means that you can now make the title font apply to
11607 ane entire titlepage and make the entire <quote>recto</quote>
11608 titlepage centered by specifying the font and alignment on the those elements:</para>
11609 <programlisting>&lt;t:titlepage t:element="article" t:wrapper="fo:block"
11610              font-family="{$title.font.family}"&gt;
11611
11612   &lt;t:titlepage-content t:side="recto"
11613              text-align="center"&gt;</programlisting>
11614
11615
11616
11617
11618
11619 </listitem>
11620 <listitem>
11621 <para>Support use of <tag>titleabbrev</tag> in running
11622 headers and footers.
11623 </para>
11624 </listitem>
11625 <listitem>
11626 <para>Added (experimental) <parameter>xref.with.number.and.title</parameter>
11627 parameter to enable number/title cross references even when the
11628 default would
11629 be just the number.
11630 </para>
11631 </listitem>
11632 <listitem>
11633 <para>Generate <tag>part</tag> ToCs if they're requested.
11634 </para>
11635 </listitem>
11636 <listitem>
11637 <para>Use proportional-column-width() in header/footer tables.
11638 </para>
11639 </listitem>
11640 <listitem>
11641 <para>Handle alignment correctly when <tag>screenshot</tag>
11642 wraps a graphic in a <tag>figure</tag>.
11643 </para>
11644 </listitem>
11645 <listitem>
11646 <para>Format <tag>chapter</tag> and <tag>appendix</tag>
11647 cross references consistently.
11648 </para>
11649 </listitem>
11650 <listitem>
11651 <para>Attempt to support tables with multiple <tag>tgroup</tag>s
11652 in FO.
11653 </para>
11654 </listitem>
11655 <listitem>
11656 <para>Output <tag>fo:table-columns</tag> in
11657 <tag>simplelist</tag> tables.
11658 </para>
11659 </listitem>
11660 <listitem>
11661 <para>Use <filename>titlepage.templates.xml</filename> for
11662 <tag>indexdiv</tag> and <tag>glossdiv</tag> formatting.
11663 </para>
11664 </listitem>
11665 <listitem>
11666 <para>Improve support for new bibliography elements.
11667 </para>
11668 </listitem>
11669 <listitem>
11670 <para>Added
11671 <parameter>footnote.number.format</parameter>,
11672 <parameter>table.footnote.number.format</parameter>,
11673 <parameter>footnote.number.symbols</parameter>, and
11674 <parameter>table.footnote.number.symbols</parameter> for better control of
11675 footnote markers.
11676 </para>
11677 </listitem>
11678 <listitem>
11679 <para>Added <tag>glossentry.show.acronyms</tag>.
11680 </para>
11681 </listitem>
11682 <listitem>
11683 <para>Suppress the draft-mode page masters when
11684 <parameter>draft-mode</parameter> is <quote>no</quote>.
11685 </para>
11686 </listitem>
11687 <listitem>
11688 <para>Make blank pages verso not recto. D'Oh!
11689 </para>
11690 </listitem>
11691 <listitem>
11692 <para>Improved formatting of <tag>ulink</tag> footnotes.
11693 </para>
11694 </listitem>
11695 <listitem>
11696 <para>Fixed bugs in graphic width/height calculations.
11697 </para>
11698 </listitem>
11699 <listitem>
11700 <para>Added class attributes to inline elements.
11701 </para>
11702 </listitem>
11703 <listitem>
11704 <para>Don't add <quote>.html</quote> to the filenames identified
11705 with the <quote>dbhtml</quote> PI.
11706 </para>
11707 </listitem>
11708 <listitem>
11709 <para>Don't force a ToC when sections contain <tag>refentry</tag>s.
11710 </para>
11711 </listitem>
11712 <listitem>
11713 <para>Make section title sizes a function of the
11714 <parameter>body.master.size</parameter>.
11715 </para>
11716 </listitem>
11717 </itemizedlist>
11718 </sect1>
11719 <sect1 xml:id="V1592">
11720 <title>Release 1.59.2</title>
11721 <itemizedlist>
11722 <para>The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail.
11723 </para>
11724 <listitem>
11725 <para>Removed the region-name from the region-body of blank pages. There's
11726 no reason to give the body of blank pages a unique name and doing so causes
11727 a mismatch that FOP detects.
11728 </para>
11729 </listitem>
11730 <listitem>
11731 <para>Output IDs for the first paragraphs in listitems.
11732 </para>
11733 </listitem>
11734 <listitem>
11735 <para>Fixed some small bugs in the handling of page numbers in double-sided mode.
11736 </para>
11737 </listitem>
11738 <listitem>
11739 <para>Attempt to prevent duplicated IDs from being produced when
11740 <tag class="attribute">endterm</tag> on <tag>xref</tag> points
11741 to something with nested structure.
11742 </para>
11743 </listitem>
11744 <listitem>
11745 <para>Fix aligment problems in <tag>equation</tag>s.
11746 </para>
11747 </listitem>
11748 <listitem>
11749 <para>Output the type attribute on unordered lists (UL) in HTML only if
11750 the css.decoration parameter is true.
11751 </para>
11752 </listitem>
11753 <listitem>
11754 <para>Calculate the font size in formal.title.properties so that it's 1.2 times
11755 the base font size, not a fixed "12pt".
11756 </para>
11757 </listitem>
11758 </itemizedlist>
11759 </sect1>
11760 <sect1 xml:id="V1591">
11761 <title>Release 1.59.1</title>
11762 <itemizedlist>
11763 <para>The 1.59.1 fixes a few bugs.
11764 </para>
11765 <listitem>
11766 <para>Added Bulgarian localization.
11767 </para>
11768 </listitem>
11769 <listitem>
11770 <para>Indexing improvements; localize book indexes to books but allow setindex
11771 to index an entire set.
11772 </para>
11773 </listitem>
11774 <listitem>
11775 <para>The default value for rowsep and colsep is now "1" as per CALS.
11776 </para>
11777 </listitem>
11778 <listitem>
11779 <para>Added support for <tag>titleabbrev</tag> (use them for cross
11780 references).
11781 </para>
11782 </listitem>
11783 <listitem>
11784 <para>Improvements to <tag>mediaobject</tag> for selecting print vs. online
11785 images.
11786 </para>
11787 </listitem>
11788 <listitem>
11789 <para>Added seperate property sets for <tag>figure</tag>s,
11790 <tag>example</tag>s, <tag>equation</tag>s, <tag>tables</tag>s,
11791 and <tag>procedure</tag>s.
11792 </para>
11793 </listitem>
11794 <listitem>
11795 <para>Make <tag>lineannotation</tag>s italic.
11796 </para>
11797 </listitem>
11798 <listitem>
11799 <para>Support <tag class="attribute">xrefstyle</tag> attribute.
11800 </para>
11801 </listitem>
11802 <listitem>
11803 <para>Make <tag class="attribute">endterm</tag> on
11804 <tag>xref</tag> higher priority than
11805 <tag class="attribute">xreflabel</tag> target.
11806 </para>
11807 </listitem>
11808 <listitem>
11809 <para>Glossary formatting improvements.
11810 </para>
11811 </listitem>
11812 </itemizedlist>
11813 </sect1>
11814 <sect1 xml:id="V1580">
11815 <title>Release 1.58.0</title>
11816 <itemizedlist>
11817 <para>The 1.58.0 adds some initial support for extensions in xsltproc, adds
11818 a few features, and fixes bugs.
11819 </para>
11820 <listitem>
11821 <para>This release contains the first attempt at extension support for xsltproc.
11822 The only extension available to date is the one that adjusts table column widths.
11823 Run <filename>extensions/xsltproc/python/xslt.py</filename>.
11824 </para>
11825 </listitem>
11826 <listitem>
11827 <para>Fixed bugs in calculation of adjusted column widths to correct for rounding
11828 errors.
11829 </para>
11830 </listitem>
11831 <listitem>
11832 <para>Support nested <tag>refsection</tag> elements correctly.
11833 </para>
11834 </listitem>
11835 <listitem>
11836 <para>Reworked <literal>gentext.template</literal> to take context into consideration.
11837 The name of elements in localization files is now an xpath-like context list, not
11838 just a simple name.
11839 </para>
11840 </listitem>
11841 <listitem>
11842 <para>Made some improvements to bibliography formatting.
11843 </para>
11844 </listitem>
11845 <listitem>
11846 <para>Improved graphical formatting of admonitions.
11847 </para>
11848 </listitem>
11849 <listitem>
11850 <para>Added support for <tag>entrytbl</tag>.
11851 </para>
11852 </listitem>
11853 <listitem>
11854 <para>Support spanning index terms.
11855 </para>
11856 </listitem>
11857 <listitem>
11858 <para>Support <tag>bibliosource</tag>.
11859 </para>
11860 </listitem>
11861 </itemizedlist>
11862 </sect1>
11863 <sect1 xml:id="V1570">
11864 <title>Release 1.57.0</title>
11865 <itemizedlist>
11866 <listitem>
11867 <para>The 1.57.0 release wasn't documented here. Oops.
11868 </para>
11869 </listitem>
11870 </itemizedlist>
11871 </sect1>
11872 <sect1 xml:id="V1560">
11873 <title>Release 1.56.0</title>
11874 <itemizedlist>
11875 <para>The 1.56.0 release fixes bugs.
11876 </para>
11877 <listitem>
11878 <para>Reworked chunking. <emphasis>This will break all existing customizations
11879 layers that change the chunking algorithm.</emphasis> If you're customizing chunking,
11880 look at the new <quote>content</quote> parameter that's passed to
11881 <literal>process-chunk-element</literal> and friends.
11882 </para>
11883 </listitem>
11884 <listitem>
11885 <para>Support continued and inherited numeration in <tag>orderedlist</tag>
11886 formatting for FOs.
11887 </para>
11888 </listitem>
11889 <listitem>
11890 <para>Added Thai localization.
11891 </para>
11892 </listitem>
11893 <listitem>
11894 <para>Tweaked stylesheet documentation stylesheets to link to TDG and
11895 the parameter references.
11896 </para>
11897 </listitem>
11898 <listitem>
11899 <para>Allow title on tables of contents ("Table of Contents") to be optional.
11900 Added new keyword to <parameter>generate.toc</parameter>.
11901 Support tables of contents on sections.
11902 </para>
11903 </listitem>
11904 <listitem>
11905 <para>Made separate parameters for table borders and table cell borders:
11906 <parameter>table.frame.border.color</parameter>,
11907 <parameter>table.frame.border.style</parameter>,
11908 <parameter>table.frame.border.thickness</parameter>,
11909 <parameter>table.cell.border.color</parameter>,
11910 <parameter>table.cell.border.style</parameter>, and
11911 <parameter>table.cell.border.thickness</parameter>.
11912 </para>
11913 </listitem>
11914 <listitem>
11915 <para>Suppress formatting of <quote>endofrange</quote> <tag>indexterm</tag>s.
11916 This is only half-right. They should generate a range, but I haven't figured out how
11917 to do that yet.
11918 </para>
11919 </listitem>
11920 <listitem>
11921 <para>Support <tag>revdescription</tag>. (Bug #582192)
11922 </para>
11923 </listitem>
11924 <listitem>
11925 <para>Added <parameter>default.float.class</parameter> and fixed figure
11926 floats. (Bug #497603)
11927 </para>
11928 </listitem>
11929 <listitem>
11930 <para>Fixed formatting of <tag>sbr</tag> in FOs.
11931 </para>
11932 </listitem>
11933 <listitem>
11934 <para>Added context to the <quote>missing template</quote> error message.
11935 </para>
11936 </listitem>
11937 <listitem>
11938 <para>Process <tag>arg</tag> correctly in a <tag>group</tag>.
11939 (Bug #605150)
11940 </para>
11941 </listitem>
11942 <listitem>
11943 <para>Removed 'keep-with-next' from <parameter>formal.title.properties</parameter>
11944 attribute set now that the stylesheets support the option of putting
11945 such titles below the object. Now the $placement value determines if
11946 'keep-with-next' or 'keep-with-previous' is used in the title block.
11947 </para>
11948 </listitem>
11949 <listitem>
11950 <para>Wrap <quote>url()</quote> around external-destinations when appropriate.
11951 </para>
11952 </listitem>
11953 <listitem>
11954 <para>Fixed typo in compact list spacing. (Bug #615464)
11955 </para>
11956 </listitem>
11957 <listitem>
11958 <para>Removed spurious hash in anchor name. (Bug #617717)
11959 </para>
11960 </listitem>
11961 <listitem>
11962 <para>Address is now displayed verbatim on title pages. (Bug #618600)
11963 </para>
11964 </listitem>
11965 <listitem>
11966 <para>The <parameter>bridgehead.in.toc</parameter> parameter is now properly
11967 supported.
11968 </para>
11969 </listitem>
11970 <listitem>
11971 <para>Improved effectiveness of HTML cleanup by increasing the number
11972 of places where it is used. Improve use of HTML cleanup in XHTML stylesheets.
11973 </para>
11974 </listitem>
11975 <listitem>
11976 <para>Support table of contents for <tag>appendix</tag> in
11977 <tag>article</tag>. (Bug #596599)
11978 </para>
11979 </listitem>
11980 <listitem>
11981 <para>Don't duplicate footnotes in <tag>bibliography</tag>s and
11982 <tag>glossary</tag>s. (Bug #583282)
11983 </para>
11984 </listitem>
11985 <listitem>
11986 <para>Added <parameter>default.image.width</parameter>. (Bug #516859)
11987 </para>
11988 </listitem>
11989 <listitem>
11990 <para>Totally reworked <tag>funcsynopsis</tag> code; it now
11991 supports a 'tabular' presentation style for 'wide' prototypes; see
11992 <parameter>funcsynopsis.tabular.threshold</parameter>. (HTML only
11993 right now, I think, FO support, uh, real soon now.)
11994 </para>
11995 </listitem>
11996 <listitem>
11997 <para>Reworked support for difference marking; toned down the colors a bit
11998 and added a <quote>system.head.content</quote> template so that the diff CSS
11999 wasn't overriding <quote>user.head.content</quote>. (Bug #610660)
12000 </para>
12001 </listitem>
12002 <listitem>
12003 <para>Added call to the <quote>*.head.content</quote> elements when writing
12004 out long description chunks.
12005 </para>
12006 </listitem>
12007 <listitem>
12008 <para>Make sure <tag>legalnotice</tag> link is correct even when
12009 chunking to a different <parameter>base.dir</parameter>.
12010 </para>
12011 </listitem>
12012 <listitem>
12013 <para>Use CSS to set viewport characteristics if
12014 <parameter>css.decoration</parameter> is non-zero, use div instead of p for making
12015 graphic a block element; make figure <tag>title</tag>s the
12016 default alt
12017 text for images in a <tag>figure</tag>.</para>
12018 </listitem>
12019 <listitem>
12020 <para>Added space-after to <parameter>list.block.spacing</parameter>.
12021 </para>
12022 </listitem>
12023 <listitem>
12024 <para>Reworked section.level template to give <quote>correct</quote> answer
12025 instead of being off by one.
12026 </para>
12027 </listitem>
12028 <listitem>
12029 <para>When processing tables, use the <tag class="attribute">tabstyle</tag>
12030 attribute as the division class.
12031 </para>
12032 </listitem>
12033 <listitem>
12034 <para>Fixed bug in <filename>html2xhtml.xsl</filename> that was causing the
12035 XHTML chunker to output HTML instead of XHTML.
12036 </para>
12037 </listitem>
12038 </itemizedlist>
12039 </sect1>
12040 <sect1 xml:id="VOlder">
12041   <title>Older releases</title>
12042   <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
12043   aware that there were no release notes for releases prior to the
12044   1.50.0 release.</para>
12045 </sect1>
12046 <sect1 xml:id="dot0">
12047   <title>About dot-zero releases</title>
12048     <para>DocBook Project “dot zero” releases should be
12049     considered <emphasis>experimental</emphasis> and are always
12050     followed by stable “dot one plus” releases, usually within
12051     two or three weeks. Please help to ensure the stability of
12052     “dot one plus” releases by carefully testing each
12053     “dot zero” release and reporting back about any
12054     problems you find. </para>
12055     <para>It is not recommended that you use a “dot zero”
12056     release in a production system. Instead, you should wait for
12057     the “dot one” or greater versions.</para>
12058   </sect1>
12059 </article>