<article>
<articleinfo>
<title>DocBook XSL Stylesheet Release Notes</title>
-<pubdate>02 September 2004</pubdate>
+<pubdate>10 September 2004</pubdate>
<releaseinfo role="cvs">$Id: RELEASE-NOTES.xml,v 1.21 2004/02/27
18:17:27 nwalsh Exp $ </releaseinfo>
<corpauthor>DocBook Open Repository Team</corpauthor>
</listitem>
<listitem>
<para>
-Add <parameter>component.label.includes.part.label</parameter>
-parameter to add part number to chapter, appendix
-and other component labels when
-<parameter>label.from.part</parameter> parameter is nonzero.
+Now <literal>xml:base</literal> attributes that are generated by an
+XInclude processor are resolved for image files.
</para>
</listitem>
<listitem>
<para>
-Now preserves formatting in titleabbrev for TOC and headers
-when there are no link elements in the title.
+Rewrote olink templates to support several new features.
+</para>
+<itemizedlist>
+<listitem>
+<para>
+Extended full olink support to FO output.
</para>
</listitem>
<listitem>
<para>
-Now <literal>xml:base</literal> attributes that are generated by an
-XInclude processor are resolved for image files.
+Add support for <literal>xrefstyle</literal> attribute in olinks.
+</para>
+</listitem>
+<listitem>
+<para>
+New parameters to support new olink features:
+<parameter>insert.olink.page.number</parameter>, <parameter>insert.olink.pdf.frag</parameter>,
+<parameter>olink.debug</parameter>, <parameter>olink.lang.fallback.sequence</parameter>, <parameter>olink.properties</parameter>,
+<parameter>prefer.internal.olink</parameter>.
+See the reference page for each parameter for more
+information.</para>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<para>
+Added <parameter>index.on.type</parameter> parameter for new <sgmltag
+class="attribute">type</sgmltag>
+attribute introduced in DocBook 4.3 for indexterms and index.
+This allows you to create multiple indices containing
+different categories of entries.
+For users of 4.2 and earlier, you can use the new parameter <parameter>index.on.role</parameter>
+instead.
</para>
</listitem>
<listitem>
Added new
<parameter>section.autolabel.max.depth</parameter> parameter to turn off section numbering
below a certain depth.
+This permits you to number major section levels and leave minor
+section levels unnumbered.</para>
+</listitem>
+<listitem>
+<para>
+Added <parameter>footnote.sep.leader.properties</parameter> attribute set to format
+the line separating footnotes in printed output.
</para>
</listitem>
<listitem>
<para>
-Rewrote olink templates to support several new features.
+Added parameter <parameter>img.src.path</parameter> as a prefix to HTML img src
+attributes.
+The prefix is added to whatever path is already generated by the
+stylesheet for each image file.</para>
+</listitem>
+<listitem>
+<para>
+Added new attribute-sets
+<parameter>informalequation.properties</parameter>,
+<parameter>informalexample.properties</parameter>,
+<parameter>informalfigure.properties</parameter>, and <parameter>informaltable.properties</parameter>,
+so each such element type can be formatted
+individually if needed.
</para>
+</listitem>
+<listitem>
+<para>
+Add <parameter>component.label.includes.part.label</parameter>
+parameter to add any part number to chapter, appendix
+and other component labels when
+the <parameter>label.from.part</parameter> parameter is nonzero.
+This permits you to distinguish multiple chapters with the same
+chapter number in cross references and the TOC.</para>
+</listitem>
+<listitem>
+<para>
+Added <parameter>chunk.separate.lots</parameter> parameter for HTML output.
+This parameter lets you generate separate chunk files for each LOT
+(list of tables, list of figures, etc.).</para>
+</listitem>
+<listitem>
+<para>Added several table features:</para>
<itemizedlist>
<listitem>
<para>
-Extended full olink support to FO output.
+Added <parameter>table.table.properties</parameter> attribute set to add
+properties to the fo:table element.
</para>
</listitem>
<listitem>
<para>
-Add support for <literal>xrefstyle</literal> attribute in olinks.
-</para>
+Added placeholder templates named <literal>table.cell.properties</literal>
+and <literal>table.cell.block.properties</literal> to enable adding properties
+to any <sgmltag>fo:table-cell</sgmltag> or the cell's <sgmltag>fo:block</sgmltag>, respectively.
+ These templates are a start for implementing table styles.</para>
+</listitem>
+</itemizedlist>
</listitem>
<listitem>
<para>
-New parameters to support new olink features:
-<parameter>insert.olink.page.number</parameter>, <parameter>insert.olink.pdf.frag</parameter>,
-<parameter>olink.debug</parameter>, <parameter>olink.doctitle</parameter>,
-<parameter>olink.lang.fallback.sequence</parameter>, <parameter>olink.properties</parameter>,
-<parameter>prefer.internal.olink</parameter>.
+Added new attribute
+set <parameter>component.title.properties</parameter> for easy modifications of
+component's title formatting in FO output.
</para>
</listitem>
-</itemizedlist>
+<listitem>
+<para>
+Added Saxon support for an <sgmltag class="attribute">encoding</sgmltag> attribute on the <sgmltag class="element">textdata</sgmltag> element. Added new parameter
+<parameter>textdata.default.encoding</parameter> which specifies encoding when
+<sgmltag class="attribute">encoding</sgmltag> attribute on
+<sgmltag class="element">textdata</sgmltag> is missing.
+</para>
</listitem>
<listitem>
<para>
</listitem>
<listitem>
<para>
+Formatting in titleabbrev for TOC and headers
+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.
+</para>
+</listitem>
+<listitem>
+<para>
Added <literal>intial.page.number</literal> template to set the <literal>initial-page-number
property</literal> for page sequences in print output.
-This is similar to the <literal>format.page.number</literal> template.
+Customizing this template lets you change when page numbering restarts. This is similar to the <literal>format.page.number</literal> template that lets you change how the page number formatting changes in the output.
</para>
</listitem>
<listitem>
</listitem>
<listitem>
<para>
-Sort language for <filename>autoidx-ng.xsl</filename> is now taken from document
+Sort language for localized index sorting in <filename>autoidx-ng.xsl</filename> is now taken from document
lang, not from system environment.
</para>
</listitem>
<para>
Numbering and formatting of normal
and ulink footnotes (if turned on) has been unified.
-</para>
-</listitem>
-<listitem>
-<para>
-Added <parameter>footnote.sep.leader.properties</parameter> attribute set to format
-the line separating footnotes in printed output.
-</para>
-</listitem>
+Now ulink footnotes are mixed in with any other footnotes.</para>
+</listitem>
<listitem>
<para>
Added support for <sgmltag>renderas</sgmltag> attribute in section and
sect1 et al.
-</para>
+This permits you to render a given section title as if it were a different level.</para>
</listitem>
<listitem>
<para>
<listitem>
<para>
Added support for a <literal>dbfo keep-together</literal> PI for
-formal objects. That permits one to be broken if it
+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
is very long and the
default keep-together is not appropriate.
</para>
Added <literal>dbfo-need</literal> processing instruction to provide
soft page breaks.
</para>
-</listitem>
-<listitem>
-<para>
-Added support for <parameter>index.on.type</parameter> parameter for new 'type'
-attribute introduced in DocBook 4.3 for indexterm and index.
-This allows you to create multiple indices containing
-different categories of entries.
-For users of 4.2 and earlier, you can use <parameter>index.on.role</parameter>
-instead.
-</para>
-</listitem>
+</listitem>
<listitem>
<para>
Added implementation of existing but unused
<para>
Support DocBook NG <sgmltag>tag</sgmltag> inline element.
</para>
-</listitem>
-<listitem>
-<para>Added several table features:</para>
-<itemizedlist>
-<listitem>
-<para>
-Added <parameter>table.table.properties</parameter> attribute set to add
-properties to the fo:table element.
-</para>
-</listitem>
-<listitem>
-<para>
-Added placeholder templates named <literal>table.cell.properties</literal>
-and <literal>table.cell.block.properties</literal> to enable adding properties
-to any <sgmltag>fo:table-cell</sgmltag> or the cell's <sgmltag>fo:block</sgmltag>, respectively.
-</para>
-</listitem>
-</itemizedlist>
-</listitem>
-<listitem>
-<para>
-Added new attribute
-set <parameter>component.title.properties</parameter> for easy modifications of
-component's title formatting in FO output.
-</para>
-</listitem>
-<listitem>
-<para>
-Added Saxon support for
-encoding attribute on textdata. Added new parameter
-<parameter>textdata.default.encoding</parameter> which specifies encoding when
-encoding attribute on textdata is missing.
-</para>
-</listitem>
+</listitem>
<listitem>
<para>
It appears that XEP now supports Unicode characters in
</listitem>
<listitem>
<para>
-Added parameter <parameter>img.src.path</parameter> as a prefix to HTML img src
-attributes.
-</para>
-</listitem>
-<listitem>
-<para>
In chunked HTML output, changed <literal>link rel="home"</literal> to <literal>rel="start"</literal>,
and <literal>link rel="previous"</literal> to <literal>rel="prev"</literal>, per W3C HTML 4.01
spec.
<para>
Added several patches to htmlhelp from W. Borgert
</para>
-</listitem>
-<listitem>
-<para>
-Added new attribute-sets
-<parameter>informalequation.properties</parameter>,
-<parameter>informalexample.properties</parameter>,
-<parameter>informalfigure.properties</parameter>, and <parameter>informaltable.properties</parameter>,
-so each such element type can be formatted
-individually if needed.
-</para>
-</listitem>
-<listitem>
-<para>
-Added <parameter>chunk.separate.lots</parameter> parameter for HTML output.
-</para>
</listitem>
</itemizedlist>
<itemizedlist>
</para>
</listitem>
</itemizedlist>
-<itemizedlist>
-<title>Release 1.55.0</title>
-<para>The 1.55.0 fixes a few bugs and reorganizes some parameters.
-</para>
-<listitem>
-<para>Added Lithuanian and Vietnamese localizations.
-</para>
-</listitem>
-<listitem>
-<para>Support <literal>orientation</literal>, <literal>rotated-width</literal>, and
-<literal>rotated-height</literal> on a <sgmltag class="pi">dbfo</sgmltag> processing
-instruction to rotate table cells in FO output.
-</para>
-</listitem>
-<listitem>
-<para>Restart all <sgmltag>book</sgmltag>s on page 1.
-</para>
-</listitem>
-<listitem>
-<para>Added experimental <quote>chunkfast</quote> support.
-</para>
-</listitem>
-<listitem>
-<para>Support automatic indexes in <sgmltag>webpage</sgmltag> elements.
-This isn't as useful as it first sounds, because as the code stands only a single
-page (not an entire site) will be indexed. Also, moving this directly into the
-<filename>autoidx.xsl</filename> file may not be the best strategy. It would be
-better if it was somehow contained in the Website stylesheets.
-</para>
-</listitem>
-<listitem>
-<para>Fixed bug where <sgmltag class="pi">dbhtml</sgmltag> processing instructions
-to specify filenames and directories were used even if they occurred in components
-that weren't being chunked.
-</para>
-</listitem>
-<listitem>
-<para>Allow <parameter>generate.toc</parameter> parameter to control ToCs in
-<sgmltag>article</sgmltag> <sgmltag>appendix</sgmltag>es. Suppressed
-by default.
-</para>
-</listitem>
-<listitem>
-<para>Fixed bug where the code that searches for pseudo-attributes in
-processing instructions would match suffixes instead of only whole attributes.
-(In other words, <quote><literal>xxxfoo</literal></quote> would match
-<quote><literal>foo</literal></quote>.)
-</para>
-</listitem>
-<listitem>
-<para>Left-align monospaced verbatim environments in FO.
-</para>
-</listitem>
-</itemizedlist>
-<itemizedlist>
-<title>Release 1.54.1</title>
-<para>The 1.54.1 release fixes a couple of bugs in 1.54.0.
-</para>
-<listitem>
-<para>Remove spurious character from <filename>common.xsl</filename>. This bug
-was a fatal error in Xalan2.</para>
-</listitem>
-<listitem>
-<para>Make sure empty cells inherit from their row.</para>
-</listitem>
-<listitem>
-<para>Actually support <sgmltag>refsection</sgmltag> in HTML.</para>
-</listitem>
-</itemizedlist>
-<itemizedlist>
-<title>Release 1.54.0</title>
-<para>The 1.54.0 release fixes some bugs and adds a couple of new features.
-</para>
-<listitem>
-<para>New option to generate back-of-book FO indexes with page-number
-ranges in place of sequences (e.g., 1-4 instead of 1,2,3,4)
-(<parameter>make.index.markup</parameter>).
-</para>
-</listitem>
-<listitem>
-<para>Experimental support for generating ToCs/LoTs as separate HTML
-chunks (<parameter>chunk.tocs.and.lots</parameter>).</para>
-</listitem>
-<listitem>
-<para>New option to generate HTML Help indexes using HHK files, allowing
-see-also processing & referencing of exact locations of index terms
-(<parameter>htmlhelp.use.hhk</parameter>).</para>
-</listitem>
-<listitem>
-<para>Olink processing tweaks.</para>
-</listitem>
-<listitem>
-<para>Improvements in graphic and table processing.</para>
-</listitem>
-<listitem>
-<para>Additions and workarounds for better compatibility with FO
-engines (FOP, PassiveTeX, XEP).</para>
-</listitem>
-<listitem>
-<para>Bug fixes for FO profiling, indexing of Refentrys.</para>
-</listitem>
-</itemizedlist>
-<itemizedlist>
-<title>Release 1.53.0</title>
-<para>The 1.53.0 release fixes some bugs, refactors page masters, and
-adds some new parameters.</para>
-<listitem>
-<para>Reworked page headers and footers.
-</para>
-</listitem>
-<listitem>
-<para>Support numbered bibliography styles.
-</para>
-</listitem>
-<listitem>
-<para>Added new property set for inline monospaced elements.
-</para>
-</listitem>
-<listitem>
-<para>Added menuchoice separator parameter.
-</para>
-</listitem>
-<listitem>
-<para>Added property sets for each section level heading to remove hard coded
-font sizes.
-</para>
-</listitem>
-<listitem>
-<para>Make table headers bold by default in FO.
-</para>
-</listitem>
-<listitem>
-<para>Use basic
-initial-page-number property instead of extended
-force-page-count property to get components to start on odd
-pages in double.sided mode.
-</para>
-</listitem>
-<listitem>
-<para>Added format.page.number template to set
-the page number format for all page sequences
-</para>
-</listitem>
-<listitem>
-<para>Don't include equations without titles in the LoT for equations.
-</para>
-</listitem>
-<listitem>
-<para>Added support for <parameter>para.propagates.style</parameter>.
-</para>
-</listitem>
-<listitem>
-<para>Added cell padding and spacing parameters for HTML.
-</para>
-</listitem>
-<listitem>
-<para>Added tr.attributes named template (for odd-row coloring and such).
-</para>
-</listitem>
-</itemizedlist>
-<itemizedlist>
-<title>Release 1.52.0</title>
-<para>The 1.52.0 release contains a lot of significant changes. Make sure you
-read the ChangeLog as well.</para>
-<listitem>
-<para>Created a complete and consistent set of chunking parameters:
-<parameter>chunker.output.cdata-section-elements</parameter>
-<parameter>chunker.output.doctype-public</parameter>
-<parameter>chunker.output.doctype-system</parameter>
-<parameter>chunker.output.encoding</parameter>
-<parameter>chunker.output.indent</parameter>
-<parameter>chunker.output.media-type</parameter>
-<parameter>chunker.output.method</parameter>
-<parameter>chunker.output.omit-xml-declaration</parameter>
-<parameter>chunker.output.standalone</parameter>. Removed
-<parameter>default.encoding</parameter> (use
-<parameter>chunker.output.encoding</parameter> instead); removed
-<parameter>output.method</parameter> (use
-<parameter>chunker.output.method</parameter> instead).
-</para>
-</listitem>
-<listitem>
-<para>Added a large number of HTML Help parameters:
-<parameter>htmlhelp.button.back</parameter>,
-<parameter>htmlhelp.button.forward</parameter>,
-<parameter>htmlhelp.button.hideshow</parameter>,
-<parameter>htmlhelp.button.home.url</parameter>,
-<parameter>htmlhelp.button.home</parameter>,
-<parameter>htmlhelp.button.jump1.title</parameter>,
-<parameter>htmlhelp.button.jump1.url</parameter>,
-<parameter>htmlhelp.button.jump1</parameter>,
-<parameter>htmlhelp.button.jump2.title</parameter>,
-<parameter>htmlhelp.button.jump2.url</parameter>,
-<parameter>htmlhelp.button.jump2</parameter>,
-<parameter>htmlhelp.button.locate</parameter>,
-<parameter>htmlhelp.button.next</parameter>,
-<parameter>htmlhelp.button.options</parameter>,
-<parameter>htmlhelp.button.prev</parameter>,
-<parameter>htmlhelp.button.print</parameter>,
-<parameter>htmlhelp.button.refresh</parameter>,
-<parameter>htmlhelp.button.stop</parameter>,
-<parameter>htmlhelp.button.zoom</parameter>,
-<parameter>htmlhelp.hhc.binary</parameter>,
-<parameter>htmlhelp.hhk</parameter>,
-<parameter>htmlhelp.hhp.window</parameter>,
-<parameter>htmlhelp.show.advanced.search</parameter>,
-<parameter>htmlhelp.show.favorities</parameter>,
-<parameter>htmlhelp.show.menu.xml</parameter>, and
-<parameter>htmlhelp.only</parameter>.</para>
-</listitem>
-<listitem>
-<para>Support for new style OLinks. Added
-<parameter>target.database.document</parameter>,
-<parameter>use.local.olink.style</parameter>,
-<parameter>current.docid</parameter>, and
-<parameter>olink.doctitle</parameter>.
-</para>
-</listitem>
-<listitem>
-<para>Added experimental support for xref styles. Added
-<parameter>use.role.as.xrefstyle</parameter>.
-</para>
-</listitem>
-<listitem>
-<para>Completely reworked page master/page sequence configuration.</para>
-</listitem>
-<listitem>
-<para>Support cross-references to paragraphs by using the nearest containing
-section title as the cross-reference text. Is this a good idea?</para>
-</listitem>
-<listitem>
-<para>Removed unused <parameter>chunk.datafile</parameter>.</para>
-</listitem>
-<listitem>
-<para>Added header/footer parameters:
-<parameter>footer.rule</parameter>,
-<parameter>footers.on.blank.pages</parameter>,
-<parameter>header.rule</parameter>, and
-<parameter>headers.on.blank.pages</parameter>.</para>
-</listitem>
-<listitem>
-<para>Added column parameters:
-<parameter>column.count.back</parameter>,
-<parameter>column.count.body</parameter>,
-<parameter>column.count.front</parameter>,
-<parameter>column.count.index</parameter>,
-<parameter>column.count.lot</parameter>,
-<parameter>column.count.of.index</parameter>,
-<parameter>column.count.titlepage</parameter>, and
-<parameter>column.count</parameter>.</para>
-</listitem>
-<listitem>
-<para>Added <parameter>draft.mode</parameter>.
-</para>
-</listitem>
-<listitem>
-<para>Added
-<parameter>glossary.as.blocks</parameter>,
-<parameter>glosslist.as.blocks</parameter>,
-<parameter>glossterm.separation</parameter>,
-<parameter>glossterm.width</parameter>.</para>
-</listitem>
-<listitem>
-<para>Added <parameter>suppress.footer.navigation</parameter> and
-<parameter>suppress.header.navigation</parameter>.</para>
-</listitem>
-<listitem>
-<para>Added
-<parameter>make.graphic.viewport</parameter>,
-<parameter>nominal.image.depth</parameter>,
-<parameter>nominal.image.width</parameter>, and
-<parameter>use.embed.for.svg</parameter></para>
-</listitem>
-<listitem>
-<para>Added
-<parameter>refentry.title.properties</parameter> and
-<parameter>section.title.properties</parameter>
-</para>
-</listitem>
-<listitem>
-<para>Added
-<parameter>use.embed.for.svg</parameter>
-</para>
-</listitem>
-<listitem>
-<para>Added
-generate.meta.abstract.xml</para>
-</listitem>
-</itemizedlist>
-<itemizedlist>
-<title>Release 1.51.0</title>
-<listitem>
-<para>Added an extension function to determine the intrinsic size of
-an image. Works for the image formats supported by the Java Image
-class and or PostScript-derived formats.</para>
-</listitem>
-<listitem>
-<para>Added callout bullets 11-15.
-</para>
-</listitem>
-<listitem>
-<para>Removed obsolete <parameter>using.chunker</parameter> parameter.
-</para>
-</listitem>
-<listitem>
-<para>Added <parameter>points.per.em</parameter> parameter.
-</para>
-</listitem>
-<listitem>
-<para>Added <parameter>generate.manifest</parameter> parameter.
-</para>
-</listitem>
-<listitem>
-<para>Added <parameter>manifest</parameter> parameter.
-</para>
-</listitem>
-<listitem>
-<para>Added <parameter>compact.list.item.spacing</parameter> parameter.
-</para>
-</listitem>
-<listitem>
-<para>Added <parameter>html.extra.head.links</parameter> parameter.
-</para>
-</listitem>
-<listitem>
-<para>Added <parameter>use.svg</parameter> parameter; support SVG in HTML.
-</para>
-</listitem>
-<listitem>
-<para>Convert the library code to a literate programming style with xweb.
-</para>
-</listitem>
-<listitem>
-<para>Support <sgmltag>xref</sgmltag> to any element that has a title (at least
-when it has a title).
-</para>
-</listitem>
-<listitem>
-<para>Pass MathML through unchanged.
-</para>
-</listitem>
-<listitem>
-<para>Completely reworked support for graphic attributes in HTML.
-</para>
-</listitem>
-<listitem>
-<para>Add additional <sgmltag>LINK</sgmltag> elements to the HTML
-<sgmltag>HEAD</sgmltag> (for site navigation as in Mozilla---note,
-however, that Mozilla has disabled this recently for the 1.0 release).
-</para>
-</listitem>
-<listitem>
-<para>Support <parameter>shade.verbatim</parameter> parameter in FO.
-</para>
-</listitem>
-<listitem>
-<para>Support compact list spacing in FO.
-</para>
-</listitem>
-</itemizedlist>
-<itemizedlist>
-<title>Release 1.50.0</title>
-<listitem>
-<para>This release introduces a new version numbering scheme. Version
-numbers are now three part: major.middle.minor. Changes to the middle
-version number indicate a change in the public API. Changes in only the
-minor number indicate simply a new release.</para>
-</listitem>
-<listitem>
-<para>The <parameter>generate.<replaceable>*</replaceable>.toc</parameter>
-and <parameter>generate.<replaceable>*</replaceable>.lot</parameter>
-parameters have been replaced by a single structured parameter,
-<parameter>generate.toc</parameter>.</para>
-<para>It's likely that the HTML and FO stylesheets do not handle ToC generation
-in exactly the same way, but they should.</para>
-</listitem>
-<listitem>
-<para>Added <filename>strip-attributes.xsl</filename> to the profiling
-stylesheets. This allows one to strip off, for example, profiling attributes
-after a document has been profiled.</para>
-</listitem>
-<listitem>
-<para>Improved numeration of footnotes and table footnotes. Made table footnotes
-render <quote>properly</quote> in FOs.</para>
-</listitem>
-<listitem>
-<para>Added a <parameter>formal.title.placement</parameter> parameter, allowing
-users to select placement of formal object titles either above or
-below the
-object.</para>
-</listitem>
-<listitem>
-<para>Improved control over delimiters for TeX equations.</para>
-</listitem>
-<listitem>
-<para>Support <sgmltag>classsynopsis</sgmltag> and friends in FOs.</para>
-</listitem>
-<listitem>
-<para>Changed HTML stylesheets to use <sgmltag>em</sgmltag> instead of
-<sgmltag>i</sgmltag> for <sgmltag>emphasis</sgmltag>.</para>
-</listitem>
-<listitem>
-<para>Added <sgmltag>chunk.quietly</sgmltag> parameter.</para>
-</listitem>
-<listitem>
-<para>Improved profiling code to support the full range of profiling attributes
-and to support one-pass profiling (if your XSLT processor understands the
-<ulink url="http://www.exslt.org/">EXSLT</ulink> <function>node-set</function>
-function.</para>
-</listitem>
-</itemizedlist>
+<note>
+<para>Consult CVS archive for release notes on earlier releases</para>
+</note>
</article>
projects / docbook-dsssl / commitdiff