1<html><head> 2 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> 3 <title>Release Notes</title><meta name="generator" content="DocBook XSL Stylesheets V1.70.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="releasenotes"></a>Release Notes</h1></div><div><h3 class="subtitle"><i>DocBook Project XSL Stylesheets</i></h3></div><div><div class="author"><h3 class="author"></h3></div></div><div><p class="releaseinfo">$Revision: 1.51 $ $Date: 2006/05/24 14:39:48 $</p></div><div><p class="pubdate">2006-05-26</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#V1701">Release: 1.70.1</a></span></dt><dd><dl><dt><span class="sect2"><a href="#V1701_FO">FO</a></span></dt><dt><span class="sect2"><a href="#V1701_HTML">HTML</a></span></dt><dt><span class="sect2"><a href="#V1701_HTMLHelp">HTMLHelp</a></span></dt><dt><span class="sect2"><a href="#V1701_Params">Params</a></span></dt></dl></dd><dt><span class="sect1"><a href="#V1700">Release: 1.70.0</a></span></dt><dd><dl><dt><span class="sect2"><a href="#V1700_Common">Common</a></span></dt><dt><span class="sect2"><a href="#V1700_Extensions">Extensions</a></span></dt><dt><span class="sect2"><a href="#V1700_FO">FO</a></span></dt><dt><span class="sect2"><a href="#V1700_HTML">HTML</a></span></dt><dt><span class="sect2"><a href="#V1700_Manpages">Manpages</a></span></dt><dt><span class="sect2"><a href="#V1700_Params">Params</a></span></dt><dt><span class="sect2"><a href="#V1700_Profiling">Profiling</a></span></dt><dt><span class="sect2"><a href="#V1700_Tools">Tools</a></span></dt><dt><span class="sect2"><a href="#V1700_WordML">WordML</a></span></dt></dl></dd><dt><span class="sect1"><a href="#V1691">Release 1.69.1</a></span></dt><dt><span class="sect1"><a href="#V1690">Release 1.69.0</a></span></dt><dd><dl><dt><span class="sect2"><a href="#V1690_COMMON">Common</a></span></dt><dt><span class="sect2"><a href="#V1690_FO">FO</a></span></dt><dt><span class="sect2"><a href="#V1690_HELP">Help</a></span></dt><dt><span class="sect2"><a href="#V1690_HTML">HTML</a></span></dt><dt><span class="sect2"><a href="#V1690_MAN">man</a></span></dt></dl></dd><dt><span class="sect1"><a href="#V1681">Release 1.68.1</a></span></dt><dt><span class="sect1"><a href="#V1680">Release 1.68.0</a></span></dt><dt><span class="sect1"><a href="#V1672">Release 1.67.2</a></span></dt><dt><span class="sect1"><a href="#V1671">Release 1.67.1</a></span></dt><dt><span class="sect1"><a href="#V1670">Release 1.67.0</a></span></dt><dt><span class="sect1"><a href="#V1661">Release 1.66.1</a></span></dt><dt><span class="sect1"><a href="#V1650">Release 1.65.0</a></span></dt><dt><span class="sect1"><a href="#V1641">Release 1.64.1</a></span></dt><dt><span class="sect1"><a href="#V1610">Release 1.61.0</a></span></dt><dt><span class="sect1"><a href="#V1601">Release 1.60.1</a></span></dt><dt><span class="sect1"><a href="#V1592">Release 1.59.2</a></span></dt><dt><span class="sect1"><a href="#V1591">Release 1.59.1</a></span></dt><dt><span class="sect1"><a href="#V1580">Release 1.58.0</a></span></dt><dt><span class="sect1"><a href="#V1570">Release 1.57.0</a></span></dt><dt><span class="sect1"><a href="#V1560">Release 1.56.0</a></span></dt><dt><span class="sect1"><a href="#VOlder">Older releases</a></span></dt><dt><span class="sect1"><a href="#dot0">About dot-zero releases</a></span></dt></dl></div> 4 5 6<p>These are the release notes for the DocBook XSL Stylesheets 7distribution. This document lists enhancements and changes to the 8public APIs (user-configurable parameters) and generally excludes 9descriptions of bug fixes, which are instead documented in a 10separate <a href="NEWS" target="_top">NEWS</a> file.</p> 11 12<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1701"></a>Release: 1.70.1</h2></div></div></div> 13 14 15<p>This is a stable release of the 1.70 stylesheets. It includes only a 16few small changes from 1.70.0.</p> 17 18<p>The following is a list of changes that have been made 19 since the 1.70.0 release.</p> 20 21<div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1701_FO"></a>FO</h3></div></div></div> 22 23<p>The following changes have been made to the 24 <code class="filename">fo</code> code 25 since the 1.70.0 release.</p> 26<div class="itemizedlist"><ul type="disc"><li> 27<p>Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output.</p> 28<p class="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</p> 29</li><li> 30<p>Support DBv5 revisions with full author name (not only authorinitials)</p> 31<p class="commit-changes">Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek</p> 32</li></ul></div> 33</div> 34 35<div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1701_HTML"></a>HTML</h3></div></div></div> 36 37<p>The following changes have been made to the 38 <code class="filename">html</code> code 39 since the 1.70.0 release.</p> 40<div class="itemizedlist"><ul type="disc"><li> 41<p>Support DBv5 revisions with full author name (not only authorinitials)</p> 42<p class="commit-changes">Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek</p> 43</li></ul></div> 44</div> 45 46<div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1701_HTMLHelp"></a>HTMLHelp</h3></div></div></div> 47 48<p>The following changes have been made to the 49 <code class="filename">htmlhelp</code> code 50 since the 1.70.0 release.</p> 51<div class="itemizedlist"><ul type="disc"><li> 52<p>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).</p> 53<p class="commit-changes">Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek</p> 54</li><li> 55<p>Support chunk.tocs.and.lots in HTML Help</p> 56<p class="commit-changes">Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek</p> 57</li></ul></div> 58</div> 59 60<div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1701_Params"></a>Params</h3></div></div></div> 61 62<p>The following changes have been made to the 63 <code class="filename">params</code> code 64 since the 1.70.0 release.</p> 65<div class="itemizedlist"><ul type="disc"><li> 66<p>Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output.</p> 67<p class="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</p> 68</li></ul></div> 69</div> 70 71</div> 72 73<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1700"></a>Release: 1.70.0</h2></div></div></div> 74 75<p>As with all DocBook Project <a href="#dot0" title="About dot-zero releases">dot-zero</a> 76releases, this is an experimental release. It will be followed shortly 77by a stable release.</p> 78 79<p>This release adds a number of new features, 80including:</p> 81 82<div class="itemizedlist"><ul type="disc"><li> 83 <p>support for selecting alternative index-collation methods 84 (in particular, support for using a collation library developed by 85 Eliot Kimber)</p> 86 </li><li> 87 <p>improved handling of DocBook 5 document instances (through a 88 namespace-stripping mechanism)</p> 89 </li><li> 90 <p>full support for CALS and HTML tables in manpages 91 output</p> 92 </li><li> 93 <p>a mechanism for preserving relative URIs in documents that 94 make use of XInclude</p> 95 </li><li> 96 <p>support for the "new" <code class="literal">.90</code> version of 97 FOP</p> 98 </li><li> 99 <p>enhanced capabilities for controlling formatting of lists in HTML 100 and FO output</p> 101 </li><li> 102 <p>autogeneration of AUTHOR and COPYRIGHT sections in manpages 103 output</p> 104 </li><li> 105 <p>support for generating crop marks in FO/PDF output</p> 106 </li><li> 107 <p>support for qandaset as a root element in FO output</p> 108 </li><li> 109 <p>support for floatstyle and orient on all table types</p> 110 </li><li> 111 <p>support for floatstyle in figure, and example</p> 112 </li><li> 113 <p>pgwide.properties attribute-set supports extending figure, 114 example and table into the left indent area instead of spanning 115 multiple columns.</p> 116 </li></ul></div> 117 <p>The following is a detailed list of enhancements and API 118 changes that have been made since the 1.69.1 release.</p> 119 120<div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1700_Common"></a>Common</h3></div></div></div> 121 122<p>The following changes have been made to the 123 <code class="filename">common</code> code 124 since the 1.69.1 release.</p> 125<div class="itemizedlist"><ul type="disc"><li> 126<p>Add the xsl:key for the kimber 127indexing method.</p> 128<p class="commit-changes">Modified: common/autoidx-ng.xsl,1.2 - Robert 129Stayton</p> 130</li><li> 131<p>Add support for 132<a href="http://docbook.org/tdg/en/html/qandaset.html"><code class="sgmltag-element">qandaset</code></a>.</p> 133<p class="commit-changes">Modified: common/labels.xsl,1.37; 134common/subtitles.xsl,1.7; common/titles.xsl,1.35 - Robert 135Stayton</p> 136</li><li> 137<p>Support dbhtml/dbfo start PI for 138<a href="http://docbook.org/tdg/en/html/orderedlist.html"><code class="sgmltag-element">orderedlist</code></a> numbering in both HTML and 139FO</p> 140<p class="commit-changes">Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman 141Walsh</p> 142</li><li> 143<p>Added CVS 144header.</p> 145<p class="commit-changes">Modified: common/stripns.xsl,1.12 - Robert 146Stayton</p> 147</li><li> 148<p>Changed content model of text 149element to ANY rather than #PCDATA because they could contain 150markup.</p> 151<p class="commit-changes">Modified: common/targetdatabase.dtd,1.7 - Robert 152Stayton</p> 153</li><li> 154<p>Added 155<a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>.meta.get.quietly param.</p> 156<p>If zero (the 157default), notes and warnings about "missing" markup are generated 158during gathering of <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> metadata. If 159non-zero, the metadata is gathered "quietly" -- that is, the 160notes and warnings are suppressed.</p> 161<p>NOTE: If you are 162processing a large amount of <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> content, you 163may be able to speed up processing significantly by setting a 164non-zero value for 165<a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>.meta.get.quietly.</p> 166<p class="commit-changes">Modified: common/refentry.xsl,1.17; 167manpages/param.ent,1.15; manpages/param.xweb,1.17; 168params/refentry.meta.get.quietly.xml,1.1 - Michael(tm) 169Smith</p> 170</li><li> 171<p>After namespace stripping, the 172source document is the temporary tree created by the stripping 173process and it has the wrong base <a href="http://docbook.org/tdg/en/html/uri.html"><code class="sgmltag-element">URI</code></a> for relative 174references. Earlier versions of this code used to try to fix that 175by patching the elements with relative @fileref attributes. That 176was inadequate because it calculated an absolute base <a href="http://docbook.org/tdg/en/html/uri.html"><code class="sgmltag-element">URI</code></a> 177without considering that there might be xml:base attributes 178already in effect. It seems obvious now that the right thing to 179do is simply to put the xml:base on the root of the document. And 180that seems to work.</p> 181<p class="commit-changes">Modified: common/stripns.xsl,1.7 - Norman 182Walsh</p> 183</li><li> 184<p>Added support for "software" and 185"sectdesc" class values on <a href="http://docbook.org/tdg/en/html/refmiscinfo.html"><code class="sgmltag-element">refmiscinfo</code></a>; "software" is 186treated identically to "source", and "setdesc" is treated 187identically to "manual".</p> 188<p class="commit-changes">Modified: common/refentry.xsl,1.10; 189params/man.th.extra2.max.length.xml,1.3; 190params/refentry.source.name.profile.xml,1.4 - Michael(tm) 191Smith</p> 192</li><li> 193<p>Added support for DocBook 5 194namespace-stripping in manpages stylesheet. Closes request 195#1210692.</p> 196<p class="commit-changes">Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - 197Michael(tm) Smith</p> 198</li><li> 199<p>Added <xsl:template 200match="/"> to make stripns.xsl usable as a standalone 201stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that 202DocBook XSLT drivers that include this stylesheet all override 203the match="/" template.</p> 204<p class="commit-changes">Modified: common/stripns.xsl,1.4 - Michael(tm) 205Smith</p> 206</li><li> 207<p>Number figures, examples, and 208tables from <a href="http://docbook.org/tdg/en/html/book.html"><code class="sgmltag-element">book</code></a> if there is no prefix (i.e. if 209<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chapter.autolabel.html"><em class="parameter"><code>chapter.autolabel</code></em></a> is set to 0). This avoids 210having the list of figures where the figures mysteriously restart 211their numeration periodically when 212<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chapter.autolabel.html"><em class="parameter"><code>chapter.autolabel</code></em></a> is set to 2130.</p> 214<p class="commit-changes">Modified: common/labels.xsl,1.36 - David Cramer</p> 215</li><li> 216<p>Add <a href="http://docbook.org/tdg/en/html/task.html"><code class="sgmltag-element">task</code></a> template in 217<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a>.markup mode.</p> 218<p class="commit-changes">Modified: common/titles.xsl,1.34 - Robert 219Stayton</p> 220</li><li> 221<p>Add children (with ids) of formal 222objects to target data.</p> 223<p class="commit-changes">Modified: common/targets.xsl,1.10 - Robert 224Stayton</p> 225</li><li> 226<p>Added support for case when 227<a href="http://docbook.org/tdg/en/html/personname.html"><code class="sgmltag-element">personname</code></a> doesn't contain specific name markup (as allowed 228in DocBook 5.0)</p> 229<p class="commit-changes">Modified: common/common.xsl,1.54 - Jirka 230Kosek</p> 231</li></ul></div> 232</div> 233 234<div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1700_Extensions"></a>Extensions</h3></div></div></div> 235 236<p>The following changes have been made to the 237 <code class="filename">extensions</code> code 238 since the 1.69.1 release.</p> 239<div class="itemizedlist"><ul type="disc"><li> 240<p>Support Xalan 2412.7</p> 242<p class="commit-changes">Modified: extensions/xalan27/.cvsignore,1.1; 243extensions/xalan27/build.xml,1.1; 244extensions/xalan27/nbproject/.cvsignore,1.1; 245extensions/xalan27/nbproject/build-impl.xml,1.1; 246extensions/xalan27/nbproject/genfiles.properties,1.1; 247extensions/xalan27/nbproject/project.properties,1.1; 248extensions/xalan27/nbproject/project.xml,1.1; 249extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1; 250extensions/xalan27/src/com/nwalsh/xalan/Callout.java,1.1; 251extensions/xalan27/src/com/nwalsh/xalan/FormatCallout.java,1.1; 252extensions/xalan27/src/com/nwalsh/xalan/FormatDingbatCallout.java,1.1; 253extensions/xalan27/src/com/nwalsh/xalan/FormatGraphicCallout.java,1.1; 254extensions/xalan27/src/com/nwalsh/xalan/FormatTextCallout.java,1.1; 255extensions/xalan27/src/com/nwalsh/xalan/FormatUnicodeCallout.java,1.1; 256extensions/xalan27/src/com/nwalsh/xalan/Func.java,1.1; 257extensions/xalan27/src/com/nwalsh/xalan/ImageIntrinsics.java,1.1; 258extensions/xalan27/src/com/nwalsh/xalan/Params.java,1.1; 259extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1; 260extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1; 261extensions/xalan27/src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman 262Walsh</p> 263</li><li> 264<p>Handle the case where the imageFn 265is actually a <a href="http://docbook.org/tdg/en/html/uri.html"><code class="sgmltag-element">URI</code></a>. This still needs 266work.</p> 267<p class="commit-changes">Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4 268- Norman Walsh</p> 269</li></ul></div> 270</div> 271 272<div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1700_FO"></a>FO</h3></div></div></div> 273 274<p>The following changes have been made to the 275 <code class="filename">fo</code> code 276 since the 1.69.1 release.</p> 277<div class="itemizedlist"><ul type="disc"><li> 278<p>Adapted to the new indexing 279code. Now works just like a wrapper that calls kosek indexing method, 280originally implemented here.</p> 281<p class="commit-changes">Modified: fo/autoidx-ng.xsl,1.5 - Jirka 282Kosek</p> 283</li><li> 284<p>Added parameters for header/footer 285<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> minimum height.</p> 286<p class="commit-changes">Modified: fo/pagesetup.xsl,1.60; 287fo/param.ent,1.100; fo/param.xweb,1.113 - Robert 288Stayton</p> 289</li><li> 290<p>Add the <a href="http://docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a>.method 291parameter.</p> 292<p class="commit-changes">Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert 293Stayton</p> 294</li><li> 295<p>Integrate support for three 296indexing methods: - the original English-only method. - 297Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's 298method using Saxon extensions. Use the '<a href="http://docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a>.method' 299parameter to select.</p> 300<p class="commit-changes">Modified: fo/autoidx.xsl,1.38 - Robert 301Stayton</p> 302</li><li> 303<p>Add support for <a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">TOC</code></a> for 304<a href="http://docbook.org/tdg/en/html/qandaset.html"><code class="sgmltag-element">qandaset</code></a> in fo output.</p> 305<p class="commit-changes">Modified: fo/autotoc.xsl,1.30; 306fo/qandaset.xsl,1.20 - Robert Stayton</p> 307</li><li> 308<p>Added parameter 309<a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/ulink.hyphenate.html"><em class="parameter"><code>ulink.hyphenate</code></em></a>.chars. Added parameter 310insert.<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>.page.number.</p> 311<p class="commit-changes">Modified: fo/param.ent,1.98; 312fo/param.xweb,1.111 - Robert Stayton</p> 313</li><li> 314<p>Implemented feature request 315#942524 to add insert.<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>.page.number to allow link 316element cross references to have a page number.</p> 317<p class="commit-changes">Modified: fo/xref.xsl,1.67 - 318Robert Stayton</p> 319</li><li> 320<p>Add support for 321<a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/ulink.hyphenate.html"><em class="parameter"><code>ulink.hyphenate</code></em></a>.chars so more characters 322can be break points in urls.</p> 323<p class="commit-changes">Modified: fo/xref.xsl,1.66 - Robert 324Stayton</p> 325</li><li> 326<p>Implemented patch #1075144 to make 327the url text in a ulink in FO output an active <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> as 328well.</p> 329<p class="commit-changes">Modified: fo/xref.xsl,1.65 - Robert Stayton</p> 330</li><li> 331<p><a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> footnotes now 332have their own <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>.<a href="http://docbook.org/tdg/en/html/footnote.html"><code class="sgmltag-element">footnote</code></a>.properties 333attribute set.</p> 334<p class="commit-changes">Modified: fo/footnote.xsl,1.23 - Robert 335Stayton</p> 336</li><li> 337<p>Add <a href="http://docbook.org/tdg/en/html/qandaset.html"><code class="sgmltag-element">qandaset</code></a> to 338root.elements.</p> 339<p class="commit-changes">Modified: fo/docbook.xsl,1.41 - Robert 340Stayton</p> 341</li><li> 342<p>Added mode="page.sequence" to make 343it easier to put content into a page sequence. First used for 344<a href="http://docbook.org/tdg/en/html/qandaset.html"><code class="sgmltag-element">qandaset</code></a>.</p> 345<p class="commit-changes">Modified: fo/component.xsl,1.37 - Robert 346Stayton</p> 347</li><li> 348<p>Implemented feature request 349#1434408 to support formatting 350of <a href="http://docbook.org/tdg/en/html/biblioentry.html"><code class="sgmltag-element">biblioentry</code></a>.</p> 351<p class="commit-changes">Modified: fo/biblio.xsl,1.35 - Robert 352Stayton</p> 353</li><li> 354<p>Added 355<a href="http://docbook.org/tdg/en/html/biblioentry.html"><code class="sgmltag-element">biblioentry</code></a>.properties.</p> 356<p class="commit-changes">Modified: fo/param.ent,1.97; 357fo/param.xweb,1.110 - Robert Stayton</p> 358</li><li> 359<p>Support PTC/Arbortext 360bookmarks</p> 361<p class="commit-changes">Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman 362Walsh</p> 363</li><li> 364<p>Added 365<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>.<a href="http://docbook.org/tdg/en/html/footnote.html"><code class="sgmltag-element">footnote</code></a>.properties to permit 366<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> footnotes to format differently from regular 367footnotes.</p> 368<p class="commit-changes">Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert 369Stayton</p> 370</li><li> 371<p>Refactored <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> 372templates to unify their processing and support all options in 373all types. Now <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> and <a href="http://docbook.org/tdg/en/html/informaltable.html"><code class="sgmltag-element">informaltable</code></a>, in 374both Cals and Html markup, use the same templates where possible, 375and all support pgwide, rotation, and floats. There is also a 376placeholder <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>.container template to 377support wrapping a <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> in a layout <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>, 378so the XEP <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> "continued" 379extension can be more easily implemented.</p> 380<p class="commit-changes">Modified: fo/formal.xsl,1.52; 381fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 - Robert 382Stayton</p> 383</li><li> 384<p>Added new attribute set 385<a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">toc</code></a>.line.properties for controlling appearance of lines in 386ToC/LoT</p> 387<p class="commit-changes">Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95; 388fo/param.xweb,1.108 - Jirka Kosek</p> 389</li><li> 390<p>Added support for float to example 391and <a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a>. Added support for pgwide to 392<a href="http://docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a>, example, and <a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a> (the latter 393two via a dbfo pgwide="1" processing 394instruction).</p> 395<p class="commit-changes">Modified: fo/formal.xsl,1.51 - Robert 396Stayton</p> 397</li><li> 398<p>Add pgwide.properties 399attribute-set.</p> 400<p class="commit-changes">Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert 401Stayton</p> 402</li><li> 403<p>Added <a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">refclass</code></a>.suppress 404param.</p> 405<p>If the value of <a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">refclass</code></a>.suppress is 406non-zero, then display <a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">refclass</code></a> contents is suppressed 407in output. Affects HTML and FO output 408only.</p> 409<p class="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; 410html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) 411Smith</p> 412</li><li> 413<p>Improved support for 414<a href="http://docbook.org/tdg/en/html/task.html"><code class="sgmltag-element">task</code></a> subelements</p> 415<p class="commit-changes">Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - 416Jirka Kosek</p> 417</li><li> 418<p>Adjusted spacing around 419K&R-formatted <a href="http://docbook.org/tdg/en/html/funcdef.html"><code class="sgmltag-element">Funcdef</code></a> and <a href="http://docbook.org/tdg/en/html/paramdef.html"><code class="sgmltag-element">Paramdef</code></a> 420output such that it can more easily be discerned where one ends 421and the other begins. Closes #1213264.</p> 422<p class="commit-changes">Modified: fo/synop.xsl,1.18 - 423Michael(tm) Smith</p> 424</li><li> 425<p>Made handling of 426paramdef/parameter in FO output consistent with that in HTML and 427manpages output. Closes #1213259.</p> 428<p class="commit-changes">Modified: fo/synop.xsl,1.17 - Michael(tm) 429Smith</p> 430</li><li> 431<p>Made handling of 432<a href="http://docbook.org/tdg/en/html/refnamediv.html"><code class="sgmltag-element">Refnamediv</code></a> consistent with formatting in HTML 433and manpages output; specifically, changed so that 434<a href="http://docbook.org/tdg/en/html/refname.html"><code class="sgmltag-element">Refname</code></a> (comma-separated list of multiple instances 435found) is used (instead of <a href="http://docbook.org/tdg/en/html/refentrytitle.html"><code class="sgmltag-element">Refentrytitle</code></a> as 436previously), then em-dash, then the <a href="http://docbook.org/tdg/en/html/refpurpose.html"><code class="sgmltag-element">Refpurpose</code></a>. Closes 437#1212562.</p> 438<p class="commit-changes">Modified: fo/refentry.xsl,1.30 - Michael(tm) 439Smith</p> 440</li><li> 441<p>Added output of 442<a href="http://docbook.org/tdg/en/html/releaseinfo.html"><code class="sgmltag-element">Releaseinfo</code></a> to recto titlepage ("<a href="http://docbook.org/tdg/en/html/copyright.html"><code class="sgmltag-element">copyright</code></a>" 443page) for <a href="http://docbook.org/tdg/en/html/book.html"><code class="sgmltag-element">Book</code></a> in FO output. This makes it consistent 444with HTML output. Closes #1327034. Thanks to Paul DuBois for 445reporting.</p> 446<p class="commit-changes">Modified: fo/titlepage.templates.xml,1.28 - Michael(tm) 447Smith</p> 448</li><li> 449<p>Added condition for setting 450block-progression-dimension.minimum on table-row, instead of 451height, when <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/fop1.extensions.html"><em class="parameter"><code>fop1.extensions</code></em></a> is 452non-zero. For an explanation of the reason for the change, 453<a href="http://docbook.org/tdg/en/html/see.html"><code class="sgmltag-element">see</code></a>: http://wiki.apache.org/xmlgraphics-fop/Troubleshooting/CommonLogMessages</p> 454<p class="commit-changes">Modified: fo/pagesetup.xsl,1.59 455- Michael(tm) Smith</p> 456</li><li> 457<p>Added new 458<a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">refclass</code></a>.suppress param for suppressing display 459of <a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">Refclass</code></a> in HTML and FO output. Did not add it to 460manpages because manpages stylesheet is currently just silently 461ignoring <a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">Refclass</code></a> anyway. Closes request 462#1461065. Thanks to Davor Ocelic (docelic) for 463reporting.</p> 464<p class="commit-changes">Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - 465Michael(tm) Smith</p> 466</li><li> 467<p>Add support for keep-together PI 468to informal objects.</p> 469<p class="commit-changes">Modified: fo/formal.xsl,1.50 - Robert 470Stayton</p> 471</li><li> 472<p>Add support for 473<a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/fop1.extensions.html"><em class="parameter"><code>fop1.extensions</code></em></a>.</p> 474<p class="commit-changes">Modified: fo/formal.xsl,1.49; 475fo/graphics.xsl,1.44; fo/table.xsl,1.47 - Robert 476Stayton</p> 477</li><li> 478<p>Add support for fop1 479bookmarks.</p> 480<p class="commit-changes">Modified: fo/docbook.xsl,1.39 - Robert 481Stayton</p> 482</li><li> 483<p>Add fop1.extentions parameter to 484add support for fop development version.</p> 485<p class="commit-changes">Modified: fo/param.ent,1.92; 486fo/param.xweb,1.105 - Robert Stayton</p> 487</li><li> 488<p>Start supporting fop development 489version, which will become fop version 1.</p> 490<p class="commit-changes">Modified: fo/fop1.xsl,1.1 - 491Robert Stayton</p> 492</li><li> 493<p>Add template for <a href="http://docbook.org/tdg/en/html/task.html"><code class="sgmltag-element">task</code></a> 494in mode="xref-to".</p> 495<p class="commit-changes">Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert 496Stayton</p> 497</li><li> 498<p><a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> footnotes now 499also get <a href="http://docbook.org/tdg/en/html/footnote.html"><code class="sgmltag-element">footnote</code></a>.properties 500attribute-set.</p> 501<p class="commit-changes">Modified: fo/footnote.xsl,1.22 - Robert 502Stayton</p> 503</li><li> 504<p>Added <a href="http://docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a>.separator 505named template to compute the separator punctuation based on 506locale.</p> 507<p class="commit-changes">Modified: fo/autoidx.xsl,1.36 - Robert Stayton</p> 508</li><li> 509<p>Added support for <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>, 510<a href="http://docbook.org/tdg/en/html/olink.html"><code class="sgmltag-element">olink</code></a>, and <a href="http://docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a> within OO 511<a href="http://docbook.org/tdg/en/html/classsynopsis.html"><code class="sgmltag-element">Classsynopsis</code></a> and children. (Because DocBook NG/5 512allows it).</p> 513<p class="commit-changes">Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) 514Smith</p> 515</li><li> 516<p>Support <a href="http://docbook.org/tdg/en/html/date.html"><code class="sgmltag-element">date</code></a> as an 517inline</p> 518<p class="commit-changes">Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman 519Walsh</p> 520</li><li> 521<p>Added new parameter 522<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/keep.relative.image.uris.html"><em class="parameter"><code>keep.relative.image.uris</code></em></a></p> 523<p class="commit-changes">Modified: fo/param.ent,1.91; 524fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96; 525params/keep.relative.image.uris.xml,1.1 - Norman 526Walsh</p> 527</li><li> 528<p>Map Unicode space characters 529U+2000-U+200A to fo:leaders.</p> 530<p class="commit-changes">Modified: fo/docbook.xsl,1.38; 531fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 - Jirka 532Kosek</p> 533</li><li> 534<p>Output a real em dash for em-dash 535dingbat (instead of two hypens).</p> 536<p class="commit-changes">Modified: fo/fo.xsl,1.7 - Michael(tm) 537Smith</p> 538</li><li> 539<p>Support default <a href="http://docbook.org/tdg/en/html/label.html"><code class="sgmltag-element">label</code></a> 540width parameters for itemized and ordered lists</p> 541<p class="commit-changes">Modified: fo/lists.xsl,1.64; 542fo/param.ent,1.90; fo/param.xweb,1.103; 543params/itemizedlist.label.width.xml,1.1; 544params/orderedlist.label.width.xml,1.1 - Norman 545Walsh</p> 546</li><li> 547<p>Generate localized 548<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> for <a href="http://docbook.org/tdg/en/html/refsynopsisdiv.html"><code class="sgmltag-element">Refsynopsisdiv</code></a> if no 549appropriate <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">Title</code></a> descendant found in source. Closes 550#1212398. This change makes behavior for the <a href="http://docbook.org/tdg/en/html/synopsis.html"><code class="sgmltag-element">Synopsis</code></a> 551<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> consistent with the behavior of HTML and 552manpages output.</p> 553<p>Also, added 554xsl:use-attribute-sets="normal.<a href="http://docbook.org/tdg/en/html/para.html"><code class="sgmltag-element">para</code></a>.spacing" to 555block generated for <a href="http://docbook.org/tdg/en/html/cmdsynopsis.html"><code class="sgmltag-element">Cmdsynopsis</code></a> output. Previously, 556that block had no spacing at all specified, which resulted it 557being crammed up to closely to the <a href="http://docbook.org/tdg/en/html/synopsis.html"><code class="sgmltag-element">Synopsis</code></a> 558head.</p> 559<p class="commit-changes">Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm) 560Smith</p> 561</li><li> 562<p>Added parameters to support 563localization of <a href="http://docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a> 564item punctuation.</p> 565<p class="commit-changes">Modified: fo/autoidx.xsl,1.35 - Robert 566Stayton</p> 567</li><li> 568<p>Added 569<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/index.number.separator.html"><em class="parameter"><code>index.number.separator</code></em></a>, 570<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/index.range.separator.html"><em class="parameter"><code>index.range.separator</code></em></a>, 571and <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/index.term.separator.html"><em class="parameter"><code>index.term.separator</code></em></a> parameters to 572support localization of punctuation in <a href="http://docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a> 573entries.</p> 574<p class="commit-changes">Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert 575Stayton</p> 576</li><li> 577<p>Added "Cross References" 578<a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> in HTML doc (for consistency with the FO 579doc). Also, moved the existing FO "Cross 580References" <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> to follow the "Linking" 581<a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a>.</p> 582<p class="commit-changes">Modified: fo/param.xweb,1.101; html/param.xweb,1.95 - 583Michael(tm) Smith</p> 584</li><li> 585<p>Added ID attribues to all 586<a href="http://docbook.org/tdg/en/html/reference.html"><code class="sgmltag-element">Reference</code></a> elements (e.g., id="tables" for the doc for 587<a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> on <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">Table</code></a> params). So pages for 588all subsections of ref docs now have stable filenames instead 589of arbitrary generated filenames.</p> 590<p class="commit-changes">Modified: fo/param.xweb,1.100; 591html/param.xweb,1.94 - Michael(tm) Smith</p> 592</li><li> 593<p>Added two new parameters for 594handling of multi-term 595<a href="http://docbook.org/tdg/en/html/varlistentry.html"><code class="sgmltag-element">varlistentry</code></a> elements:</p> 596<p><a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.break.after.html"><em class="parameter"><code>variablelist.term.break.after</code></em></a>: 597When the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.break.after.html"><em class="parameter"><code>variablelist.term.break.after</code></em></a> is 598non-zero, it will generate a line break after each 599<a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a> multi-term 600<a href="http://docbook.org/tdg/en/html/varlistentry.html"><code class="sgmltag-element">varlistentry</code></a>.</p> 601<p><a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.separator.html"><em class="parameter"><code>variablelist.term.separator</code></em></a>: 602When a <a href="http://docbook.org/tdg/en/html/varlistentry.html"><code class="sgmltag-element">varlistentry</code></a> contains multiple <a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a> 603elements, the string specified in the value of the 604<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.separator.html"><em class="parameter"><code>variablelist.term.separator</code></em></a> parameter is 605placed after each <a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a> except the last. The default 606is ", " (a comma followed by a space). To suppress rendering of 607the separator, set the value of 608<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.separator.html"><em class="parameter"><code>variablelist.term.separator</code></em></a> to the empty 609string ("").</p> 610<p>These parameters are primarily intended to be 611useful if you have multi-term varlistentries that have long 612terms.</p> 613<p>Closes #1306676. Thanks to Sam Steingold for 614providing an example "lots of long terms" doc that demonstrated 615the value of having these options.</p> 616<p>Also, added 617normalize-space() call to processing of each 618<a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a>.</p> 619<p>This change affects all output formats 620(HTML, PDF, manpages). The default behavior should pretty much 621remain the same as before, but it is possible (as always) that 622the change may introduce some 623new bugginess.</p> 624<p class="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; 625fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86; 626html/param.xweb,1.93; manpages/lists.xsl,1.22; 627manpages/param.ent,1.14; manpages/param.xweb,1.16; 628params/variablelist.term.break.after.xml,1.1; 629params/variablelist.term.separator.xml,1.1 - Michael(tm) 630Smith</p> 631</li><li> 632<p>Add <a href="http://docbook.org/tdg/en/html/sidebar.html"><code class="sgmltag-element">sidebar</code></a> titlepage 633placeholder attset for styles.</p> 634<p class="commit-changes">Modified: fo/titlepage.xsl,1.37 - Robert 635Stayton</p> 636</li><li> 637<p>Add titlepage for 638<a href="http://docbook.org/tdg/en/html/sidebar.html"><code class="sgmltag-element">sidebar</code></a>.</p> 639<p class="commit-changes">Modified: fo/titlepage.templates.xml,1.27 - Robert 640Stayton</p> 641</li><li> 642<p>Implemented RFE 643#1292615.</p> 644<p>Added bunch of new parameters (attribute sets) 645that affect list presentation: list.block.properties, 646<a href="http://docbook.org/tdg/en/html/itemizedlist.html"><code class="sgmltag-element">itemizedlist</code></a>.properties, <a href="http://docbook.org/tdg/en/html/orderedlist.html"><code class="sgmltag-element">orderedlist</code></a>.properties, 647<a href="http://docbook.org/tdg/en/html/itemizedlist.html"><code class="sgmltag-element">itemizedlist</code></a>.<a href="http://docbook.org/tdg/en/html/label.html"><code class="sgmltag-element">label</code></a>.properties and 648<a href="http://docbook.org/tdg/en/html/orderedlist.html"><code class="sgmltag-element">orderedlist</code></a>.<a href="http://docbook.org/tdg/en/html/label.html"><code class="sgmltag-element">label</code></a>.properties. Default behaviour 649of stylesheets has not been changed but further customizations will be 650much more easier.</p> 651<p class="commit-changes">Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; 652fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1; 653params/itemizedlist.properties.xml,1.1; 654params/list.block.properties.xml,1.1; 655params/orderedlist.label.properties.xml,1.1; 656params/orderedlist.properties.xml,1.1 - Jirka 657Kosek</p> 658</li><li> 659<p>Implemented RFE 660#1242092.</p> 661<p>You can enable crop marks in your document by 662setting crop.marks=1 and xep.extensions=1. Appearance of crop 663marks can be controlled by parameters 664<a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/crop.mark.bleed.html"><em class="parameter"><code>crop.mark.bleed</code></em></a> (6pt), 665<a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/crop.mark.offset.html"><em class="parameter"><code>crop.mark.offset</code></em></a> (24pt) and 666<a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/crop.mark.width.html"><em class="parameter"><code>crop.mark.width</code></em></a> (0.5pt).</p> 667<p>Also there 668is new named template called user-xep-pis. You can overwrite it in 669order to produce some PIs that can control XEP as described in 670http://www.renderx.com/reference.html#Output_Formats</p> 671<p class="commit-changes">Modified: fo/docbook.xsl,1.36; 672fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23; 673params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1; 674params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka 675Kosek</p> 676</li></ul></div> 677</div> 678 679<div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1700_HTML"></a>HTML</h3></div></div></div> 680 681<p>The following changes have been made to the 682 <code class="filename">html</code> code 683 since the 1.69.1 release.</p> 684<div class="itemizedlist"><ul type="disc"><li> 685<p>implemented 686<a href="http://docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a>.method parameter and three 687methods.</p> 688<p class="commit-changes">Modified: html/autoidx.xsl,1.28 - Robert 689Stayton</p> 690</li><li> 691<p>added <a href="http://docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a>.method 692parameter to support 3 indexing methods.</p> 693<p class="commit-changes">Modified: html/param.ent,1.94; 694html/param.xweb,1.103 - Robert Stayton</p> 695</li><li> 696<p>Implemented feature request 697#1072510 as a processing instruction to permit including external 698HTML content into HTML output.</p> 699<p class="commit-changes">Modified: html/pi.xsl,1.9 - Robert 700Stayton</p> 701</li><li> 702<p>Added new parameter 703<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chunk.tocs.and.lots.html"><em class="parameter"><code>chunk.tocs.and.lots</code></em></a>.has.<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> which 704controls presence of <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> in a separate chunk with 705ToC/LoT. Disabling <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> can be very useful if you are 706generating frameset output (well, yes those frames, but some customers 707really want them ;-).</p> 708<p class="commit-changes">Modified: html/chunk-code.xsl,1.15; 709html/param.ent,1.93; html/param.xweb,1.102; 710params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka 711Kosek</p> 712</li><li> 713<p>Support dbhtml/dbfo start PI for 714<a href="http://docbook.org/tdg/en/html/orderedlist.html"><code class="sgmltag-element">orderedlist</code></a> numbering in both HTML and 715FO</p> 716<p class="commit-changes">Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman 717Walsh</p> 718</li><li> 719<p>Allow <a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">ToC</code></a> without 720<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> also for set and 721<a href="http://docbook.org/tdg/en/html/book.html"><code class="sgmltag-element">book</code></a>.</p> 722<p class="commit-changes">Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 - 723Jirka Kosek</p> 724</li><li> 725<p>Implemented floats uniformly for 726<a href="http://docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a>, example, <a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a> 727and <a href="http://docbook.org/tdg/en/html/informalfigure.html"><code class="sgmltag-element">informalfigure</code></a>, <a href="http://docbook.org/tdg/en/html/informalexample.html"><code class="sgmltag-element">informalexample</code></a>, and 728<a href="http://docbook.org/tdg/en/html/informalequation.html"><code class="sgmltag-element">informalequation</code></a>.</p> 729<p class="commit-changes">Modified: html/formal.xsl,1.22 - Robert 730Stayton</p> 731</li><li> 732<p>Added the 733autotoc.<a href="http://docbook.org/tdg/en/html/label.html"><code class="sgmltag-element">label</code></a>.in.hyperlink param.</p> 734<p>If the value 735of autotoc.<a href="http://docbook.org/tdg/en/html/label.html"><code class="sgmltag-element">label</code></a>.in.hyperlink is non-zero, labels 736are included in hyperlinked titles in the <a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">TOC</code></a>. If it 737is instead zero, labels are still displayed prior to the 738hyperlinked titles, but are not hyperlinked along with the 739titles.</p> 740<p>Closes patch #1065868. Thanks to anatoly techtonik 741for the patch.</p> 742<p class="commit-changes">Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; 743html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - 744Michael(tm) Smith</p> 745</li><li> 746<p>Added two new params: 747html.head.<a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a>.<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>.types 748and html.head.<a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a>.<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>.multiple.</p> 749<p>If 750the value of the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/generate.legalnotice.link.html"><em class="parameter"><code>generate.legalnotice.link</code></em></a> is 751non-zero, then the stylesheet generates (in the head 752<a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> of the HTML source) either a single HTML 753<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> element or, if the value of 754the html.head.<a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a>.<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>.multiple is 755non-zero, one <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> element for each <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> 756type specified. Each <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> has the 757following attributes:</p> 758<p> - a rel attribute whose value 759is derived from the value of 760html.head.<a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a>.<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>.types</p> 761<p> - 762an href attribute whose value is set to the URL of the file 763containing the <a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a></p> 764<p> - a <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> 765attribute whose value is set to the <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> of the 766corresponding <a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a> (or a <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> 767programatically determined by the stylesheet)</p> 768<p>For 769example:</p> 770<p> <<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> rel="<a href="http://docbook.org/tdg/en/html/copyright.html"><code class="sgmltag-element">copyright</code></a>" 771href="ln-id2524073.html" title="Legal Notice"></p> 772<p>Closes 773#1476450. Thanks to Sam Steingold.</p> 774<p class="commit-changes">Modified: html/chunk-common.xsl,1.45; 775html/param.ent,1.91; html/param.xweb,1.100; 776params/generate.legalnotice.link.xml,1.4; 777params/html.head.legalnotice.link.multiple.xml,1.1; 778params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm) 779Smith</p> 780</li><li> 781<p>Added <a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">refclass</code></a>.suppress 782param.</p> 783<p>If the value of <a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">refclass</code></a>.suppress is 784non-zero, then display <a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">refclass</code></a> contents is suppressed 785in output. Affects HTML and FO output 786only.</p> 787<p class="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; 788html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) 789Smith</p> 790</li><li> 791<p>Improved support for 792<a href="http://docbook.org/tdg/en/html/task.html"><code class="sgmltag-element">task</code></a> subelements</p> 793<p class="commit-changes">Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - 794Jirka Kosek</p> 795</li><li> 796<p>Added new 797<a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">refclass</code></a>.suppress param for suppressing display 798of <a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">Refclass</code></a> in HTML and FO output. Did not add it to 799manpages because manpages stylesheet is currently just silently 800ignoring <a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">Refclass</code></a> anyway. Closes request 801#1461065. Thanks to Davor Ocelic (docelic) for 802reporting.</p> 803<p class="commit-changes">Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - 804Michael(tm) Smith</p> 805</li><li> 806<p>Process <a href="http://docbook.org/tdg/en/html/alt.html"><code class="sgmltag-element">alt</code></a> text with 807normalize-space(). Replace tab indents with 808spaces.</p> 809<p class="commit-changes">Modified: html/graphics.xsl,1.57 - Robert 810Stayton</p> 811</li><li> 812<p>Content of <a href="http://docbook.org/tdg/en/html/citation.html"><code class="sgmltag-element">citation</code></a> 813element is automatically linked to the bibliographic <a href="http://docbook.org/tdg/en/html/entry.html"><code class="sgmltag-element">entry</code></a> 814with the corresponding <a href="http://docbook.org/tdg/en/html/abbrev.html"><code class="sgmltag-element">abbrev</code></a>.</p> 815<p class="commit-changes">Modified: html/biblio.xsl,1.26; 816html/inline.xsl,1.47; html/xref.xsl,1.58 - Jirka 817Kosek</p> 818</li><li> 819<p>Add template for <a href="http://docbook.org/tdg/en/html/task.html"><code class="sgmltag-element">task</code></a> 820in mode="xref-to".</p> 821<p class="commit-changes">Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert 822Stayton</p> 823</li><li> 824<p>Suppress ID warnings if the 825.warnings parameter is 0</p> 826<p class="commit-changes">Modified: html/html.xsl,1.17 - Norman 827Walsh</p> 828</li><li> 829<p>Add support for floatstyle to 830<a href="http://docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a>.</p> 831<p class="commit-changes">Modified: html/formal.xsl,1.21 - Robert 832Stayton</p> 833</li><li> 834<p>Handling of <a href="http://docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a> to 835area/areaset need support in extensions code also. I currently have no 836time to touch extensions code, so code is here to be enabled when 837extension is fixed also.</p> 838<p class="commit-changes">Modified: html/xref.xsl,1.56 - Jirka 839Kosek</p> 840</li><li> 841<p>Added 3 parameters for overriding 842gentext for <a href="http://docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a> 843punctuation.</p> 844<p class="commit-changes">Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert 845Stayton</p> 846</li><li> 847<p>Added parameters to support 848localization of <a href="http://docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a> item punctuation. Added 849<a href="http://docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a>.separator named template to compute 850the separator punctuation based on 851locale.</p> 852<p class="commit-changes">Modified: html/autoidx.xsl,1.27 - Robert 853Stayton</p> 854</li><li> 855<p>Added a <div 856class="{$class}-contents"> wrapper around output of contents 857of all formal objects. Also, added an optional <br 858class="{class}-break"/> linebreak after all formal 859objects.</p> 860<p>WARNING: Because this change places an additional 861DIV between the DIV wrapper for the <a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a> and the 862<a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a> contents, it may break some existing CSS 863stylesheets that have been created with the assumption that there 864would never be an intervening DIV there.</p> 865<p>The following is 866an example of what <a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">Equation</code></a> output looks like as a 867result of the changes described above.</p> 868<p> <div 869class="<a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a>"> <a name="three" 870id="three"></a></p> 871<p> <p 872class="<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a>"><b>(1.3)</b></p></p> 873<p> 874<div class="equation-contents"> <span 875class="<a href="http://docbook.org/tdg/en/html/mathphrase.html"><code class="sgmltag-element">mathphrase</code></a>">1+1=3</span> 876</div> </div><br 877class="equation-break"></p> 878<p>Rationale: These changes allow 879CSS control of the placement of the formal-object 880<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> relative to the formal-object 881contents. For example, using the CSS "float" <a href="http://docbook.org/tdg/en/html/property.html"><code class="sgmltag-element">property</code></a> 882enables the <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> and contents to be rendered on the 883same line. Example stylesheet:</p> 884<p> .<a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a> 885{ margin-top: 20px; margin-bottom: 20px; } 886.equation-contents { float: left; }</p> 887<p> 888.<a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a> .<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> { margin-top: 0; 889float: right; margin-right: 200px; }</p> 890<p> 891.<a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a> .<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> b { font-weight: 892normal; }</p> 893<p> .equation-break { clear: both; 894}</p> 895<p>Note that the purpose of the ".equation-break" class is 896to provide a way to clear off the floats.</p> 897<p>If you want 898to instead have the <a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a> <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> rendered to 899the left of the <a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a> contents, you can do 900something like this:</p> 901<p> .<a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a> { 902margin-top: 20px; width: 300px; margin-bottom: 20px; 903} .equation-contents { float: right; }</p> 904<p> 905.<a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a> .<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> { margin-top: 0; 906float: left; margin-right: 200px; }</p> 907<p> 908.<a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a> .<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> b { font-weight: 909normal; }</p> 910<p> .equation-break { clear: both; 911}</p> 912<p class="commit-changes">Modified: html/formal.xsl,1.20 - Michael(tm) Smith</p> 913</li><li> 914<p>Added a chunker.output.quiet 915top-level parameter so that the chunker can be made quiet by 916default</p> 917<p class="commit-changes">Modified: html/chunker.xsl,1.26 - Norman Walsh</p> 918</li><li> 919<p>Added support for <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>, 920<a href="http://docbook.org/tdg/en/html/olink.html"><code class="sgmltag-element">olink</code></a>, and <a href="http://docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a> within OO 921<a href="http://docbook.org/tdg/en/html/classsynopsis.html"><code class="sgmltag-element">Classsynopsis</code></a> and children. (Because DocBook NG/5 922allows it).</p> 923<p class="commit-changes">Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) 924Smith</p> 925</li><li> 926<p>New parameter: 927<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/id.warnings.html"><em class="parameter"><code>id.warnings</code></em></a>. If non-zero, warnings are 928generated for titled objects that don't have titles. True by default; 929I wonder if this will be too aggressive?</p> 930<p class="commit-changes">Modified: html/biblio.xsl,1.25; 931html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19; 932html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16; 933html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22; 934html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman 935Walsh</p> 936</li><li> 937<p>If the 938<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/keep.relative.image.uris.html"><em class="parameter"><code>keep.relative.image.uris</code></em></a> parameter is true, 939don't use the absolute <a href="http://docbook.org/tdg/en/html/uri.html"><code class="sgmltag-element">URI</code></a> (as calculated from xml:base) in 940the img src attribute, us the value the <a href="http://docbook.org/tdg/en/html/author.html"><code class="sgmltag-element">author</code></a> 941specified. Note that we still have to calculate the absolute 942<a href="http://docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a> for use in the image intrinsics 943extension.</p> 944<p class="commit-changes">Modified: html/graphics.xsl,1.56 - Norman 945Walsh</p> 946</li><li> 947<p>Support <a href="http://docbook.org/tdg/en/html/date.html"><code class="sgmltag-element">date</code></a> as an 948inline</p> 949<p class="commit-changes">Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman 950Walsh</p> 951</li><li> 952<p>Added new parameter 953<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/keep.relative.image.uris.html"><em class="parameter"><code>keep.relative.image.uris</code></em></a></p> 954<p class="commit-changes">Modified: fo/param.ent,1.91; 955fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96; 956params/keep.relative.image.uris.xml,1.1 - Norman 957Walsh</p> 958</li><li> 959<p>Added two new parameters for 960handling of multi-term 961<a href="http://docbook.org/tdg/en/html/varlistentry.html"><code class="sgmltag-element">varlistentry</code></a> elements:</p> 962<p><a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.break.after.html"><em class="parameter"><code>variablelist.term.break.after</code></em></a>: 963When the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.break.after.html"><em class="parameter"><code>variablelist.term.break.after</code></em></a> is 964non-zero, it will generate a line break after each 965<a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a> multi-term 966<a href="http://docbook.org/tdg/en/html/varlistentry.html"><code class="sgmltag-element">varlistentry</code></a>.</p> 967<p><a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.separator.html"><em class="parameter"><code>variablelist.term.separator</code></em></a>: 968When a <a href="http://docbook.org/tdg/en/html/varlistentry.html"><code class="sgmltag-element">varlistentry</code></a> contains multiple <a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a> 969elements, the string specified in the value of the 970<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.separator.html"><em class="parameter"><code>variablelist.term.separator</code></em></a> parameter is 971placed after each <a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a> except the last. The default 972is ", " (a comma followed by a space). To suppress rendering of 973the separator, set the value of 974<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.separator.html"><em class="parameter"><code>variablelist.term.separator</code></em></a> to the empty 975string ("").</p> 976<p>These parameters are primarily intended to be 977useful if you have multi-term varlistentries that have long 978terms.</p> 979<p>Closes #1306676. Thanks to Sam Steingold for 980providing an example "lots of long terms" doc that demonstrated 981the value of having these options.</p> 982<p>Also, added 983normalize-space() call to processing of each 984<a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a>.</p> 985<p>This change affects all output formats 986(HTML, PDF, manpages). The default behavior should pretty much 987remain the same as before, but it is possible (as always) that 988the change may introduce some 989new bugginess.</p> 990<p class="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; 991fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86; 992html/param.xweb,1.93; manpages/lists.xsl,1.22; 993manpages/param.ent,1.14; manpages/param.xweb,1.16; 994params/variablelist.term.break.after.xml,1.1; 995params/variablelist.term.separator.xml,1.1 - Michael(tm) 996Smith</p> 997</li><li> 998<p>Added "wrapper-name" param to 999inline.charseq named template, enabling it to output inlines 1000other than just "span". <a href="http://docbook.org/tdg/en/html/acronym.html"><code class="sgmltag-element">Acronym</code></a> and <a href="http://docbook.org/tdg/en/html/abbrev.html"><code class="sgmltag-element">Abbrev</code></a> 1001templates now use inline.charseq to output HTML 1002"<a href="http://docbook.org/tdg/en/html/acronym.html"><code class="sgmltag-element">acronym</code></a>" and "abbr" elements (instead of 1003"span"). Closes #1305468. Thanks to Sam Steingold for suggesting 1004the change.</p> 1005<p class="commit-changes">Modified: html/inline.xsl,1.45 - Michael(tm) 1006Smith</p> 1007</li></ul></div> 1008</div> 1009 1010<div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1700_Manpages"></a>Manpages</h3></div></div></div> 1011 1012<p>The following changes have been made to the 1013 <code class="filename">manpages</code> code 1014 since the 1.69.1 release.</p> 1015<div class="itemizedlist"><ul type="disc"><li> 1016<p>Added the following 1017params:</p> 1018<p> - man.indent.width (string-valued) - 1019man.indent.refsect (boolean) - man.indent.blurbs (boolean) 1020- man.indent.lists (boolean) - man.indent.verbatims 1021(boolean)</p> 1022<p>Note that in earlier snapshots, man.indent.width 1023was named man.indentation.default.value and the boolean params 1024had names like man.indentation.*.adjust. Also the 1025man.indent.blurbs param was called man.indentation.authors.adjust 1026(or something).</p> 1027<p>The behavior now is: If the value of a 1028particular man.indent.* boolean param is non-zero, the 1029corresponding contents (refsect*, list items, 1030authorblurb/personblurb, vervatims) are displayed with a left 1031margin indented by a width equal to the value 1032of man.indent.width.</p> 1033<p class="commit-changes">Modified: params/man.indent.blurbs.xml,1.1; 1034manpages/docbook.xsl,1.74; manpages/info.xsl,1.20; 1035manpages/lists.xsl,1.30; manpages/other.xsl,1.20; 1036manpages/param.ent,1.22; manpages/param.xweb,1.24; 1037manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1; 1038params/man.indent.refsect.xml,1.1; 1039params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 - 1040Michael(tm) Smith</p> 1041</li><li> 1042<p>Added 1043man.<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>.footnotes.divider param.</p> 1044<p>In each 1045<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> that contains footenotes, the string specified 1046by the man.<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>.footnotes.divider parameter is output 1047before the list of footnotes for the 1048<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>.</p> 1049<p class="commit-changes">Modified: manpages/docbook.xsl,1.73; 1050manpages/links.xsl,1.6; manpages/param.ent,1.21; 1051manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 - 1052Michael(tm) Smith</p> 1053</li><li> 1054<p>Added the 1055man.output.in.separate.dir, 1056man.output.<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/base.dir.html"><em class="parameter"><code>base.dir</code></em></a>, 1057and man.output.subdirs.enabled parameters.</p> 1058<p>The 1059man.output.<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/base.dir.html"><em class="parameter"><code>base.dir</code></em></a> parameter specifies the 1060base directory into which man-page files are 1061output. The man.output.subdirs.enabled parameter controls whether 1062the files are output in subdirectories within the base 1063directory.</p> 1064<p>The values of the 1065man.output.<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/base.dir.html"><em class="parameter"><code>base.dir</code></em></a> 1066and man.output.subdirs.enabled parameters are used only if the 1067value of man.output.in.separate.dir parameter is non-zero. If the 1068value of man.output.in.separate.dir is zero, man-page files are 1069not output in a separate 1070directory.</p> 1071<p class="commit-changes">Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; 1072manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1; 1073params/man.output.in.separate.dir.xml,1.1; 1074params/man.output.subdirs.enabled.xml,1.1 - Michael(tm) 1075Smith</p> 1076</li><li> 1077<p>Added 1078man.font.<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>.headings and 1079man.font.<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>.<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> params, for 1080controlling font in <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> headings and 1081titles.</p> 1082<p class="commit-changes">Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; 1083manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1; 1084params/man.font.table.title.xml,1.1 - Michael(tm) 1085Smith</p> 1086</li><li> 1087<p>Added 1088man.font.<a href="http://docbook.org/tdg/en/html/funcsynopsisinfo.html"><code class="sgmltag-element">funcsynopsisinfo</code></a> and 1089man.font.<a href="http://docbook.org/tdg/en/html/funcprototype.html"><code class="sgmltag-element">funcprototype</code></a> params, for specifying the roff 1090font (for example, BI, B, I) for <a href="http://docbook.org/tdg/en/html/funcsynopsisinfo.html"><code class="sgmltag-element">funcsynopsisinfo</code></a> and 1091<a href="http://docbook.org/tdg/en/html/funcprototype.html"><code class="sgmltag-element">funcprototype</code></a> output.</p> 1092<p class="commit-changes">Modified: manpages/block.xsl,1.19; 1093manpages/docbook.xsl,1.69; manpages/param.ent,1.18; 1094manpages/param.xweb,1.20; manpages/synop.xsl,1.29; 1095manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1; 1096params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) 1097Smith</p> 1098</li><li> 1099<p>Added 1100man.<a href="http://docbook.org/tdg/en/html/segtitle.html"><code class="sgmltag-element">segtitle</code></a>.suppress param.</p> 1101<p>If the value of 1102man.<a href="http://docbook.org/tdg/en/html/segtitle.html"><code class="sgmltag-element">segtitle</code></a>.suppress is non-zero, then display 1103of <a href="http://docbook.org/tdg/en/html/segtitle.html"><code class="sgmltag-element">segtitle</code></a> contents is suppressed in 1104output.</p> 1105<p class="commit-changes">Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; 1106manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - 1107Michael(tm) Smith</p> 1108</li><li> 1109<p>Added 1110man.output.<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/manifest.html"><em class="parameter"><code>manifest</code></em></a>.enabled and 1111man.output.manifest.<a href="http://docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a> params.</p> 1112<p>If 1113man.output.<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/manifest.html"><em class="parameter"><code>manifest</code></em></a>.enabled is non-zero, a list 1114of filenames for man pages generated by the stylesheet 1115transformation is written to the file named by 1116man.output.<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/manifest.html"><em class="parameter"><code>manifest</code></em></a>.<a href="http://docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a></p> 1117<p class="commit-changes">Modified: manpages/docbook.xsl,1.67; 1118manpages/other.xsl,1.19; manpages/param.ent,1.16; 1119manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1; 1120params/man.output.manifest.filename.xml,1.1; 1121tools/make/Makefile.DocBook,1.4 - Michael(tm) 1122Smith</p> 1123</li><li> 1124<p>Added 1125<a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>.meta.get.quietly param.</p> 1126<p>If zero (the 1127default), notes and warnings about "missing" markup are generated 1128during gathering of <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> metadata. If 1129non-zero, the metadata is gathered "quietly" -- that is, the 1130notes and warnings are suppressed.</p> 1131<p>NOTE: If you are 1132processing a large amount of <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> content, you 1133may be able to speed up processing significantly by setting a 1134non-zero value for 1135<a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>.meta.get.quietly.</p> 1136<p class="commit-changes">Modified: common/refentry.xsl,1.17; 1137manpages/param.ent,1.15; manpages/param.xweb,1.17; 1138params/refentry.meta.get.quietly.xml,1.1 - Michael(tm) 1139Smith</p> 1140</li><li> 1141<p>Changed names of all boolean 1142indentation params to man.indent.* Also discarded individual 1143man.indent.*.value params and switched to just using a common 1144man.indent.width param (3n by default).</p> 1145<p class="commit-changes">Modified: manpages/docbook.xsl,1.66; 1146manpages/info.xsl,1.19; manpages/lists.xsl,1.29; 1147manpages/other.xsl,1.18; manpages/refentry.xsl,1.13 - Michael(tm) 1148Smith</p> 1149</li><li> 1150<p>Added boolean 1151man.output.in.separate.dir param, to control whether or not man 1152files are output in separate directory.</p> 1153<p class="commit-changes">Modified: manpages/docbook.xsl,1.65; 1154manpages/utility.xsl,1.14 - Michael(tm) Smith</p> 1155</li><li> 1156<p>Added options for controlling 1157indentation of verbatim output. Controlled through the 1158man.indentation.verbatims.adjust 1159and man.indentation.verbatims.value params. Closes 1160#1242997</p> 1161<p class="commit-changes">Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 - 1162Michael(tm) Smith</p> 1163</li><li> 1164<p>Added options for controlling 1165indentation in lists and in *blurb output in the AUTHORS 1166<a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a>. Controlled through 1167the man.indentation.lists.adjust, 1168man.indentation.lists.value, man.indentation.authors.adjust, and 1169man.indentation.authors.value parameters. Default is 3 characters 1170(instead of the roff default of 8 characters). Closes 1171#1449369.</p> 1172<p>Also, removed the indent that was being set on 1173<a href="http://docbook.org/tdg/en/html/informalexample.html"><code class="sgmltag-element">informalexample</code></a> outuput. I will instead add an option 1174for indenting verbatims, which I think is what the 1175<a href="http://docbook.org/tdg/en/html/informalexample.html"><code class="sgmltag-element">informalexample</code></a> indent was intended 1176for originally.</p> 1177<p class="commit-changes">Modified: manpages/block.xsl,1.14; 1178manpages/docbook.xsl,1.63; manpages/info.xsl,1.18; 1179manpages/lists.xsl,1.28 - Michael(tm) Smith</p> 1180</li><li> 1181<p>Changed line-spacing call before 1182<a href="http://docbook.org/tdg/en/html/synopfragment.html"><code class="sgmltag-element">synopfragment</code></a> to use ".sp -1n" ("n" units specified) 1183instead of plain ".sp -1"</p> 1184<p class="commit-changes">Modified: manpages/synop.xsl,1.28 - Michael(tm) 1185Smith</p> 1186</li><li> 1187<p>Added support for writing man 1188files into a specific output directory and into appropriate 1189subdirectories within that output directory. Controlled through 1190the man.<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/base.dir.html"><em class="parameter"><code>base.dir</code></em></a> parameter (similar to the 1191<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/base.dir.html"><em class="parameter"><code>base.dir</code></em></a> support in the HTML stylesheet) and 1192the man.subdirs.enabled parameter, which automatically determines 1193the name of an appropriate subdir (for example, man/man7, 1194man/man1, etc.) based on the <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> number/manvolnum 1195of the source <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">Refentry</code></a>.</p> 1196<p>Closes #1255036 and 1197#1170317. Thanks to Denis Bradford for the original feature 1198request, and to Costin Stroie for submitting a patch that was 1199very helpful in implementing the 1200support.</p> 1201<p class="commit-changes">Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 - 1202Michael(tm) Smith</p> 1203</li><li> 1204<p>Refined XPath statements and 1205notification messages for <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> metadata 1206handling.</p> 1207<p class="commit-changes">Modified: common/common.xsl,1.59; common/refentry.xsl,1.14; 1208manpages/docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm) 1209Smith</p> 1210</li><li> 1211<p>Added support for 1212<a href="http://docbook.org/tdg/en/html/copyright.html"><code class="sgmltag-element">copyright</code></a> and <a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a>. The manpages 1213stylesheets now output a <a href="http://docbook.org/tdg/en/html/copyright.html"><code class="sgmltag-element">COPYRIGHT</code></a> <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a>, 1214after the AUTHORS <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a>, if a <a href="http://docbook.org/tdg/en/html/copyright.html"><code class="sgmltag-element">copyright</code></a> 1215or <a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a> is found in the source. The 1216<a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> contains the <a href="http://docbook.org/tdg/en/html/copyright.html"><code class="sgmltag-element">copyright</code></a> contents followed 1217by the <a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a> contents. Closes 1218#1450209.</p> 1219<p class="commit-changes">Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 - 1220Michael(tm) Smith</p> 1221</li><li> 1222<p>Drastically reworked all of the 1223XPath expressions used in <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> metadata gathering 1224-- completely removed $parentinfo and turned $info into a set of 1225nodes that includes the *info contents of the <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">Refentry</code></a> 1226plus the *info contents all all of its ancestor elements. The 1227basic XPath expression now used throughout is (using the example 1228of checking for a <a href="http://docbook.org/tdg/en/html/date.html"><code class="sgmltag-element">date</code></a>):</p> 1229<p> 1230(($info[//date])[last()]/date)[1].</p> 1231<p>That selects the "last" 1232*info/date <a href="http://docbook.org/tdg/en/html/date.html"><code class="sgmltag-element">date</code></a> in document order -- that is, the one 1233eitther on the <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">Refentry</code></a> itself or on the 1234closest ancestor to the <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">Refentry</code></a>.</p> 1235<p>It's 1236likely this change may break some things; may need to pick up 1237some pieces later.</p> 1238<p>Also, changed the default value for the 1239<a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.th.extra2.max.length.html"><em class="parameter"><code>man.th.extra2.max.length</code></em></a> from 40 to 124030.</p> 1241<p class="commit-changes">Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; 1242params/man.th.extra2.max.length.xml,1.2; 1243params/refentry.date.profile.xml,1.2; 1244params/refentry.manual.profile.xml,1.2; 1245params/refentry.source.name.profile.xml,1.2; 1246params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; 1247manpages/other.xsl,1.15 - Michael(tm) Smith</p> 1248</li><li> 1249<p>Added support for DocBook 5 1250namespace-stripping in manpages stylesheet. Closes request 1251#1210692.</p> 1252<p class="commit-changes">Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - 1253Michael(tm) Smith</p> 1254</li><li> 1255<p>Fixed handling of <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> 1256footnotes. With this checkin, the <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> support in the 1257manpages stylesheet is now basically feature complete. So this 1258change closes request #619532, "No support for tables" -- the 1259oldest currently open manpages feature request, submitted by Ben 1260Secrest (blsecres) on 2002-10-07. Congratulations to me [patting 1261myself on the back].</p> 1262<p class="commit-changes">Modified: manpages/block.xsl,1.11; 1263manpages/docbook.xsl,1.55; manpages/table.xsl,1.15 - Michael(tm) 1264Smith</p> 1265</li><li> 1266<p>Added handling for 1267<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> titles. Also fixed handling of nested tables; 1268nest tables are now "extracted" and displayed just after their 1269parent tables.</p> 1270<p class="commit-changes">Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14 1271- Michael(tm) Smith</p> 1272</li><li> 1273<p>Added option for turning off bold 1274formatting in <a href="http://docbook.org/tdg/en/html/funcsynopsis.html"><code class="sgmltag-element">Funcsynopsis</code></a>. Boldface formatting in 1275<a href="http://docbook.org/tdg/en/html/function.html"><code class="sgmltag-element">function</code></a> <a href="http://docbook.org/tdg/en/html/synopsis.html"><code class="sgmltag-element">synopsis</code></a> is mandated in the 1276man(7) man page and is used almost universally in existing man 1277pages. Despite that, it really does look like crap to have an 1278entire <a href="http://docbook.org/tdg/en/html/funcsynopsis.html"><code class="sgmltag-element">Funcsynopsis</code></a> output in bold, so I added params 1279for turning off the bold formatting and/or replacing it with a 1280different roff special font (e.g., "RI" for alternating 1281roman/italic instead of the default "BI" for alternating 1282bold/italic). The new params 1283are "man.<a href="http://docbook.org/tdg/en/html/funcprototype.html"><code class="sgmltag-element">funcprototype</code></a>.font" and 1284"man.<a href="http://docbook.org/tdg/en/html/funcsynopsisinfo.html"><code class="sgmltag-element">funcsynopsisinfo</code></a>.font". To be documented 1285later.</p> 1286<p>Closes #1452247. Thanks to Joe Orton for the feature 1287request.</p> 1288<p class="commit-changes">Modified: params/man.string.subst.map.xml,1.16; 1289manpages/block.xsl,1.10; manpages/docbook.xsl,1.51; 1290manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm) 1291Smith</p> 1292</li><li> 1293<p>Use AUTHORS instead of 1294<a href="http://docbook.org/tdg/en/html/author.html"><code class="sgmltag-element">AUTHOR</code></a> if we have multiple people to attribute. Also, 1295fixed checking such that we generate 1296<a href="http://docbook.org/tdg/en/html/author.html"><code class="sgmltag-element">author</code></a> <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> even if we don't have an 1297<a href="http://docbook.org/tdg/en/html/author.html"><code class="sgmltag-element">author</code></a> (as long as there is at least one other 1298person/entity we can put in the 1299<a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a>). Also adjusted assembly of content for 1300<a href="http://docbook.org/tdg/en/html/author.html"><code class="sgmltag-element">Author</code></a> metainfo field such that we now not only use 1301<a href="http://docbook.org/tdg/en/html/author.html"><code class="sgmltag-element">author</code></a>, but try to find a "best match" if we can't 1302find an <a href="http://docbook.org/tdg/en/html/author.html"><code class="sgmltag-element">author</code></a> name to put there.</p> 1303<p>Closes 1304#1233592. Thanks to Sam Steingold for the 1305request.</p> 1306<p class="commit-changes">Modified: manpages/info.xsl,1.12 - Michael(tm) 1307Smith</p> 1308</li><li> 1309<p>Changes for request #1243027, 1310"Impove handling of <a href="http://docbook.org/tdg/en/html/author.html"><code class="sgmltag-element">AUTHOR</code></a> <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a>." This 1311adds support for <a href="http://docbook.org/tdg/en/html/collab.html"><code class="sgmltag-element">Collab</code></a>, Corpauthor, Corpcredt, 1312<a href="http://docbook.org/tdg/en/html/orgname.html"><code class="sgmltag-element">Orgname</code></a>, <a href="http://docbook.org/tdg/en/html/publishername.html"><code class="sgmltag-element">Publishername</code></a>, and 1313<a href="http://docbook.org/tdg/en/html/publisher.html"><code class="sgmltag-element">Publisher</code></a>. Also adds support for output 1314of <a href="http://docbook.org/tdg/en/html/affiliation.html"><code class="sgmltag-element">Affiliation</code></a> and its children, and support for using 1315gentext strings for auto-attributing roles (<a href="http://docbook.org/tdg/en/html/author.html"><code class="sgmltag-element">Author</code></a>, 1316<a href="http://docbook.org/tdg/en/html/editor.html"><code class="sgmltag-element">Editor</code></a>, <a href="http://docbook.org/tdg/en/html/publisher.html"><code class="sgmltag-element">Publisher</code></a>, Translator, etc.). Also 1317did a lot of code cleanup and modularization of all the 1318<a href="http://docbook.org/tdg/en/html/author.html"><code class="sgmltag-element">AUTHOR</code></a> handling code. And fixed a bug that was causing 1319<a href="http://docbook.org/tdg/en/html/author.html"><code class="sgmltag-element">Author</code></a> <a href="http://docbook.org/tdg/en/html/info.html"><code class="sgmltag-element">info</code></a> to not be picked up correctly 1320for metainfo comment we embed in man-page 1321source.</p> 1322<p class="commit-changes">Modified: manpages/info.xsl,1.11 - Michael(tm) 1323Smith</p> 1324</li><li> 1325<p>Support bold output for 1326"<a href="http://docbook.org/tdg/en/html/emphasis.html"><code class="sgmltag-element">emphasis</code></a> remap='B'". (because Eric Raymond's 1327doclifter(1) tool converts groff source marked up with ".B" 1328request or "\fB" escapes to DocBook "<a href="http://docbook.org/tdg/en/html/emphasis.html"><code class="sgmltag-element">emphasis</code></a> 1329remap='B'".)</p> 1330<p class="commit-changes">Modified: manpages/inline.xsl,1.14 - Michael(tm) 1331Smith</p> 1332</li><li> 1333<p>Added support for 1334<a href="http://docbook.org/tdg/en/html/segmentedlist.html"><code class="sgmltag-element">Segmentedlist</code></a>. Details: Output is tabular, with no 1335option for "list" type output. Output for <a href="http://docbook.org/tdg/en/html/segtitle.html"><code class="sgmltag-element">Segtitle</code></a> 1336elements can be supressed by 1337setting man.<a href="http://docbook.org/tdg/en/html/segtitle.html"><code class="sgmltag-element">segtitle</code></a>.suppress. If <a href="http://docbook.org/tdg/en/html/segtitle.html"><code class="sgmltag-element">Segtitle</code></a> 1338content is output, it is rendered in italic type (not bold 1339because not all terminals support bold and so italic ensures the 1340stand out on those terminals). Extra space (.sp line) at end of 1341<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> code ensures that it gets handled correctly in 1342the case where its source is the child of a <a href="http://docbook.org/tdg/en/html/para.html"><code class="sgmltag-element">Para</code></a>. 1343Closes feature-request #1400097. Thanks to Daniel Leidert for the 1344patch and push, and to Alastair Rankine for filing the original 1345feature request.</p> 1346<p class="commit-changes">Modified: manpages/lists.xsl,1.23; 1347manpages/utility.xsl,1.10 - Michael(tm) Smith</p> 1348</li><li> 1349<p>Improved handling or 1350Author/Editor/Othercredit.</p> 1351<p>Reworked content of 1352(non-visible) comment added at top of each page (metadata 1353stuff).</p> 1354<p>Added support for generating a 1355<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/manifest.html"><em class="parameter"><code>manifest</code></em></a> file (useful for cleaning up 1356after builds, etc.)</p> 1357<p class="commit-changes">Modified: manpages/docbook.xsl,1.46; 1358manpages/info.xsl,1.9; manpages/other.xsl,1.12; 1359manpages/utility.xsl,1.6 - Michael(tm) Smith</p> 1360</li><li> 1361<p>Added two new parameters for 1362handling of multi-term 1363<a href="http://docbook.org/tdg/en/html/varlistentry.html"><code class="sgmltag-element">varlistentry</code></a> elements:</p> 1364<p><a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.break.after.html"><em class="parameter"><code>variablelist.term.break.after</code></em></a>: 1365When the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.break.after.html"><em class="parameter"><code>variablelist.term.break.after</code></em></a> is 1366non-zero, it will generate a line break after each 1367<a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a> multi-term 1368<a href="http://docbook.org/tdg/en/html/varlistentry.html"><code class="sgmltag-element">varlistentry</code></a>.</p> 1369<p><a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.separator.html"><em class="parameter"><code>variablelist.term.separator</code></em></a>: 1370When a <a href="http://docbook.org/tdg/en/html/varlistentry.html"><code class="sgmltag-element">varlistentry</code></a> contains multiple <a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a> 1371elements, the string specified in the value of the 1372<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.separator.html"><em class="parameter"><code>variablelist.term.separator</code></em></a> parameter is 1373placed after each <a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a> except the last. The default 1374is ", " (a comma followed by a space). To suppress rendering of 1375the separator, set the value of 1376<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.separator.html"><em class="parameter"><code>variablelist.term.separator</code></em></a> to the empty 1377string ("").</p> 1378<p>These parameters are primarily intended to be 1379useful if you have multi-term varlistentries that have long 1380terms.</p> 1381<p>Closes #1306676. Thanks to Sam Steingold for 1382providing an example "lots of long terms" doc that demonstrated 1383the value of having these options.</p> 1384<p>Also, added 1385normalize-space() call to processing of each 1386<a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a>.</p> 1387<p>This change affects all output formats 1388(HTML, PDF, manpages). The default behavior should pretty much 1389remain the same as before, but it is possible (as always) that 1390the change may introduce some 1391new bugginess.</p> 1392<p class="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; 1393fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86; 1394html/param.xweb,1.93; manpages/lists.xsl,1.22; 1395manpages/param.ent,1.14; manpages/param.xweb,1.16; 1396params/variablelist.term.break.after.xml,1.1; 1397params/variablelist.term.separator.xml,1.1 - Michael(tm) 1398Smith</p> 1399</li></ul></div> 1400</div> 1401 1402<div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1700_Params"></a>Params</h3></div></div></div> 1403 1404<p>The following changes have been made to the 1405 <code class="filename">params</code> code 1406 since the 1.69.1 release.</p> 1407<div class="itemizedlist"><ul type="disc"><li> 1408<p>New parameters to set 1409header/footer <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> minimum 1410height.</p> 1411<p class="commit-changes">Modified: params/footer.table.height.xml,1.1; 1412params/header.table.height.xml,1.1 - Robert 1413Stayton</p> 1414</li><li> 1415<p>Support multiple indexing methods 1416for different languages.</p> 1417<p class="commit-changes">Modified: params/index.method.xml,1.1 - Robert 1418Stayton</p> 1419</li><li> 1420<p>Remove <a href="http://docbook.org/tdg/en/html/qandaset.html"><code class="sgmltag-element">qandaset</code></a> and 1421<a href="http://docbook.org/tdg/en/html/qandadiv.html"><code class="sgmltag-element">qandadiv</code></a> from <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/generate.toc.html"><em class="parameter"><code>generate.toc</code></em></a> for fo 1422output because formerly it wasn't working, but now it is and 1423the default behavior should stay the 1424same.</p> 1425<p class="commit-changes">Modified: params/generate.toc.xml,1.8 - Robert 1426Stayton</p> 1427</li><li> 1428<p>add support for page number 1429references to <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> element 1430too.</p> 1431<p class="commit-changes">Modified: params/insert.link.page.number.xml,1.1 - Robert 1432Stayton</p> 1433</li><li> 1434<p>Add support for more characters to 1435hyphen on when <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/ulink.hyphenate.html"><em class="parameter"><code>ulink.hyphenate</code></em></a> is turned 1436on.</p> 1437<p class="commit-changes">Modified: params/ulink.hyphenate.chars.xml,1.1; 1438params/ulink.hyphenate.xml,1.3 - Robert Stayton</p> 1439</li><li> 1440<p>New attribute-set to format 1441<a href="http://docbook.org/tdg/en/html/biblioentry.html"><code class="sgmltag-element">biblioentry</code></a> and 1442<a href="http://docbook.org/tdg/en/html/bibliomixed.html"><code class="sgmltag-element">bibliomixed</code></a>.</p> 1443<p class="commit-changes">Modified: params/biblioentry.properties.xml,1.1 - 1444Robert Stayton</p> 1445</li><li> 1446<p>Added new parameter 1447<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chunk.tocs.and.lots.html"><em class="parameter"><code>chunk.tocs.and.lots</code></em></a>.has.<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> which 1448controls presence of <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> in a separate chunk with 1449ToC/LoT. Disabling <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> can be very useful if you are 1450generating frameset output (well, yes those frames, but some customers 1451really want them ;-).</p> 1452<p class="commit-changes">Modified: html/chunk-code.xsl,1.15; 1453html/param.ent,1.93; html/param.xweb,1.102; 1454params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka 1455Kosek</p> 1456</li><li> 1457<p>Added new attribute set 1458<a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">toc</code></a>.line.properties for controlling appearance of lines in 1459ToC/LoT</p> 1460<p class="commit-changes">Modified: params/toc.line.properties.xml,1.1 - Jirka 1461Kosek</p> 1462</li><li> 1463<p>Allow <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> footnotes 1464to have different properties from regular 1465footnotes.</p> 1466<p class="commit-changes">Modified: params/table.footnote.properties.xml,1.1 - Robert 1467Stayton</p> 1468</li><li> 1469<p>Set properties for pgwide="1" 1470objects.</p> 1471<p class="commit-changes">Modified: params/pgwide.properties.xml,1.1 - Robert 1472Stayton</p> 1473</li><li> 1474<p>Added the 1475autotoc.<a href="http://docbook.org/tdg/en/html/label.html"><code class="sgmltag-element">label</code></a>.in.hyperlink param.</p> 1476<p>If the value 1477of autotoc.<a href="http://docbook.org/tdg/en/html/label.html"><code class="sgmltag-element">label</code></a>.in.hyperlink is non-zero, labels 1478are included in hyperlinked titles in the <a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">TOC</code></a>. If it 1479is instead zero, labels are still displayed prior to the 1480hyperlinked titles, but are not hyperlinked along with the 1481titles.</p> 1482<p>Closes patch #1065868. Thanks to anatoly techtonik 1483for the patch.</p> 1484<p class="commit-changes">Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; 1485html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - 1486Michael(tm) Smith</p> 1487</li><li> 1488<p>Added two new params: 1489html.head.<a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a>.<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>.types 1490and html.head.<a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a>.<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>.multiple.</p> 1491<p>If 1492the value of the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/generate.legalnotice.link.html"><em class="parameter"><code>generate.legalnotice.link</code></em></a> is 1493non-zero, then the stylesheet generates (in the head 1494<a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> of the HTML source) either a single HTML 1495<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> element or, if the value of 1496the html.head.<a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a>.<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>.multiple is 1497non-zero, one <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> element for each <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> 1498type specified. Each <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> has the 1499following attributes:</p> 1500<p> - a rel attribute whose value 1501is derived from the value of 1502html.head.<a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a>.<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>.types</p> 1503<p> - 1504an href attribute whose value is set to the URL of the file 1505containing the <a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a></p> 1506<p> - a <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> 1507attribute whose value is set to the <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> of the 1508corresponding <a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a> (or a <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> 1509programatically determined by the stylesheet)</p> 1510<p>For 1511example:</p> 1512<p> <<a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a> rel="<a href="http://docbook.org/tdg/en/html/copyright.html"><code class="sgmltag-element">copyright</code></a>" 1513href="ln-id2524073.html" title="Legal Notice"></p> 1514<p>Closes 1515#1476450. Thanks to Sam Steingold.</p> 1516<p class="commit-changes">Modified: html/chunk-common.xsl,1.45; 1517html/param.ent,1.91; html/param.xweb,1.100; 1518params/generate.legalnotice.link.xml,1.4; 1519params/html.head.legalnotice.link.multiple.xml,1.1; 1520params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm) 1521Smith</p> 1522</li><li> 1523<p>Added the following 1524params:</p> 1525<p> - man.indent.width (string-valued) - 1526man.indent.refsect (boolean) - man.indent.blurbs (boolean) 1527- man.indent.lists (boolean) - man.indent.verbatims 1528(boolean)</p> 1529<p>Note that in earlier snapshots, man.indent.width 1530was named man.indentation.default.value and the boolean params 1531had names like man.indentation.*.adjust. Also the 1532man.indent.blurbs param was called man.indentation.authors.adjust 1533(or something).</p> 1534<p>The behavior now is: If the value of a 1535particular man.indent.* boolean param is non-zero, the 1536corresponding contents (refsect*, list items, 1537authorblurb/personblurb, vervatims) are displayed with a left 1538margin indented by a width equal to the value 1539of man.indent.width.</p> 1540<p class="commit-changes">Modified: params/man.indent.blurbs.xml,1.1; 1541manpages/docbook.xsl,1.74; manpages/info.xsl,1.20; 1542manpages/lists.xsl,1.30; manpages/other.xsl,1.20; 1543manpages/param.ent,1.22; manpages/param.xweb,1.24; 1544manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1; 1545params/man.indent.refsect.xml,1.1; 1546params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 - 1547Michael(tm) Smith</p> 1548</li><li> 1549<p>Added 1550man.<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>.footnotes.divider param.</p> 1551<p>In each 1552<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> that contains footenotes, the string specified 1553by the man.<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>.footnotes.divider parameter is output 1554before the list of footnotes for the 1555<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>.</p> 1556<p class="commit-changes">Modified: manpages/docbook.xsl,1.73; 1557manpages/links.xsl,1.6; manpages/param.ent,1.21; 1558manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 - 1559Michael(tm) Smith</p> 1560</li><li> 1561<p>Added the 1562man.output.in.separate.dir, 1563man.output.<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/base.dir.html"><em class="parameter"><code>base.dir</code></em></a>, 1564and man.output.subdirs.enabled parameters.</p> 1565<p>The 1566man.output.<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/base.dir.html"><em class="parameter"><code>base.dir</code></em></a> parameter specifies the 1567base directory into which man-page files are 1568output. The man.output.subdirs.enabled parameter controls whether 1569the files are output in subdirectories within the base 1570directory.</p> 1571<p>The values of the 1572man.output.<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/base.dir.html"><em class="parameter"><code>base.dir</code></em></a> 1573and man.output.subdirs.enabled parameters are used only if the 1574value of man.output.in.separate.dir parameter is non-zero. If the 1575value of man.output.in.separate.dir is zero, man-page files are 1576not output in a separate 1577directory.</p> 1578<p class="commit-changes">Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; 1579manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1; 1580params/man.output.in.separate.dir.xml,1.1; 1581params/man.output.subdirs.enabled.xml,1.1 - Michael(tm) 1582Smith</p> 1583</li><li> 1584<p>Added 1585man.font.<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>.headings and 1586man.font.<a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>.<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> params, for 1587controlling font in <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> headings and 1588titles.</p> 1589<p class="commit-changes">Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; 1590manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1; 1591params/man.font.table.title.xml,1.1 - Michael(tm) 1592Smith</p> 1593</li><li> 1594<p>Added 1595man.font.<a href="http://docbook.org/tdg/en/html/funcsynopsisinfo.html"><code class="sgmltag-element">funcsynopsisinfo</code></a> and 1596man.font.<a href="http://docbook.org/tdg/en/html/funcprototype.html"><code class="sgmltag-element">funcprototype</code></a> params, for specifying the roff 1597font (for example, BI, B, I) for <a href="http://docbook.org/tdg/en/html/funcsynopsisinfo.html"><code class="sgmltag-element">funcsynopsisinfo</code></a> and 1598<a href="http://docbook.org/tdg/en/html/funcprototype.html"><code class="sgmltag-element">funcprototype</code></a> output.</p> 1599<p class="commit-changes">Modified: manpages/block.xsl,1.19; 1600manpages/docbook.xsl,1.69; manpages/param.ent,1.18; 1601manpages/param.xweb,1.20; manpages/synop.xsl,1.29; 1602manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1; 1603params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) 1604Smith</p> 1605</li><li> 1606<p>Changed to select="0" in 1607<a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">refclass</code></a>.suppress (instead of 1608..>0</..)</p> 1609<p class="commit-changes">Modified: params/refclass.suppress.xml,1.3 - Michael(tm) 1610Smith</p> 1611</li><li> 1612<p>Added 1613man.<a href="http://docbook.org/tdg/en/html/segtitle.html"><code class="sgmltag-element">segtitle</code></a>.suppress param.</p> 1614<p>If the value of 1615man.<a href="http://docbook.org/tdg/en/html/segtitle.html"><code class="sgmltag-element">segtitle</code></a>.suppress is non-zero, then display 1616of <a href="http://docbook.org/tdg/en/html/segtitle.html"><code class="sgmltag-element">segtitle</code></a> contents is suppressed in 1617output.</p> 1618<p class="commit-changes">Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; 1619manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - 1620Michael(tm) Smith</p> 1621</li><li> 1622<p>Added 1623man.output.<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/manifest.html"><em class="parameter"><code>manifest</code></em></a>.enabled and 1624man.output.manifest.<a href="http://docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a> params.</p> 1625<p>If 1626man.output.<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/manifest.html"><em class="parameter"><code>manifest</code></em></a>.enabled is non-zero, a list 1627of filenames for man pages generated by the stylesheet 1628transformation is written to the file named by 1629man.output.<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/manifest.html"><em class="parameter"><code>manifest</code></em></a>.<a href="http://docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a></p> 1630<p class="commit-changes">Modified: manpages/docbook.xsl,1.67; 1631manpages/other.xsl,1.19; manpages/param.ent,1.16; 1632manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1; 1633params/man.output.manifest.filename.xml,1.1; 1634tools/make/Makefile.DocBook,1.4 - Michael(tm) 1635Smith</p> 1636</li><li> 1637<p>Added <a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">refclass</code></a>.suppress 1638param.</p> 1639<p>If the value of <a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">refclass</code></a>.suppress is 1640non-zero, then display <a href="http://docbook.org/tdg/en/html/refclass.html"><code class="sgmltag-element">refclass</code></a> contents is suppressed 1641in output. Affects HTML and FO output 1642only.</p> 1643<p class="commit-changes">Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; 1644html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) 1645Smith</p> 1646</li><li> 1647<p>Added 1648<a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>.meta.get.quietly param.</p> 1649<p>If zero (the 1650default), notes and warnings about "missing" markup are generated 1651during gathering of <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> metadata. If 1652non-zero, the metadata is gathered "quietly" -- that is, the 1653notes and warnings are suppressed.</p> 1654<p>NOTE: If you are 1655processing a large amount of <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> content, you 1656may be able to speed up processing significantly by setting a 1657non-zero value for 1658<a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>.meta.get.quietly.</p> 1659<p class="commit-changes">Modified: common/refentry.xsl,1.17; 1660manpages/param.ent,1.15; manpages/param.xweb,1.17; 1661params/refentry.meta.get.quietly.xml,1.1 - Michael(tm) 1662Smith</p> 1663</li><li> 1664<p>Added support for "software" and 1665"sectdesc" class values on <a href="http://docbook.org/tdg/en/html/refmiscinfo.html"><code class="sgmltag-element">refmiscinfo</code></a>; "software" is 1666treated identically to "source", and "setdesc" is treated 1667identically to "manual".</p> 1668<p class="commit-changes">Modified: common/refentry.xsl,1.10; 1669params/man.th.extra2.max.length.xml,1.3; 1670params/refentry.source.name.profile.xml,1.4 - Michael(tm) 1671Smith</p> 1672</li><li> 1673<p>Drastically reworked all of the 1674XPath expressions used in <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> metadata gathering 1675-- completely removed $parentinfo and turned $info into a set of 1676nodes that includes the *info contents of the <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">Refentry</code></a> 1677plus the *info contents all all of its ancestor elements. The 1678basic XPath expression now used throughout is (using the example 1679of checking for a <a href="http://docbook.org/tdg/en/html/date.html"><code class="sgmltag-element">date</code></a>):</p> 1680<p> 1681(($info[//date])[last()]/date)[1].</p> 1682<p>That selects the "last" 1683*info/date <a href="http://docbook.org/tdg/en/html/date.html"><code class="sgmltag-element">date</code></a> in document order -- that is, the one 1684eitther on the <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">Refentry</code></a> itself or on the 1685closest ancestor to the <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">Refentry</code></a>.</p> 1686<p>It's 1687likely this change may break some things; may need to pick up 1688some pieces later.</p> 1689<p>Also, changed the default value for the 1690<a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.th.extra2.max.length.html"><em class="parameter"><code>man.th.extra2.max.length</code></em></a> from 40 to 169130.</p> 1692<p class="commit-changes">Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; 1693params/man.th.extra2.max.length.xml,1.2; 1694params/refentry.date.profile.xml,1.2; 1695params/refentry.manual.profile.xml,1.2; 1696params/refentry.source.name.profile.xml,1.2; 1697params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; 1698manpages/other.xsl,1.15 - Michael(tm) Smith</p> 1699</li><li> 1700<p>Added option for turning off bold 1701formatting in <a href="http://docbook.org/tdg/en/html/funcsynopsis.html"><code class="sgmltag-element">Funcsynopsis</code></a>. Boldface formatting in 1702<a href="http://docbook.org/tdg/en/html/function.html"><code class="sgmltag-element">function</code></a> <a href="http://docbook.org/tdg/en/html/synopsis.html"><code class="sgmltag-element">synopsis</code></a> is mandated in the 1703man(7) man page and is used almost universally in existing man 1704pages. Despite that, it really does look like crap to have an 1705entire <a href="http://docbook.org/tdg/en/html/funcsynopsis.html"><code class="sgmltag-element">Funcsynopsis</code></a> output in bold, so I added params 1706for turning off the bold formatting and/or replacing it with a 1707different roff special font (e.g., "RI" for alternating 1708roman/italic instead of the default "BI" for alternating 1709bold/italic). The new params 1710are "man.<a href="http://docbook.org/tdg/en/html/funcprototype.html"><code class="sgmltag-element">funcprototype</code></a>.font" and 1711"man.<a href="http://docbook.org/tdg/en/html/funcsynopsisinfo.html"><code class="sgmltag-element">funcsynopsisinfo</code></a>.font". To be documented 1712later.</p> 1713<p>Closes #1452247. Thanks to Joe Orton for the feature 1714request.</p> 1715<p class="commit-changes">Modified: params/man.string.subst.map.xml,1.16; 1716manpages/block.xsl,1.10; manpages/docbook.xsl,1.51; 1717manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm) 1718Smith</p> 1719</li><li> 1720<p><a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/fop.extensions.html"><em class="parameter"><code>fop.extensions</code></em></a> now only 1721for FOP version 0.20.5 and earlier.</p> 1722<p class="commit-changes">Modified: params/fop.extensions.xml,1.4 1723- Robert Stayton</p> 1724</li><li> 1725<p>Support for fop1 different from 1726fop 0.20.5 and earlier.</p> 1727<p class="commit-changes">Modified: params/fop1.extensions.xml,1.1 - Robert 1728Stayton</p> 1729</li><li> 1730<p>Reset default value to empty 1731string so template uses gentext first, then the parameter value 1732if not empty.</p> 1733<p class="commit-changes">Modified: params/index.number.separator.xml,1.2; 1734params/index.range.separator.xml,1.2; 1735params/index.term.separator.xml,1.2 - Robert 1736Stayton</p> 1737</li><li> 1738<p>New parameter: 1739<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/id.warnings.html"><em class="parameter"><code>id.warnings</code></em></a>. If non-zero, warnings are 1740generated for titled objects that don't have titles. True by default; 1741I wonder if this will be too aggressive?</p> 1742<p class="commit-changes">Modified: html/biblio.xsl,1.25; 1743html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19; 1744html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16; 1745html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22; 1746html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman 1747Walsh</p> 1748</li><li> 1749<p>Added new parameter 1750<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/keep.relative.image.uris.html"><em class="parameter"><code>keep.relative.image.uris</code></em></a></p> 1751<p class="commit-changes">Modified: fo/param.ent,1.91; 1752fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96; 1753params/keep.relative.image.uris.xml,1.1 - Norman 1754Walsh</p> 1755</li><li> 1756<p>Support default <a href="http://docbook.org/tdg/en/html/label.html"><code class="sgmltag-element">label</code></a> 1757width parameters for itemized and ordered lists</p> 1758<p class="commit-changes">Modified: fo/lists.xsl,1.64; 1759fo/param.ent,1.90; fo/param.xweb,1.103; 1760params/itemizedlist.label.width.xml,1.1; 1761params/orderedlist.label.width.xml,1.1 - Norman 1762Walsh</p> 1763</li><li> 1764<p>Added parameters to localize 1765punctuation in indexes.</p> 1766<p class="commit-changes">Modified: params/index.number.separator.xml,1.1; 1767params/index.range.separator.xml,1.1; 1768params/index.term.separator.xml,1.1 - Robert 1769Stayton</p> 1770</li><li> 1771<p>Added two new parameters for 1772handling of multi-term 1773<a href="http://docbook.org/tdg/en/html/varlistentry.html"><code class="sgmltag-element">varlistentry</code></a> elements:</p> 1774<p><a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.break.after.html"><em class="parameter"><code>variablelist.term.break.after</code></em></a>: 1775When the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.break.after.html"><em class="parameter"><code>variablelist.term.break.after</code></em></a> is 1776non-zero, it will generate a line break after each 1777<a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a> multi-term 1778<a href="http://docbook.org/tdg/en/html/varlistentry.html"><code class="sgmltag-element">varlistentry</code></a>.</p> 1779<p><a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.separator.html"><em class="parameter"><code>variablelist.term.separator</code></em></a>: 1780When a <a href="http://docbook.org/tdg/en/html/varlistentry.html"><code class="sgmltag-element">varlistentry</code></a> contains multiple <a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a> 1781elements, the string specified in the value of the 1782<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.separator.html"><em class="parameter"><code>variablelist.term.separator</code></em></a> parameter is 1783placed after each <a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a> except the last. The default 1784is ", " (a comma followed by a space). To suppress rendering of 1785the separator, set the value of 1786<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/variablelist.term.separator.html"><em class="parameter"><code>variablelist.term.separator</code></em></a> to the empty 1787string ("").</p> 1788<p>These parameters are primarily intended to be 1789useful if you have multi-term varlistentries that have long 1790terms.</p> 1791<p>Closes #1306676. Thanks to Sam Steingold for 1792providing an example "lots of long terms" doc that demonstrated 1793the value of having these options.</p> 1794<p>Also, added 1795normalize-space() call to processing of each 1796<a href="http://docbook.org/tdg/en/html/term.html"><code class="sgmltag-element">term</code></a>.</p> 1797<p>This change affects all output formats 1798(HTML, PDF, manpages). The default behavior should pretty much 1799remain the same as before, but it is possible (as always) that 1800the change may introduce some 1801new bugginess.</p> 1802<p class="commit-changes">Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; 1803fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86; 1804html/param.xweb,1.93; manpages/lists.xsl,1.22; 1805manpages/param.ent,1.14; manpages/param.xweb,1.16; 1806params/variablelist.term.break.after.xml,1.1; 1807params/variablelist.term.separator.xml,1.1 - Michael(tm) 1808Smith</p> 1809</li><li> 1810<p>Convert 'no' to string in default 1811value.</p> 1812<p class="commit-changes">Modified: params/olink.doctitle.xml,1.4 - Robert 1813Stayton</p> 1814</li><li> 1815<p>Implemented RFE 1816#1292615.</p> 1817<p>Added bunch of new parameters (attribute sets) 1818that affect list presentation: list.block.properties, 1819<a href="http://docbook.org/tdg/en/html/itemizedlist.html"><code class="sgmltag-element">itemizedlist</code></a>.properties, <a href="http://docbook.org/tdg/en/html/orderedlist.html"><code class="sgmltag-element">orderedlist</code></a>.properties, 1820<a href="http://docbook.org/tdg/en/html/itemizedlist.html"><code class="sgmltag-element">itemizedlist</code></a>.<a href="http://docbook.org/tdg/en/html/label.html"><code class="sgmltag-element">label</code></a>.properties and 1821<a href="http://docbook.org/tdg/en/html/orderedlist.html"><code class="sgmltag-element">orderedlist</code></a>.<a href="http://docbook.org/tdg/en/html/label.html"><code class="sgmltag-element">label</code></a>.properties. Default behaviour 1822of stylesheets has not been changed but further customizations will be 1823much more easier.</p> 1824<p class="commit-changes">Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; 1825fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1; 1826params/itemizedlist.properties.xml,1.1; 1827params/list.block.properties.xml,1.1; 1828params/orderedlist.label.properties.xml,1.1; 1829params/orderedlist.properties.xml,1.1 - Jirka 1830Kosek</p> 1831</li><li> 1832<p>Implemented RFE 1833#1242092.</p> 1834<p>You can enable crop marks in your document by 1835setting crop.marks=1 and xep.extensions=1. Appearance of crop 1836marks can be controlled by parameters 1837<a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/crop.mark.bleed.html"><em class="parameter"><code>crop.mark.bleed</code></em></a> (6pt), 1838<a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/crop.mark.offset.html"><em class="parameter"><code>crop.mark.offset</code></em></a> (24pt) and 1839<a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/crop.mark.width.html"><em class="parameter"><code>crop.mark.width</code></em></a> (0.5pt).</p> 1840<p>Also there 1841is new named template called user-xep-pis. You can overwrite it in 1842order to produce some PIs that can control XEP as described in 1843http://www.renderx.com/reference.html#Output_Formats</p> 1844<p class="commit-changes">Modified: fo/docbook.xsl,1.36; 1845fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23; 1846params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1; 1847params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka 1848Kosek</p> 1849</li><li> 1850<p>Changed short descriptions in doc 1851for *autolabel* params to match new autolabel 1852behavior.</p> 1853<p class="commit-changes">Modified: params/appendix.autolabel.xml,1.5; 1854params/chapter.autolabel.xml,1.4; params/part.autolabel.xml,1.5; 1855params/preface.autolabel.xml,1.4 - Michael(tm) 1856Smith</p> 1857</li></ul></div> 1858</div> 1859 1860<div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1700_Profiling"></a>Profiling</h3></div></div></div> 1861 1862<p>The following changes have been made to the 1863 <code class="filename">profiling</code> code 1864 since the 1.69.1 release.</p> 1865<div class="itemizedlist"><ul type="disc"><li> 1866<p>Profiling now works together with 1867namespace stripping (V5 documents). Namespace striping should work 1868with all stylesheets named profile-, even if they are not supporting 1869namespace stripping in a non-profiling 1870variant.</p> 1871<p class="commit-changes">Modified: profiling/profile-mode.xsl,1.4; 1872profiling/xsl2profile.xsl,1.7 - Jirka Kosek</p> 1873</li><li> 1874<p>Moved profiling stage out of 1875templates. This make possible to reuse profiled content by several 1876templates and still maintaing node indentity (needed for example for 1877HTML Help where content is processed multiple times).</p> 1878<p>I 1879don't know why this was not on the top level before. Maybe some XSLT 1880processors choked on it. I hope this will be OK 1881now.</p> 1882<p class="commit-changes">Modified: profiling/xsl2profile.xsl,1.5 - Jirka 1883Kosek</p> 1884</li></ul></div> 1885</div> 1886 1887<div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1700_Tools"></a>Tools</h3></div></div></div> 1888 1889<p>The following changes have been made to the 1890 <code class="filename">tools</code> code 1891 since the 1.69.1 release.</p> 1892<div class="itemizedlist"><ul type="disc"><li> 1893<p>Moved Makefile.DocBook from 1894<a href="http://docbook.org/tdg/en/html/contrib.html"><code class="sgmltag-element">contrib</code></a> module to xsl 1895module.</p> 1896<p class="commit-changes">Modified: tools/make/Makefile.DocBook,1.1 - Michael(tm) 1897Smith</p> 1898</li></ul></div> 1899</div> 1900 1901<div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1700_WordML"></a>WordML</h3></div></div></div> 1902 1903<p>The following changes have been made to the 1904 <code class="filename">wordml</code> code 1905 since the 1.69.1 release.</p> 1906<div class="itemizedlist"><ul type="disc"><li> 1907<p>added <a href="http://docbook.org/tdg/en/html/contrib.html"><code class="sgmltag-element">contrib</code></a> element, 1908better handling of default paragraph 1909style</p> 1910<p class="commit-changes">Modified: wordml/pages-normalise.xsl,1.6; wordml/supported.xml,1.2; 1911wordml/wordml-final.xsl,1.14 - Steve Ball</p> 1912</li><li> 1913<p>added 1914<a href="http://docbook.org/tdg/en/html/bridgehead.html"><code class="sgmltag-element">bridgehead</code></a></p> 1915<p class="commit-changes">Modified: wordml/docbook-pages.xsl,1.6; 1916wordml/docbook.xsl,1.17; wordml/pages-normalise.xsl,1.5; 1917wordml/template-pages.xml,1.7; wordml/template.dot,1.4; 1918wordml/template.xml,1.14; wordml/wordml-final.xsl,1.13 - Steve 1919Ball</p> 1920</li><li> 1921<p>added blocks stylesheet to support 1922bibliographies, glossaries and qandasets</p> 1923<p class="commit-changes">Modified: wordml/Makefile,1.4; 1924wordml/README,1.3; wordml/blocks-spec.xml,1.1; 1925wordml/docbook-pages.xsl,1.5; wordml/docbook.xsl,1.16; 1926wordml/pages-normalise.xsl,1.4; wordml/sections-spec.xml,1.3; 1927wordml/specifications.xml,1.13; wordml/template-pages.xml,1.6; 1928wordml/template.dot,1.3; wordml/template.xml,1.13; 1929wordml/wordml-blocks.xsl,1.1; wordml/wordml-final.xsl,1.12; 1930wordml/wordml-sections.xsl,1.3 - Steve Ball</p> 1931</li><li> 1932<p>added <a href="http://docbook.org/tdg/en/html/mediaobject.html"><code class="sgmltag-element">mediaobject</code></a> 1933<a href="http://docbook.org/tdg/en/html/caption.html"><code class="sgmltag-element">caption</code></a></p> 1934<p class="commit-changes">Modified: wordml/docbook-pages.xsl,1.4; 1935wordml/docbook.xsl,1.15; wordml/specifications.xml,1.12; 1936wordml/template-pages.xml,1.5; wordml/template.dot,1.2; 1937wordml/template.xml,1.12; wordml/wordml-final.xsl,1.11 - Steve 1938Ball</p> 1939</li><li> 1940<p>added 1941callouts</p> 1942<p class="commit-changes">Modified: wordml/docbook-pages.xsl,1.3; wordml/docbook.xsl,1.14; 1943wordml/pages-normalise.xsl,1.3; wordml/specifications.xml,1.11; 1944wordml/template-pages.xml,1.4; wordml/wordml-final.xsl,1.10 - Steve 1945Ball</p> 1946</li><li> 1947<p>added Word template 1948file</p> 1949<p class="commit-changes">Modified: wordml/template.dot,1.1 - Steve Ball</p> 1950</li><li> 1951<p>added <a href="http://docbook.org/tdg/en/html/abstract.html"><code class="sgmltag-element">abstract</code></a>, fixed 1952<a href="http://docbook.org/tdg/en/html/itemizedlist.html"><code class="sgmltag-element">itemizedlist</code></a>, ulink</p> 1953<p class="commit-changes">Modified: wordml/specifications.xml,1.10; 1954wordml/wordml-final.xsl,1.9 - Steve Ball</p> 1955</li><li> 1956<p>fixed Makefile added many 1957features to Pages support added <a href="http://docbook.org/tdg/en/html/revhistory.html"><code class="sgmltag-element">revhistory</code></a>, inlines, 1958highlights, <a href="http://docbook.org/tdg/en/html/abstract.html"><code class="sgmltag-element">abstract</code></a></p> 1959<p class="commit-changes">Modified: wordml/Makefile,1.2; 1960wordml/docbook-pages.xsl,1.2; wordml/pages-normalise.xsl,1.2; 1961wordml/sections-spec.xml,1.2; wordml/specifications.xml,1.9; 1962wordml/template-pages.xml,1.3; wordml/template.xml,1.11; 1963wordml/wordml-final.xsl,1.8; wordml/wordml-sections.xsl,1.2 - Steve 1964Ball</p> 1965</li><li> 1966<p>fixed handling linebreaks when 1967generating WordML added Apple Pages 1968support</p> 1969<p class="commit-changes">Modified: wordml/docbook.xsl,1.13; wordml/template-pages.xml,1.2 - 1970Steve Ball</p> 1971</li></ul></div> 1972</div> 1973</div> 1974 1975 <div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1691"></a>Release 1.69.1</h2></div></div></div> 1976 1977 <p>This release is a minor bug-fix update to the 1.69.0 1978 release. Along with bug fixes, it includes one 1979 configuration-parameter change: The default value of the 1980 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/annotation.support.html"><em class="parameter"><code>annotation.support</code></em></a> parameter is now 1981 <code class="literal">0</code> (off). The reason for that change is that 1982 there have been reports that <a href="http://docbook.org/tdg/en/html/annotation.html"><code class="sgmltag-element">annotation</code></a> handling is 1983 causing a significant performance degradation in processing of 1984 large documents with <span><strong class="command">xsltproc</strong></span>.</p> 1985 </div> 1986 1987 1988 <div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1690"></a>Release 1.69.0</h2></div></div></div> 1989 1990 <p>The release includes major feature changes, 1991 particularly in the <a href="#V1690_MAN" title="man">manpages 1992 stylesheets</a>, as well as a large number of bug fixes.</p> 1993 1994 <p>As with all DocBook Project “<span class="quote">dot zero</span>” releases, this is an 1995 <a href="#dot0" title="About dot-zero releases">experimental release </a>.</p> 1996 1997 <div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_COMMON"></a>Common</h3></div></div></div> 1998 1999 <div class="itemizedlist"><ul type="disc"><li> 2000 <p>This release adds localizations for the following 2001 languages: 2002 <span class="simplelist">Albanian, Amharic, Azerbaijani, Hindi, Irish (Gaelic), Gujarati, Kannada, Mongolian, Oriya, Punjabi, Tagalog, Tamil, and Welsh</span>.</p> 2003 </li><li> 2004 <p>Added support for specifying number format for auto 2005 labels for <a href="http://docbook.org/tdg/en/html/chapter.html"><code class="sgmltag-element">chapter</code></a>, <a href="http://docbook.org/tdg/en/html/appendix.html"><code class="sgmltag-element">appendix</code></a>, 2006 <a href="http://docbook.org/tdg/en/html/part.html"><code class="sgmltag-element">part</code></a>, and <a href="http://docbook.org/tdg/en/html/preface.html"><code class="sgmltag-element">preface</code></a>. Contolled with the 2007 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/appendix.autolabel.html"><em class="parameter"><code>appendix.autolabel</code></em></a>, 2008 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chapter.autolabel.html"><em class="parameter"><code>chapter.autolabel</code></em></a>, 2009 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/part.autolabel.html"><em class="parameter"><code>part.autolabel</code></em></a>, and 2010 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/preface.autolabel.html"><em class="parameter"><code>preface.autolabel</code></em></a> parameters.</p> 2011 </li><li> 2012 <p>Added basic support for <a href="http://docbook.org/tdg/en/html/biblioref.html"><code class="sgmltag-element">biblioref</code></a> cross 2013 referencing.</p> 2014 </li><li> 2015 <p>Added support for <code class="sgmltag-attribute">align</code> 2016 on <a href="http://docbook.org/tdg/en/html/caption.html"><code class="sgmltag-element">caption</code></a> in <a href="http://docbook.org/tdg/en/html/mediaobject.html"><code class="sgmltag-element">mediaobject</code></a>.</p> 2017 </li><li> 2018 <p>Added support for processing documents that use the 2019 DocBook V5 namespace.</p> 2020 </li><li> 2021 <p>Added support for <a href="http://docbook.org/tdg/en/html/termdef.html"><code class="sgmltag-element">termdef</code></a> and 2022 <a href="http://docbook.org/tdg/en/html/mathphrase.html"><code class="sgmltag-element">mathphrase</code></a>.</p> 2023 </li><li> 2024 <p>EXPERIMENTAL: Incorporated the Slides and Website 2025 stylesheets into the DocBook XSL stylesheets package. So, 2026 for example, Website documents can now be processed using 2027 the following URI for the driver Website 2028 <code class="filename">tabular.xsl</code> file: </p><pre class="literallayout"><code class="uri">http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl</code></pre> 2029 </li><li> 2030 <p>A <a href="http://docbook.org/tdg/en/html/procedure.html"><code class="sgmltag-element">procedure</code></a> without a <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> is 2031 now treated as an “<span class="quote">informal</span>” procedure (meaning 2032 that it is not added to any generated “<span class="quote">list of 2033 procedures</span>” and has no affect on numbering of 2034 generated labels for other procedures).</p> 2035 </li><li> 2036 <p><code class="sgmltag-element">docname</code> is no longer added to 2037 <a href="http://docbook.org/tdg/en/html/olink.html"><code class="sgmltag-element">olink</code></a> when pointing to a root element.</p> 2038 </li><li> 2039 <p>Added support for generation of choice separator in 2040 inline simplelist. This enables auto-generation of an 2041 appropriate localized “<span class="quote">choice separator</span>” (for 2042 example, “<span class="quote">and</span>” or “<span class="quote">or</span>”) before the 2043 final item in an inline <a href="http://docbook.org/tdg/en/html/simplelist.html"><code class="sgmltag-element">simplelist</code></a>.</p> 2044 <p>To indicate that you want a choice separator 2045 generated for a particular list, you need to put a processing 2046 instruction (PI) of the form 2047 <code class="sgmltag-xmlpi"><?dbchoice choice="foo"?></code> as a 2048 child of the list. For example: 2049 </p><pre class="literallayout"> <para>Choose from 2050 ONE and ONLY ONE of the following: 2051 <simplelist type="inline"> 2052 <?dbchoice choice="or" ?> 2053 <member>A</member> 2054 <member>B</member> 2055 <member>C</member>.</simplelist></para></pre><p> 2056 2057 Output (for English): 2058 </p><div class="blockquote"><blockquote class="blockquote"> 2059 <p>Choose from ONE and only ONE of the 2060 following choices: A, B, or C.</p> 2061 </blockquote></div><p> 2062 As a temporary workaround for the fact that most of the 2063 DocBook non-English locale files don't have a localization for 2064 the word “<span class="quote">or</span>”, you can put in a literal string to 2065 be used; example for French: <code class="sgmltag-pi"><?dbchoice choice="ou"></code>. That is, use 2066 “<span class="quote">ou</span>” instead of “<span class="quote">or</span>”.</p> 2067 </li></ul></div> 2068 </div> 2069 <div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_FO"></a>FO</h3></div></div></div> 2070 2071 <div class="itemizedlist"><ul type="disc"><li> 2072 <p> Added <code class="literal">content-type</code> property to 2073 <code class="literal">external-graphic</code> element, based on 2074 <a href="http://docbook.org/tdg/en/html/imagedata.html"><code class="sgmltag-element">imagedata</code></a> <code class="sgmltag-attribute">format</code> 2075 attribute.</p> 2076 </li><li> 2077 <p>Added support for generating 2078 <code class="literal"><rx:meta-field creator="$VERSION"/></code> 2079 field for XEP output. This makes the DocBook XSL 2080 stylesheet version information available through the 2081 <span class="guimenu">Document Properties</span> menu in Acrobat 2082 Reader and other PDF viewers.</p> 2083 </li><li> 2084 <p>Trademark symbol handling made consistent with 2085 handling of same in HTML stylesheets. Prior to this change, 2086 if you processed a document that contained no value for the 2087 <code class="sgmltag-attribute">class</code> attribute on the 2088 <a href="http://docbook.org/tdg/en/html/trademark.html"><code class="sgmltag-element">trademark</code></a> element, the HTML stylesheets would 2089 default to rendering a superscript <code class="literal">TM 2090 </code>symbol after the <a href="http://docbook.org/tdg/en/html/trademark.html"><code class="sgmltag-element">trademark</code></a> contents, 2091 but the FO stylesheets would render nothing.</p> 2092 </li><li> 2093 <p>Added support for generating XEP bookmarks for 2094 <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>.</p> 2095 </li><li> 2096 <p>Added support for HTML markup <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> <code class="sgmltag-attribute">border</code> attribute, applied to each 2097 table cell.</p> 2098 </li><li> 2099 <p>The <code class="function">table.width</code> template can now 2100 sum column specs if none use <code class="literal">%</code> or 2101 <code class="literal">*</code>.</p> 2102 </li><li> 2103 <p>Added <code class="literal">fox:destination</code> extension 2104 inside <code class="literal">fox:outline</code> to support linking to 2105 internal destinations.</p> 2106 </li><li> 2107 <p>Added support for customizing 2108 <code class="literal">abstract</code> with property sets. Controlled 2109 with the <em class="parameter"><code>abstract.properties</code></em> and 2110 <em class="parameter"><code>abstract.title.properties</code></em> 2111 parameters.</p> 2112 </li><li> 2113 <p>Add <a href="http://docbook.org/tdg/en/html/footnote.html"><code class="sgmltag-element">footnote</code></a>s in <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> title to 2114 table footnote set, and add support for table footnotes to 2115 HTML table markup.</p> 2116 </li><li> 2117 <p>Added support for <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> in 2118 <a href="http://docbook.org/tdg/en/html/glosslist.html"><code class="sgmltag-element">glosslist</code></a>.</p> 2119 </li><li> 2120 <p>Added support for <a href="http://docbook.org/tdg/en/html/itemizedlist.html"><code class="sgmltag-element">itemizedlist</code></a> symbol 2121 <code class="literal">none</code>.</p> 2122 </li><li> 2123 <p>Implemented the new 2124 <em class="parameter"><code>graphical.admonition.properties</code></em> and 2125 <em class="parameter"><code>nongraphical.admonition.properties</code></em> 2126 attribute sets.</p> 2127 </li><li> 2128 <p>Added <code class="sgmltag-attribute">id</code> to 2129 <a href="http://docbook.org/tdg/en/html/formalpara.html"><code class="sgmltag-element">formalpara</code></a> and some other blocks that were 2130 missing it.</p> 2131 </li><li> 2132 <p>Changed the anchor template to output 2133 <code class="literal">fo:inline</code> instead of 2134 <code class="literal">fo:wrapper</code>.</p> 2135 </li><li> 2136 <p>Added support for <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/toc.max.depth.html"><em class="parameter"><code>toc.max.depth</code></em></a> 2137 parameter.</p> 2138 </li></ul></div> 2139 </div> 2140 2141 <div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_HELP"></a>Help</h3></div></div></div> 2142 2143 <div class="itemizedlist"><ul type="disc"><li> 2144 <p>Eclipse Help: Added support for generating olink 2145 database.</p> 2146 </li></ul></div> 2147 </div> 2148 2149 <div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_HTML"></a>HTML</h3></div></div></div> 2150 2151 <div class="itemizedlist"><ul type="disc"><li> 2152 <p>Added a first cut at support in HTML output for 2153 DocBook 5 style <a href="http://docbook.org/tdg/en/html/annotation.html"><code class="sgmltag-element">annotation</code></a>s. Controlled using the 2154 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/annotation.support.html"><em class="parameter"><code>annotation.support</code></em></a> parameter, and 2155 implemented using JavaScript and CSS styling. For more 2156 details, see the documentation for the 2157 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/annotation.js.html"><em class="parameter"><code>annotation.js</code></em></a>, 2158 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/annotation.css.html"><em class="parameter"><code>annotation.css</code></em></a>, 2159 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/annotation.graphic.open.html"><em class="parameter"><code>annotation.graphic.open</code></em></a>, and 2160 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/annotation.graphic.close.html"><em class="parameter"><code>annotation.graphic.close</code></em></a> 2161 parameters.</p> 2162 </li><li> 2163 <p>Generate client-side image map for 2164 <a href="http://docbook.org/tdg/en/html/imageobjectco.html"><code class="sgmltag-element">imageobjectco</code></a> with areas using 2165 <code class="literal">calspair</code> units</p> 2166 </li><li> 2167 <p>Added support for <code class="sgmltag-xmlpi"><?img.src.path?></code> PI.</p> 2168 </li><li> 2169 <p>Added support for passing 2170 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/img.src.path.html"><em class="parameter"><code>img.src.path</code></em></a> to DocBook Java XSLT 2171 image extensions when appropriate. Controlled using the 2172 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/graphicsize.use.img.src.path.html"><em class="parameter"><code>graphicsize.use.img.src.path</code></em></a> 2173 parameter.</p> 2174 </li><li> 2175 <p>Added support for (not 2176 valid for DocBook 4) <code class="sgmltag-attribute">xlink:href</code> 2177 on <a href="http://docbook.org/tdg/en/html/area.html"><code class="sgmltag-element">area</code></a> and (not valid for DocBook 4) 2178 <a href="http://docbook.org/tdg/en/html/alt.html"><code class="sgmltag-element">alt</code></a> in <a href="http://docbook.org/tdg/en/html/area.html"><code class="sgmltag-element">area</code></a>.</p> 2179 </li><li> 2180 <p>Added new parameter 2181 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/default.table.frame.html"><em class="parameter"><code>default.table.frame</code></em></a> to control table 2182 framing if there is no <code class="sgmltag-attribute">frame</code> 2183 attribute on a table.</p> 2184 </li><li> 2185 <p>Added initial, experimental support for generating 2186 content for the HTML <code class="literal">title</code> attribute from 2187 content of the <a href="http://docbook.org/tdg/en/html/alt.html"><code class="sgmltag-element">alt</code></a> element. This change adds 2188 support for the following inline elements only (none of them 2189 are block elements): 2190 <span class="simplelist"><a href="http://docbook.org/tdg/en/html/abbrev.html"><code class="sgmltag-element">abbrev</code></a>, <a href="http://docbook.org/tdg/en/html/accel.html"><code class="sgmltag-element">accel</code></a>, <a href="http://docbook.org/tdg/en/html/acronym.html"><code class="sgmltag-element">acronym</code></a>, <code class="sgmltag-element">action</code>, <a href="http://docbook.org/tdg/en/html/application.html"><code class="sgmltag-element">application</code></a>, <a href="http://docbook.org/tdg/en/html/authorinitials.html"><code class="sgmltag-element">authorinitials</code></a>, <code class="sgmltag-element">beginpage</code>, <a href="http://docbook.org/tdg/en/html/citation.html"><code class="sgmltag-element">citation</code></a>, <a href="http://docbook.org/tdg/en/html/citerefentry.html"><code class="sgmltag-element">citerefentry</code></a>, <a href="http://docbook.org/tdg/en/html/citetitle.html"><code class="sgmltag-element">citetitle</code></a>, <a href="http://docbook.org/tdg/en/html/city.html"><code class="sgmltag-element">city</code></a>, <a href="http://docbook.org/tdg/en/html/classname.html"><code class="sgmltag-element">classname</code></a>, <a href="http://docbook.org/tdg/en/html/code.html"><code class="sgmltag-element">code</code></a>, <a href="http://docbook.org/tdg/en/html/command.html"><code class="sgmltag-element">command</code></a>, <a href="http://docbook.org/tdg/en/html/computeroutput.html"><code class="sgmltag-element">computeroutput</code></a>, <a href="http://docbook.org/tdg/en/html/constant.html"><code class="sgmltag-element">constant</code></a>, <a href="http://docbook.org/tdg/en/html/country.html"><code class="sgmltag-element">country</code></a>, <a href="http://docbook.org/tdg/en/html/database.html"><code class="sgmltag-element">database</code></a>, <a href="http://docbook.org/tdg/en/html/email.html"><code class="sgmltag-element">email</code></a>, <a href="http://docbook.org/tdg/en/html/envar.html"><code class="sgmltag-element">envar</code></a>, <a href="http://docbook.org/tdg/en/html/errorcode.html"><code class="sgmltag-element">errorcode</code></a>, <a href="http://docbook.org/tdg/en/html/errorname.html"><code class="sgmltag-element">errorname</code></a>, <a href="http://docbook.org/tdg/en/html/errortext.html"><code class="sgmltag-element">errortext</code></a>, <a href="http://docbook.org/tdg/en/html/errortype.html"><code class="sgmltag-element">errortype</code></a>, <a href="http://docbook.org/tdg/en/html/exceptionname.html"><code class="sgmltag-element">exceptionname</code></a>, <a href="http://docbook.org/tdg/en/html/fax.html"><code class="sgmltag-element">fax</code></a>, <a href="http://docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a>, <a href="http://docbook.org/tdg/en/html/firstname.html"><code class="sgmltag-element">firstname</code></a>, <a href="http://docbook.org/tdg/en/html/firstterm.html"><code class="sgmltag-element">firstterm</code></a>, <a href="http://docbook.org/tdg/en/html/foreignphrase.html"><code class="sgmltag-element">foreignphrase</code></a>, <a href="http://docbook.org/tdg/en/html/function.html"><code class="sgmltag-element">function</code></a>, <a href="http://docbook.org/tdg/en/html/glossterm.html"><code class="sgmltag-element">glossterm</code></a>, <a href="http://docbook.org/tdg/en/html/guibutton.html"><code class="sgmltag-element">guibutton</code></a>, <a href="http://docbook.org/tdg/en/html/guiicon.html"><code class="sgmltag-element">guiicon</code></a>, <a href="http://docbook.org/tdg/en/html/guilabel.html"><code class="sgmltag-element">guilabel</code></a>, <a href="http://docbook.org/tdg/en/html/guimenu.html"><code class="sgmltag-element">guimenu</code></a>, <a href="http://docbook.org/tdg/en/html/guimenuitem.html"><code class="sgmltag-element">guimenuitem</code></a>, <a href="http://docbook.org/tdg/en/html/guisubmenu.html"><code class="sgmltag-element">guisubmenu</code></a>, <a href="http://docbook.org/tdg/en/html/hardware.html"><code class="sgmltag-element">hardware</code></a>, <a href="http://docbook.org/tdg/en/html/honorific.html"><code class="sgmltag-element">honorific</code></a>, <code class="sgmltag-element">interface</code>, <a href="http://docbook.org/tdg/en/html/interfacename.html"><code class="sgmltag-element">interfacename</code></a>, <a href="http://docbook.org/tdg/en/html/keycap.html"><code class="sgmltag-element">keycap</code></a>, <a href="http://docbook.org/tdg/en/html/keycode.html"><code class="sgmltag-element">keycode</code></a>, <a href="http://docbook.org/tdg/en/html/keysym.html"><code class="sgmltag-element">keysym</code></a>, <a href="http://docbook.org/tdg/en/html/lineage.html"><code class="sgmltag-element">lineage</code></a>, <a href="http://docbook.org/tdg/en/html/lineannotation.html"><code class="sgmltag-element">lineannotation</code></a>, <a href="http://docbook.org/tdg/en/html/literal.html"><code class="sgmltag-element">literal</code></a>, <a href="http://docbook.org/tdg/en/html/markup.html"><code class="sgmltag-element">markup</code></a>, <code class="sgmltag-element">medialabel</code>, <a href="http://docbook.org/tdg/en/html/methodname.html"><code class="sgmltag-element">methodname</code></a>, <a href="http://docbook.org/tdg/en/html/mousebutton.html"><code class="sgmltag-element">mousebutton</code></a>, <a href="http://docbook.org/tdg/en/html/option.html"><code class="sgmltag-element">option</code></a>, <a href="http://docbook.org/tdg/en/html/optional.html"><code class="sgmltag-element">optional</code></a>, <a href="http://docbook.org/tdg/en/html/otheraddr.html"><code class="sgmltag-element">otheraddr</code></a>, <a href="http://docbook.org/tdg/en/html/othername.html"><code class="sgmltag-element">othername</code></a>, <a href="http://docbook.org/tdg/en/html/package.html"><code class="sgmltag-element">package</code></a>, <a href="http://docbook.org/tdg/en/html/parameter.html"><code class="sgmltag-element">parameter</code></a>, <a href="http://docbook.org/tdg/en/html/personname.html"><code class="sgmltag-element">personname</code></a>, <a href="http://docbook.org/tdg/en/html/phone.html"><code class="sgmltag-element">phone</code></a>, <a href="http://docbook.org/tdg/en/html/pob.html"><code class="sgmltag-element">pob</code></a>, <a href="http://docbook.org/tdg/en/html/postcode.html"><code class="sgmltag-element">postcode</code></a>, <a href="http://docbook.org/tdg/en/html/productname.html"><code class="sgmltag-element">productname</code></a>, <a href="http://docbook.org/tdg/en/html/productnumber.html"><code class="sgmltag-element">productnumber</code></a>, <a href="http://docbook.org/tdg/en/html/prompt.html"><code class="sgmltag-element">prompt</code></a>, <a href="http://docbook.org/tdg/en/html/property.html"><code class="sgmltag-element">property</code></a>, <a href="http://docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a>, <a href="http://docbook.org/tdg/en/html/refentrytitle.html"><code class="sgmltag-element">refentrytitle</code></a>, <a href="http://docbook.org/tdg/en/html/remark.html"><code class="sgmltag-element">remark</code></a>, <a href="http://docbook.org/tdg/en/html/replaceable.html"><code class="sgmltag-element">replaceable</code></a>, <a href="http://docbook.org/tdg/en/html/returnvalue.html"><code class="sgmltag-element">returnvalue</code></a>, <a href="http://docbook.org/tdg/en/html/tag.html"><code class="sgmltag-element">tag</code></a>, <a href="http://docbook.org/tdg/en/html/shortcut.html"><code class="sgmltag-element">shortcut</code></a>, <a href="http://docbook.org/tdg/en/html/state.html"><code class="sgmltag-element">state</code></a>, <a href="http://docbook.org/tdg/en/html/street.html"><code class="sgmltag-element">street</code></a>, <code class="sgmltag-element">structfield</code>, <code class="sgmltag-element">structname</code>, <a href="http://docbook.org/tdg/en/html/subscript.html"><code class="sgmltag-element">subscript</code></a>, <a href="http://docbook.org/tdg/en/html/superscript.html"><code class="sgmltag-element">superscript</code></a>, <a href="http://docbook.org/tdg/en/html/surname.html"><code class="sgmltag-element">surname</code></a>, <a href="http://docbook.org/tdg/en/html/symbol.html"><code class="sgmltag-element">symbol</code></a>, <a href="http://docbook.org/tdg/en/html/systemitem.html"><code class="sgmltag-element">systemitem</code></a>, <a href="http://docbook.org/tdg/en/html/tag.html"><code class="sgmltag-element">tag</code></a>, <a href="http://docbook.org/tdg/en/html/termdef.html"><code class="sgmltag-element">termdef</code></a>, <a href="http://docbook.org/tdg/en/html/token.html"><code class="sgmltag-element">token</code></a>, <a href="http://docbook.org/tdg/en/html/trademark.html"><code class="sgmltag-element">trademark</code></a>, <a href="http://docbook.org/tdg/en/html/type.html"><code class="sgmltag-element">type</code></a>, <a href="http://docbook.org/tdg/en/html/uri.html"><code class="sgmltag-element">uri</code></a>, <a href="http://docbook.org/tdg/en/html/userinput.html"><code class="sgmltag-element">userinput</code></a>, <a href="http://docbook.org/tdg/en/html/varname.html"><code class="sgmltag-element">varname</code></a>, and <a href="http://docbook.org/tdg/en/html/wordasword.html"><code class="sgmltag-element">wordasword</code></a></span> 2191 </p> 2192 </li><li> 2193 <p>Added support for chunking <a href="http://docbook.org/tdg/en/html/revhistory.html"><code class="sgmltag-element">revhistory</code></a> into 2194 separate file (similar to the support for doing same with 2195 <a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a>). Patch from Thomas 2196 Schraitle. Controlled through <em class="parameter"><code>new 2197 generate.revhistory.link</code></em> parameter.</p> 2198 </li><li> 2199 <p>l10n.xsl: Made language codes RFC compliant. Added a 2200 new boolean config parameter, 2201 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/l10n.lang.value.rfc.compliant.html"><em class="parameter"><code>l10n.lang.value.rfc.compliant</code></em></a>. If it 2202 is non-zero (the default), any underscore in a language code 2203 will be converted to a hyphen in HTML output. If it is zero, 2204 the language code will be left as-is.</p> 2205 </li></ul></div> 2206 </div> 2207 <div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_MAN"></a>man</h3></div></div></div> 2208 2209 <p>This release closes out 44 manpages stylesheet bug reports 2210 and feature requests. It adds more than 35 new configuration 2211 parameters for controlling aspects of man-page output -- 2212 including hyphenation and justification, handling of links, 2213 conversion of Unicode characters, and contents of man-page 2214 headers and footers.</p> 2215 <div class="itemizedlist"><ul type="disc"><li> 2216 <p>New options for globally disabling/enabling 2217 hyphenation and justification: 2218 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.justify.html"><em class="parameter"><code>man.justify</code></em></a> and 2219 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.hyphenate.html"><em class="parameter"><code>man.hyphenate</code></em></a>.</p> 2220 <p>Note that the default 2221 for the both of those is zero (off), because justified text 2222 looks good only when it is also hyphenated; to quote the 2223 “<span class="quote">Hyphenation</span>” node from the groff info page: 2224 </p><div class="blockquote"><blockquote class="blockquote"> 2225 <p><span class="emphasis"><em>Since the odds are not great for finding a 2226 set of words, for every output line, which fit nicely on a 2227 line without inserting excessive amounts of space between 2228 words, `gtroff' hyphenates words so that it can justify 2229 lines without inserting too much space between 2230 words.</em></span></p> 2231 </blockquote></div><p> 2232 The problem is that groff can end up hyphenating a lot of 2233 things that you don't want hyphenated (variable names and 2234 command names, for example). Keeping both justification and 2235 hyphenation disabled ensures that hyphens won't get inserted 2236 where you don't want to them, and you don't end up with 2237 lines containing excessive amounts of space between 2238 words. These default settings run counter to how most 2239 existing man pages are formatted. But there are some notable 2240 exceptions, such as the perl man pages.</p> 2241 </li><li> 2242 <p> Added parameters for controlling hyphenation of 2243 computer inlines, filenames, and URLs. By default, even when 2244 hyphenation is enabled (globally), hyphenation is now 2245 suppressed for "computer inlines" (currently, just 2246 <a href="http://docbook.org/tdg/en/html/classname.html"><code class="sgmltag-element">classname</code></a>, <a href="http://docbook.org/tdg/en/html/constant.html"><code class="sgmltag-element">constant</code></a>, <a href="http://docbook.org/tdg/en/html/envar.html"><code class="sgmltag-element">envar</code></a>, 2247 <a href="http://docbook.org/tdg/en/html/errorcode.html"><code class="sgmltag-element">errorcode</code></a>, <a href="http://docbook.org/tdg/en/html/option.html"><code class="sgmltag-element">option</code></a>, 2248 <a href="http://docbook.org/tdg/en/html/replaceable.html"><code class="sgmltag-element">replaceable</code></a>, <a href="http://docbook.org/tdg/en/html/userinput.html"><code class="sgmltag-element">userinput</code></a>, 2249 <a href="http://docbook.org/tdg/en/html/type.html"><code class="sgmltag-element">type</code></a>, and <a href="http://docbook.org/tdg/en/html/varname.html"><code class="sgmltag-element">varname</code></a>, and for 2250 <code class="sgmltag-element">filenames</code>, and for URLs from <a href="http://docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>. It 2251 can be (re)enabled using the 2252 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.hyphenate.computer.inlines.html"><em class="parameter"><code>man.hyphenate.computer.inlines</code></em></a>, 2253 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.hyphenate.filenames.html"><em class="parameter"><code>man.hyphenate.filenames</code></em></a>, and 2254 <em class="parameter"><code>man.hyphenate.urls parameters</code></em>.</p> 2255 </li><li> 2256 <p>Implemented a new system for replacing Unicode 2257 characters. There are two parts to the new system: a 2258 “<span class="quote">string substitution map</span>” for doing 2259 “<span class="quote">essential</span>” replacements, and a 2260 “<span class="quote">character map</span>” that can optionally be disabled 2261 and enabled.</p> 2262 <p>The new system fixes all open bugs that had to do with 2263 literal Unicode numbered entities such as &#8220; and 2264 &#8221; showing up in output, and greatly expands the 2265 ability of the stylesheets to generate “<span class="quote">good</span>” roff 2266 equivalents for Unicode symbols and special 2267 characters.</p> 2268 <p>Here are some details...</p> 2269 <p>The previous manpages mechanism for replacing Unicode 2270 symbols and special characters with roff equivalents (the 2271 <code class="function">replace-entities</code> template) was not 2272 scalable and not complete. The mechanism handled a somewhat 2273 arbitrary selection of less than 20 or so Unicode 2274 characters. But there are potentially more than 2275 <span class="emphasis"><em>800</em></span> Unicode special characters that 2276 have some groff equivalent they can be mapped to. And there 2277 are about 34 symbols in the Latin-1 (ISO-8859-1) block 2278 alone. Users might reasonably expect that if they include 2279 any of those Latin-1 characters in their DocBook source 2280 documents, they will get correctly converted to known roff 2281 equivalents in output.</p> 2282 <p>In addition to those common symbols, certain users may 2283 have a need to use symbols from other Unicode blocks. Say, 2284 somebody who is documenting an application related to math 2285 might need to use a bunch of symbols from the 2286 “<span class="quote">Mathematical Operators</span>” Unicode block (there 2287 are about 65 characters in that block that have reasonable 2288 roff equivalents). Or somebody else might really like 2289 Dingbats -- such as the checkmark character -- and so might 2290 use a bunch of things from the “<span class="quote">Dingbat</span>” block 2291 (141 characters in that that have roff equivalents or that 2292 can at least be “<span class="quote">degraded</span>” somewhat gracefully 2293 into roff).</p> 2294 <p>So, the old <code class="function">replace-entities</code> 2295 mechanism was replaced with a completely different mechanism 2296 that is based on use of two “<span class="quote">maps</span>”: a 2297 “<span class="quote">substitution map</span>” and a “<span class="quote">character 2298 map</span>” (the latter in a format compliant with the XSLT 2299 2.0 spec and therefore completely “<span class="quote">forward 2300 compatible</span>” with XSLT 2.0).</p> 2301 <p>The substitution map is controlled through the 2302 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.string.subst.map.html"><em class="parameter"><code>man.string.subst.map</code></em></a> parameter, and 2303 is used to replace things like the backslash character 2304 (which needs special handling to prevent it from being 2305 interpreted as a roff escape). The substitution map cannot 2306 be disabled, because disabling it will cause the output to 2307 be broken. However, you can add to it and change it if 2308 needed.</p> 2309 2310 <p>The “<span class="quote">character map</span>” mechanism, on the 2311 other hand, can be completely disabled. It is enabled by 2312 default, and, by default, does replacement of all Latin-1 2313 symbols, along with most special spaces, dashes, and quotes 2314 (about 75 characters by default). Also, you can optionally 2315 enable a “<span class="quote">full</span>” character map that provides 2316 support for converting all 800 or so of the characters that 2317 have some reasonable groff equivalent.</p> 2318 2319 <p>The character-map mechanism is controlled through the 2320 following parameters: 2321 </p><div class="variablelist"><dl><dt><span class="term"><a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.enabled.html"><em class="parameter"><code>man.charmap.enabled</code></em></a></span></dt><dd><p>turns character-map support 2322 on/off</p></dd><dt><span class="term"><a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.use.subset.html"><em class="parameter"><code>man.charmap.use.subset</code></em></a></span></dt><dd><p>specifies that a subset of the character 2323 map is used instead of the full map</p></dd><dt><span class="term"><a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.subset.profile.html"><em class="parameter"><code>man.charmap.subset.profile</code></em></a></span></dt><dd><p>specifies profile of character-map 2324 subset</p></dd><dt><span class="term"><a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.uri.html"><em class="parameter"><code>man.charmap.uri</code></em></a></span></dt><dd><p>specifies an alternate character map to 2325 use instead of the “<span class="quote">standard</span>” character map 2326 provided in the distribution</p></dd></dl></div><p> 2327 </p> 2328 </li><li> 2329 <p>Implemented out-of-line handling of display of URLs 2330 for links (currently, only for <code class="sgmltag-element">ulink</code>). This gives 2331 you three choices for handling of links: 2332 </p><div class="orderedlist"><ol type="1"><li> 2333 <p>Number and list links. Each link is numbered 2334 inline, with a number in square brackets preceding the 2335 link contents, and a numbered list of all links is added 2336 to the end of the document.</p> 2337 </li><li> 2338 <p>Only list links. Links are not numbered, but an 2339 (unnumbered) list of links is added to the end of the 2340 document.</p> 2341 </li><li> 2342 <p>Suppress links. Don't number links and don't add 2343 any list of links to the end of the document.</p> 2344 </li></ol></div><p> 2345 You can also choose whether links should be underlined. The 2346 default is “<span class="quote">the works</span>” -- list, number, and 2347 underline links. You can use the 2348 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.links.list.enabled.html"><em class="parameter"><code>man.links.list.enabled</code></em></a>, <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.links.are.numbered.html"><em class="parameter"><code> 2349 man.links.are.numbered</code></em></a>, and 2350 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.links.are.underlined.html"><em class="parameter"><code>man.links.are.underlined</code></em></a> parameters 2351 to change the defaults. The default heading for the link 2352 list is REFERENCES. You can be change that using the 2353 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.links.list.heading.html"><em class="parameter"><code>man.links.list.heading</code></em></a> 2354 parameter.</p> 2355 </li><li> 2356 <p>Changed default output encoding to UTF-8. <span class="bold"><strong>This does not mean that man pages are output in 2357 raw UTF-8</strong></span>, because the character map is applied 2358 before final output, causing all UTF-8 characters covered in 2359 the map to be converted to roff equivalents.</p> 2360 </li><li> 2361 <p>Added support for processing <a href="http://docbook.org/tdg/en/html/refsect3.html"><code class="sgmltag-element">refsect3</code></a> and 2362 <a href="http://docbook.org/tdg/en/html/formalpara.html"><code class="sgmltag-element">formalpara</code></a> and nested <a href="http://docbook.org/tdg/en/html/refsection.html"><code class="sgmltag-element">refsection</code></a> 2363 elements, down to any arbitrary level of nesting.</p> 2364 </li><li> 2365 <p>Output of the <code class="literal">NAME</code> and 2366 <code class="literal">SYNOPSIS</code> and <code class="literal">AUTHOR</code> 2367 headings and the headings for admonitions (<a href="http://docbook.org/tdg/en/html/note.html"><code class="sgmltag-element">note</code></a>, 2368 <a href="http://docbook.org/tdg/en/html/caution.html"><code class="sgmltag-element">caution</code></a>, etc.) are no longer hard-coded for 2369 English. Instead, headings are generated for those in the 2370 correct locale (just as the FO and HTML stylesheets 2371 do).</p> 2372 </li><li> 2373 <p>Re-worked mechanism for assembling page 2374 headers/footers (the contents of the <code class="literal">.TH</code> 2375 macro “<span class="quote">title line</span>”).</p> 2376 2377 <p>Here are some details...</p> 2378 2379 <p>All man pages contain a <code class="literal">.TH</code> roff 2380 macro whose contents are used for rendering the “<span class="quote">title 2381 line</span>” displayed in the header and footer of each 2382 page. Here are a couple of examples of real-world man pages 2383 that have useful page headers/footers: </p><pre class="literallayout"> 2384 gtk-options(7) GTK+ User's Manual gtk-options(7) <-- header 2385 GTK+ 1.2 2003-10-20 gtk-options(7) <-- footer 2386 2387 svgalib(7) Svgalib User Manual svgalib(7) <-- header 2388 Svgalib 1.4.1 16 December 1999 svgalib(7) <-- footer</pre> 2389 2390 <p>And here are the terms with which the 2391 <code class="literal">groff_man(7)</code> man page refers to the 2392 various parts of the header/footer: </p><pre class="literallayout"> 2393 title(section) extra3 title(section) <- header 2394 extra2 extra1 title(section) <- footer</pre> 2395 <p> Or, using the names with which the <code class="literal">man(7)</code> 2396 man page refers to those same fields: </p><pre class="literallayout"> 2397 title(section) manual title(section) <- page header 2398 source date title(section) <- page footer</pre> 2399 2400 <p>The easiest way to control the contents of those 2401 fields is to mark up your <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> content like 2402 the following (note that this is a “<span class="quote">minimal</span>” 2403 example). </p><pre class="programlisting"> 2404 <refentry> 2405 <info> 2406 <date>2003-10-20</date> <a name="V1690_date-co" href="#V1690_date"><img src="images/callouts/1.png" alt="1" border="0"></a> 2407 </info> 2408 <refmeta> 2409 <refentrytitle>gtk-options</refentrytitle> <a name="V1690_title-co" href="#V1690_title"><img src="images/callouts/2.png" alt="2" border="0"></a> 2410 <manvolnum>7</manvolnum> <a name="V1690_manvolnum-co" href="#V1690_manvolnum"><img src="images/callouts/3.png" alt="3" border="0"></a> 2411 <refmiscinfo class="source-name">GTK+</refmiscinfo> <a name="V1690_source-name-co" href="#V1690_source-name"><img src="images/callouts/4.png" alt="4" border="0"></a> 2412 <refmiscinfo class="version">1.2</refmiscinfo> <a name="V1690_version-co" href="#V1690_version"><img src="images/callouts/5.png" alt="5" border="0"></a> 2413 <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> <a name="V1690_manual-co" href="#V1690_manual"><img src="images/callouts/6.png" alt="6" border="0"></a> 2414 </refmeta> 2415 <refnamediv> 2416 <refname>gtk-options</refname> 2417 <refpurpose>Standard Command Line Options for GTK+ Programs</refpurpose> 2418 </refnamediv> 2419 <refsect1> 2420 <title>Description</title> 2421 <para>This manual page describes the command line options, which 2422 are common to all GTK+ based applications.</para> 2423 </refsect1> 2424 </refentry></pre><p> 2425 </p><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><a name="V1690_date"></a><a href="#V1690_date-co"><img src="images/callouts/1.png" alt="1" border="0"></a> </td><td valign="top" align="left"> 2426 <p>Sets the “<span class="quote">date</span>” part of the header/footer.</p> 2427 </td></tr><tr><td width="5%" valign="top" align="left"><a name="V1690_title"></a><a href="#V1690_title-co"><img src="images/callouts/2.png" alt="2" border="0"></a> </td><td valign="top" align="left"> 2428 <p>Sets the “<span class="quote">title</span>” part.</p> 2429 </td></tr><tr><td width="5%" valign="top" align="left"><a name="V1690_manvolnum"></a><a href="#V1690_manvolnum-co"><img src="images/callouts/3.png" alt="3" border="0"></a> </td><td valign="top" align="left"> 2430 <p>Sets the “<span class="quote">section</span>” part.</p> 2431 </td></tr><tr><td width="5%" valign="top" align="left"><a name="V1690_source-name"></a><a href="#V1690_source-name-co"><img src="images/callouts/4.png" alt="4" border="0"></a> </td><td valign="top" align="left"> 2432 <p>Sets the “<span class="quote">source name</span>” part.</p> 2433 </td></tr><tr><td width="5%" valign="top" align="left"><a name="V1690_version"></a><a href="#V1690_version-co"><img src="images/callouts/5.png" alt="5" border="0"></a> </td><td valign="top" align="left"> 2434 <p>Sets the “<span class="quote">version</span>” part.</p> 2435 </td></tr><tr><td width="5%" valign="top" align="left"><a name="V1690_manual"></a><a href="#V1690_manual-co"><img src="images/callouts/6.png" alt="6" border="0"></a> </td><td valign="top" align="left"> 2436 <p>Sets the “<span class="quote">manual</span>” part.</p> 2437 </td></tr></table></div><p> 2438 </p> 2439 <p>Below are explanations of the steps the stylesheets 2440 take to attempt to assemble and display 2441 “<span class="quote">good</span>” headers and footer. [In the 2442 descriptions, note that <em class="replaceable"><code>*info</code></em> 2443 is the <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> “<span class="quote">info</span>” child 2444 (whatever its name), and 2445 <em class="replaceable"><code>parentinfo</code></em> is the 2446 “<span class="quote">info</span>” child of its parent (again, whatever 2447 its name).] 2448 </p><div class="variablelist"><dl><dt><span class="term">extra1 field (date)</span></dt><dd> 2449 <p>Content of the “<span class="quote">extra1</span>” field is 2450 what shows up in the <span class="bold"><strong>center 2451 footer</strong></span> position of each page. The 2452 <code class="literal">man(7)</code> man page describes it as 2453 “<span class="quote">the date of the last revision</span>”.</p> 2454 <p>To provide this content, if the 2455 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/refentry.date.profile.enabled.html"><em class="parameter"><code>refentry.date.profile.enabled</code></em></a> 2456 is non-zero, the stylesheets check the value of 2457 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/refentry.date.profile.html"><em class="parameter"><code>refentry.date.profile</code></em></a>.</p> 2458 <p>Otherwise, by default, they check for a 2459 <a href="http://docbook.org/tdg/en/html/date.html"><code class="sgmltag-element">date</code></a> or <a href="http://docbook.org/tdg/en/html/pubdate.html"><code class="sgmltag-element">pubdate</code></a> not only in the 2460 <em class="replaceable"><code>*info</code></em> contents, but also in 2461 the <em class="replaceable"><code>parentinfo</code></em> 2462 contents.</p> 2463 <p>If a date cannot be found, the stylesheets now 2464 automatically generate a localized “<span class="quote">long 2465 format</span>” date, ensuring that this field always 2466 has content in output.</p> 2467 <p>However, if for some reason you want to suppress 2468 this field, you can do so by setting a non-zero value 2469 for <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.th.extra1.suppress.html"><em class="parameter"><code>man.th.extra1.suppress</code></em></a>.</p> 2470 </dd><dt><span class="term">extra2 field (source)</span></dt><dd> 2471 <p>On Linux systems and on systems with a modern 2472 groff, the content of the “<span class="quote">extra2</span>” field 2473 are what shows up in the <span class="bold"><strong>left 2474 footer</strong></span> position of each page.</p> 2475 2476 <p>The <code class="literal">man(7)</code> man page describes 2477 this as “<span class="quote">the source of the command</span>”, and 2478 provides the following examples: 2479 </p><div class="itemizedlist"><ul type="circle"><li> 2480 <p>For binaries, use somwething like: GNU, 2481 NET-2, SLS Distribution, MCC Distribution.</p> 2482 </li><li> 2483 <p>For system calls, use the version of the 2484 kernel that you are currently looking at: Linux 2485 0.99.11.</p> 2486 </li><li> 2487 <p>For library calls, use the source of the 2488 function: GNU, BSD 4.3, Linux DLL 4.4.1.</p> 2489 </li></ul></div><p> 2490 </p> 2491 2492 <p>In practice, there are many pages that simply 2493 have a version number in the “<span class="quote">source</span>” 2494 field. So, it looks like what we have is a two-part 2495 field, 2496 <em class="replaceable"><code>Name</code></em> <em class="replaceable"><code>Version</code></em>, 2497 where: 2498 </p><div class="variablelist"><dl><dt><span class="term">Name</span></dt><dd> 2499 <p>product name (e.g., BSD) or org. name 2500 (e.g., GNU)</p> 2501 </dd><dt><span class="term">Version</span></dt><dd> 2502 <p>version name</p> 2503 </dd></dl></div><p> 2504 Each part is optional. If the 2505 <em class="replaceable"><code>Name</code></em> is a product name, 2506 then the <em class="replaceable"><code>Version</code></em> is 2507 probably the version of the product. Or there may be 2508 no <em class="replaceable"><code>Name</code></em>, in which case, if 2509 there is a <em class="replaceable"><code>Version</code></em>, it is 2510 probably the version of the item itself, not the 2511 product it is part of. Or, if the 2512 <em class="replaceable"><code>Name</code></em> is an organization 2513 name, then there probably will be no 2514 <em class="replaceable"><code>Version</code></em>. 2515 </p> 2516 <p>To provide this content, if the 2517 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/refentry.source.name.profile.enabled.html"><em class="parameter"><code>refentry.source.name.profile.enabled</code></em></a> 2518 and 2519 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/refentry.version.profile.enabled.html"><em class="parameter"><code>refentry.version.profile.enabled</code></em></a> 2520 parameter are non-zero, the stylesheets check the 2521 value of <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/refentry.source.name.profile.html"><em class="parameter"><code>refentry.source.name.profile</code></em></a> 2522 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/refentry.version.profile.html"><em class="parameter"><code>refentry.version.profile</code></em></a>.</p> 2523 2524 <p>Otherwise, by default, they check the following 2525 places, in the following order: 2526 </p><div class="orderedlist"><ol type="1"><li> 2527 <pre class="literallayout"><em class="replaceable"><code>*info</code></em>/<a href="http://docbook.org/tdg/en/html/productnumber.html"><code class="sgmltag-element">productnumber</code></a></pre> 2528 </li><li> 2529 <pre class="literallayout"><em class="replaceable"><code>*info</code></em>/<a href="http://docbook.org/tdg/en/html/productnumber.html"><code class="sgmltag-element">productnumber</code></a></pre> 2530 </li><li> 2531 <pre class="literallayout"><a href="http://docbook.org/tdg/en/html/refmeta.html"><code class="sgmltag-element">refmeta</code></a>/<a href="http://docbook.org/tdg/en/html/refmiscinfo.html"><code class="sgmltag-element">refmiscinfo</code></a>[@class = 'version']</pre> 2532 </li><li> 2533 <pre class="literallayout"><em class="replaceable"><code>parentinfo</code></em>/<a href="http://docbook.org/tdg/en/html/productnumber.html"><code class="sgmltag-element">productnumber</code></a></pre> 2534 </li><li> 2535 <pre class="literallayout"><em class="replaceable"><code>*info</code></em>/<a href="http://docbook.org/tdg/en/html/productname.html"><code class="sgmltag-element">productname</code></a></pre> 2536 </li><li> 2537 <pre class="literallayout"><em class="replaceable"><code>parentinfo</code></em>/<a href="http://docbook.org/tdg/en/html/productname.html"><code class="sgmltag-element">productname</code></a></pre> 2538 </li><li> 2539 <pre class="literallayout"><a href="http://docbook.org/tdg/en/html/refmeta.html"><code class="sgmltag-element">refmeta</code></a>/<a href="http://docbook.org/tdg/en/html/refmiscinfo.html"><code class="sgmltag-element">refmiscinfo</code></a></pre> 2540 </li><li> 2541 <p>[nothing found, so leave it empty]</p> 2542 </li></ol></div><p> 2543 </p> 2544 </dd><dt><span class="term">extra3 field</span></dt><dd> 2545 <p>On Linux systems and on systems with a modern 2546 groff, the content of the “<span class="quote">extra3</span>” field 2547 are what shows up in the <span class="bold"><strong>center 2548 header</strong></span> position of each page. Some man 2549 pages have “<span class="quote">extra2</span>” content, some 2550 don't. If a particular man page has it, it is most 2551 often “<span class="quote">context</span>” data about some larger 2552 system the documented item belongs to (for example, 2553 the name or description of a group of related 2554 applications). The stylesheets now check the following 2555 places, in the following order, to look for content to 2556 add to the “<span class="quote">extra3</span>” field.</p> 2557 <div class="orderedlist"><ol type="1"><li> 2558 <pre class="literallayout"><em class="replaceable"><code>parentinfo</code></em>/<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a></pre> 2559 </li><li> 2560 <pre class="literallayout">parent's <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a></pre> 2561 </li><li> 2562 <pre class="literallayout"><a href="http://docbook.org/tdg/en/html/refmeta.html"><code class="sgmltag-element">refmeta</code></a>/<a href="http://docbook.org/tdg/en/html/refmiscinfo.html"><code class="sgmltag-element">refmiscinfo</code></a></pre> 2563 </li><li> 2564 <p>[nothing found, so leave it empty]</p> 2565 </li></ol></div> 2566 </dd></dl></div><p> 2567 </p> 2568 </li><li> 2569 <p>Reworked <em class="replaceable"><code>*info</code></em> gathering. For 2570 each <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> found, the stylesheets now cache its 2571 <em class="replaceable"><code>*info</code></em> content, then check for any 2572 valid parent of it that might have metainfo content and cache 2573 that, if found; they then then do all further matches against 2574 those node-sets (rather than re-selecting the original 2575 <em class="replaceable"><code>*info</code></em> nodes each time they are 2576 needed).</p> 2577 </li><li> 2578 <p>New option for breaking strings after forward 2579 slashes. This enables long URLs and pathnames to be broken 2580 across lines. Controlled through 2581 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.break.after.slash.html"><em class="parameter"><code>man.break.after.slash</code></em></a> parameter.</p> 2582 </li><li> 2583 <p>Output for servicemark and trademark are now 2584 <code class="literal">(SM)</code> and <code class="literal">(TM)</code>. There is 2585 a groff <code class="literal">"\(tm"</code> escape, but output from that 2586 is not acceptable.</p> 2587 </li><li> 2588 <p>New option for controlling the length of the title 2589 part of the <code class="literal">.TH</code> title line. Controlled 2590 through the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.th.title.max.length.html"><em class="parameter"><code>man.th.title.max.length</code></em></a> 2591 parameter.</p> 2592 </li><li> 2593 <p>New option for specifying output encoding of each man 2594 page; controlled with 2595 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.output.encoding.html"><em class="parameter"><code>man.output.encoding</code></em></a> (similar to the 2596 HTML <em class="parameter"><code>chunker.output.encoding </code></em> 2597 parameter).</p> 2598 </li><li> 2599 <p>New option for suppressing filename messages when 2600 generating output; controlled with 2601 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.output.quietly.html"><em class="parameter"><code>man.output.quietly</code></em></a> (similar to the HTML 2602 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chunk.quietly.html"><em class="parameter"><code>chunk.quietly</code></em></a> parameter).</p> 2603 </li><li> 2604 <p>The text of cross-references to first-level 2605 <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> (<a href="http://docbook.org/tdg/en/html/refsect1.html"><code class="sgmltag-element">refsect1</code></a>, top-level 2606 <a href="http://docbook.org/tdg/en/html/refsection.html"><code class="sgmltag-element">refsection</code></a>, <a href="http://docbook.org/tdg/en/html/refnamediv.html"><code class="sgmltag-element">refnamediv</code></a>, and 2607 <a href="http://docbook.org/tdg/en/html/refsynopsisdiv.html"><code class="sgmltag-element">refsynopsisdiv</code></a>) are now capitalized.</p> 2608 </li><li> 2609 <p>Cross-references to <a href="http://docbook.org/tdg/en/html/refnamediv.html"><code class="sgmltag-element">refnamediv</code></a> now use the 2610 localized <code class="literal">NAME</code> title instead of using the 2611 first <a href="http://docbook.org/tdg/en/html/refname.html"><code class="sgmltag-element">refname</code></a> child. This makes the output 2612 inconsistent with HTML and FO output, but for man-page output, 2613 it seems to make better sense to have the 2614 <code class="literal">NAME</code>. (It may actually make better sense to 2615 do it that way in HTML and FO output as well...)</p> 2616 </li><li> 2617 <p>Added support for processing <a href="http://docbook.org/tdg/en/html/funcparams.html"><code class="sgmltag-element">funcparams</code></a>.</p> 2618 </li><li> 2619 <p>Removed the space that was being output between 2620 <a href="http://docbook.org/tdg/en/html/funcdef.html"><code class="sgmltag-element">funcdef</code></a> and <a href="http://docbook.org/tdg/en/html/paramdef.html"><code class="sgmltag-element">paramdef</code></a>; example: was: 2621 <code class="literal">float rand (void)</code>; now: 2622 <code class="literal">float rand(void)</code></p> 2623 </li><li> 2624 <p>Turned off bold formatting for the <a href="http://docbook.org/tdg/en/html/type.html"><code class="sgmltag-element">type</code></a> 2625 element when it occurs within a <a href="http://docbook.org/tdg/en/html/funcdef.html"><code class="sgmltag-element">funcdef</code></a> or 2626 <a href="http://docbook.org/tdg/en/html/paramdef.html"><code class="sgmltag-element">paramdef</code></a></p> 2627 </li><li> 2628 <p>Corrected rendering of <a href="http://docbook.org/tdg/en/html/simplelist.html"><code class="sgmltag-element">simplelist</code></a>. Any 2629 <code class="literal"><simplelist type="inline"</code> instance 2630 is now rendered as a comma-separated list (also with an 2631 optional localized “<span class="quote">and</span>” or “<span class="quote">or</span>” before the last item -- see 2632 description elsewhere in these release notes). Any simplelist 2633 instance whose <code class="sgmltag-attribute">type</code> is not 2634 <code class="literal">inline</code> is rendered as a one-column vertical 2635 list (ignoring the values of the <code class="sgmltag-attribute">type</code> and <code class="sgmltag-attribute">columns</code> attributes if present)</p> 2636 </li><li> 2637 <p>Comment added at top of roff source for each page now 2638 includes DocBook XSL stylesheets version number (as in the 2639 HTML stylesheets)</p> 2640 </li><li> 2641 <p>Made change to prevent “<span class="quote">sticky</span>” fonts 2642 changes. Now, when the manpages stylesheets encounter node 2643 sets that need to be boldfaced or italicized, they put the 2644 <code class="literal">\fBfoo\fR</code> and <code class="literal">\fIbar\fR</code> 2645 groff bold/italic instructions separately around each node in 2646 the set.</p> 2647 </li><li> 2648 <p>synop.xsl: Boldface everything in 2649 <a href="http://docbook.org/tdg/en/html/funcsynopsis.html"><code class="sgmltag-element">funcsynopsis</code></a> output except parameters (which are in 2650 ital). The <code class="literal">man(7)</code> man page says: 2651 </p><div class="blockquote"><blockquote class="blockquote"> 2652 <p>For functions, the arguments are always specified 2653 using italics, even in the SYNOPSIS section, where the rest 2654 of the function is specified in bold.</p> 2655 </blockquote></div><p> 2656 A look through the contents of the 2657 <code class="filename">man/man2</code> directory shows that most 2658 (all) existing pages do follow this “<span class="quote">everything in 2659 funcsynopsis bold</span>” rule. That means the 2660 <a href="http://docbook.org/tdg/en/html/type.html"><code class="sgmltag-element">type</code></a> content and any punctuation (parens, 2661 semicolons, <code class="sgmltag-element">vararg</code>s) also must be bolded.</p> 2662 </li><li> 2663 <p>Removed code for adding backslashes before periods/dots 2664 in roff source, because backslashes in front of periods/dots 2665 in roff source are needed only in the very rare case where a 2666 period is the very first character in a line, without any 2667 space in front of it. A better way to deal with that rare case 2668 is for you to add a zero-width space in front of the offending 2669 dot(s) in your source</p> 2670 </li><li> 2671 <p>Removed special handling of the <a href="http://docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a> 2672 element. That was hard-coded to cause anything marked up with 2673 the <a href="http://docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a> element to be output preceded by two 2674 backticks and followed by two apostrophes -- that is, that 2675 old-school kludge for generating “<span class="quote">curly</span>” quotes in Emacs and 2676 in X-Windows fonts. While Emacs still seems to support that, I 2677 don't think X-Windows has for a long time now. And, anyway, it 2678 looks (and has always looked) like crap when viewed on a 2679 normal tty/console. In addition, it breaks localiztion of 2680 <a href="http://docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a>. By default, <a href="http://docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a> content is 2681 output with localized quotation marks, which, depending on the 2682 locale, may or may not be left and right double quotation 2683 marks.</p> 2684 </li><li> 2685 <p>Changed mappings for left and right single quotation 2686 marks. Those had previously been incorrectly mapped to the 2687 backtick (&#96;) and apostrophe (&39;) characters (for 2688 kludgy reasons -- see above). They are now correctly mapped to 2689 the <code class="literal">\(oq</code> and <code class="literal">\(cq</code> roff 2690 escapes. If you want the old (broken) behavior, you need to 2691 manually change the mappings for those in the value of the 2692 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.string.subst.map.html"><em class="parameter"><code>man.string.subst.map</code></em></a> parameter.</p> 2693 </li><li> 2694 <p>Removed <code class="filename">xref.xsl</code> file. Now, of the 2695 various cross-reference elements, only the <code class="sgmltag-element">ulink</code> 2696 element is handled differently; the rest are handled exactly 2697 as the HTML stylesheets handle them, except that no hypertext 2698 links are generated. (Because there is no equivalent hypertext 2699 mechanism is man pages.)</p> 2700 </li><li> 2701 <p>New option for making “<span class="quote">subheading dividers</span>” in generated 2702 roff source. The dividers are not visible in the rendered man 2703 page; they are just there to make the source 2704 readable. Controlled using 2705 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.subheading.divider.html"><em class="parameter"><code>man.subheading.divider</code></em></a>.</p> 2706 </li><li> 2707 <p>Fixed many places where too much space was being added 2708 between lines.</p> 2709 </li></ul></div> 2710 2711 </div> 2712</div> 2713 2714 2715 <div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1681"></a>Release 1.68.1</h2></div></div></div> 2716 2717 <p>The release adds localization support for Farsi (thanks to 2718 Sina Heshmati) and improved support for the XLink-based DocBook NG 2719 <code class="sgmltag-element">db:link</code> element. Other than that, it is a minor 2720 bug-fix update to the 1.68.0 release. The main thing it fixes is a 2721 build error that caused the XSLT Java extensions to be jarred up 2722 with the wrong package structure. Thanks to Jens Stavnstrup for 2723 quickly reporting the problem, and to Mauritz Jeanson for 2724 investigating and finding the cause.</p> 2725 </div> 2726 2727 2728 <div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1680"></a>Release 1.68.0</h2></div></div></div> 2729 2730 <p>This release includes some features changes, particularly 2731 for FO/PDF output, and a number of bug fixes. 2732 </p><div class="itemizedlist"><a name="V1680_FO"></a><p class="title"><b>FO</b></p><ul type="disc"><li> 2733 <p>Moved footnote properties to attribute-sets.</p> 2734 </li><li> 2735 <p>Added support for side floats, margin notes, and 2736 custom floats.</p> 2737 </li><li> 2738 <p>Added new parameters 2739 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/body.start.indent.html"><em class="parameter"><code>body.start.indent</code></em></a> and 2740 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/body.end.indent.html"><em class="parameter"><code>body.end.indent</code></em></a> to the 2741 <em class="parameter"><code>set.flow.properties template</code></em>.</p> 2742 </li><li> 2743 <p>Added support for <code class="sgmltag-attribute">xml:id</code></p> 2744 </li><li> 2745 <p>Added support for 2746 <a href="http://docbook.org/tdg/en/html/refdescriptor.html"><code class="sgmltag-element">refdescriptor</code></a>.</p> 2747 </li><li> 2748 <p>Added support for multiple <a href="http://docbook.org/tdg/en/html/refnamediv.html"><code class="sgmltag-element">refnamediv</code></a>s.</p> 2749 </li><li> 2750 <p>Added <em class="parameter"><code>index.entry.properties</code></em> 2751 attribute-set to support customization of index 2752 entries.</p> 2753 </li><li> 2754 <p>Added <em class="parameter"><code>set.flow.properties 2755 template</code></em> call to each <code class="sgmltag-element">fo:flow</code> 2756 to support customizations entry point.</p> 2757 </li><li> 2758 <p>Add support for <code class="literal">@floatstyle</code> in 2759 <a href="http://docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a></p> 2760 </li><li> 2761 <p>Moved hardcoded properties for index division titles 2762 to the <em class="parameter"><code>index.div.title.properties</code></em> 2763 attribute-set.</p> 2764 </li><li> 2765 <p>Added support for 2766 <code class="sgmltag-element">table-layout</code>="<code class="sgmltag-attvalue">auto</code>" for XEP.</p> 2767 </li><li> 2768 <p>Added <em class="parameter"><code>index.div.title.properties</code></em> 2769 attribute-set.</p> 2770 </li><li> 2771 <p><em class="parameter"><code>$verbose</code></em> parameter is now 2772 passed to most elements.</p> 2773 </li><li> 2774 <p>Added <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> to 2775 <a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">toc</code></a> in <a href="http://docbook.org/tdg/en/html/part.html"><code class="sgmltag-element">part</code></a>, as it is 2776 permitted by the DocBook schema/DTD.</p> 2777 </li><li> 2778 <p>Added backmatter elements and 2779 <a href="http://docbook.org/tdg/en/html/article.html"><code class="sgmltag-element">article</code></a> to <a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">toc</code></a> in 2780 <a href="http://docbook.org/tdg/en/html/part.html"><code class="sgmltag-element">part</code></a>, since they are permitted by the 2781 DocBook schema/DTD.</p> 2782 </li><li> 2783 <p>Added <code class="sgmltag-attribute">mode</code>="<code class="sgmltag-attvalue">toc</code>" for 2784 <a href="http://docbook.org/tdg/en/html/simplesect.html"><code class="sgmltag-element">simplesect</code></a>, since it is now permitted in 2785 the <a href="http://docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">toc</code></a> if 2786 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/simplesect.in.toc.html"><em class="parameter"><code>simplesect.in.toc</code></em></a> is set.</p> 2787 </li><li> 2788 <p>Moved hard-coded properties to 2789 <em class="parameter"><code>nongraphical.admonintion.properties</code></em> 2790 and <em class="parameter"><code>graphical.admonition.properties</code></em> 2791 attribute sets.</p> 2792 </li><li> 2793 <p>Added support for <code class="literal">sidebar-width</code> and 2794 <code class="literal">float-type</code> processing instructions in 2795 <a href="http://docbook.org/tdg/en/html/sidebar.html"><code class="sgmltag-element">sidebar</code></a>.</p> 2796 </li><li> 2797 <p>For tables with HTML markup elements, added support 2798 for <code class="literal">dbfo bgcolor</code> PI, the attribute-sets 2799 named <em class="parameter"><code>table.properties</code></em>, 2800 <em class="parameter"><code>informaltable.properties</code></em>, 2801 <em class="parameter"><code>table.table.properties</code></em>, and 2802 <em class="parameter"><code>table.cell.padding</code></em>. Also added 2803 support for the templates named 2804 <em class="parameter"><code>table.cell.properties</code></em> and 2805 <em class="parameter"><code>table.cell.block.properties</code></em> so that 2806 tabstyles can be implemented. Also added support for tables 2807 containing only <a href="http://docbook.org/tdg/en/html/tr.html"><code class="sgmltag-element">tr</code></a> instead of 2808 <a href="http://docbook.org/tdg/en/html/tbody.html"><code class="sgmltag-element">tbody</code></a> with <a href="http://docbook.org/tdg/en/html/tr.html"><code class="sgmltag-element">tr</code></a>.</p> 2809 </li><li> 2810 <p>Added new paramater 2811 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/hyphenate.verbatim.characters.html"><em class="parameter"><code>hyphenate.verbatim.characters</code></em></a> which 2812 can specify characters after which a line break can occur in 2813 verbatim environments. This parameter can be used to extend 2814 the initial set of characters which contain only space and 2815 non-breakable space.</p> 2816 </li><li> 2817 <p>Added <em class="parameter"><code>itemizedlist.label.markup</code></em> to enable 2818 selection of different bullet symbol. Also added several 2819 potential bullet characters, commented out by default.</p> 2820 </li><li> 2821 <p>Enabled all id's in XEP output for external olinking.</p> 2822 </li></ul></div><p> 2823 2824 </p><div class="itemizedlist"><a name="V1680_HTML"></a><p class="title"><b>HTML</b></p><ul type="disc"><li> 2825 <p>Added support for 2826 <a href="http://docbook.org/tdg/en/html/refdescriptor.html"><code class="sgmltag-element">refdescriptor</code></a>.</p> 2827 </li><li> 2828 <p>Added support for multiple <a href="http://docbook.org/tdg/en/html/refnamediv.html"><code class="sgmltag-element">refnamediv</code></a>s.</p> 2829 </li><li> 2830 <p>Added support for <code class="sgmltag-attribute">xml:id</code></p> 2831 </li><li> 2832 <p><a href="http://docbook.org/tdg/en/html/refsynopsisdiv.html"><code class="sgmltag-element">refsynopsisdiv</code></a> as a section for 2833 counting section levels</p> 2834 </li></ul></div><p> 2835 </p><div class="itemizedlist"><a name="V1680_images"></a><p class="title"><b>Images</b></p><ul type="disc"><li> 2836 <p>Added new SVG admonition graphics and navigation images.</p> 2837 </li></ul></div><p> 2838 </p> 2839 </div> 2840 2841 2842 <div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1672"></a>Release 1.67.2</h2></div></div></div> 2843 2844 <p>This release fixes a table bug introduced in the 1.67.1 2845 release.</p> 2846 </div> 2847 <div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1671"></a>Release 1.67.1</h2></div></div></div> 2848 2849 <p>This release includes a number of bug fixes.</p> 2850 <p>The following lists provide details about API and feature changes. 2851 </p><div class="itemizedlist"><a name="V1671_FO"></a><p class="title"><b>FO</b></p><ul type="disc"><li> 2852 <p>Tables: Inherited cell properties are now passed to the 2853 <code class="literal">table.cell.properties</code> template so they can 2854 be overridden by a customization.</p> 2855 </li><li> 2856 <p>Tables: Added support for bgcolor PI on table row 2857 element.</p> 2858 </li><li> 2859 <p>TOCs: Added new parameter 2860 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/simplesect.in.toc.html"><em class="parameter"><code>simplesect.in.toc</code></em></a>; default value of 2861 <code class="literal">0</code> causes simplesect to be omitted from TOCs; to 2862 cause <a href="http://docbook.org/tdg/en/html/simplesect.html"><code class="sgmltag-element">simplesect</code></a> to be included in TOCs, you 2863 must set the value of <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/simplesect.in.toc.html"><em class="parameter"><code>simplesect.in.toc</code></em></a> to 2864 <code class="literal">1</code>.Comment from Norm: 2865 2866 </p><div class="blockquote"><blockquote class="blockquote"> 2867 <p><span class="emphasis"><em>Simplesect elements aren't supposed to 2868 appear in the ToC at all... The use case for simplesect 2869 is when, for example, every chapter in a book ends with 2870 "Exercises" or "For More Information" sections and you 2871 don't want those to appear in the ToC.</em></span></p> 2872 </blockquote></div><p> 2873 </p> 2874 </li><li> 2875 <p>Sections: Reverted change that caused a variable reference 2876 to be used in a template match and rewrote code to preserve 2877 intended semantics.</p> 2878 </li><li> 2879 <p>Lists: Added workaround to prevent "* 0.60 + 1em" garbage in 2880 list output from PassiveTeX</p> 2881 </li><li> 2882 <p>Moved the literal attributes from 2883 <em class="parameter"><code>component.title</code></em> to the 2884 <em class="parameter"><code>component.title.properties</code></em> attribute-set so 2885 they can be customized.</p> 2886 </li><li> 2887 <p>Lists: Added <a href="http://docbook.org/tdg/en/html/glossdef.html"><code class="sgmltag-element">glossdef</code></a>'s first 2888 <a href="http://docbook.org/tdg/en/html/para.html"><code class="sgmltag-element">para</code></a> to special handling in 2889 <code class="literal">fo:list-item-body</code>.</p> 2890 </li></ul></div><p> 2891 2892 </p><div class="itemizedlist"><a name="V1671_HTML"></a><p class="title"><b>HTML</b></p><ul type="disc"><li> 2893 <p>TOCs: Added new parameter 2894 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/simplesect.in.toc.html"><em class="parameter"><code>simplesect.in.toc</code></em></a>; for details, see 2895 the list of <a href="#V1671_FO" title="FO">FO</a> changes for this 2896 release.</p> 2897 </li><li> 2898 <p>Indexing: Added new parameter 2899 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/index.prefer.titleabbrev.html"><em class="parameter"><code>index.prefer.titleabbrev</code></em></a>; when set to 2900 <code class="literal">1</code>, index references will use 2901 <a href="http://docbook.org/tdg/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> instead of 2902 <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> when available.</p> 2903 </li></ul></div><p> 2904 </p><div class="itemizedlist"><a name="V1671_HELP"></a><p class="title"><b>HTML Help</b></p><ul type="disc"><li> 2905 <p>Added support for generating windows-1252-encoded 2906 output using Saxon; for more details, see the list of <a href="#V1671_EXT" title="XSL Java extensions">XSL Java extensions</a> changes for this release.</p> 2907 </li></ul></div><p> 2908 </p><div class="itemizedlist"><a name="V1671_MAN"></a><p class="title"><b>man pages</b></p><ul type="disc"><li> 2909 <p>Replaced named/numeric character-entity references for 2910 non-breaking space with groff equivalent (backslash-tilde).</p> 2911 </li></ul></div><p> 2912 </p><div class="itemizedlist"><a name="V1671_EXT"></a><p class="title"><b>XSL Java extensions</b></p><ul type="disc"><li> 2913 <p>Saxon extensions: Added the 2914 <code class="classname">Windows1252</code> class. It extends Saxon 2915 6.5.x with the windows-1252 character set, which is 2916 particularly useful when generating HTML Help for Western 2917 European Languages (code from 2918 <span class="firstname">Pontus</span> <span class="surname">Haglund</span> and contributed to the 2919 DocBook community by Sectra AB, Sweden).</p> 2920 <p>To use: 2921 </p><div class="orderedlist"><ol type="1"><li> 2922 <p>Make sure that the Saxon 6.5.x jar file and the jar file for 2923 the DocBook XSL Java extensions are in your <code class="envar">CLASSPATH</code></p> 2924 </li><li> 2925 <p>Create a DocBook XSL customization layer -- a file named 2926 <code class="filename">mystylesheet.xsl</code> or whatever -- that, at a 2927 minimum, contains the following: 2928 </p><pre class="screen"> <xsl:stylesheet 2929 xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 2930 version='1.0'> 2931 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/> 2932 <xsl:output method="html" encoding="WINDOWS-1252" indent="no"/> 2933 <xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"></xsl:param> 2934 <xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"></xsl:param> 2935 <xsl:param name="saxon.character.representation" select="'native'"></xsl:param> 2936 </xsl:stylesheet></pre><p> 2937 </p> 2938 <p>Invoke Saxon with the 2939 <code class="literal">encoding.windows-1252</code> Java system property set 2940 to <code class="literal">com.nwalsh.saxon.Windows1252</code>; for example 2941 </p><pre class="screen"> java \ 2942 -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \ 2943 com.icl.saxon.StyleSheet \ 2944 mydoc.xml mystylesheet.xsl</pre><p> 2945 2946 Or, for a more complete "real world" case showing other 2947 options you'll typically want to use: 2948 </p><pre class="screen"> java \ 2949 -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \ 2950 -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \ 2951 -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \ 2952 -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \ 2953 com.icl.saxon.StyleSheet \ 2954 -x org.apache.xml.resolver.tools.ResolvingXMLReader \ 2955 -y org.apache.xml.resolver.tools.ResolvingXMLReader \ 2956 -r org.apache.xml.resolver.tools.CatalogResolver \ 2957 mydoc.xml mystylesheet.xsl</pre><p> 2958 2959 In both cases, the "mystylesheet.xsl" file should be a 2960 DocBook customization layer containing the parameters 2961 show in step 2.</p> 2962 </li></ol></div><p> 2963 </p> 2964 </li><li> 2965 <p>Saxon extensions: Removed Saxon 8 extensions from release package</p> 2966 </li></ul></div><p> 2967 </p> 2968 </div> 2969<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1670"></a>Release 1.67.0</h2></div></div></div> 2970 2971 <div class="itemizedlist"><ul type="disc"><li> 2972 <p>A number of important bug fixes.</p> 2973 </li><li> 2974 <p>Added Saxon8 extensions</p> 2975 </li><li> 2976 <p>Enabled <code class="literal">dbfo table-width</code> on 2977 <a href="http://docbook.org/tdg/en/html/entrytbl.html"><code class="sgmltag-element">entrytbl</code></a> in FO output</p> 2978 </li><li> 2979 <p>Added support for <code class="literal">role=strong</code> on 2980 <a href="http://docbook.org/tdg/en/html/emphasis.html"><code class="sgmltag-element">emphasis</code></a> in FO output</p> 2981 </li><li> 2982 <p>Added new FO parameter 2983 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/hyphenate.verbatim.html"><em class="parameter"><code>hyphenate.verbatim</code></em></a> that can be used to turn 2984 on "intelligent" wrapping of verbatim environments.</p> 2985 </li><li> 2986 <p>Replaced all <code class="literal"><tt></tt></code> output with 2987 <code class="literal"><code></code></code></p> 2988 </li><li> 2989 <p>Changed <code class="literal">admon.graphic.width</code> template to a 2990 mode so that different admonitions can have different graphical 2991 widths.</p> 2992 </li><li> 2993 <p>Deprecated the HTML <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/shade.verbatim.html"><em class="parameter"><code>shade.verbatim</code></em></a> 2994 parameter (use CSS instead)</p> 2995 </li><li> 2996 <p>Wrapped ToC 2997 <a href="http://docbook.org/tdg/en/html/refentrytitle.html"><code class="sgmltag-element">refentrytitle</code></a>/<a href="http://docbook.org/tdg/en/html/refname.html"><code class="sgmltag-element">refname</code></a> and 2998 <a href="http://docbook.org/tdg/en/html/refpurpose.html"><code class="sgmltag-element">refpurpose</code></a> in span with class values. This 2999 makes it possible to style them using a CSS stylesheet.</p> 3000 </li><li> 3001 <p>Use <code class="literal">strong/em</code> instead of 3002 <code class="literal">b/i</code> in HTML output</p> 3003 </li><li> 3004 <p>Added support for converting <a href="http://docbook.org/tdg/en/html/emphasis.html"><code class="sgmltag-element">Emphasis</code></a> to 3005 groff italic and <a href="http://docbook.org/tdg/en/html/emphasis.html"><code class="sgmltag-element">Emphasis role='bold'</code></a> to 3006 bold. Controlled by 3007 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/emphasis.propagates.style.html"><em class="parameter"><code>emphasis.propagates.style</code></em></a> param, but not 3008 documented yet using litprog system. Will do that next (planning 3009 to add some other parameter-controllable options for hyphenation 3010 and handling of line spacing).</p> 3011 </li><li> 3012 <p><em class="parameter"><code>callout.graphics.number.limit.xml</code></em> 3013 param: Changed the default from <code class="literal">10</code> to 3014 <code class="literal">15</code>.</p> 3015 </li><li> 3016 <p><em class="parameter"><code>verbatim.properties</code></em>: Added 3017 <code class="literal">hyphenate=false</code></p> 3018 </li><li> 3019 <p>Saxon and Xalan Text.java extensions: Added support for 3020 <code class="methodname">URIResolver()</code> on insertfile href's</p> 3021 </li><li> 3022 <p>Added generated <code class="filename">RELEASE-NOTES.txt</code> 3023 file.</p> 3024 </li><li> 3025 <p>Added <code class="filename">INSTALL</code> file (executable file for 3026 generating catalog.xml)</p> 3027 </li><li> 3028 <p>Removed obsolete <code class="filename">tools</code> directory from 3029 package</p> 3030 </li></ul></div> 3031</div> 3032<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1661"></a>Release 1.66.1</h2></div></div></div> 3033 3034 <div class="itemizedlist"><ul type="disc"><li> 3035<p>A number of important bug fixes. 3036</p> 3037</li><li> 3038<p> 3039Now <code class="literal">xml:base</code> attributes that are generated by an 3040XInclude processor are resolved for image files. 3041</p> 3042</li><li> 3043<p> 3044Rewrote olink templates to support several new features. 3045</p> 3046<div class="itemizedlist"><ul type="circle"><li> 3047<p> 3048Extended full olink support to FO output. 3049</p> 3050</li><li> 3051<p> 3052Add support for <code class="literal">xrefstyle</code> attribute in olinks. 3053</p> 3054</li><li> 3055<p> 3056New parameters to support new olink features: 3057<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/insert.olink.page.number.html"><em class="parameter"><code>insert.olink.page.number</code></em></a>, <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/insert.olink.pdf.frag.html"><em class="parameter"><code>insert.olink.pdf.frag</code></em></a>, 3058<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/olink.debug.html"><em class="parameter"><code>olink.debug</code></em></a>, <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/olink.lang.fallback.sequence.html"><em class="parameter"><code>olink.lang.fallback.sequence</code></em></a>, <em class="parameter"><code>olink.properties</code></em>, 3059<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/prefer.internal.olink.html"><em class="parameter"><code>prefer.internal.olink</code></em></a>. 3060See the reference page for each parameter for more 3061information.</p> 3062</li></ul></div> 3063</li><li> 3064<p> 3065Added <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/index.on.type.html"><em class="parameter"><code>index.on.type</code></em></a> parameter for new <code class="sgmltag-attribute">type</code> 3066attribute introduced in DocBook 4.3 for indexterms and index. 3067This allows you to create multiple indices containing 3068different categories of entries. 3069For users of 4.2 and earlier, you can use the new parameter <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/index.on.role.html"><em class="parameter"><code>index.on.role</code></em></a> 3070instead. 3071</p> 3072</li><li> 3073<p> 3074Added new 3075<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/section.autolabel.max.depth.html"><em class="parameter"><code>section.autolabel.max.depth</code></em></a> parameter to turn off section numbering 3076below a certain depth. 3077This permits you to number major section levels and leave minor 3078section levels unnumbered.</p> 3079</li><li> 3080<p> 3081Added <em class="parameter"><code>footnote.sep.leader.properties</code></em> attribute set to format 3082the line separating footnotes in printed output. 3083</p> 3084</li><li> 3085<p> 3086Added parameter <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/img.src.path.html"><em class="parameter"><code>img.src.path</code></em></a> as a prefix to HTML img src 3087attributes. 3088The prefix is added to whatever path is already generated by the 3089stylesheet for each image file.</p> 3090</li><li> 3091<p> 3092Added new attribute-sets 3093<em class="parameter"><code>informalequation.properties</code></em>, 3094<em class="parameter"><code>informalexample.properties</code></em>, 3095<em class="parameter"><code>informalfigure.properties</code></em>, and <em class="parameter"><code>informaltable.properties</code></em>, 3096so each such element type can be formatted 3097individually if needed. 3098</p> 3099</li><li> 3100<p> 3101Add <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/component.label.includes.part.label.html"><em class="parameter"><code>component.label.includes.part.label</code></em></a> 3102parameter to add any part number to chapter, appendix 3103and other component labels when 3104the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/label.from.part.html"><em class="parameter"><code>label.from.part</code></em></a> parameter is nonzero. 3105This permits you to distinguish multiple chapters with the same 3106chapter number in cross references and the TOC.</p> 3107</li><li> 3108<p> 3109Added <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chunk.separate.lots.html"><em class="parameter"><code>chunk.separate.lots</code></em></a> parameter for HTML output. 3110This parameter lets you generate separate chunk files for each LOT 3111(list of tables, list of figures, etc.).</p> 3112</li><li> 3113<p>Added several table features:</p> 3114<div class="itemizedlist"><ul type="circle"><li> 3115<p> 3116Added <em class="parameter"><code>table.table.properties</code></em> attribute set to add 3117properties to the fo:table element. 3118</p> 3119</li><li> 3120<p> 3121Added placeholder templates named <code class="literal">table.cell.properties</code> 3122and <code class="literal">table.cell.block.properties</code> to enable adding properties 3123to any <code class="sgmltag-element">fo:table-cell</code> or the cell's <code class="sgmltag-element">fo:block</code>, respectively. 3124 These templates are a start for implementing table styles.</p> 3125</li></ul></div> 3126</li><li> 3127<p> 3128Added new attribute 3129set <em class="parameter"><code>component.title.properties</code></em> for easy modifications of 3130component's title formatting in FO output. 3131</p> 3132</li><li> 3133<p> 3134Added Saxon support for an <code class="sgmltag-attribute">encoding</code> attribute on the <a href="http://docbook.org/tdg/en/html/textdata.html"><code class="sgmltag-element">textdata</code></a> element. Added new parameter 3135<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/textdata.default.encoding.html"><em class="parameter"><code>textdata.default.encoding</code></em></a> which specifies encoding when 3136<code class="sgmltag-attribute">encoding</code> attribute on 3137<a href="http://docbook.org/tdg/en/html/textdata.html"><code class="sgmltag-element">textdata</code></a> is missing. 3138</p> 3139</li><li> 3140<p> 3141Template <code class="literal">label.this.section</code> now controls whole 3142section label, not only sub-label which corresponds to 3143particular label. Former behaviour was IMHO bug as it was 3144not usable. 3145</p> 3146</li><li> 3147<p> 3148Formatting in titleabbrev for TOC and headers 3149is 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. 3150</p> 3151</li><li> 3152<p> 3153Added <code class="literal">intial.page.number</code> template to set the <code class="literal">initial-page-number 3154property</code> for page sequences in print output. 3155Customizing this template lets you change when page numbering restarts. This is similar to the <code class="literal">format.page.number</code> template that lets you change how the page number formatting changes in the output. 3156</p> 3157</li><li> 3158<p> 3159Added <code class="literal">force.page.count</code> template to set the force-page-count 3160property for page sequences in print output. 3161This is similar to the <code class="literal">format.page.number</code> template. 3162</p> 3163</li><li> 3164<p> 3165Sort language for localized index sorting in <code class="filename">autoidx-ng.xsl</code> is now taken from document 3166lang, not from system environment. 3167</p> 3168</li><li> 3169<p> 3170Numbering and formatting of normal 3171and ulink footnotes (if turned on) has been unified. 3172Now ulink footnotes are mixed in with any other footnotes.</p> 3173</li><li> 3174<p> 3175Added support for <code class="sgmltag-element">renderas</code> attribute in section and 3176sect1 et al. 3177This permits you to render a given section title as if it were a different level.</p> 3178</li><li> 3179<p> 3180Added support for <a href="http://docbook.org/tdg/en/html/label.html"><code class="sgmltag-element">label</code></a> attribute in footnote to manually 3181supply the footnote mark. 3182</p> 3183</li><li> 3184<p> 3185Added support for DocBook 4.3 <code class="sgmltag-element">corpcredit</code> element. 3186</p> 3187</li><li> 3188<p> 3189Added support for a <code class="literal">dbfo keep-together</code> PI for 3190formal 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 3191is very long and the 3192default keep-together is not appropriate. 3193</p> 3194</li><li> 3195<p> 3196For graphics files, made file extension matching case 3197insensitive, and updated the list of graphics extensions. 3198</p> 3199</li><li> 3200<p> 3201Allow <a href="http://docbook.org/tdg/en/html/calloutlist.html"><code class="sgmltag-element">calloutlist</code></a> to have block content before 3202the first callout 3203</p> 3204</li><li> 3205<p> 3206Added <code class="literal">dbfo-need</code> processing instruction to provide 3207soft page breaks. 3208</p> 3209</li><li> 3210<p> 3211Added implementation of existing but unused 3212<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/default.image.width.html"><em class="parameter"><code>default.image.width</code></em></a> parameter for graphics. 3213</p> 3214</li><li> 3215<p> 3216Support DocBook NG <a href="http://docbook.org/tdg/en/html/tag.html"><code class="sgmltag-element">tag</code></a> inline element. 3217</p> 3218</li><li> 3219<p> 3220It appears that XEP now supports Unicode characters in 3221bookmarks. There is no further need to strip accents from 3222characters. 3223</p> 3224</li><li> 3225<p> 3226Make <a href="http://docbook.org/tdg/en/html/segmentedlist.html"><code class="sgmltag-element">segmentedlist</code></a> HTML markup 3227more semantic and available to CSS styles. 3228</p> 3229</li><li> 3230<p> 3231Added <code class="literal">user.preroot</code> placeholder template to 3232permit xsl-stylesheet and other PIs and comments to be 3233output before the HTML root element. 3234</p> 3235</li><li> 3236<p> 3237Non-chunked legalnotice now gets an <a 3238name="id"> element in HTML output 3239so it can be referenced with xref or link. 3240</p> 3241</li><li> 3242<p> 3243In chunked HTML output, changed <code class="literal">link rel="home"</code> to <code class="literal">rel="start"</code>, 3244and <code class="literal">link rel="previous"</code> to <code class="literal">rel="prev"</code>, per W3C HTML 4.01 3245spec. 3246</p> 3247</li><li> 3248<p> 3249Added several patches to htmlhelp from W. Borgert 3250</p> 3251</li><li> 3252<p> 3253Added Bosnian locale file as common/bs.xml. 3254</p> 3255</li></ul></div> 3256</div> 3257<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1650"></a>Release 1.65.0</h2></div></div></div> 3258 3259<div class="itemizedlist"><ul type="disc"><li> 3260<p>A number of important bug fixes. 3261</p> 3262</li><li> 3263<p>Added a workaround to allow these stylesheets to process DocBook NG 3264documents. (It’s a hack that pre-processes the document to strip off the 3265namespace and then uses <code class="function">exsl:node-set</code> to process 3266the result.) 3267</p> 3268</li><li> 3269<p>Added alternative indexing mechanism which has better 3270internationalization support. New indexing method allows grouping of 3271accented letters like e, é, ë into the same group under letter "e". It 3272can also treat special letters (e.g. "ch") as one character and place 3273them in the correct position (e.g. between "h" and "i" in Czech 3274language).</p> 3275<p>In order to use this mechanism you must create customization 3276layer which imports some base stylesheet (like 3277<code class="filename">fo/docbook.xsl</code>, 3278<code class="filename">html/chunk.xsl</code>) and then includes appropriate 3279stylesheet with new indexing code 3280(<code class="filename">fo/autoidx-ng.xsl</code> or 3281<code class="filename">html/autoidx-ng.xsl</code>). For example:</p> 3282<pre class="programlisting"><xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 3283 version="1.0"> 3284 3285<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/> 3286<xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/> 3287 3288</xsl:stylesheet></pre> 3289<p>New method is known to work with Saxon and it should also work 3290with xsltproc 1.1.1 and later. Currently supported languages are 3291English, Czech, German, French, Spanish and Danish.</p> 3292</li></ul></div> 3293</div> 3294<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1641"></a>Release 1.64.1</h2></div></div></div> 3295 3296<div class="itemizedlist"><p>General bug fixes and improvements. Sorry about the failure to produce 3297an updated release notes file for 1.62.0—1.63.2</p><ul type="disc"><li> 3298<p>In the course of fixing bug #849787, wrapping Unicode callouts 3299with an appropriate font change in the Xalan extensions, I discovered 3300that the Xalan APIs have changed a bit. So <code class="filename">xalan2.jar</code> 3301will work with older Xalan 2 implementations, <code class="filename">xalan25.jar</code> 3302works with Xalan 2.5.</p> 3303</li></ul></div> 3304</div> 3305<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1610"></a>Release 1.61.0</h2></div></div></div> 3306 3307<div class="itemizedlist"><p>Lots of bug fixes and improvements.</p><ul type="disc"><li> 3308<p>Initial support for timestamp PI. From now you 3309 can use <?dbtimestamp format="Y-m-d H:M:S"?> to get current 3310 datetime in your document. Added localization support for datetime PI 3311</p> 3312</li><li> 3313<p>Added level 6 to test for <a href="http://docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> depth in 3314section.level template so that 3315section.title.level6.properties will be used for sections 3316that are 6 deep or deeper. This should also cause a h6 to be 3317created in html output. 3318</p> 3319</li><li> 3320<p>Don't use SVG graphics if <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/use.svg.html"><em class="parameter"><code>use.svg</code></em></a>=0 3321</p> 3322</li><li> 3323<p>Now uses number-and-title-template for sections 3324 only if <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/section.autolabel.html"><em class="parameter"><code>section.autolabel</code></em></a> is not zero. 3325</p> 3326</li><li> 3327<p>Added missing 'english-language-name' attribute to 3328the l10n element, and the missing 'style' attribute to the 3329template element so the current gentext documents will 3330validate. 3331</p> 3332</li><li> 3333<p>Corrected several references to parameter 3334 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/qanda.defaultlabel.html"><em class="parameter"><code>qanda.defaultlabel</code></em></a> that were missing the "$". 3335</p> 3336</li><li> 3337<p>Now accepts <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/admon.textlabel.html"><em class="parameter"><code>admon.textlabel</code></em></a> parameter to turn off 3338 Note, Warning, etc. label. 3339</p> 3340</li><li> 3341<p>FeatReq #684561: support more XEP metadata 3342</p> 3343</li><li> 3344<p>Added hyphenation support. Added support for <a href="http://docbook.org/tdg/en/html/coref.html"><code class="sgmltag-element">coref</code></a>. 3345Added <code class="sgmltag-element">beginpage</code> support. (does nothing; see TDG). 3346</p> 3347</li><li> 3348<p>Added support for 3349hyphenation-character, hyphenation-push-character-count, and 3350hyphenation-remain-character-count 3351</p> 3352</li><li> 3353<p>Added <em class="parameter"><code>root.properties</code></em>, 3354<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/ebnf.assignment.html"><em class="parameter"><code>ebnf.assignment</code></em></a>, 3355and <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/ebnf.statement.terminator.html"><em class="parameter"><code>ebnf.statement.terminator</code></em></a> 3356</p> 3357</li><li> 3358<p>Support bgcolor PI in table cells; make sure 3359rowsep and colsep don't have any effect on the last row or 3360column 3361</p> 3362</li><li> 3363<p>Handle <a href="http://docbook.org/tdg/en/html/othercredit.html"><code class="sgmltag-element">othercredit</code></a> on titlepage a little 3364better 3365</p> 3366</li><li> 3367<p>Applied fix from Jeff Beal that fixed the bug 3368that put secondary page numbers on primary entries. Same 3369with tertiary page numbers on secondary entries. 3370</p> 3371</li><li> 3372<p>Added definition of missing variable 3373<em class="parameter"><code>collection</code></em>. 3374</p> 3375</li><li> 3376<p>Make <a href="http://docbook.org/tdg/en/html/footnote.html"><code class="sgmltag-element">footnote</code></a> formatting 'normal' even when it 3377occurs in a context that has special formatting 3378</p> 3379</li><li> 3380<p>Added warning when <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/glossary.collection.html"><em class="parameter"><code>glossary.collection</code></em></a> is not 3381blank, but it cannot open the specified file. 3382</p> 3383</li><li> 3384<p>Pick up the frame attribute on <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> and 3385<a href="http://docbook.org/tdg/en/html/informaltable.html"><code class="sgmltag-element">informaltable</code></a>. 3386</p> 3387</li><li> 3388<p><a href="http://docbook.org/tdg/en/html/indexdiv.html"><code class="sgmltag-element">indexdiv</code></a>/<a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> 3389in non-autogenerated indexes are 3390now picked up. 3391</p> 3392</li><li> 3393<p>Removed (unused) 3394component.title.properties 3395</p> 3396</li><li> 3397<p>Move IDs from 3398page-sequences down to titlepage blocks 3399</p> 3400</li><li> 3401<p>Use 3402proportional-column-width(1) on more <a href="http://docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>s. 3403</p> 3404<p>Use proportional-column-width() for 3405header/footer tables; suppress relative-align when when 3406using FOP 3407</p> 3408</li><li> 3409<p>Check for <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/glossterm.auto.link.html"><em class="parameter"><code>glossterm.auto.link</code></em></a> when linking 3410firstterms; don't output gl. prefix on glossterm links 3411</p> 3412</li><li> 3413<p>Generate Part ToCs 3414</p> 3415</li><li> 3416<p>Support <a href="http://docbook.org/tdg/en/html/glossary.html"><code class="sgmltag-element">glossary</code></a>, <a href="http://docbook.org/tdg/en/html/bibliography.html"><code class="sgmltag-element">bibliography</code></a>, 3417and <a href="http://docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a> in component ToCs. 3418</p> 3419</li><li> 3420<p>Refactored chunking code so that 3421customization of chunk algorithm and chunk elements is more 3422practical 3423</p> 3424</li><li> 3425<p>Support <a href="http://docbook.org/tdg/en/html/textobject.html"><code class="sgmltag-element">textobject</code></a>/<a href="http://docbook.org/tdg/en/html/phrase.html"><code class="sgmltag-element">phrase</code></a> 3426on <a href="http://docbook.org/tdg/en/html/inlinemediaobject.html"><code class="sgmltag-element">inlinemediaobject</code></a>. 3427</p> 3428</li><li> 3429<p>Support 'start' PI on ordered lists 3430</p> 3431</li><li> 3432<p>Fixed test of $toc PI to turn on qandaset TOC. 3433</p> 3434</li><li> 3435<p>Added process.chunk.footnotes to sect2 through 34365 to fix bug of missing footnotes when chunk level greater 3437than 1. 3438</p> 3439</li><li> 3440<p>Added 3441paramater <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/toc.max.depth.html"><em class="parameter"><code>toc.max.depth</code></em></a> which controls maximal depth of ToC 3442as requested by PHP-DOC group. 3443</p> 3444</li><li> 3445<p>Exempted <a href="http://docbook.org/tdg/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> from preamble processing in 3446lists, and fixed variablelist preamble code to use the same 3447syntax as the other lists. 3448</p> 3449</li><li> 3450<p>Added support for elements between variablelist 3451and first varlistentry since DocBook 4.2 supports that now. 3452</p> 3453</li></ul></div> 3454</div> 3455<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1601"></a>Release 1.60.1</h2></div></div></div> 3456 3457<div class="itemizedlist"><p>Lots of bug fixes.</p><ul type="disc"><li> 3458<p>The format of the <code class="filename">titlepage.templates.xml</code> files and 3459the stylesheet that transforms them have been significantly changed. All of the 3460attributes used to control the templates are now namespace qualified. So what 3461used to be:</p> 3462<pre class="programlisting"><t:titlepage element="article" wrapper="fo:block"></pre> 3463<p>is now:</p> 3464<pre class="programlisting"><t:titlepage t:element="article" t:wrapper="fo:block"></pre> 3465<p>Attributes from other namespaces (including those that are unqualified) are 3466now copied directly through. In practice, this means that the names that used 3467to be “<span class="quote">fo:</span>” qualified:</p> 3468<pre class="programlisting"><title named-template="component.title" 3469 param:node="ancestor-or-self::article[1]" 3470 fo:text-align="center" 3471 fo:keep-with-next="always" 3472 fo:font-size="&hsize5;" 3473 fo:font-weight="bold" 3474 fo:font-family="{$title.font.family}"/></pre> 3475<p>are now unqualified:</p> 3476<pre class="programlisting"><title t:named-template="component.title" 3477 param:node="ancestor-or-self::article[1]" 3478 text-align="center" 3479 keep-with-next="always" 3480 font-size="&hsize5;" 3481 font-weight="bold" 3482 font-family="{$title.font.family}"/></pre> 3483<p>The <code class="sgmltag-element">t:titlepage</code> and <code class="sgmltag-element">t:titlepage-content</code> 3484elements both generate wrappers now. And unqualified attributes on those elements 3485are passed through. This means that you can now make the title font apply to 3486ane entire titlepage and make the entire “<span class="quote">recto</span>” 3487titlepage centered by specifying the font and alignment on the those elements:</p> 3488<pre class="programlisting"><t:titlepage t:element="article" t:wrapper="fo:block" 3489 font-family="{$title.font.family}"> 3490 3491 <t:titlepage-content t:side="recto" 3492 text-align="center"></pre> 3493 3494 3495 3496 3497 3498</li><li> 3499<p>Support use of <a href="http://docbook.org/tdg/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> in running 3500headers and footers. 3501</p> 3502</li><li> 3503<p>Added (experimental) <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/xref.with.number.and.title.html"><em class="parameter"><code>xref.with.number.and.title</code></em></a> 3504parameter to enable number/title cross references even when the 3505default would 3506be just the number. 3507</p> 3508</li><li> 3509<p>Generate <a href="http://docbook.org/tdg/en/html/part.html"><code class="sgmltag-element">part</code></a> ToCs if they're requested. 3510</p> 3511</li><li> 3512<p>Use proportional-column-width() in header/footer tables. 3513</p> 3514</li><li> 3515<p>Handle alignment correctly when <a href="http://docbook.org/tdg/en/html/screenshot.html"><code class="sgmltag-element">screenshot</code></a> 3516wraps a graphic in a <a href="http://docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a>. 3517</p> 3518</li><li> 3519<p>Format <a href="http://docbook.org/tdg/en/html/chapter.html"><code class="sgmltag-element">chapter</code></a> and <a href="http://docbook.org/tdg/en/html/appendix.html"><code class="sgmltag-element">appendix</code></a> 3520cross references consistently. 3521</p> 3522</li><li> 3523<p>Attempt to support tables with multiple <a href="http://docbook.org/tdg/en/html/tgroup.html"><code class="sgmltag-element">tgroup</code></a>s 3524in FO. 3525</p> 3526</li><li> 3527<p>Output <code class="sgmltag-element">fo:table-columns</code> in 3528<a href="http://docbook.org/tdg/en/html/simplelist.html"><code class="sgmltag-element">simplelist</code></a> tables. 3529</p> 3530</li><li> 3531<p>Use <code class="filename">titlepage.templates.xml</code> for 3532<a href="http://docbook.org/tdg/en/html/indexdiv.html"><code class="sgmltag-element">indexdiv</code></a> and <a href="http://docbook.org/tdg/en/html/glossdiv.html"><code class="sgmltag-element">glossdiv</code></a> formatting. 3533</p> 3534</li><li> 3535<p>Improve support for new bibliography elements. 3536</p> 3537</li><li> 3538<p>Added 3539<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/footnote.number.format.html"><em class="parameter"><code>footnote.number.format</code></em></a>, 3540<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.footnote.number.format.html"><em class="parameter"><code>table.footnote.number.format</code></em></a>, 3541<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/footnote.number.symbols.html"><em class="parameter"><code>footnote.number.symbols</code></em></a>, and 3542<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.footnote.number.symbols.html"><em class="parameter"><code>table.footnote.number.symbols</code></em></a> for better control of 3543footnote markers. 3544</p> 3545</li><li> 3546<p>Added <code class="sgmltag-element">glossentry.show.acronyms</code>. 3547</p> 3548</li><li> 3549<p>Suppress the draft-mode page masters when 3550<em class="parameter"><code>draft-mode</code></em> is “<span class="quote">no</span>”. 3551</p> 3552</li><li> 3553<p>Make blank pages verso not recto. D'Oh! 3554</p> 3555</li><li> 3556<p>Improved formatting of <code class="sgmltag-element">ulink</code> footnotes. 3557</p> 3558</li><li> 3559<p>Fixed bugs in graphic width/height calculations. 3560</p> 3561</li><li> 3562<p>Added class attributes to inline elements. 3563</p> 3564</li><li> 3565<p>Don't add “<span class="quote">.html</span>” to the filenames identified 3566with the “<span class="quote">dbhtml</span>” PI. 3567</p> 3568</li><li> 3569<p>Don't force a ToC when sections contain <a href="http://docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>s. 3570</p> 3571</li><li> 3572<p>Make section title sizes a function of the 3573<em class="parameter"><code>body.master.size</code></em>. 3574</p> 3575</li></ul></div> 3576</div> 3577<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1592"></a>Release 1.59.2</h2></div></div></div> 3578 3579<div class="itemizedlist"><p>The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail. 3580</p><ul type="disc"><li> 3581<p>Removed the region-name from the region-body of blank pages. There's 3582no reason to give the body of blank pages a unique name and doing so causes 3583a mismatch that FOP detects. 3584</p> 3585</li><li> 3586<p>Output IDs for the first paragraphs in listitems. 3587</p> 3588</li><li> 3589<p>Fixed some small bugs in the handling of page numbers in double-sided mode. 3590</p> 3591</li><li> 3592<p>Attempt to prevent duplicated IDs from being produced when 3593<code class="sgmltag-attribute">endterm</code> on <a href="http://docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a> points 3594to something with nested structure. 3595</p> 3596</li><li> 3597<p>Fix aligment problems in <a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a>s. 3598</p> 3599</li><li> 3600<p>Output the type attribute on unordered lists (UL) in HTML only if 3601the css.decoration parameter is true. 3602</p> 3603</li><li> 3604<p>Calculate the font size in formal.title.properties so that it's 1.2 times 3605the base font size, not a fixed "12pt". 3606</p> 3607</li></ul></div> 3608</div> 3609<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1591"></a>Release 1.59.1</h2></div></div></div> 3610 3611<div class="itemizedlist"><p>The 1.59.1 fixes a few bugs. 3612</p><ul type="disc"><li> 3613<p>Added Bulgarian localization. 3614</p> 3615</li><li> 3616<p>Indexing improvements; localize book indexes to books but allow setindex 3617to index an entire set. 3618</p> 3619</li><li> 3620<p>The default value for rowsep and colsep is now "1" as per CALS. 3621</p> 3622</li><li> 3623<p>Added support for <a href="http://docbook.org/tdg/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> (use them for cross 3624references). 3625</p> 3626</li><li> 3627<p>Improvements to <a href="http://docbook.org/tdg/en/html/mediaobject.html"><code class="sgmltag-element">mediaobject</code></a> for selecting print vs. online 3628images. 3629</p> 3630</li><li> 3631<p>Added seperate property sets for <a href="http://docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a>s, 3632<a href="http://docbook.org/tdg/en/html/example.html"><code class="sgmltag-element">example</code></a>s, <a href="http://docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a>s, <code class="sgmltag-element">tables</code>s, 3633and <a href="http://docbook.org/tdg/en/html/procedure.html"><code class="sgmltag-element">procedure</code></a>s. 3634</p> 3635</li><li> 3636<p>Make <a href="http://docbook.org/tdg/en/html/lineannotation.html"><code class="sgmltag-element">lineannotation</code></a>s italic. 3637</p> 3638</li><li> 3639<p>Support <code class="sgmltag-attribute">xrefstyle</code> attribute. 3640</p> 3641</li><li> 3642<p>Make <code class="sgmltag-attribute">endterm</code> on 3643<a href="http://docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a> higher priority than 3644<code class="sgmltag-attribute">xreflabel</code> target. 3645</p> 3646</li><li> 3647<p>Glossary formatting improvements. 3648</p> 3649</li></ul></div> 3650</div> 3651<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1580"></a>Release 1.58.0</h2></div></div></div> 3652 3653<div class="itemizedlist"><p>The 1.58.0 adds some initial support for extensions in xsltproc, adds 3654a few features, and fixes bugs. 3655</p><ul type="disc"><li> 3656<p>This release contains the first attempt at extension support for xsltproc. 3657The only extension available to date is the one that adjusts table column widths. 3658Run <code class="filename">extensions/xsltproc/python/xslt.py</code>. 3659</p> 3660</li><li> 3661<p>Fixed bugs in calculation of adjusted column widths to correct for rounding 3662errors. 3663</p> 3664</li><li> 3665<p>Support nested <a href="http://docbook.org/tdg/en/html/refsection.html"><code class="sgmltag-element">refsection</code></a> elements correctly. 3666</p> 3667</li><li> 3668<p>Reworked <code class="literal">gentext.template</code> to take context into consideration. 3669The name of elements in localization files is now an xpath-like context list, not 3670just a simple name. 3671</p> 3672</li><li> 3673<p>Made some improvements to bibliography formatting. 3674</p> 3675</li><li> 3676<p>Improved graphical formatting of admonitions. 3677</p> 3678</li><li> 3679<p>Added support for <a href="http://docbook.org/tdg/en/html/entrytbl.html"><code class="sgmltag-element">entrytbl</code></a>. 3680</p> 3681</li><li> 3682<p>Support spanning index terms. 3683</p> 3684</li><li> 3685<p>Support <a href="http://docbook.org/tdg/en/html/bibliosource.html"><code class="sgmltag-element">bibliosource</code></a>. 3686</p> 3687</li></ul></div> 3688</div> 3689<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1570"></a>Release 1.57.0</h2></div></div></div> 3690 3691<div class="itemizedlist"><ul type="disc"><li> 3692<p>The 1.57.0 release wasn't documented here. Oops. 3693</p> 3694</li></ul></div> 3695</div> 3696<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="V1560"></a>Release 1.56.0</h2></div></div></div> 3697 3698<div class="itemizedlist"><p>The 1.56.0 release fixes bugs. 3699</p><ul type="disc"><li> 3700<p>Reworked chunking. <span class="emphasis"><em>This will break all existing customizations 3701layers that change the chunking algorithm.</em></span> If you're customizing chunking, 3702look at the new “<span class="quote">content</span>” parameter that's passed to 3703<code class="literal">process-chunk-element</code> and friends. 3704</p> 3705</li><li> 3706<p>Support continued and inherited numeration in <a href="http://docbook.org/tdg/en/html/orderedlist.html"><code class="sgmltag-element">orderedlist</code></a> 3707formatting for FOs. 3708</p> 3709</li><li> 3710<p>Added Thai localization. 3711</p> 3712</li><li> 3713<p>Tweaked stylesheet documentation stylesheets to link to TDG and 3714the parameter references. 3715</p> 3716</li><li> 3717<p>Allow title on tables of contents ("Table of Contents") to be optional. 3718Added new keyword to <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/generate.toc.html"><em class="parameter"><code>generate.toc</code></em></a>. 3719Support tables of contents on sections. 3720</p> 3721</li><li> 3722<p>Made separate parameters for table borders and table cell borders: 3723<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.frame.border.color.html"><em class="parameter"><code>table.frame.border.color</code></em></a>, 3724<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.frame.border.style.html"><em class="parameter"><code>table.frame.border.style</code></em></a>, 3725<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.frame.border.thickness.html"><em class="parameter"><code>table.frame.border.thickness</code></em></a>, 3726<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.cell.border.color.html"><em class="parameter"><code>table.cell.border.color</code></em></a>, 3727<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.cell.border.style.html"><em class="parameter"><code>table.cell.border.style</code></em></a>, and 3728<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.cell.border.thickness.html"><em class="parameter"><code>table.cell.border.thickness</code></em></a>. 3729</p> 3730</li><li> 3731<p>Suppress formatting of “<span class="quote">endofrange</span>” <a href="http://docbook.org/tdg/en/html/indexterm.html"><code class="sgmltag-element">indexterm</code></a>s. 3732This is only half-right. They should generate a range, but I haven't figured out how 3733to do that yet. 3734</p> 3735</li><li> 3736<p>Support <a href="http://docbook.org/tdg/en/html/revdescription.html"><code class="sgmltag-element">revdescription</code></a>. (Bug #582192) 3737</p> 3738</li><li> 3739<p>Added <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/default.float.class.html"><em class="parameter"><code>default.float.class</code></em></a> and fixed figure 3740floats. (Bug #497603) 3741</p> 3742</li><li> 3743<p>Fixed formatting of <a href="http://docbook.org/tdg/en/html/sbr.html"><code class="sgmltag-element">sbr</code></a> in FOs. 3744</p> 3745</li><li> 3746<p>Added context to the “<span class="quote">missing template</span>” error message. 3747</p> 3748</li><li> 3749<p>Process <a href="http://docbook.org/tdg/en/html/arg.html"><code class="sgmltag-element">arg</code></a> correctly in a <a href="http://docbook.org/tdg/en/html/group.html"><code class="sgmltag-element">group</code></a>. 3750(Bug #605150) 3751</p> 3752</li><li> 3753<p>Removed 'keep-with-next' from <em class="parameter"><code>formal.title.properties</code></em> 3754attribute set now that the stylesheets support the option of putting 3755such titles below the object. Now the $placement value determines if 3756'keep-with-next' or 'keep-with-previous' is used in the title block. 3757</p> 3758</li><li> 3759<p>Wrap “<span class="quote">url()</span>” around external-destinations when appropriate. 3760</p> 3761</li><li> 3762<p>Fixed typo in compact list spacing. (Bug #615464) 3763</p> 3764</li><li> 3765<p>Removed spurious hash in anchor name. (Bug #617717) 3766</p> 3767</li><li> 3768<p>Address is now displayed verbatim on title pages. (Bug #618600) 3769</p> 3770</li><li> 3771<p>The <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/bridgehead.in.toc.html"><em class="parameter"><code>bridgehead.in.toc</code></em></a> parameter is now properly 3772supported. 3773</p> 3774</li><li> 3775<p>Improved effectiveness of HTML cleanup by increasing the number 3776of places where it is used. Improve use of HTML cleanup in XHTML stylesheets. 3777</p> 3778</li><li> 3779<p>Support table of contents for <a href="http://docbook.org/tdg/en/html/appendix.html"><code class="sgmltag-element">appendix</code></a> in 3780<a href="http://docbook.org/tdg/en/html/article.html"><code class="sgmltag-element">article</code></a>. (Bug #596599) 3781</p> 3782</li><li> 3783<p>Don't duplicate footnotes in <a href="http://docbook.org/tdg/en/html/bibliography.html"><code class="sgmltag-element">bibliography</code></a>s and 3784<a href="http://docbook.org/tdg/en/html/glossary.html"><code class="sgmltag-element">glossary</code></a>s. (Bug #583282) 3785</p> 3786</li><li> 3787<p>Added <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/default.image.width.html"><em class="parameter"><code>default.image.width</code></em></a>. (Bug #516859) 3788</p> 3789</li><li> 3790<p>Totally reworked <a href="http://docbook.org/tdg/en/html/funcsynopsis.html"><code class="sgmltag-element">funcsynopsis</code></a> code; it now 3791supports a 'tabular' presentation style for 'wide' prototypes; see 3792<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/funcsynopsis.tabular.threshold.html"><em class="parameter"><code>funcsynopsis.tabular.threshold</code></em></a>. (HTML only 3793right now, I think, FO support, uh, real soon now.) 3794</p> 3795</li><li> 3796<p>Reworked support for difference marking; toned down the colors a bit 3797and added a “<span class="quote">system.head.content</span>” template so that the diff CSS 3798wasn't overriding “<span class="quote">user.head.content</span>”. (Bug #610660) 3799</p> 3800</li><li> 3801<p>Added call to the “<span class="quote">*.head.content</span>” elements when writing 3802out long description chunks. 3803</p> 3804</li><li> 3805<p>Make sure <a href="http://docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a> link is correct even when 3806chunking to a different <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/base.dir.html"><em class="parameter"><code>base.dir</code></em></a>. 3807</p> 3808</li><li> 3809<p>Use CSS to set viewport characteristics if 3810<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/css.decoration.html"><em class="parameter"><code>css.decoration</code></em></a> is non-zero, use div instead of p for making 3811graphic a block element; make figure <a href="http://docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a>s the 3812default alt 3813text for images in a <a href="http://docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a>.</p> 3814</li><li> 3815<p>Added space-after to <em class="parameter"><code>list.block.spacing</code></em>. 3816</p> 3817</li><li> 3818<p>Reworked section.level template to give “<span class="quote">correct</span>” answer 3819instead of being off by one. 3820</p> 3821</li><li> 3822<p>When processing tables, use the <code class="sgmltag-attribute">tabstyle</code> 3823attribute as the division class. 3824</p> 3825</li><li> 3826<p>Fixed bug in <code class="filename">html2xhtml.xsl</code> that was causing the 3827XHTML chunker to output HTML instead of XHTML. 3828</p> 3829</li></ul></div> 3830</div> 3831<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="VOlder"></a>Older releases</h2></div></div></div> 3832 3833 <p>To view the release notes for older releases, see <code class="uri"><a href="http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml">http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml</a></code>. Be 3834 aware that there were no release notes for releases prior to the 3835 1.50.0 release.</p> 3836</div> 3837<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="dot0"></a>About dot-zero releases</h2></div></div></div> 3838 3839 <p>DocBook Project “<span class="quote">dot zero</span>” releases should be 3840 considered <span class="emphasis"><em>experimental</em></span> and are always 3841 followed by stable “<span class="quote">dot one</span>” releases, usually within 3842 two or three weeks. Please help to ensure the stability of 3843 “<span class="quote">dot one</span>” releases by carefully testing each 3844 “<span class="quote">dot zero</span>” release and reporting back about any 3845 problems you find. </p> 3846 <p>It is not recommended that you use a “<span class="quote">dot zero</span>” 3847 release in a production system, or package it for an OS 3848 distro. Instead, you should wait for the “<span class="quote">dot one</span>” 3849 version.</p> 3850 </div> 3851</div></body></html>
