From: Michael Smith Date: Sat, 25 Mar 2006 05:24:40 +0000 (+0000) Subject: Turned release notes document into a DocBook 5 instance, but added X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ce64055a25bc877c117852738029d8ee4f5f4f3b;p=docbook-dsssl Turned release notes document into a DocBook 5 instance, but added internal DTD subset that makes it backward-compatible with DocBook old. Also added a skeletal "snapshot" section. --- diff --git a/xsl/RELEASE-NOTES.xml b/xsl/RELEASE-NOTES.xml index 1b8b79967..b9418e4a8 100644 --- a/xsl/RELEASE-NOTES.xml +++ b/xsl/RELEASE-NOTES.xml @@ -1,14 +1,84 @@ -
- +"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ + + + + + + + + + + + + + + + + + + + + + + + +]> +
+ Release Notes DocBook Project XSL Stylesheets - $Revision$ $Date$ - DocBook Project Development Team - + $Revision$ $Date$ + DocBook Project Development Team + These are the release notes for the DocBook XSL Stylesheets. At a minimum, this file attempts to document changes to the public @@ -17,11 +87,90 @@ release. Bug fixes are (mostly) not documented here. For a complete - list of changes, including descriptions of bug fixes, see the file, which is auto-generated from the checkin - descriptions for changes in the project CVS repository. + list of changes, including descriptions of bug fixes, see the file, which is auto-generated from the checkin + descriptions for changes in the project source-code repository. -
+
+ Current snapshot + The current snapshot includes changes related to… FIXME + +
+ Common + The following changes have been made to the + common code since the previous + release. + + + + + + +
+ +
+ FO + The following changes have been made to the FO stylesheets + since the last release. + + + + + + +
+ +
+ HTML + + The following changes have been made to the HTML + stylesheets since the last release. + + + + + +
+ +
+ Help + The following changes have been made to the Help + stylesheets since the last release. + + + + + + +
+ +
+ WordML + The following changes have been made to the Help + stylesheets since the last release. + + + + + + +
+ +
+ man + The following changes have been made to the manpages + stylesheets since the last release. + + + + + + +
+
+ + +
Release 1.69.1 This release is a minor bug-fix update to the 1.69.0 release. Along with bug fixes, it includes one @@ -34,7 +183,7 @@
-
+
Release 1.69.0 The release includes major feature changes, particularly in the manpages @@ -43,7 +192,7 @@ As with all DocBook Project dot zero releases, this is an experimental release . -
+
Common @@ -147,7 +296,7 @@
-
+
FO @@ -236,7 +385,7 @@
-
+
Help @@ -246,7 +395,7 @@
-
+
HTML @@ -368,7 +517,7 @@ remark replaceable returnvalue - sgmltag + tag shortcut state street @@ -408,7 +557,7 @@
-
+
man This release closes out 44 manpages stylesheet bug reports and feature requests. It adds more than 35 new configuration @@ -651,14 +800,14 @@ > <refentry> <info> - <date>2003-10-20</date> + <date>2003-10-20</date> </info> <refmeta> - <refentrytitle>gtk-options</refentrytitle> - <manvolnum>7</manvolnum> - <refmiscinfo class="source-name">GTK+</refmiscinfo> - <refmiscinfo class="version">1.2</refmiscinfo> - <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> + <refentrytitle>gtk-options</refentrytitle> + <manvolnum>7</manvolnum> + <refmiscinfo class="source-name">GTK+</refmiscinfo> + <refmiscinfo class="version">1.2</refmiscinfo> + <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> </refmeta> <refnamediv> <refname>gtk-options</refname> @@ -671,22 +820,22 @@ </refsect1> </refentry> - + Sets the date part of the header/footer. - + Sets the title part. - + Sets the section part. - + Sets the source name part. - + Sets the version part. - + Sets the manual part. @@ -1074,7 +1223,7 @@ Release 1.68.1 The release adds localization support for Farsi (thanks to Sina Heshmati) and improved support for the XLink-based DocBook NG - db:link element. Other than that, it is a minor + db:link element. Other than that, it is a minor bug-fix update to the 1.68.0 release. The main thing it fixes is a build error that caused the XSLT Java extensions to be jarred up with the wrong package structure. Thanks to Jens Stavnstrup for @@ -1087,7 +1236,7 @@ Release 1.68.0 This release includes some features changes, particularly for FO/PDF output, and a number of bug fixes. - + FO Moved footnote properties to attribute-sets. @@ -1103,15 +1252,15 @@ set.flow.properties template. - Added support for xml:id + Added support for xml:id Added support for - refdescriptor. + refdescriptor. - Added support for multiple refnamedivs. + Added support for multiple refnamedivs. Added index.entry.properties @@ -1120,12 +1269,12 @@ Added set.flow.properties - template call to each fo:flow + template call to each fo:flow to support customizations entry point. Add support for @floatstyle in - figure + figure Moved hardcoded properties for index division titles @@ -1134,8 +1283,8 @@ Added support for - table-layout="auto" for XEP. + table-layout="auto" for XEP. Added index.div.title.properties @@ -1146,22 +1295,22 @@ passed to most elements. - Added refentry to - toc in part, as it is + Added refentry to + toc in part, as it is permitted by the DocBook schema/DTD. Added backmatter elements and - article to toc in - part, since they are permitted by the + article to toc in + part, since they are permitted by the DocBook schema/DTD. - Added mode="toc" for - simplesect, since it is now permitted in - the toc if + Added mode="toc" for + simplesect, since it is now permitted in + the toc if simplesect.in.toc is set. @@ -1173,7 +1322,7 @@ Added support for sidebar-width and float-type processing instructions in - sidebar. + sidebar. For tables with HTML markup elements, added support @@ -1186,8 +1335,8 @@ table.cell.properties and table.cell.block.properties so that tabstyles can be implemented. Also added support for tables - containing only tr instead of - tbody with tr. + containing only tr instead of + tbody with tr. Added new paramater @@ -1207,25 +1356,25 @@ - + HTML Added support for - refdescriptor. + refdescriptor. - Added support for multiple refnamedivs. + Added support for multiple refnamedivs. - Added support for xml:id + Added support for xml:id - refsynopsisdiv as a section for + refsynopsisdiv as a section for counting section levels - + Images Added new SVG admonition graphics and navigation images. @@ -1243,9 +1392,9 @@
Release 1.67.1 This release includes a number of bug fixes; for details, - see the file. + see the file. The following lists provide details about API and feature changes. - + FO Tables: Inherited cell properties are now passed to the @@ -1260,7 +1409,7 @@ TOCs: Added new parameter simplesect.in.toc; default value of 0 causes simplesect to be omitted from TOCs; to - cause simplesect to be included in TOCs, you + cause simplesect to be included in TOCs, you must set the value of simplesect.in.toc to 1.Comment from Norm: @@ -1289,13 +1438,13 @@ they can be customized. - Lists: Added glossdef's first - para to special handling in + Lists: Added glossdef's first + para to special handling in fo:list-item-body. - + HTML TOCs: Added new parameter @@ -1307,8 +1456,8 @@ Indexing: Added new parameter index.prefer.titleabbrev; when set to 1, index references will use - titleabbrev instead of - title when available. + titleabbrev instead of + title when available. @@ -1319,14 +1468,14 @@ linkend="V1671_EXT"/> changes for this release. - + man pages Replaced named/numeric character-entity references for non-breaking space with groff equivalent (backslash-tilde). - + XSL Java extensions Saxon extensions: Added the @@ -1347,7 +1496,7 @@ Create a DocBook XSL customization layer -- a file named mystylesheet.xsl or whatever -- that, at a minimum, contains the following: - <xsl:stylesheet + <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version='1.0'> <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/> @@ -1360,14 +1509,14 @@ Invoke Saxon with the encoding.windows-1252 Java system property set to com.nwalsh.saxon.Windows1252; for example - java \ + java \ -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \ com.icl.saxon.StyleSheet \ mydoc.xml mystylesheet.xsl Or, for a more complete "real world" case showing other options you'll typically want to use: - java \ + java \ -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \ -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \ -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \ @@ -1395,18 +1544,18 @@ Release 1.67.0 - A number of important bug fixes, documented in . + A number of important bug fixes, documented in . Added Saxon8 extensions Enabled dbfo table-width on - entrytbl in FO output + entrytbl in FO output Added support for role=strong on - emphasis in FO output + emphasis in FO output Added new FO parameter @@ -1428,8 +1577,8 @@ Wrapped ToC - refentrytitle/refname and - refpurpose in span with class values. This + refentrytitle/refname and + refpurpose in span with class values. This makes it possible to style them using a CSS stylesheet. @@ -1437,8 +1586,8 @@ b/i in HTML output - Added support for converting Emphasis to - groff italic and Emphasis role='bold' to + Added support for converting Emphasis to + groff italic and Emphasis role='bold' to bold. Controlled by emphasis.propagates.style param, but not documented yet using litprog system. Will do that next (planning @@ -1476,7 +1625,7 @@ Release 1.66.1 -A number of important bug fixes, documented in . +A number of important bug fixes, documented in . @@ -1513,8 +1662,8 @@ information. -Added index.on.type parameter for new type +Added index.on.type parameter for new type attribute introduced in DocBook 4.3 for indexterms and index. This allows you to create multiple indices containing different categories of entries. @@ -1581,7 +1730,7 @@ properties to the fo:table element. Added placeholder templates named table.cell.properties and table.cell.block.properties to enable adding properties -to any fo:table-cell or the cell's fo:block, respectively. +to any fo:table-cell or the cell's fo:block, respectively. These templates are a start for implementing table styles. @@ -1595,10 +1744,10 @@ component's title formatting in FO output. -Added Saxon support for an encoding attribute on the textdata element. Added new parameter +Added Saxon support for an encoding attribute on the textdata element. Added new parameter textdata.default.encoding which specifies encoding when -encoding attribute on -textdata is missing. +encoding attribute on +textdata is missing. @@ -1643,19 +1792,19 @@ Now ulink footnotes are mixed in with any other footnotes. -Added support for renderas attribute in section and +Added support for renderas attribute in section and sect1 et al. This permits you to render a given section title as if it were a different level. -Added support for label attribute in footnote to manually +Added support for label attribute in footnote to manually supply the footnote mark. -Added support for DocBook 4.3 corpcredit element. +Added support for DocBook 4.3 corpcredit element. @@ -1674,7 +1823,7 @@ insensitive, and updated the list of graphics extensions. -Allow calloutlist to have block content before +Allow calloutlist to have block content before the first callout @@ -1692,7 +1841,7 @@ Added implementation of existing but unused -Support DocBook NG tag inline element. +Support DocBook NG tag inline element. @@ -1704,7 +1853,7 @@ characters. -Make segmentedlist HTML markup +Make segmentedlist HTML markup more semantic and available to CSS styles. @@ -1745,7 +1894,7 @@ Added Bosnian locale file as common/bs.xml. Release 1.65.0 -A number of important bug fixes, documented in . +A number of important bug fixes, documented in . @@ -1807,7 +1956,7 @@ works with Xalan 2.5. -Added level 6 to test for section depth in +Added level 6 to test for section depth in section.level template so that section.title.level6.properties will be used for sections that are 6 deep or deeper. This should also cause a h6 to be @@ -1845,8 +1994,8 @@ validate. -Added hyphenation support. Added support for coref. -Added beginpage support. (does nothing; see TDG). +Added hyphenation support. Added support for coref. +Added beginpage support. (does nothing; see TDG). @@ -1868,7 +2017,7 @@ column -Handle othercredit on titlepage a little +Handle othercredit on titlepage a little better @@ -1884,7 +2033,7 @@ with tertiary page numbers on secondary entries. -Make footnote formatting 'normal' even when it +Make footnote formatting 'normal' even when it occurs in a context that has special formatting @@ -1894,12 +2043,12 @@ blank, but it cannot open the specified file. -Pick up the frame attribute on table and -informaltable. +Pick up the frame attribute on table and +informaltable. -indexdiv/title +indexdiv/title in non-autogenerated indexes are now picked up. @@ -1916,7 +2065,7 @@ page-sequences down to titlepage blocks Use -proportional-column-width(1) on more tables. +proportional-column-width(1) on more tables. Use proportional-column-width() for header/footer tables; suppress relative-align when when @@ -1933,8 +2082,8 @@ firstterms; don't output gl. prefix on glossterm links -Support glossary, bibliography, -and index in component ToCs. +Support glossary, bibliography, +and index in component ToCs. @@ -1944,8 +2093,8 @@ practical -Support textobject/phrase -on inlinemediaobject. +Support textobject/phrase +on inlinemediaobject. @@ -1969,7 +2118,7 @@ as requested by PHP-DOC group. -Exempted titleabbrev from preamble processing in +Exempted titleabbrev from preamble processing in lists, and fixed variablelist preamble code to use the same syntax as the other lists. @@ -2011,7 +2160,7 @@ to be fo: qualified: font-size="&hsize5;" font-weight="bold" font-family="{$title.font.family}"/>]]> -The t:titlepage and t:titlepage-content +The t:titlepage and t:titlepage-content elements both generate wrappers now. And unqualified attributes on those elements are passed through. This means that you can now make the title font apply to ane entire titlepage and make the entire recto @@ -2028,7 +2177,7 @@ titlepage centered by specifying the font and alignment on the those elements: -Support use of titleabbrev in running +Support use of titleabbrev in running headers and footers. @@ -2040,7 +2189,7 @@ be just the number. -Generate part ToCs if they're requested. +Generate part ToCs if they're requested. @@ -2048,28 +2197,28 @@ be just the number. -Handle alignment correctly when screenshot -wraps a graphic in a figure. +Handle alignment correctly when screenshot +wraps a graphic in a figure. -Format chapter and appendix +Format chapter and appendix cross references consistently. -Attempt to support tables with multiple tgroups +Attempt to support tables with multiple tgroups in FO. -Output fo:table-columns in -simplelist tables. +Output fo:table-columns in +simplelist tables. Use titlepage.templates.xml for -indexdiv and glossdiv formatting. +indexdiv and glossdiv formatting. @@ -2086,7 +2235,7 @@ footnote markers. -Added glossentry.show.acronyms. +Added glossentry.show.acronyms. @@ -2099,7 +2248,7 @@ footnote markers. -Improved formatting of ulink footnotes. +Improved formatting of ulink footnotes. @@ -2116,7 +2265,7 @@ with the dbhtml PI. -Don't force a ToC when sections contain refentrys. +Don't force a ToC when sections contain refentrys. @@ -2147,12 +2296,12 @@ a mismatch that FOP detects. Attempt to prevent duplicated IDs from being produced when -endterm on xref points +endterm on xref points to something with nested structure. -Fix aligment problems in equations. +Fix aligment problems in equations. @@ -2186,33 +2335,33 @@ to index an entire set. -Added support for titleabbrev (use them for cross +Added support for titleabbrev (use them for cross references). -Improvements to mediaobject for selecting print vs. online +Improvements to mediaobject for selecting print vs. online images. -Added seperate property sets for figures, -examples, equations, tabless, -and procedures. +Added seperate property sets for figures, +examples, equations, tabless, +and procedures. -Make lineannotations italic. +Make lineannotations italic. -Support xrefstyle attribute. +Support xrefstyle attribute. -Make endterm on -xref higher priority than -xreflabel target. +Make endterm on +xref higher priority than +xreflabel target. @@ -2239,7 +2388,7 @@ errors. -Support nested refsection elements correctly. +Support nested refsection elements correctly. @@ -2257,7 +2406,7 @@ just a simple name. -Added support for entrytbl. +Added support for entrytbl. @@ -2265,7 +2414,7 @@ just a simple name. -Support bibliosource. +Support bibliosource. @@ -2292,7 +2441,7 @@ look at the new content parameter that's passed to -Support continued and inherited numeration in orderedlist +Support continued and inherited numeration in orderedlist formatting for FOs. @@ -2322,13 +2471,13 @@ Support tables of contents on sections. -Suppress formatting of endofrange indexterms. +Suppress formatting of endofrange indexterms. This is only half-right. They should generate a range, but I haven't figured out how to do that yet. -Support revdescription. (Bug #582192) +Support revdescription. (Bug #582192) @@ -2337,7 +2486,7 @@ floats. (Bug #497603) -Fixed formatting of sbr in FOs. +Fixed formatting of sbr in FOs. @@ -2345,7 +2494,7 @@ floats. (Bug #497603) -Process arg correctly in a group. +Process arg correctly in a group. (Bug #605150) @@ -2383,13 +2532,13 @@ of places where it is used. Improve use of HTML cleanup in XHTML stylesheets. -Support table of contents for appendix in -article. (Bug #596599) +Support table of contents for appendix in +article. (Bug #596599) -Don't duplicate footnotes in bibliographys and -glossarys. (Bug #583282) +Don't duplicate footnotes in bibliographys and +glossarys. (Bug #583282) @@ -2397,7 +2546,7 @@ of places where it is used. Improve use of HTML cleanup in XHTML stylesheets. -Totally reworked funcsynopsis code; it now +Totally reworked funcsynopsis code; it now supports a 'tabular' presentation style for 'wide' prototypes; see funcsynopsis.tabular.threshold. (HTML only right now, I think, FO support, uh, real soon now.) @@ -2415,16 +2564,16 @@ out long description chunks. -Make sure legalnotice link is correct even when +Make sure legalnotice link is correct even when chunking to a different base.dir. Use CSS to set viewport characteristics if css.decoration is non-zero, use div instead of p for making -graphic a block element; make figure titles the +graphic a block element; make figure titles the default alt -text for images in a figure. +text for images in a figure. Added space-after to list.block.spacing. @@ -2436,7 +2585,7 @@ instead of being off by one. -When processing tables, use the tabstyle +When processing tables, use the tabstyle attribute as the division class. @@ -2449,12 +2598,12 @@ XHTML chunker to output HTML instead of XHTML.
Older releases - To view the release notes for older releases, see . Be + To view the release notes for older releases, see . Be aware that there were no release notes for releases prior to the 1.50.0 release.
-
+
About dot-zero releases DocBook Project dot zero releases should be considered experimental and are always