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 “<span class="quote">dot zero</span>” 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
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 “<span class="quote">informal</span>” procedure (meaning
37 that it is not added to any generated “<span class="quote">list of
38 procedures</span>” 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 “<span class="quote">choice separator</span>” (for
43 example, “<span class="quote">and</span>” or “<span class="quote">or</span>”) 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"><?dbchoice choice="foo"?></code> as a
48 child of the list. For example:
49 </p><pre class="literallayout"> <para>Choose from
50 ONE and ONLY ONE of the following:
51 <simplelist type="inline">
52 <?dbchoice choice="or" ?>
53 <member>A</member>
54 <member>B</member>
55 <member>C</member>.</simplelist></para></pre><p>
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 “<span class="quote">or</span>”, you can put in a literal string to
63 be used; example for French: <code class="sgmltag-pi"><?dbchoice choice="ou"></code>. That is, use
64 “<span class="quote">ou</span>” instead of “<span class="quote">or</span>”.</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"><rx:meta-field creator="$VERSION"/></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"><?img.src.path?></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
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 “<span class="quote">Hyphenation</span>” 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 “<span class="quote">string substitution map</span>” for doing
179 “<span class="quote">essential</span>” replacements, and a
180 “<span class="quote">character map</span>” 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 &#8220; and
183 &#8221; showing up in output, and greatly expands the
184 ability of the stylesheets to generate “<span class="quote">good</span>” 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 “<span class="quote">Mathematical Operators</span>” 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 “<span class="quote">Dingbat</span>” block
207 (141 characters in that that have roff equivalents or that
208 can at least be “<span class="quote">degraded</span>” 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 “<span class="quote">maps</span>”: a
212 “<span class="quote">substitution map</span>” and a “<span class="quote">character
213 map</span>” (the latter in a format compliant with the XSLT
214 2.0 spec and therefore completely “<span class="quote">forward
215 compatible</span>” 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 “<span class="quote">character map</span>” 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 “<span class="quote">full</span>” 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 “<span class="quote">standard</span>” 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 “<span class="quote">the works</span>” -- 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 “<span class="quote">title line</span>”).</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 “<span class="quote">title
271 line</span>” 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) <-- header
275 GTK+ 1.2 2003-10-20 gtk-options(7) <-- footer
277 svgalib(7) Svgalib User Manual svgalib(7) <-- header
278 Svgalib 1.4.1 16 December 1999 svgalib(7) <-- 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) <- header
282 extra2 extra1 title(section) <- 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) <- page header
285 source date title(section) <- 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 “<span class="quote">minimal</span>”
288 example). </p><pre class="programlisting">
291 <date>2003-10-20</date> <a name="V1690_date-co"></a><img src="images/callouts/1.png" alt="1" border="0">
294 <refentrytitle>gtk-options</refentrytitle> <a name="V1690_title-co"></a><img src="images/callouts/2.png" alt="2" border="0">
295 <manvolnum>7</manvolnum> <a name="V1690_manvolnum-co"></a><img src="images/callouts/3.png" alt="3" border="0">
296 <refmiscinfo class="source-name">GTK+</refmiscinfo> <a name="V1690_source-name-co"></a><img src="images/callouts/4.png" alt="4" border="0">
297 <refmiscinfo class="version">1.2</refmiscinfo> <a name="V1690_version-co"></a><img src="images/callouts/5.png" alt="5" border="0">
298 <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> <a name="V1690_manual-co"></a><img src="images/callouts/6.png" alt="6" border="0">
301 <refname>gtk-options</refname>
302 <refpurpose>Standard Command Line Options for GTK+ Programs</refpurpose>
305 <title>Description</title>
306 <para>This manual page describes the command line options, which
307 are common to all GTK+ based applications.</para>
309 </refentry></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 “<span class="quote">date</span>” 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 “<span class="quote">title</span>” 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 “<span class="quote">section</span>” 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 “<span class="quote">source name</span>” 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 “<span class="quote">version</span>” 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 “<span class="quote">manual</span>” 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 “<span class="quote">good</span>” 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> “<span class="quote">info</span>” child
316 (whatever its name), and
317 <em class="replaceable"><code>parentinfo</code></em> is the
318 “<span class="quote">info</span>” child of its parent (again, whatever
320 </p><div class="variablelist"><dl><dt><span class="term">extra1 field (date)</span></dt><dd><p>Content of the “<span class="quote">extra1</span>” 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 “<span class="quote">the date of the last revision</span>”.</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 “<span class="quote">long
333 format</span>” 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 “<span class="quote">extra2</span>” 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 “<span class="quote">the source of the command</span>”, 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 “<span class="quote">source</span>”
349 field. So, it looks like what we have is a two-part
351 <em class="replaceable"><code>Name</code></em> <em class="replaceable"><code>Version</code></em>,
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>
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 “<span class="quote">extra3</span>” 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 “<span class="quote">extra2</span>” content, some
380 don't. If a particular man page has it, it is most
381 often “<span class="quote">context</span>” 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 “<span class="quote">extra3</span>” 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 rand (void)</code>; now:
422 <code class="literal">float 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"><simplelist type="inline"</code> instance
426 is now rendered as a comma-separated list (also with an
427 optional localized “<span class="quote">and</span>” or “<span class="quote">or</span>” 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 “<span class="quote">sticky</span>” 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 “<span class="quote">everything in
447 funcsynopsis bold</span>” 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 “<span class="quote">curly</span>” 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 (&#96;) and apostrophe (&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 “<span class="quote">subheading dividers</span>” 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>
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:
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>
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"> <xsl:stylesheet
597 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
599 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/>
600 <xsl:output method="html" encoding="WINDOWS-1252" indent="no"/>
601 <xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"></xsl:param>
602 <xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"></xsl:param>
603 <xsl:param name="saxon.character.representation" select="'native'"></xsl:param>
604 </xsl:stylesheet></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>
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>
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"><tt></tt></code> output with
635 <code class="literal"><code></code></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
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>.
657 Now <code class="literal">xml:base</code> attributes that are generated by an
658 XInclude processor are resolved for image files.
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.
664 Add support for <code class="literal">xrefstyle</code> attribute in olinks.
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>
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.
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
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.
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.
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>
715 set <em class="parameter"><code>component.title.properties</code></em> for easy modifications of
716 component's title formatting in FO output.
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.
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
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.
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.
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.
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.
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
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.
751 Added support for DocBook 4.3 <code class="sgmltag-element">corpcredit</code> element.
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
756 default keep-together is not appropriate.
758 For graphics files, made file extension matching case
759 insensitive, and updated the list of graphics extensions.
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
764 Added <code class="literal">dbfo-need</code> processing instruction to provide
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.
770 Support DocBook NG <code class="sgmltag-element">tag</code> inline element.
772 It appears that XEP now supports Unicode characters in
773 bookmarks. There is no further need to strip accents from
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.
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.
783 Non-chunked legalnotice now gets an <a
784 name="id"> element in HTML output
785 so it can be referenced with xref or link.
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
791 Added several patches to htmlhelp from W. Borgert
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’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
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, é, ë 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"><xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
813 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/>
814 <xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/>
816 </xsl:stylesheet></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—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 <?dbtimestamp format="Y-m-d H:M:S"?> 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
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
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
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
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
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
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
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
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"><t:titlepage element="article" wrapper="fo:block"></pre><p>is now:</p><pre class="programlisting"><t:titlepage t:element="article" t:wrapper="fo:block"></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 “<span class="quote">fo:</span>” qualified:</p><pre class="programlisting"><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="&hsize5;"
912 fo:font-weight="bold"
913 fo:font-family="{$title.font.family}"/></pre><p>are now unqualified:</p><pre class="programlisting"><title t:named-template="component.title"
914 param:node="ancestor-or-self::article[1]"
916 keep-with-next="always"
917 font-size="&hsize5;"
919 font-family="{$title.font.family}"/></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 “<span class="quote">recto</span>”
923 titlepage centered by specifying the font and alignment on the those elements:</p><pre class="programlisting"><t:titlepage t:element="article" t:wrapper="fo:block"
924 font-family="{$title.font.family}">
926 <t:titlepage-content t:side="recto"
927 text-align="center"></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
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
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
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
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 “<span class="quote">no</span>”.
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 “<span class="quote">.html</span>” to the filenames identified
960 with the “<span class="quote">dbhtml</span>” 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
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
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
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
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 “<span class="quote">content</span>” 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>
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 “<span class="quote">endofrange</span>” <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
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 “<span class="quote">missing template</span>” 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>.
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 “<span class="quote">url()</span>” 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
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 “<span class="quote">system.head.content</span>” template so that the diff CSS
1066 wasn't overriding “<span class="quote">user.head.content</span>”. (Bug #610660)
1067 </p></li><li><p>Added call to the “<span class="quote">*.head.content</span>” 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
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 “<span class="quote">correct</span>” 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 “<span class="quote">dot zero</span>” releases should be
1085 considered <span class="emphasis"><em>experimental</em></span> and are always
1086 followed by stable “<span class="quote">dot one</span>” releases, usually within
1087 two or three weeks. Please help to ensure the stability of
1088 “<span class="quote">dot one</span>” releases by carefully testing each
1089 “<span class="quote">dot zero</span>” release and reporting back about any
1090 problems you find. </p><p>It is not recommended that you use a “<span class="quote">dot zero</span>”
1091 release in a production system, or package it for an OS
1092 distro. Instead, you should wait for the “<span class="quote">dot one</span>”
1093 version.</p></div></div></body></html>