From: Robert S. <bob...@us...> - 2004-09-11 08:16:08
|
Update of /cvsroot/docbook/xsl In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv14548 Modified Files: RELEASE-NOTES.xml Log Message: Updated release notes for version 1.66.0 Index: RELEASE-NOTES.xml =================================================================== RCS file: /cvsroot/docbook/xsl/RELEASE-NOTES.xml,v retrieving revision 1.22 retrieving revision 1.23 diff -u -U2 -r1.22 -r1.23 --- RELEASE-NOTES.xml 2 Sep 2004 07:07:18 -0000 1.22 +++ RELEASE-NOTES.xml 11 Sep 2004 08:15:55 -0000 1.23 @@ -4,5 +4,5 @@ <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> @@ -23,20 +23,43 @@ <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> @@ -46,31 +69,77 @@ <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> @@ -84,7 +153,13 @@ <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> @@ -98,5 +173,5 @@ <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> @@ -106,17 +181,11 @@ 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> @@ -134,5 +203,5 @@ <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. @@ -156,15 +225,5 @@ 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> @@ -177,38 +236,5 @@ 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> @@ -240,10 +266,4 @@ <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 @@ -255,19 +275,4 @@ 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> @@ -960,414 +965,6 @@ </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> |