From: Keith Fahlgren Date: Tue, 17 Feb 2009 16:56:15 +0000 (+0000) Subject: Updated for 1.74.1 release X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=2879a6f4d7a7b9ca9376365fdb3a18b97f668f6d;p=docbook-dsssl Updated for 1.74.1 release --- diff --git a/xsl/RELEASE-NOTES.xml b/xsl/RELEASE-NOTES.xml index f85d652fa..b55c86a22 100644 --- a/xsl/RELEASE-NOTES.xml +++ b/xsl/RELEASE-NOTES.xml @@ -58,6 +58,344 @@ public APIs (user-configurable parameters). + +Release Notes: 1.74.1 +This release includes important bug fixes and adds the following +significant feature changes: + + +Gentext +Kirghiz locale added and Chinese translations have been simplified. +Somme support for gentext and right-to-left languages has been added. + + +FO +Various bugs have been resolved. +Support for a new processing instruction: dbfo funcsynopsis-style has been added. +Added new param email.mailto.enabled for FO output. Patch from Paolo Borelli. + +Support for documented metadata in fop1 mode has been added. + + + + +Highlighting +Support for the latest version of XSLTHL 2.0 and some new language syntaxes have been added to a variety of outputs. + + + + +Manpages +Added man.output.better.ps.enabled param (zero default). It non-zero, no such +markup is embedded in generated man pages, and no enhancements are +included in the PostScript output generated from those man pages +by the man -Tps command. + + + + + +HTML +Support for writing.mode to set text direction and alignment based on document locale has been added. + +Added a new top-level stylesheet module, chunk-changebars.xsl, to be +used for generating chunked output with highlighting based on change +(@revisionflag) markup. The module imports/includes the standard chunking +and changebars templates and contains additional logic for chunked output. +See FRs #1015180 and #1819915. + + + + +ePub + +Covers now look better in Adobe Digital Editions thanks to a patch from Paul Norton of Adobe + +Cover handling now more generic (including limited DocBook 5.0 cover support thanks to patch contributed by Liza Daly. +Cover markup now carries more reliably into files destined for .mobi and the Kindle. +dc:identifiers are now generated from more types of numbering schemes. +Both SEO and semantic structure of chunked ePub output by ensuring that we always send out one and only one h1 in each XHTML chunk. + +Primitive support for embedding a single font added. + + +Support for embedding a CSS customizations added. + + + + + +Roundtrip + + +Support for imagedata-metadata and table as images added. + + +Support for imagedata-metadata and legalnotice as images added. + + + + +Params +man.output.better.ps.enabled added for Manpages output + +writing.mode.xml added to set text direction. + + +Added new param email.mailto.enabled for FO output. +Patch from Paolo Borelli. Closes #2086321. + + +highlight.source upgraded to support the latest version of XSLTHL 2.0. + + + + + + + + +The following is a list of changes that have been made since the 1.74.0 release. + + + +Gentext +The following changes have been made to the gentext code since the 1.74.0 release. + + +Michael(tm) Smith: locale/ky.xml; Makefilenew Kirghiz locale from Ilyas Bakirov + + +Mauritz Jeanson: locale/en.xmlAdded "Acknowledgements". + + +Dongsheng Song: locale/zh_cn.xmlSimplified Chinese translation. + + +Robert Stayton: locale/lv.xml; locale/ca.xml; locale/pt.xml; locale/tr.xml; locale/af.xml;⋯Add writing-mode gentext string to support right-to-left languages. + + + + + +FO +The following changes have been made to the fo code since the 1.74.0 release. + + +David Cramer: footnote.xslAdded a check to confirm that a footnoteref's linkend points to a footnote. Stylesheets stop processing if not and provide a useful error message. + + +Mauritz Jeanson: spaces.xslConvert spaces to fo:leader also in elements in the DB 5 namespace. + + +Mauritz Jeanson: pi.xsl; synop.xslAdded support for a new processing instruction: dbfo funcsynopsis-style. +Closes bug #1838213. + + +Michael(tm) Smith: inline.xsl; param.xweb; param.entAdded new param email.mailto.enabled for FO output. +Patch from Paolo Borelli. Closes #2086321. + + +Mauritz Jeanson: docbook.xslAdded support for document metadata for fop1 (patch #2067318). + + +Jirka Kosek: param.ent; param.xweb; highlight.xslUpgraded to support the latest version of XSLTHL 2.0 + -- nested markup in highlited code is now processed + -- it is no longer needed to specify path XSLTHL configuration file using Java property + -- support for new languages, including Perl, Python and Ruby was added + + + + + +HTML +The following changes have been made to the html code since the 1.74.0 release. + + +Robert Stayton: param.xweb; docbook.xsl; param.ent; html.xslAdd support for writing.mode to set text direction and alignment based on document locale. + + +Mauritz Jeanson: chunk-changebars.xslAdded a new top-level stylesheet module, chunk-changebars.xsl, to be +used for generating chunked output with highlighting based on change +(@revisionflag) markup. The module imports/includes the standard chunking +and changebars templates and contains additional logic for chunked output. +See FRs #1015180 and #1819915. + + + + + +Manpages +The following changes have been made to the manpages code since the 1.74.0 release. + + +Michael(tm) Smith: docbook.xslPut the following at the top of generated roff for each page: + \" t +purpose is to explicitly tell AT&T troff that the page needs to be +pre-processed through tbl(1); groff can figure it out +automatically, but apparently AT&T troff needs to be explicitly told + + + + + +ePub +The following changes have been made to the epub code since the 1.74.0 release. + + +Keith Fahlgren: docbook.xslPatch from Paul Norton of Adobe to get covers to look better in Adobe Digital Editions + + +Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/v5cover.xml; bin/spec/sp⋯Patch contributed by Liza Daly to make ePub cover handling more generic. Additionally +DocBook 5.0's <cover> now has some limited support: + +- should reference a cover in the OPF guide for a DocBook 5.0 test document + + +Keith Fahlgren: bin/spec/files/isbn.xml; bin/spec/files/issn.xml; bin/spec/files/biblioid.⋯Liza Daly reported that the dc:identifer-generation code was garbage (she was right). + +Added new tests: +- should include at least one dc:identifier +- should include an ISBN as URN for dc:identifier if an ISBN was in the metadata +- should include an ISSN as URN for dc:identifier if an ISSN was in the metadata +- should include an biblioid as a dc:identifier if an biblioid was in the metadata +- should include a URN for a biblioid with @class attribute as a dc:identifier if an biblioid was in the metadata + + +Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rbImprove both SEO and semantic structure of chunked ePub output by ensuring that +we always send out one and only one h1 in each XHTML chunk. + +DocBook::Epub +- should include one and only one <h1> in each HTML file in rendered ePub files +for <book>s +- should include one and only one <h1> in each HTML file in rendered ePub files +for <book>s even if they do not have section markup + + +Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files/orm.book.001.x⋯Adding better support for covers in epub files destined for .mobi and the Kindle + + +Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/DejaVuSerif.otf; docbook.⋯Adding primitive support for embedding a single font + + +Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/test_cust.xsl; bin/spec/e⋯Adding support for user-specified customization layers in dbtoepub + + +Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/docbook.rb; bin/s⋯Adding CSS support to .epub target & dbtoepub: + -c, --css [FILE] Use FILE for CSS on generated XHTML. + + +DocBook::Epub +... +- should include a CSS link in HTML files when a CSS file has been provided +- should include CSS file in .epub when a CSS file has been provided +- should include a CSS link in OPF file when a CSS file has been provided + + + + + +Roundtrip +The following changes have been made to the + roundtrip code + since the 1.74.0 release. + + +Steve Ball: blocks2dbk.xsl; template.xml; template.dotadded support for imagedata-metadata +added support for table as images + + +Steve Ball: blocks2dbk.xsl; normalise2sections.xsl; sections2blocks.xslImproved support for personname inlines. + + +Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xmlAdded support for legalnotice. + + +Steve Ball: blocks2dbk.xsl; wordml2normalise.xsladded support for orgname in author + + +Steve Ball: specifications.xml; supported.xml; blocks2dbk.xsl; wordml2normalise.xsl; dbk2w⋯Updated specification. +to-DocBook: add cols attribute to tgroup +from-DocBook: fix for blockquote title + + + + + +Params +The following changes have been made to the params since the 1.74.0 release. + + +The change was to add man.output.better.ps.enabled parameter, with +its default value set to zero. + +If the value of the man.output.better.ps.enabled parameter is +non-zero, certain markup is embedded in each generated man page +such that PostScript output from the man -Tps command for that +page will include a number of enhancements designed to improve the +quality of that output. + +If man.output.better.ps.enabled is zero (the default), no such +markup is embedded in generated man pages, and no enhancements are +included in the PostScript output generated from those man pages +by the man -Tps command. + +WARNING: The enhancements provided by this parameter rely on +features that are specific to groff (GNU troff) and that are not +part of "classic" AT&T troff or any of its derivatives. Therefore, +any man pages you generate with this parameter enabled will be +readable only on systems on which the groff (GNU troff) program is +installed, such as GNU/Linux systems. The pages will not not be +readable on systems on with the classic troff (AT&T troff) command +is installed. + +NOTE: The value of this parameter only affects PostScript output +generated from the man command. It has no effect on output +generated using the FO backend. + +TIP: You can generate PostScript output for any man page by +running the following command: + +man FOO -Tps > FOO.ps + +You can then generate PDF output by running the following command: + +ps2pdf FOO.ps + + +Robert Stayton: writing.mode.xmlwriting mode param used to set text direction. + + +Michael(tm) Smith: email.mailto.enabled.xmlAdded new param email.mailto.enabled for FO output. +Patch from Paolo Borelli. Closes #2086321. + + +Jirka Kosek: highlight.source.xml; highlight.xslthl.config.xmlUpgraded to support the latest version of XSLTHL 2.0 + -- nested markup in highlited code is now processed + -- it is no longer needed to specify path XSLTHL configuration file using Java property + -- support for new languages, including Perl, Python and Ruby was added + + + + + +Highlighting +The following changes have been made to the + highlighting code + since the 1.74.0 release. + + +Jirka Kosek: cpp-hl.xml; c-hl.xml; tcl-hl.xml; php-hl.xml; common.xsl; perl-hl.xml; delphi⋯Upgraded to support the latest version of XSLTHL 2.0 + -- nested markup in highlited code is now processed + -- it is no longer needed to specify path XSLTHL configuration file using Java property + -- support for new languages, including Perl, Python and Ruby was added + + + + + + + Release Notes: 1.74.0 This release includes important bug fixes and adds the following