xslt/RELEASE-NOTES.html

   1 <html><head>
   2       <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
   3    <title>DocBook XSL Stylesheet Release Notes</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.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="d0e1"></a>DocBook XSL Stylesheet Release Notes</h1></div><div><h3 class="corpauthor">DocBook Project Development Team</h3></div><div><p class="releaseinfo">$Id$</p></div><div><p class="pubdate">2005-08-12</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#d0e22">Release 1.69.1</a></span></dt><dt><span class="section"><a href="#d0e40">Release 1.69.0</a></span></dt><dd><dl><dt><span class="section"><a href="#V1690_COMMON">Common</a></span></dt><dt><span class="section"><a href="#V1690_FO">FO</a></span></dt><dt><span class="section"><a href="#V1690_HELP">Help</a></span></dt><dt><span class="section"><a href="#V1690_HTML">HTML</a></span></dt><dt><span class="section"><a href="#V1690_MAN">man</a></span></dt></dl></dd><dt><span class="section"><a href="#d0e1625">Release 1.68.1</a></span></dt><dt><span class="section"><a href="#d0e1634">Release 1.68.0</a></span></dt><dt><span class="section"><a href="#d0e1872">Release 1.67.2</a></span></dt><dt><span class="section"><a href="#d0e1877">Release 1.67.1</a></span></dt><dt><span class="section"><a href="#d0e2044">Release 1.67.0</a></span></dt><dt><span class="section"><a href="#d0e2175">Release 1.66.1</a></span></dt><dt><span class="section"><a href="#d0e2462">Release 1.65.0</a></span></dt><dt><span class="section"><a href="#d0e2498">Release 1.64.1</a></span></dt><dt><span class="section"><a href="#d0e2513">Release 1.61.0</a></span></dt><dt><span class="section"><a href="#d0e2703">Release 1.60.1</a></span></dt><dt><span class="section"><a href="#d0e2880">Release 1.59.2</a></span></dt><dt><span class="section"><a href="#d0e2916">Release 1.59.1</a></span></dt><dt><span class="section"><a href="#d0e2988">Release 1.58.0</a></span></dt><dt><span class="section"><a href="#d0e3036">Release 1.57.0</a></span></dt><dt><span class="section"><a href="#d0e3043">Release 1.56.0</a></span></dt><dt><span class="section"><a href="#d0e3265">Older releases</a></span></dt><dt><span class="section"><a href="#dot0">About dot-zero releases</a></span></dt></dl></div><p>These are the release notes for the DocBook XSL Stylesheets.
   4   At a minimum, this file attempts to document changes to the public
   5   APIs, particularly to user-configurable parameters. This file also
   6   provides a high-level overview of the features added in each
   7   release.</p><p>Bug fixes are (mostly) not documented here. For a complete
   8   list of changes, including descriptions of bug fixes, see the <a href="NEWS" target="_top">NEWS</a> file, which is auto-generated from the checkin
   9   descriptions for changes in the project CVS repository.</p><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e22"></a>Release 1.69.1</h2></div></div></div><p>This release is a minor bug-fix update to the 1.69.0
  10     release. Along with bug fixes, it includes one
  11     configuration-parameter change: The default value of the
  12     <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
  13     <code class="literal">0</code> (off). The reason for that change is that
  14     there have been reports that <code class="sgmltag-element">annotation</code> handling is
  15     causing a significant performance degradation in processing of
  16     large documents with <span><strong class="command">xsltproc</strong></span>.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e40"></a>Release 1.69.0</h2></div></div></div><p>The release includes major feature changes,
  17     particularly in the <a href="#V1690_MAN" title="man">manpages
  18     stylesheets</a>, as well as a large number of bug fixes.</p><p>As with all DocBook Project &#8220;<span class="quote">dot zero</span>&#8221; releases, this is an
  19     <a href="#dot0" title="About dot-zero releases">experimental release </a>.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_COMMON"></a>Common</h3></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>This release adds localizations for the following
  20           languages:
  21             <span class="simplelist">Albanian, Amharic, Azerbaijani, Hindi, Irish (Gaelic), Gujarati, Kannada, Mongolian, Oriya, Punjabi, Tagalog, Tamil, and Welsh</span>.</p></li><li><p>Added support for specifying number format for auto
  22           labels for <a href="http://www.docbook.org/tdg/en/html/chapter.html"><code class="sgmltag-element">chapter</code></a>, <a href="http://www.docbook.org/tdg/en/html/appendix.html"><code class="sgmltag-element">appendix</code></a>,
  23           <a href="http://www.docbook.org/tdg/en/html/part.html"><code class="sgmltag-element">part</code></a>, and <a href="http://www.docbook.org/tdg/en/html/preface.html"><code class="sgmltag-element">preface</code></a>. Contolled with the
  24           <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/appendix.autolabel.html"><em class="parameter"><code>appendix.autolabel</code></em></a>,
  25           <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chapter.autolabel.html"><em class="parameter"><code>chapter.autolabel</code></em></a>,
  26           <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/part.autolabel.html"><em class="parameter"><code>part.autolabel</code></em></a>, and
  27           <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></li><li><p>Added basic support for <code class="sgmltag-element">biblioref</code> cross
  28           referencing.</p></li><li><p>Added support for <code class="sgmltag-attribute">align</code>
  29           on <a href="http://www.docbook.org/tdg/en/html/caption.html"><code class="sgmltag-element">caption</code></a> in <a href="http://www.docbook.org/tdg/en/html/mediaobject.html"><code class="sgmltag-element">mediaobject</code></a>.</p></li><li><p>Added support for processing documents that use the
  30           DocBook V5 namespace.</p></li><li><p>Added support for <code class="sgmltag-element">termdef</code> and
  31           <code class="sgmltag-element">mathphrase</code>.</p></li><li><p>EXPERIMENTAL: Incorporated the Slides and Website
  32           stylesheets into the DocBook XSL stylesheets package. So,
  33           for example, Website documents can now be processed using
  34           the following URI for the driver Website
  35           <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></li><li><p>A <a href="http://www.docbook.org/tdg/en/html/procedure.html"><code class="sgmltag-element">procedure</code></a> without a <a href="http://www.docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> is
  36           now treated as an &#8220;<span class="quote">informal</span>&#8221; procedure (meaning
  37           that it is not added to any generated &#8220;<span class="quote">list of
  38           procedures</span>&#8221; and has no affect on numbering of
  39           generated labels for other procedures).</p></li><li><p><code class="sgmltag-element">docname</code> is no longer added to
  40           <a href="http://www.docbook.org/tdg/en/html/olink.html"><code class="sgmltag-element">olink</code></a> when pointing to a root element.</p></li><li><p>Added support for generation of choice separator in
  41         inline simplelist. This enables auto-generation of an
  42         appropriate localized &#8220;<span class="quote">choice separator</span>&#8221; (for
  43         example, &#8220;<span class="quote">and</span>&#8221; or &#8220;<span class="quote">or</span>&#8221;) before the
  44         final item in an inline <a href="http://www.docbook.org/tdg/en/html/simplelist.html"><code class="sgmltag-element">simplelist</code></a>.</p><p>To indicate that you want a choice separator
  45         generated for a particular list, you need to put a processing
  46         instruction (PI) of the form
  47         <code class="sgmltag-xmlpi">&lt;?dbchoice&nbsp;choice="foo"?&gt;</code> as a
  48         child of the list. For example:
  49         </p><pre class="literallayout">  &lt;para&gt;Choose from
  50   ONE and ONLY ONE of the following:
  51   &lt;simplelist type="inline"&gt;
  52   &lt;?dbchoice choice="or" ?&gt;
  53   &lt;member&gt;A&lt;/member&gt;
  54   &lt;member&gt;B&lt;/member&gt;
  55   &lt;member&gt;C&lt;/member&gt;.&lt;/simplelist&gt;&lt;/para&gt;</pre><p>
  56
  57         Output (for English):
  58         </p><div class="blockquote"><blockquote class="blockquote"><p>Choose from ONE and only ONE of the
  59           following choices: A, B, or C.</p></blockquote></div><p>
  60         As a temporary workaround for the fact that most of the
  61         DocBook non-English locale files don't have a localization for
  62         the word &#8220;<span class="quote">or</span>&#8221;, you can put in a literal string to
  63         be used; example for French: <code class="sgmltag-pi">&lt;?dbchoice&nbsp;choice="ou"&gt;</code>.  That is, use
  64         &#8220;<span class="quote">ou</span>&#8221; instead of &#8220;<span class="quote">or</span>&#8221;.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_FO"></a>FO</h3></div></div></div><div class="itemizedlist"><ul type="disc"><li><p> Added <code class="literal">content-type</code> property to
  65           <code class="literal">external-graphic</code> element, based on
  66           <a href="http://www.docbook.org/tdg/en/html/imagedata.html"><code class="sgmltag-element">imagedata</code></a> <code class="sgmltag-attribute">format</code>
  67           attribute.</p></li><li><p>Added support for generating
  68           <code class="literal">&lt;rx:meta-field&nbsp;creator="$VERSION"/&gt;</code>
  69           field for XEP output. This makes the DocBook XSL
  70           stylesheet version information available through the
  71           <span class="guimenu">Document Properties</span> menu in Acrobat
  72           Reader and other PDF viewers.</p></li><li><p>Trademark symbol handling made consistent with
  73           handling of same in HTML stylesheets. Prior to this change,
  74           if you processed a document that contained no value for the
  75           <code class="sgmltag-attribute">class</code> attribute on the
  76           <a href="http://www.docbook.org/tdg/en/html/trademark.html"><code class="sgmltag-element">trademark</code></a> element, the HTML stylesheets would
  77           default to rendering a superscript <code class="literal">TM
  78           </code>symbol after the <a href="http://www.docbook.org/tdg/en/html/trademark.html"><code class="sgmltag-element">trademark</code></a> contents,
  79           but the FO stylesheets would render nothing.</p></li><li><p>Added support for generating XEP bookmarks for
  80           <a href="http://www.docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>.</p></li><li><p>Added support for HTML markup <a href="http://www.docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> <code class="sgmltag-attribute">border</code> attribute, applied to each
  81           table cell.</p></li><li><p>The <code class="function">table.width</code> template can now
  82           sum column specs if none use <code class="literal">%</code> or
  83           <code class="literal">*</code>.</p></li><li><p>Added <code class="literal">fox:destination</code> extension
  84           inside <code class="literal">fox:outline</code> to support linking to
  85           internal destinations.</p></li><li><p>Added support for customizing
  86           <code class="literal">abstract</code> with property sets. Controlled
  87           with the <em class="parameter"><code>abstract.properties</code></em> and
  88           <em class="parameter"><code>abstract.title.properties</code></em>
  89           parameters.</p></li><li><p>Add <a href="http://www.docbook.org/tdg/en/html/footnote.html"><code class="sgmltag-element">footnote</code></a>s in <a href="http://www.docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> title to
  90           table footnote set, and add support for table footnotes to
  91           HTML table markup.</p></li><li><p>Added support for <a href="http://www.docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> in
  92           <a href="http://www.docbook.org/tdg/en/html/glosslist.html"><code class="sgmltag-element">glosslist</code></a>.</p></li><li><p>Added support for <a href="http://www.docbook.org/tdg/en/html/itemizedlist.html"><code class="sgmltag-element">itemizedlist</code></a> symbol
  93           <code class="literal">none</code>.</p></li><li><p>Implemented the new
  94           <em class="parameter"><code>graphical.admonition.properties</code></em> and
  95           <em class="parameter"><code>nongraphical.admonition.properties</code></em>
  96           attribute sets.</p></li><li><p>Added <code class="sgmltag-attribute">id</code> to
  97           <a href="http://www.docbook.org/tdg/en/html/formalpara.html"><code class="sgmltag-element">formalpara</code></a> and some other blocks that were
  98           missing it.</p></li><li><p>Changed the anchor template to output
  99           <code class="literal">fo:inline</code> instead of
 100           <code class="literal">fo:wrapper</code>.</p></li><li><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>
 101           parameter.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_HELP"></a>Help</h3></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Eclipse Help: Added support for generating olink
 102           database.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_HTML"></a>HTML</h3></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Added a first cut at support in HTML output for
 103           DocBook 5 style <code class="sgmltag-element">annotation</code>s. Controlled using the
 104           <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
 105           implemented using JavaScript and CSS styling. For more
 106           details, see the documentation for the
 107           <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/annotation.js.html"><em class="parameter"><code>annotation.js</code></em></a>,
 108           <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/annotation.css.html"><em class="parameter"><code>annotation.css</code></em></a>,
 109           <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
 110           <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>
 111           parameters.</p></li><li><p>Generate client-side image map for
 112           <a href="http://www.docbook.org/tdg/en/html/imageobjectco.html"><code class="sgmltag-element">imageobjectco</code></a> with areas using
 113           <code class="literal">calspair</code> units</p></li><li><p>Added support for <code class="sgmltag-xmlpi">&lt;?img.src.path?&gt;</code> PI.</p></li><li><p>Added support for passing
 114           <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
 115           image extensions when appropriate. Controlled using the
 116           <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>
 117           parameter.</p></li><li><p>Added support for (not
 118           valid for DocBook 4) <code class="sgmltag-attribute">xlink:href</code>
 119           on <a href="http://www.docbook.org/tdg/en/html/area.html"><code class="sgmltag-element">area</code></a> and (not valid for DocBook 4)
 120           <a href="http://www.docbook.org/tdg/en/html/alt.html"><code class="sgmltag-element">alt</code></a> in <a href="http://www.docbook.org/tdg/en/html/area.html"><code class="sgmltag-element">area</code></a>.</p></li><li><p>Added new parameter
 121           <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
 122           framing if there is no <code class="sgmltag-attribute">frame</code>
 123           attribute on a table.</p></li><li><p>Added initial, experimental support for generating
 124           content for the HTML <code class="literal">title</code> attribute from
 125           content of the <a href="http://www.docbook.org/tdg/en/html/alt.html"><code class="sgmltag-element">alt</code></a> element. This change adds
 126           support for the following inline elements only (none of them
 127           are block elements):
 128           <span class="simplelist"><a href="http://www.docbook.org/tdg/en/html/abbrev.html"><code class="sgmltag-element">abbrev</code></a>, <a href="http://www.docbook.org/tdg/en/html/accel.html"><code class="sgmltag-element">accel</code></a>, <a href="http://www.docbook.org/tdg/en/html/acronym.html"><code class="sgmltag-element">acronym</code></a>, <a href="http://www.docbook.org/tdg/en/html/action.html"><code class="sgmltag-element">action</code></a>, <a href="http://www.docbook.org/tdg/en/html/application.html"><code class="sgmltag-element">application</code></a>, <a href="http://www.docbook.org/tdg/en/html/authorinitials.html"><code class="sgmltag-element">authorinitials</code></a>, <a href="http://www.docbook.org/tdg/en/html/beginpage.html"><code class="sgmltag-element">beginpage</code></a>, <a href="http://www.docbook.org/tdg/en/html/citation.html"><code class="sgmltag-element">citation</code></a>, <a href="http://www.docbook.org/tdg/en/html/citerefentry.html"><code class="sgmltag-element">citerefentry</code></a>, <a href="http://www.docbook.org/tdg/en/html/citetitle.html"><code class="sgmltag-element">citetitle</code></a>, <a href="http://www.docbook.org/tdg/en/html/city.html"><code class="sgmltag-element">city</code></a>, <a href="http://www.docbook.org/tdg/en/html/classname.html"><code class="sgmltag-element">classname</code></a>, <code class="sgmltag-element">code</code>, <a href="http://www.docbook.org/tdg/en/html/command.html"><code class="sgmltag-element">command</code></a>, <a href="http://www.docbook.org/tdg/en/html/computeroutput.html"><code class="sgmltag-element">computeroutput</code></a>, <a href="http://www.docbook.org/tdg/en/html/constant.html"><code class="sgmltag-element">constant</code></a>, <a href="http://www.docbook.org/tdg/en/html/country.html"><code class="sgmltag-element">country</code></a>, <a href="http://www.docbook.org/tdg/en/html/database.html"><code class="sgmltag-element">database</code></a>, <a href="http://www.docbook.org/tdg/en/html/email.html"><code class="sgmltag-element">email</code></a>, <a href="http://www.docbook.org/tdg/en/html/envar.html"><code class="sgmltag-element">envar</code></a>, <a href="http://www.docbook.org/tdg/en/html/errorcode.html"><code class="sgmltag-element">errorcode</code></a>, <a href="http://www.docbook.org/tdg/en/html/errorname.html"><code class="sgmltag-element">errorname</code></a>, <a href="http://www.docbook.org/tdg/en/html/errortext.html"><code class="sgmltag-element">errortext</code></a>, <a href="http://www.docbook.org/tdg/en/html/errortype.html"><code class="sgmltag-element">errortype</code></a>, <a href="http://www.docbook.org/tdg/en/html/exceptionname.html"><code class="sgmltag-element">exceptionname</code></a>, <a href="http://www.docbook.org/tdg/en/html/fax.html"><code class="sgmltag-element">fax</code></a>, <a href="http://www.docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a>, <a href="http://www.docbook.org/tdg/en/html/firstname.html"><code class="sgmltag-element">firstname</code></a>, <a href="http://www.docbook.org/tdg/en/html/firstterm.html"><code class="sgmltag-element">firstterm</code></a>, <a href="http://www.docbook.org/tdg/en/html/foreignphrase.html"><code class="sgmltag-element">foreignphrase</code></a>, <a href="http://www.docbook.org/tdg/en/html/function.html"><code class="sgmltag-element">function</code></a>, <a href="http://www.docbook.org/tdg/en/html/glossterm.html"><code class="sgmltag-element">glossterm</code></a>, <a href="http://www.docbook.org/tdg/en/html/guibutton.html"><code class="sgmltag-element">guibutton</code></a>, <a href="http://www.docbook.org/tdg/en/html/guiicon.html"><code class="sgmltag-element">guiicon</code></a>, <a href="http://www.docbook.org/tdg/en/html/guilabel.html"><code class="sgmltag-element">guilabel</code></a>, <a href="http://www.docbook.org/tdg/en/html/guimenu.html"><code class="sgmltag-element">guimenu</code></a>, <a href="http://www.docbook.org/tdg/en/html/guimenuitem.html"><code class="sgmltag-element">guimenuitem</code></a>, <a href="http://www.docbook.org/tdg/en/html/guisubmenu.html"><code class="sgmltag-element">guisubmenu</code></a>, <a href="http://www.docbook.org/tdg/en/html/hardware.html"><code class="sgmltag-element">hardware</code></a>, <a href="http://www.docbook.org/tdg/en/html/honorific.html"><code class="sgmltag-element">honorific</code></a>, <a href="http://www.docbook.org/tdg/en/html/interface.html"><code class="sgmltag-element">interface</code></a>, <a href="http://www.docbook.org/tdg/en/html/interfacename.html"><code class="sgmltag-element">interfacename</code></a>, <a href="http://www.docbook.org/tdg/en/html/keycap.html"><code class="sgmltag-element">keycap</code></a>, <a href="http://www.docbook.org/tdg/en/html/keycode.html"><code class="sgmltag-element">keycode</code></a>, <a href="http://www.docbook.org/tdg/en/html/keysym.html"><code class="sgmltag-element">keysym</code></a>, <a href="http://www.docbook.org/tdg/en/html/lineage.html"><code class="sgmltag-element">lineage</code></a>, <a href="http://www.docbook.org/tdg/en/html/lineannotation.html"><code class="sgmltag-element">lineannotation</code></a>, <a href="http://www.docbook.org/tdg/en/html/literal.html"><code class="sgmltag-element">literal</code></a>, <a href="http://www.docbook.org/tdg/en/html/markup.html"><code class="sgmltag-element">markup</code></a>, <a href="http://www.docbook.org/tdg/en/html/medialabel.html"><code class="sgmltag-element">medialabel</code></a>, <a href="http://www.docbook.org/tdg/en/html/methodname.html"><code class="sgmltag-element">methodname</code></a>, <a href="http://www.docbook.org/tdg/en/html/mousebutton.html"><code class="sgmltag-element">mousebutton</code></a>, <a href="http://www.docbook.org/tdg/en/html/option.html"><code class="sgmltag-element">option</code></a>, <a href="http://www.docbook.org/tdg/en/html/optional.html"><code class="sgmltag-element">optional</code></a>, <a href="http://www.docbook.org/tdg/en/html/otheraddr.html"><code class="sgmltag-element">otheraddr</code></a>, <a href="http://www.docbook.org/tdg/en/html/othername.html"><code class="sgmltag-element">othername</code></a>, <code class="sgmltag-element">package</code>, <a href="http://www.docbook.org/tdg/en/html/parameter.html"><code class="sgmltag-element">parameter</code></a>, <a href="http://www.docbook.org/tdg/en/html/personname.html"><code class="sgmltag-element">personname</code></a>, <a href="http://www.docbook.org/tdg/en/html/phone.html"><code class="sgmltag-element">phone</code></a>, <a href="http://www.docbook.org/tdg/en/html/pob.html"><code class="sgmltag-element">pob</code></a>, <a href="http://www.docbook.org/tdg/en/html/postcode.html"><code class="sgmltag-element">postcode</code></a>, <a href="http://www.docbook.org/tdg/en/html/productname.html"><code class="sgmltag-element">productname</code></a>, <a href="http://www.docbook.org/tdg/en/html/productnumber.html"><code class="sgmltag-element">productnumber</code></a>, <a href="http://www.docbook.org/tdg/en/html/prompt.html"><code class="sgmltag-element">prompt</code></a>, <a href="http://www.docbook.org/tdg/en/html/property.html"><code class="sgmltag-element">property</code></a>, <a href="http://www.docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a>, <a href="http://www.docbook.org/tdg/en/html/refentrytitle.html"><code class="sgmltag-element">refentrytitle</code></a>, <a href="http://www.docbook.org/tdg/en/html/remark.html"><code class="sgmltag-element">remark</code></a>, <a href="http://www.docbook.org/tdg/en/html/replaceable.html"><code class="sgmltag-element">replaceable</code></a>, <a href="http://www.docbook.org/tdg/en/html/returnvalue.html"><code class="sgmltag-element">returnvalue</code></a>, <a href="http://www.docbook.org/tdg/en/html/sgmltag.html"><code class="sgmltag-element">sgmltag</code></a>, <a href="http://www.docbook.org/tdg/en/html/shortcut.html"><code class="sgmltag-element">shortcut</code></a>, <a href="http://www.docbook.org/tdg/en/html/state.html"><code class="sgmltag-element">state</code></a>, <a href="http://www.docbook.org/tdg/en/html/street.html"><code class="sgmltag-element">street</code></a>, <a href="http://www.docbook.org/tdg/en/html/structfield.html"><code class="sgmltag-element">structfield</code></a>, <a href="http://www.docbook.org/tdg/en/html/structname.html"><code class="sgmltag-element">structname</code></a>, <a href="http://www.docbook.org/tdg/en/html/subscript.html"><code class="sgmltag-element">subscript</code></a>, <a href="http://www.docbook.org/tdg/en/html/superscript.html"><code class="sgmltag-element">superscript</code></a>, <a href="http://www.docbook.org/tdg/en/html/surname.html"><code class="sgmltag-element">surname</code></a>, <a href="http://www.docbook.org/tdg/en/html/symbol.html"><code class="sgmltag-element">symbol</code></a>, <a href="http://www.docbook.org/tdg/en/html/systemitem.html"><code class="sgmltag-element">systemitem</code></a>, <code class="sgmltag-element">tag</code>, <code class="sgmltag-element">termdef</code>, <a href="http://www.docbook.org/tdg/en/html/token.html"><code class="sgmltag-element">token</code></a>, <a href="http://www.docbook.org/tdg/en/html/trademark.html"><code class="sgmltag-element">trademark</code></a>, <a href="http://www.docbook.org/tdg/en/html/type.html"><code class="sgmltag-element">type</code></a>, <code class="sgmltag-element">uri</code>, <a href="http://www.docbook.org/tdg/en/html/userinput.html"><code class="sgmltag-element">userinput</code></a>, <a href="http://www.docbook.org/tdg/en/html/varname.html"><code class="sgmltag-element">varname</code></a>, and <a href="http://www.docbook.org/tdg/en/html/wordasword.html"><code class="sgmltag-element">wordasword</code></a></span>
 129         </p></li><li><p>Added support for chunking <a href="http://www.docbook.org/tdg/en/html/revhistory.html"><code class="sgmltag-element">revhistory</code></a> into
 130           separate file (similar to the support for doing same with
 131           <a href="http://www.docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a>). Patch from Thomas
 132           Schraitle. Controlled through <em class="parameter"><code>new
 133           generate.revhistory.link</code></em> parameter.</p></li><li><p>l10n.xsl: Made language codes RFC compliant. Added a
 134           new boolean config parameter,
 135           <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
 136           is non-zero (the default), any underscore in a language code
 137           will be converted to a hyphen in HTML output. If it is zero,
 138           the language code will be left as-is.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_MAN"></a>man</h3></div></div></div><p>This release closes out 44 manpages stylesheet bug reports
 139       and feature requests. It adds more than 35 new configuration
 140       parameters for controlling aspects of man-page output --
 141       including hyphenation and justification, handling of links,
 142       conversion of Unicode characters, and contents of man-page
 143       headers and footers.</p><div class="itemizedlist"><ul type="disc"><li><p>New options for globally disabling/enabling
 144           hyphenation and justification:
 145           <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.justify.html"><em class="parameter"><code>man.justify</code></em></a> and
 146           <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.hyphenate.html"><em class="parameter"><code>man.hyphenate</code></em></a>.</p><p>Note that the default
 147           for the both of those is zero (off), because justified text
 148           looks good only when it is also hyphenated; to quote the
 149           &#8220;<span class="quote">Hyphenation</span>&#8221; node from the groff info page:
 150           </p><div class="blockquote"><blockquote class="blockquote"><p><span class="emphasis"><em>Since the odds are not great for finding a
 151             set of words, for every output line, which fit nicely on a
 152             line without inserting excessive amounts of space between
 153             words, `gtroff' hyphenates words so that it can justify
 154             lines without inserting too much space between
 155             words.</em></span></p></blockquote></div><p>
 156           The problem is that groff can end up hyphenating a lot of
 157           things that you don't want hyphenated (variable names and
 158           command names, for example). Keeping both justification and
 159           hyphenation disabled ensures that hyphens won't get inserted
 160           where you don't want to them, and you don't end up with
 161           lines containing excessive amounts of space between
 162           words. These default settings run counter to how most
 163           existing man pages are formatted. But there are some notable
 164           exceptions, such as the perl man pages.</p></li><li><p> Added parameters for controlling hyphenation of
 165           computer inlines, filenames, and URLs. By default, even when
 166           hyphenation is enabled (globally), hyphenation is now
 167           suppressed for "computer inlines" (currently, just
 168           <a href="http://www.docbook.org/tdg/en/html/classname.html"><code class="sgmltag-element">classname</code></a>, <a href="http://www.docbook.org/tdg/en/html/constant.html"><code class="sgmltag-element">constant</code></a>, <a href="http://www.docbook.org/tdg/en/html/envar.html"><code class="sgmltag-element">envar</code></a>,
 169           <a href="http://www.docbook.org/tdg/en/html/errorcode.html"><code class="sgmltag-element">errorcode</code></a>, <a href="http://www.docbook.org/tdg/en/html/option.html"><code class="sgmltag-element">option</code></a>,
 170           <a href="http://www.docbook.org/tdg/en/html/replaceable.html"><code class="sgmltag-element">replaceable</code></a>, <a href="http://www.docbook.org/tdg/en/html/userinput.html"><code class="sgmltag-element">userinput</code></a>,
 171           <a href="http://www.docbook.org/tdg/en/html/type.html"><code class="sgmltag-element">type</code></a>, and <a href="http://www.docbook.org/tdg/en/html/varname.html"><code class="sgmltag-element">varname</code></a>, and for
 172           <code class="sgmltag-element">filenames</code>, and for URLs from <a href="http://www.docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>. It
 173           can be (re)enabled using the
 174           <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>,
 175           <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
 176           <em class="parameter"><code>man.hyphenate.urls parameters</code></em>.</p></li><li><p>Implemented a new system for replacing Unicode
 177           characters. There are two parts to the new system: a
 178           &#8220;<span class="quote">string substitution map</span>&#8221; for doing
 179           &#8220;<span class="quote">essential</span>&#8221; replacements, and a
 180           &#8220;<span class="quote">character map</span>&#8221; that can optionally be disabled
 181           and enabled.</p><p>The new system fixes all open bugs that had to do with
 182           literal Unicode numbered entities such as &amp;#8220; and
 183           &amp;#8221; showing up in output, and greatly expands the
 184           ability of the stylesheets to generate &#8220;<span class="quote">good</span>&#8221; roff
 185           equivalents for Unicode symbols and special
 186           characters.</p><p>Here are some details...</p><p>The previous manpages mechanism for replacing Unicode
 187           symbols and special characters with roff equivalents (the
 188           <code class="function">replace-entities</code> template) was not
 189           scalable and not complete. The mechanism handled a somewhat
 190           arbitrary selection of less than 20 or so Unicode
 191           characters. But there are potentially more than
 192           <span class="emphasis"><em>800</em></span> Unicode special characters that
 193           have some groff equivalent they can be mapped to. And there
 194           are about 34 symbols in the Latin-1 (ISO-8859-1) block
 195           alone. Users might reasonably expect that if they include
 196           any of those Latin-1 characters in their DocBook source
 197           documents, they will get correctly converted to known roff
 198           equivalents in output.</p><p>In addition to those common symbols, certain users may
 199           have a need to use symbols from other Unicode blocks. Say,
 200           somebody who is documenting an application related to math
 201           might need to use a bunch of symbols from the
 202           &#8220;<span class="quote">Mathematical Operators</span>&#8221; Unicode block (there
 203           are about 65 characters in that block that have reasonable
 204           roff equivalents). Or somebody else might really like
 205           Dingbats -- such as the checkmark character -- and so might
 206           use a bunch of things from the &#8220;<span class="quote">Dingbat</span>&#8221; block
 207           (141 characters in that that have roff equivalents or that
 208           can at least be &#8220;<span class="quote">degraded</span>&#8221; somewhat gracefully
 209           into roff).</p><p>So, the old <code class="function">replace-entities</code>
 210           mechanism was replaced with a completely different mechanism
 211           that is based on use of two &#8220;<span class="quote">maps</span>&#8221;: a
 212           &#8220;<span class="quote">substitution map</span>&#8221; and a &#8220;<span class="quote">character
 213           map</span>&#8221; (the latter in a format compliant with the XSLT
 214           2.0 spec and therefore completely &#8220;<span class="quote">forward
 215           compatible</span>&#8221; with XSLT 2.0).</p><p>The substitution map is controlled through the
 216           <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
 217           is used to replace things like the backslash character
 218           (which needs special handling to prevent it from being
 219           interpreted as a roff escape). The substitution map cannot
 220           be disabled, because disabling it will cause the output to
 221           be broken. However, you can add to it and change it if
 222           needed.</p><p>The &#8220;<span class="quote">character map</span>&#8221; mechanism, on the
 223           other hand, can be completely disabled. It is enabled by
 224           default, and, by default, does replacement of all Latin-1
 225           symbols, along with most special spaces, dashes, and quotes
 226           (about 75 characters by default). Also, you can optionally
 227           enable a &#8220;<span class="quote">full</span>&#8221; character map that provides
 228           support for converting all 800 or so of the characters that
 229           have some reasonable groff equivalent.</p><p>The character-map mechanism is controlled through the
 230           following parameters:
 231           </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
 232               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
 233               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
 234               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
 235               use instead of the &#8220;<span class="quote">standard</span>&#8221; character map
 236               provided in the distribution</p></dd></dl></div><p>
 237           </p></li><li><p>Implemented out-of-line handling of display of URLs
 238           for links (currently, only for <a href="http://www.docbook.org/tdg/en/html/ulink.html"><code class="sgmltag-element">ulink</code></a>). This gives
 239           you three choices for handling of links:
 240           </p><div class="orderedlist"><ol type="1"><li><p>Number and list links. Each link is numbered
 241               inline, with a number in square brackets preceding the
 242               link contents, and a numbered list of all links is added
 243               to the end of the document.</p></li><li><p>Only list links. Links are not numbered, but an
 244               (unnumbered) list of links is added to the end of the
 245               document.</p></li><li><p>Suppress links. Don't number links and don't add
 246               any list of links to the end of the document.</p></li></ol></div><p>
 247           You can also choose whether links should be underlined. The
 248           default is &#8220;<span class="quote">the works</span>&#8221; -- list, number, and
 249           underline links. You can use the
 250           <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>
 251           man.links.are.numbered</code></em></a>, and
 252           <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
 253           to change the defaults. The default heading for the link
 254           list is REFERENCES. You can be change that using the
 255           <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>
 256           parameter.</p></li><li><p>Changed default output encoding to UTF-8. <span class="bold"><strong>This does not mean that man pages are output in
 257           raw UTF-8</strong></span>, because the character map is applied
 258           before final output, causing all UTF-8 characters covered in
 259           the map to be converted to roff equivalents.</p></li><li><p>Added support for processing <a href="http://www.docbook.org/tdg/en/html/refsect3.html"><code class="sgmltag-element">refsect3</code></a> and
 260           <a href="http://www.docbook.org/tdg/en/html/formalpara.html"><code class="sgmltag-element">formalpara</code></a> and nested <a href="http://www.docbook.org/tdg/en/html/refsection.html"><code class="sgmltag-element">refsection</code></a>
 261           elements, down to any arbitrary level of nesting.</p></li><li><p>Output of the <code class="literal">NAME</code> and
 262           <code class="literal">SYNOPSIS</code> and <code class="literal">AUTHOR</code>
 263           headings and the headings for admonitions (<a href="http://www.docbook.org/tdg/en/html/note.html"><code class="sgmltag-element">note</code></a>,
 264           <a href="http://www.docbook.org/tdg/en/html/caution.html"><code class="sgmltag-element">caution</code></a>, etc.) are no longer hard-coded for
 265           English. Instead, headings are generated for those in the
 266           correct locale (just as the FO and HTML stylesheets
 267           do).</p></li><li><p>Re-worked mechanism for assembling page
 268           headers/footers (the contents of the <code class="literal">.TH</code>
 269           macro &#8220;<span class="quote">title line</span>&#8221;).</p><p>Here are some details...</p><p>All man pages contain a <code class="literal">.TH</code> roff
 270           macro whose contents are used for rendering the &#8220;<span class="quote">title
 271           line</span>&#8221; displayed in the header and footer of each
 272           page. Here are a couple of examples of real-world man pages
 273           that have useful page headers/footers: </p><pre class="literallayout">
 274   gtk-options(7)    GTK+ User's Manual   gtk-options(7) &lt;-- header
 275   GTK+ 1.2              2003-10-20       gtk-options(7) &lt;-- footer
 276
 277   svgalib(7)       Svgalib User Manual       svgalib(7) &lt;-- header
 278   Svgalib 1.4.1      16 December 1999        svgalib(7) &lt;-- footer</pre><p>And here are the terms with which the
 279           <code class="literal">groff_man(7)</code> man page refers to the
 280           various parts of the header/footer: </p><pre class="literallayout">
 281   title(section)  extra3  title(section)  &lt;- header
 282   extra2          extra1  title(section)  &lt;- footer</pre><p> Or, using the names with which the <code class="literal">man(7)</code>
 283    man page refers to those same fields: </p><pre class="literallayout">
 284   title(section)  manual  title(section)  &lt;- page header
 285   source          date    title(section)  &lt;- page footer</pre><p>The easiest way to control the contents of those
 286             fields is to mark up your <a href="http://www.docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> content like
 287             the following (note that this is a &#8220;<span class="quote">minimal</span>&#8221;
 288             example). </p><pre class="programlisting">
 289   &lt;refentry&gt;
 290     &lt;info&gt;
 291       &lt;date&gt;2003-10-20&lt;/date&gt; <a name="V1690_date-co"></a><img src="images/callouts/1.png" alt="1" border="0">
 292     &lt;/info&gt;
 293     &lt;refmeta&gt;
 294       &lt;refentrytitle&gt;gtk-options&lt;/refentrytitle&gt; <a name="V1690_title-co"></a><img src="images/callouts/2.png" alt="2" border="0">
 295       &lt;manvolnum&gt;7&lt;/manvolnum&gt; <a name="V1690_manvolnum-co"></a><img src="images/callouts/3.png" alt="3" border="0">
 296       &lt;refmiscinfo class="source-name"&gt;GTK+&lt;/refmiscinfo&gt; <a name="V1690_source-name-co"></a><img src="images/callouts/4.png" alt="4" border="0">
 297       &lt;refmiscinfo class="version"&gt;1.2&lt;/refmiscinfo&gt; <a name="V1690_version-co"></a><img src="images/callouts/5.png" alt="5" border="0">
 298       &lt;refmiscinfo class="manual"&gt;GTK+ User's Manual&lt;/refmiscinfo&gt; <a name="V1690_manual-co"></a><img src="images/callouts/6.png" alt="6" border="0">
 299     &lt;/refmeta&gt;
 300     &lt;refnamediv&gt;
 301       &lt;refname&gt;gtk-options&lt;/refname&gt;
 302       &lt;refpurpose&gt;Standard Command Line Options for GTK+ Programs&lt;/refpurpose&gt;
 303     &lt;/refnamediv&gt;
 304     &lt;refsect1&gt;
 305       &lt;title&gt;Description&lt;/title&gt;
 306       &lt;para&gt;This manual page describes the command line options, which
 307       are common to all GTK+ based applications.&lt;/para&gt;
 308     &lt;/refsect1&gt;
 309   &lt;/refentry&gt;</pre><p>
 310   </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"><p>Sets the &#8220;<span class="quote">date</span>&#8221; part of the header/footer.</p></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"><p>Sets the &#8220;<span class="quote">title</span>&#8221; part.</p></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"><p>Sets the &#8220;<span class="quote">section</span>&#8221; part.</p></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"><p>Sets the &#8220;<span class="quote">source name</span>&#8221; part.</p></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"><p>Sets the &#8220;<span class="quote">version</span>&#8221; part.</p></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"><p>Sets the &#8220;<span class="quote">manual</span>&#8221; part.</p></td></tr></table></div><p>
 311             </p><p>Below are explanations of the steps the stylesheets
 312             take to attempt to assemble and display
 313             &#8220;<span class="quote">good</span>&#8221; headers and footer. [In the
 314             descriptions, note that <em class="replaceable"><code>*info</code></em>
 315             is the <a href="http://www.docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> &#8220;<span class="quote">info</span>&#8221; child
 316             (whatever its name), and
 317             <em class="replaceable"><code>parentinfo</code></em> is the
 318             &#8220;<span class="quote">info</span>&#8221; child of its parent (again, whatever
 319             its name).]
 320           </p><div class="variablelist"><dl><dt><span class="term">extra1 field (date)</span></dt><dd><p>Content of the &#8220;<span class="quote">extra1</span>&#8221; field is
 321                 what shows up in the <span class="bold"><strong>center
 322                 footer</strong></span> position of each page. The
 323                 <code class="literal">man(7)</code> man page describes it as
 324                 &#8220;<span class="quote">the date of the last revision</span>&#8221;.</p><p>To provide this content, if the
 325                 <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>
 326                 is non-zero, the stylesheets check the value of
 327                 <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><p>Otherwise, by default, they check for a
 328                 <a href="http://www.docbook.org/tdg/en/html/date.html"><code class="sgmltag-element">date</code></a> or <a href="http://www.docbook.org/tdg/en/html/pubdate.html"><code class="sgmltag-element">pubdate</code></a> not only in the
 329                 <em class="replaceable"><code>*info</code></em> contents, but also in
 330                 the <em class="replaceable"><code>parentinfo</code></em>
 331                 contents.</p><p>If a date cannot be found, the stylesheets now
 332                 automatically generate a localized &#8220;<span class="quote">long
 333                 format</span>&#8221; date, ensuring that this field always
 334                 has content in output.</p><p>However, if for some reason you want to suppress
 335                 this field, you can do so by setting a non-zero value
 336                 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></dd><dt><span class="term">extra2 field (source)</span></dt><dd><p>On Linux systems and on systems with a modern
 337                 groff, the content of the &#8220;<span class="quote">extra2</span>&#8221; field
 338                 are what shows up in the <span class="bold"><strong>left
 339                 footer</strong></span> position of each page.</p><p>The <code class="literal">man(7)</code> man page describes
 340                 this as &#8220;<span class="quote">the source of the command</span>&#8221;, and
 341                 provides the following examples:
 342                 </p><div class="itemizedlist"><ul type="circle"><li><p>For binaries, use somwething like: GNU,
 343                     NET-2, SLS Distribution, MCC Distribution.</p></li><li><p>For system calls, use the version of the
 344                     kernel that you are currently looking at: Linux
 345                     0.99.11.</p></li><li><p>For library calls, use the source of the
 346                     function: GNU, BSD 4.3, Linux DLL 4.4.1.</p></li></ul></div><p>
 347                 </p><p>In practice, there are many pages that simply
 348                 have a version number in the &#8220;<span class="quote">source</span>&#8221;
 349                 field. So, it looks like what we have is a two-part
 350                 field,
 351                 <em class="replaceable"><code>Name</code></em>&nbsp;<em class="replaceable"><code>Version</code></em>,
 352                 where:
 353                 </p><div class="variablelist"><dl><dt><span class="term">Name</span></dt><dd><p>product name (e.g., BSD) or org. name
 354                       (e.g., GNU)</p></dd><dt><span class="term">Version</span></dt><dd><p>version name</p></dd></dl></div><p>
 355                 Each part is optional. If the
 356                 <em class="replaceable"><code>Name</code></em> is a product name,
 357                 then the <em class="replaceable"><code>Version</code></em> is
 358                 probably the version of the product. Or there may be
 359                 no <em class="replaceable"><code>Name</code></em>, in which case, if
 360                 there is a <em class="replaceable"><code>Version</code></em>, it is
 361                 probably the version of the item itself, not the
 362                 product it is part of. Or, if the
 363                 <em class="replaceable"><code>Name</code></em> is an organization
 364                 name, then there probably will be no
 365                 <em class="replaceable"><code>Version</code></em>.
 366                 </p><p>To provide this content, if the
 367                 <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>
 368                 and
 369                 <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>
 370                 parameter are non-zero, the stylesheets check the
 371                 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>
 372                 <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><p>Otherwise, by default, they check the following
 373                 places, in the following order:
 374                 </p><div class="orderedlist"><ol type="1"><li><pre class="literallayout"><em class="replaceable"><code>*info</code></em>/<a href="http://www.docbook.org/tdg/en/html/productnumber.html"><code class="sgmltag-element">productnumber</code></a></pre></li><li><pre class="literallayout"><em class="replaceable"><code>*info</code></em>/<a href="http://www.docbook.org/tdg/en/html/productnumber.html"><code class="sgmltag-element">productnumber</code></a></pre></li><li><pre class="literallayout"><a href="http://www.docbook.org/tdg/en/html/refmeta.html"><code class="sgmltag-element">refmeta</code></a>/<a href="http://www.docbook.org/tdg/en/html/refmiscinfo.html"><code class="sgmltag-element">refmiscinfo</code></a>[@class = 'version']</pre></li><li><pre class="literallayout"><em class="replaceable"><code>parentinfo</code></em>/<a href="http://www.docbook.org/tdg/en/html/productnumber.html"><code class="sgmltag-element">productnumber</code></a></pre></li><li><pre class="literallayout"><em class="replaceable"><code>*info</code></em>/<a href="http://www.docbook.org/tdg/en/html/productname.html"><code class="sgmltag-element">productname</code></a></pre></li><li><pre class="literallayout"><em class="replaceable"><code>parentinfo</code></em>/<a href="http://www.docbook.org/tdg/en/html/productname.html"><code class="sgmltag-element">productname</code></a></pre></li><li><pre class="literallayout"><a href="http://www.docbook.org/tdg/en/html/refmeta.html"><code class="sgmltag-element">refmeta</code></a>/<a href="http://www.docbook.org/tdg/en/html/refmiscinfo.html"><code class="sgmltag-element">refmiscinfo</code></a></pre></li><li><p>[nothing found, so leave it empty]</p></li></ol></div><p>
 375                 </p></dd><dt><span class="term">extra3 field</span></dt><dd><p>On Linux systems and on systems with a modern
 376                 groff, the content of the &#8220;<span class="quote">extra3</span>&#8221; field
 377                 are what shows up in the <span class="bold"><strong>center
 378                 header</strong></span> position of each page. Some man
 379                 pages have &#8220;<span class="quote">extra2</span>&#8221; content, some
 380                 don't. If a particular man page has it, it is most
 381                 often &#8220;<span class="quote">context</span>&#8221; data about some larger
 382                 system the documented item belongs to (for example,
 383                 the name or description of a group of related
 384                 applications). The stylesheets now check the following
 385                 places, in the following order, to look for content to
 386                 add to the &#8220;<span class="quote">extra3</span>&#8221; field.</p><div class="orderedlist"><ol type="1"><li><pre class="literallayout"><em class="replaceable"><code>parentinfo</code></em>/<a href="http://www.docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a></pre></li><li><pre class="literallayout">parent's <a href="http://www.docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a></pre></li><li><pre class="literallayout"><a href="http://www.docbook.org/tdg/en/html/refmeta.html"><code class="sgmltag-element">refmeta</code></a>/<a href="http://www.docbook.org/tdg/en/html/refmiscinfo.html"><code class="sgmltag-element">refmiscinfo</code></a></pre></li><li><p>[nothing found, so leave it empty]</p></li></ol></div></dd></dl></div><p>
 387         </p></li><li><p>Reworked <em class="replaceable"><code>*info</code></em> gathering. For
 388         each <a href="http://www.docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> found, the stylesheets now cache its
 389         <em class="replaceable"><code>*info</code></em> content, then check for any
 390         valid parent of it that might have metainfo content and cache
 391         that, if found; they then then do all further matches against
 392         those node-sets (rather than re-selecting the original
 393         <em class="replaceable"><code>*info</code></em> nodes each time they are
 394         needed).</p></li><li><p>New option for breaking strings after forward
 395         slashes. This enables long URLs and pathnames to be broken
 396         across lines. Controlled through
 397         <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></li><li><p>Output for servicemark and trademark are now
 398         <code class="literal">(SM)</code> and <code class="literal">(TM)</code>. There is
 399         a groff <code class="literal">"\(tm"</code> escape, but output from that
 400         is not acceptable.</p></li><li><p>New option for controlling the length of the title
 401         part of the <code class="literal">.TH</code> title line. Controlled
 402         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>
 403         parameter.</p></li><li><p>New option for specifying output encoding of each man
 404         page; controlled with
 405         <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
 406         HTML <em class="parameter"><code>chunker.output.encoding </code></em>
 407         parameter).</p></li><li><p>New option for suppressing filename messages when
 408         generating output; controlled with
 409         <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
 410         <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></li><li><p>The text of cross-references to first-level
 411         <a href="http://www.docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> (<a href="http://www.docbook.org/tdg/en/html/refsect1.html"><code class="sgmltag-element">refsect1</code></a>, top-level
 412         <a href="http://www.docbook.org/tdg/en/html/refsection.html"><code class="sgmltag-element">refsection</code></a>, <a href="http://www.docbook.org/tdg/en/html/refnamediv.html"><code class="sgmltag-element">refnamediv</code></a>, and
 413         <a href="http://www.docbook.org/tdg/en/html/refsynopsisdiv.html"><code class="sgmltag-element">refsynopsisdiv</code></a>) are now capitalized.</p></li><li><p>Cross-references to <a href="http://www.docbook.org/tdg/en/html/refnamediv.html"><code class="sgmltag-element">refnamediv</code></a> now use the
 414         localized <code class="literal">NAME</code> title instead of using the
 415         first <a href="http://www.docbook.org/tdg/en/html/refname.html"><code class="sgmltag-element">refname</code></a> child. This makes the output
 416         inconsistent with HTML and FO output, but for man-page output,
 417         it seems to make better sense to have the
 418         <code class="literal">NAME</code>. (It may actually make better sense to
 419         do it that way in HTML and FO output as well...)</p></li><li><p>Added support for processing <a href="http://www.docbook.org/tdg/en/html/funcparams.html"><code class="sgmltag-element">funcparams</code></a>.</p></li><li><p>Removed the space that was being output between
 420         <a href="http://www.docbook.org/tdg/en/html/funcdef.html"><code class="sgmltag-element">funcdef</code></a> and <a href="http://www.docbook.org/tdg/en/html/paramdef.html"><code class="sgmltag-element">paramdef</code></a>; example: was:
 421         <code class="literal">float&nbsp;rand&nbsp;(void)</code>; now:
 422         <code class="literal">float&nbsp;rand(void)</code></p></li><li><p>Turned off bold formatting for the <a href="http://www.docbook.org/tdg/en/html/type.html"><code class="sgmltag-element">type</code></a>
 423         element when it occurs within a <a href="http://www.docbook.org/tdg/en/html/funcdef.html"><code class="sgmltag-element">funcdef</code></a> or
 424         <a href="http://www.docbook.org/tdg/en/html/paramdef.html"><code class="sgmltag-element">paramdef</code></a></p></li><li><p>Corrected rendering of <a href="http://www.docbook.org/tdg/en/html/simplelist.html"><code class="sgmltag-element">simplelist</code></a>. Any
 425         <code class="literal">&lt;simplelist&nbsp;type="inline"</code> instance
 426         is now rendered as a comma-separated list (also with an
 427         optional localized &#8220;<span class="quote">and</span>&#8221; or &#8220;<span class="quote">or</span>&#8221; before the last item -- see
 428         description elsewhere in these release notes). Any simplelist
 429         instance whose <code class="sgmltag-attribute">type</code> is not
 430         <code class="literal">inline</code> is rendered as a one-column vertical
 431         list (ignoring the values of the <code class="sgmltag-attribute">type</code> and <code class="sgmltag-attribute">columns</code> attributes if present)</p></li><li><p>Comment added at top of roff source for each page now
 432         includes DocBook XSL stylesheets version number (as in the
 433         HTML stylesheets)</p></li><li><p>Made change to prevent &#8220;<span class="quote">sticky</span>&#8221; fonts
 434         changes. Now, when the manpages stylesheets encounter node
 435         sets that need to be boldfaced or italicized, they put the
 436         <code class="literal">\fBfoo\fR</code> and <code class="literal">\fIbar\fR</code>
 437         groff bold/italic instructions separately around each node in
 438         the set.</p></li><li><p>synop.xsl: Boldface everything in
 439         <a href="http://www.docbook.org/tdg/en/html/funcsynopsis.html"><code class="sgmltag-element">funcsynopsis</code></a> output except parameters (which are in
 440         ital). The <code class="literal">man(7)</code> man page says:
 441         </p><div class="blockquote"><blockquote class="blockquote"><p>For functions, the arguments are always specified
 442           using italics, even in the SYNOPSIS section, where the rest
 443           of the function is specified in bold.</p></blockquote></div><p>
 444           A look through the contents of the
 445           <code class="filename">man/man2</code> directory shows that most
 446           (all) existing pages do follow this &#8220;<span class="quote">everything in
 447           funcsynopsis bold</span>&#8221; rule. That means the
 448           <a href="http://www.docbook.org/tdg/en/html/type.html"><code class="sgmltag-element">type</code></a> content and any punctuation (parens,
 449           semicolons, <code class="sgmltag-element">vararg</code>s) also must be bolded.</p></li><li><p>Removed code for adding backslashes before periods/dots
 450         in roff source, because backslashes in front of periods/dots
 451         in roff source are needed only in the very rare case where a
 452         period is the very first character in a line, without any
 453         space in front of it. A better way to deal with that rare case
 454         is for you to add a zero-width space in front of the offending
 455         dot(s) in your source</p></li><li><p>Removed special handling of the <a href="http://www.docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a>
 456         element. That was hard-coded to cause anything marked up with
 457         the <a href="http://www.docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a> element to be output preceded by two
 458         backticks and followed by two apostrophes -- that is, that
 459         old-school kludge for generating &#8220;<span class="quote">curly</span>&#8221; quotes in Emacs and
 460         in X-Windows fonts. While Emacs still seems to support that, I
 461         don't think X-Windows has for a long time now. And, anyway, it
 462         looks (and has always looked) like crap when viewed on a
 463         normal tty/console. In addition, it breaks localiztion of
 464         <a href="http://www.docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a>. By default, <a href="http://www.docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a> content is
 465         output with localized quotation marks, which, depending on the
 466         locale, may or may not be left and right double quotation
 467         marks.</p></li><li><p>Changed mappings for left and right single quotation
 468         marks. Those had previously been incorrectly mapped to the
 469         backtick (&amp;#96;) and apostrophe (&amp;39;) characters (for
 470         kludgy reasons -- see above). They are now correctly mapped to
 471         the <code class="literal">\(oq</code> and <code class="literal">\(cq</code> roff
 472         escapes. If you want the old (broken) behavior, you need to
 473         manually change the mappings for those in the value of the
 474         <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></li><li><p>Removed <code class="filename">xref.xsl</code> file. Now, of the
 475         various cross-reference elements, only the <a href="http://www.docbook.org/tdg/en/html/ulink.html"><code class="sgmltag-element">ulink</code></a>
 476         element is handled differently; the rest are handled exactly
 477         as the HTML stylesheets handle them, except that no hypertext
 478         links are generated. (Because there is no equivalent hypertext
 479         mechanism is man pages.)</p></li><li><p>New option for making &#8220;<span class="quote">subheading dividers</span>&#8221; in generated
 480         roff source. The dividers are not visible in the rendered man
 481         page; they are just there to make the source
 482         readable. Controlled using
 483         <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></li><li><p>Fixed many places where too much space was being added
 484         between lines.</p></li></ul></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e1625"></a>Release 1.68.1</h2></div></div></div><p>The release adds localization support for Farsi (thanks to
 485     Sina Heshmati) and improved support for the XLink-based DocBook NG
 486     <code class="sgmltag-element">db:link</code> element. Other than that, it is a minor
 487     bug-fix update to the 1.68.0 release. The main thing it fixes is a
 488     build error that caused the XSLT Java extensions to be jarred up
 489     with the wrong package structure. Thanks to Jens Stavnstrup for
 490     quickly reporting the problem, and to Mauritz Jeanson for
 491     investigating and finding the cause.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e1634"></a>Release 1.68.0</h2></div></div></div><p>This release includes some features changes, particularly
 492     for FO/PDF output, and a number of bug fixes.
 493       </p><div class="itemizedlist"><a name="V1680_FO"></a><p class="title"><b>FO</b></p><ul type="disc"><li><p>Moved footnote properties to attribute-sets.</p></li><li><p>Added support for side floats, margin notes, and
 494           custom floats.</p></li><li><p>Added new parameters
 495           <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
 496           <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
 497           <em class="parameter"><code>set.flow.properties template</code></em>.</p></li><li><p>Added support for <code class="sgmltag-attribute">xml:id</code></p></li><li><p>Added support for
 498           <a href="http://www.docbook.org/tdg/en/html/refdescriptor.html"><code class="sgmltag-element">refdescriptor</code></a>.</p></li><li><p>Added support for multiple <a href="http://www.docbook.org/tdg/en/html/refnamediv.html"><code class="sgmltag-element">refnamediv</code></a>s.</p></li><li><p>Added <em class="parameter"><code>index.entry.properties</code></em>
 499           attribute-set to support customization of index
 500           entries.</p></li><li><p>Added <em class="parameter"><code>set.flow.properties
 501           template</code></em> call to each <code class="sgmltag-element">fo:flow</code>
 502           to support customizations entry point.</p></li><li><p>Add support for <code class="literal">@floatstyle</code> in
 503           <a href="http://www.docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a></p></li><li><p>Moved hardcoded properties for index division titles
 504           to the <em class="parameter"><code>index.div.title.properties</code></em>
 505           attribute-set.</p></li><li><p>Added support for
 506           <code class="sgmltag-element">table-layout</code>="<code class="sgmltag-attvalue">auto</code>" for XEP.</p></li><li><p>Added <em class="parameter"><code>index.div.title.properties</code></em>
 507           attribute-set.</p></li><li><p><em class="parameter"><code>$verbose</code></em> parameter is now
 508           passed to most elements.</p></li><li><p>Added <a href="http://www.docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> to
 509           <a href="http://www.docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">toc</code></a> in <a href="http://www.docbook.org/tdg/en/html/part.html"><code class="sgmltag-element">part</code></a>, as it is
 510           permitted by the DocBook schema/DTD.</p></li><li><p>Added backmatter elements and
 511           <a href="http://www.docbook.org/tdg/en/html/article.html"><code class="sgmltag-element">article</code></a> to <a href="http://www.docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">toc</code></a> in
 512           <a href="http://www.docbook.org/tdg/en/html/part.html"><code class="sgmltag-element">part</code></a>, since they are permitted by the
 513           DocBook schema/DTD.</p></li><li><p>Added <code class="sgmltag-attribute">mode</code>="<code class="sgmltag-attvalue">toc</code>" for
 514           <a href="http://www.docbook.org/tdg/en/html/simplesect.html"><code class="sgmltag-element">simplesect</code></a>, since it is now permitted in
 515           the <a href="http://www.docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">toc</code></a> if
 516           <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></li><li><p>Moved hard-coded properties to
 517           <em class="parameter"><code>nongraphical.admonintion.properties</code></em>
 518           and <em class="parameter"><code>graphical.admonition.properties</code></em>
 519           attribute sets.</p></li><li><p>Added support for <code class="literal">sidebar-width</code> and
 520           <code class="literal">float-type</code> processing instructions in
 521           <a href="http://www.docbook.org/tdg/en/html/sidebar.html"><code class="sgmltag-element">sidebar</code></a>.</p></li><li><p>For tables with HTML markup elements, added support
 522           for <code class="literal">dbfo bgcolor</code> PI, the attribute-sets
 523           named <em class="parameter"><code>table.properties</code></em>,
 524           <em class="parameter"><code>informaltable.properties</code></em>,
 525           <em class="parameter"><code>table.table.properties</code></em>, and
 526           <em class="parameter"><code>table.cell.padding</code></em>. Also added
 527           support for the templates named
 528           <em class="parameter"><code>table.cell.properties</code></em> and
 529           <em class="parameter"><code>table.cell.block.properties</code></em> so that
 530           tabstyles can be implemented. Also added support for tables
 531           containing only <code class="sgmltag-element">tr</code> instead of
 532           <a href="http://www.docbook.org/tdg/en/html/tbody.html"><code class="sgmltag-element">tbody</code></a> with <code class="sgmltag-element">tr</code>.</p></li><li><p>Added new paramater
 533           <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
 534           can specify characters after which a line break can occur in
 535           verbatim environments.  This parameter can be used to extend
 536           the initial set of characters which contain only space and
 537           non-breakable space.</p></li><li><p>Added <em class="parameter"><code>itemizedlist.label.markup</code></em> to enable
 538           selection of different bullet symbol. Also added several
 539           potential bullet characters, commented out by default.</p></li><li><p>Enabled all id's in XEP output for external olinking.</p></li></ul></div><p>
 540
 541       </p><div class="itemizedlist"><a name="V1680_HTML"></a><p class="title"><b>HTML</b></p><ul type="disc"><li><p>Added support for
 542           <a href="http://www.docbook.org/tdg/en/html/refdescriptor.html"><code class="sgmltag-element">refdescriptor</code></a>.</p></li><li><p>Added support for multiple <a href="http://www.docbook.org/tdg/en/html/refnamediv.html"><code class="sgmltag-element">refnamediv</code></a>s.</p></li><li><p>Added support for <code class="sgmltag-attribute">xml:id</code></p></li><li><p><a href="http://www.docbook.org/tdg/en/html/refsynopsisdiv.html"><code class="sgmltag-element">refsynopsisdiv</code></a> as a section for
 543           counting section levels</p></li></ul></div><p>
 544       </p><div class="itemizedlist"><a name="V1680_images"></a><p class="title"><b>Images</b></p><ul type="disc"><li><p>Added new SVG admonition graphics and navigation images.</p></li></ul></div><p>
 545     </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e1872"></a>Release 1.67.2</h2></div></div></div><p>This release fixes a table bug introduced in the 1.67.1
 546     release.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e1877"></a>Release 1.67.1</h2></div></div></div><p>This release includes a number of bug fixes; for details,
 547     see the <a href="WhatsNew" target="_top">WhatsNew</a> file.</p><p>The following lists provide details about API and feature changes.
 548       </p><div class="itemizedlist"><a name="V1671_FO"></a><p class="title"><b>FO</b></p><ul type="disc"><li><p>Tables: Inherited cell properties are now passed to the
 549           <code class="literal">table.cell.properties</code> template so they can
 550           be overridden by a customization.</p></li><li><p>Tables: Added support for bgcolor PI on table row
 551           element.</p></li><li><p>TOCs: Added new parameter
 552           <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
 553           <code class="literal">0</code> causes simplesect to be omitted from TOCs; to
 554           cause <a href="http://www.docbook.org/tdg/en/html/simplesect.html"><code class="sgmltag-element">simplesect</code></a> to be included in TOCs, you
 555           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
 556           <code class="literal">1</code>.Comment from Norm:
 557
 558             </p><div class="blockquote"><blockquote class="blockquote"><p><span class="emphasis"><em>Simplesect elements aren't supposed to
 559               appear in the ToC at all... The use case for simplesect
 560               is when, for example, every chapter in a book ends with
 561               "Exercises" or "For More Information" sections and you
 562               don't want those to appear in the ToC.</em></span></p></blockquote></div><p>
 563             </p></li><li><p>Sections: Reverted change that caused a variable reference
 564           to be used in a template match and rewrote code to preserve
 565           intended semantics.</p></li><li><p>Lists: Added workaround to prevent "* 0.60 + 1em" garbage in
 566           list output from PassiveTeX</p></li><li><p>Moved the literal attributes from
 567           <em class="parameter"><code>component.title</code></em> to the
 568           <em class="parameter"><code>component.title.properties</code></em> attribute-set so
 569           they can be customized.</p></li><li><p>Lists: Added <a href="http://www.docbook.org/tdg/en/html/glossdef.html"><code class="sgmltag-element">glossdef</code></a>'s first
 570           <a href="http://www.docbook.org/tdg/en/html/para.html"><code class="sgmltag-element">para</code></a> to special handling in
 571           <code class="literal">fo:list-item-body</code>.</p></li></ul></div><p>
 572
 573       </p><div class="itemizedlist"><a name="V1671_HTML"></a><p class="title"><b>HTML</b></p><ul type="disc"><li><p>TOCs: Added new parameter
 574           <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
 575           the list of <a href="#V1671_FO" title="FO">FO</a> changes for this
 576           release.</p></li><li><p>Indexing: Added new parameter
 577           <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
 578           <code class="literal">1</code>, index references will use
 579           <a href="http://www.docbook.org/tdg/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> instead of
 580           <a href="http://www.docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> when available.</p></li></ul></div><p>
 581       </p><div class="itemizedlist"><p class="title"><b>HTML Help</b></p><ul type="disc"><li><p>Added support for generating windows-1252-encoded
 582           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></li></ul></div><p>
 583       </p><div class="itemizedlist"><a name="V1671_MAN"></a><p class="title"><b>man pages</b></p><ul type="disc"><li><p>Replaced named/numeric character-entity references for
 584           non-breaking space with groff equivalent (backslash-tilde).</p></li></ul></div><p>
 585       </p><div class="itemizedlist"><a name="V1671_EXT"></a><p class="title"><b>XSL Java extensions</b></p><ul type="disc"><li><p>Saxon extensions: Added the
 586           <code class="classname">Windows1252</code> class.  It extends Saxon
 587           6.5.x with the windows-1252 character set, which is
 588           particularly useful when generating HTML Help for Western
 589           European Languages (code from
 590           <span class="firstname">Pontus</span> <span class="surname">Haglund</span> and contributed to the
 591           DocBook community by Sectra AB, Sweden).</p><p>To use:
 592           </p><div class="orderedlist"><ol type="1"><li><p>Make sure that the Saxon 6.5.x jar file and the jar file for
 593               the DocBook XSL Java extensions are in your <code class="envar">CLASSPATH</code></p></li><li><p>Create a DocBook XSL customization layer -- a file named
 594               <code class="filename">mystylesheet.xsl</code> or whatever -- that, at a
 595               minimum, contains the following:
 596               </p><pre class="screen">  &lt;xsl:stylesheet
 597     xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 598     version='1.0'&gt;
 599     &lt;xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/&gt;
 600     &lt;xsl:output method="html" encoding="WINDOWS-1252" indent="no"/&gt;
 601     &lt;xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"&gt;&lt;/xsl:param&gt;
 602     &lt;xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"&gt;&lt;/xsl:param&gt;
 603     &lt;xsl:param name="saxon.character.representation" select="'native'"&gt;&lt;/xsl:param&gt;
 604   &lt;/xsl:stylesheet&gt;</pre><p>
 605               </p><p>Invoke Saxon with the
 606               <code class="literal">encoding.windows-1252</code> Java system property set
 607               to <code class="literal">com.nwalsh.saxon.Windows1252</code>; for example
 608               </p><pre class="screen">  java \
 609     -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
 610   com.icl.saxon.StyleSheet \
 611   mydoc.xml mystylesheet.xsl</pre><p>
 612
 613               Or, for a more complete "real world" case showing other
 614               options you'll typically want to use:
 615               </p><pre class="screen">  java \
 616     -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
 617     -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \
 618     -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \
 619     -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \
 620   com.icl.saxon.StyleSheet \
 621     -x org.apache.xml.resolver.tools.ResolvingXMLReader \
 622     -y org.apache.xml.resolver.tools.ResolvingXMLReader \
 623     -r org.apache.xml.resolver.tools.CatalogResolver \
 624   mydoc.xml mystylesheet.xsl</pre><p>
 625
 626               In both cases, the "mystylesheet.xsl" file should be a
 627               DocBook customization layer containing the parameters
 628               show in step 2.</p></li></ol></div><p>
 629           </p></li><li><p>Saxon extensions: Removed Saxon 8 extensions from release package</p></li></ul></div><p>
 630     </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2044"></a>Release 1.67.0</h2></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>A number of important bug fixes, documented in <a href="WhatsNew" target="_top">WhatsNew</a>.</p></li><li><p>Added Saxon8 extensions</p></li><li><p>Enabled <code class="literal">dbfo table-width</code> on
 631     <a href="http://www.docbook.org/tdg/en/html/entrytbl.html"><code class="sgmltag-element">entrytbl</code></a> in FO output</p></li><li><p>Added support for <code class="literal">role=strong</code> on
 632     <a href="http://www.docbook.org/tdg/en/html/emphasis.html"><code class="sgmltag-element">emphasis</code></a> in FO output</p></li><li><p>Added new FO parameter
 633     <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
 634     on "intelligent" wrapping of verbatim environments.</p></li><li><p>Replaced all <code class="literal">&lt;tt&gt;&lt;/tt&gt;</code> output with
 635     <code class="literal">&lt;code&gt;&lt;/code&gt;</code></p></li><li><p>Changed <code class="literal">admon.graphic.width</code> template to a
 636     mode so that different admonitions can have different graphical
 637     widths.</p></li><li><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>
 638     parameter (use CSS instead)</p></li><li><p>Wrapped ToC
 639     <a href="http://www.docbook.org/tdg/en/html/refentrytitle.html"><code class="sgmltag-element">refentrytitle</code></a>/<a href="http://www.docbook.org/tdg/en/html/refname.html"><code class="sgmltag-element">refname</code></a> and
 640     <a href="http://www.docbook.org/tdg/en/html/refpurpose.html"><code class="sgmltag-element">refpurpose</code></a> in span with class values. This
 641     makes it possible to style them using a CSS stylesheet.</p></li><li><p>Use <code class="literal">strong/em</code> instead of
 642     <code class="literal">b/i</code> in HTML output</p></li><li><p>Added support for converting <a href="http://www.docbook.org/tdg/en/html/Emphasis.html"><code class="sgmltag-element">Emphasis</code></a> to
 643     groff italic and <a href="http://www.docbook.org/tdg/en/html/Emphasis role='bold'.html"><code class="sgmltag-element">Emphasis role='bold'</code></a> to
 644     bold. Controlled by
 645     <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
 646     documented yet using litprog system. Will do that next (planning
 647     to add some other parameter-controllable options for hyphenation
 648     and handling of line spacing).</p></li><li><p><em class="parameter"><code>callout.graphics.number.limit.xml</code></em>
 649     param: Changed the default from <code class="literal">10</code> to
 650     <code class="literal">15</code>.</p></li><li><p><em class="parameter"><code>verbatim.properties</code></em>: Added
 651     <code class="literal">hyphenate=false</code></p></li><li><p>Saxon and Xalan Text.java extensions: Added support for
 652     <code class="methodname">URIResolver()</code> on insertfile href's</p></li><li><p>Added generated <code class="filename">RELEASE-NOTES.txt</code>
 653     file.</p></li><li><p>Added <code class="filename">INSTALL</code> file (executable file for
 654     generating catalog.xml)</p></li><li><p>Removed obsolete <code class="filename">tools</code> directory from
 655     package</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2175"></a>Release 1.66.1</h2></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>A number of important bug fixes, documented in <a href="WhatsNew" target="_top">WhatsNew</a>.
 656 </p></li><li><p>
 657 Now <code class="literal">xml:base</code> attributes that are generated by an
 658 XInclude processor are resolved for image files.
 659 </p></li><li><p>
 660 Rewrote olink templates to support several new features.
 661 </p><div class="itemizedlist"><ul type="circle"><li><p>
 662 Extended full olink support to FO output.
 663 </p></li><li><p>
 664 Add support for <code class="literal">xrefstyle</code> attribute in olinks.
 665 </p></li><li><p>
 666 New parameters to support new olink features:
 667 <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>,
 668 <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>,
 669 <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>.
 670 See the reference page for each parameter for more
 671 information.</p></li></ul></div></li><li><p>
 672 Added  <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>
 673 attribute introduced in DocBook 4.3 for indexterms and index.
 674 This allows you to create multiple indices containing
 675 different categories of entries.
 676 For 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>
 677 instead.
 678 </p></li><li><p>
 679 Added new
 680 <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
 681 below a certain depth.
 682 This permits you to number major section levels and leave minor
 683 section levels unnumbered.</p></li><li><p>
 684 Added <em class="parameter"><code>footnote.sep.leader.properties</code></em> attribute set to format
 685 the line separating footnotes in printed output.
 686 </p></li><li><p>
 687 Added 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
 688 attributes.
 689 The prefix is added to whatever path is already generated by the
 690 stylesheet for each image file.</p></li><li><p>
 691 Added new attribute-sets
 692 <em class="parameter"><code>informalequation.properties</code></em>,
 693 <em class="parameter"><code>informalexample.properties</code></em>,
 694 <em class="parameter"><code>informalfigure.properties</code></em>, and <em class="parameter"><code>informaltable.properties</code></em>,
 695 so each such element type can be formatted
 696 individually if needed.
 697 </p></li><li><p>
 698 Add <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>
 699 parameter to add any  part number to chapter, appendix
 700 and other component labels when
 701 the <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.
 702 This permits you to distinguish multiple chapters with the same
 703 chapter number in cross references and the TOC.</p></li><li><p>
 704 Added <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.
 705 This parameter lets you generate separate chunk files for each LOT
 706 (list of tables, list of figures, etc.).</p></li><li><p>Added several table features:</p><div class="itemizedlist"><ul type="circle"><li><p>
 707 Added <em class="parameter"><code>table.table.properties</code></em> attribute set to add
 708 properties to the fo:table element.
 709 </p></li><li><p>
 710 Added placeholder templates named <code class="literal">table.cell.properties</code>
 711 and <code class="literal">table.cell.block.properties</code> to enable adding properties
 712 to any <code class="sgmltag-element">fo:table-cell</code> or the cell's <code class="sgmltag-element">fo:block</code>, respectively.
 713  These templates are a start for implementing table styles.</p></li></ul></div></li><li><p>
 714 Added new attribute
 715 set <em class="parameter"><code>component.title.properties</code></em> for easy modifications of
 716 component's title formatting in FO output.
 717 </p></li><li><p>
 718 Added Saxon support for an <code class="sgmltag-attribute">encoding</code> attribute on the <a href="http://www.docbook.org/tdg/en/html/textdata.html"><code class="sgmltag-element">textdata</code></a> element. Added new parameter
 719 <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
 720 <code class="sgmltag-attribute">encoding</code> attribute on
 721 <a href="http://www.docbook.org/tdg/en/html/textdata.html"><code class="sgmltag-element">textdata</code></a> is missing.
 722 </p></li><li><p>
 723 Template <code class="literal">label.this.section</code> now controls whole
 724 section label, not only sub-label which corresponds to
 725 particular label. Former behaviour was IMHO bug as it was
 726 not usable.
 727 </p></li><li><p>
 728 Formatting in titleabbrev for TOC and headers
 729 is preserved when there are no hotlink elements in the title. Formerly the title showed only the text of the title, no font changes or other markup.
 730 </p></li><li><p>
 731 Added <code class="literal">intial.page.number</code> template to set the <code class="literal">initial-page-number
 732 property</code> for page sequences in print output.
 733 Customizing 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.
 734 </p></li><li><p>
 735 Added <code class="literal">force.page.count</code> template to set the force-page-count
 736 property for page sequences in print output.
 737 This is similar to the <code class="literal">format.page.number</code> template.
 738 </p></li><li><p>
 739 Sort language for localized index sorting in <code class="filename">autoidx-ng.xsl</code> is now taken from document
 740 lang, not from system environment.
 741 </p></li><li><p>
 742 Numbering and formatting of normal
 743 and ulink footnotes (if turned on) has been unified.
 744 Now ulink footnotes are mixed in with any other footnotes.</p></li><li><p>
 745 Added support for <code class="sgmltag-element">renderas</code> attribute in section and
 746 sect1 et al.
 747 This permits you to render a given section title as if it were a different level.</p></li><li><p>
 748 Added support for <a href="http://www.docbook.org/tdg/en/html/label.html"><code class="sgmltag-element">label</code></a> attribute in footnote to manually
 749 supply the footnote mark.
 750 </p></li><li><p>
 751 Added support for DocBook 4.3 <code class="sgmltag-element">corpcredit</code> element.
 752 </p></li><li><p>
 753 Added support for a <code class="literal">dbfo keep-together</code> PI for
 754 formal objects (table, figure, example, equation, programlisting).  That permits a formal object to be kept together if it is not already, or to be broken if it
 755 is very long and the
 756 default keep-together is not appropriate.
 757 </p></li><li><p>
 758 For graphics files, made file extension matching case
 759 insensitive, and updated the list of graphics extensions.
 760 </p></li><li><p>
 761 Allow <a href="http://www.docbook.org/tdg/en/html/calloutlist.html"><code class="sgmltag-element">calloutlist</code></a> to have block content before
 762 the first callout
 763 </p></li><li><p>
 764 Added <code class="literal">dbfo-need</code> processing instruction to provide
 765 soft page breaks.
 766 </p></li><li><p>
 767 Added implementation of existing but unused
 768 <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.
 769 </p></li><li><p>
 770 Support DocBook NG <code class="sgmltag-element">tag</code> inline element.
 771 </p></li><li><p>
 772 It appears that XEP now supports Unicode characters in
 773 bookmarks. There is no further need to strip accents from
 774 characters.
 775 </p></li><li><p>
 776 Make <a href="http://www.docbook.org/tdg/en/html/segmentedlist.html"><code class="sgmltag-element">segmentedlist</code></a> HTML markup
 777 more semantic and available to CSS styles.
 778 </p></li><li><p>
 779 Added <code class="literal">user.preroot</code> placeholder template to
 780 permit xsl-stylesheet and other PIs and comments to be
 781 output before the HTML root element.
 782 </p></li><li><p>
 783 Non-chunked legalnotice now gets an &lt;a
 784 name="id"&gt; element in HTML output
 785 so it can be referenced with xref or link.
 786 </p></li><li><p>
 787 In chunked HTML output, changed <code class="literal">link rel="home"</code> to <code class="literal">rel="start"</code>,
 788 and <code class="literal">link rel="previous"</code> to <code class="literal">rel="prev"</code>, per W3C HTML 4.01
 789 spec.
 790 </p></li><li><p>
 791 Added several patches to htmlhelp from W. Borgert
 792 </p></li><li><p>
 793 Added Bosnian locale file as common/bs.xml.
 794 </p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2462"></a>Release 1.65.0</h2></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>A number of important bug fixes, documented in <a href="WhatsNew" target="_top">WhatsNew</a>.
 795 </p></li><li><p>Added a workaround to allow these stylesheets to process DocBook NG
 796 documents. (It&#8217;s a hack that pre-processes the document to strip off the
 797 namespace and then uses <code class="function">exsl:node-set</code> to process
 798 the result.)
 799 </p></li><li><p>Added alternative indexing mechanism which has better
 800 internationalization support. New indexing method allows grouping of
 801 accented letters like e, &eacute;, &euml; into the same group under letter "e". It
 802 can also treat special letters (e.g. "ch") as one character and place
 803 them in the correct position (e.g. between "h" and "i" in Czech
 804 language).</p><p>In order to use this mechanism you must create customization
 805 layer which imports some base stylesheet (like
 806 <code class="filename">fo/docbook.xsl</code>,
 807 <code class="filename">html/chunk.xsl</code>) and then includes appropriate
 808 stylesheet with new indexing code
 809 (<code class="filename">fo/autoidx-ng.xsl</code> or
 810 <code class="filename">html/autoidx-ng.xsl</code>). For example:</p><pre class="programlisting">&lt;xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 811                 version="1.0"&gt;
 812
 813 &lt;xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/&gt;
 814 &lt;xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/&gt;
 815
 816 &lt;/xsl:stylesheet&gt;</pre><p>New method is known to work with Saxon and it should also work
 817 with xsltproc 1.1.1 and later. Currently supported languages are
 818 English, Czech, German, French, Spanish and Danish.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2498"></a>Release 1.64.1</h2></div></div></div><div class="itemizedlist"><p>General bug fixes and improvements. Sorry about the failure to produce
 819 an updated release notes file for 1.62.0&#8212;1.63.2</p><ul type="disc"><li><p>In the course of fixing bug #849787, wrapping Unicode callouts
 820 with an appropriate font change in the Xalan extensions, I discovered
 821 that the Xalan APIs have changed a bit. So <code class="filename">xalan2.jar</code>
 822 will work with older Xalan 2 implementations, <code class="filename">xalan25.jar</code>
 823 works with Xalan 2.5.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2513"></a>Release 1.61.0</h2></div></div></div><div class="itemizedlist"><p>Lots of bug fixes and improvements.</p><ul type="disc"><li><p>Initial support for timestamp PI. From now you
 824   can use &lt;?dbtimestamp format="Y-m-d H:M:S"?&gt; to get current
 825   datetime in your document. Added localization support for datetime PI
 826 </p></li><li><p>Added level 6 to test for <a href="http://www.docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> depth in
 827 section.level template so that
 828 section.title.level6.properties will be used for sections
 829 that are 6 deep or deeper. This should also cause a h6 to be
 830 created in html output.
 831 </p></li><li><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
 832 </p></li><li><p>Now uses number-and-title-template for sections
 833   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.
 834 </p></li><li><p>Added missing 'english-language-name' attribute to
 835 the l10n element, and the missing 'style' attribute to the
 836 template element so the current gentext documents will
 837 validate.
 838 </p></li><li><p>Corrected several references to parameter
 839   <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 "$".
 840 </p></li><li><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
 841   Note, Warning, etc. label.
 842 </p></li><li><p>FeatReq #684561: support more XEP metadata
 843 </p></li><li><p>Added hyphenation support. Added support for <a href="http://www.docbook.org/tdg/en/html/coref.html"><code class="sgmltag-element">coref</code></a>.
 844 Added <a href="http://www.docbook.org/tdg/en/html/beginpage.html"><code class="sgmltag-element">beginpage</code></a> support. (does nothing; see TDG).
 845 </p></li><li><p>Added support for
 846 hyphenation-character, hyphenation-push-character-count, and
 847 hyphenation-remain-character-count
 848 </p></li><li><p>Added <em class="parameter"><code>root.properties</code></em>,
 849 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/ebnf.assignment.html"><em class="parameter"><code>ebnf.assignment</code></em></a>,
 850 and <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>
 851 </p></li><li><p>Support bgcolor PI in table cells; make sure
 852 rowsep and colsep don't have any effect on the last row or
 853 column
 854 </p></li><li><p>Handle <a href="http://www.docbook.org/tdg/en/html/othercredit.html"><code class="sgmltag-element">othercredit</code></a> on titlepage a little
 855 better
 856 </p></li><li><p>Applied fix from Jeff Beal that fixed the bug
 857 that put secondary page numbers on primary entries. Same
 858 with tertiary page numbers on secondary entries.
 859 </p></li><li><p>Added definition of missing variable
 860 <em class="parameter"><code>collection</code></em>.
 861 </p></li><li><p>Make <a href="http://www.docbook.org/tdg/en/html/footnote.html"><code class="sgmltag-element">footnote</code></a> formatting 'normal' even when it
 862 occurs in a context that has special formatting
 863 </p></li><li><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
 864 blank, but it cannot open the specified file.
 865 </p></li><li><p>Pick up the frame attribute on <a href="http://www.docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> and
 866 <a href="http://www.docbook.org/tdg/en/html/informaltable.html"><code class="sgmltag-element">informaltable</code></a>.
 867 </p></li><li><p><a href="http://www.docbook.org/tdg/en/html/indexdiv.html"><code class="sgmltag-element">indexdiv</code></a>/<a href="http://www.docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a>
 868 in non-autogenerated indexes are
 869 now picked up.
 870 </p></li><li><p>Removed (unused)
 871 component.title.properties
 872 </p></li><li><p>Move IDs from
 873 page-sequences down to titlepage blocks
 874 </p></li><li><p>Use
 875 proportional-column-width(1) on more <a href="http://www.docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>s.
 876 </p><p>Use proportional-column-width() for
 877 header/footer tables; suppress relative-align when when
 878 using FOP
 879 </p></li><li><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
 880 firstterms; don't output gl. prefix on glossterm links
 881 </p></li><li><p>Generate Part ToCs
 882 </p></li><li><p>Support <a href="http://www.docbook.org/tdg/en/html/glossary.html"><code class="sgmltag-element">glossary</code></a>, <a href="http://www.docbook.org/tdg/en/html/bibliography.html"><code class="sgmltag-element">bibliography</code></a>,
 883 and <a href="http://www.docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a> in component ToCs.
 884 </p></li><li><p>Refactored chunking code so that
 885 customization of chunk algorithm and chunk elements is more
 886 practical
 887 </p></li><li><p>Support <a href="http://www.docbook.org/tdg/en/html/textobject.html"><code class="sgmltag-element">textobject</code></a>/<a href="http://www.docbook.org/tdg/en/html/phrase.html"><code class="sgmltag-element">phrase</code></a>
 888 on <a href="http://www.docbook.org/tdg/en/html/inlinemediaobject.html"><code class="sgmltag-element">inlinemediaobject</code></a>.
 889 </p></li><li><p>Support 'start' PI on ordered lists
 890 </p></li><li><p>Fixed test of $toc PI to turn on qandaset TOC.
 891 </p></li><li><p>Added process.chunk.footnotes to sect2 through
 892 5 to fix bug of missing footnotes when chunk level greater
 893 than 1.
 894 </p></li><li><p>Added
 895 paramater <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
 896 as requested by PHP-DOC group.
 897 </p></li><li><p>Exempted <a href="http://www.docbook.org/tdg/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> from preamble processing in
 898 lists, and fixed variablelist preamble code to use the same
 899 syntax as the other lists.
 900 </p></li><li><p>Added support for elements between variablelist
 901 and first varlistentry since DocBook 4.2 supports that now.
 902 </p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2703"></a>Release 1.60.1</h2></div></div></div><div class="itemizedlist"><p>Lots of bug fixes.</p><ul type="disc"><li><p>The format of the <code class="filename">titlepage.templates.xml</code> files and
 903 the stylesheet that transforms them have been significantly changed. All of the
 904 attributes used to control the templates are now namespace qualified. So what
 905 used to be:</p><pre class="programlisting">&lt;t:titlepage element="article" wrapper="fo:block"&gt;</pre><p>is now:</p><pre class="programlisting">&lt;t:titlepage t:element="article" t:wrapper="fo:block"&gt;</pre><p>Attributes from other namespaces (including those that are unqualified) are
 906 now copied directly through. In practice, this means that the names that used
 907 to be &#8220;<span class="quote">fo:</span>&#8221; qualified:</p><pre class="programlisting">&lt;title named-template="component.title"
 908        param:node="ancestor-or-self::article[1]"
 909        fo:text-align="center"
 910        fo:keep-with-next="always"
 911        fo:font-size="&amp;hsize5;"
 912        fo:font-weight="bold"
 913        fo:font-family="{$title.font.family}"/&gt;</pre><p>are now unqualified:</p><pre class="programlisting">&lt;title t:named-template="component.title"
 914        param:node="ancestor-or-self::article[1]"
 915        text-align="center"
 916        keep-with-next="always"
 917        font-size="&amp;hsize5;"
 918        font-weight="bold"
 919        font-family="{$title.font.family}"/&gt;</pre><p>The <code class="sgmltag-element">t:titlepage</code> and <code class="sgmltag-element">t:titlepage-content</code>
 920 elements both generate wrappers now. And unqualified attributes on those elements
 921 are passed through. This means that you can now make the title font apply to
 922 ane entire titlepage and make the entire &#8220;<span class="quote">recto</span>&#8221;
 923 titlepage centered by specifying the font and alignment on the those elements:</p><pre class="programlisting">&lt;t:titlepage t:element="article" t:wrapper="fo:block"
 924              font-family="{$title.font.family}"&gt;
 925
 926   &lt;t:titlepage-content t:side="recto"
 927              text-align="center"&gt;</pre></li><li><p>Support use of <a href="http://www.docbook.org/tdg/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> in running
 928 headers and footers.
 929 </p></li><li><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>
 930 parameter to enable number/title cross references even when the
 931 default would
 932 be just the number.
 933 </p></li><li><p>Generate <a href="http://www.docbook.org/tdg/en/html/part.html"><code class="sgmltag-element">part</code></a> ToCs if they're requested.
 934 </p></li><li><p>Use proportional-column-width() in header/footer tables.
 935 </p></li><li><p>Handle alignment correctly when <a href="http://www.docbook.org/tdg/en/html/screenshot.html"><code class="sgmltag-element">screenshot</code></a>
 936 wraps a graphic in a <a href="http://www.docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a>.
 937 </p></li><li><p>Format <a href="http://www.docbook.org/tdg/en/html/chapter.html"><code class="sgmltag-element">chapter</code></a> and <a href="http://www.docbook.org/tdg/en/html/appendix.html"><code class="sgmltag-element">appendix</code></a>
 938 cross references consistently.
 939 </p></li><li><p>Attempt to support tables with multiple <a href="http://www.docbook.org/tdg/en/html/tgroup.html"><code class="sgmltag-element">tgroup</code></a>s
 940 in FO.
 941 </p></li><li><p>Output <code class="sgmltag-element">fo:table-columns</code> in
 942 <a href="http://www.docbook.org/tdg/en/html/simplelist.html"><code class="sgmltag-element">simplelist</code></a> tables.
 943 </p></li><li><p>Use <code class="filename">titlepage.templates.xml</code> for
 944 <a href="http://www.docbook.org/tdg/en/html/indexdiv.html"><code class="sgmltag-element">indexdiv</code></a> and <a href="http://www.docbook.org/tdg/en/html/glossdiv.html"><code class="sgmltag-element">glossdiv</code></a> formatting.
 945 </p></li><li><p>Improve support for new bibliography elements.
 946 </p></li><li><p>Added
 947 <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>,
 948 <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>,
 949 <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
 950 <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
 951 footnote markers.
 952 </p></li><li><p>Added <code class="sgmltag-element">glossentry.show.acronyms</code>.
 953 </p></li><li><p>Suppress the draft-mode page masters when
 954 <em class="parameter"><code>draft-mode</code></em> is &#8220;<span class="quote">no</span>&#8221;.
 955 </p></li><li><p>Make blank pages verso not recto. D'Oh!
 956 </p></li><li><p>Improved formatting of <a href="http://www.docbook.org/tdg/en/html/ulink.html"><code class="sgmltag-element">ulink</code></a> footnotes.
 957 </p></li><li><p>Fixed bugs in graphic width/height calculations.
 958 </p></li><li><p>Added class attributes to inline elements.
 959 </p></li><li><p>Don't add &#8220;<span class="quote">.html</span>&#8221; to the filenames identified
 960 with the &#8220;<span class="quote">dbhtml</span>&#8221; PI.
 961 </p></li><li><p>Don't force a ToC when sections contain <a href="http://www.docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>s.
 962 </p></li><li><p>Make section title sizes a function of the
 963 <em class="parameter"><code>body.master.size</code></em>.
 964 </p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2880"></a>Release 1.59.2</h2></div></div></div><div class="itemizedlist"><p>The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail.
 965 </p><ul type="disc"><li><p>Removed the region-name from the region-body of blank pages. There's
 966 no reason to give the body of blank pages a unique name and doing so causes
 967 a mismatch that FOP detects.
 968 </p></li><li><p>Output IDs for the first paragraphs in listitems.
 969 </p></li><li><p>Fixed some small bugs in the handling of page numbers in double-sided mode.
 970 </p></li><li><p>Attempt to prevent duplicated IDs from being produced when
 971 <code class="sgmltag-attribute">endterm</code> on <a href="http://www.docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a> points
 972 to something with nested structure.
 973 </p></li><li><p>Fix aligment problems in <a href="http://www.docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a>s.
 974 </p></li><li><p>Output the type attribute on unordered lists (UL) in HTML only if
 975 the css.decoration parameter is true.
 976 </p></li><li><p>Calculate the font size in formal.title.properties so that it's 1.2 times
 977 the base font size, not a fixed "12pt".
 978 </p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2916"></a>Release 1.59.1</h2></div></div></div><div class="itemizedlist"><p>The 1.59.1 fixes a few bugs.
 979 </p><ul type="disc"><li><p>Added Bulgarian localization.
 980 </p></li><li><p>Indexing improvements; localize book indexes to books but allow setindex
 981 to index an entire set.
 982 </p></li><li><p>The default value for rowsep and colsep is now "1" as per CALS.
 983 </p></li><li><p>Added support for <a href="http://www.docbook.org/tdg/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> (use them for cross
 984 references).
 985 </p></li><li><p>Improvements to <a href="http://www.docbook.org/tdg/en/html/mediaobject.html"><code class="sgmltag-element">mediaobject</code></a> for selecting print vs. online
 986 images.
 987 </p></li><li><p>Added seperate property sets for <a href="http://www.docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a>s,
 988 <a href="http://www.docbook.org/tdg/en/html/example.html"><code class="sgmltag-element">example</code></a>s, <a href="http://www.docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a>s, <code class="sgmltag-element">tables</code>s,
 989 and <a href="http://www.docbook.org/tdg/en/html/procedure.html"><code class="sgmltag-element">procedure</code></a>s.
 990 </p></li><li><p>Make <a href="http://www.docbook.org/tdg/en/html/lineannotation.html"><code class="sgmltag-element">lineannotation</code></a>s italic.
 991 </p></li><li><p>Support <code class="sgmltag-attribute">xrefstyle</code> attribute.
 992 </p></li><li><p>Make <code class="sgmltag-attribute">endterm</code> on
 993 <a href="http://www.docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a> higher priority than
 994 <code class="sgmltag-attribute">xreflabel</code> target.
 995 </p></li><li><p>Glossary formatting improvements.
 996 </p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2988"></a>Release 1.58.0</h2></div></div></div><div class="itemizedlist"><p>The 1.58.0 adds some initial support for extensions in xsltproc, adds
 997 a few features, and fixes bugs.
 998 </p><ul type="disc"><li><p>This release contains the first attempt at extension support for xsltproc.
 999 The only extension available to date is the one that adjusts table column widths.
1000 Run <code class="filename">extensions/xsltproc/python/xslt.py</code>.
1001 </p></li><li><p>Fixed bugs in calculation of adjusted column widths to correct for rounding
1002 errors.
1003 </p></li><li><p>Support nested <a href="http://www.docbook.org/tdg/en/html/refsection.html"><code class="sgmltag-element">refsection</code></a> elements correctly.
1004 </p></li><li><p>Reworked <code class="literal">gentext.template</code> to take context into consideration.
1005 The name of elements in localization files is now an xpath-like context list, not
1006 just a simple name.
1007 </p></li><li><p>Made some improvements to bibliography formatting.
1008 </p></li><li><p>Improved graphical formatting of admonitions.
1009 </p></li><li><p>Added support for <a href="http://www.docbook.org/tdg/en/html/entrytbl.html"><code class="sgmltag-element">entrytbl</code></a>.
1010 </p></li><li><p>Support spanning index terms.
1011 </p></li><li><p>Support <a href="http://www.docbook.org/tdg/en/html/bibliosource.html"><code class="sgmltag-element">bibliosource</code></a>.
1012 </p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e3036"></a>Release 1.57.0</h2></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>The 1.57.0 release wasn't documented here. Oops.
1013 </p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e3043"></a>Release 1.56.0</h2></div></div></div><div class="itemizedlist"><p>The 1.56.0 release fixes bugs.
1014 </p><ul type="disc"><li><p>Reworked chunking. <span class="emphasis"><em>This will break all existing customizations
1015 layers that change the chunking algorithm.</em></span> If you're customizing chunking,
1016 look at the new &#8220;<span class="quote">content</span>&#8221; parameter that's passed to
1017 <code class="literal">process-chunk-element</code> and friends.
1018 </p></li><li><p>Support continued and inherited numeration in <a href="http://www.docbook.org/tdg/en/html/orderedlist.html"><code class="sgmltag-element">orderedlist</code></a>
1019 formatting for FOs.
1020 </p></li><li><p>Added Thai localization.
1021 </p></li><li><p>Tweaked stylesheet documentation stylesheets to link to TDG and
1022 the parameter references.
1023 </p></li><li><p>Allow title on tables of contents ("Table of Contents") to be optional.
1024 Added 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>.
1025 Support tables of contents on sections.
1026 </p></li><li><p>Made separate parameters for table borders and table cell borders:
1027 <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>,
1028 <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>,
1029 <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>,
1030 <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>,
1031 <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
1032 <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>.
1033 </p></li><li><p>Suppress formatting of &#8220;<span class="quote">endofrange</span>&#8221; <a href="http://www.docbook.org/tdg/en/html/indexterm.html"><code class="sgmltag-element">indexterm</code></a>s.
1034 This is only half-right. They should generate a range, but I haven't figured out how
1035 to do that yet.
1036 </p></li><li><p>Support <a href="http://www.docbook.org/tdg/en/html/revdescription.html"><code class="sgmltag-element">revdescription</code></a>. (Bug #582192)
1037 </p></li><li><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
1038 floats. (Bug #497603)
1039 </p></li><li><p>Fixed formatting of <a href="http://www.docbook.org/tdg/en/html/sbr.html"><code class="sgmltag-element">sbr</code></a> in FOs.
1040 </p></li><li><p>Added context to the &#8220;<span class="quote">missing template</span>&#8221; error message.
1041 </p></li><li><p>Process <a href="http://www.docbook.org/tdg/en/html/arg.html"><code class="sgmltag-element">arg</code></a> correctly in a <a href="http://www.docbook.org/tdg/en/html/group.html"><code class="sgmltag-element">group</code></a>.
1042 (Bug #605150)
1043 </p></li><li><p>Removed 'keep-with-next' from <em class="parameter"><code>formal.title.properties</code></em>
1044 attribute set now that the stylesheets support the option of putting
1045 such titles below the object. Now the $placement value determines if
1046 'keep-with-next' or 'keep-with-previous' is used in the title block.
1047 </p></li><li><p>Wrap &#8220;<span class="quote">url()</span>&#8221; around external-destinations when appropriate.
1048 </p></li><li><p>Fixed typo in compact list spacing. (Bug #615464)
1049 </p></li><li><p>Removed spurious hash in anchor name. (Bug #617717)
1050 </p></li><li><p>Address is now displayed verbatim on title pages. (Bug #618600)
1051 </p></li><li><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
1052 supported.
1053 </p></li><li><p>Improved effectiveness of HTML cleanup by increasing the number
1054 of places where it is used. Improve use of HTML cleanup in XHTML stylesheets.
1055 </p></li><li><p>Support table of contents for <a href="http://www.docbook.org/tdg/en/html/appendix.html"><code class="sgmltag-element">appendix</code></a> in
1056 <a href="http://www.docbook.org/tdg/en/html/article.html"><code class="sgmltag-element">article</code></a>. (Bug #596599)
1057 </p></li><li><p>Don't duplicate footnotes in <a href="http://www.docbook.org/tdg/en/html/bibliography.html"><code class="sgmltag-element">bibliography</code></a>s and
1058 <a href="http://www.docbook.org/tdg/en/html/glossary.html"><code class="sgmltag-element">glossary</code></a>s. (Bug #583282)
1059 </p></li><li><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)
1060 </p></li><li><p>Totally reworked <a href="http://www.docbook.org/tdg/en/html/funcsynopsis.html"><code class="sgmltag-element">funcsynopsis</code></a> code; it now
1061 supports a 'tabular' presentation style for 'wide' prototypes; see
1062 <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
1063 right now, I think, FO support, uh, real soon now.)
1064 </p></li><li><p>Reworked support for difference marking; toned down the colors a bit
1065 and added a &#8220;<span class="quote">system.head.content</span>&#8221; template so that the diff CSS
1066 wasn't overriding &#8220;<span class="quote">user.head.content</span>&#8221;. (Bug #610660)
1067 </p></li><li><p>Added call to the &#8220;<span class="quote">*.head.content</span>&#8221; elements when writing
1068 out long description chunks.
1069 </p></li><li><p>Make sure <a href="http://www.docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a> link is correct even when
1070 chunking 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>.
1071 </p></li><li><p>Use CSS to set viewport characteristics if
1072 <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
1073 graphic a block element; make figure <a href="http://www.docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a>s the
1074 default alt
1075 text for images in a <a href="http://www.docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a>.</p></li><li><p>Added space-after to <em class="parameter"><code>list.block.spacing</code></em>.
1076 </p></li><li><p>Reworked section.level template to give &#8220;<span class="quote">correct</span>&#8221; answer
1077 instead of being off by one.
1078 </p></li><li><p>When processing tables, use the <code class="sgmltag-attribute">tabstyle</code>
1079 attribute as the division class.
1080 </p></li><li><p>Fixed bug in <code class="filename">html2xhtml.xsl</code> that was causing the
1081 XHTML chunker to output HTML instead of XHTML.
1082 </p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e3265"></a>Older releases</h2></div></div></div><p>To view the release notes for older releases, see <a href="http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml" target="_top">http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml</a>. Be
1083   aware that there were no release notes for releases prior to the
1084   1.50.0 release.</p></div><div class="section" 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><p>DocBook Project &#8220;<span class="quote">dot zero</span>&#8221; releases should be
1085     considered <span class="emphasis"><em>experimental</em></span> and are always
1086     followed by stable &#8220;<span class="quote">dot one</span>&#8221; releases, usually within
1087     two or three weeks. Please help to ensure the stability of
1088     &#8220;<span class="quote">dot one</span>&#8221; releases by carefully testing each
1089     &#8220;<span class="quote">dot zero</span>&#8221; release and reporting back about any
1090     problems you find. </p><p>It is not recommended that you use a &#8220;<span class="quote">dot zero</span>&#8221;
1091     release in a production system, or package it for an OS
1092     distro. Instead, you should wait for the &#8220;<span class="quote">dot one</span>&#8221;
1093     version.</p></div></div></body></html>