+++ /dev/null
-Release Notes for the DocBook XSL Stylesheets\r
-\r
-$Revision: 8504 $ $Date: 2009-07-21 07:22:11 -0700 (Tue, 21 Jul 2009) $\r
-\r
-2009-07-21\r
-\r
-This release-notes document is available in the following formats: HTML, PDF,\r
-plain text; it provides a per-release list of enhancements and changes to the\r
-stylesheets’ public APIs (user-configurable parameters) and excludes\r
-descriptions of most bug fixes. For a complete list of all changes (including\r
-all bug fixes) that have been made since the previous release, see the separate\r
-NEWS (plain text) or NEWS.html files. Also available: An online hyperlinked\r
-change history (warning: big file) of all changes made over the entire history\r
-of the codebase.\r
-\r
-As with all DocBook Project “dot one plus” releases, this release aspires to be\r
-stable (in contrast to dot-zero releases, which are experimental).\r
-\r
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
-\r
-Table of Contents\r
-\r
-Release Notes: 1.75.2\r
-\r
- Gentext\r
- Common\r
- FO\r
- HTML\r
- Manpages\r
- Epub\r
- Profiling\r
- XSL-Saxon\r
- XSL-Xalan\r
-\r
-Release Notes: 1.75.1\r
-\r
- FO\r
- HTML\r
- Epub\r
- Params\r
-\r
-Release Notes: 1.75.0\r
-\r
- Gentext\r
- Common\r
- FO\r
- HTML\r
- Manpages\r
- ePub\r
- HTMLHelp\r
- Params\r
- Highlighting\r
- XSL-Saxon\r
- XSL-Xalan\r
-\r
-Release Notes: 1.74.3\r
-Release Notes: 1.74.2\r
-Release Notes: 1.74.1\r
-\r
- Gentext\r
- FO\r
- HTML\r
- Manpages\r
- ePub\r
- Roundtrip\r
- Params\r
- Highlighting\r
-\r
-Release Notes: 1.74.0\r
-\r
- Gentext\r
- Common\r
- FO\r
- HTML\r
- Manpages\r
- Epub\r
- HTMLHelp\r
- Eclipse\r
- JavaHelp\r
- Roundtrip\r
- Slides\r
- Website\r
- Params\r
- Profiling\r
- Tools\r
- Extensions\r
- XSL-Saxon\r
- XSL-Xalan\r
- XSL-libxslt\r
-\r
-Release Notes: 1.73.2\r
-Release: 1.73.1\r
-\r
- Gentext\r
- FO\r
- HTML\r
- Manpages\r
- HTMLHelp\r
- Eclipse\r
- JavaHelp\r
- Roundtrip\r
- Params\r
-\r
-Release: 1.73.0\r
-\r
- Gentext\r
- Common\r
- FO\r
- HTML\r
- Manpages\r
- Eclipse\r
- JavaHelp\r
- Roundtrip\r
- Params\r
- Highlighting\r
- Profiling\r
- Lib\r
- Tools\r
- XSL-Saxon\r
- XSL-Xalan\r
-\r
-Release: 1.72.0\r
-\r
- Common\r
- FO\r
- HTML\r
- Manpages\r
- Params\r
- Template\r
- Roundtrip\r
-\r
-Release: 1.71.1\r
-\r
- Common\r
- FO\r
- HTML\r
- Highlighting\r
- Manpages\r
- Params\r
- Profiling\r
-\r
-Release: 1.71.0\r
-\r
- Common\r
- Extensions\r
- FO\r
- HTML\r
- Highlighting\r
- Manpages\r
- Params\r
- Tools\r
-\r
-Release: 1.70.1\r
-\r
- FO\r
- HTML\r
- HTMLHelp\r
- Params\r
-\r
-Release: 1.70.0\r
-\r
- Common\r
- Extensions\r
- FO\r
- HTML\r
- Manpages\r
- Params\r
- Profiling\r
- Tools\r
- WordML\r
-\r
-Release 1.69.1\r
-Release 1.69.0\r
-\r
- Common\r
- FO\r
- Help\r
- HTML\r
- man\r
-\r
-Release 1.68.1\r
-Release 1.68.0\r
-Release 1.67.2\r
-Release 1.67.1\r
-Release 1.67.0\r
-Release 1.66.1\r
-Release 1.65.0\r
-Release 1.64.1\r
-Release 1.61.0\r
-Release 1.60.1\r
-Release 1.59.2\r
-Release 1.59.1\r
-Release 1.58.0\r
-Release 1.57.0\r
-Release 1.56.0\r
-Older releases\r
-About dot-zero releases\r
-\r
-Release Notes: 1.75.2\r
-\r
-The following is a list of changes that have been made since the 1.75.1\r
-release.\r
-\r
-Gentext\r
-\r
-The following changes have been made to the gentext code since the 1.75.1\r
-release.\r
-\r
- ● dleidert: locale/ja.xml\r
-\r
- Improved Japanese translation for Note(s). Closes bug #2823965.\r
-\r
- ● dleidert: locale/pl.xml\r
-\r
- Polish alphabet contains O with acute accent, not with grave accent. Closes bug #2823964.\r
-\r
- ● Robert Stayton: locale/ja.xml\r
-\r
- Fix translation of "index", per bug report 2796064.\r
-\r
- ● Robert Stayton: locale/is.xml\r
-\r
- New Icelandic locale file.\r
-\r
-Common\r
-\r
-The following changes have been made to the common code since the 1.75.1\r
-release.\r
-\r
- ● Norman Walsh: stripns.xsl\r
-\r
- Support more downconvert cases\r
-\r
- ● Robert Stayton: titles.xsl\r
-\r
- Make sure title inside info is used if no other title.\r
-\r
-FO\r
-\r
-The following changes have been made to the fo code since the 1.75.1 release.\r
-\r
- ● Robert Stayton: pi.xsl\r
-\r
- Turn off dbfo-need for fop1.extensions also, per bug #2816141.\r
-\r
-HTML\r
-\r
-The following changes have been made to the html code since the 1.75.1 release.\r
-\r
- ● Mauritz Jeanson: titlepage.xsl\r
-\r
- Output "Copyright" heading in XHTML too.\r
-\r
- ● Mauritz Jeanson: titlepage.xsl\r
-\r
- Added stylesheet.result.type test for copyright. Closes bug #2813289.\r
-\r
- ● Norman Walsh: htmltbl.xsl\r
-\r
- Remove ambiguity wrt @span, @rowspan, and @colspan\r
-\r
-Manpages\r
-\r
-The following changes have been made to the manpages code since the 1.75.1\r
-release.\r
-\r
- ● Mauritz Jeanson: endnotes.xsl\r
-\r
- Added normalize-space() for ulink content. Closes bug #2793877.\r
-\r
- ● Mauritz Jeanson: docbook.xsl\r
-\r
- Added stylesheet.result.type test for copyright. Closes bug #2813289.\r
-\r
-Epub\r
-\r
-The following changes have been made to the epub code since the 1.75.1 release.\r
-\r
- ● Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb\r
-\r
- Corrected bugs caused by path and file assumptions were not met\r
-\r
- ● Keith Fahlgren: bin/lib/docbook.rb; docbook.xsl\r
-\r
- Cleaning up hardcoded values into parameters and fixing Ruby library to pass them properly; all thanks to patch from Liza Daly\r
-\r
-Profiling\r
-\r
-The following changes have been made to the profiling code since the 1.75.1\r
-release.\r
-\r
- ● Robert Stayton: profile.xsl\r
-\r
- Fix bug 2815493 missing exsl.node.set.available parameter.\r
-\r
-XSL-Saxon\r
-\r
-The following changes have been made to the xsl-saxon code since the 1.75.1\r
-release.\r
-\r
- ● Mauritz Jeanson: src/com/nwalsh/saxon/ColumnUpdateEmitter.java; src/com/\r
- nwalsh/saxon/Colum⋯\r
-\r
- Added fixes so that colgroups in the XHTML namespace are processed properly.\r
-\r
-XSL-Xalan\r
-\r
-The following changes have been made to the xsl-xalan code since the 1.75.1\r
-release.\r
-\r
- ● Mauritz Jeanson: nbproject/project.xml\r
-\r
- Added missing NetBeans configuration.\r
-\r
-Release Notes: 1.75.1\r
-\r
-This release includes bug fixes.\r
-\r
-The following is a list of changes that have been made since the 1.75.0\r
-release.\r
-\r
-FO\r
-\r
-The following changes have been made to the fo code since the 1.75.0 release.\r
-\r
- ● Keith Fahlgren: block.xsl\r
-\r
- Switching to em dash for character before attribution in epigraph; resolves Bug #2793878\r
-\r
- ● Robert Stayton: lists.xsl\r
-\r
- Fixed bug 2789947, id attribute missing on simplelist fo output.\r
-\r
-HTML\r
-\r
-The following changes have been made to the html code since the 1.75.0 release.\r
-\r
- ● Keith Fahlgren: block.xsl\r
-\r
- Switching to em dash for character before attribution in epigraph; resolves Bug #2793878\r
-\r
- ● Robert Stayton: lists.xsl\r
-\r
- Fixed bug 2789678: apply-templates line accidentally deleted.\r
-\r
-Epub\r
-\r
-The following changes have been made to the epub code since the 1.75.0 release.\r
-\r
- ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl\r
-\r
- Added regression and fix to correct "bug" with namespace-prefixed container elements in META-INF/container.xml ; resolves Issue #2790017\r
-\r
- ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/\r
- onegraphic.xinclude.xml;⋯\r
-\r
- Another attempt at flexible named entity and XInclude processing\r
-\r
- ● Keith Fahlgren: bin/lib/docbook.rb\r
-\r
- Tweaking solution to Bug #2750442 following regression reported by Michael Wiedmann.\r
-\r
-Params\r
-\r
-The following changes have been made to the params code since the 1.75.0\r
-release.\r
-\r
- ● Mauritz Jeanson: highlight.source.xml\r
-\r
- Updated documentation to reflect changes made in r8419.\r
-\r
-Release Notes: 1.75.0\r
-\r
-This release includes important bug fixes and adds the following significant\r
-feature changes:\r
-\r
-Gentext\r
-\r
- Modifications to translations have been made.\r
-\r
-Common\r
-\r
- Added support for some format properties on tables using HTML table markup.\r
-\r
- Added two new qanda.defaultlabel values so that numbered sections and\r
- numbered questions can be distinguished. Satisfies Feature Request #\r
- 1539045.\r
-\r
- Added code to handle acknowledgements in book and part. The element is\r
- processed similarly to dedication. All acknowledgements will appear as\r
- front matter, after any dedications.\r
-\r
-FO\r
-\r
- The inclusion of highlighting code has been simplified.\r
-\r
- Add support for pgwide on informal objects.\r
-\r
- Added a new parameter, bookmarks.collapse, that controls the initial state\r
- of the bookmark tree. Closes FR #1792326.\r
-\r
- Add support for more dbfo processing instructions.\r
-\r
- Add new variablelist.term.properties to format terms, per request #\r
- 1968513.\r
-\r
- Add support for @width on screen and programlisting, fixes bug #2012736.\r
-\r
- Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.\r
-\r
- Add writing.mode param for FO output.\r
-\r
-HTML\r
-\r
- Convert all calls to class.attribute to calls to common.html.attributes to\r
- support dir, lang, and title attributes in html output for all elements.\r
- Fulfills feature request #1993833.\r
-\r
- Inclusion of highlighting code was simplified. Only one import is now\r
- necessary.\r
-\r
- Add new param index.links.to.section.\r
-\r
- Add support for the new index.links.to.section param which permits precise\r
- links to indexterms in HTML output rather than to the section title.\r
-\r
-ePub\r
-\r
- Slightly more nuanced handling of imageobject alternatives and better\r
- support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442\r
- reported by Raphael Hertzog.\r
-\r
- Added a colon after an abstract/title when mapping into the dc:description\r
- for OPF metadata in ePub output to help the flat text have more\r
- pseudo-semantics (sugestions from Michael Wiedmann)\r
-\r
- Added DocBook subjectset -> OPF dc:subject mapping and tests\r
-\r
- Added DocBook date -> OPF dc:date mapping and tests\r
-\r
- Added DocBook abstract -> OPF dc:description mapping and tests\r
-\r
- Added --output option to dbtoepub based on user request\r
-\r
-HTMLHelp\r
-\r
- Add support for generating olink target database for htmlhelp files.\r
-\r
-Params\r
-\r
- Add default setting for @rules attribute on HTML markup tables.\r
-\r
- Added a new parameter, bookmarks.collapse, that controls the initial state\r
- of the bookmark tree. When the parameter has a non-zero value (the\r
- default), only the top-level bookmarks are displayed initially. Otherwise,\r
- the whole tree of bookmarks is displayed. This is implemented for FOP 0.9X.\r
- Closes FR #1792326.\r
-\r
- Add new variablelist.term.properties to format terms, per request #\r
- 1968513.\r
-\r
- Add two new qanda.defaultlabel values so that numbered sections and\r
- numbered questions can be distinguished. Satisfies Feature Request #\r
- 1539045.\r
-\r
- Add param to control whether an index entry links to a section title or to\r
- the precise location of the indexterm.\r
-\r
- New attribute list for glossentry in glossary.\r
-\r
- New parameter to support @width on programlisting and screen.\r
-\r
- Add attribute-sets for formatting glossary terms and defs.\r
-\r
-Highlighting\r
-\r
- Inclusion of highlighting code was simplified. Only one import is now\r
- necessary.\r
-\r
-The following is a list of changes that have been made since the 1.74.3\r
-release.\r
-\r
-Gentext\r
-\r
-The following changes have been made to the gentext code since the 1.74.3\r
-release.\r
-\r
- ● Robert Stayton: locale/sv.xml; locale/ja.xml; locale/pl.xml\r
-\r
- Check in translations of Legalnotice submitted on mailing list.\r
-\r
- ● Robert Stayton: locale/es.xml\r
-\r
- Fix spelling errors in Acknowledgements entries.\r
-\r
- ● Robert Stayton: locale/es.xml\r
-\r
- Check in translations for 4 elements submitted through docbook-apps\r
- message of 14 April 2009.\r
-\r
- ● David Cramer: locale/zh.xml; locale/ca.xml; locale/ru.xml; locale/ga.xml;\r
- locale/gl.xml; l⋯\r
-\r
- Internationalized punctuation in glosssee and glossseealso\r
-\r
- ● Robert Stayton: Makefile\r
-\r
- Check in fixes for DSSSL gentext targets from submitted patch #1689633.\r
-\r
- ● Robert Stayton: locale/uk.xml\r
-\r
- Check in major update submitted with bug report #2008524.\r
-\r
- ● Robert Stayton: locale/zh_tw.xml\r
-\r
- Check in fix to Note string submitted in bug #2441051.\r
-\r
- ● Robert Stayton: locale/ru.xml\r
-\r
- Checkin typo fix submitted in bug #2453406.\r
-\r
-Common\r
-\r
-The following changes have been made to the common code since the 1.74.3\r
-release.\r
-\r
- ● Robert Stayton: gentext.xsl\r
-\r
- Fix extra generated space when xrefstyle includes 'nopage'.\r
-\r
- ● Robert Stayton: table.xsl\r
-\r
- Add support for some format properties on tables using\r
- HTML table markup. These include:\r
- - frame attribute on table (or uses $default.table.frame parameter).\r
- - rules attribute on table (or uses $default.table.rules parameter).\r
- - align attribute on td and th\r
- - valign attribute on td and th\r
- - colspan on td and th\r
- - rowspan on td and th\r
- - bgcolor on td and th\r
-\r
- ● Robert Stayton: olink.xsl\r
-\r
- Add placeholder template to massage olink hot text to make\r
- customization easier, per Feature Request 1828608.\r
-\r
- ● Robert Stayton: targets.xsl\r
-\r
- Add support for collecting olink targets from a glossary\r
- generated from a glossary.collection.\r
-\r
- ● Robert Stayton: titles.xsl\r
-\r
- Handle firstterm like glossterm in mode="title.markup".\r
-\r
- ● Robert Stayton: titles.xsl\r
-\r
- Add match on info/title in title.markup templates where missing.\r
-\r
- ● Mauritz Jeanson: titles.xsl\r
-\r
- Changed "ancestor::title" to "(ancestor::title and (@id or @xml:id))".\r
- This enables proper formatting of inline elements in titles in TOCs,\r
- as long as these inlines don't have id or xml:id attributes.\r
-\r
- ● Robert Stayton: labels.xsl\r
-\r
- Add two new qanda.defaultlabel values so that numbered sections\r
- and numbered questions can be distinguished. Satisfies\r
- Feature Request #1539045.\r
-\r
- ● Robert Stayton: stripns.xsl; pi.xsl\r
-\r
- Convert function-available(exsl:node-set) to use the new param\r
- so Xalan bug is isolated.\r
-\r
- ● Mauritz Jeanson: titles.xsl\r
-\r
- Added fixes for bugs #2112656 and #1759205:\r
- 1. Reverted mistaken commits r7485 and r7523.\r
- 2. Updated the template with match="link" and mode="no.anchor.mode" so that\r
- @endterm is used if it exists and if the link has no content.\r
-\r
- ● Mauritz Jeanson: titles.xsl\r
-\r
- Added code to handle acknowledgements in book and part. The element is processed\r
- similarly to dedication. All acknowledgements will appear as front matter, after\r
- any dedications.\r
-\r
- ● Robert Stayton: olink.xsl\r
-\r
- Fix bug #2018717 use.local.olink.style uses wrong gentext context.\r
-\r
- ● Robert Stayton: olink.xsl\r
-\r
- Fix bug #1787167 incorrect hot text for some olinks.\r
-\r
- ● Robert Stayton: common.xsl\r
-\r
- Fix bug #1669654 Broken output if copyright <year> contains a range.\r
-\r
- ● Robert Stayton: labels.xsl\r
-\r
- Fix bug in labelling figure inside appendix inside article inside book.\r
-\r
-FO\r
-\r
-The following changes have been made to the fo code since the 1.74.3 release.\r
-\r
- ● Jirka Kosek: highlight.xsl\r
-\r
- Inclusion of highlighting code was simplified. Only one import is now necessary.\r
-\r
- ● Robert Stayton: fop1.xsl\r
-\r
- Add the new fop extensions namespace declaration, in case FOP\r
- extension functions are used.\r
-\r
- ● Robert Stayton: formal.xsl\r
-\r
- Add support for pgwide on informal objects.\r
-\r
- ● Robert Stayton: docbook.xsl\r
-\r
- Fixed spurious closing quote on line 134.\r
-\r
- ● Robert Stayton: docbook.xsl; autoidx-kosek.xsl; autoidx.xsl\r
-\r
- Convert function-available for node-set() to use\r
- new $exsl.node.set.available param in test.\r
-\r
- ● David Cramer: xref.xsl\r
-\r
- Suppress extra space after xref when xrefstyle='select: label nopage' (#2740472)\r
-\r
- ● Mauritz Jeanson: pi.xsl\r
-\r
- Fixed doc bug for row-height.\r
-\r
- ● David Cramer: glossary.xsl\r
-\r
- Internationalized punctuation in glosssee and glossseealso\r
-\r
- ● Robert Stayton: param.xweb; param.ent; htmltbl.xsl; table.xsl\r
-\r
- Add support for some format properties on tables using\r
- HTML table markup. These include:\r
- - frame attribute on table (or uses $default.table.frame parameter).\r
- - rules attribute on table (or uses $default.table.rules parameter).\r
- - align attribute on td and th\r
- - valign attribute on td and th\r
- - colspan on td and th\r
- - rowspan on td and th\r
- - bgcolor on td and th\r
-\r
- ● Robert Stayton: table.xsl\r
-\r
- Add support bgcolor in td and th\r
- elements in HTML table markup.\r
-\r
- ● Robert Stayton: htmltbl.xsl\r
-\r
- Add support for colspan and rowspan and bgcolor in td and th\r
- elements in HTML table markup.\r
-\r
- ● Robert Stayton: param.xweb\r
-\r
- Fix working of page-master left and right margins.\r
-\r
- ● Mauritz Jeanson: param.xweb; param.ent; fop1.xsl\r
-\r
- Added a new parameter, bookmarks.collapse, that controls the initial state of the bookmark tree. When the parameter has a non-zero value (the default), only the top-level bookmarks are displayed initially. Otherwise, the whole tree of bookmarks is displayed. This is implemented for FOP 0.9X. Closes FR #1792326.\r
-\r
- ● Robert Stayton: table.xsl; pi.xsl\r
-\r
- Add support for dbfo row-height processing instruction, like that in dbhtml.\r
-\r
- ● Robert Stayton: lists.xsl\r
-\r
- Add support for dbfo keep-together processing instruction for\r
- entire list instances.\r
-\r
- ● Robert Stayton: lists.xsl; block.xsl\r
-\r
- Add support fo dbfo keep-together processing instruction to\r
- more blocks like list items and paras.\r
-\r
- ● Robert Stayton: lists.xsl; param.xweb; param.ent\r
-\r
- Add new variablelist.term.properties to format terms, per request # 1968513.\r
-\r
- ● Robert Stayton: inline.xsl\r
-\r
- In simple.xlink, rearrange order of processing.\r
-\r
- ● Robert Stayton: xref.xsl\r
-\r
- Handle firstterm like glossterm in mode="xref-to".\r
-\r
- ● Robert Stayton: glossary.xsl; xref.xsl; pi.xsl; footnote.xsl\r
-\r
- Implement simple.xlink for glosssee and glossseealso so they can use\r
- other types of linking besides otherterm.\r
-\r
- ● Robert Stayton: qandaset.xsl\r
-\r
- Add two new qanda.defaultlabel values so that numbered sections and numbered questions can be distinguished. Satisfies Feature Request #1539045.\r
-\r
- ● Robert Stayton: titlepage.xsl\r
-\r
- For the book title templates, I changed info/title to book/info/title\r
- so other element's titles will not be affected.\r
-\r
- ● Robert Stayton: xref.xsl; verbatim.xsl\r
-\r
- Use param exsl.node.set.available to test for function.\r
-\r
- ● Robert Stayton: param.xweb; param.ent; footnote.xsl\r
-\r
- Start using new param exsl.node.set.available to work around Xalan bug.\r
-\r
- ● Robert Stayton: titlepage.templates.xml\r
-\r
- Add comment on use of t:predicate for editor to prevent\r
- extra processing of multiple editors. Fixes bug 2687842.\r
-\r
- ● Robert Stayton: xref.xsl; autoidx.xsl\r
-\r
- An indexterm primary, secondary, or tertiary element with an id or xml:id\r
- now outputs that ID, so that index entries can be cross referenced to.\r
-\r
- ● Mauritz Jeanson: synop.xsl\r
-\r
- Added modeless template for ooclass|oointerface|ooexception.\r
- Closes bug #1623468.\r
-\r
- ● Robert Stayton: xref.xsl\r
-\r
- Add template with match on indexterm in mode="xref-to" to fix bug 2102592.\r
-\r
- ● Robert Stayton: xref.xsl\r
-\r
- Now xref to qandaentry will use the label element in a question for\r
- the link text if it has one.\r
-\r
- ● Robert Stayton: inline.xsl\r
-\r
- Add id if specified from @id to output for quote and phrase so\r
- they can be xref'ed to.\r
-\r
- ● Robert Stayton: xref.xsl\r
-\r
- Add support for xref to phrase, simpara, anchor, and quote.\r
- This assumes the author specifies something using xrefstyle since\r
- the elements don't have ordinary link text.\r
-\r
- ● Robert Stayton: toc.xsl\r
-\r
- Fix bug in new toc templates.\r
-\r
- ● Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl;\r
- titlepage.templates⋯\r
-\r
- Added code to handle acknowledgements in book and part. The element is processed\r
- similarly to dedication. All acknowledgements will appear as front matter, after\r
- any dedications.\r
-\r
- ● Robert Stayton: toc.xsl\r
-\r
- Rewrite toc templates to support an empty toc or populated toc\r
- in all permitted contexts. Same for lot elements.\r
- This fixes bug #1595969 for FO outputs.\r
-\r
- ● Robert Stayton: index.xsl\r
-\r
- Fix indents for seealsoie so they are consistent.\r
-\r
- ● Mauritz Jeanson: param.xweb\r
-\r
- Removed duplicate (monospace.font.family).\r
-\r
- ● Robert Stayton: param.xweb; param.ent\r
-\r
- Add glossentry.list.item.properties.\r
-\r
- ● Robert Stayton: param.xweb; param.ent\r
-\r
- Add monospace.verbatim.font.width param to support @width on programlisting.\r
-\r
- ● Robert Stayton: verbatim.xsl\r
-\r
- Put programlisting in fo:block-container with writing-mode="lr-tb"\r
- when text direction is right to left because all program languages\r
- are left-to-right.\r
-\r
- ● Robert Stayton: verbatim.xsl\r
-\r
- Add support for @width on screen and programlisting, fixes bug #2012736.\r
-\r
- ● Robert Stayton: xref.xsl\r
-\r
- Fix bug #1973585 xref to para with xrefstyle not handled correctly.\r
-\r
- ● Mauritz Jeanson: block.xsl\r
-\r
- Added support for acknowledgements in article.\r
- Support in book/part remains to be added.\r
-\r
- ● Robert Stayton: xref.xsl\r
-\r
- Fix bug #1787167 incorrect hot text for some olinks.\r
-\r
- ● Robert Stayton: fo.xsl\r
-\r
- Add writing-mode="tb-rl" as well since some XSL-FO processors support it.\r
-\r
- ● Robert Stayton: autotoc.xsl; lists.xsl; glossary.xsl; fo.xsl; table.xsl;\r
- pagesetup.xsl\r
-\r
- Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.\r
- Changed instances of margin-left to margin-{$direction.align.start}\r
- and margin-right to margin-{$direction.align.end}. Those direction.align\r
- params are computed from the writing mode value in each locale's\r
- gentext key named 'writing-mode', introduced in 1.74.3 to add\r
- right-to-left support to HTML outputs.\r
-\r
- ● Robert Stayton: param.xweb; param.ent\r
-\r
- Add attribute-sets for formatting glossary terms and defs.\r
-\r
- ● Robert Stayton: param.xweb; param.ent\r
-\r
- Add writing.mode param for FO output.\r
-\r
- ● Robert Stayton: autotoc.xsl\r
-\r
- Fix bug 1546008: in qandaentry in a TOC, use its blockinfo/titleabbrev or blockinfo/title\r
- instead of question, if available. For DocBook 5, use the info versions.\r
-\r
- ● Keith Fahlgren: verbatim.xsl\r
-\r
- Add better pointer to README for XSLTHL\r
-\r
- ● Keith Fahlgren: verbatim.xsl\r
-\r
- More tweaking the way that XSLTHL does or does not get called\r
-\r
- ● Keith Fahlgren: verbatim.xsl\r
-\r
- Alternate attempt at sanely including/excluding XSLTHT code\r
-\r
-HTML\r
-\r
-The following changes have been made to the html code since the 1.74.3 release.\r
-\r
- ● Robert Stayton: lists.xsl\r
-\r
- Removed redundant lang and title attributes on list element inside\r
- div element for lists.\r
-\r
- ● Robert Stayton: inline.xsl; titlepage.xsl; division.xsl; toc.xsl;\r
- sections.xsl; table.xsl;⋯\r
-\r
- Convert all calls to class.attribute to calls to common.html.attributes\r
- to support dir, lang, and title attributes in html output for all elements.\r
- Fulfills feature request #1993833.\r
-\r
- ● Robert Stayton: chunk-common.xsl\r
-\r
- Fix bug #2750253 wrong links in list of figures in chunk.html\r
- when target html is in a subdirectory and dbhtml filename used.\r
-\r
- ● Jirka Kosek: highlight.xsl\r
-\r
- Inclusion of highlighting code was simplified. Only one import is now necessary.\r
-\r
- ● Robert Stayton: chunk-common.xsl; chunktoc.xsl; docbook.xsl;\r
- chunk-changebars.xsl; autoidx⋯\r
-\r
- Convert function-available for node-set() to use\r
- new $exsl.node.set.available param in test.\r
-\r
- ● Mauritz Jeanson: pi.xsl\r
-\r
- Fixed doc bug for row-height.\r
-\r
- ● David Cramer: glossary.xsl\r
-\r
- Internationalized punctuation in glosssee and glossseealso\r
-\r
- ● Robert Stayton: lists.xsl; html.xsl; block.xsl\r
-\r
- More elements get common.html.attributes.\r
- Added locale.html.attributes template which does the lang,\r
- dir, and title attributes, but not the class attribute\r
- (used on para, for example).\r
-\r
- ● Robert Stayton: lists.xsl\r
-\r
- Replace more literal class atts with mode="class.attribute" to support\r
- easier customization.\r
-\r
- ● Robert Stayton: glossary.xsl\r
-\r
- Support olinking in glosssee and glossseealso.\r
-\r
- ● Robert Stayton: inline.xsl\r
-\r
- In simple.xlink, rearrange order of processing.\r
-\r
- ● Robert Stayton: xref.xsl\r
-\r
- Handle firstterm like glossterm in mode="xref-to".\r
-\r
- ● Robert Stayton: lists.xsl; html.xsl; block.xsl\r
-\r
- Added template named common.html.attributes to output\r
- class, title, lang, and dir for most elements.\r
- Started adding it to some list and block elements.\r
-\r
- ● Robert Stayton: qandaset.xsl\r
-\r
- Add two new qanda.defaultlabel values so that numbered sections\r
- and numbered questions can be distinguished. Satisfies\r
- Feature Request #1539045.\r
-\r
- ● Robert Stayton: param.xweb; chunk-code.xsl; param.ent; xref.xsl;\r
- chunkfast.xsl; verbatim.x⋯\r
-\r
- Use new param exsl.node.set.available to test, handles Xalan bug.\r
-\r
- ● Robert Stayton: autoidx.xsl\r
-\r
- Use named anchors for primary, secondary, and tertiary ids so\r
- duplicate entries with different ids can still have an id output.\r
-\r
- ● Robert Stayton: param.xweb; param.ent\r
-\r
- Add new param index.links.to.section.\r
-\r
- ● Robert Stayton: xref.xsl; autoidx.xsl\r
-\r
- Pass through an id on primary, secondary, or tertiary to\r
- the index entry, so that one could link to an index entry.\r
- You can't link to the id on an indexterm because that is\r
- used to place the main anchor in the text flow.\r
-\r
- ● Robert Stayton: autoidx.xsl\r
-\r
- Add support for the new index.links.to.section param which permits\r
- precise links to indexterms in HTML output rather than to\r
- the section title.\r
-\r
- ● Mauritz Jeanson: synop.xsl\r
-\r
- Added modeless template for ooclass|oointerface|ooexception.\r
- Closes bug #1623468.\r
-\r
- ● Robert Stayton: qandaset.xsl\r
-\r
- Make sure a qandaset has an anchor, even when it has no title,\r
- because it may be referenced in a TOC or xref.\r
- Before, the anchor was output by the title, but there was no\r
- anchor if there was no title.\r
-\r
- ● Robert Stayton: xref.xsl\r
-\r
- Add a template for indexterm with mode="xref-to" to fix bug 2102592.\r
-\r
- ● Robert Stayton: xref.xsl\r
-\r
- Now xref to qandaentry will use the label element in a question for\r
- the link text if it has one.\r
-\r
- ● Robert Stayton: qandaset.xsl; html.xsl\r
-\r
- Create separate templates for computing label of question and answer\r
- in a qandaentry, so such can be used for the alt text of an xref\r
- to a qandaentry.\r
-\r
- ● Robert Stayton: inline.xsl; xref.xsl\r
-\r
- Now support xref to phrase, simpara, anchor, and quote,\r
- most useful when an xrefstyle is used.\r
-\r
- ● Robert Stayton: toc.xsl\r
-\r
- Rewrite toc templates to support an empty toc or populated toc\r
- in all permitted contexts. Same for lot elements.\r
- This fixes bug #1595969 for HTML outputs.\r
-\r
- ● Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl;\r
- titlepage.templates⋯\r
-\r
- Added code to handle acknowledgements in book and part. The element is processed\r
- similarly to dedication. All acknowledgements will appear as front matter, after\r
- any dedications.\r
-\r
- ● Robert Stayton: index.xsl\r
-\r
- Rewrote primaryie, secondaryie and tertiaryie templates to handle\r
- nesting of elements and seeie and seealsoie, as reported in\r
- bug # 1168912.\r
-\r
- ● Robert Stayton: autotoc.xsl\r
-\r
- Fix simplesect in toc problem.\r
-\r
- ● Robert Stayton: verbatim.xsl\r
-\r
- Add support for @width per bug report #2012736.\r
-\r
- ● Robert Stayton: formal.xsl; htmltbl.xsl\r
-\r
- Fix bug #1787140 HTML tables not handling attributes correctly.\r
-\r
- ● Robert Stayton: param.xweb\r
-\r
- Move writing-mode param.\r
-\r
- ● Keith Fahlgren: refentry.xsl\r
-\r
- Remove a nesting of <p> inside <p> for refclass (made XHTML* invalid, made HTML silly)\r
-\r
- ● Robert Stayton: table.xsl\r
-\r
- Fix bug #1945872 to allow passthrough of colwidth values to\r
- HTML table when no tablecolumns.extension is available and\r
- when no instance of * appears in the table's colspecs.\r
-\r
- ● Mauritz Jeanson: block.xsl\r
-\r
- Added support for acknowledgements in article.\r
- Support in book/part remains to be added.\r
-\r
- ● Robert Stayton: chunk-common.xsl\r
-\r
- Fix bug #1787167 incorrect hot text for some olinks.\r
-\r
- ● Robert Stayton: qandaset.xsl\r
-\r
- Fix bug 1546008: in qandaentry in a TOC, use its blockinfo/titleabbrev or blockinfo/title\r
- instead of question, if available. For DocBook 5, use the info versions.\r
-\r
- ● Robert Stayton: chunktoc.xsl\r
-\r
- Add support for generating olink database when using chunktoc.xsl.\r
-\r
- ● Keith Fahlgren: verbatim.xsl\r
-\r
- Add better pointer to README for XSLTHL\r
-\r
- ● Keith Fahlgren: verbatim.xsl\r
-\r
- Another stab at fixing the stupid XSLTHT includes across processors (Saxon regression reported by Sorin Ristache)\r
-\r
- ● Keith Fahlgren: verbatim.xsl\r
-\r
- More tweaking the way that XSLTHL does or does not get called\r
-\r
- ● Keith Fahlgren: verbatim.xsl\r
-\r
- Alternate attempt at sanely including/excluding XSLTHT code\r
-\r
-Manpages\r
-\r
-The following changes have been made to the manpages code since the 1.74.3\r
-release.\r
-\r
- ● Robert Stayton: table.xsl\r
-\r
- Convert function-available test for node-set() function to\r
- test of $exsl.node.set.available param.\r
-\r
- ● Mauritz Jeanson: lists.xsl\r
-\r
- Added a template for bibliolist. Closes bug #1815916.\r
-\r
-ePub\r
-\r
-The following changes have been made to the epub code since the 1.74.3 release.\r
-\r
- ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/\r
- onegraphic.xinclude.xml;⋯\r
-\r
- Slightly more nuanced handling of imageobject alternatives and better support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442 reported by Raphael Hertzog.\r
-\r
- ● Keith Fahlgren: docbook.xsl\r
-\r
- Add a colon after an abstract/title when mapping into the dc:description for OPF metadata in ePub output to help the flat text have more pseudo-semantics (sugestions from Michael Wiedmann)\r
-\r
- ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/\r
- files/de.xml\r
-\r
- Correctly set dc:language in OPF metadata when i18nizing. Closes Bug #2755150\r
-\r
- ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl\r
-\r
- Corrected namespace declarations for literal XHTML elements to make them serialize "normally"\r
-\r
- ● Keith Fahlgren: docbook.xsl\r
-\r
- Be a little bit more nuanced about dates\r
-\r
- ● Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files\r
- /orm.book.001.x⋯\r
-\r
- Add DocBook subjectset -> OPF dc:subject mapping and tests\r
-\r
- ● Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files\r
- /orm.book.001.x⋯\r
-\r
- Add DocBook date -> OPF dc:date mapping and tests\r
-\r
- ● Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files\r
- /orm.book.001.x⋯\r
-\r
- Add DocBook abstract -> OPF dc:description mapping and tests\r
-\r
- ● Robert Stayton: docbook.xsl\r
-\r
- Check in patch submitted by user to add opf:file-as attribute\r
- to dc:creator element.\r
-\r
- ● Keith Fahlgren: bin/dbtoepub\r
-\r
- Adding --output option to dbtoepub based on user request\r
-\r
- ● Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb\r
-\r
- Cleaning and regularizing the generation of namespaced nodes for OPF, NCX, XHTML and other outputted filetypes (hat tip to bobstayton for pointing out the silly, incorrect code)\r
-\r
- ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/\r
- refclass.xml\r
-\r
- Remove a nesting of <p> inside <p> for refclass (made XHTML* invalid, made HTML silly)\r
-\r
- ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/\r
- blockquotepre.xml\r
-\r
- Added regression test and fix for XHTML validation problem with <a>s added inside <blockquote>; This potentially causes another problem (where something is referenced by has no anchor, but someone reporting that should cause the whole <a id='thing'/> thing to be reconsidered with modern browsers in mind.\r
-\r
-HTMLHelp\r
-\r
-The following changes have been made to the htmlhelp code since the 1.74.3\r
-release.\r
-\r
- ● Robert Stayton: htmlhelp-common.xsl\r
-\r
- Add support for generating olink target database for htmlhelp files.\r
-\r
-Params\r
-\r
-The following changes have been made to the params code since the 1.74.3\r
-release.\r
-\r
- ● Robert Stayton: default.table.rules.xml\r
-\r
- Add default setting for @rules attribute on HTML markup tables.\r
-\r
- ● Mauritz Jeanson: bookmarks.collapse.xml\r
-\r
- Added a new parameter, bookmarks.collapse, that controls the initial state\r
- of the bookmark tree. When the parameter has a non-zero value (the default),\r
- only the top-level bookmarks are displayed initially. Otherwise, the whole\r
- tree of bookmarks is displayed.\r
-\r
- This is implemented for FOP 0.9X. Closes FR #1792326.\r
-\r
- ● Robert Stayton: variablelist.term.properties.xml\r
-\r
- Add new variablelist.term.properties to format terms, per\r
- request # 1968513.\r
-\r
- ● Robert Stayton: qanda.defaultlabel.xml\r
-\r
- Add two new qanda.defaultlabel values so that numbered sections\r
- and numbered questions can be distinguished. Satisfies\r
- Feature Request #1539045.\r
-\r
- ● Robert Stayton: index.links.to.section.xml\r
-\r
- Change default to 1 to match past behavior.\r
-\r
- ● Robert Stayton: exsl.node.set.available.xml\r
-\r
- Isolate this text for Xalan bug regarding exsl:node-set available.\r
- If it is ever fixed in Xalan, just fix it here.\r
-\r
- ● Robert Stayton: index.links.to.section.xml\r
-\r
- Add param to control whether an index entry links to\r
- a section title or to the precise location of the\r
- indexterm.\r
-\r
- ● Robert Stayton: glossentry.list.item.properties.xml\r
-\r
- New attribute list for glossentry in glossary.\r
-\r
- ● Robert Stayton: monospace.verbatim.font.width.xml\r
-\r
- New parameter to support @width on programlisting and screen.\r
-\r
- ● Mauritz Jeanson: highlight.source.xml\r
-\r
- Updated and reorganized the description.\r
-\r
- ● Robert Stayton: page.margin.outer.xml; page.margin.inner.xml\r
-\r
- Add caveat about XEP bug when writing-mode is right-to-left.\r
-\r
- ● Robert Stayton: article.appendix.title.properties.xml; writing.mode.xml;\r
- body.start.indent⋯\r
-\r
- Change 'left' to 'start' and 'right' to 'end' to support right-to-left\r
- writing mode.\r
-\r
- ● Robert Stayton: glossdef.block.properties.xml;\r
- glossdef.list.properties.xml; glossterm.blo⋯\r
-\r
- Add attribute-sets for formatting glossary terms and defs.\r
-\r
- ● Robert Stayton: glossterm.separation.xml\r
-\r
- Clarify the description.\r
-\r
- ● Robert Stayton: make.year.ranges.xml\r
-\r
- Now handles year element containing a comma or dash without error.\r
-\r
-Highlighting\r
-\r
-The following changes have been made to the highlighting code since the 1.74.3\r
-release.\r
-\r
- ● Jirka Kosek: README\r
-\r
- Inclusion of highlighting code was simplified. Only one import is now necessary.\r
-\r
- ● Keith Fahlgren: README\r
-\r
- Adding XSLTHL readme\r
-\r
- ● Keith Fahlgren: common.xsl\r
-\r
- Alternate attempt at sanely including/excluding XSLTHT code\r
-\r
-XSL-Saxon\r
-\r
-The following changes have been made to the xsl-saxon code since the 1.74.3\r
-release.\r
-\r
- ● Mauritz Jeanson: src/com/nwalsh/saxon/Text.java\r
-\r
- Added a fix that prevents output of extra blank line.\r
- Hopefully this closes bug #894805.\r
-\r
-XSL-Xalan\r
-\r
-The following changes have been made to the xsl-xalan code since the 1.74.3\r
-release.\r
-\r
- ● Mauritz Jeanson: src/com/nwalsh/xalan/Text.java\r
-\r
- Added a fix that prevents output of extra blank line.\r
- Hopefully this closes bug #894805.\r
-\r
-Release Notes: 1.74.3\r
-\r
-This release fixes some bugs in the 1.74.2 release.\r
-\r
-See highlighting/README for XSLTHL usage instructions.\r
-\r
-Release Notes: 1.74.2\r
-\r
-This release fixes some bugs in the 1.74.1 release.\r
-\r
-Release Notes: 1.74.1\r
-\r
-This release includes important bug fixes and adds the following significant\r
-feature changes:\r
-\r
-Gentext\r
-\r
- Kirghiz locale added and Chinese translations have been simplified.\r
-\r
- Somme support for gentext and right-to-left languages has been added.\r
-\r
-FO\r
-\r
- Various bugs have been resolved.\r
-\r
- Support for a new processing instruction: dbfo funcsynopsis-style has been\r
- added.\r
-\r
- Added new param email.mailto.enabled for FO output. Patch from Paolo\r
- Borelli.\r
-\r
- Support for documented metadata in fop1 mode has been added.\r
-\r
-Highlighting\r
-\r
- Support for the latest version of XSLTHL 2.0 and some new language syntaxes\r
- have been added to a variety of outputs.\r
-\r
-Manpages\r
-\r
- Added man.output.better.ps.enabled param (zero default). It non-zero, no\r
- such markup is embedded in generated man pages, and no enhancements are\r
- included in the PostScript output generated from those man pages by the man\r
- -Tps command.\r
-\r
-HTML\r
-\r
- Support for writing.mode to set text direction and alignment based on\r
- document locale has been added.\r
-\r
- Added a new top-level stylesheet module, chunk-changebars.xsl, to be used\r
- for generating chunked output with highlighting based on change\r
- (@revisionflag) markup. The module imports/includes the standard chunking\r
- and changebars templates and contains additional logic for chunked output.\r
- See FRs #1015180 and #1819915.\r
-\r
-ePub\r
-\r
- Covers now look better in Adobe Digital Editions thanks to a patch from\r
- Paul Norton of Adobe\r
-\r
- Cover handling now more generic (including limited DocBook 5.0 cover\r
- support thanks to patch contributed by Liza Daly.\r
-\r
- Cover markup now carries more reliably into files destined for .mobi and\r
- the Kindle.\r
-\r
- dc:identifiers are now generated from more types of numbering schemes.\r
-\r
- Both SEO and semantic structure of chunked ePub output by ensuring that we\r
- always send out one and only one h1 in each XHTML chunk.\r
-\r
- Primitive support for embedding a single font added.\r
-\r
- Support for embedding a CSS customizations added.\r
-\r
-Roundtrip\r
-\r
- Support for imagedata-metadata and table as images added.\r
-\r
- Support for imagedata-metadata and legalnotice as images added.\r
-\r
-Params\r
-\r
- man.output.better.ps.enabled added for Manpages output\r
-\r
- writing.mode.xml added to set text direction.\r
-\r
- Added new param email.mailto.enabled for FO output. Patch from Paolo\r
- Borelli. Closes #2086321.\r
-\r
- highlight.source upgraded to support the latest version of XSLTHL 2.0.\r
-\r
-The following is a list of changes that have been made since the 1.74.0\r
-release.\r
-\r
-Gentext\r
-\r
-The following changes have been made to the gentext code since the 1.74.0\r
-release.\r
-\r
- ● Michael(tm) Smith: locale/ky.xml; Makefile\r
-\r
- new Kirghiz locale from Ilyas Bakirov\r
-\r
- ● Mauritz Jeanson: locale/en.xml\r
-\r
- Added "Acknowledgements".\r
-\r
- ● Dongsheng Song: locale/zh_cn.xml\r
-\r
- Simplified Chinese translation.\r
-\r
- ● Robert Stayton: locale/lv.xml; locale/ca.xml; locale/pt.xml; locale/tr.xml;\r
- locale/af.xml;⋯\r
-\r
- Add writing-mode gentext string to support right-to-left languages.\r
-\r
-FO\r
-\r
-The following changes have been made to the fo code since the 1.74.0 release.\r
-\r
- ● David Cramer: footnote.xsl\r
-\r
- Added a check to confirm that a footnoteref's linkend points to a footnote. Stylesheets stop processing if not and provide a useful error message.\r
-\r
- ● Mauritz Jeanson: spaces.xsl\r
-\r
- Convert spaces to fo:leader also in elements in the DB 5 namespace.\r
-\r
- ● Mauritz Jeanson: pi.xsl; synop.xsl\r
-\r
- Added support for a new processing instruction: dbfo funcsynopsis-style.\r
- Closes bug #1838213.\r
-\r
- ● Michael(tm) Smith: inline.xsl; param.xweb; param.ent\r
-\r
- Added new param email.mailto.enabled for FO output.\r
- Patch from Paolo Borelli. Closes #2086321.\r
-\r
- ● Mauritz Jeanson: docbook.xsl\r
-\r
- Added support for document metadata for fop1 (patch #2067318).\r
-\r
- ● Jirka Kosek: param.ent; param.xweb; highlight.xsl\r
-\r
- Upgraded to support the latest version of XSLTHL 2.0\r
- -- nested markup in highlited code is now processed\r
- -- it is no longer needed to specify path XSLTHL configuration file using Java property\r
- -- support for new languages, including Perl, Python and Ruby was added\r
-\r
-HTML\r
-\r
-The following changes have been made to the html code since the 1.74.0 release.\r
-\r
- ● Robert Stayton: param.xweb; docbook.xsl; param.ent; html.xsl\r
-\r
- Add support for writing.mode to set text direction and alignment based on document locale.\r
-\r
- ● Mauritz Jeanson: chunk-changebars.xsl\r
-\r
- Added a new top-level stylesheet module, chunk-changebars.xsl, to be\r
- used for generating chunked output with highlighting based on change\r
- (@revisionflag) markup. The module imports/includes the standard chunking\r
- and changebars templates and contains additional logic for chunked output.\r
- See FRs #1015180 and #1819915.\r
-\r
-Manpages\r
-\r
-The following changes have been made to the manpages code since the 1.74.0\r
-release.\r
-\r
- ● Michael(tm) Smith: docbook.xsl\r
-\r
- Put the following at the top of generated roff for each page:\r
- \" t\r
- purpose is to explicitly tell AT&T troff that the page needs to be\r
- pre-processed through tbl(1); groff can figure it out\r
- automatically, but apparently AT&T troff needs to be explicitly told\r
-\r
-ePub\r
-\r
-The following changes have been made to the epub code since the 1.74.0 release.\r
-\r
- ● Keith Fahlgren: docbook.xsl\r
-\r
- Patch from Paul Norton of Adobe to get covers to look better in Adobe Digital Editions\r
-\r
- ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/\r
- v5cover.xml; bin/spec/sp⋯\r
-\r
- Patch contributed by Liza Daly to make ePub cover handling more generic. Additionally\r
- DocBook 5.0's <cover> now has some limited support:\r
-\r
- - should reference a cover in the OPF guide for a DocBook 5.0 test document\r
-\r
- ● Keith Fahlgren: bin/spec/files/isbn.xml; bin/spec/files/issn.xml; bin/spec/\r
- files/biblioid.⋯\r
-\r
- Liza Daly reported that the dc:identifer-generation code was garbage (she was right).\r
-\r
- Added new tests:\r
- - should include at least one dc:identifier\r
- - should include an ISBN as URN for dc:identifier if an ISBN was in the metadata\r
- - should include an ISSN as URN for dc:identifier if an ISSN was in the metadata\r
- - should include an biblioid as a dc:identifier if an biblioid was in the metadata\r
- - should include a URN for a biblioid with @class attribute as a dc:identifier if an biblioid was in the metadata\r
-\r
- ● Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb\r
-\r
- Improve both SEO and semantic structure of chunked ePub output by ensuring that\r
- we always send out one and only one h1 in each XHTML chunk.\r
-\r
- DocBook::Epub\r
- - should include one and only one <h1> in each HTML file in rendered ePub files\r
- for <book>s\r
- - should include one and only one <h1> in each HTML file in rendered ePub files\r
- for <book>s even if they do not have section markup\r
-\r
- ● Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files\r
- /orm.book.001.x⋯\r
-\r
- Adding better support for covers in epub files destined for .mobi and the Kindle\r
-\r
- ● Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/\r
- DejaVuSerif.otf; docbook.⋯\r
-\r
- Adding primitive support for embedding a single font\r
-\r
- ● Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/\r
- test_cust.xsl; bin/spec/e⋯\r
-\r
- Adding support for user-specified customization layers in dbtoepub\r
-\r
- ● Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/\r
- docbook.rb; bin/s⋯\r
-\r
- Adding CSS support to .epub target & dbtoepub:\r
- -c, --css [FILE] Use FILE for CSS on generated XHTML.\r
-\r
-\r
- DocBook::Epub\r
- ...\r
- - should include a CSS link in HTML files when a CSS file has been provided\r
- - should include CSS file in .epub when a CSS file has been provided\r
- - should include a CSS link in OPF file when a CSS file has been provided\r
-\r
-Roundtrip\r
-\r
-The following changes have been made to the roundtrip code since the 1.74.0\r
-release.\r
-\r
- ● Steve Ball: blocks2dbk.xsl; template.xml; template.dot\r
-\r
- added support for imagedata-metadata\r
- added support for table as images\r
-\r
- ● Steve Ball: blocks2dbk.xsl; normalise2sections.xsl; sections2blocks.xsl\r
-\r
- Improved support for personname inlines.\r
-\r
- ● Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml\r
-\r
- Added support for legalnotice.\r
-\r
- ● Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl\r
-\r
- added support for orgname in author\r
-\r
- ● Steve Ball: specifications.xml; supported.xml; blocks2dbk.xsl;\r
- wordml2normalise.xsl; dbk2w⋯\r
-\r
- Updated specification.\r
- to-DocBook: add cols attribute to tgroup\r
- from-DocBook: fix for blockquote title\r
-\r
-Params\r
-\r
-The following changes have been made to the params since the 1.74.0 release.\r
-\r
- ● The change was to add man.output.better.ps.enabled parameter, with its\r
- default value set to zero. If the value of the man.output.better.ps.enabled\r
- parameter is non-zero, certain markup is embedded in each generated man\r
- page such that PostScript output from the man -Tps command for that page\r
- will include a number of enhancements designed to improve the quality of\r
- that output. If man.output.better.ps.enabled is zero (the default), no such\r
- markup is embedded in generated man pages, and no enhancements are included\r
- in the PostScript output generated from those man pages by the man -Tps\r
- command. WARNING: The enhancements provided by this parameter rely on\r
- features that are specific to groff (GNU troff) and that are not part of\r
- "classic" AT&T troff or any of its derivatives. Therefore, any man pages\r
- you generate with this parameter enabled will be readable only on systems\r
- on which the groff (GNU troff) program is installed, such as GNU/Linux\r
- systems. The pages will not not be readable on systems on with the classic\r
- troff (AT&T troff) command is installed. NOTE: The value of this parameter\r
- only affects PostScript output generated from the man command. It has no\r
- effect on output generated using the FO backend. TIP: You can generate\r
- PostScript output for any man page by running the following command: man\r
- FOO -Tps > FOO.ps You can then generate PDF output by running the following\r
- command: ps2pdf FOO.ps\r
-\r
- ● Robert Stayton: writing.mode.xml\r
-\r
- writing mode param used to set text direction.\r
-\r
- ● Michael(tm) Smith: email.mailto.enabled.xml\r
-\r
- Added new param email.mailto.enabled for FO output.\r
- Patch from Paolo Borelli. Closes #2086321.\r
-\r
- ● Jirka Kosek: highlight.source.xml; highlight.xslthl.config.xml\r
-\r
- Upgraded to support the latest version of XSLTHL 2.0\r
- -- nested markup in highlited code is now processed\r
- -- it is no longer needed to specify path XSLTHL configuration file using Java property\r
- -- support for new languages, including Perl, Python and Ruby was added\r
-\r
-Highlighting\r
-\r
-The following changes have been made to the highlighting code since the 1.74.0\r
-release.\r
-\r
- ● Jirka Kosek: cpp-hl.xml; c-hl.xml; tcl-hl.xml; php-hl.xml; common.xsl;\r
- perl-hl.xml; delphi⋯\r
-\r
- Upgraded to support the latest version of XSLTHL 2.0\r
- -- nested markup in highlited code is now processed\r
- -- it is no longer needed to specify path XSLTHL configuration file using Java property\r
- -- support for new languages, including Perl, Python and Ruby was added\r
-\r
-Release Notes: 1.74.0\r
-\r
-This release includes important bug fixes and adds the following significant\r
-feature changes:\r
-\r
-.epub target\r
-\r
- Paul Norton (Adobe) and Keith Fahlgren(O'Reilly Media) have donated code\r
- that generates .epub documents from DocBook input. An alpha-reference\r
- implementation in Ruby has also been provided.\r
-\r
- .epub is an open standard of the The International Digital Publishing Forum\r
- (IDPF), a the trade and standards association for the digital publishing\r
- industry.\r
-\r
- Read more about this target in epub/README\r
-\r
-XHTML 1.1 target\r
-\r
- To support .epub output, a strict XHTML 1.1 target has been added. The\r
- stylesheets for this output are generated and are quite similar to the\r
- XHTML target.\r
-\r
-Gentext updates\r
-\r
- A number of locales have been updated.\r
-\r
-Roundtrip improvements\r
-\r
- Table, figure, template syncronization, and character style improvements\r
- have been made for WordML & Pages. Support added for OpenOffice.org.\r
-\r
-First implementation of a libxslt extension\r
-\r
- A stylesheet extension for libxslt, written in Python, has been added. The\r
- extension is a function for adjusting column widths in CALS tables. See\r
- extensions/README.LIBXSLT for more information.\r
-\r
-The following is a list of changes that have been made since the 1.73.2\r
-release.\r
-\r
-Gentext\r
-\r
-The following changes have been made to the gentext code since the 1.73.2\r
-release.\r
-\r
- ● Michael(tm) Smith: locale/id.xml\r
-\r
- Checked in changes to Indonesion locale submitted by Euis Luhuanam a long time ago.\r
-\r
- ● Michael(tm) Smith: locale/lt.xml\r
-\r
- Added changes to Lithuanian locate submitted a long time back by Nikolajus Krauklis.\r
-\r
- ● Michael(tm) Smith: locale/hu.xml\r
-\r
- fixed error in lowercase.alpha definition in Hungarian locale\r
-\r
- ● Michael(tm) Smith: locale/nb.xml\r
-\r
- Corrected language code for nb locale, and restored missing "startquote" key.\r
-\r
- ● Michael(tm) Smith: locale/ja.xml\r
-\r
- Committed changes to ja locale file, from Akagi Kobayashi. Adds bracket quotes around many xref instances that did not have them\r
- before.\r
-\r
- ● Michael(tm) Smith: Makefile\r
-\r
- "no" locale is now "nb"\r
-\r
- ● Michael(tm) Smith: locale/nb.xml\r
-\r
- Update Norwegian Bokmål translation. Thanks to Hans F. Nordhaug.\r
-\r
- ● Michael(tm) Smith: locale/no.xml; locale/nb.xml\r
-\r
- per message from Hans F. Nordhaug, correct identifier for\r
- Norwegian Bokmål is "nb" (not "no") and has been for quite some\r
- time now...\r
-\r
- ● Michael(tm) Smith: locale/ja.xml\r
-\r
- Converted ja.xml source file to use real unicode characters so\r
- that the actual glyphs so up when you edit it in a text editor\r
- (instead of the character references).\r
-\r
- ● Michael(tm) Smith: locale/ja.xml\r
-\r
- Checked in changes to ja.xml locale file. Thanks to Akagi Kobayashi.\r
-\r
- ● Michael(tm) Smith: locale/it.xml\r
-\r
- Changes from Federico Zenith\r
-\r
- ● Dongsheng Song: locale/zh_cn.xml\r
-\r
- Added missing translations.\r
-\r
-Common\r
-\r
-The following changes have been made to the common code since the 1.73.2\r
-release.\r
-\r
- ● Michael(tm) Smith: l10n.xsl\r
-\r
- Added new template "l10.language.name" for retrieving the\r
- English-language name of the lang setting of the current document.\r
- Closes #1916837. Thanks to Simon Kennedy.\r
-\r
- ● Michael(tm) Smith: refentry.xsl\r
-\r
- fixed syntax error\r
-\r
- ● Michael(tm) Smith: refentry.xsl\r
-\r
- fixed a couple of typos\r
-\r
- ● Michael(tm) Smith: refentry.xsl\r
-\r
- refined handling of cases where refentry "source" or "manual"\r
- metadata is missing or when we use fallback content instead. We\r
- now report a Warning if we use fallback content.\r
-\r
- ● Michael(tm) Smith: refentry.xsl\r
-\r
- don't use refmiscinfo@class=date value as fallback for refentry\r
- "source" or "manual" metadata fields\r
-\r
- ● Michael(tm) Smith: refentry.xsl\r
-\r
- Made reporting of missing refentry metadata more quiet:\r
-\r
- - we no longer report anything if usable-but-not-preferred\r
- metadata is found; we just quietly use whatever we manage to\r
- find\r
-\r
- - we now only report missing "source" metadata if the refentry\r
- is missing BOTH "source name" and "version" metadata; if it\r
- has one but not the other, we use whichever one it has and\r
- don't report anything as missing\r
-\r
- The above changes were made because testing with some "real world"\r
- source reveals that some authors are intentionally choosing to use\r
- "non preferred" markup for some metadata, and also choosing to\r
- omit "source name" or "version" metadata in there DocBook XML. So\r
- it does no good to give them pedantic reminders about what they\r
- already know...\r
-\r
- Also, changed code to cause "fixme" text to be inserted in output\r
- in particular cases:\r
-\r
- - if we can't manage to find any "source" metadata at all, we\r
- now put fixme text into the output\r
-\r
- - if we can't manage to find any "manual" metadata a all, we\r
- now put fixme text into the output\r
-\r
- The "source" and "manual" metadata is necessary information, so\r
- buy putting the fixme stuff in the output, we alert users to the\r
- need problem of it being missing.\r
-\r
- ● Michael(tm) Smith: refentry.xsl\r
-\r
- When generating manpages output, we no longer report anything if\r
- the refentry source is missing date or pubdate content. In\r
- practice, many users intentionally omit the date from the source\r
- because they explicitly want it to be generated.\r
-\r
- ● Michael(tm) Smith: l10n.xml\r
-\r
- further change needed for switch from no locale to nb.\r
-\r
- ● Michael(tm) Smith: common.xsl\r
-\r
- Added support for orgname in authorgroup. Thanks to Camille\r
- Bégnis.\r
-\r
- ● Michael(tm) Smith: Makefile\r
-\r
- "no" locale is now "nb"\r
-\r
- ● Mauritz Jeanson: stripns.xsl\r
-\r
- Removed the template matching "ng:link|db:link" (in order to make @xlink:show\r
- work with <link> elements). As far as I can tell, this template is no longer needed.\r
-\r
- ● Mauritz Jeanson: entities.ent\r
-\r
- Moved declaration of comment.block.parents entity to common/entities.ent.\r
-\r
- ● Mauritz Jeanson: titles.xsl\r
-\r
- Added an update the fix made in revision 7528 (handling of xref/link in no.anchor.mode mode).\r
- Having xref in title is not a problem as long as the target is not an ancestor element.\r
- Closes bug #1838136.\r
-\r
- Note that an xref that is in a title and whose target is an ancestor element is still not\r
- rendered in the TOC. This could be considered a bug, but on the other hand I cannot really\r
- see the point in having such an xref in a document.\r
-\r
- ● Mauritz Jeanson: titles.xsl\r
-\r
- Added a "not(ancestor::title)" test to work around "too many nested\r
- apply-templates" problems when processing xrefs or links in no.anchor.mode mode.\r
- Hopefully, this closes bug #1811721.\r
-\r
- ● Mauritz Jeanson: titles.xsl\r
-\r
- Removed old template matching "link" in no.anchor.mode mode.\r
-\r
- ● Mauritz Jeanson: titles.xsl\r
-\r
- Process <link> in no.anchor.mode mode with the same template as <xref>.\r
- Closes bug #1759205 (Empty link in no.anchor.mode mode).\r
-\r
- ● Mauritz Jeanson: titles.xsl\r
-\r
- In no.anchor.mode mode, do not output anchors for elements that are descendants\r
- of <title>. Previously, having inline elements with @id/@xml:id in <title>s\r
- resulted in anchors both in the TOC and in the main flow. Closes bug #1797492.\r
-\r
-FO\r
-\r
-The following changes have been made to the fo code since the 1.73.2 release.\r
-\r
- ● Mauritz Jeanson: pi.xsl\r
-\r
- Updated documentation for keep-together.\r
-\r
- ● Mauritz Jeanson: task.xsl\r
-\r
- Enabled use of the keep-together PI on task elements.\r
-\r
- ● Robert Stayton: index.xsl\r
-\r
- FOP1 requires fo:wrapper for inline index entries, not fo:inline.\r
-\r
- ● Robert Stayton: index.xsl\r
-\r
- Fixed non-working inline.or.block template for indexterm wrappers.\r
- Add fop1 to list of processors using inline.or.block.\r
-\r
- ● Mauritz Jeanson: table.xsl\r
-\r
- Fixed bug #1891965 (colsep in entytbl not working).\r
-\r
- ● Mauritz Jeanson: titlepage.xsl\r
-\r
- Added support for title in revhistory. Closes bug #1842847.\r
-\r
- ● Mauritz Jeanson: pi.xsl\r
-\r
- Small doc cleanup (dbfo float-type).\r
-\r
- ● Mauritz Jeanson: titlepage.xsl\r
-\r
- Insert commas between multiple copyright holders.\r
-\r
- ● Mauritz Jeanson: autotoc.xsl; division.xsl\r
-\r
- Added modifications to support nested set elements. See bug #1853172.\r
-\r
- ● David Cramer: glossary.xsl\r
-\r
- Added normalize-space to xsl:sorts to avoid missorting of glossterms due to stray leading spaces.\r
-\r
- ● David Cramer: glossary.xsl\r
-\r
- Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry\r
-\r
- ● Mauritz Jeanson: inline.xsl\r
-\r
- Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,\r
- and the "hot text" is the biblioid itself enclosed in brackets.\r
-\r
- ● Mauritz Jeanson: inline.xsl\r
-\r
- Moved declaration of comment.block.parents entity to common/entities.ent.\r
-\r
- ● Mauritz Jeanson: docbook.xsl\r
-\r
- Updated message about unmatched element.\r
-\r
- ● Mauritz Jeanson: param.xweb\r
-\r
- Added link to profiling chapter of TCG.\r
-\r
- ● Mauritz Jeanson: refentry.xsl\r
-\r
- Fixed typo (refsynopsysdiv -> refsynopsisdiv).\r
-\r
- ● David Cramer: fop.xsl; fop1.xsl; ptc.xsl; xep.xsl\r
-\r
- Added test to check generate.index param when generating pdf bookmarks\r
-\r
- ● Mauritz Jeanson: graphics.xsl\r
-\r
- Added support for MathML in imagedata.\r
-\r
- ● Michael(tm) Smith: math.xsl\r
-\r
- Removed unnecessary extra test condition in test express that\r
- checks for passivetex.\r
-\r
- ● Michael(tm) Smith: math.xsl\r
-\r
- Don't use fo:instream-foreign-object if we are processing with\r
- passivetex. Closes #1806899. Thanks to Justus Piater.\r
-\r
- ● Mauritz Jeanson: component.xsl\r
-\r
- Added code to output a TOC for an appendix in an article when\r
- generate.toc='article/appendix toc'. Closes bug #1669658.\r
-\r
- ● Dongsheng Song: biblio-iso690.xsl\r
-\r
- Change encoding from "windows-1250" to "UTF-8".\r
-\r
- ● Mauritz Jeanson: pi.xsl\r
-\r
- Updated documentation for dbfo_label-width.\r
-\r
- ● Mauritz Jeanson: lists.xsl\r
-\r
- Added support for the dbfo_label-width PI in calloutlists.\r
-\r
- ● Robert Stayton: biblio.xsl\r
-\r
- Support finding glossary database entries inside bibliodivs.\r
-\r
- ● Robert Stayton: formal.xsl\r
-\r
- Complete support for <?dbfo pgwide="1"?> for informal\r
- elements too.\r
-\r
- ● Mauritz Jeanson: table.xsl\r
-\r
- In the table.block template, added a check for the dbfo_keep-together PI, so that\r
- a table may break (depending on the PI value) at a page break. This was needed\r
- since the outer fo:block that surrounds fo:table has keep-together.within-column="always"\r
- by default, which prevents the table from breaking. Closes bug #1740964 (Titled\r
- table does not respect dbfo PI).\r
-\r
- ● Mauritz Jeanson: pi.xsl\r
-\r
- Added a few missing @role="tcg".\r
-\r
- ● Mauritz Jeanson: inline.xsl\r
-\r
- Use normalize-space() in glossterm comparisons (as in html/inline.xsl).\r
-\r
- ● Mauritz Jeanson: autoidx.xsl\r
-\r
- Removed the [&scope;] predicate from the target variable in the template with name="reference".\r
- This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,\r
- with index.on.type=1. Closes bug #1680836.\r
-\r
- ● Michael(tm) Smith: inline.xsl; xref.xsl; footnote.xsl\r
-\r
- Added capability in FO output for displaying URLs for all\r
- hyperlinks (elements marked up with xlink:href attributes) in the\r
- same way as URLs for ulinks are already handled (which is to say,\r
- either inline or as numbered footnotes).\r
-\r
- Background on this change:\r
- DocBook 5 allows "ubiquitous" linking, which means you can make\r
- any element a hyperlink just by adding an xlink:href attribute to\r
- it, with the value set to an external URL. That's in contrast to\r
- DocBook 4, which only allows you to use specific elements (e.g.,\r
- the link and ulink elements) to mark up hyperlinks.\r
-\r
- The existing FO stylesheets have a mechanism for handling display\r
- of URLs for hyperlinks that are marked up with ulink, but they did\r
- not handle display of URLs for elements that were marked up with\r
- xlink:href attributes. This change adds handling for those other\r
- elements, enabling the URLs they link to be displayed either\r
- inline or as numbered footnotes (depending on what values the user\r
- has the ulink.show and ulink.footnotes params set to).\r
-\r
- Note that this change only adds URL display support for elements\r
- that call the simple.xlink template -- which currently is most\r
- (but not all) inline elements.\r
-\r
- This change also moves the URL display handling out of the ulink\r
- template and into a new "hyperlink.url.display" named template;\r
- the ulink template and the simple.xlink named template now both\r
- call the hyperlink.url.display template.\r
-\r
- Warning: In the stylesheet code that determines what footnote\r
- number to assign to each footnote or external hyperlink, there is\r
- an XPath expression for determining whether a particular\r
- xlink:href instance is an external hyperlink; that expression is\r
- necessarily a bit complicated and further testing may reveal that\r
- it doesn't handle all cases as expected -- so some refinements to\r
- it may need to be done later.\r
-\r
- Closes #1785519. Thanks to Ken Morse for reporting and\r
- troubleshooting the problem.\r
-\r
-HTML\r
-\r
-The following changes have been made to the html code since the 1.73.2 release.\r
-\r
- ● Keith Fahlgren: inline.xsl; synop.xsl\r
-\r
- Work to make HTML and XHTML targets more valid\r
-\r
- ● Keith Fahlgren: table.xsl\r
-\r
- Add better handling for tables that have footnotes in the titles\r
-\r
- ● Keith Fahlgren: biblio.xsl\r
-\r
- Add anchors to bibliodivs\r
-\r
- ● Keith Fahlgren: formal.xsl; Makefile; htmltbl.xsl\r
-\r
- Initial checkin/merge of epub target from work provided by Paul Norton of Adobe\r
- and Keith Fahlgren of O'Reilly.\r
-\r
- This change includes new code for generating the XHTML 1.1 target sanely.\r
-\r
- ● Mauritz Jeanson: biblio.xsl\r
-\r
- Added code for creating URLs from biblioids with @class="doi" (representing Digital\r
- Object Identifiers). See FR #1934434 and http://doi.org.\r
-\r
- To do: 1) Add support for FO output. 2) Figure out how @class="doi" should be handled\r
- for bibliorelation, bibliosource and citebiblioid.\r
-\r
- ● Norman Walsh: formal.xsl\r
-\r
- Don't use xsl:copy because it forces the resulting element to be in the same namespace as the source element; in the XHTML stylesheets, that's wrong. But the HTML-to-XHTML converter does the right thing with literal result elements, so use one of them.\r
-\r
- ● Michael(tm) Smith: Makefile\r
-\r
- Added checks and hacks to various makefiles to enable building\r
- under Cygwin. This stuff is ugly and maybe not worth the mess and\r
- trouble, but does seem to work as expected and not break anything\r
- else.\r
-\r
- ● Michael(tm) Smith: docbook.xsl\r
-\r
- added "exslt" namespace binding to html/docbook.xsl file (in\r
- addition to existing "exsl" binding. reason is because lack of it\r
- seems to cause processing problems when using the profiled\r
- version of the stylsheet\r
-\r
- ● Norman Walsh: chunk-common.xsl\r
-\r
- Rename link\r
-\r
- ● Mauritz Jeanson: table.xsl\r
-\r
- Added a fix to make rowsep apply to the last row of thead in entrytbl.\r
-\r
- ● Michael(tm) Smith: synop.xsl\r
-\r
- Simplified and streamlined handling of output for ANSI-style\r
- funcprototype output, to correct a problem that was causing type\r
- data to be lost in the output parameter definitions. For example,\r
- for an instance like this:\r
- <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>\r
- ... the brackets (indicating an array type) were being dropped.\r
-\r
- ● Michael(tm) Smith: synop.xsl\r
-\r
- Changed HTML handling of K&R-style paramdef output. The parameter\r
- definitions are no longer output in a table (though the prototype\r
- still is). The reason for the change is that the\r
- kr-tabular-funcsynopsis-mode template was causing type data to be\r
- lost in the output parameter definitions. For example, for an\r
- instance like this:\r
- <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>\r
- ... the brackets (indicating an array type) were being dropped.\r
- The easiest way to deal with the problem is to not try to chop up\r
- the parameter definitions and display them in table format, but to\r
- instead just output them as-is. May not look quite as pretty, but\r
- at least we can be sure no information is being lost...\r
-\r
- ● Michael(tm) Smith: pi.xsl\r
-\r
- updated wording of doc for funcsynopsis-style PI\r
-\r
- ● Michael(tm) Smith: param.xweb; param.ent; synop.xsl\r
-\r
- Removed the funcsynopsis.tabular.threshold param. It's no longer\r
- being used in the code and hasn't been since mid 2006.\r
-\r
- ● Mauritz Jeanson: graphics.xsl\r
-\r
- Added support for the img.src.path parameter for SVG graphics. Closes bug #1888169.\r
-\r
- ● Mauritz Jeanson: chunk-common.xsl\r
-\r
- Added missing space.\r
-\r
- ● Norman Walsh: component.xsl\r
-\r
- Fix bug where component titles inside info elements were not handled properly\r
-\r
- ● Michael(tm) Smith: pi.xsl\r
-\r
- Moved dbhtml_stop-chunking embedded doc into alphabetical order,\r
- fixed text of TCG section it see-also'ed.\r
-\r
- ● David Cramer: pi.xsl\r
-\r
- Added support for <?dbhtml stop-chunking?> processing instruction\r
-\r
- ● David Cramer: chunk-common.xsl; pi.xsl\r
-\r
- Added support for <?dbhtml stop-chunking?> processing instruction\r
-\r
- ● David Cramer: glossary.xsl\r
-\r
- Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry. Also added normalize-space to avoid missorting due to stray leading spaces.\r
-\r
- ● Mauritz Jeanson: inline.xsl\r
-\r
- Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,\r
- and the "hot text" is the biblioid itself enclosed in brackets.\r
-\r
- ● Mauritz Jeanson: inline.xsl\r
-\r
- Added support for @xlink:show in the simple.xlink template. The "new" and "replace"\r
- values are supported (corresponding to values of "_blank" and "_top" for the\r
- ulink.target parameter). I have assumed that @xlink:show should override ulink.target\r
- for external URI links. This closes bugs #1762023 and #1727498.\r
-\r
- ● Mauritz Jeanson: inline.xsl\r
-\r
- Moved declaration of comment.block.parents entity to common/entities.ent.\r
-\r
- ● Mauritz Jeanson: param.xweb\r
-\r
- Added link to profiling chapter of TCG.\r
-\r
- ● Dongsheng Song: biblio-iso690.xsl\r
-\r
- Change encoding from "windows-1250" to "UTF-8".\r
-\r
- ● Robert Stayton: biblio.xsl\r
-\r
- Add support in biblio collection to entries in bibliodivs.\r
-\r
- ● Mauritz Jeanson: pi.xsl\r
-\r
- Added missing @role="tcg".\r
-\r
- ● Mauritz Jeanson: chunk-common.xsl; titlepage.xsl\r
-\r
- Refactored legalnotice/revhistory chunking, so that the use.id.as.filename\r
- parameter as well as the dbhtml_filename PI are taken into account. A new named\r
- template in titlepage.xsl is used to compute the filename.\r
-\r
- ● Mauritz Jeanson: chunk-common.xsl; titlepage.xsl\r
-\r
- An update to the fix for bug #1790495 (r7433):\r
- The "ln-" prefix is output only when the legalnotice doesn't have an\r
- @id/@xml:id, in which case the stylesheets generate an ID value,\r
- resulting in a filename like "ln-7e0fwgj.html". This is useful because\r
- without the prefix, you wouldn't know that the file contained a legalnotice.\r
- The same logic is also applied to revhistory, using an "rh-" prefix.\r
-\r
- ● Mauritz Jeanson: autoidx.xsl\r
-\r
- Removed the [&scope;] predicate from the target variable in the template with name="reference".\r
- This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,\r
- with index.on.type=1. Closes bug #1680836.\r
-\r
- ● Mauritz Jeanson: titlepage.xsl\r
-\r
- Added 'ln-' prefix to the name of the legalnotice chunk, in order to match the\r
- <link href"..."> that is output by make.legalnotice.head.links (chunk-common.xsl).\r
- Modified the href attribute on the legalnotice link.\r
- Closes bug #1790495.\r
-\r
-Manpages\r
-\r
-The following changes have been made to the manpages code since the 1.73.2\r
-release.\r
-\r
- ● Michael(tm) Smith: other.xsl\r
-\r
- slightly adjusted spacing around admonition markers\r
-\r
- ● Michael(tm) Smith: refentry.xsl; utility.xsl\r
-\r
- make sure refsect3 titles are preceded by a line of space, and\r
- make the indenting of their child content less severe\r
-\r
- ● Michael(tm) Smith: block.xsl\r
-\r
- only indent verbatim environments in TTY output, not in non-TTY/PS\r
-\r
- ● Michael(tm) Smith: block.xsl\r
-\r
- made another adjustment to correct vertical alignment of admonition marker\r
-\r
- ● Michael(tm) Smith: block.xsl; other.xsl\r
-\r
- Adjusted/corrected alignment of adominition marker in PS/non-TTY output.\r
-\r
- ● Michael(tm) Smith: endnotes.xsl\r
-\r
- For PS/non-TTY output, display footnote/endnote numbers in\r
- superscript.\r
-\r
- ● Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl\r
-\r
- Changed handling of hanging indents for cmdsynopsis, funcsynopsis,\r
- and synopfragment such that they now look correct in non-TTY/PS\r
- output. We now use the groff \w escape to hang by the actual width\r
- -- in the current font -- of the command, funcdef, or\r
- synopfragment references number (as opposed to hanging by the\r
- number of characters). This rendering in TTY output remains the\r
- same, since the width in monospaced TTY output is the same as the\r
- number of characters.\r
-\r
- Also, created new synopsis-block-start and synopsis-block-end\r
- templates to use for cmdsynopsis and funcsynopsis instead of the\r
- corresponding verbatim-* templates.\r
-\r
- Along with those changes, also corrected a problem that caused the\r
- content of synopfragment to be dropped, and made a\r
- vertical-spacing change to adjust spacing around table titles and\r
- among sibling synopfragment instances.\r
-\r
- ● Michael(tm) Smith: other.xsl\r
-\r
- use common l10.language.name template to retrieve English-language name\r
-\r
- ● Michael(tm) Smith: synop.xsl; inline.xsl\r
-\r
- added comment in code explaining why we don't put filename output\r
- in italic (despite the fact that man guidelines say we should)\r
-\r
- ● Michael(tm) Smith: inline.xsl\r
-\r
- put filename output in monospace instead of italic\r
-\r
- ● Michael(tm) Smith: synop.xsl\r
-\r
- put cmdsynopsis in monospace\r
-\r
- ● Michael(tm) Smith: inline.xsl\r
-\r
- removed template match for literal. template matches for monospace\r
- inlines are all imported from the HTML stylesheet\r
-\r
- ● Michael(tm) Smith: block.xsl\r
-\r
- don't indent verbatim environments that are descendants of\r
- refsynopsisdiv, not put backgrounds behind them\r
-\r
- ● Michael(tm) Smith: inline.xsl\r
-\r
- set output of the literal element in monospace. this causes all\r
- inline monospace instances in the git man pages to be set in\r
- monospace (since DocBook XML source for git docs is generated with\r
- asciidoc and asciidoc consistently outputs only <literal> for\r
- inline monospace (not <command> or <code> or anything else).\r
- Of course this only affects non-TTY output...\r
-\r
- ● Michael(tm) Smith: utility.xsl\r
-\r
- Added inline.monoseq named template.\r
-\r
- ● Michael(tm) Smith: utility.xsl\r
-\r
- don't bother using a custom register to store the previous\r
- font-family value when setting blocks of text in code font; just\r
- use \F[] .fam with no arg to switch back\r
-\r
- ● Michael(tm) Smith: endnotes.xsl\r
-\r
- put links in blue in PS output (note that this matches how groff\r
- renders content marked up with the .URL macro)\r
-\r
- ● Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent\r
-\r
- removed man.links.are.underlined and added man.font.links. Also,\r
- changed the default font formatting for links to bold.\r
-\r
- ● Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent\r
-\r
- Added new param man.base.url.for.relative.links .. specifies a\r
- base URL for relative links (for ulink, @xlink:href, imagedata,\r
- audiodata, videodata) shown in the generated NOTES section of\r
- man-page output. The value of man.base.url.for.relative.links is\r
- prepended to any relative URI that is a value of ulink url,\r
- xlink:href, or fileref attribute.\r
-\r
- If you use relative URIs in link sources in your DocBook refentry\r
- source, and you leave man.base.url.for.relative.links unset, the\r
- relative links will appear "as is" in the NOTES section of any\r
- man-page output generated from your source. That's probably not\r
- what you want, because such relative links are only usable in the\r
- context of HTML output. So, to make the links meaningful and\r
- usable in the context of man-page output, set a value for\r
- man.base.url.for.relative.links that points\r
- to the online version of HTML output generated from your DocBook\r
- refentry source. For example:\r
-\r
- <xsl:param name="man.base.url.for.relative.links"\r
- >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param>\r
-\r
- ● Michael(tm) Smith: info.xsl\r
-\r
- If a source refentry contains a Documentation or DOCUMENTATION\r
- section, don't report it as having missing AUTHOR information.\r
- Also, if missing a contrib/personblurb for a person or org, report\r
- pointers to http://docbook.sf.net/el/personblurb and to\r
- http://docbook.sf.net/el/contrib\r
-\r
- ● Michael(tm) Smith: info.xsl\r
-\r
- If we encounter an author|editor|othercredit instance that lacks a\r
- personblurb or contrib, report it to the user (because that means\r
- we have no information about that author|editor|othercredit to\r
- display in the generated AUTHOR|AUTHORS section...)\r
-\r
- ● Michael(tm) Smith: info.xsl; docbook.xsl; other.xsl\r
-\r
- if we can't find any usable author data, emit a warning and insert\r
- a fixme in the output\r
-\r
- ● Michael(tm) Smith: info.xsl\r
-\r
- fixed bug in indenting of output for contrib instances in AUTHORS\r
- section. Thanks to Daniel Leidert and the fglrx docs for exposing\r
- the bug.\r
-\r
- ● Michael(tm) Smith: block.xsl\r
-\r
- for a para or simpara that is the first child of a callout,\r
- suppress the .sp or .PP that would normally be output (because in\r
- those cases, the output goes into a table cell, and the .sp or .PP\r
- markup causes a spurious linebreak before it when displayed\r
-\r
- ● Michael(tm) Smith: lists.xsl\r
-\r
- Added support for rendering co callouts and calloutlist instances.\r
- So you can now use simple callouts -- marking up programlisting\r
- and such with co instances -- and have the callouts displayed in\r
- man-page output. ("simple callouts" means using co@id and\r
- callout@arearefs pointing to co@id instances; in man/roff output,\r
- we can't/don't support markup that uses areaset and area)\r
-\r
- ● Michael(tm) Smith: block.xsl\r
-\r
- only put a line of space after a verbatim if it's followed by a\r
- text node or a paragraph\r
-\r
- ● Michael(tm) Smith: utility.xsl\r
-\r
- put verbatim environments in slightly smaller font in non-TTY\r
- output\r
-\r
- ● Michael(tm) Smith: lists.xsl\r
-\r
- minor whitespace-only reformatting of lists.xsl source\r
-\r
- ● Michael(tm) Smith: lists.xsl\r
-\r
- Made refinements/fixes to output of orderedlist and itemizedlist\r
- -- in part, to get mysql man pages to display correctly. This\r
- change causes a "\c" continuation marker to be added between\r
- listitem markers and contents (to ensure that the content remains\r
- on the same line as the marker when displayed)\r
-\r
- ● Michael(tm) Smith: block.xsl\r
-\r
- put a line of vertical space after all verbatim output that has\r
- sibling content following it (not just if that sibling content is\r
- a text node)\r
-\r
- ● Michael(tm) Smith: block.xsl\r
-\r
- refined spacing around titles for admonitions\r
-\r
- ● Michael(tm) Smith: block.xsl; other.xsl\r
-\r
- Deal with case of verbatim environments that have a linebreak\r
- after the opening tag. Assumption is that users generally don't\r
- want that linebreak to appear in output, so we do some groff\r
- hackery to mess with vertical spacing and close the space.\r
-\r
- ● Michael(tm) Smith: inline.xsl\r
-\r
- indexterm instances now produce groff comments like this:\r
-\r
- .\" primary: secondary: tertiary\r
-\r
- remark instances, if non-empty, now produce groff comments\r
-\r
- ● Michael(tm) Smith: charmap.groff.xsl; other.xsl\r
-\r
- convert no-break space character to groff "\ \&" (instead of just\r
- "\ "). the reason is that if a space occurs at the end of a line,\r
- our processing causes it to be eaten. a real-world case of this is\r
- the mysql(1) man page. appending the "\&" prevents that\r
-\r
- ● Michael(tm) Smith: block.xsl\r
-\r
- output "sp" before simpara output, not after it (outputting it\r
- after results in undesirable whitespace in particular cases; for\r
- example, in the hg/mercurial docs\r
-\r
- ● Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl\r
-\r
- renamed from title-preamble to pinch.together and replaced "sp -1"\r
- between synopsis fragments with call to pinch.together instead\r
-\r
- ● Michael(tm) Smith: table.xsl\r
-\r
- use title-preamble template for table titles (instead of "sp -1"\r
- hack), and "sp 1" after all tables (instead of just "sp"\r
-\r
- ● Michael(tm) Smith: utility.xsl\r
-\r
- created title-preamble template for suppressing line spacing after\r
- headings\r
-\r
- ● Michael(tm) Smith: info.xsl\r
-\r
- further refinement of indenting in AUTHORS section\r
-\r
- ● Michael(tm) Smith: block.xsl; other.xsl\r
-\r
- refined handling of admonitions\r
-\r
- ● Michael(tm) Smith: lists.xsl\r
-\r
- Use RS/RE in another place where we had IP ""\r
-\r
- ● Michael(tm) Smith: info.xsl\r
-\r
- Replace (ab)use of IP with "sp -1" in AUTHORS section with RS/RE\r
- instead.\r
-\r
- ● Michael(tm) Smith: table.xsl; synop.xsl; info.xsl\r
-\r
- changed all instances of ".sp -1n" to ".sp -1"\r
-\r
- ● Michael(tm) Smith: other.xsl\r
-\r
- add extra line before SH heads only in non-TTY output\r
-\r
- ● Michael(tm) Smith: block.xsl\r
-\r
- Reworked output for admonitions (caution, important, note, tip,\r
- warning). In TTY output, admonitions now get indented. In non-TTY\r
- output, a colored marker (yellow) is displayed next to them.\r
-\r
- ● Michael(tm) Smith: other.xsl\r
-\r
- Added BM/EM macros for putting a colored marker in margin next to\r
- a block of text.\r
-\r
- ● Michael(tm) Smith: utility.xsl\r
-\r
- created make.bold.title template by moving title-bolding part out\r
- from nested-section-title template. This allows the bolding to\r
- also be used by the template for formatting admonitions\r
-\r
- ● Michael(tm) Smith: info.xsl\r
-\r
- put .br before copyright contents to prevent them from getting run in\r
-\r
- ● Michael(tm) Smith: refentry.xsl; other.xsl; utility.xsl\r
-\r
- made point size of output for Refsect2 and Refsect3 heads bigger\r
-\r
- ● Michael(tm) Smith: other.xsl\r
-\r
- put slightly more space between SH head and underline in non-TTY\r
- output\r
-\r
- ● Michael(tm) Smith: param.xweb; param.ent; other.xsl\r
-\r
- Added the man.charmap.subset.profile.english parameter and refined\r
- the handling of charmap subsets to differentiate between English\r
- and non-English source.\r
-\r
- This way charmap subsets are now handled is this:\r
-\r
- If the value of the man.charmap.use.subset parameter is non-zero,\r
- and your DocBook source is not written in English (that is, if its\r
- lang or xml:lang attribute has a value other than en), then the\r
- character-map subset specified by the man.charmap.subset.profile\r
- parameter is used instead of the full roff character map.\r
-\r
- Otherwise, if the lang or xml:lang attribute on the root element\r
- in your DocBook source or on the first refentry element in your\r
- source has the value en or if it has no lang or xml:lang\r
- attribute, then the character-map subset specified by the\r
- man.charmap.subset.profile.english parameter is used instead of\r
- man.charmap.subset.profile.\r
-\r
- The difference between the two subsets is that\r
- man.charmap.subset.profile provides mappings for characters in\r
- Western European languages that are not part of the Roman\r
- (English) alphabet (ASCII character set).\r
-\r
- ● Michael(tm) Smith: other.xsl\r
-\r
- Various updates, mainly related to uppercasing SH titles:\r
-\r
- - added a "Language: " metadata line to the top comment area of\r
- output man pages, to indicate the language the page is in\r
-\r
- - added a "toupper" macro of doing locale-aware uppercasing of\r
- SH titles and cross-references to SH titles; the mechanism\r
- relies on the uppercase.alpha and lowercase.alpha DocBook\r
- gentext keys to do locale-aware uppercasing based on the\r
- language the page is written in\r
-\r
- - added a "string.shuffle" template, which provides a library\r
- function for "shuffling" two strings together into a single\r
- string; it takes the first character for the first string, the\r
- first character from second string, etc. The only current use\r
- for it is to generate the argument for the groff tr request\r
- that does string uppercasing.\r
-\r
- - added make.tr.uppercase.arg and make.tr.normalcase.arg named\r
- templates for use in generating groff code for uppercasing and\r
- "normal"-casing SH titles\r
-\r
- - made the BB/BE "background drawing" macros have effect only in\r
- non-TTY output\r
-\r
- - output a few comments in the top part of source\r
-\r
- ● Michael(tm) Smith: utility.xsl\r
-\r
- removed some leftover kruft\r
-\r
- ● Michael(tm) Smith: refentry.xsl\r
-\r
- To create the name(s) for each man page, we now replace any spaces\r
- in the refname(s) with underscores. This ensures that tools like\r
- lexgrog(1) will be able to parse the name (lexgrog won't parse\r
- names that contain spaces).\r
-\r
- ● Michael(tm) Smith: docbook.xsl\r
-\r
- Put a comment into source of man page to indicate where the main\r
- content starts. (We now have a few of macro definitions at the\r
- start of the source, so putting this comment in helps those that\r
- might be viewing the source.)\r
-\r
- ● Michael(tm) Smith: refentry.xsl\r
-\r
- refined mechanism for generating SH titles\r
-\r
- ● Michael(tm) Smith: charmap.groff.xsl\r
-\r
- Added zcaron, Zcaron, scaron, and Scaron to the groff character map.\r
- This means that generated Finnish man pages will no longer contain\r
- any raw accented characters -- they'll instead by marked up with\r
- groff escapes.\r
-\r
- ● Michael(tm) Smith: other.xsl; utility.xsl\r
-\r
- corrected a regression I introduced about a year ago that caused\r
- dots to be output just as "\." -- instead needs to be "\&." (which\r
- is what it will be now, after this change)\r
-\r
- ● Michael(tm) Smith: refentry.xsl\r
-\r
- Changed backend handling for generating titles for SH sections and\r
- for cross-references to those sections. This should have no effect\r
- on TTY output (behavior should remain the same hopefully) but\r
- results in titles in normal case (instead of uppercase) in PS\r
- output.\r
-\r
- ● Michael(tm) Smith: info.xsl\r
-\r
- use make.subheading template to make subheadings for AUTHORS and\r
- COPYRIGHT sections (instead of harcoding roff markup)\r
-\r
- ● Michael(tm) Smith: block.xsl\r
-\r
- put code font around programlisting etc.\r
-\r
- ● Michael(tm) Smith: synop.xsl; docbook.xsl\r
-\r
- embed custom macro definitions in man pages, plus wrap synopsis in\r
- code font\r
-\r
- ● Michael(tm) Smith: endnotes.xsl\r
-\r
- use the make.subheading template to generated SH subheading for\r
- endnotes section.\r
-\r
- ● Michael(tm) Smith: lists.xsl\r
-\r
- Added some templates for generating if-then-else conditional\r
- markup in groff, so let's use those instead of hard-coding it in\r
- multiple places...\r
-\r
- ● Michael(tm) Smith: other.xsl; utility.xsl\r
-\r
- Initial checkin of some changes related to making PS/PDF output\r
- from "man -l -Tps" look better. The current changes:\r
-\r
- - render synopsis and verbatim sections in a monospace/code font\r
-\r
- - put a light-grey background behind all programlisting, screen,\r
- and literallayout instances\r
-\r
- - prevent SH heads in PS output from being rendered in uppercase\r
- (as they are in console output)\r
-\r
- - also display xrefs to SH heads in PS output in normal case\r
- (instead of uppercase)\r
-\r
- - draw a line under SH heads in PS output\r
-\r
- The changes made to the code to support the above features were:\r
-\r
- - added some embedded/custom macros: one for conditionally\r
- upper-casing SH x-refs, one for redefining the SH macro\r
- itself, with some conditional handling for PS output, and\r
- finally a macro for putting a background/screen (filled box)\r
- around a block of text (e.g., a program listing) in PS output\r
-\r
- - added utility templates for wrapping blocks of text in code\r
- font; also templates for inline code font\r
-\r
- ● Robert Stayton: refentry.xsl\r
-\r
- refpurpose nodes now get apply-templates instead of just normalize-space().\r
-\r
- ● Michael(tm) Smith: lists.xsl\r
-\r
- Fixed alignment of first lined of text for each listitem in\r
- orderedlist output for TTY. Existing code seemed to have been\r
- causing an extra undesirable space to appear.\r
-\r
- ● Michael(tm) Smith: lists.xsl\r
-\r
- Wrapped some roff conditionals around roff markup for orderedlist\r
- and itemizedlist output, so that the lists look acceptable in PS\r
- output as well as TTY.\r
-\r
- ● Michael(tm) Smith: pi.xsl; synop.xsl; param.xweb; param.ent\r
-\r
- Added the man.funcsynopsis.style parameter. Has the same effect in\r
- manpages output as the funcsynopsis.style parameter has in HTML\r
- output -- except that its default value is 'ansi' instead of 'kr'.\r
-\r
- ● Michael(tm) Smith: synop.xsl\r
-\r
- Reworked handling of K&R funcprototype output. It no longer relies\r
- on the HTML kr-tabular templates, but instead just does direct\r
- transformation to roff. For K&R output, it displays the paramdef\r
- output in an indented list following the prototype.\r
-\r
- ● Michael(tm) Smith: synop.xsl\r
-\r
- Properly integrated handling for K&R output into manpages\r
- stylesheet. The choice between K&R output and ANSI output is\r
- currently controlled through use of the (HTML) funcsynopsis.style\r
- parameter. Note that because the mechanism does currently rely on\r
- funcsynopsis.style, the default in manpages output is now K&R\r
- (because that's the default of that param). But I suppose I ought\r
- to create a man.funcsynopsis.style and make the default for that\r
- ANSI (to preserve the existing default behavior).\r
-\r
- ● Michael(tm) Smith: docbook.xsl\r
-\r
- added manpages/pi.xsl file\r
-\r
- ● Michael(tm) Smith: .cvsignore; pi.xsl\r
-\r
- Added "dbman funcsynopsis-style" PI and incorporated it into the\r
- doc build.\r
-\r
- ● Michael(tm) Smith: refentry.xsl\r
-\r
- Fixed regression that caused an unescaped dash to be output\r
- between refname and refpurpose content. Closes bug #1894244.\r
- Thanks to Daniel Leidert.\r
-\r
- ● Michael(tm) Smith: other.xsl\r
-\r
- Fixed problem with dots being escaped in filenames of generated\r
- man files. Closes #1827195. Thanks to Daniel Leidert.\r
-\r
- ● Michael(tm) Smith: inline.xsl\r
-\r
- Added support for processing structfield (was appearing in roff\r
- output surrounded by HTML <em> tags; fixed so that it gets roff\r
- ital markup). Closes bug #1858329. Thanks to Sam Varshavchik.\r
-\r
-Epub\r
-\r
-The following changes have been made to the epub code since the 1.73.2 release.\r
-\r
- ● Keith Fahlgren: bin/spec/README; bin/spec/epub_realbook_spec.rb\r
-\r
- 'Realbook' spec now passes\r
-\r
- ● Keith Fahlgren: bin/dbtoepub; README; bin/spec/README; bin/lib/docbook.rb;\r
- bin/spec/epub_r⋯\r
-\r
- Very primitive Windows support for dbtoepub reference implementation; README for running tests and for the .epub target in general; shorter realbook test document (still fails for now)\r
-\r
- ● Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/\r
- docbook.rb; bin/s⋯\r
-\r
- Changes to OPF spine to not duplicate idrefs for documents with parts not at the root; regression specs for same\r
-\r
- ● Keith Fahlgren: docbook.xsl\r
-\r
- Fixing linking to cover @id, distinct from other needs of cover-image-id (again, thanks to Martin Goerner)\r
-\r
- ● Keith Fahlgren: docbook.xsl\r
-\r
- Updating the title of the toc element in the guide to be more explicit (thanks to Martin Goerner)\r
-\r
- ● Keith Fahlgren: bin/spec/examples/amasque_exploded/content.opf; bin/spec/\r
- examples/amasque_⋯\r
-\r
- Initial checkin/merge of epub target from work provided by Paul Norton of Adobe\r
- and Keith Fahlgren of O'Reilly.\r
-\r
- ● Keith Fahlgren: docbook.xsl\r
-\r
- == General epub test support\r
-\r
- $ spec -O ~/.spec.opts spec/epub_spec.rb\r
-\r
- DocBook::Epub\r
- - should be able to be created\r
- - should fail on a nonexistent file\r
- - should be able to render to a file\r
- - should create a file after rendering\r
- - should have the correct mimetype after rendering\r
- - should be valid .epub after rendering an article\r
- - should be valid .epub after rendering an article without sections\r
- - should be valid .epub after rendering a book\r
- - should be valid .epub after rendering a book even if it has one graphic\r
- - should be valid .epub after rendering a book even if it has many graphics\r
- - should be valid .epub after rendering a book even if it has many duplicated graphics\r
- - should report an empty file as invalid\r
- - should confirm that a valid .epub file is valid\r
- - should not include PDFs in rendered epub files as valid image inclusions\r
- - should include a TOC link in rendered epub files for <book>s\r
-\r
- Finished in 20.608395 seconds\r
-\r
- 15 examples, 0 failures\r
-\r
-\r
- == Verbose epub test coverage against _all_ of the testdocs\r
-\r
- Fails on only (errors truncated):\r
- 1)\r
- 'DocBook::Epub should be able to render a valid .epub for the test document /Users/keith/work/docbook-dev/trunk/xsl/epub/bin/spec/testdocs/calloutlist.003.xml [30]' FAILED\r
- 'DocBook::Epub should be able to render a valid .epub for the test document /Users/keith/work/docbook-dev/trunk/xsl/epub/bin/spec/testdocs/cmdsynopsis.001.xml [35]' FAILED\r
- ....\r
-\r
- Finished in 629.89194 seconds\r
-\r
- 224 examples, 15 failures\r
-\r
- 224 examples, 15 failures yields 6% failure rate\r
-\r
-HTMLHelp\r
-\r
-The following changes have been made to the htmlhelp code since the 1.73.2\r
-release.\r
-\r
- ● Mauritz Jeanson: htmlhelp-common.xsl\r
-\r
- Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to\r
- the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.\r
- This makes chunk.quietly=1 suppress chunk filename messages also for help\r
- support files (which seems to be what one would expect). See bug #1648360.\r
-\r
-Eclipse\r
-\r
-The following changes have been made to the eclipse code since the 1.73.2\r
-release.\r
-\r
- ● David Cramer: eclipse.xsl\r
-\r
- Use sortas attributes (if they exist) when sorting indexterms\r
-\r
- ● David Cramer: eclipse.xsl\r
-\r
- Added support for indexterm/see in eclipse index.xml\r
-\r
- ● Mauritz Jeanson: eclipse.xsl\r
-\r
- Added <xsl:with-param name="quiet" select="$chunk.quietly"/>\r
- to helpidx template.\r
-\r
- ● David Cramer: eclipse.xsl\r
-\r
- Generate index.xml file and add related goo to plugin.xml file. Does not yet support see and seealso.\r
-\r
- ● Mauritz Jeanson: eclipse.xsl\r
-\r
- Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to\r
- the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.\r
- This makes chunk.quietly=1 suppress chunk filename messages also for help\r
- support files (which seems to be what one would expect). See bug #1648360.\r
-\r
-JavaHelp\r
-\r
-The following changes have been made to the javahelp code since the 1.73.2\r
-release.\r
-\r
- ● Mauritz Jeanson: javahelp.xsl\r
-\r
- Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to\r
- the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.\r
- This makes chunk.quietly=1 suppress chunk filename messages also for help\r
- support files (which seems to be what one would expect). See bug #1648360.\r
-\r
-Roundtrip\r
-\r
-The following changes have been made to the roundtrip code since the 1.73.2\r
-release.\r
-\r
- ● Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl\r
-\r
- fix table/cell borders for wordml, fix formal figure, add emphasis-strong\r
-\r
- ● Mauritz Jeanson: supported.xml\r
-\r
- Changed @cols to 5.\r
-\r
- ● Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml\r
-\r
- added pubdate, fixed metadata handling in biblioentry\r
-\r
- ● Steve Ball: supported.xml\r
-\r
- Added support for edition.\r
-\r
- ● Steve Ball: docbook-pages.xsl; wordml-blocks.xsl; docbook.xsl; wordml.xsl;\r
- pages-normalise⋯\r
-\r
- Removed stylesheets for old, deprecated conversion method.\r
-\r
- ● Steve Ball: specifications.xml; dbk2ooo.xsl; blocks2dbk.xsl; dbk2pages.xsl;\r
- blocks2dbk.dtd⋯\r
-\r
- Added support for Open Office, added edition element, improved list and table support in Word and Pages\r
-\r
- ● Steve Ball: normalise-common.xsl; blocks2dbk.xsl; dbk2pages.xsl;\r
- template-pages.xml; templ⋯\r
-\r
- Fixed bug in WordML table handling, improved table handling for Pages 08, synchronised WordML and Pages templates.\r
-\r
- ● Steve Ball: normalise-common.xsl; blocks2dbk.xsl; wordml2normalise.xsl;\r
- dbk2wp.xsl\r
-\r
- fix caption, attributes\r
-\r
- ● Steve Ball: specifications.xml; blocks2dbk.xsl; wordml2normalise.xsl;\r
- blocks2dbk.dtd; temp⋯\r
-\r
- Fixes to table and list handling\r
-\r
- ● Steve Ball: blocks2dbk.xsl\r
-\r
- added support for explicit emphasis character styles\r
-\r
- ● Steve Ball: wordml2normalise.xsl\r
-\r
- added support for customisation in image handling\r
-\r
- ● Steve Ball: blocks2dbk.xsl\r
-\r
- Added inlinemediaobject support for metadata.\r
-\r
- ● Steve Ball: normalise-common.xsl; blocks2dbk.xsl; template.xml;\r
- dbk2wordml.xsl; dbk2wp.xsl\r
-\r
- Added support file. Added style locking. Conversion bug fixes.\r
-\r
-Slides\r
-\r
-The following changes have been made to the slides code since the 1.73.2\r
-release.\r
-\r
- ● Michael(tm) Smith: fo/Makefile; html/Makefile\r
-\r
- Added checks and hacks to various makefiles to enable building\r
- under Cygwin. This stuff is ugly and maybe not worth the mess and\r
- trouble, but does seem to work as expected and not break anything\r
- else.\r
-\r
- ● Jirka Kosek: html/plain.xsl\r
-\r
- Added support for showing foil number\r
-\r
-Website\r
-\r
-The following changes have been made to the website code since the 1.73.2\r
-release.\r
-\r
- ● Michael(tm) Smith: extensions/saxon64/.classes/.gitignore; extensions/\r
- xalan2/.classes/com/⋯\r
-\r
- renamed a bunch more .cvsignore files to .gitignore (to facilitate use of git-svn)\r
-\r
-Params\r
-\r
-The following changes have been made to the params code since the 1.73.2\r
-release.\r
-\r
- ● Keith Fahlgren: epub.autolabel.xml\r
-\r
- New parameter for epub, epub.autolabel\r
-\r
- ● Mauritz Jeanson: table.frame.border.color.xml; table.cell.padding.xml;\r
- table.cell.border.t⋯\r
-\r
- Added missing refpurposes and descriptions.\r
-\r
- ● Keith Fahlgren: ade.extensions.xml\r
-\r
- Extensions to support Adobe Digital Editions extensions in .epub output.\r
-\r
- ● Mauritz Jeanson: fop.extensions.xml; fop1.extensions.xml\r
-\r
- Clarified that fop1.extensions is for FOP 0.90 and later. Version 1 is not here yet...\r
-\r
- ● Michael(tm) Smith: man.links.are.underlined.xml;\r
- man.endnotes.list.enabled.xml; man.font.l⋯\r
-\r
- removed man.links.are.underlined and added man.font.links. Also,\r
- changed the default font formatting for links to bold.\r
-\r
- ● Michael(tm) Smith: man.base.url.for.relative.links.xml\r
-\r
- Added new param man.base.url.for.relative.links .. specifies a\r
- base URL for relative links (for ulink, @xlink:href, imagedata,\r
- audiodata, videodata) shown in the generated NOTES section of\r
- man-page output. The value of man.base.url.for.relative.links is\r
- prepended to any relative URI that is a value of ulink url,\r
- xlink:href, or fileref attribute.\r
-\r
- If you use relative URIs in link sources in your DocBook refentry\r
- source, and you leave man.base.url.for.relative.links unset, the\r
- relative links will appear "as is" in the NOTES section of any\r
- man-page output generated from your source. That's probably not\r
- what you want, because such relative links are only usable in the\r
- context of HTML output. So, to make the links meaningful and\r
- usable in the context of man-page output, set a value for\r
- man.base.url.for.relative.links that points\r
- to the online version of HTML output generated from your DocBook\r
- refentry source. For example:\r
-\r
- <xsl:param name="man.base.url.for.relative.links"\r
- >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param>\r
-\r
- ● Michael(tm) Smith: man.string.subst.map.xml\r
-\r
- squeeze .sp\n.sp into a single .sp (to prevent a extra, spurious\r
- line of whitespace from being inserted after programlisting etc.\r
- in certain cases)\r
-\r
- ● Michael(tm) Smith: refentry.manual.fallback.profile.xml;\r
- refentry.source.fallback.profile.⋯\r
-\r
- don't use refmiscinfo@class=date value as fallback for refentry\r
- "source" or "manual" metadata fields\r
-\r
- ● Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml;\r
- man.charmap.su⋯\r
-\r
- made some further doc tweaks related to the\r
- man.charmap.subset.profile.english param\r
-\r
- ● Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml;\r
- man.charmap.su⋯\r
-\r
- Added the man.charmap.subset.profile.english parameter and refined\r
- the handling of charmap subsets to differentiate between English\r
- and non-English source.\r
-\r
- This way charmap subsets are now handled is this:\r
-\r
- If the value of the man.charmap.use.subset parameter is non-zero,\r
- and your DocBook source is not written in English (that is, if its\r
- lang or xml:lang attribute has a value other than en), then the\r
- character-map subset specified by the man.charmap.subset.profile\r
- parameter is used instead of the full roff character map.\r
-\r
- Otherwise, if the lang or xml:lang attribute on the root element\r
- in your DocBook source or on the first refentry element in your\r
- source has the value en or if it has no lang or xml:lang\r
- attribute, then the character-map subset specified by the\r
- man.charmap.subset.profile.english parameter is used instead of\r
- man.charmap.subset.profile.\r
-\r
- The difference between the two subsets is that\r
- man.charmap.subset.profile provides mappings for characters in\r
- Western European languages that are not part of the Roman\r
- (English) alphabet (ASCII character set).\r
-\r
- ● Michael(tm) Smith: man.charmap.subset.profile.xml\r
-\r
- Added to default charmap used by manpages:\r
-\r
- - the "letters" part of the 'C1 Controls And Latin-1 Supplement\r
- (Latin-1 Supplement)' Unicode block\r
- - Latin Extended-A block (but not all of the characters from\r
- that block have mappings in groff, so some of them are still\r
- passed through as-is)\r
-\r
- The effects of this change are that in man pages generated for\r
- most Western European languages and for Finnish, all characters\r
- not part of the Roman alphabet are (e.g., "accented" characters)\r
- are converted to groff escapes.\r
-\r
- Previously, by default we passed through those characters as is\r
- (and users needed to use the full charmap if they wanted to have\r
- those characters converted).\r
-\r
- As a result of this change, man pages generated for Western\r
- European languages will be viewable in some environments in which\r
- they are not viewable if the "raw" non-Roman characters are in them.\r
-\r
- ● Mauritz Jeanson: generate.legalnotice.link.xml;\r
- generate.revhistory.link.xml\r
-\r
- Added information on how the filename is computed.\r
-\r
- ● Mauritz Jeanson: default.table.width.xml\r
-\r
- Clarified PI usage.\r
-\r
- ● Michael(tm) Smith: man.funcsynopsis.style.xml\r
-\r
- Added the man.funcsynopsis.style parameter. Has the same effect in\r
- manpages output as the funcsynopsis.style parameter has in HTML\r
- output -- except that its default value is 'ansi' instead of 'kr'.\r
-\r
- ● Michael(tm) Smith: funcsynopsis.tabular.threshold.xml\r
-\r
- Removed the funcsynopsis.tabular.threshold param. It's no longer\r
- being used in the code and hasn't been since mid 2006.\r
-\r
- ● Mauritz Jeanson: table.properties.xml\r
-\r
- Set keep-together.within-column to "auto". This seems to be the most sensible\r
- default value for tables.\r
-\r
- ● Mauritz Jeanson: informal.object.properties.xml;\r
- admon.graphics.extension.xml; informalequ⋯\r
-\r
- Several small documentation fixes.\r
-\r
- ● Mauritz Jeanson: manifest.in.base.dir.xml\r
-\r
- Wording fixes.\r
-\r
- ● Mauritz Jeanson: header.content.properties.xml;\r
- footer.content.properties.xml\r
-\r
- Added refpurpose.\r
-\r
- ● Mauritz Jeanson: ulink.footnotes.xml; ulink.show.xml\r
-\r
- Updated for DocBook 5.\r
-\r
- ● Mauritz Jeanson: index.method.xml; glossterm.auto.link.xml\r
-\r
- Spelling and wording fixes.\r
-\r
- ● Mauritz Jeanson: callout.graphics.extension.xml\r
-\r
- Clarifed available graphics formats and extensions.\r
-\r
- ● Mauritz Jeanson: footnote.sep.leader.properties.xml\r
-\r
- Corrected refpurpose.\r
-\r
- ● Jirka Kosek: footnote.properties.xml\r
-\r
- Added more properties which make it possible to render correctly footnotes placed inside verbatim elements.\r
-\r
- ● Mauritz Jeanson: img.src.path.xml\r
-\r
- img.src.path works with inlinegraphic too.\r
-\r
- ● Mauritz Jeanson: saxon.character.representation.xml\r
-\r
- Added TCG link.\r
-\r
- ● Mauritz Jeanson: img.src.path.xml\r
-\r
- Updated description of img.src.path. Bug #1785224 revealed that\r
- there was a risk of misunderstanding how it works.\r
-\r
-Profiling\r
-\r
-The following changes have been made to the profiling code since the 1.73.2\r
-release.\r
-\r
- ● Jirka Kosek: xsl2profile.xsl\r
-\r
- Added new rules to profile all content generated by HTML Help (including alias files)\r
-\r
- ● Robert Stayton: profile-mode.xsl\r
-\r
- use mode="profile" instead of xsl:copy-of for attributes so\r
- they can be more easily customized.\r
-\r
-Tools\r
-\r
-The following changes have been made to the tools code since the 1.73.2\r
-release.\r
-\r
- ● Michael(tm) Smith: make/Makefile.DocBook\r
-\r
- various changes and additions to support making with asciidoc as\r
- an input format\r
-\r
- ● Michael(tm) Smith: make/Makefile.DocBook\r
-\r
- make dblatex the default PDF maker for the example makefile\r
-\r
- ● Michael(tm) Smith: xsl/build/html2roff.xsl\r
-\r
- Reworked handling of K&R funcprototype output. It no longer relies\r
- on the HTML kr-tabular templates, but instead just does direct\r
- transformation to roff. For K&R output, it displays the paramdef\r
- output in an indented list following the prototype.\r
-\r
- ● Mauritz Jeanson: xsl/build/make-xsl-params.xsl\r
-\r
- Made attribute-sets members of the param list. This enables links to attribute-sets in the\r
- reference documentation.\r
-\r
- ● Michael(tm) Smith: xsl/build/html2roff.xsl\r
-\r
- use .BI handling in K&R funsynopsis output for manpages, just as\r
- we do already of ANSI output\r
-\r
- ● Michael(tm) Smith: xsl/build/html2roff.xsl\r
-\r
- Implemented initial support for handling tabular K&R output of\r
- funcprototype in manpages output. Accomplished by adding more\r
- templates to the intermediate HTML-to-roff stylesheet that the\r
- build uses to create the manpages/html-synop.xsl stylesheet.\r
-\r
- ● Michael(tm) Smith: xsl/build/doc-link-docbook.xsl\r
-\r
- Made the xsl/tools/xsl/build/doc-link-docbook.xsl stylesheet\r
- import profile-docbook.xsl, so that we can do profiling of release\r
- notes. Corrected some problems in the target for the release-notes\r
- HTML build.\r
-\r
-Extensions\r
-\r
-The following changes have been made to the extensions code since the 1.73.2\r
-release.\r
-\r
- ● Keith Fahlgren: Makefile\r
-\r
- Use DOCBOOK_SVN variable everywhere, please; build with PDF_MAKER\r
-\r
- ● Michael(tm) Smith: Makefile\r
-\r
- moved extensions build targets from master xsl/Makefile to\r
- xsl/extensions/Makefile\r
-\r
- ● Michael(tm) Smith: .cvsignore\r
-\r
- re-adding empty extensions subdir\r
-\r
-XSL-Saxon\r
-\r
-The following changes have been made to the xsl-saxon code since the 1.73.2\r
-release.\r
-\r
- ● Michael(tm) Smith: VERSION\r
-\r
- bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with\r
- recent change to snapshot build infrastructure\r
-\r
- ● Michael(tm) Smith: nbproject/build-impl.xml; nbproject/project.properties\r
-\r
- Changed hard-coded file references in "clean" target to variable\r
- references. Closes #1792043. Thanks to Daniel Leidert.\r
-\r
- ● Michael(tm) Smith: VERSION; Makefile\r
-\r
- Did post-release wrap-up of xsl-saxon and xsl-xalan dirs\r
-\r
- ● Michael(tm) Smith: nbproject/build-impl.xml; VERSION; Makefile; test\r
-\r
- More tweaks to get release-ready\r
-\r
-XSL-Xalan\r
-\r
-The following changes have been made to the xsl-xalan code since the 1.73.2\r
-release.\r
-\r
- ● Michael(tm) Smith: VERSION\r
-\r
- bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with\r
- recent change to snapshot build infrastructure\r
-\r
- ● Michael(tm) Smith: nbproject/build-impl.xml\r
-\r
- Changed hard-coded file references in "clean" target to variable\r
- references. Closes #1792043. Thanks to Daniel Leidert.\r
-\r
- ● Michael(tm) Smith: Makefile; VERSION\r
-\r
- Did post-release wrap-up of xsl-saxon and xsl-xalan dirs\r
-\r
- ● Michael(tm) Smith: Makefile; nbproject/build-impl.xml; VERSION\r
-\r
- More tweaks to get release-ready\r
-\r
-XSL-libxslt\r
-\r
-The following changes have been made to the xsl-libxslt code since the 1.73.2\r
-release.\r
-\r
- ● Mauritz Jeanson: python/xslt.py\r
-\r
- Print the result to stdout if no outfile has been given.\r
- Some unnecessary semicolons removed.\r
-\r
- ● Mauritz Jeanson: python/xslt.py\r
-\r
- Added a function that quotes parameter values (to ensure that they are interpreted as strings).\r
- Replaced deprecated functions from the string module with string methods.\r
-\r
- ● Michael(tm) Smith: python/README; python/README.LIBXSLT\r
-\r
- renamed xsl-libxslt/python/README to xsl-libxslt/python/README.LIBXSLT\r
-\r
- ● Mauritz Jeanson: python/README\r
-\r
- Tweaked the text a little.\r
-\r
-Release Notes: 1.73.2\r
-\r
-This is solely a minor bug-fix update to the 1.73.1 release. It fixes a\r
-packaging error in the 1.73.1 package, as well as a bug in footnote handling in\r
-FO output.\r
-\r
-Release: 1.73.1\r
-\r
-This is mostly a bug-fix update to the 1.73.0 release.\r
-\r
-Gentext\r
-\r
-The following changes have been made to the gentext code since the 1.73.0\r
-release.\r
-\r
- ● Mauritz Jeanson: locale/de.xml\r
-\r
- Applied patch #1766009.\r
-\r
- ● Michael(tm) Smith: locale/lv.xml\r
-\r
- Added localization for ProductionSet.\r
-\r
-FO\r
-\r
-The following changes have been made to the fo code since the 1.73.0 release.\r
-\r
- ● Mauritz Jeanson: table.xsl\r
-\r
- Modified the tgroup template so that, for tables with multiple tgroups,\r
- a width attribute is output on all corresponding fo:tables. Previously,\r
- there was a test prohibiting this (and a comment saying that outputting more\r
- than one width attribute will cause an error). But this seems to be no longer\r
- relevant; it is not a problem with FOP 0.93 or XEP 4.10. Closes bug #1760559.\r
-\r
- ● Mauritz Jeanson: graphics.xsl\r
-\r
- Replaced useless <a> elements with warning messages (textinsert extension).\r
-\r
- ● Mauritz Jeanson: admon.xsl\r
-\r
- Enabled generation of ids (on fo:wrapper) for indexterms in admonition titles, so that page\r
- references in the index can be created. Closes bug #1775086.\r
-\r
-HTML\r
-\r
-The following changes have been made to the html code since the 1.73.0 release.\r
-\r
- ● Mauritz Jeanson: titlepage.xsl\r
-\r
- Added <xsl:call-template name="process.footnotes"/> to abstract template\r
- so that footnotes in info/abstract are processed. Closes bug #1760907.\r
-\r
- ● Michael(tm) Smith: pi.xsl; synop.xsl\r
-\r
- Changed handling of HTML output for the cmdsynopsis and\r
- funcsynopsis elements, such that a@id instances are generated for\r
- them if they are descendants of any element containing a dbcmdlist\r
- or dbfunclist PI. Also, update the embedded reference docs for the\r
- dbcmdlist and dbfunclist PIs to make it clear that they can be\r
- used within any element for which cmdsynopsis or funcsynopsis are\r
- valid children.\r
-\r
- ● Michael(tm) Smith: formal.xsl\r
-\r
- Reverted the part of revision 6952 that caused a@id anchors to be\r
- generated for output of informal objects. Thanks to Sam Steingold\r
- for reporting.\r
-\r
- ● Robert Stayton: glossary.xsl\r
-\r
- Account for a glossary with no glossdiv or glossentry children.\r
-\r
- ● Mauritz Jeanson: titlepage.xsl\r
-\r
- Modified legalnotice template so that the base.name parameter is calculated\r
- in the same way as for revhistory chunks. Using <xsl:apply-templates\r
- mode="chunk-filename" select="."/> did not work for single-page output since\r
- the template with that mode is in chunk-code.xsl.\r
-\r
- ● Mauritz Jeanson: graphics.xsl\r
-\r
- Updated support for SVG (must be a child of imagedata in DB 5).\r
- Added support for MathML in imagedata.\r
-\r
- ● Mauritz Jeanson: pi.xsl\r
-\r
- Added documentation for the dbhh PI (used for context-sensitive HTML Help).\r
- (The two templates matching 'dbhh' are still in htmlhelp-common.xsl).\r
-\r
-Manpages\r
-\r
-The following changes have been made to the manpages code since the 1.73.0\r
-release.\r
-\r
- ● Michael(tm) Smith: endnotes.xsl\r
-\r
- In manpages output, generate warnings about notesources with\r
- non-para children only if the notesource is a footnote or\r
- annotation. Thanks to Sam Steingold for reporting problems with\r
- the existing handling.\r
-\r
-HTMLHelp\r
-\r
-The following changes have been made to the htmlhelp code since the 1.73.0\r
-release.\r
-\r
- ● Michael(tm) Smith: htmlhelp-common.xsl\r
-\r
- Added single-pass namespace-stripping support to the htmlhelp,\r
- eclipse, and javahelp stylesheets.\r
-\r
-Eclipse\r
-\r
-The following changes have been made to the eclipse code since the 1.73.0\r
-release.\r
-\r
- ● Michael(tm) Smith: eclipse.xsl\r
-\r
- Added single-pass namespace-stripping support to the htmlhelp,\r
- eclipse, and javahelp stylesheets.\r
-\r
-JavaHelp\r
-\r
-The following changes have been made to the javahelp code since the 1.73.0\r
-release.\r
-\r
- ● Michael(tm) Smith: javahelp.xsl\r
-\r
- Added single-pass namespace-stripping support to the htmlhelp,\r
- eclipse, and javahelp stylesheets.\r
-\r
-Roundtrip\r
-\r
-The following changes have been made to the roundtrip code since the 1.73.0\r
-release.\r
-\r
- ● Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; pages2normalise.xsl\r
-\r
- Modularised blocks2dbk to allow customisation,\r
- Added support for tables to pages2normalise\r
-\r
-Params\r
-\r
-The following changes have been made to the params code since the 1.73.0\r
-release.\r
-\r
- ● Robert Stayton: procedure.properties.xml\r
-\r
- procedure was inheriting keep-together from formal.object.properties, but\r
- a procedure does not need to be kept together by default.\r
-\r
- ● Dave Pawson: title.font.family.xml;\r
- component.label.includes.part.label.xml; table.frame.b⋯\r
-\r
- Regular formatting re-org.\r
-\r
-Release: 1.73.0\r
-\r
-This release includes important bug fixes and adds the following significant\r
-feature changes:\r
-\r
-New localizations and localization updates\r
-\r
- We added two new localizations: Latvian and Esperanto, and made updates to\r
- the Czech, Chinese Simplified, Mongolian, Serbian, Italian, and Ukrainian\r
- localizations.\r
-\r
-ISO690 citation style for bibliography output.\r
-\r
- Set the bibliography.style parameter to iso690 to use ISO690 style.\r
-\r
-New documentation for processing instructions (PI)\r
-\r
- The reference documentation that ships with the release now includes\r
- documentation on all PIs that you can use to control output from the\r
- stylesheets.\r
-\r
-New profiling parameters for audience and wordsize\r
-\r
- You can now do profiling based on the values of the audience and wordsize\r
- attributes.\r
-\r
-Changes to man-page output\r
-\r
- The manpages stylesheet now supports single-pass profiling and single-pass\r
- DocBook 5 namespace stripping (just as the HTML and FO stylesheets also\r
- do). Also, added handling for mediaobject & inlinemediaobject. (Each\r
- imagedata, audiodata, or videodata element within a mediaobject or inline\r
- mediaobject is now treated as a "notesource" and so handled in much the\r
- same way as links and annotation/alt/footnote are in manpages output.) And\r
- added the man.authors.section.enabled and man.copyright.section.enabled\r
- parameters to enable control over whether output includes auto-generated\r
- AUTHORS and COPYRIGHT sections.\r
-\r
-Highlighting support for C\r
-\r
- The highlighting mechanism for generating syntax-highlighted code snippets\r
- in output now supports C code listings (along with Java, PHP, XSLT, and\r
- others).\r
-\r
-Experimental docbook-xsl-update script\r
-\r
- We added an experimental docbook-xsl-update script, the purpose of which is\r
- to facilitate easy sync-up to the latest docbook-xsl snapshot (by means of\r
- rsync).\r
-\r
-Gentext\r
-\r
-The following changes have been made to the gentext code since the 1.72.0\r
-release.\r
-\r
- ● Michael(tm) Smith: locale/lv.xml; Makefile\r
-\r
- Added Latvian localization file, from Girts Ziemelis.\r
-\r
- ● Dongsheng Song: locale/zh_cn.xml\r
-\r
- Brought up to date with en.xml in terms of items. A few strings marked for translation.\r
-\r
- ● Jirka Kosek: locale/cs.xml\r
-\r
- Added missing translations\r
-\r
- ● Robert Stayton: locale/eo.xml\r
-\r
- New locale for Esperanto.\r
-\r
- ● Robert Stayton: locale/mn.xml\r
-\r
- Update from Ganbold Tsagaankhuu.\r
-\r
- ● Jirka Kosek: locale/en.xml; locale/cs.xml\r
-\r
- Rules for normalizing glossary entries before they are sorted can be now different for each language.\r
-\r
- ● Michael(tm) Smith: locale/sr_Latn.xml; locale/sr.xml\r
-\r
- Committed changes from Miloš Komarčević to Serbian files.\r
-\r
- ● Robert Stayton: locale/ja.xml\r
-\r
- Fix chapter in context xref-number-and-title\r
-\r
- ● Robert Stayton: locale/it.xml\r
-\r
- Improved version from contributor.\r
-\r
- ● Mauritz Jeanson: locale/uk.xml\r
-\r
- Applied patch 1592083.\r
-\r
-Common\r
-\r
-The following changes have been made to the common code since the 1.72.0\r
-release.\r
-\r
- ● Michael(tm) Smith: labels.xsl\r
-\r
- Changed handling of reference auto-labeling such that reference\r
- (when it appears at the component level) is now affected by the\r
- label.from.part param, just as preface, chapter, and appendix.\r
-\r
- ● Michael(tm) Smith: common.xsl\r
-\r
- Added support to the HTML stylesheets for proper processing of\r
- orgname as a child of author.\r
-\r
- ● Michael(tm) Smith: refentry.xsl\r
-\r
- Refined logging output of refentry metadata-gathering template;\r
- for some cases of "missing" elements (refmiscinfo stuff, etc.),\r
- the log messages now include URL to corresponding page in the\r
- Definitive Guide (TDG).\r
-\r
- ● Robert Stayton: titles.xsl\r
-\r
- Add refsection/info/title support.\r
-\r
- ● Michael(tm) Smith: titles.xsl\r
-\r
- Added support for correct handling of xref to elements that\r
- contain info/title descendants but no title children.\r
-\r
- This should be further refined so that it handles any *info\r
- elements. And there are probably some other places where similar\r
- handling for *info/title should be added.\r
-\r
- ● Mauritz Jeanson: pi.xsl\r
-\r
- Modified <xsl:when> in datetime.format template to work\r
- around Xalan bug.\r
-\r
-FO\r
-\r
-The following changes have been made to the fo code since the 1.72.0 release.\r
-\r
- ● Robert Stayton: component.xsl\r
-\r
- Add parameters to the page.sequence utility template.\r
-\r
- ● Mauritz Jeanson: xref.xsl\r
-\r
- Added template for xref to area/areaset.\r
- Part of fix for bug #1675513 (xref to area broken).\r
-\r
- ● Michael(tm) Smith: inline.xsl\r
-\r
- Added template match for person element to fo stylesheet.\r
-\r
- ● Robert Stayton: lists.xsl\r
-\r
- Added support for spacing="compact" in variablelist, per bug report #1722540.\r
-\r
- ● Robert Stayton: table.xsl\r
-\r
- table pgwide="1" should also use pgwide.properties attribute-set.\r
-\r
- ● Mauritz Jeanson: inline.xsl\r
-\r
- Make citations numbered if bibliography.numbered != 0.\r
-\r
- ● Robert Stayton: param.xweb; param.ent\r
-\r
- Add new profiling parameters for audience and wordsize.\r
-\r
- ● Robert Stayton: param.xweb; param.ent\r
-\r
- Added callout.icon.size parameter.\r
-\r
- ● Robert Stayton: inline.xsl; xref.xsl\r
-\r
- Add support for xlink as olink.\r
-\r
- ● Robert Stayton: autotoc.xsl; param.xweb; param.ent\r
-\r
- Add support for qanda.in.toc to fo TOC.\r
-\r
- ● Robert Stayton: component.xsl\r
-\r
- Improved the page.sequence utility template for use with book.\r
-\r
- ● Robert Stayton: division.xsl\r
-\r
- Refactored the big book template into smaller pieces.\r
- Used the "page.sequence" utility template in\r
- component.xsl to shorten the toc piece.\r
- Added placeholder templates for front.cover and back.cover.\r
-\r
- ● Robert Stayton: param.xweb; param.ent; sections.xsl\r
-\r
- Add section.container.element parameter to enable\r
- pgwide spans inside sections.\r
-\r
- ● Robert Stayton: param.xweb; param.ent; component.xsl\r
-\r
- Add component.titlepage.properties attribute-set to\r
- support span="all" and other properties.\r
-\r
- ● Robert Stayton: htmltbl.xsl; table.xsl\r
-\r
- Apply table.row.properties template to html tr rows too.\r
- Add keep-with-next to table.row.properties when row is in thead.\r
-\r
- ● Robert Stayton: table.xsl\r
-\r
- Add support for default.table.frame parameter.\r
- Fix bug 1575446 rowsep last check for @morerows.\r
-\r
- ● Robert Stayton: refentry.xsl\r
-\r
- Add support for info/title in refsections.\r
-\r
- ● David Cramer: qandaset.xsl\r
-\r
- Make fo questions and answers behave the same way as html\r
-\r
- ● Jirka Kosek: lists.xsl\r
-\r
- Added missing attribute set for procedure\r
-\r
- ● Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent;\r
- biblio-iso690.xsl\r
-\r
- Added support for formatting biblioentries according to ISO690 citation style.\r
- New bibliography style can be turned on by setting parameter bibliography.style to "iso690"\r
- The code was provided by Jana Dvorakova\r
-\r
- ● Robert Stayton: param.xweb; param.ent; pagesetup.xsl\r
-\r
- Add header.table.properties and footer.table.properties attribute-sets.\r
-\r
- ● Robert Stayton: inline.xsl\r
-\r
- Add fop1.extensions for menuchoice arrow handling exception.\r
-\r
-HTML\r
-\r
-The following changes have been made to the html code since the 1.72.0 release.\r
-\r
- ● Mauritz Jeanson: param.xweb; param.ent\r
-\r
- Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the\r
- regular "parameter machinery".\r
-\r
- ● Michael(tm) Smith: admon.xsl\r
-\r
- Changed handling of titles for note, warning, caution, important,\r
- tip admonitions: We now output and HTML h3 head only if\r
- admon.textlabel is non-zero or if the admonition actually contains\r
- a title; otherwise, we don't output an h3 head at all.\r
- (Previously, we were outputting an empty h3 if the admon.textlabel\r
- was zero and if the admonition had no title.)\r
-\r
- ● Mauritz Jeanson: xref.xsl\r
-\r
- Added template for xref to area/areaset.\r
- Part of fix for bug #1675513 (xref to area broken).\r
-\r
- ● Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; sections.xsl\r
-\r
- Added fixes to avoid duplicate ids when generate.id.attributes = 1.\r
- This (hopefully) closes bug #1671052.\r
-\r
- ● Michael(tm) Smith: formal.xsl; pi.xsl\r
-\r
- Made the dbfunclist PI work as intended. Also added doc for\r
- dbfunclist and dbcmdlist PIs.\r
-\r
- ● Michael(tm) Smith: pi.xsl; synop.xsl\r
-\r
- Made the dbcmdlist work the way it appears to have been intended\r
- to work. Restored dbhtml-dir template back to pi.xsl.\r
-\r
- ● Michael(tm) Smith: titlepage.xsl; param.xweb; param.ent\r
-\r
- Added new param abstract.notitle.enabled.\r
- If non-zero, in output of the abstract element on titlepages,\r
- display of the abstract title is suppressed.\r
- Because sometimes you really don't want or need that title\r
- there...\r
-\r
- ● Michael(tm) Smith: chunk-code.xsl; graphics.xsl\r
-\r
- When we are chunking long descriptions for mediaobject instances\r
- into separate HTML output files, and use.id.as.filename is\r
- non-zero, if a mediaobject has an ID, use that ID as the basename\r
- for the long-description file (otherwise, we generate an ID for it\r
- and use that ID as the basename for the file).\r
- The parallels the recent change made to cause IDs for legalnotice\r
- instances to be used as basenames for legalnotice chunks.\r
- Also, made some minor refinements to the recent changes for\r
- legalnotice chunk handling.\r
-\r
- ● Michael(tm) Smith: titlepage.xsl\r
-\r
- Added support to the HTML stylesheets for proper processing of\r
- orgname as a child of author.\r
-\r
- ● Michael(tm) Smith: chunk-code.xsl\r
-\r
- When $generate.legalnotice.link is non-zero and\r
- $use.id.as.filename is also non-zero, if a legalnotice has an ID,\r
- then instead of assigning the "ln-<generatedID>" basename to the\r
- output file for that legalnotice, just use its real ID as the\r
- basename for the file -- as we do when chunking other elements\r
- that have IDs.\r
-\r
- ● David Cramer: xref.xsl\r
-\r
- Handle alt text on xrefs to steps when the step doesn't have a title.\r
-\r
- ● David Cramer: lists.xsl\r
-\r
- Added <p> element around term in variablelist when formatted as table to avoid misalignment of term and listitem in xhtml (non-quirks mode) output\r
-\r
- ● David Cramer: qandaset.xsl\r
-\r
- Added <p> element around question and answer labels to avoid misalignment of label and listitem in xhtml (non-quirks mode) output\r
-\r
- ● David Cramer: lists.xsl\r
-\r
- Added <p> element around callouts to avoid misalignment of callout and listitem in xhtml (non-quirks mode) output\r
-\r
- ● Mauritz Jeanson: inline.xsl\r
-\r
- Make citations numbered if bibliography.numbered != 0.\r
-\r
- ● Robert Stayton: param.xweb; param.ent\r
-\r
- Add support for new profiling attributes audience and wordsize.\r
-\r
- ● Robert Stayton: inline.xsl; xref.xsl\r
-\r
- Add support for xlink olinks.\r
-\r
- ● Jirka Kosek: glossary.xsl\r
-\r
- Rules for normalizing glossary entries before they are sorted can be now different for each language.\r
-\r
- ● Robert Stayton: chunk-common.xsl; chunk-code.xsl; manifest.xsl; chunk.xsl\r
-\r
- Refactored the chunking modules to move all named templates to\r
- chunk-common.xsl and all match templates to chunk-code.xsl, in\r
- order to enable better chunk customization.\r
- See the comments in chunk.xsl for more details.\r
-\r
- ● Robert Stayton: lists.xsl\r
-\r
- Add anchor for xml:id for listitem in varlistentry.\r
-\r
- ● Robert Stayton: refentry.xsl\r
-\r
- Add support for info/title in refsections for db5.\r
-\r
- ● Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent;\r
- biblio-iso690.xsl\r
-\r
- Added support for formatting biblioentries according to ISO690 citation style.\r
- New bibliography style can be turned on by setting parameter bibliography.style to "iso690"\r
- The code was provided by Jana Dvorakova\r
-\r
- ● Robert Stayton: inline.xsl; xref.xsl\r
-\r
- Add call to class.attribute to <a> output elements so they can\r
- have a class value too.\r
-\r
- ● Mauritz Jeanson: glossary.xsl\r
-\r
- Fixed bug #1644881:\r
- * Added curly braces around all $language attribute values.\r
- * Moved declaration of language variable to top level of stylesheet.\r
- Tested with Xalan, Saxon, and xsltproc.\r
-\r
-Manpages\r
-\r
-The following changes have been made to the manpages code since the 1.72.0\r
-release.\r
-\r
- ● Michael(tm) Smith: param.xweb; docbook.xsl; param.ent\r
-\r
- Added the man.authors.section.enabled and\r
- man.copyright.section.enabled parameters. Set those to zero when\r
- you want to suppress display of the auto-generated AUTHORS and\r
- COPYRIGHT sections. Closes request #1467806. Thanks to Daniel\r
- Leidert.\r
-\r
- ● Michael(tm) Smith: docbook.xsl\r
-\r
- Took the test that the manpages stylesheet does to see if there\r
- are any Refentry chilren in current doc, and made it\r
- namespace-agnostic. Reason for that is because the test otherwise\r
- won't work when it is copied over into the generated\r
- profile-docbook.xsl stylesheet.\r
-\r
- ● Michael(tm) Smith: Makefile\r
-\r
- Added a manpages/profile-docbook.xsl file to enable single-pass\r
- profiling for manpages output.\r
-\r
- ● Michael(tm) Smith: info.xsl\r
-\r
- Output copyright and legalnotice in man-page output in whatever\r
- place they are in in document order. Closes #1690539. Thanks to\r
- Daniel Leidert for reporting.\r
-\r
- ● Michael(tm) Smith: docbook.xsl\r
-\r
- Restored support for single-pass namespace stripping to manpages\r
- stylesheet.\r
-\r
- ● Michael(tm) Smith: synop.xsl; block.xsl; info.xsl; inline.xsl; lists.xsl;\r
- endnotes.xsl; ut⋯\r
-\r
- Changed handling of bold and italic/underline output in manpages\r
- output. Should be transparent to users, but...\r
-\r
- This touches handling of all bold and italic/underline output. The\r
- exact change is that the mode="bold" and mode="italic" utility\r
- templates were changed to named templates. (I think maybe I've\r
- changed it back and forth from mode to named before, so this is\r
- maybe re-reverting it yet again).\r
-\r
- Anyway, the reason for the change is that the templates are\r
- sometimes call on dynamically node-sets, and using modes to format\r
- those doesn't allow passing info about the current/real context\r
- node from the source (not the node-set created by the stylesheet)\r
- to that formatting stage.\r
-\r
- The named templates allow the context to be passed in as a\r
- parameter, so that the bold/ital formatting template can use\r
- context-aware condition checking.\r
-\r
- This was basically necessary in order to suppress bold formatting\r
- in titles, which otherwise gets screwed up because of the numbnut\r
- way that roff handles nested bold/ital.\r
-\r
- Closes #1674534). Much thanks to Daniel Leidert, whose in his\r
- docbook-xsl bug-finding kung-fu has achieved Grand Master status.\r
-\r
- ● Michael(tm) Smith: block.xsl\r
-\r
- Fixed handling of example instances by adding the example element\r
- to the same template we use for processing figure. Closes\r
- #1674538. Thanks to Daniel Leidert.\r
-\r
- ● Michael(tm) Smith: utility.xsl\r
-\r
- Don't include lang in manpages filename/pathname if lang=en (that\r
- is, only generate lang-qualified file-/pathnames for non-English).\r
-\r
- ● Michael(tm) Smith: endnotes.xsl\r
-\r
- In manpages output, emit warnings for notesources (footnote, etc.)\r
- that have something other than para as a child.\r
-\r
- The numbered-with-hanging-indent formatting that's used for\r
- rendering endnotes in the NOTES section of man pages places some\r
- limits/assumptions on how the DocBook source is marked up; namely,\r
- for notesources (footnote, annotation, etc.) that can contain\r
- block-level children, if the they have a block-level child such as\r
- a table or itemizedlist or orderedlist that is the first child of\r
- a footnote, we have no way of rendering/indenting its content\r
- properly in the endnotes list.\r
-\r
- Thus, the manpages stylesheet not emits a warning message for that\r
- case, and suggests the "fix" (which is to wrap the table or\r
- itemizedlist or whatever in a para that has some preferatory text.\r
-\r
- ● Michael(tm) Smith: utility.xsl\r
-\r
- Added support to mixed-block template for handling tables in\r
- mixed-blocks (e.g., as child of para) correctly.\r
-\r
- ● Michael(tm) Smith: table.xsl; synop.xsl; block.xsl; info.xsl; lists.xsl;\r
- refentry.xsl; end⋯\r
-\r
- Reverted necessary escaping of backslash, dot, and dash\r
- out of the well-intentioned (but it now appears,\r
- misguided) "marker" mechanism (introduced in the 1.72.0\r
- release) -- which made use of alternative "marker"\r
- characters as internal representations of those\r
- characters, and then replaced them just prior to\r
- serialization -- and back into what's basically the\r
- system that was used prior to the 1.69.0 release; that\r
- is, into a part of stylesheet code that gets executed\r
- at the beginning of processing -- before any other roff\r
- markup up is. This change obviates the need for the\r
- marker system. It also requires a lot less RAM during\r
- processing (for large files, the marker mechanism\r
- ending up requiring gigabytes of memory).\r
-\r
- Closes bug #1661177. Thanks to Scott Smedley for\r
- providing a test case (the fvwm man page) that exposed\r
- the problem with the marker mechanism.\r
-\r
- Also moved the mechanism for converting non-breaking\r
- spaces back into the same area of the stylesheet code.\r
-\r
- ● Michael(tm) Smith: lists.xsl\r
-\r
- Fixed problem with incorrect formatting of nested variablelist.\r
- Closes bug #1650931. Thanks to Daniel "Eagle Eye" Leidert.\r
-\r
- ● Michael(tm) Smith: lists.xsl\r
-\r
- Make sure that all listitems in itemizedlist and orderedlist are\r
- preceded by a blank line. This fixes a regression that occurred\r
- when instances of the TP macro that were use in a previous\r
- versions of the list-handling code were switched to RS/RE (because\r
- TP doesn't support nesting). TP automatically generates a blank\r
- line, but RS doesn't. So I added a .sp before each .RS\r
-\r
- ● Michael(tm) Smith: block.xsl; inline.xsl; param.xweb; docbook.xsl;\r
- links.xsl; param.ent\r
-\r
- Made a number of changes related to elements with\r
- out-of-line content:\r
-\r
- - Added handling for mediaobject & inlinemediaobject.\r
- Each imagedata, audiodata, or videodata element\r
- within a mediaobject or inline mediaobject is now\r
- treated as a "notesource" and so handled in much the\r
- same way as links and annotation/alt/footnotes.\r
-\r
- That means a numbered marker is generated inline to\r
- mark the place in the main flow where the imagedata,\r
- audiodata, or videodata element occurs, and a\r
- corresponding numbered endnote for it is generated in\r
- the endnotes list at the end of the man page; the\r
- endnote contains the URL from the fileref attribute\r
- of the imagedata, audiodata, or videodata element.\r
-\r
- For mediobject and inlinemediaobject instances that\r
- have a textobject child, the textobject is displayed\r
- within the main text flow.\r
-\r
- - Renamed several man.link.* params to man.endnotes.*,\r
- to reflect that fact that the endnotes list now\r
- contains more than just links. Also did similar\r
- renaming for a number of stylesheet-internal vars.\r
-\r
- - Added support for xlink:href (along with existing\r
- support for the legacy ulink element).\r
-\r
- - Cleaned up and streamlined the endnotes-handling\r
- code. It's still messy and klunky and the basic\r
- mechanism it uses is very inefficent for documents\r
- that contain a lot of notesources, but at least it's\r
- a bit better than it was.\r
-\r
-Eclipse\r
-\r
-The following changes have been made to the eclipse code since the 1.72.0\r
-release.\r
-\r
- ● Mauritz Jeanson: Makefile\r
-\r
- Fixed bug #1715093: Makefile for creating profiled version of eclipse.xsl added.\r
-\r
- ● David Cramer: eclipse.xsl\r
-\r
- Added normalize-space around to avoid leading whitespace from appearing in the output if there's extra leading whitespace (e.g. <title> Foo</title>) in the source\r
-\r
-JavaHelp\r
-\r
-The following changes have been made to the javahelp code since the 1.72.0\r
-release.\r
-\r
- ● Mauritz Jeanson: javahelp.xsl\r
-\r
- Implemented FR #1230233 (sorted index in javahelp).\r
-\r
- ● Mauritz Jeanson: javahelp.xsl\r
-\r
- Added normalize-space() around titles and index entries to work around whitespace problems.\r
- Added support for glossary and bibliography in toc and map files.\r
-\r
-Roundtrip\r
-\r
-The following changes have been made to the roundtrip code since the 1.72.0\r
-release.\r
-\r
- ● Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl; normalise2sections.xsl;\r
- sections2blocks.⋯\r
-\r
- new stylesheets for better word processor support and easier maintenance\r
-\r
- ● Steve Ball: template-pages.xml; dbk2wp.xsl; sections-spec.xml\r
-\r
- fixed bugs\r
-\r
-Params\r
-\r
-The following changes have been made to the params code since the 1.72.0\r
-release.\r
-\r
- ● Mauritz Jeanson: htmlhelp.button.back.xml; htmlhelp.button.forward.xml;\r
- htmlhelp.button.zo⋯\r
-\r
- Modified refpurpose text.\r
-\r
- ● Mauritz Jeanson: htmlhelp.map.file.xml; htmlhelp.force.map.and.alias.xml;\r
- htmlhelp.alias.f⋯\r
-\r
- Fixed typos, made some small changes.\r
-\r
- ● Mauritz Jeanson: javahelp.encoding.xml\r
-\r
- Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the\r
- regular "parameter machinery".\r
-\r
- ● Mauritz Jeanson: generate.id.attributes.xml\r
-\r
- Added refpurpose text.\r
-\r
- ● Mauritz Jeanson: annotation.js.xml; annotation.graphic.open.xml;\r
- annotation.graphic.close.⋯\r
-\r
- Added better refpurpose texts.\r
-\r
- ● Michael(tm) Smith: chunker.output.cdata-section-elements.xml;\r
- chunker.output.standalone.xm⋯\r
-\r
- Fixed some broken formatting in source files for chunker.* params,\r
- as pointed out by Dave Pawson.\r
-\r
- ● Michael(tm) Smith: label.from.part.xml\r
-\r
- Changed handling of reference auto-labeling such that reference\r
- (when it appears at the component level) is now affected by the\r
- label.from.part param, just as preface, chapter, and appendix.\r
-\r
- ● Mauritz Jeanson: callout.graphics.extension.xml\r
-\r
- Clarified that 'extension' refers to file names.\r
-\r
- ● Michael(tm) Smith: abstract.notitle.enabled.xml\r
-\r
- Added new param abstract.notitle.enabled.\r
- If non-zero, in output of the abstract element on titlepages,\r
- display of the abstract title is suppressed.\r
- Because sometimes you really don't want or need that title\r
- there...\r
-\r
- ● Michael(tm) Smith: man.string.subst.map.xml\r
-\r
- Updated manpages string-substitute map to reflect fact that\r
- because of another recent change to suppress bold markup in .SH\r
- output, we no longer need to add a workaround for the accidental\r
- uppercasing of roff escapes that occurred previously.\r
-\r
- ● Jirka Kosek: margin.note.float.type.xml; title.font.family.xml;\r
- table.frame.border.color.x⋯\r
-\r
- Improved parameter metadata\r
-\r
- ● Robert Stayton: profile.wordsize.xml; profile.audience.xml\r
-\r
- Add support for profiling on new attributes audience and wordsize.\r
-\r
- ● Robert Stayton: callout.graphics.number.limit.xml;\r
- callout.graphics.extension.xml\r
-\r
- Added SVG graphics for fo output.\r
-\r
- ● Robert Stayton: callout.icon.size.xml\r
-\r
- Set size of callout graphics.\r
-\r
- ● Jirka Kosek: default.units.xml; chunker.output.method.xml;\r
- toc.list.type.xml; output.inden⋯\r
-\r
- Updated parameter metadata to the new format.\r
-\r
- ● Jirka Kosek: man.output.quietly.xml; title.font.family.xml;\r
- footnote.sep.leader.properties⋯\r
-\r
- Added type annotations into parameter definition files.\r
-\r
- ● Robert Stayton: section.container.element.xml\r
-\r
- Support spans in sections for certain processors.\r
-\r
- ● Robert Stayton: component.titlepage.properties.xml\r
-\r
- Empty attribute set for top level component titlepage block.\r
- Allows setting a span on title info.\r
-\r
- ● Jirka Kosek: bibliography.style.xml\r
-\r
- Added link to WiKi page with description of special markup needed for ISO690 biblioentries\r
-\r
- ● Robert Stayton: make.year.ranges.xml\r
-\r
- Clarify that multiple year elements are required.\r
-\r
- ● Robert Stayton: id.warnings.xml\r
-\r
- Turn off id.warnings by default.\r
-\r
- ● Jirka Kosek: bibliography.style.xml\r
-\r
- Added support for formatting biblioentries according to ISO690 citation style.\r
- New bibliography style can be turned on by setting parameter bibliography.style to "iso690"\r
- The code was provided by Jana Dvorakova\r
-\r
- ● Robert Stayton: header.table.properties.xml; footer.table.properties.xml\r
-\r
- Support adding table properties to header and footer tables.\r
-\r
-Highlighting\r
-\r
-The following changes have been made to the highlighting code since the 1.72.0\r
-release.\r
-\r
- ● Jirka Kosek: c-hl.xml; xslthl-config.xml\r
-\r
- Added support for C language. Provided by Bruno Guegan.\r
-\r
-Profiling\r
-\r
-The following changes have been made to the profiling code since the 1.72.0\r
-release.\r
-\r
- ● Robert Stayton: profile-mode.xsl\r
-\r
- Add support for new profiling attributes audience and wordsize.\r
-\r
-Lib\r
-\r
-The following changes have been made to the lib code since the 1.72.0 release.\r
-\r
- ● Michael(tm) Smith: lib.xweb\r
-\r
- Changed name of prepend-pad template to pad-string and twheeked so\r
- it can do both right/left padding.\r
-\r
-Tools\r
-\r
-The following changes have been made to the tools code since the 1.72.0\r
-release.\r
-\r
- ● Michael(tm) Smith: bin; bin/docbook-xsl-update\r
-\r
- Did some cleanup to the install.sh source and added a\r
- docbook-xsl-update script to the docbook-xsl distro, the purpose\r
- of which is to facilitate easy sync-up to the latest docbook-xsl\r
- snapshot (by means of rsync).\r
-\r
-XSL-Saxon\r
-\r
-The following changes have been made to the xsl-saxon code since the 1.72.0\r
-release.\r
-\r
- ● Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/\r
- com/nwalsh/xalan/⋯\r
-\r
- Added modifications so that the new callout.icon.size parameter is taken into account. This\r
- parameter is used for FO output (where SVG now is the default graphics format for callouts).\r
-\r
- ● Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/\r
- src/com/nwalsh/x⋯\r
-\r
- Added code for generating id attributes on callouts in HTML and FO output.\r
- These patches enable cross-references to callouts placed by area coordinates.\r
- It works for graphic, unicode and text callouts.\r
- Part of fix for bug #1675513 (xref to area broken).\r
-\r
- ● Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/\r
- com/nwalsh/xalan⋯\r
-\r
- Copied over Website XSL Java extensions.\r
-\r
-XSL-Xalan\r
-\r
-The following changes have been made to the xsl-xalan code since the 1.72.0\r
-release.\r
-\r
- ● Michael(tm) Smith: Makefile; xalan2\r
-\r
- Turned off xalan2.jar build. This removes DocBook XSL\r
- Java extensions support for versions of Xalan prior to\r
- Xalan 2.7. If you are currently using the extensions\r
- with an earlier version of Xalan, you need to upgrade\r
- to Xalan 2.7.\r
-\r
- ● Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/\r
- com/nwalsh/xalan/⋯\r
-\r
- Added modifications so that the new callout.icon.size parameter is taken into account. This\r
- parameter is used for FO output (where SVG now is the default graphics format for callouts).\r
-\r
- ● Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/\r
- src/com/nwalsh/x⋯\r
-\r
- Added code for generating id attributes on callouts in HTML and FO output.\r
- These patches enable cross-references to callouts placed by area coordinates.\r
- It works for graphic, unicode and text callouts.\r
- Part of fix for bug #1675513 (xref to area broken).\r
-\r
- ● Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/\r
- com/nwalsh/xalan⋯\r
-\r
- Copied over Website XSL Java extensions.\r
-\r
-Release: 1.72.0\r
-\r
-This release includes important bug fixes and adds the following significant\r
-feature changes:\r
-\r
-Automatic sorting of glossary entries\r
-\r
- The HTML and FO stylesheets now support automatic sorting of glossary\r
- entries. To enable glossary sorting, set the value of the glossary.sort \r
- parameter to 1 (by default, it’s value is 0). When you enable glossary\r
- sorting, glossentry elements within a glossary, glossdiv, or glosslist are\r
- sorted on the glossterm, using the current language setting. If you don’t\r
- enable glossary sorting, then the order of glossentry elements is left “as\r
- is” — that is, they are not sorted but are instead just displayed in\r
- document order.\r
-\r
-WordML renamed to Roundtrip, OpenOffice support added\r
-\r
- Stylesheets for “roundtrip” conversion between documents in OpenOffice\r
- format (ODF) and DocBook XML have been added to the set of stylesheets that\r
- formerly had the collective title WordML, and that set of stylesheets has\r
- been renamed to Roundtrip to better reflect the actual scope and purpose of\r
- its contents.\r
-\r
- So the DocBook XSL Stylesheets now support roundtrip conversion (with\r
- certain limitations) of WordML, OpenOffice, and Apple Pages documents to\r
- and from DocBook XML.\r
-\r
-Including QandASet questions in TOCs\r
-\r
- The HTML stylesheet now provides support for including QandASet questions\r
- in the document TOC. To enable display of questions in the document TOC,\r
- set the value of the qanda.in.toc to 1 (by default, it’s 0). When you\r
- enable qanda.in.toc, then the generated table of contents for a document\r
- will include qandaset titles, qandadiv titles, and question elements. The\r
- default value of zero excludes them from the TOC.\r
-\r
- Note\r
-\r
- The qanda.in.toc parameter does not affect any tables of contents that may\r
- be generated within a qandaset or qandadiv (only in the document TOC).\r
-\r
-Language identifier in man-page filenames and pathnames\r
-\r
- Added new parameter man.output.lang.in.name.enabled, which controls whether\r
- a language identifier is included in man-page filenames and pathnames. It\r
- works like this:\r
-\r
- If the value of man.output.lang.in.name.enabled is non-zero, man-page files\r
- are output with a language identifier included in their filenames or\r
- pathnames as follows:\r
-\r
- ● if man.output.subdirs.enabled is non-zero, each file is output to,\r
- e.g., a /$lang/man8/foo.8 pathname\r
-\r
- ● if man.output.subdirs.enabled is zero, each file is output with a\r
- foo.$lang.8 filename\r
-\r
-index.page.number.properties property set\r
-\r
- For FO output, use the index.page.number.properties to control formatting\r
- of page numbers in index output — to (for example) to display page numbers\r
- in index output in a different color (to indicate that they are links).\r
-\r
-Crop marks in output from Antenna House XSL Formatter\r
-\r
- Support has been added for generating crop marks in print/PDF output\r
- generated using Antenna House XSL Formatter\r
-\r
-More string-substitution hooks in manpages output\r
-\r
- The man.string.subst.map.local.pre and man.string.subst.map.local.post\r
- parameters have been added to enable easier control over custom string\r
- substitutions.\r
-\r
-Moved verbatim properties to attribute-set\r
-\r
- The hardcoded properties used in verbatim elements (literallayout,\r
- programlisting, screen) were moved to the verbatim.properties attribute-set\r
- so they can be more easily customized.\r
-\r
-enhanced simple.xlink template\r
-\r
- Now the simple.xlink template in inline.xsl works with cross reference\r
- elements xref and link as well. Also, more elements call simple.xlink,\r
- which enables DB5 xlink functionality.\r
-\r
-DocBook 5 compatibility\r
-\r
- Stylesheets now consistently support DocBook 5 attributes (such as xml:id).\r
- Also, DocBook 5 info elements are now checked along with other *info\r
- elements, and the use of name() function was replaced by local-name() so it\r
- also matches on DocBook 5 elements. These changes enable reusing the\r
- stylesheets with DocBook 5 documents with minimal fixup.\r
-\r
-HTML class attributes now handled in class.attribute mode\r
-\r
- The HTML class attributes were formerly hardcoded to the element name. Now\r
- the class attribute is generated by applying templates in class.attribute\r
- mode so class attribute names can be customized. The default is still the\r
- element name.\r
-\r
-arabic-indic numbering enabled in autolabels\r
-\r
- Numbering of chapter, sections, and pages can now use arabic-indic\r
- numbering when number format is set to 'arabicindic' or to ١.\r
-\r
-The following is a detailed list of changes (not including bug fixes) that have\r
-been made since the 1.71.1 release.\r
-\r
-Common\r
-\r
-The following changes have been made to the common code since the 1.71.1\r
-release.\r
-\r
- ● Add support for arabicindic numbering to autolabel.format template.\r
-\r
- ● Finish support for @xml:id everywhere @id is used.\r
-\r
- ● replace name() with local-name() in most cases.\r
-\r
- ● Add support for info.\r
-\r
- ● Add utility template tabstyle to return the tabstyle from\r
- any table element.\r
-\r
-FO\r
-\r
-The following changes have been made to the fo code since the 1.71.1 release.\r
-\r
- ● Add support for sorting glossary entries\r
-\r
- ● Add table.row.properties template to customize table rows.\r
-\r
- ● Moved all properties to attribute-sets so can be customized more easily.\r
-\r
- ● Add index.page.number.properties attribute-set to format page numbers.\r
-\r
- ● xref now supports xlink:href, using simple.xlink template.\r
-\r
- ● Rewrote simple.xlink, and call it with all charseq templates.\r
-\r
- ● Add simple.xlink processing to term and member elements.\r
-\r
- ● Add support for crop marks in Antenna House.\r
-\r
-HTML\r
-\r
-The following changes have been made to the html code since the 1.71.1 release.\r
-\r
- ● Add support for sorting glossary entries\r
-\r
- ● Add support for qanda.in.toc to add qandaentry questions to document TOC.\r
-\r
- ● add simple.xlink support to variablelist term and simplelist member.\r
-\r
- ● *.propagates.style now handled in class.attribute mode.\r
-\r
- ● add class parameter to class.attribute mode to set default class.\r
-\r
- ● Convert all class attributes to use the class.attribute mode\r
- so class names can be customized more easily.\r
-\r
- ● Add class.attribute mode to generate class attributes.\r
-\r
- ● Added simple.xlink to most remaining inlines.\r
- Changed class attributes to applying class.attributes mode.\r
-\r
- ● Changed xref template to use simple.xlink tempalte.\r
-\r
- ● Improve generate.html.title to work with link targets too.\r
-\r
- ● Improved simple.xlink to support link and xref.\r
-\r
- ● Use new link.title.attribute now.\r
-\r
- ● Rewrote simple.xlink to handle linkend also.\r
- Better computation of title attribute on link too.\r
-\r
- ● Handle Xalan quirk as special case.\r
-\r
- ● Add support for info.\r
-\r
- ● Fixed imagemaps so they work properly going from calspair coords\r
- to HTML area coords.\r
-\r
-Manpages\r
-\r
-The following changes have been made to the manpages code since the 1.71.1\r
-release.\r
-\r
- ● Added doc for man.output.lang.in.name.enabled parameter. This\r
- checkin completes support for writing file/pathnames for man-pages\r
- with $lang include in the names. Closes #1585967. knightly\r
- accolades to Daniel Leidert for providing the feature request.\r
-\r
- ● Added new param man.output.lang.in.name.enabled, which\r
- controls whether $LANG value is included in manpages\r
- filenames and pathnames. It works like this:\r
-\r
- If the value of man.output.lang.in.name.enabled is non-zero,\r
- man-page files are output with the $lang value included in\r
- their filenames or pathnames as follows;\r
-\r
- - if man.output.subdirs.enabled is non-zero, each file is\r
- output to, e.g., a /$lang/man8/foo.8 pathname\r
-\r
- - if man.output.subdirs.enabled is zero, each file is output\r
- with a foo.$lang.8 filename\r
-\r
- ● Use "\e" instead of "\\" for backslash output, because the\r
- groff docs say that's the correct thing to do; also because\r
- testing (thanks, Paul Dubois) shows that "\\" doesn't always\r
- work as expected; for example, "\\" within a table seems to\r
- mess things up.\r
-\r
- ● Added the man.string.subst.map.local.pre and\r
- man.string.subst.map.local.post parameters. Those parameters\r
- enable local additions and changes to string-substitution mappings\r
- without the need to change the value of man.string.subst.map\r
- parameter (which is for standard system mappings). Closes\r
- #1456738. Thanks to Sam Steingold for constructing a true\r
- stylesheet torture test (the clisp docs) that exposed the need for\r
- these params.\r
-\r
- ● Added the Markup element to the list of elements that get output\r
- in bold. Thanks to Eric S. Raymond.\r
-\r
- ● Replaced all dots in roff requests with U+2302 ("house"\r
- character), and added escaping in output for all instances of dot\r
- that are not in roff requests. This fixes the problem case where a\r
- string beginning with a dot (for example, the string ".bashrc")\r
- might occur at the beginning of a line in output, in which case \r
- would mistakenly get interpreted as a roff request. Thanks to Eric\r
- S. Raymond for pushing to fix this.\r
-\r
- ● Made change to ensure that list content nested in\r
- itemizedlist and orderedlist instances is properly indented. This\r
- is a switch from using .TP to format those lists to using .RS/.RE\r
- to format them instead (because .TP does not allow nesting). Closes bug #\r
- 1602616.\r
- Thanks to Daniel Leidert.\r
-\r
-Params\r
-\r
-The following changes have been made to the params code since the 1.71.1\r
-release.\r
-\r
- ● Added doc for man.output.lang.in.name.enabled parameter. This\r
- checkin completes support for writing file/pathnames for man-pages\r
- with $lang include in the names. Closes #1585967. knightly\r
- accolades to Daniel Leidert for providing the feature request.\r
-\r
- ● Added new param man.output.lang.in.name.enabled, which\r
- controls whether $LANG value is included in manpages\r
- filenames and pathnames. It works like this:\r
-\r
- If the value of man.output.lang.in.name.enabled is non-zero,\r
- man-page files are output with the $lang value included in\r
- their filenames or pathnames as follows;\r
-\r
- - if man.output.subdirs.enabled is non-zero, each file is\r
- output to, e.g., a /$lang/man8/foo.8 pathname\r
-\r
- - if man.output.subdirs.enabled is zero, each file is output\r
- with a foo.$lang.8 filename\r
-\r
- ● Added the man.string.subst.map.local.pre and\r
- man.string.subst.map.local.post parameters. Those parameters\r
- enable local additions and changes to string-substitution mappings\r
- without the need to change the value of man.string.subst.map\r
- parameter (which is for standard system mappings). Closes\r
- #1456738. Thanks to Sam Steingold for constructing a true\r
- stylesheet torture test (the clisp docs) that exposed the need for\r
- these params.\r
-\r
- ● Add index.page.number.properties by default.\r
-\r
- ● Added index.page.number.properties\r
- to allow customizations of page numbers in indexes.\r
-\r
- ● Move show-destination="replace" property from template to attribute-set\r
- so it can be customized.\r
-\r
- ● Add support for sorting glossary entries\r
-\r
- ● Add option to include qanda in tables of contents.\r
-\r
- ● Moved all properties to attribute-sets so can be customized more easily.\r
-\r
-Template\r
-\r
-The following changes have been made to the template code since the 1.71.1\r
-release.\r
-\r
- ● Added workaround for Xalan bug: use for-each and copy instead of copy-of (#\r
- 1604770).\r
-\r
-Roundtrip\r
-\r
-The following changes have been made to the roundtrip code since the 1.71.1\r
-release.\r
-\r
- ● rename to roundtrip, add OpenOffice support\r
-\r
-Release: 1.71.1\r
-\r
-This is a minor update to the 1.71.0 release. Along with a number of bug fixes,\r
-it includes two feature changes:\r
-\r
- ● Added support for profiling based on xml:lang and status attributes.\r
-\r
- ● Added initial support in manpages output for footnote, annotation, and alt\r
- instances. Basically, they all now get handled the same way ulink instances\r
- are. They are treated as a class as "note sources": A numbered marker is\r
- generated at the place in the main text flow where they occur, then their\r
- contents are displayed in an endnotes section at the end of the man page.\r
-\r
-Common\r
-\r
-The following changes have been made to the common code since the 1.71.1\r
-release.\r
-\r
- ● For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.\r
-\r
- ● Add support for Xalan generating a root xml:base like saxon.\r
-\r
-FO\r
-\r
-The following changes have been made to the fo code since the 1.71.1 release.\r
-\r
- ● For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.\r
-\r
- ● Add support for Xalan to add root node xml:base for db5 docs.\r
-\r
- ● Added support for profiling based on xml:lang and status attributes.\r
-\r
-HTML\r
-\r
-The following changes have been made to the html code since the 1.71.1 release.\r
-\r
- ● For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.\r
-\r
- ● Add support for Xalan to add root node xml:base for db5 docs.\r
-\r
- ● Added support for profiling based on xml:lang and status attributes.\r
-\r
- ● Made changes in namespace declarations to prevent xmllint's\r
- canonicalizer from treating them as relative namespace URIs.\r
-\r
- - Changed xmlns:k="java:com.isogen.saxoni18n.Saxoni18nService"\r
- to xmlns:k="http://www.isogen.com/functions/\r
- com.isogen.saxoni18n.Saxoni18nService";\r
- Saxon accepts either form\r
- (see http://www.saxonica.com/documentation/extensibility/\r
- functions.html);\r
- to Saxon, "the part of the URI before the final '/' is immaterial".\r
-\r
- - Changed, e.g. xmlns:xverb="com.nwalsh.xalan.Verbatim" to\r
- xmlns:xverb="xalan://com.nwalsh.xalan.Verbatim"; Xalan accepts\r
- either form\r
- (see http://xml.apache.org/xalan-j/extensions.html#\r
- java-namespace-declare);\r
- just as Saxon does, it will "simply use the string to the\r
- right of the rightmost forward slash as the Java class name".\r
-\r
- - Changed xmlns:xalanredirect="org.apache.xalan.xslt.extensions.Redirect"\r
- to xmlns:redirect="http://xml.apache.org/xalan/redirect", and\r
- adjusted associated code to make the current Xalan redirect spec.\r
- (see http://xml.apache.org/xalan-j/apidocs/org/apache/xalan/lib/\r
- Redirect.html)\r
-\r
- ● Added the html.append and chunk.append parameters. By default, the\r
- value of both is empty; but the internal DocBook XSL stylesheets\r
- build sets their value to "<xsl:text>
</xsl:text>", in order\r
- to ensure that all files in the docbook-xsl-doc package end in a\r
- newline character. (Because diff and some other tools may emit\r
- error messages and/or not behave as expected when processing\r
- files that are not newline-terminated.)\r
-\r
-Highlighting\r
-\r
-The following changes have been made to the highlighting code since the 1.71.1\r
-release.\r
-\r
- ● Added license information\r
-\r
-Manpages\r
-\r
-The following changes have been made to the manpages code since the 1.71.1\r
-release.\r
-\r
- ● Added initial support in manpages output for footnote, annotation,\r
- and alt instances. Basically, they all now get handled the same\r
- way ulink instances are. They are treated as a class as "note\r
- sources": A numbered marker is generated at the place in the main\r
- text flow where they occur, then their contents are displayed in\r
- an endnotes section at the end of the man page (currently titled\r
- REFERENCES, for English output, but will be changed to NOTES).\r
-\r
- This support is not yet complete. It works for most "normal"\r
- cases, but probably mishandles a good number of cases. More\r
- testing will be needed to expose the problems. It may well also\r
- introduce some bugs and regressions in other areas, including\r
- basic paragraph handling, handling of "mixed block" content,\r
- handling of other indented content, and handling of authorblurb\r
- and personblurb in the AUTHORS section.\r
-\r
-Params\r
-\r
-The following changes have been made to the params code since the 1.71.1\r
-release.\r
-\r
- ● Added support for profiling based on xml:lang and status attributes.\r
-\r
- ● Added the html.append and chunk.append parameters. By default, the\r
- value of both is empty; but the internal DocBook XSL stylesheets\r
- build sets their value to "<xsl:text>
</xsl:text>", in order\r
- to ensure that all files in the docbook-xsl-doc package end in a\r
- newline character. (Because diff and some other tools may emit\r
- error messages and/or not behave as expected when processing\r
- files that are not newline-terminated.)\r
-\r
-Profiling\r
-\r
-The following changes have been made to the profiling code since the 1.71.1\r
-release.\r
-\r
- ● Added support for profiling based on xml:lang and status attributes.\r
-\r
-Release: 1.71.0\r
-\r
-This is mainly a bug fix release, but it also includes two significant feature\r
-changes:\r
-\r
-Highlighting support added\r
-\r
- The stylesheets now include support for source-code highlighting in output\r
- of programlisting instances (controlled through the highlight.source\r
- parameter). The Java-based implementation requires Saxon and makes use of\r
- Michal Molhanec’s XSLTHL. More details are available at Jirka Kosek’s\r
- website:\r
-\r
- http://xmlguru.cz/2006/07/docbook-syntax-highlighting\r
-\r
- The support is currently limited to highlighting of XML, Java, PHP, Delphi,\r
- Modula-2 sources, and INI files.\r
-\r
-Changes to autoindexing\r
-\r
- The templates that handle alternative indexing methods were reworked to\r
- avoid errors produced by certain processors not being able to tolerate the\r
- presence of unused functions. With this release, none of the code for the\r
- 'kimber' or 'kosek' methods is included in the default stylesheets. In\r
- order to use one of those methods, your customization layer must import one\r
- of the optional stylesheet modules:\r
-\r
- ● html/autoidx-kosek.xsl\r
- ● html/autoidx-kimber.xsl\r
- ● fo/autoidx-kosek.xsl\r
- ● fo/autoidx-kimber.xsl\r
-\r
- See the index.method parameter reference page for more information.\r
-\r
- Two other changes to note:\r
-\r
- ● The default indexing method now can handle accented characters in\r
- latin-based alphabets, not just English. This means accented latin\r
- letters will group and sort with their unaccented counterpart.\r
- ● The default value for the index.method parameter was changed from\r
- 'english' to 'basic' because now the default method can handle\r
- latin-based alphabets, not just English.\r
-\r
-The following is a list of changes that have been made since the 1.70.1\r
-release.\r
-\r
-Common\r
-\r
-The following changes have been made to the common code since the 1.70.1\r
-release.\r
-\r
- ● Added reference.autolabel parameter for controlling labels on\r
- reference output.\r
-\r
- ● Support rows that are *completely* overlapped by the preceding row\r
-\r
- ● New modules for supporting indexing extensions.\r
-\r
- ● Support startinglinenumber on orderedlist\r
-\r
-Extensions\r
-\r
-The following changes have been made to the extensions code since the 1.70.1\r
-release.\r
-\r
- ● Completely reworked extensions build system; now uses NetBeans and ant\r
-\r
-FO\r
-\r
-The following changes have been made to the fo code since the 1.70.1 release.\r
-\r
- ● xsl:sort lang attribute now uses two-char substring of lang attribute.\r
-\r
- ● Support titlecase "Java", "Perl", and "IDL" as values for the\r
- language attribute on classsynopsis, etc. (instead of just\r
- lowercase "java", "perl", and "idl"). Also support "c++" and "C++"\r
- (instead of just "cpp").\r
-\r
- Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks\r
- to "Brian A. Vanderburg II".\r
-\r
- ● Added support for the reference.autolabel param in (X)HTML and FO\r
- output.\r
-\r
- ● Support rows that are *completely* overlapped by the preceding row\r
-\r
- ● Rearranged templates for the 3 indexing methods\r
- and changed method named 'english' to 'basic'.\r
-\r
- ● New modules for supporting indexing extensions.\r
-\r
- ● Turn off blank-body for fop1.extensions too since fop 0.92\r
- does not support it either.\r
-\r
- ● Add Xalan variant to test for exslt:node-set function.\r
- Xalan can use function named node-set(), but doesn't\r
- recognize it using function-available().\r
-\r
- ● Added support to FO stylesheets for handling instances of Org\r
- where it occurs outside of *info content. In HTML stylesheets,\r
- moved handling of Org out of info.xsl and into inline.xsl. In both\r
- FO and HTML stylesheets, added support for correctly processing\r
- Affiliation and Jobtitle.\r
-\r
- ● Don't output punctuation between Refname and Refpurpose if\r
- Refpurpose is empty. Also corrected handling of Refsect2/title\r
- instances, and removed some debugging stuff that was generated in\r
- manpages output to mark the ends of sections.\r
-\r
- ● Added new email.delimiters.enabled param. If non-zero (the\r
- default), delimiters are generated around e-mail addresses (output\r
- of the email element). If zero, the delimiters are suppressed.\r
-\r
- ● Initial support of syntax highlighting of programlistings.\r
-\r
- ● Chapter after preface should restart numbering of pages.\r
-\r
-HTML\r
-\r
-The following changes have been made to the html code since the 1.70.1 release.\r
-\r
- ● xsl:sort lang attribute now uses two-char substring of lang attribute.\r
-\r
- ● Support titlecase "Java", "Perl", and "IDL" as values for the\r
- language attribute on classsynopsis, etc. (instead of just\r
- lowercase "java", "perl", and "idl"). Also support "c++" and "C++"\r
- (instead of just "cpp").\r
-\r
- Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks\r
- to "Brian A. Vanderburg II".\r
-\r
- ● Added support for the reference.autolabel param in (X)HTML and FO\r
- output.\r
-\r
- ● Support rows that are *completely* overlapped by the preceding row\r
-\r
- ● Rearranged templates for the 3 indexing methods\r
- and changed method named 'english' to 'basic'.\r
-\r
- ● New modules for supporting indexing extensions.\r
-\r
- ● Added several new HTML parameters for controlling appearance of\r
- content on HTML title pages:\r
-\r
- contrib.inline.enabled:\r
- If non-zero (the default), output of the contrib element is\r
- displayed as inline content rather than as block content.\r
-\r
- othercredit.like.author.enabled:\r
- If non-zero, output of the othercredit element on titlepages is\r
- displayed in the same style as author and editor output. If zero\r
- (the default), othercredit output is displayed using a style\r
- different than that of author and editor.\r
-\r
- blurb.on.titlepage.enabled:\r
- If non-zero, output from authorblurb and personblurb elements is\r
- displayed on title pages. If zero (the default), output from\r
- those elements is suppressed on title pages (unless you are\r
- using a titlepage customization that causes them to be included).\r
-\r
- editedby.enabled\r
- If non-zero (the default), a localized Edited by heading is\r
- displayed above editor names in output of the editor element.\r
-\r
- ● Add Xalan variant to test for exslt:node-set function.\r
- Xalan can use function named node-set(), but doesn't\r
- recognize it using function-available().\r
-\r
- ● Added support to FO stylesheets for handling instances of Org\r
- where it occurs outside of *info content. In HTML stylesheets,\r
- moved handling of Org out of info.xsl and into inline.xsl. In both\r
- FO and HTML stylesheets, added support for correctly processing\r
- Affiliation and Jobtitle.\r
-\r
- ● Don't output punctuation between Refname and Refpurpose if\r
- Refpurpose is empty. Also corrected handling of Refsect2/title\r
- instances, and removed some debugging stuff that was generated in\r
- manpages output to mark the ends of sections.\r
-\r
- ● Added new email.delimiters.enabled param. If non-zero (the\r
- default), delimiters are generated around e-mail addresses (output\r
- of the email element). If zero, the delimiters are suppressed.\r
-\r
- ● Added qanda.nested.in.toc param. Default value is zero. If\r
- non-zero, instances of "nested" Qandaentry (ones that are children\r
- of Answer elements) are displayed in the TOC. Closes patch 1509018\r
- (from Daniel Leidert). Currently on affects HTML output (no patch\r
- for FO output provided).\r
-\r
- ● Improved handling of relative locations generated files\r
-\r
- ● Initial support of syntax highlighting of programlistings.\r
-\r
- ● Support org\r
-\r
- ● Support person\r
-\r
- ● Support $keep.relative.image.uris also when chunking\r
-\r
-Highlighting\r
-\r
-The following changes have been made to the highlighting code since the 1.70.1\r
-release.\r
-\r
- ● Initial support of syntax highlighting of programlistings.\r
-\r
-Manpages\r
-\r
-The following changes have been made to the manpages code since the 1.70.1\r
-release.\r
-\r
- ● Suppress footnote markers and output warning that footnotes are\r
- not yet supported.\r
-\r
- ● Handle instances of address/otheraddr/ulink in author et al in the\r
- same way as email instances; that is, display them on the same\r
- linke as the author, editor, etc., name.\r
-\r
- ● Don't number or link-list any Ulink instance whose string value is\r
- identical to the value of its url attribute. Just display it inline.\r
-\r
- ● Don't output punctuation between Refname and Refpurpose if\r
- Refpurpose is empty. Also corrected handling of Refsect2/title\r
- instances, and removed some debugging stuff that was generated in\r
- manpages output to mark the ends of sections.\r
-\r
- ● Added new email.delimiters.enabled param. If non-zero (the\r
- default), delimiters are generated around e-mail addresses (output\r
- of the email element). If zero, the delimiters are suppressed.\r
-\r
- ● In manpages output, if the last/nearest *info element for\r
- particular Refentry has multiple Copyright and/or Legalnotice\r
- children, process them all (not just the first ones). Closes bug\r
- 1524576. Thanks to Sam Steingold for the report and to Daniel\r
- Leidert for providing a patch.\r
-\r
-Params\r
-\r
-The following changes have been made to the params code since the 1.70.1\r
-release.\r
-\r
- ● Added reference.autolabel parameter for controlling labels on\r
- reference output.\r
-\r
- ● Added namespace declarations to document elements for all param files.\r
-\r
- ● Updated index.method doc to describe revised setup for importing index\r
- extensions.\r
-\r
- ● Added several new HTML parameters for controlling appearance of\r
- content on HTML title pages:\r
-\r
- contrib.inline.enabled:\r
- If non-zero (the default), output of the contrib element is\r
- displayed as inline content rather than as block content.\r
-\r
- othercredit.like.author.enabled:\r
- If non-zero, output of the othercredit element on titlepages is\r
- displayed in the same style as author and editor output. If zero\r
- (the default), othercredit output is displayed using a style\r
- different than that of author and editor.\r
-\r
- blurb.on.titlepage.enabled:\r
- If non-zero, output from authorblurb and personblurb elements is\r
- displayed on title pages. If zero (the default), output from\r
- those elements is suppressed on title pages (unless you are\r
- using a titlepage customization that causes them to be included).\r
-\r
- editedby.enabled\r
- If non-zero (the default), a localized Edited by heading is\r
- displayed above editor names in output of the editor element.\r
-\r
- ● Added new email.delimiters.enabled param. If non-zero (the\r
- default), delimiters are generated around e-mail addresses (output\r
- of the email element). If zero, the delimiters are suppressed.\r
-\r
- ● Added qanda.nested.in.toc param. Default value is zero. If\r
- non-zero, instances of "nested" Qandaentry (ones that are children\r
- of Answer elements) are displayed in the TOC. Closes patch 1509018\r
- (from Daniel Leidert). Currently on affects HTML output (no patch\r
- for FO output provided).\r
-\r
- ● Initial support of syntax highlighting of programlistings.\r
-\r
-Tools\r
-\r
-The following changes have been made to the tools code since the 1.70.1\r
-release.\r
-\r
- ● Racheted down font sizes of headings in example makefile FO output.\r
-\r
- ● Added param and attribute set to example makefile, for getting\r
- wrapping in verbatims in FO output.\r
-\r
- ● Renamed Makefile.paramDoc to Makefile.docParam.\r
-\r
- ● Added Makefile.paramDoc file, for creating versions of param.xsl\r
- files with doc embedded.\r
-\r
- ● Added variable to example makefile for controlling whether HTML or\r
- XHTML is generated.\r
-\r
-Release: 1.70.1\r
-\r
-This is a stable release of the 1.70 stylesheets. It includes only a few small\r
-changes from 1.70.0.\r
-\r
-The following is a list of changes that have been made since the 1.70.0\r
-release.\r
-\r
-FO\r
-\r
-The following changes have been made to the fo code since the 1.70.0 release.\r
-\r
- ● Added three new attribute sets (revhistory.title.properties,\r
- revhistory.table.properties and revhistory.table.cell.properties) for\r
- controlling appearance of revhistory in FO output.\r
-\r
- Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/\r
- titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params\r
- /revhistory.table.properties.xml,1.1; params/\r
- revhistory.title.properties.xml,1.1 - Jirka Kosek\r
-\r
- ● Support DBv5 revisions with full author name (not only authorinitials)\r
-\r
- Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek\r
-\r
-HTML\r
-\r
-The following changes have been made to the html code since the 1.70.0 release.\r
-\r
- ● Support DBv5 revisions with full author name (not only authorinitials)\r
-\r
- Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek\r
-\r
-HTMLHelp\r
-\r
-The following changes have been made to the htmlhelp code since the 1.70.0\r
-release.\r
-\r
- ● htmlhelp.generate.index is now param, not variable. This means that you can\r
- override its setting from outside. This is useful when you generate\r
- indexterms on the fly (see http://www.xml.com/pub/a/2004/07/14/dbndx.html?\r
- page=3).\r
-\r
- Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek\r
-\r
- ● Support chunk.tocs.and.lots in HTML Help\r
-\r
- Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek\r
-\r
-Params\r
-\r
-The following changes have been made to the params code since the 1.70.0\r
-release.\r
-\r
- ● Added three new attribute sets (revhistory.title.properties,\r
- revhistory.table.properties and revhistory.table.cell.properties) for\r
- controlling appearance of revhistory in FO output.\r
-\r
- Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/\r
- titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params\r
- /revhistory.table.properties.xml,1.1; params/\r
- revhistory.title.properties.xml,1.1 - Jirka Kosek\r
-\r
-Release: 1.70.0\r
-\r
-As with all DocBook Project dot-zero releases, this is an experimental release.\r
-It will be followed shortly by a stable release.\r
-\r
-This release adds a number of new features, including:\r
-\r
- ● support for selecting alternative index-collation methods (in particular,\r
- support for using a collation library developed by Eliot Kimber)\r
-\r
- ● improved handling of DocBook 5 document instances (through a\r
- namespace-stripping mechanism)\r
-\r
- ● full support for CALS and HTML tables in manpages output\r
-\r
- ● a mechanism for preserving relative URIs in documents that make use of\r
- XInclude\r
-\r
- ● support for the "new" .90 version of FOP\r
-\r
- ● enhanced capabilities for controlling formatting of lists in HTML and FO\r
- output\r
-\r
- ● autogeneration of AUTHOR and COPYRIGHT sections in manpages output\r
-\r
- ● support for generating crop marks in FO/PDF output\r
-\r
- ● support for qandaset as a root element in FO output\r
-\r
- ● support for floatstyle and orient on all table types\r
-\r
- ● support for floatstyle in figure, and example\r
-\r
- ● pgwide.properties attribute-set supports extending figure, example and\r
- table into the left indent area instead of spanning multiple columns.\r
-\r
-The following is a detailed list of enhancements and API changes that have been\r
-made since the 1.69.1 release.\r
-\r
-Common\r
-\r
-The following changes have been made to the common code since the 1.69.1\r
-release.\r
-\r
- ● Add the xsl:key for the kimber indexing method.\r
-\r
- Modified: common/autoidx-ng.xsl,1.2 - Robert Stayton\r
-\r
- ● Add support for qandaset.\r
-\r
- Modified: common/labels.xsl,1.37; common/subtitles.xsl,1.7; common/\r
- titles.xsl,1.35 - Robert Stayton\r
-\r
- ● Support dbhtml/dbfo start PI for orderedlist numbering in both HTML and FO\r
-\r
- Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman Walsh\r
-\r
- ● Added CVS header.\r
-\r
- Modified: common/stripns.xsl,1.12 - Robert Stayton\r
-\r
- ● Changed content model of text element to ANY rather than #PCDATA because\r
- they could contain markup.\r
-\r
- Modified: common/targetdatabase.dtd,1.7 - Robert Stayton\r
-\r
- ● Added refentry.meta.get.quietly param.\r
-\r
- If zero (the default), notes and warnings about "missing" markup are\r
- generated during gathering of refentry metadata. If non-zero, the metadata\r
- is gathered "quietly" -- that is, the notes and warnings are suppressed.\r
-\r
- NOTE: If you are processing a large amount of refentry content, you may be\r
- able to speed up processing significantly by setting a non-zero value for\r
- refentry.meta.get.quietly.\r
-\r
- Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/\r
- param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)\r
- Smith\r
-\r
- ● After namespace stripping, the source document is the temporary tree\r
- created by the stripping process and it has the wrong base URI for relative\r
- references. Earlier versions of this code used to try to fix that by\r
- patching the elements with relative @fileref attributes. That was\r
- inadequate because it calculated an absolute base URI without considering\r
- that there might be xml:base attributes already in effect. It seems obvious\r
- now that the right thing to do is simply to put the xml:base on the root of\r
- the document. And that seems to work.\r
-\r
- Modified: common/stripns.xsl,1.7 - Norman Walsh\r
-\r
- ● Added support for "software" and "sectdesc" class values on refmiscinfo;\r
- "software" is treated identically to "source", and "setdesc" is treated\r
- identically to "manual".\r
-\r
- Modified: common/refentry.xsl,1.10; params/\r
- man.th.extra2.max.length.xml,1.3; params/\r
- refentry.source.name.profile.xml,1.4 - Michael(tm) Smith\r
-\r
- ● Added support for DocBook 5 namespace-stripping in manpages stylesheet.\r
- Closes request #1210692.\r
-\r
- Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm)\r
- Smith\r
-\r
- ● Added <xsl:template match="/"> to make stripns.xsl usable as a standalone\r
- stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that DocBook\r
- XSLT drivers that include this stylesheet all override the match="/"\r
- template.\r
-\r
- Modified: common/stripns.xsl,1.4 - Michael(tm) Smith\r
-\r
- ● Number figures, examples, and tables from book if there is no prefix (i.e.\r
- if chapter.autolabel is set to 0). This avoids having the list of figures\r
- where the figures mysteriously restart their numeration periodically when\r
- chapter.autolabel is set to 0.\r
-\r
- Modified: common/labels.xsl,1.36 - David Cramer\r
-\r
- ● Add task template in title.markup mode.\r
-\r
- Modified: common/titles.xsl,1.34 - Robert Stayton\r
-\r
- ● Add children (with ids) of formal objects to target data.\r
-\r
- Modified: common/targets.xsl,1.10 - Robert Stayton\r
-\r
- ● Added support for case when personname doesn't contain specific name markup\r
- (as allowed in DocBook 5.0)\r
-\r
- Modified: common/common.xsl,1.54 - Jirka Kosek\r
-\r
-Extensions\r
-\r
-The following changes have been made to the extensions code since the 1.69.1\r
-release.\r
-\r
- ● Support Xalan 2.7\r
-\r
- Modified: extensions/xalan27/.cvsignore,1.1; extensions/xalan27/\r
- build.xml,1.1; extensions/xalan27/nbproject/.cvsignore,1.1; extensions/\r
- xalan27/nbproject/build-impl.xml,1.1; extensions/xalan27/nbproject/\r
- genfiles.properties,1.1; extensions/xalan27/nbproject/\r
- project.properties,1.1; extensions/xalan27/nbproject/project.xml,1.1;\r
- extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1; extensions/xalan27/\r
- src/com/nwalsh/xalan/Callout.java,1.1; extensions/xalan27/src/com/nwalsh/\r
- xalan/FormatCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/\r
- FormatDingbatCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/\r
- FormatGraphicCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/\r
- FormatTextCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/\r
- FormatUnicodeCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/\r
- Func.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/\r
- ImageIntrinsics.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/\r
- Params.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1;\r
- extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1; extensions/xalan27/\r
- src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman Walsh\r
-\r
- ● Handle the case where the imageFn is actually a URI. This still needs work.\r
-\r
- Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4 -\r
- Norman Walsh\r
-\r
-FO\r
-\r
-The following changes have been made to the fo code since the 1.69.1 release.\r
-\r
- ● Adapted to the new indexing code. Now works just like a wrapper that calls\r
- kosek indexing method, originally implemented here.\r
-\r
- Modified: fo/autoidx-ng.xsl,1.5 - Jirka Kosek\r
-\r
- ● Added parameters for header/footer table minimum height.\r
-\r
- Modified: fo/pagesetup.xsl,1.60; fo/param.ent,1.100; fo/param.xweb,1.113 -\r
- Robert Stayton\r
-\r
- ● Add the index.method parameter.\r
-\r
- Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert Stayton\r
-\r
- ● Integrate support for three indexing methods: - the original English-only\r
- method. - Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's\r
- method using Saxon extensions. Use the 'index.method' parameter to select.\r
-\r
- Modified: fo/autoidx.xsl,1.38 - Robert Stayton\r
-\r
- ● Add support for TOC for qandaset in fo output.\r
-\r
- Modified: fo/autotoc.xsl,1.30; fo/qandaset.xsl,1.20 - Robert Stayton\r
-\r
- ● Added parameter ulink.hyphenate.chars. Added parameter insert.link\r
- .page.number.\r
-\r
- Modified: fo/param.ent,1.98; fo/param.xweb,1.111 - Robert Stayton\r
-\r
- ● Implemented feature request #942524 to add insert.link.page.number to allow\r
- link element cross references to have a page number.\r
-\r
- Modified: fo/xref.xsl,1.67 - Robert Stayton\r
-\r
- ● Add support for ulink.hyphenate.chars so more characters can be break\r
- points in urls.\r
-\r
- Modified: fo/xref.xsl,1.66 - Robert Stayton\r
-\r
- ● Implemented patch #1075144 to make the url text in a ulink in FO output an\r
- active link as well.\r
-\r
- Modified: fo/xref.xsl,1.65 - Robert Stayton\r
-\r
- ● table footnotes now have their own table.footnote.properties attribute set.\r
-\r
- Modified: fo/footnote.xsl,1.23 - Robert Stayton\r
-\r
- ● Add qandaset to root.elements.\r
-\r
- Modified: fo/docbook.xsl,1.41 - Robert Stayton\r
-\r
- ● Added mode="page.sequence" to make it easier to put content into a page\r
- sequence. First used for qandaset.\r
-\r
- Modified: fo/component.xsl,1.37 - Robert Stayton\r
-\r
- ● Implemented feature request #1434408 to support formatting of biblioentry.\r
-\r
- Modified: fo/biblio.xsl,1.35 - Robert Stayton\r
-\r
- ● Added biblioentry.properties.\r
-\r
- Modified: fo/param.ent,1.97; fo/param.xweb,1.110 - Robert Stayton\r
-\r
- ● Support PTC/Arbortext bookmarks\r
-\r
- Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman Walsh\r
-\r
- ● Added table.footnote.properties to permit table footnotes to format\r
- differently from regular footnotes.\r
-\r
- Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert Stayton\r
-\r
- ● Refactored table templates to unify their processing and support all\r
- options in all types. Now table and informaltable, in both Cals and Html\r
- markup, use the same templates where possible, and all support pgwide,\r
- rotation, and floats. There is also a placeholder table.container template\r
- to support wrapping a table in a layout table, so the XEP table title\r
- "continued" extension can be more easily implemented.\r
-\r
- Modified: fo/formal.xsl,1.52; fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 -\r
- Robert Stayton\r
-\r
- ● Added new attribute set toc.line.properties for controlling appearance of\r
- lines in ToC/LoT\r
-\r
- Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95; fo/param.xweb,1.108 -\r
- Jirka Kosek\r
-\r
- ● Added support for float to example and equation. Added support for pgwide\r
- to figure, example, and equation (the latter two via a dbfo pgwide="1"\r
- processing instruction).\r
-\r
- Modified: fo/formal.xsl,1.51 - Robert Stayton\r
-\r
- ● Add pgwide.properties attribute-set.\r
-\r
- Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert Stayton\r
-\r
- ● Added refclass.suppress param.\r
-\r
- If the value of refclass.suppress is non-zero, then display refclass\r
- contents is suppressed in output. Affects HTML and FO output only.\r
-\r
- Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html\r
- /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Improved support for task subelements\r
-\r
- Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - Jirka Kosek\r
-\r
- ● Adjusted spacing around K&R-formatted Funcdef and Paramdef output such that\r
- it can more easily be discerned where one ends and the other begins. Closes\r
- #1213264.\r
-\r
- Modified: fo/synop.xsl,1.18 - Michael(tm) Smith\r
-\r
- ● Made handling of paramdef/parameter in FO output consistent with that in\r
- HTML and manpages output. Closes #1213259.\r
-\r
- Modified: fo/synop.xsl,1.17 - Michael(tm) Smith\r
-\r
- ● Made handling of Refnamediv consistent with formatting in HTML and manpages\r
- output; specifically, changed so that Refname (comma-separated list of\r
- multiple instances found) is used (instead of Refentrytitle as previously),\r
- then em-dash, then the Refpurpose. Closes #1212562.\r
-\r
- Modified: fo/refentry.xsl,1.30 - Michael(tm) Smith\r
-\r
- ● Added output of Releaseinfo to recto titlepage ("copyright" page) for Book\r
- in FO output. This makes it consistent with HTML output. Closes #1327034.\r
- Thanks to Paul DuBois for reporting.\r
-\r
- Modified: fo/titlepage.templates.xml,1.28 - Michael(tm) Smith\r
-\r
- ● Added condition for setting block-progression-dimension.minimum on\r
- table-row, instead of height, when fop1.extensions is non-zero. For an\r
- explanation of the reason for the change, see: http://wiki.apache.org/\r
- xmlgraphics-fop/Troubleshooting/CommonLogMessages\r
-\r
- Modified: fo/pagesetup.xsl,1.59 - Michael(tm) Smith\r
-\r
- ● Added new refclass.suppress param for suppressing display of Refclass in\r
- HTML and FO output. Did not add it to manpages because manpages stylesheet\r
- is currently just silently ignoring Refclass anyway. Closes request #\r
- 1461065. Thanks to Davor Ocelic (docelic) for reporting.\r
-\r
- Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - Michael(tm) Smith\r
-\r
- ● Add support for keep-together PI to informal objects.\r
-\r
- Modified: fo/formal.xsl,1.50 - Robert Stayton\r
-\r
- ● Add support for fop1.extensions.\r
-\r
- Modified: fo/formal.xsl,1.49; fo/graphics.xsl,1.44; fo/table.xsl,1.47 -\r
- Robert Stayton\r
-\r
- ● Add support for fop1 bookmarks.\r
-\r
- Modified: fo/docbook.xsl,1.39 - Robert Stayton\r
-\r
- ● Add fop1.extentions parameter to add support for fop development version.\r
-\r
- Modified: fo/param.ent,1.92; fo/param.xweb,1.105 - Robert Stayton\r
-\r
- ● Start supporting fop development version, which will become fop version 1.\r
-\r
- Modified: fo/fop1.xsl,1.1 - Robert Stayton\r
-\r
- ● Add template for task in mode="xref-to".\r
-\r
- Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert Stayton\r
-\r
- ● table footnotes now also get footnote.properties attribute-set.\r
-\r
- Modified: fo/footnote.xsl,1.22 - Robert Stayton\r
-\r
- ● Added index.separator named template to compute the separator punctuation\r
- based on locale.\r
-\r
- Modified: fo/autoidx.xsl,1.36 - Robert Stayton\r
-\r
- ● Added support for link, olink, and xref within OO Classsynopsis and\r
- children. (Because DocBook NG/5 allows it).\r
-\r
- Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith\r
-\r
- ● Support date as an inline\r
-\r
- Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh\r
-\r
- ● Added new parameter keep.relative.image.uris\r
-\r
- Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html\r
- /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh\r
-\r
- ● Map Unicode space characters U+2000-U+200A to fo:leaders.\r
-\r
- Modified: fo/docbook.xsl,1.38; fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 -\r
- Jirka Kosek\r
-\r
- ● Output a real em dash for em-dash dingbat (instead of two hypens).\r
-\r
- Modified: fo/fo.xsl,1.7 - Michael(tm) Smith\r
-\r
- ● Support default label width parameters for itemized and ordered lists\r
-\r
- Modified: fo/lists.xsl,1.64; fo/param.ent,1.90; fo/param.xweb,1.103; params\r
- /itemizedlist.label.width.xml,1.1; params/orderedlist.label.width.xml,1.1 -\r
- Norman Walsh\r
-\r
- ● Generate localized title for Refsynopsisdiv if no appropriate Title\r
- descendant found in source. Closes #1212398. This change makes behavior for\r
- the Synopsis title consistent with the behavior of HTML and manpages\r
- output.\r
-\r
- Also, added xsl:use-attribute-sets="normal.para.spacing" to block generated\r
- for Cmdsynopsis output. Previously, that block had no spacing at all\r
- specified, which resulted it being crammed up to closely to the Synopsis\r
- head.\r
-\r
- Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm) Smith\r
-\r
- ● Added parameters to support localization of index item punctuation.\r
-\r
- Modified: fo/autoidx.xsl,1.35 - Robert Stayton\r
-\r
- ● Added index.number.separator, index.range.separator, and\r
- index.term.separator parameters to support localization of punctuation in\r
- index entries.\r
-\r
- Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert Stayton\r
-\r
- ● Added "Cross References" section in HTML doc (for consistency with the FO\r
- doc). Also, moved the existing FO "Cross References" section to follow the\r
- "Linking" section.\r
-\r
- Modified: fo/param.xweb,1.101; html/param.xweb,1.95 - Michael(tm) Smith\r
-\r
- ● Added ID attribues to all Reference elements (e.g., id="tables" for the doc\r
- for section on Table params). So pages for all subsections of ref docs now\r
- have stable filenames instead of arbitrary generated filenames.\r
-\r
- Modified: fo/param.xweb,1.100; html/param.xweb,1.94 - Michael(tm) Smith\r
-\r
- ● Added two new parameters for handling of multi-term varlistentry elements:\r
-\r
- variablelist.term.break.after: When the variablelist.term.break.after is\r
- non-zero, it will generate a line break after each term multi-term\r
- varlistentry.\r
-\r
- variablelist.term.separator: When a varlistentry contains multiple term\r
- elements, the string specified in the value of the\r
- variablelist.term.separator parameter is placed after each term except the\r
- last. The default is ", " (a comma followed by a space). To suppress\r
- rendering of the separator, set the value of variablelist.term.separator to\r
- the empty string ("").\r
-\r
- These parameters are primarily intended to be useful if you have multi-term\r
- varlistentries that have long terms.\r
-\r
- Closes #1306676. Thanks to Sam Steingold for providing an example "lots of\r
- long terms" doc that demonstrated the value of having these options.\r
-\r
- Also, added normalize-space() call to processing of each term.\r
-\r
- This change affects all output formats (HTML, PDF, manpages). The default\r
- behavior should pretty much remain the same as before, but it is possible\r
- (as always) that the change may introduce some new bugginess.\r
-\r
- Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/\r
- lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/\r
- lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/\r
- variablelist.term.break.after.xml,1.1; params/\r
- variablelist.term.separator.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Add sidebar titlepage placeholder attset for styles.\r
-\r
- Modified: fo/titlepage.xsl,1.37 - Robert Stayton\r
-\r
- ● Add titlepage for sidebar.\r
-\r
- Modified: fo/titlepage.templates.xml,1.27 - Robert Stayton\r
-\r
- ● Implemented RFE #1292615.\r
-\r
- Added bunch of new parameters (attribute sets) that affect list\r
- presentation: list.block.properties, itemizedlist.properties, orderedlist\r
- .properties, itemizedlist.label.properties and orderedlist.label\r
- .properties. Default behaviour of stylesheets has not been changed but\r
- further customizations will be much more easier.\r
-\r
- Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; params/\r
- itemizedlist.label.properties.xml,1.1; params/\r
- itemizedlist.properties.xml,1.1; params/list.block.properties.xml,1.1;\r
- params/orderedlist.label.properties.xml,1.1; params/\r
- orderedlist.properties.xml,1.1 - Jirka Kosek\r
-\r
- ● Implemented RFE #1242092.\r
-\r
- You can enable crop marks in your document by setting crop.marks=1 and\r
- xep.extensions=1. Appearance of crop marks can be controlled by parameters\r
- crop.mark.bleed (6pt), crop.mark.offset (24pt) and crop.mark.width (0.5pt).\r
-\r
- Also there is new named template called user-xep-pis. You can overwrite it\r
- in order to produce some PIs that can control XEP as described in http://\r
- www.renderx.com/reference.html#Output_Formats\r
-\r
- Modified: fo/docbook.xsl,1.36; fo/param.ent,1.86; fo/param.xweb,1.97; fo/\r
- xep.xsl,1.23; params/crop.mark.bleed.xml,1.1; params/\r
- crop.mark.offset.xml,1.1; params/crop.mark.width.xml,1.1; params/\r
- crop.marks.xml,1.1 - Jirka Kosek\r
-\r
-HTML\r
-\r
-The following changes have been made to the html code since the 1.69.1 release.\r
-\r
- ● implemented index.method parameter and three methods.\r
-\r
- Modified: html/autoidx.xsl,1.28 - Robert Stayton\r
-\r
- ● added index.method parameter to support 3 indexing methods.\r
-\r
- Modified: html/param.ent,1.94; html/param.xweb,1.103 - Robert Stayton\r
-\r
- ● Implemented feature request #1072510 as a processing instruction to permit\r
- including external HTML content into HTML output.\r
-\r
- Modified: html/pi.xsl,1.9 - Robert Stayton\r
-\r
- ● Added new parameter chunk.tocs.and.lots.has.title which controls presence\r
- of title in a separate chunk with ToC/LoT. Disabling title can be very\r
- useful if you are generating frameset output (well, yes those frames, but\r
- some customers really want them ;-).\r
-\r
- Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; html/\r
- param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka\r
- Kosek\r
-\r
- ● Support dbhtml/dbfo start PI for orderedlist numbering in both HTML and FO\r
-\r
- Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman Walsh\r
-\r
- ● Allow ToC without title also for set and book.\r
-\r
- Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 - Jirka Kosek\r
-\r
- ● Implemented floats uniformly for figure, example, equation and\r
- informalfigure, informalexample, and informalequation.\r
-\r
- Modified: html/formal.xsl,1.22 - Robert Stayton\r
-\r
- ● Added the autotoc.label.in.hyperlink param.\r
-\r
- If the value of autotoc.label.in.hyperlink is non-zero, labels are included\r
- in hyperlinked titles in the TOC. If it is instead zero, labels are still\r
- displayed prior to the hyperlinked titles, but are not hyperlinked along\r
- with the titles.\r
-\r
- Closes patch #1065868. Thanks to anatoly techtonik for the patch.\r
-\r
- Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; html/\r
- param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - Michael(tm)\r
- Smith\r
-\r
- ● Added two new params: html.head.legalnotice.link.types and html.head.\r
- legalnotice.link.multiple.\r
-\r
- If the value of the generate.legalnotice.link is non-zero, then the\r
- stylesheet generates (in the head section of the HTML source) either a\r
- single HTML link element or, if the value of the html.head.legalnotice.link\r
- .multiple is non-zero, one link element for each link type specified. Each\r
- link has the following attributes:\r
-\r
- - a rel attribute whose value is derived from the value of html.head.\r
- legalnotice.link.types\r
-\r
- - an href attribute whose value is set to the URL of the file containing\r
- the legalnotice\r
-\r
- - a title attribute whose value is set to the title of the corresponding\r
- legalnotice (or a title programatically determined by the stylesheet)\r
-\r
- For example:\r
-\r
- <link rel="copyright" href="ln-id2524073.html" title="Legal Notice">\r
-\r
- Closes #1476450. Thanks to Sam Steingold.\r
-\r
- Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; html/\r
- param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; params/\r
- html.head.legalnotice.link.multiple.xml,1.1; params/\r
- html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added refclass.suppress param.\r
-\r
- If the value of refclass.suppress is non-zero, then display refclass\r
- contents is suppressed in output. Affects HTML and FO output only.\r
-\r
- Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html\r
- /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Improved support for task subelements\r
-\r
- Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - Jirka Kosek\r
-\r
- ● Added new refclass.suppress param for suppressing display of Refclass in\r
- HTML and FO output. Did not add it to manpages because manpages stylesheet\r
- is currently just silently ignoring Refclass anyway. Closes request #\r
- 1461065. Thanks to Davor Ocelic (docelic) for reporting.\r
-\r
- Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - Michael(tm) Smith\r
-\r
- ● Process alt text with normalize-space(). Replace tab indents with spaces.\r
-\r
- Modified: html/graphics.xsl,1.57 - Robert Stayton\r
-\r
- ● Content of citation element is automatically linked to the bibliographic\r
- entry with the corresponding abbrev.\r
-\r
- Modified: html/biblio.xsl,1.26; html/inline.xsl,1.47; html/xref.xsl,1.58 -\r
- Jirka Kosek\r
-\r
- ● Add template for task in mode="xref-to".\r
-\r
- Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert Stayton\r
-\r
- ● Suppress ID warnings if the .warnings parameter is 0\r
-\r
- Modified: html/html.xsl,1.17 - Norman Walsh\r
-\r
- ● Add support for floatstyle to figure.\r
-\r
- Modified: html/formal.xsl,1.21 - Robert Stayton\r
-\r
- ● Handling of xref to area/areaset need support in extensions code also. I\r
- currently have no time to touch extensions code, so code is here to be\r
- enabled when extension is fixed also.\r
-\r
- Modified: html/xref.xsl,1.56 - Jirka Kosek\r
-\r
- ● Added 3 parameters for overriding gentext for index punctuation.\r
-\r
- Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert Stayton\r
-\r
- ● Added parameters to support localization of index item punctuation. Added\r
- index.separator named template to compute the separator punctuation based\r
- on locale.\r
-\r
- Modified: html/autoidx.xsl,1.27 - Robert Stayton\r
-\r
- ● Added a <div class="{$class}-contents"> wrapper around output of contents\r
- of all formal objects. Also, added an optional <br class="{class}-break"/>\r
- linebreak after all formal objects.\r
-\r
- WARNING: Because this change places an additional DIV between the DIV\r
- wrapper for the equation and the equation contents, it may break some\r
- existing CSS stylesheets that have been created with the assumption that\r
- there would never be an intervening DIV there.\r
-\r
- The following is an example of what Equation output looks like as a result\r
- of the changes described above.\r
-\r
- <div class="equation"> <a name="three" id="three"></a>\r
-\r
- <p class="title"><b>(1.3)</b></p>\r
-\r
- <div class="equation-contents"> <span class="mathphrase">1+1=3</span> </\r
- div> </div><br class="equation-break">\r
-\r
- Rationale: These changes allow CSS control of the placement of the\r
- formal-object title relative to the formal-object contents. For example,\r
- using the CSS "float" property enables the title and contents to be\r
- rendered on the same line. Example stylesheet:\r
-\r
- .equation { margin-top: 20px; margin-bottom: 20px; } .equation-contents {\r
- float: left; }\r
-\r
- .equation .title { margin-top: 0; float: right; margin-right: 200px; }\r
-\r
- .equation .title b { font-weight: normal; }\r
-\r
- .equation-break { clear: both; }\r
-\r
- Note that the purpose of the ".equation-break" class is to provide a way to\r
- clear off the floats.\r
-\r
- If you want to instead have the equation title rendered to the left of the\r
- equation contents, you can do something like this:\r
-\r
- .equation { margin-top: 20px; width: 300px; margin-bottom: 20px; }\r
- .equation-contents { float: right; }\r
-\r
- .equation .title { margin-top: 0; float: left; margin-right: 200px; }\r
-\r
- .equation .title b { font-weight: normal; }\r
-\r
- .equation-break { clear: both; }\r
-\r
- Modified: html/formal.xsl,1.20 - Michael(tm) Smith\r
-\r
- ● Added a chunker.output.quiet top-level parameter so that the chunker can be\r
- made quiet by default\r
-\r
- Modified: html/chunker.xsl,1.26 - Norman Walsh\r
-\r
- ● Added support for link, olink, and xref within OO Classsynopsis and\r
- children. (Because DocBook NG/5 allows it).\r
-\r
- Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith\r
-\r
- ● New parameter: id.warnings. If non-zero, warnings are generated for titled\r
- objects that don't have titles. True by default; I wonder if this will be\r
- too aggressive?\r
-\r
- Modified: html/biblio.xsl,1.25; html/component.xsl,1.27; html/\r
- division.xsl,1.11; html/formal.xsl,1.19; html/glossary.xsl,1.20; html/\r
- html.xsl,1.13; html/index.xsl,1.16; html/param.ent,1.88; html/\r
- param.xweb,1.97; html/refentry.xsl,1.22; html/sections.xsl,1.30; params/\r
- id.warnings.xml,1.1 - Norman Walsh\r
-\r
- ● If the keep.relative.image.uris parameter is true, don't use the absolute\r
- URI (as calculated from xml:base) in the img src attribute, us the value\r
- the author specified. Note that we still have to calculate the absolute\r
- filename for use in the image intrinsics extension.\r
-\r
- Modified: html/graphics.xsl,1.56 - Norman Walsh\r
-\r
- ● Support date as an inline\r
-\r
- Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh\r
-\r
- ● Added new parameter keep.relative.image.uris\r
-\r
- Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html\r
- /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh\r
-\r
- ● Added two new parameters for handling of multi-term varlistentry elements:\r
-\r
- variablelist.term.break.after: When the variablelist.term.break.after is\r
- non-zero, it will generate a line break after each term multi-term\r
- varlistentry.\r
-\r
- variablelist.term.separator: When a varlistentry contains multiple term\r
- elements, the string specified in the value of the\r
- variablelist.term.separator parameter is placed after each term except the\r
- last. The default is ", " (a comma followed by a space). To suppress\r
- rendering of the separator, set the value of variablelist.term.separator to\r
- the empty string ("").\r
-\r
- These parameters are primarily intended to be useful if you have multi-term\r
- varlistentries that have long terms.\r
-\r
- Closes #1306676. Thanks to Sam Steingold for providing an example "lots of\r
- long terms" doc that demonstrated the value of having these options.\r
-\r
- Also, added normalize-space() call to processing of each term.\r
-\r
- This change affects all output formats (HTML, PDF, manpages). The default\r
- behavior should pretty much remain the same as before, but it is possible\r
- (as always) that the change may introduce some new bugginess.\r
-\r
- Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/\r
- lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/\r
- lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/\r
- variablelist.term.break.after.xml,1.1; params/\r
- variablelist.term.separator.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added "wrapper-name" param to inline.charseq named template, enabling it to\r
- output inlines other than just "span". Acronym and Abbrev templates now use\r
- inline.charseq to output HTML "acronym" and "abbr" elements (instead of\r
- "span"). Closes #1305468. Thanks to Sam Steingold for suggesting the\r
- change.\r
-\r
- Modified: html/inline.xsl,1.45 - Michael(tm) Smith\r
-\r
-Manpages\r
-\r
-The following changes have been made to the manpages code since the 1.69.1\r
-release.\r
-\r
- ● Added the following params:\r
-\r
- - man.indent.width (string-valued) - man.indent.refsect (boolean) -\r
- man.indent.blurbs (boolean) - man.indent.lists (boolean) -\r
- man.indent.verbatims (boolean)\r
-\r
- Note that in earlier snapshots, man.indent.width was named\r
- man.indentation.default.value and the boolean params had names like\r
- man.indentation.*.adjust. Also the man.indent.blurbs param was called\r
- man.indentation.authors.adjust (or something).\r
-\r
- The behavior now is: If the value of a particular man.indent.* boolean\r
- param is non-zero, the corresponding contents (refsect*, list items,\r
- authorblurb/personblurb, vervatims) are displayed with a left margin\r
- indented by a width equal to the value of man.indent.width.\r
-\r
- Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74;\r
- manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20;\r
- manpages/param.ent,1.22; manpages/param.xweb,1.24; manpages/\r
- refentry.xsl,1.14; params/man.indent.lists.xml,1.1; params/\r
- man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; params/\r
- man.indent.width.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added man.table.footnotes.divider param.\r
-\r
- In each table that contains footenotes, the string specified by the man.\r
- table.footnotes.divider parameter is output before the list of footnotes\r
- for the table.\r
-\r
- Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; manpages/\r
- param.ent,1.21; manpages/param.xweb,1.23; params/\r
- man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added the man.output.in.separate.dir, man.output.base.dir, and\r
- man.output.subdirs.enabled parameters.\r
-\r
- The man.output.base.dir parameter specifies the base directory into which\r
- man-page files are output. The man.output.subdirs.enabled parameter\r
- controls whether the files are output in subdirectories within the base\r
- directory.\r
-\r
- The values of the man.output.base.dir and man.output.subdirs.enabled\r
- parameters are used only if the value of man.output.in.separate.dir\r
- parameter is non-zero. If the value of man.output.in.separate.dir is zero,\r
- man-page files are not output in a separate directory.\r
-\r
- Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; manpages/\r
- param.xweb,1.22; params/man.output.base.dir.xml,1.1; params/\r
- man.output.in.separate.dir.xml,1.1; params/\r
- man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added man.font.table.headings and man.font.table.title params, for\r
- controlling font in table headings and titles.\r
-\r
- Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; manpages/\r
- param.xweb,1.21; params/man.font.table.headings.xml,1.1; params/\r
- man.font.table.title.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added man.font.funcsynopsisinfo and man.font.funcprototype params, for\r
- specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and\r
- funcprototype output.\r
-\r
- Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; manpages/\r
- param.ent,1.18; manpages/param.xweb,1.20; manpages/synop.xsl,1.29; manpages\r
- /table.xsl,1.21; params/man.font.funcprototype.xml,1.1; params/\r
- man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added man.segtitle.suppress param.\r
-\r
- If the value of man.segtitle.suppress is non-zero, then display of segtitle\r
- contents is suppressed in output.\r
-\r
- Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; manpages/\r
- param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added man.output.manifest.enabled and man.output.manifest.filename params.\r
-\r
- If man.output.manifest.enabled is non-zero, a list of filenames for man\r
- pages generated by the stylesheet transformation is written to the file\r
- named by man.output.manifest.filename\r
-\r
- Modified: manpages/docbook.xsl,1.67; manpages/other.xsl,1.19; manpages/\r
- param.ent,1.16; manpages/param.xweb,1.18; params/\r
- man.output.manifest.enabled.xml,1.1; params/\r
- man.output.manifest.filename.xml,1.1; tools/make/Makefile.DocBook,1.4 -\r
- Michael(tm) Smith\r
-\r
- ● Added refentry.meta.get.quietly param.\r
-\r
- If zero (the default), notes and warnings about "missing" markup are\r
- generated during gathering of refentry metadata. If non-zero, the metadata\r
- is gathered "quietly" -- that is, the notes and warnings are suppressed.\r
-\r
- NOTE: If you are processing a large amount of refentry content, you may be\r
- able to speed up processing significantly by setting a non-zero value for\r
- refentry.meta.get.quietly.\r
-\r
- Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/\r
- param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)\r
- Smith\r
-\r
- ● Changed names of all boolean indentation params to man.indent.* Also\r
- discarded individual man.indent.*.value params and switched to just using a\r
- common man.indent.width param (3n by default).\r
-\r
- Modified: manpages/docbook.xsl,1.66; manpages/info.xsl,1.19; manpages/\r
- lists.xsl,1.29; manpages/other.xsl,1.18; manpages/refentry.xsl,1.13 -\r
- Michael(tm) Smith\r
-\r
- ● Added boolean man.output.in.separate.dir param, to control whether or not\r
- man files are output in separate directory.\r
-\r
- Modified: manpages/docbook.xsl,1.65; manpages/utility.xsl,1.14 - Michael\r
- (tm) Smith\r
-\r
- ● Added options for controlling indentation of verbatim output. Controlled\r
- through the man.indentation.verbatims.adjust and\r
- man.indentation.verbatims.value params. Closes #1242997\r
-\r
- Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 - Michael(tm)\r
- Smith\r
-\r
- ● Added options for controlling indentation in lists and in *blurb output in\r
- the AUTHORS section. Controlled through the man.indentation.lists.adjust,\r
- man.indentation.lists.value, man.indentation.authors.adjust, and\r
- man.indentation.authors.value parameters. Default is 3 characters (instead\r
- of the roff default of 8 characters). Closes #1449369.\r
-\r
- Also, removed the indent that was being set on informalexample outuput. I\r
- will instead add an option for indenting verbatims, which I think is what\r
- the informalexample indent was intended for originally.\r
-\r
- Modified: manpages/block.xsl,1.14; manpages/docbook.xsl,1.63; manpages/\r
- info.xsl,1.18; manpages/lists.xsl,1.28 - Michael(tm) Smith\r
-\r
- ● Changed line-spacing call before synopfragment to use ".sp -1n" ("n" units\r
- specified) instead of plain ".sp -1"\r
-\r
- Modified: manpages/synop.xsl,1.28 - Michael(tm) Smith\r
-\r
- ● Added support for writing man files into a specific output directory and\r
- into appropriate subdirectories within that output directory. Controlled\r
- through the man.base.dir parameter (similar to the base.dir support in the\r
- HTML stylesheet) and the man.subdirs.enabled parameter, which automatically\r
- determines the name of an appropriate subdir (for example, man/man7, man/\r
- man1, etc.) based on the section number/manvolnum of the source Refentry.\r
-\r
- Closes #1255036 and #1170317. Thanks to Denis Bradford for the original\r
- feature request, and to Costin Stroie for submitting a patch that was very\r
- helpful in implementing the support.\r
-\r
- Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 - Michael\r
- (tm) Smith\r
-\r
- ● Refined XPath statements and notification messages for refentry metadata\r
- handling.\r
-\r
- Modified: common/common.xsl,1.59; common/refentry.xsl,1.14; manpages/\r
- docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm) Smith\r
-\r
- ● Added support for copyright and legalnotice. The manpages stylesheets now\r
- output a COPYRIGHT section, after the AUTHORS section, if a copyright or\r
- legalnotice is found in the source. The section contains the copyright\r
- contents followed by the legalnotice contents. Closes #1450209.\r
-\r
- Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 - Michael(tm)\r
- Smith\r
-\r
- ● Drastically reworked all of the XPath expressions used in refentry metadata\r
- gathering -- completely removed $parentinfo and turned $info into a set of\r
- nodes that includes the *info contents of the Refentry plus the *info\r
- contents all all of its ancestor elements. The basic XPath expression now\r
- used throughout is (using the example of checking for a date):\r
-\r
- (($info[//date])[last()]/date)[1].\r
-\r
- That selects the "last" *info/date date in document order -- that is, the\r
- one eitther on the Refentry itself or on the closest ancestor to the\r
- Refentry.\r
-\r
- It's likely this change may break some things; may need to pick up some\r
- pieces later.\r
-\r
- Also, changed the default value for the man.th.extra2.max.length from 40 to\r
- 30.\r
-\r
- Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; params/\r
- man.th.extra2.max.length.xml,1.2; params/refentry.date.profile.xml,1.2;\r
- params/refentry.manual.profile.xml,1.2; params/\r
- refentry.source.name.profile.xml,1.2; params/\r
- refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; manpages/\r
- other.xsl,1.15 - Michael(tm) Smith\r
-\r
- ● Added support for DocBook 5 namespace-stripping in manpages stylesheet.\r
- Closes request #1210692.\r
-\r
- Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm)\r
- Smith\r
-\r
- ● Fixed handling of table footnotes. With this checkin, the table support in\r
- the manpages stylesheet is now basically feature complete. So this change\r
- closes request #619532, "No support for tables" -- the oldest currently\r
- open manpages feature request, submitted by Ben Secrest (blsecres) on\r
- 2002-10-07. Congratulations to me [patting myself on the back].\r
-\r
- Modified: manpages/block.xsl,1.11; manpages/docbook.xsl,1.55; manpages/\r
- table.xsl,1.15 - Michael(tm) Smith\r
-\r
- ● Added handling for table titles. Also fixed handling of nested tables; nest\r
- tables are now "extracted" and displayed just after their parent tables.\r
-\r
- Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14 - Michael(tm)\r
- Smith\r
-\r
- ● Added option for turning off bold formatting in Funcsynopsis. Boldface\r
- formatting in function synopsis is mandated in the man(7) man page and is\r
- used almost universally in existing man pages. Despite that, it really does\r
- look like crap to have an entire Funcsynopsis output in bold, so I added\r
- params for turning off the bold formatting and/or replacing it with a\r
- different roff special font (e.g., "RI" for alternating roman/italic\r
- instead of the default "BI" for alternating bold/italic). The new params\r
- are "man.funcprototype.font" and "man.funcsynopsisinfo.font". To be\r
- documented later.\r
-\r
- Closes #1452247. Thanks to Joe Orton for the feature request.\r
-\r
- Modified: params/man.string.subst.map.xml,1.16; manpages/block.xsl,1.10;\r
- manpages/docbook.xsl,1.51; manpages/inline.xsl,1.16; manpages/\r
- synop.xsl,1.27 - Michael(tm) Smith\r
-\r
- ● Use AUTHORS instead of AUTHOR if we have multiple people to attribute.\r
- Also, fixed checking such that we generate author section even if we don't\r
- have an author (as long as there is at least one other person/entity we can\r
- put in the section). Also adjusted assembly of content for Author metainfo\r
- field such that we now not only use author, but try to find a "best match"\r
- if we can't find an author name to put there.\r
-\r
- Closes #1233592. Thanks to Sam Steingold for the request.\r
-\r
- Modified: manpages/info.xsl,1.12 - Michael(tm) Smith\r
-\r
- ● Changes for request #1243027, "Impove handling of AUTHOR section." This\r
- adds support for Collab, Corpauthor, Corpcredt, Orgname, Publishername, and\r
- Publisher. Also adds support for output of Affiliation and its children,\r
- and support for using gentext strings for auto-attributing roles (Author,\r
- Editor, Publisher, Translator, etc.). Also did a lot of code cleanup and\r
- modularization of all the AUTHOR handling code. And fixed a bug that was\r
- causing Author info to not be picked up correctly for metainfo comment we\r
- embed in man-page source.\r
-\r
- Modified: manpages/info.xsl,1.11 - Michael(tm) Smith\r
-\r
- ● Support bold output for "emphasis remap='B'". (because Eric Raymond's\r
- doclifter(1) tool converts groff source marked up with ".B" request or "\\r
- fB" escapes to DocBook "emphasis remap='B'".)\r
-\r
- Modified: manpages/inline.xsl,1.14 - Michael(tm) Smith\r
-\r
- ● Added support for Segmentedlist. Details: Output is tabular, with no option\r
- for "list" type output. Output for Segtitle elements can be supressed by\r
- setting man.segtitle.suppress. If Segtitle content is output, it is\r
- rendered in italic type (not bold because not all terminals support bold\r
- and so italic ensures the stand out on those terminals). Extra space (.sp\r
- line) at end of table code ensures that it gets handled correctly in the\r
- case where its source is the child of a Para. Closes feature-request #\r
- 1400097. Thanks to Daniel Leidert for the patch and push, and to Alastair\r
- Rankine for filing the original feature request.\r
-\r
- Modified: manpages/lists.xsl,1.23; manpages/utility.xsl,1.10 - Michael(tm)\r
- Smith\r
-\r
- ● Improved handling or Author/Editor/Othercredit.\r
-\r
- Reworked content of (non-visible) comment added at top of each page\r
- (metadata stuff).\r
-\r
- Added support for generating a manifest file (useful for cleaning up after\r
- builds, etc.)\r
-\r
- Modified: manpages/docbook.xsl,1.46; manpages/info.xsl,1.9; manpages/\r
- other.xsl,1.12; manpages/utility.xsl,1.6 - Michael(tm) Smith\r
-\r
- ● Added two new parameters for handling of multi-term varlistentry elements:\r
-\r
- variablelist.term.break.after: When the variablelist.term.break.after is\r
- non-zero, it will generate a line break after each term multi-term\r
- varlistentry.\r
-\r
- variablelist.term.separator: When a varlistentry contains multiple term\r
- elements, the string specified in the value of the\r
- variablelist.term.separator parameter is placed after each term except the\r
- last. The default is ", " (a comma followed by a space). To suppress\r
- rendering of the separator, set the value of variablelist.term.separator to\r
- the empty string ("").\r
-\r
- These parameters are primarily intended to be useful if you have multi-term\r
- varlistentries that have long terms.\r
-\r
- Closes #1306676. Thanks to Sam Steingold for providing an example "lots of\r
- long terms" doc that demonstrated the value of having these options.\r
-\r
- Also, added normalize-space() call to processing of each term.\r
-\r
- This change affects all output formats (HTML, PDF, manpages). The default\r
- behavior should pretty much remain the same as before, but it is possible\r
- (as always) that the change may introduce some new bugginess.\r
-\r
- Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/\r
- lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/\r
- lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/\r
- variablelist.term.break.after.xml,1.1; params/\r
- variablelist.term.separator.xml,1.1 - Michael(tm) Smith\r
-\r
-Params\r
-\r
-The following changes have been made to the params code since the 1.69.1\r
-release.\r
-\r
- ● New parameters to set header/footer table minimum height.\r
-\r
- Modified: params/footer.table.height.xml,1.1; params/\r
- header.table.height.xml,1.1 - Robert Stayton\r
-\r
- ● Support multiple indexing methods for different languages.\r
-\r
- Modified: params/index.method.xml,1.1 - Robert Stayton\r
-\r
- ● Remove qandaset and qandadiv from generate.toc for fo output because\r
- formerly it wasn't working, but now it is and the default behavior should\r
- stay the same.\r
-\r
- Modified: params/generate.toc.xml,1.8 - Robert Stayton\r
-\r
- ● add support for page number references to link element too.\r
-\r
- Modified: params/insert.link.page.number.xml,1.1 - Robert Stayton\r
-\r
- ● Add support for more characters to hyphen on when ulink.hyphenate is turned\r
- on.\r
-\r
- Modified: params/ulink.hyphenate.chars.xml,1.1; params/\r
- ulink.hyphenate.xml,1.3 - Robert Stayton\r
-\r
- ● New attribute-set to format biblioentry and bibliomixed.\r
-\r
- Modified: params/biblioentry.properties.xml,1.1 - Robert Stayton\r
-\r
- ● Added new parameter chunk.tocs.and.lots.has.title which controls presence\r
- of title in a separate chunk with ToC/LoT. Disabling title can be very\r
- useful if you are generating frameset output (well, yes those frames, but\r
- some customers really want them ;-).\r
-\r
- Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; html/\r
- param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka\r
- Kosek\r
-\r
- ● Added new attribute set toc.line.properties for controlling appearance of\r
- lines in ToC/LoT\r
-\r
- Modified: params/toc.line.properties.xml,1.1 - Jirka Kosek\r
-\r
- ● Allow table footnotes to have different properties from regular footnotes.\r
-\r
- Modified: params/table.footnote.properties.xml,1.1 - Robert Stayton\r
-\r
- ● Set properties for pgwide="1" objects.\r
-\r
- Modified: params/pgwide.properties.xml,1.1 - Robert Stayton\r
-\r
- ● Added the autotoc.label.in.hyperlink param.\r
-\r
- If the value of autotoc.label.in.hyperlink is non-zero, labels are included\r
- in hyperlinked titles in the TOC. If it is instead zero, labels are still\r
- displayed prior to the hyperlinked titles, but are not hyperlinked along\r
- with the titles.\r
-\r
- Closes patch #1065868. Thanks to anatoly techtonik for the patch.\r
-\r
- Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; html/\r
- param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - Michael(tm)\r
- Smith\r
-\r
- ● Added two new params: html.head.legalnotice.link.types and html.head.\r
- legalnotice.link.multiple.\r
-\r
- If the value of the generate.legalnotice.link is non-zero, then the\r
- stylesheet generates (in the head section of the HTML source) either a\r
- single HTML link element or, if the value of the html.head.legalnotice.link\r
- .multiple is non-zero, one link element for each link type specified. Each\r
- link has the following attributes:\r
-\r
- - a rel attribute whose value is derived from the value of html.head.\r
- legalnotice.link.types\r
-\r
- - an href attribute whose value is set to the URL of the file containing\r
- the legalnotice\r
-\r
- - a title attribute whose value is set to the title of the corresponding\r
- legalnotice (or a title programatically determined by the stylesheet)\r
-\r
- For example:\r
-\r
- <link rel="copyright" href="ln-id2524073.html" title="Legal Notice">\r
-\r
- Closes #1476450. Thanks to Sam Steingold.\r
-\r
- Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; html/\r
- param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; params/\r
- html.head.legalnotice.link.multiple.xml,1.1; params/\r
- html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added the following params:\r
-\r
- - man.indent.width (string-valued) - man.indent.refsect (boolean) -\r
- man.indent.blurbs (boolean) - man.indent.lists (boolean) -\r
- man.indent.verbatims (boolean)\r
-\r
- Note that in earlier snapshots, man.indent.width was named\r
- man.indentation.default.value and the boolean params had names like\r
- man.indentation.*.adjust. Also the man.indent.blurbs param was called\r
- man.indentation.authors.adjust (or something).\r
-\r
- The behavior now is: If the value of a particular man.indent.* boolean\r
- param is non-zero, the corresponding contents (refsect*, list items,\r
- authorblurb/personblurb, vervatims) are displayed with a left margin\r
- indented by a width equal to the value of man.indent.width.\r
-\r
- Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74;\r
- manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20;\r
- manpages/param.ent,1.22; manpages/param.xweb,1.24; manpages/\r
- refentry.xsl,1.14; params/man.indent.lists.xml,1.1; params/\r
- man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; params/\r
- man.indent.width.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added man.table.footnotes.divider param.\r
-\r
- In each table that contains footenotes, the string specified by the man.\r
- table.footnotes.divider parameter is output before the list of footnotes\r
- for the table.\r
-\r
- Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; manpages/\r
- param.ent,1.21; manpages/param.xweb,1.23; params/\r
- man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added the man.output.in.separate.dir, man.output.base.dir, and\r
- man.output.subdirs.enabled parameters.\r
-\r
- The man.output.base.dir parameter specifies the base directory into which\r
- man-page files are output. The man.output.subdirs.enabled parameter\r
- controls whether the files are output in subdirectories within the base\r
- directory.\r
-\r
- The values of the man.output.base.dir and man.output.subdirs.enabled\r
- parameters are used only if the value of man.output.in.separate.dir\r
- parameter is non-zero. If the value of man.output.in.separate.dir is zero,\r
- man-page files are not output in a separate directory.\r
-\r
- Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; manpages/\r
- param.xweb,1.22; params/man.output.base.dir.xml,1.1; params/\r
- man.output.in.separate.dir.xml,1.1; params/\r
- man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added man.font.table.headings and man.font.table.title params, for\r
- controlling font in table headings and titles.\r
-\r
- Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; manpages/\r
- param.xweb,1.21; params/man.font.table.headings.xml,1.1; params/\r
- man.font.table.title.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added man.font.funcsynopsisinfo and man.font.funcprototype params, for\r
- specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and\r
- funcprototype output.\r
-\r
- Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; manpages/\r
- param.ent,1.18; manpages/param.xweb,1.20; manpages/synop.xsl,1.29; manpages\r
- /table.xsl,1.21; params/man.font.funcprototype.xml,1.1; params/\r
- man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Changed to select="0" in refclass.suppress (instead of ..>0</..)\r
-\r
- Modified: params/refclass.suppress.xml,1.3 - Michael(tm) Smith\r
-\r
- ● Added man.segtitle.suppress param.\r
-\r
- If the value of man.segtitle.suppress is non-zero, then display of segtitle\r
- contents is suppressed in output.\r
-\r
- Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; manpages/\r
- param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added man.output.manifest.enabled and man.output.manifest.filename params.\r
-\r
- If man.output.manifest.enabled is non-zero, a list of filenames for man\r
- pages generated by the stylesheet transformation is written to the file\r
- named by man.output.manifest.filename\r
-\r
- Modified: manpages/docbook.xsl,1.67; manpages/other.xsl,1.19; manpages/\r
- param.ent,1.16; manpages/param.xweb,1.18; params/\r
- man.output.manifest.enabled.xml,1.1; params/\r
- man.output.manifest.filename.xml,1.1; tools/make/Makefile.DocBook,1.4 -\r
- Michael(tm) Smith\r
-\r
- ● Added refclass.suppress param.\r
-\r
- If the value of refclass.suppress is non-zero, then display refclass\r
- contents is suppressed in output. Affects HTML and FO output only.\r
-\r
- Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html\r
- /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Added refentry.meta.get.quietly param.\r
-\r
- If zero (the default), notes and warnings about "missing" markup are\r
- generated during gathering of refentry metadata. If non-zero, the metadata\r
- is gathered "quietly" -- that is, the notes and warnings are suppressed.\r
-\r
- NOTE: If you are processing a large amount of refentry content, you may be\r
- able to speed up processing significantly by setting a non-zero value for\r
- refentry.meta.get.quietly.\r
-\r
- Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/\r
- param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)\r
- Smith\r
-\r
- ● Added support for "software" and "sectdesc" class values on refmiscinfo;\r
- "software" is treated identically to "source", and "setdesc" is treated\r
- identically to "manual".\r
-\r
- Modified: common/refentry.xsl,1.10; params/\r
- man.th.extra2.max.length.xml,1.3; params/\r
- refentry.source.name.profile.xml,1.4 - Michael(tm) Smith\r
-\r
- ● Drastically reworked all of the XPath expressions used in refentry metadata\r
- gathering -- completely removed $parentinfo and turned $info into a set of\r
- nodes that includes the *info contents of the Refentry plus the *info\r
- contents all all of its ancestor elements. The basic XPath expression now\r
- used throughout is (using the example of checking for a date):\r
-\r
- (($info[//date])[last()]/date)[1].\r
-\r
- That selects the "last" *info/date date in document order -- that is, the\r
- one eitther on the Refentry itself or on the closest ancestor to the\r
- Refentry.\r
-\r
- It's likely this change may break some things; may need to pick up some\r
- pieces later.\r
-\r
- Also, changed the default value for the man.th.extra2.max.length from 40 to\r
- 30.\r
-\r
- Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; params/\r
- man.th.extra2.max.length.xml,1.2; params/refentry.date.profile.xml,1.2;\r
- params/refentry.manual.profile.xml,1.2; params/\r
- refentry.source.name.profile.xml,1.2; params/\r
- refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; manpages/\r
- other.xsl,1.15 - Michael(tm) Smith\r
-\r
- ● Added option for turning off bold formatting in Funcsynopsis. Boldface\r
- formatting in function synopsis is mandated in the man(7) man page and is\r
- used almost universally in existing man pages. Despite that, it really does\r
- look like crap to have an entire Funcsynopsis output in bold, so I added\r
- params for turning off the bold formatting and/or replacing it with a\r
- different roff special font (e.g., "RI" for alternating roman/italic\r
- instead of the default "BI" for alternating bold/italic). The new params\r
- are "man.funcprototype.font" and "man.funcsynopsisinfo.font". To be\r
- documented later.\r
-\r
- Closes #1452247. Thanks to Joe Orton for the feature request.\r
-\r
- Modified: params/man.string.subst.map.xml,1.16; manpages/block.xsl,1.10;\r
- manpages/docbook.xsl,1.51; manpages/inline.xsl,1.16; manpages/\r
- synop.xsl,1.27 - Michael(tm) Smith\r
-\r
- ● fop.extensions now only for FOP version 0.20.5 and earlier.\r
-\r
- Modified: params/fop.extensions.xml,1.4 - Robert Stayton\r
-\r
- ● Support for fop1 different from fop 0.20.5 and earlier.\r
-\r
- Modified: params/fop1.extensions.xml,1.1 - Robert Stayton\r
-\r
- ● Reset default value to empty string so template uses gentext first, then\r
- the parameter value if not empty.\r
-\r
- Modified: params/index.number.separator.xml,1.2; params/\r
- index.range.separator.xml,1.2; params/index.term.separator.xml,1.2 - Robert\r
- Stayton\r
-\r
- ● New parameter: id.warnings. If non-zero, warnings are generated for titled\r
- objects that don't have titles. True by default; I wonder if this will be\r
- too aggressive?\r
-\r
- Modified: html/biblio.xsl,1.25; html/component.xsl,1.27; html/\r
- division.xsl,1.11; html/formal.xsl,1.19; html/glossary.xsl,1.20; html/\r
- html.xsl,1.13; html/index.xsl,1.16; html/param.ent,1.88; html/\r
- param.xweb,1.97; html/refentry.xsl,1.22; html/sections.xsl,1.30; params/\r
- id.warnings.xml,1.1 - Norman Walsh\r
-\r
- ● Added new parameter keep.relative.image.uris\r
-\r
- Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html\r
- /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh\r
-\r
- ● Support default label width parameters for itemized and ordered lists\r
-\r
- Modified: fo/lists.xsl,1.64; fo/param.ent,1.90; fo/param.xweb,1.103; params\r
- /itemizedlist.label.width.xml,1.1; params/orderedlist.label.width.xml,1.1 -\r
- Norman Walsh\r
-\r
- ● Added parameters to localize punctuation in indexes.\r
-\r
- Modified: params/index.number.separator.xml,1.1; params/\r
- index.range.separator.xml,1.1; params/index.term.separator.xml,1.1 - Robert\r
- Stayton\r
-\r
- ● Added two new parameters for handling of multi-term varlistentry elements:\r
-\r
- variablelist.term.break.after: When the variablelist.term.break.after is\r
- non-zero, it will generate a line break after each term multi-term\r
- varlistentry.\r
-\r
- variablelist.term.separator: When a varlistentry contains multiple term\r
- elements, the string specified in the value of the\r
- variablelist.term.separator parameter is placed after each term except the\r
- last. The default is ", " (a comma followed by a space). To suppress\r
- rendering of the separator, set the value of variablelist.term.separator to\r
- the empty string ("").\r
-\r
- These parameters are primarily intended to be useful if you have multi-term\r
- varlistentries that have long terms.\r
-\r
- Closes #1306676. Thanks to Sam Steingold for providing an example "lots of\r
- long terms" doc that demonstrated the value of having these options.\r
-\r
- Also, added normalize-space() call to processing of each term.\r
-\r
- This change affects all output formats (HTML, PDF, manpages). The default\r
- behavior should pretty much remain the same as before, but it is possible\r
- (as always) that the change may introduce some new bugginess.\r
-\r
- Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/\r
- lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/\r
- lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/\r
- variablelist.term.break.after.xml,1.1; params/\r
- variablelist.term.separator.xml,1.1 - Michael(tm) Smith\r
-\r
- ● Convert 'no' to string in default value.\r
-\r
- Modified: params/olink.doctitle.xml,1.4 - Robert Stayton\r
-\r
- ● Implemented RFE #1292615.\r
-\r
- Added bunch of new parameters (attribute sets) that affect list\r
- presentation: list.block.properties, itemizedlist.properties, orderedlist\r
- .properties, itemizedlist.label.properties and orderedlist.label\r
- .properties. Default behaviour of stylesheets has not been changed but\r
- further customizations will be much more easier.\r
-\r
- Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; params/\r
- itemizedlist.label.properties.xml,1.1; params/\r
- itemizedlist.properties.xml,1.1; params/list.block.properties.xml,1.1;\r
- params/orderedlist.label.properties.xml,1.1; params/\r
- orderedlist.properties.xml,1.1 - Jirka Kosek\r
-\r
- ● Implemented RFE #1242092.\r
-\r
- You can enable crop marks in your document by setting crop.marks=1 and\r
- xep.extensions=1. Appearance of crop marks can be controlled by parameters\r
- crop.mark.bleed (6pt), crop.mark.offset (24pt) and crop.mark.width (0.5pt).\r
-\r
- Also there is new named template called user-xep-pis. You can overwrite it\r
- in order to produce some PIs that can control XEP as described in http://\r
- www.renderx.com/reference.html#Output_Formats\r
-\r
- Modified: fo/docbook.xsl,1.36; fo/param.ent,1.86; fo/param.xweb,1.97; fo/\r
- xep.xsl,1.23; params/crop.mark.bleed.xml,1.1; params/\r
- crop.mark.offset.xml,1.1; params/crop.mark.width.xml,1.1; params/\r
- crop.marks.xml,1.1 - Jirka Kosek\r
-\r
- ● Changed short descriptions in doc for *autolabel* params to match new\r
- autolabel behavior.\r
-\r
- Modified: params/appendix.autolabel.xml,1.5; params/\r
- chapter.autolabel.xml,1.4; params/part.autolabel.xml,1.5; params/\r
- preface.autolabel.xml,1.4 - Michael(tm) Smith\r
-\r
-Profiling\r
-\r
-The following changes have been made to the profiling code since the 1.69.1\r
-release.\r
-\r
- ● Profiling now works together with namespace stripping (V5 documents).\r
- Namespace striping should work with all stylesheets named profile-, even if\r
- they are not supporting namespace stripping in a non-profiling variant.\r
-\r
- Modified: profiling/profile-mode.xsl,1.4; profiling/xsl2profile.xsl,1.7 -\r
- Jirka Kosek\r
-\r
- ● Moved profiling stage out of templates. This make possible to reuse\r
- profiled content by several templates and still maintaing node indentity\r
- (needed for example for HTML Help where content is processed multiple\r
- times).\r
-\r
- I don't know why this was not on the top level before. Maybe some XSLT\r
- processors choked on it. I hope this will be OK now.\r
-\r
- Modified: profiling/xsl2profile.xsl,1.5 - Jirka Kosek\r
-\r
-Tools\r
-\r
-The following changes have been made to the tools code since the 1.69.1\r
-release.\r
-\r
- ● Moved Makefile.DocBook from contrib module to xsl module.\r
-\r
- Modified: tools/make/Makefile.DocBook,1.1 - Michael(tm) Smith\r
-\r
-WordML\r
-\r
-The following changes have been made to the wordml code since the 1.69.1\r
-release.\r
-\r
- ● added contrib element, better handling of default paragraph style\r
-\r
- Modified: wordml/pages-normalise.xsl,1.6; wordml/supported.xml,1.2; wordml/\r
- wordml-final.xsl,1.14 - Steve Ball\r
-\r
- ● added bridgehead\r
-\r
- Modified: wordml/docbook-pages.xsl,1.6; wordml/docbook.xsl,1.17; wordml/\r
- pages-normalise.xsl,1.5; wordml/template-pages.xml,1.7; wordml/\r
- template.dot,1.4; wordml/template.xml,1.14; wordml/wordml-final.xsl,1.13 -\r
- Steve Ball\r
-\r
- ● added blocks stylesheet to support bibliographies, glossaries and qandasets\r
-\r
- Modified: wordml/Makefile,1.4; wordml/README,1.3; wordml/\r
- blocks-spec.xml,1.1; wordml/docbook-pages.xsl,1.5; wordml/docbook.xsl,1.16;\r
- wordml/pages-normalise.xsl,1.4; wordml/sections-spec.xml,1.3; wordml/\r
- specifications.xml,1.13; wordml/template-pages.xml,1.6; wordml/\r
- template.dot,1.3; wordml/template.xml,1.13; wordml/wordml-blocks.xsl,1.1;\r
- wordml/wordml-final.xsl,1.12; wordml/wordml-sections.xsl,1.3 - Steve Ball\r
-\r
- ● added mediaobject caption\r
-\r
- Modified: wordml/docbook-pages.xsl,1.4; wordml/docbook.xsl,1.15; wordml/\r
- specifications.xml,1.12; wordml/template-pages.xml,1.5; wordml/\r
- template.dot,1.2; wordml/template.xml,1.12; wordml/wordml-final.xsl,1.11 -\r
- Steve Ball\r
-\r
- ● added callouts\r
-\r
- Modified: wordml/docbook-pages.xsl,1.3; wordml/docbook.xsl,1.14; wordml/\r
- pages-normalise.xsl,1.3; wordml/specifications.xml,1.11; wordml/\r
- template-pages.xml,1.4; wordml/wordml-final.xsl,1.10 - Steve Ball\r
-\r
- ● added Word template file\r
-\r
- Modified: wordml/template.dot,1.1 - Steve Ball\r
-\r
- ● added abstract, fixed itemizedlist, ulink\r
-\r
- Modified: wordml/specifications.xml,1.10; wordml/wordml-final.xsl,1.9 -\r
- Steve Ball\r
-\r
- ● fixed Makefile added many features to Pages support added revhistory,\r
- inlines, highlights, abstract\r
-\r
- Modified: wordml/Makefile,1.2; wordml/docbook-pages.xsl,1.2; wordml/\r
- pages-normalise.xsl,1.2; wordml/sections-spec.xml,1.2; wordml/\r
- specifications.xml,1.9; wordml/template-pages.xml,1.3; wordml/\r
- template.xml,1.11; wordml/wordml-final.xsl,1.8; wordml/\r
- wordml-sections.xsl,1.2 - Steve Ball\r
-\r
- ● fixed handling linebreaks when generating WordML added Apple Pages support\r
-\r
- Modified: wordml/docbook.xsl,1.13; wordml/template-pages.xml,1.2 - Steve\r
- Ball\r
-\r
-Release 1.69.1\r
-\r
-This release is a minor bug-fix update to the 1.69.0 release. Along with bug\r
-fixes, it includes one configuration-parameter change: The default value of the\r
-annotation.support parameter is now 0 (off). The reason for that change is that\r
-there have been reports that annotation handling is causing a significant\r
-performance degradation in processing of large documents with xsltproc.\r
-\r
-Release 1.69.0\r
-\r
-The release includes major feature changes, particularly in the manpages\r
-stylesheets, as well as a large number of bug fixes.\r
-\r
-As with all DocBook Project “dot zero” releases, this is an experimental\r
-release .\r
-\r
-Common\r
-\r
- ● This release adds localizations for the following languages: Albanian,\r
- Amharic, Azerbaijani, Hindi, Irish (Gaelic), Gujarati, Kannada, Mongolian,\r
- Oriya, Punjabi, Tagalog, Tamil, and Welsh.\r
-\r
- ● Added support for specifying number format for auto labels for chapter,\r
- appendix, part, and preface. Contolled with the appendix.autolabel,\r
- chapter.autolabel, part.autolabel, and preface.autolabel parameters.\r
-\r
- ● Added basic support for biblioref cross referencing.\r
-\r
- ● Added support for align on caption in mediaobject.\r
-\r
- ● Added support for processing documents that use the DocBook V5 namespace.\r
-\r
- ● Added support for termdef and mathphrase.\r
-\r
- ● EXPERIMENTAL: Incorporated the Slides and Website stylesheets into the\r
- DocBook XSL stylesheets package. So, for example, Website documents can now\r
- be processed using the following URI for the driver Website tabular.xsl\r
- file:\r
-\r
- http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl\r
-\r
- ● A procedure without a title is now treated as an “informal” procedure\r
- (meaning that it is not added to any generated “list of procedures” and has\r
- no affect on numbering of generated labels for other procedures).\r
-\r
- ● docname is no longer added to olink when pointing to a root element.\r
-\r
- ● Added support for generation of choice separator in inline simplelist. This\r
- enables auto-generation of an appropriate localized “choice separator” (for\r
- example, “and” or “or”) before the final item in an inline simplelist.\r
-\r
- To indicate that you want a choice separator generated for a particular\r
- list, you need to put a processing instruction (PI) of the form <?\r
- dbchoice choice="foo"?> as a child of the list. For example:\r
-\r
- <para>Choose from\r
- ONE and ONLY ONE of the following:\r
- <simplelist type="inline">\r
- <?dbchoice choice="or" ?>\r
- <member>A</member>\r
- <member>B</member>\r
- <member>C</member>.</simplelist></para>\r
-\r
- Output (for English):\r
-\r
- Choose from ONE and only ONE of the following choices: A, B, or C.\r
-\r
- As a temporary workaround for the fact that most of the DocBook non-English\r
- locale files don't have a localization for the word “or”, you can put in a\r
- literal string to be used; example for French: <?dbchoice choice="ou">.\r
- That is, use “ou” instead of “or”.\r
-\r
-FO\r
-\r
- ● Added content-type property to external-graphic element, based on imagedata\r
- format attribute.\r
-\r
- ● Added support for generating <rx:meta-field creator="$VERSION"/> field for\r
- XEP output. This makes the DocBook XSL stylesheet version information\r
- available through the Document Properties menu in Acrobat Reader and other\r
- PDF viewers.\r
-\r
- ● Trademark symbol handling made consistent with handling of same in HTML\r
- stylesheets. Prior to this change, if you processed a document that\r
- contained no value for the class attribute on the trademark element, the\r
- HTML stylesheets would default to rendering a superscript TM symbol after\r
- the trademark contents, but the FO stylesheets would render nothing.\r
-\r
- ● Added support for generating XEP bookmarks for refentry.\r
-\r
- ● Added support for HTML markup table border attribute, applied to each table\r
- cell.\r
-\r
- ● The table.width template can now sum column specs if none use % or *.\r
-\r
- ● Added fox:destination extension inside fox:outline to support linking to\r
- internal destinations.\r
-\r
- ● Added support for customizing abstract with property sets. Controlled with\r
- the abstract.properties and abstract.title.properties parameters.\r
-\r
- ● Add footnotes in table title to table footnote set, and add support for\r
- table footnotes to HTML table markup.\r
-\r
- ● Added support for title in glosslist.\r
-\r
- ● Added support for itemizedlist symbol none.\r
-\r
- ● Implemented the new graphical.admonition.properties and\r
- nongraphical.admonition.properties attribute sets.\r
-\r
- ● Added id to formalpara and some other blocks that were missing it.\r
-\r
- ● Changed the anchor template to output fo:inline instead of fo:wrapper.\r
-\r
- ● Added support for toc.max.depth parameter.\r
-\r
-Help\r
-\r
- ● Eclipse Help: Added support for generating olink database.\r
-\r
-HTML\r
-\r
- ● Added a first cut at support in HTML output for DocBook 5 style annotation\r
- s. Controlled using the annotation.support parameter, and implemented using\r
- JavaScript and CSS styling. For more details, see the documentation for the\r
- annotation.js, annotation.css, annotation.graphic.open, and\r
- annotation.graphic.close parameters.\r
-\r
- ● Generate client-side image map for imageobjectco with areas using calspair\r
- units\r
-\r
- ● Added support for <?img.src.path?> PI.\r
-\r
- ● Added support for passing img.src.path to DocBook Java XSLT image\r
- extensions when appropriate. Controlled using the\r
- graphicsize.use.img.src.path parameter.\r
-\r
- ● Added support for (not valid for DocBook 4) xlink:href on area and (not\r
- valid for DocBook 4) alt in area.\r
-\r
- ● Added new parameter default.table.frame to control table framing if there\r
- is no frame attribute on a table.\r
-\r
- ● Added initial, experimental support for generating content for the HTML\r
- title attribute from content of the alt element. This change adds support\r
- for the following inline elements only (none of them are block elements):\r
- abbrev, accel, acronym, action, application, authorinitials, beginpage,\r
- citation, citerefentry, citetitle, city, classname, code, command,\r
- computeroutput, constant, country, database, email, envar, errorcode,\r
- errorname, errortext, errortype, exceptionname, fax, filename, firstname,\r
- firstterm, foreignphrase, function, glossterm, guibutton, guiicon, guilabel\r
- , guimenu, guimenuitem, guisubmenu, hardware, honorific, interface,\r
- interfacename, keycap, keycode, keysym, lineage, lineannotation, literal,\r
- markup, medialabel, methodname, mousebutton, option, optional, otheraddr,\r
- othername, package, parameter, personname, phone, pob, postcode,\r
- productname, productnumber, prompt, property, quote, refentrytitle, remark,\r
- replaceable, returnvalue, tag, shortcut, state, street, structfield,\r
- structname, subscript, superscript, surname, symbol, systemitem, tag,\r
- termdef, token, trademark, type, uri, userinput, varname, and wordasword\r
-\r
- ● Added support for chunking revhistory into separate file (similar to the\r
- support for doing same with legalnotice). Patch from Thomas Schraitle.\r
- Controlled through new generate.revhistory.link parameter.\r
-\r
- ● l10n.xsl: Made language codes RFC compliant. Added a new boolean config\r
- parameter, l10n.lang.value.rfc.compliant. If it is non-zero (the default),\r
- any underscore in a language code will be converted to a hyphen in HTML\r
- output. If it is zero, the language code will be left as-is.\r
-\r
-man\r
-\r
-This release closes out 44 manpages stylesheet bug reports and feature\r
-requests. It adds more than 35 new configuration parameters for controlling\r
-aspects of man-page output -- including hyphenation and justification, handling\r
-of links, conversion of Unicode characters, and contents of man-page headers\r
-and footers.\r
-\r
- ● New options for globally disabling/enabling hyphenation and justification:\r
- man.justify and man.hyphenate.\r
-\r
- Note that the default for the both of those is zero (off), because\r
- justified text looks good only when it is also hyphenated; to quote the\r
- “Hyphenation” node from the groff info page:\r
-\r
- Since the odds are not great for finding a set of words, for every\r
- output line, which fit nicely on a line without inserting excessive\r
- amounts of space between words, `gtroff' hyphenates words so that it\r
- can justify lines without inserting too much space between words.\r
-\r
- The problem is that groff can end up hyphenating a lot of things that you\r
- don't want hyphenated (variable names and command names, for example).\r
- Keeping both justification and hyphenation disabled ensures that hyphens\r
- won't get inserted where you don't want to them, and you don't end up with\r
- lines containing excessive amounts of space between words. These default\r
- settings run counter to how most existing man pages are formatted. But\r
- there are some notable exceptions, such as the perl man pages.\r
-\r
- ● Added parameters for controlling hyphenation of computer inlines,\r
- filenames, and URLs. By default, even when hyphenation is enabled\r
- (globally), hyphenation is now suppressed for "computer inlines"\r
- (currently, just classname, constant, envar, errorcode, option, replaceable\r
- , userinput, type, and varname, and for filenames, and for URLs from link.\r
- It can be (re)enabled using the man.hyphenate.computer.inlines,\r
- man.hyphenate.filenames, and man.hyphenate.urls parameters.\r
-\r
- ● Implemented a new system for replacing Unicode characters. There are two\r
- parts to the new system: a “string substitution map” for doing “essential”\r
- replacements, and a “character map” that can optionally be disabled and\r
- enabled.\r
-\r
- The new system fixes all open bugs that had to do with literal Unicode\r
- numbered entities such as “ and ” showing up in output, and\r
- greatly expands the ability of the stylesheets to generate “good” roff\r
- equivalents for Unicode symbols and special characters.\r
-\r
- Here are some details...\r
-\r
- The previous manpages mechanism for replacing Unicode symbols and special\r
- characters with roff equivalents (the replace-entities template) was not\r
- scalable and not complete. The mechanism handled a somewhat arbitrary\r
- selection of less than 20 or so Unicode characters. But there are\r
- potentially more than 800 Unicode special characters that have some groff\r
- equivalent they can be mapped to. And there are about 34 symbols in the\r
- Latin-1 (ISO-8859-1) block alone. Users might reasonably expect that if\r
- they include any of those Latin-1 characters in their DocBook source\r
- documents, they will get correctly converted to known roff equivalents in\r
- output.\r
-\r
- In addition to those common symbols, certain users may have a need to use\r
- symbols from other Unicode blocks. Say, somebody who is documenting an\r
- application related to math might need to use a bunch of symbols from the\r
- “Mathematical Operators” Unicode block (there are about 65 characters in\r
- that block that have reasonable roff equivalents). Or somebody else might\r
- really like Dingbats -- such as the checkmark character -- and so might use\r
- a bunch of things from the “Dingbat” block (141 characters in that that\r
- have roff equivalents or that can at least be “degraded” somewhat\r
- gracefully into roff).\r
-\r
- So, the old replace-entities mechanism was replaced with a completely\r
- different mechanism that is based on use of two “maps”: a “substitution\r
- map” and a “character map” (the latter in a format compliant with the XSLT\r
- 2.0 spec and therefore completely “forward compatible” with XSLT 2.0).\r
-\r
- The substitution map is controlled through the man.string.subst.map\r
- parameter, and is used to replace things like the backslash character\r
- (which needs special handling to prevent it from being interpreted as a\r
- roff escape). The substitution map cannot be disabled, because disabling it\r
- will cause the output to be broken. However, you can add to it and change\r
- it if needed.\r
-\r
- The “character map” mechanism, on the other hand, can be completely\r
- disabled. It is enabled by default, and, by default, does replacement of\r
- all Latin-1 symbols, along with most special spaces, dashes, and quotes\r
- (about 75 characters by default). Also, you can optionally enable a “full”\r
- character map that provides support for converting all 800 or so of the\r
- characters that have some reasonable groff equivalent.\r
-\r
- The character-map mechanism is controlled through the following parameters:\r
-\r
- man.charmap.enabled\r
-\r
- turns character-map support on/off\r
-\r
- man.charmap.use.subset\r
-\r
- specifies that a subset of the character map is used instead of the\r
- full map\r
-\r
- man.charmap.subset.profile\r
-\r
- specifies profile of character-map subset\r
-\r
- man.charmap.uri\r
-\r
- specifies an alternate character map to use instead of the “standard”\r
- character map provided in the distribution\r
-\r
- ● Implemented out-of-line handling of display of URLs for links (currently,\r
- only for ulink). This gives you three choices for handling of links:\r
-\r
- 1. Number and list links. Each link is numbered inline, with a number in\r
- square brackets preceding the link contents, and a numbered list of all\r
- links is added to the end of the document.\r
-\r
- 2. Only list links. Links are not numbered, but an (unnumbered) list of\r
- links is added to the end of the document.\r
-\r
- 3. Suppress links. Don't number links and don't add any list of links to\r
- the end of the document.\r
-\r
- You can also choose whether links should be underlined. The default is “the\r
- works” -- list, number, and underline links. You can use the\r
- man.links.list.enabled, man.links.are.numbered, and\r
- man.links.are.underlined parameters to change the defaults. The default\r
- heading for the link list is REFERENCES. You can be change that using the\r
- man.links.list.heading parameter.\r
-\r
- ● Changed default output encoding to UTF-8. This does not mean that man pages\r
- are output in raw UTF-8, because the character map is applied before final\r
- output, causing all UTF-8 characters covered in the map to be converted to\r
- roff equivalents.\r
-\r
- ● Added support for processing refsect3 and formalpara and nested refsection\r
- elements, down to any arbitrary level of nesting.\r
-\r
- ● Output of the NAME and SYNOPSIS and AUTHOR headings and the headings for\r
- admonitions (note, caution, etc.) are no longer hard-coded for English.\r
- Instead, headings are generated for those in the correct locale (just as\r
- the FO and HTML stylesheets do).\r
-\r
- ● Re-worked mechanism for assembling page headers/footers (the contents of\r
- the .TH macro “title line”).\r
-\r
- Here are some details...\r
-\r
- All man pages contain a .TH roff macro whose contents are used for\r
- rendering the “title line” displayed in the header and footer of each page.\r
- Here are a couple of examples of real-world man pages that have useful page\r
- headers/footers:\r
-\r
- gtk-options(7) GTK+ User's Manual gtk-options(7) <-- header\r
- GTK+ 1.2 2003-10-20 gtk-options(7) <-- footer\r
-\r
- svgalib(7) Svgalib User Manual svgalib(7) <-- header\r
- Svgalib 1.4.1 16 December 1999 svgalib(7) <-- footer\r
-\r
- And here are the terms with which the groff_man(7) man page refers to the\r
- various parts of the header/footer:\r
-\r
- title(section) extra3 title(section) <- header\r
- extra2 extra1 title(section) <- footer\r
-\r
- Or, using the names with which the man(7) man page refers to those same\r
- fields:\r
-\r
- title(section) manual title(section) <- page header\r
- source date title(section) <- page footer\r
-\r
- The easiest way to control the contents of those fields is to mark up your\r
- refentry content like the following (note that this is a “minimal”\r
- example).\r
-\r
- <refentry>\r
- <info>\r
- <date>2003-10-20</date> 1\r
- </info>\r
- <refmeta>\r
- <refentrytitle>gtk-options</refentrytitle> 2\r
- <manvolnum>7</manvolnum> 3\r
- <refmiscinfo class="source-name">GTK+</refmiscinfo> 4\r
- <refmiscinfo class="version">1.2</refmiscinfo> 5\r
- <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> 6\r
- </refmeta>\r
- <refnamediv>\r
- <refname>gtk-options</refname>\r
- <refpurpose>Standard Command Line Options for GTK+ Programs</refpurpose>\r
- </refnamediv>\r
- <refsect1>\r
- <title>Description</title>\r
- <para>This manual page describes the command line options, which\r
- are common to all GTK+ based applications.</para>\r
- </refsect1>\r
- </refentry>\r
-\r
- 1 Sets the “date” part of the header/footer.\r
-\r
- 2 Sets the “title” part.\r
-\r
- 3 Sets the “section” part.\r
-\r
- 4 Sets the “source name” part.\r
-\r
- 5 Sets the “version” part.\r
-\r
- 6 Sets the “manual” part.\r
-\r
- Below are explanations of the steps the stylesheets take to attempt to\r
- assemble and display “good” headers and footer. [In the descriptions, note\r
- that *info is the refentry “info” child (whatever its name), and parentinfo\r
- is the “info” child of its parent (again, whatever its name).]\r
-\r
- extra1 field (date)\r
-\r
- Content of the “extra1” field is what shows up in the center footer\r
- position of each page. The man(7) man page describes it as “the date of\r
- the last revision”.\r
-\r
- To provide this content, if the refentry.date.profile.enabled is\r
- non-zero, the stylesheets check the value of refentry.date.profile.\r
-\r
- Otherwise, by default, they check for a date or pubdate not only in the\r
- *info contents, but also in the parentinfo contents.\r
-\r
- If a date cannot be found, the stylesheets now automatically generate a\r
- localized “long format” date, ensuring that this field always has\r
- content in output.\r
-\r
- However, if for some reason you want to suppress this field, you can do\r
- so by setting a non-zero value for man.th.extra1.suppress.\r
-\r
- extra2 field (source)\r
-\r
- On Linux systems and on systems with a modern groff, the content of the\r
- “extra2” field are what shows up in the left footer position of each\r
- page.\r
-\r
- The man(7) man page describes this as “the source of the command”, and\r
- provides the following examples:\r
-\r
- ○ For binaries, use somwething like: GNU, NET-2, SLS Distribution,\r
- MCC Distribution.\r
-\r
- ○ For system calls, use the version of the kernel that you are\r
- currently looking at: Linux 0.99.11.\r
-\r
- ○ For library calls, use the source of the function: GNU, BSD 4.3,\r
- Linux DLL 4.4.1.\r
-\r
- In practice, there are many pages that simply have a version number in\r
- the “source” field. So, it looks like what we have is a two-part field,\r
- Name Version, where:\r
-\r
- Name\r
-\r
- product name (e.g., BSD) or org. name (e.g., GNU)\r
-\r
- Version\r
-\r
- version name\r
-\r
- Each part is optional. If the Name is a product name, then the Version\r
- is probably the version of the product. Or there may be no Name, in\r
- which case, if there is a Version, it is probably the version of the\r
- item itself, not the product it is part of. Or, if the Name is an\r
- organization name, then there probably will be no Version.\r
-\r
- To provide this content, if the refentry.source.name.profile.enabled\r
- and refentry.version.profile.enabled parameter are non-zero, the\r
- stylesheets check the value of refentry.source.name.profile\r
- refentry.version.profile.\r
-\r
- Otherwise, by default, they check the following places, in the\r
- following order:\r
-\r
- 1. *info/productnumber\r
-\r
- 2. *info/productnumber\r
-\r
- 3. refmeta/refmiscinfo[@class = 'version']\r
-\r
- 4. parentinfo/productnumber\r
-\r
- 5. *info/productname\r
-\r
- 6. parentinfo/productname\r
-\r
- 7. refmeta/refmiscinfo\r
-\r
- 8. [nothing found, so leave it empty]\r
-\r
- extra3 field\r
-\r
- On Linux systems and on systems with a modern groff, the content of the\r
- “extra3” field are what shows up in the center header position of each\r
- page. Some man pages have “extra2” content, some don't. If a particular\r
- man page has it, it is most often “context” data about some larger\r
- system the documented item belongs to (for example, the name or\r
- description of a group of related applications). The stylesheets now\r
- check the following places, in the following order, to look for content\r
- to add to the “extra3” field.\r
-\r
- 1. parentinfo/title\r
-\r
- 2. parent's title\r
-\r
- 3. refmeta/refmiscinfo\r
-\r
- 4. [nothing found, so leave it empty]\r
-\r
- ● Reworked *info gathering. For each refentry found, the stylesheets now\r
- cache its *info content, then check for any valid parent of it that might\r
- have metainfo content and cache that, if found; they then then do all\r
- further matches against those node-sets (rather than re-selecting the\r
- original *info nodes each time they are needed).\r
-\r
- ● New option for breaking strings after forward slashes. This enables long\r
- URLs and pathnames to be broken across lines. Controlled through\r
- man.break.after.slash parameter.\r
-\r
- ● Output for servicemark and trademark are now (SM) and (TM). There is a\r
- groff "\(tm" escape, but output from that is not acceptable.\r
-\r
- ● New option for controlling the length of the title part of the .TH title\r
- line. Controlled through the man.th.title.max.length parameter.\r
-\r
- ● New option for specifying output encoding of each man page; controlled with\r
- man.output.encoding (similar to the HTML chunker.output.encoding \r
- parameter).\r
-\r
- ● New option for suppressing filename messages when generating output;\r
- controlled with man.output.quietly (similar to the HTML chunk.quietly\r
- parameter).\r
-\r
- ● The text of cross-references to first-level refentry (refsect1, top-level\r
- refsection, refnamediv, and refsynopsisdiv) are now capitalized.\r
-\r
- ● Cross-references to refnamediv now use the localized NAME title instead of\r
- using the first refname child. This makes the output inconsistent with HTML\r
- and FO output, but for man-page output, it seems to make better sense to\r
- have the NAME. (It may actually make better sense to do it that way in HTML\r
- and FO output as well...)\r
-\r
- ● Added support for processing funcparams.\r
-\r
- ● Removed the space that was being output between funcdef and paramdef;\r
- example: was: float rand (void); now: float rand(void)\r
-\r
- ● Turned off bold formatting for the type element when it occurs within a\r
- funcdef or paramdef\r
-\r
- ● Corrected rendering of simplelist. Any <simplelist type="inline" instance\r
- is now rendered as a comma-separated list (also with an optional localized\r
- “and” or “or” before the last item -- see description elsewhere in these\r
- release notes). Any simplelist instance whose type is not inline is\r
- rendered as a one-column vertical list (ignoring the values of the type and\r
- columns attributes if present)\r
-\r
- ● Comment added at top of roff source for each page now includes DocBook XSL\r
- stylesheets version number (as in the HTML stylesheets)\r
-\r
- ● Made change to prevent “sticky” fonts changes. Now, when the manpages\r
- stylesheets encounter node sets that need to be boldfaced or italicized,\r
- they put the \fBfoo\fR and \fIbar\fR groff bold/italic instructions\r
- separately around each node in the set.\r
-\r
- ● synop.xsl: Boldface everything in funcsynopsis output except parameters\r
- (which are in ital). The man(7) man page says:\r
-\r
- For functions, the arguments are always specified using italics, even\r
- in the SYNOPSIS section, where the rest of the function is specified in\r
- bold.\r
-\r
- A look through the contents of the man/man2 directory shows that most (all)\r
- existing pages do follow this “everything in funcsynopsis bold” rule. That\r
- means the type content and any punctuation (parens, semicolons, varargs)\r
- also must be bolded.\r
-\r
- ● Removed code for adding backslashes before periods/dots in roff source,\r
- because backslashes in front of periods/dots in roff source are needed only\r
- in the very rare case where a period is the very first character in a line,\r
- without any space in front of it. A better way to deal with that rare case\r
- is for you to add a zero-width space in front of the offending dot(s) in\r
- your source\r
-\r
- ● Removed special handling of the quote element. That was hard-coded to cause\r
- anything marked up with the quote element to be output preceded by two\r
- backticks and followed by two apostrophes -- that is, that old-school\r
- kludge for generating “curly” quotes in Emacs and in X-Windows fonts. While\r
- Emacs still seems to support that, I don't think X-Windows has for a long\r
- time now. And, anyway, it looks (and has always looked) like crap when\r
- viewed on a normal tty/console. In addition, it breaks localiztion of quote\r
- . By default, quote content is output with localized quotation marks,\r
- which, depending on the locale, may or may not be left and right double\r
- quotation marks.\r
-\r
- ● Changed mappings for left and right single quotation marks. Those had\r
- previously been incorrectly mapped to the backtick (`) and apostrophe\r
- (&39;) characters (for kludgy reasons -- see above). They are now correctly\r
- mapped to the \(oq and \(cq roff escapes. If you want the old (broken)\r
- behavior, you need to manually change the mappings for those in the value\r
- of the man.string.subst.map parameter.\r
-\r
- ● Removed xref.xsl file. Now, of the various cross-reference elements, only\r
- the ulink element is handled differently; the rest are handled exactly as\r
- the HTML stylesheets handle them, except that no hypertext links are\r
- generated. (Because there is no equivalent hypertext mechanism is man\r
- pages.)\r
-\r
- ● New option for making “subheading dividers” in generated roff source. The\r
- dividers are not visible in the rendered man page; they are just there to\r
- make the source readable. Controlled using man.subheading.divider.\r
-\r
- ● Fixed many places where too much space was being added between lines.\r
-\r
-Release 1.68.1\r
-\r
-The release adds localization support for Farsi (thanks to Sina Heshmati) and\r
-improved support for the XLink-based DocBook NG db:link element. Other than\r
-that, it is a minor bug-fix update to the 1.68.0 release. The main thing it\r
-fixes is a build error that caused the XSLT Java extensions to be jarred up\r
-with the wrong package structure. Thanks to Jens Stavnstrup for quickly\r
-reporting the problem, and to Mauritz Jeanson for investigating and finding the\r
-cause.\r
-\r
-Release 1.68.0\r
-\r
-This release includes some features changes, particularly for FO/PDF output,\r
-and a number of bug fixes.\r
-\r
-FO\r
-\r
- ● Moved footnote properties to attribute-sets.\r
-\r
- ● Added support for side floats, margin notes, and custom floats.\r
-\r
- ● Added new parameters body.start.indent and body.end.indent to the\r
- set.flow.properties template.\r
-\r
- ● Added support for xml:id\r
-\r
- ● Added support for refdescriptor.\r
-\r
- ● Added support for multiple refnamedivs.\r
-\r
- ● Added index.entry.properties attribute-set to support customization of\r
- index entries.\r
-\r
- ● Added set.flow.properties template call to each fo:flow to support\r
- customizations entry point.\r
-\r
- ● Add support for @floatstyle in figure\r
-\r
- ● Moved hardcoded properties for index division titles to the\r
- index.div.title.properties attribute-set.\r
-\r
- ● Added support for table-layout="auto" for XEP.\r
-\r
- ● Added index.div.title.properties attribute-set.\r
-\r
- ● $verbose parameter is now passed to most elements.\r
-\r
- ● Added refentry to toc in part, as it is permitted by the DocBook schema/\r
- DTD.\r
-\r
- ● Added backmatter elements and article to toc in part, since they are\r
- permitted by the DocBook schema/DTD.\r
-\r
- ● Added mode="toc" for simplesect, since it is now permitted in the toc if\r
- simplesect.in.toc is set.\r
-\r
- ● Moved hard-coded properties to nongraphical.admonintion.properties and\r
- graphical.admonition.properties attribute sets.\r
-\r
- ● Added support for sidebar-width and float-type processing instructions in\r
- sidebar.\r
-\r
- ● For tables with HTML markup elements, added support for dbfo bgcolor PI,\r
- the attribute-sets named table.properties, informaltable.properties,\r
- table.table.properties, and table.cell.padding. Also added support for the\r
- templates named table.cell.properties and table.cell.block.properties so\r
- that tabstyles can be implemented. Also added support for tables containing\r
- only tr instead of tbody with tr.\r
-\r
- ● Added new paramater hyphenate.verbatim.characters which can specify\r
- characters after which a line break can occur in verbatim environments.\r
- This parameter can be used to extend the initial set of characters which\r
- contain only space and non-breakable space.\r
-\r
- ● Added itemizedlist.label.markup to enable selection of different bullet\r
- symbol. Also added several potential bullet characters, commented out by\r
- default.\r
-\r
- ● Enabled all id's in XEP output for external olinking.\r
-\r
-HTML\r
-\r
- ● Added support for refdescriptor.\r
-\r
- ● Added support for multiple refnamedivs.\r
-\r
- ● Added support for xml:id\r
-\r
- ● refsynopsisdiv as a section for counting section levels\r
-\r
-Images\r
-\r
- ● Added new SVG admonition graphics and navigation images.\r
-\r
-Release 1.67.2\r
-\r
-This release fixes a table bug introduced in the 1.67.1 release.\r
-\r
-Release 1.67.1\r
-\r
-This release includes a number of bug fixes.\r
-\r
-The following lists provide details about API and feature changes.\r
-\r
-FO\r
-\r
- ● Tables: Inherited cell properties are now passed to the\r
- table.cell.properties template so they can be overridden by a\r
- customization.\r
-\r
- ● Tables: Added support for bgcolor PI on table row element.\r
-\r
- ● TOCs: Added new parameter simplesect.in.toc; default value of 0 causes\r
- simplesect to be omitted from TOCs; to cause simplesect to be included in\r
- TOCs, you must set the value of simplesect.in.toc to 1.Comment from Norm:\r
-\r
- Simplesect elements aren't supposed to appear in the ToC at all... The\r
- use case for simplesect is when, for example, every chapter in a book\r
- ends with "Exercises" or "For More Information" sections and you don't\r
- want those to appear in the ToC.\r
-\r
- ● Sections: Reverted change that caused a variable reference to be used in a\r
- template match and rewrote code to preserve intended semantics.\r
-\r
- ● Lists: Added workaround to prevent "* 0.60 + 1em" garbage in list output\r
- from PassiveTeX\r
-\r
- ● Moved the literal attributes from component.title to the\r
- component.title.properties attribute-set so they can be customized.\r
-\r
- ● Lists: Added glossdef's first para to special handling in\r
- fo:list-item-body.\r
-\r
-HTML\r
-\r
- ● TOCs: Added new parameter simplesect.in.toc; for details, see the list of\r
- FO changes for this release.\r
-\r
- ● Indexing: Added new parameter index.prefer.titleabbrev; when set to 1,\r
- index references will use titleabbrev instead of title when available.\r
-\r
-HTML Help\r
-\r
- ● Added support for generating windows-1252-encoded output using Saxon; for\r
- more details, see the list of XSL Java extensions changes for this release.\r
-\r
-man pages\r
-\r
- ● Replaced named/numeric character-entity references for non-breaking space\r
- with groff equivalent (backslash-tilde).\r
-\r
-XSL Java extensions\r
-\r
- ● Saxon extensions: Added the Windows1252 class. It extends Saxon 6.5.x with\r
- the windows-1252 character set, which is particularly useful when\r
- generating HTML Help for Western European Languages (code from Pontus\r
- Haglund and contributed to the DocBook community by Sectra AB, Sweden).\r
-\r
- To use:\r
-\r
- 1. Make sure that the Saxon 6.5.x jar file and the jar file for the\r
- DocBook XSL Java extensions are in your CLASSPATH\r
-\r
- 2. Create a DocBook XSL customization layer -- a file named\r
- mystylesheet.xsl or whatever -- that, at a minimum, contains the\r
- following:\r
-\r
- <xsl:stylesheet\r
- xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
- version='1.0'>\r
- <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/>\r
- <xsl:output method="html" encoding="WINDOWS-1252" indent="no"/>\r
- <xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"></xsl:param>\r
- <xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"></xsl:param>\r
- <xsl:param name="saxon.character.representation" select="'native'"></xsl:param>\r
- </xsl:stylesheet>\r
-\r
- Invoke Saxon with the encoding.windows-1252 Java system property set to\r
- com.nwalsh.saxon.Windows1252; for example\r
-\r
- java \\r
- -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \\r
- com.icl.saxon.StyleSheet \\r
- mydoc.xml mystylesheet.xsl\r
-\r
- Or, for a more complete "real world" case showing other options you'll\r
- typically want to use:\r
-\r
- java \\r
- -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \\r
- -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \\r
- -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \\r
- -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \\r
- com.icl.saxon.StyleSheet \\r
- -x org.apache.xml.resolver.tools.ResolvingXMLReader \\r
- -y org.apache.xml.resolver.tools.ResolvingXMLReader \\r
- -r org.apache.xml.resolver.tools.CatalogResolver \\r
- mydoc.xml mystylesheet.xsl\r
-\r
- In both cases, the "mystylesheet.xsl" file should be a DocBook\r
- customization layer containing the parameters show in step 2.\r
-\r
- ● Saxon extensions: Removed Saxon 8 extensions from release package\r
-\r
-Release 1.67.0\r
-\r
- ● A number of important bug fixes.\r
-\r
- ● Added Saxon8 extensions\r
-\r
- ● Enabled dbfo table-width on entrytbl in FO output\r
-\r
- ● Added support for role=strong on emphasis in FO output\r
-\r
- ● Added new FO parameter hyphenate.verbatim that can be used to turn on\r
- "intelligent" wrapping of verbatim environments.\r
-\r
- ● Replaced all <tt></tt> output with <code></code>\r
-\r
- ● Changed admon.graphic.width template to a mode so that different\r
- admonitions can have different graphical widths.\r
-\r
- ● Deprecated the HTML shade.verbatim parameter (use CSS instead)\r
-\r
- ● Wrapped ToC refentrytitle/refname and refpurpose in span with class values.\r
- This makes it possible to style them using a CSS stylesheet.\r
-\r
- ● Use strong/em instead of b/i in HTML output\r
-\r
- ● Added support for converting Emphasis to groff italic and Emphasis role=\r
- 'bold' to bold. Controlled by emphasis.propagates.style param, but not\r
- documented yet using litprog system. Will do that next (planning to add\r
- some other parameter-controllable options for hyphenation and handling of\r
- line spacing).\r
-\r
- ● callout.graphics.number.limit.xml param: Changed the default from 10 to 15.\r
-\r
- ● verbatim.properties: Added hyphenate=false\r
-\r
- ● Saxon and Xalan Text.java extensions: Added support for URIResolver() on\r
- insertfile href's\r
-\r
- ● Added generated RELEASE-NOTES.txt file.\r
-\r
- ● Added INSTALL file (executable file for generating catalog.xml)\r
-\r
- ● Removed obsolete tools directory from package\r
-\r
-Release 1.66.1\r
-\r
- ● A number of important bug fixes.\r
-\r
- ● Now xml:base attributes that are generated by an XInclude processor are\r
- resolved for image files.\r
-\r
- ● Rewrote olink templates to support several new features.\r
-\r
- ○ Extended full olink support to FO output.\r
-\r
- ○ Add support for xrefstyle attribute in olinks.\r
-\r
- ○ New parameters to support new olink features: insert.olink.page.number,\r
- insert.olink.pdf.frag, olink.debug, olink.lang.fallback.sequence,\r
- olink.properties, prefer.internal.olink. See the reference page for\r
- each parameter for more information.\r
-\r
- ● Added index.on.type parameter for new type attribute introduced in DocBook\r
- 4.3 for indexterms and index. This allows you to create multiple indices\r
- containing different categories of entries. For users of 4.2 and earlier,\r
- you can use the new parameter index.on.role instead.\r
-\r
- ● Added new section.autolabel.max.depth parameter to turn off section\r
- numbering below a certain depth. This permits you to number major section\r
- levels and leave minor section levels unnumbered.\r
-\r
- ● Added footnote.sep.leader.properties attribute set to format the line\r
- separating footnotes in printed output.\r
-\r
- ● Added parameter img.src.path as a prefix to HTML img src attributes. The\r
- prefix is added to whatever path is already generated by the stylesheet for\r
- each image file.\r
-\r
- ● Added new attribute-sets informalequation.properties,\r
- informalexample.properties, informalfigure.properties, and\r
- informaltable.properties, so each such element type can be formatted\r
- individually if needed.\r
-\r
- ● Add component.label.includes.part.label parameter to add any part number to\r
- chapter, appendix and other component labels when the label.from.part\r
- parameter is nonzero. This permits you to distinguish multiple chapters\r
- with the same chapter number in cross references and the TOC.\r
-\r
- ● Added chunk.separate.lots parameter for HTML output. This parameter lets\r
- you generate separate chunk files for each LOT (list of tables, list of\r
- figures, etc.).\r
-\r
- ● Added several table features:\r
-\r
- ○ Added table.table.properties attribute set to add properties to the\r
- fo:table element.\r
-\r
- ○ Added placeholder templates named table.cell.properties and\r
- table.cell.block.properties to enable adding properties to any\r
- fo:table-cell or the cell's fo:block, respectively. These templates are\r
- a start for implementing table styles.\r
-\r
- ● Added new attribute set component.title.properties for easy modifications\r
- of component's title formatting in FO output.\r
-\r
- ● Added Saxon support for an encoding attribute on the textdata element.\r
- Added new parameter textdata.default.encoding which specifies encoding when\r
- encoding attribute on textdata is missing.\r
-\r
- ● Template label.this.section now controls whole section label, not only\r
- sub-label which corresponds to particular label. Former behaviour was IMHO\r
- bug as it was not usable.\r
-\r
- ● Formatting in titleabbrev for TOC and headers is preserved when there are\r
- no hotlink elements in the title. Formerly the title showed only the text\r
- of the title, no font changes or other markup.\r
-\r
- ● Added intial.page.number template to set the initial-page-number property\r
- for page sequences in print output. Customizing this template lets you\r
- change when page numbering restarts. This is similar to the\r
- format.page.number template that lets you change how the page number\r
- formatting changes in the output.\r
-\r
- ● Added force.page.count template to set the force-page-count property for\r
- page sequences in print output. This is similar to the format.page.number\r
- template.\r
-\r
- ● Sort language for localized index sorting in autoidx-ng.xsl is now taken\r
- from document lang, not from system environment.\r
-\r
- ● Numbering and formatting of normal and ulink footnotes (if turned on) has\r
- been unified. Now ulink footnotes are mixed in with any other footnotes.\r
-\r
- ● Added support for renderas attribute in section and sect1 et al. This\r
- permits you to render a given section title as if it were a different\r
- level.\r
-\r
- ● Added support for label attribute in footnote to manually supply the\r
- footnote mark.\r
-\r
- ● Added support for DocBook 4.3 corpcredit element.\r
-\r
- ● Added support for a dbfo keep-together PI for formal objects (table,\r
- figure, example, equation, programlisting). That permits a formal object to\r
- be kept together if it is not already, or to be broken if it is very long\r
- and the default keep-together is not appropriate.\r
-\r
- ● For graphics files, made file extension matching case insensitive, and\r
- updated the list of graphics extensions.\r
-\r
- ● Allow calloutlist to have block content before the first callout\r
-\r
- ● Added dbfo-need processing instruction to provide soft page breaks.\r
-\r
- ● Added implementation of existing but unused default.image.width parameter\r
- for graphics.\r
-\r
- ● Support DocBook NG tag inline element.\r
-\r
- ● It appears that XEP now supports Unicode characters in bookmarks. There is\r
- no further need to strip accents from characters.\r
-\r
- ● Make segmentedlist HTML markup more semantic and available to CSS styles.\r
-\r
- ● Added user.preroot placeholder template to permit xsl-stylesheet and other\r
- PIs and comments to be output before the HTML root element.\r
-\r
- ● Non-chunked legalnotice now gets an <a name="id"> element in HTML output so\r
- it can be referenced with xref or link.\r
-\r
- ● In chunked HTML output, changed link rel="home" to rel="start", and link\r
- rel="previous" to rel="prev", per W3C HTML 4.01 spec.\r
-\r
- ● Added several patches to htmlhelp from W. Borgert\r
-\r
- ● Added Bosnian locale file as common/bs.xml.\r
-\r
-Release 1.65.0\r
-\r
- ● A number of important bug fixes.\r
-\r
- ● Added a workaround to allow these stylesheets to process DocBook NG\r
- documents. (It’s a hack that pre-processes the document to strip off the\r
- namespace and then uses exsl:node-set to process the result.)\r
-\r
- ● Added alternative indexing mechanism which has better internationalization\r
- support. New indexing method allows grouping of accented letters like e, é,\r
- ë into the same group under letter "e". It can also treat special letters\r
- (e.g. "ch") as one character and place them in the correct position (e.g.\r
- between "h" and "i" in Czech language).\r
-\r
- In order to use this mechanism you must create customization layer which\r
- imports some base stylesheet (like fo/docbook.xsl, html/chunk.xsl) and then\r
- includes appropriate stylesheet with new indexing code (fo/autoidx-ng.xsl\r
- or html/autoidx-ng.xsl). For example:\r
-\r
- <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
- version="1.0">\r
-\r
- <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/>\r
- <xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/>\r
-\r
- </xsl:stylesheet>\r
-\r
- New method is known to work with Saxon and it should also work with\r
- xsltproc 1.1.1 and later. Currently supported languages are English, Czech,\r
- German, French, Spanish and Danish.\r
-\r
-Release 1.64.1\r
-\r
-General bug fixes and improvements. Sorry about the failure to produce an\r
-updated release notes file for 1.62.0—1.63.2\r
-\r
- ● In the course of fixing bug #849787, wrapping Unicode callouts with an\r
- appropriate font change in the Xalan extensions, I discovered that the\r
- Xalan APIs have changed a bit. So xalan2.jar will work with older Xalan 2\r
- implementations, xalan25.jar works with Xalan 2.5.\r
-\r
-Release 1.61.0\r
-\r
-Lots of bug fixes and improvements.\r
-\r
- ● Initial support for timestamp PI. From now you can use <?dbtimestamp format\r
- ="Y-m-d H:M:S"?> to get current datetime in your document. Added\r
- localization support for datetime PI\r
-\r
- ● Added level 6 to test for section depth in section.level template so that\r
- section.title.level6.properties will be used for sections that are 6 deep\r
- or deeper. This should also cause a h6 to be created in html output.\r
-\r
- ● Don't use SVG graphics if use.svg=0\r
-\r
- ● Now uses number-and-title-template for sections only if section.autolabel\r
- is not zero.\r
-\r
- ● Added missing 'english-language-name' attribute to the l10n element, and\r
- the missing 'style' attribute to the template element so the current\r
- gentext documents will validate.\r
-\r
- ● Corrected several references to parameter qanda.defaultlabel that were\r
- missing the "$".\r
-\r
- ● Now accepts admon.textlabel parameter to turn off Note, Warning, etc.\r
- label.\r
-\r
- ● FeatReq #684561: support more XEP metadata\r
-\r
- ● Added hyphenation support. Added support for coref. Added beginpage\r
- support. (does nothing; see TDG).\r
-\r
- ● Added support for hyphenation-character, hyphenation-push-character-count,\r
- and hyphenation-remain-character-count\r
-\r
- ● Added root.properties, ebnf.assignment, and ebnf.statement.terminator\r
-\r
- ● Support bgcolor PI in table cells; make sure rowsep and colsep don't have\r
- any effect on the last row or column\r
-\r
- ● Handle othercredit on titlepage a little better\r
-\r
- ● Applied fix from Jeff Beal that fixed the bug that put secondary page\r
- numbers on primary entries. Same with tertiary page numbers on secondary\r
- entries.\r
-\r
- ● Added definition of missing variable collection.\r
-\r
- ● Make footnote formatting 'normal' even when it occurs in a context that has\r
- special formatting\r
-\r
- ● Added warning when glossary.collection is not blank, but it cannot open the\r
- specified file.\r
-\r
- ● Pick up the frame attribute on table and informaltable.\r
-\r
- ● indexdiv/title in non-autogenerated indexes are now picked up.\r
-\r
- ● Removed (unused) component.title.properties\r
-\r
- ● Move IDs from page-sequences down to titlepage blocks\r
-\r
- ● Use proportional-column-width(1) on more tables.\r
-\r
- Use proportional-column-width() for header/footer tables; suppress\r
- relative-align when when using FOP\r
-\r
- ● Check for glossterm.auto.link when linking firstterms; don't output gl.\r
- prefix on glossterm links\r
-\r
- ● Generate Part ToCs\r
-\r
- ● Support glossary, bibliography, and index in component ToCs.\r
-\r
- ● Refactored chunking code so that customization of chunk algorithm and chunk\r
- elements is more practical\r
-\r
- ● Support textobject/phrase on inlinemediaobject.\r
-\r
- ● Support 'start' PI on ordered lists\r
-\r
- ● Fixed test of $toc PI to turn on qandaset TOC.\r
-\r
- ● Added process.chunk.footnotes to sect2 through 5 to fix bug of missing\r
- footnotes when chunk level greater than 1.\r
-\r
- ● Added paramater toc.max.depth which controls maximal depth of ToC as\r
- requested by PHP-DOC group.\r
-\r
- ● Exempted titleabbrev from preamble processing in lists, and fixed\r
- variablelist preamble code to use the same syntax as the other lists.\r
-\r
- ● Added support for elements between variablelist and first varlistentry\r
- since DocBook 4.2 supports that now.\r
-\r
-Release 1.60.1\r
-\r
-Lots of bug fixes.\r
-\r
- ● The format of the titlepage.templates.xml files and the stylesheet that\r
- transforms them have been significantly changed. All of the attributes used\r
- to control the templates are now namespace qualified. So what used to be:\r
-\r
- <t:titlepage element="article" wrapper="fo:block">\r
-\r
- is now:\r
-\r
- <t:titlepage t:element="article" t:wrapper="fo:block">\r
-\r
- Attributes from other namespaces (including those that are unqualified) are\r
- now copied directly through. In practice, this means that the names that\r
- used to be “fo:” qualified:\r
-\r
- <title named-template="component.title"\r
- param:node="ancestor-or-self::article[1]"\r
- fo:text-align="center"\r
- fo:keep-with-next="always"\r
- fo:font-size="&hsize5;"\r
- fo:font-weight="bold"\r
- fo:font-family="{$title.font.family}"/>\r
-\r
- are now unqualified:\r
-\r
- <title t:named-template="component.title"\r
- param:node="ancestor-or-self::article[1]"\r
- text-align="center"\r
- keep-with-next="always"\r
- font-size="&hsize5;"\r
- font-weight="bold"\r
- font-family="{$title.font.family}"/>\r
-\r
- The t:titlepage and t:titlepage-content elements both generate wrappers\r
- now. And unqualified attributes on those elements are passed through. This\r
- means that you can now make the title font apply to ane entire titlepage\r
- and make the entire “recto” titlepage centered by specifying the font and\r
- alignment on the those elements:\r
-\r
- <t:titlepage t:element="article" t:wrapper="fo:block"\r
- font-family="{$title.font.family}">\r
-\r
- <t:titlepage-content t:side="recto"\r
- text-align="center">\r
-\r
- ● Support use of titleabbrev in running headers and footers.\r
-\r
- ● Added (experimental) xref.with.number.and.title parameter to enable number/\r
- title cross references even when the default would be just the number.\r
-\r
- ● Generate part ToCs if they're requested.\r
-\r
- ● Use proportional-column-width() in header/footer tables.\r
-\r
- ● Handle alignment correctly when screenshot wraps a graphic in a figure.\r
-\r
- ● Format chapter and appendix cross references consistently.\r
-\r
- ● Attempt to support tables with multiple tgroups in FO.\r
-\r
- ● Output fo:table-columns in simplelist tables.\r
-\r
- ● Use titlepage.templates.xml for indexdiv and glossdiv formatting.\r
-\r
- ● Improve support for new bibliography elements.\r
-\r
- ● Added footnote.number.format, table.footnote.number.format,\r
- footnote.number.symbols, and table.footnote.number.symbols for better\r
- control of footnote markers.\r
-\r
- ● Added glossentry.show.acronyms.\r
-\r
- ● Suppress the draft-mode page masters when draft-mode is “no”.\r
-\r
- ● Make blank pages verso not recto. D'Oh!\r
-\r
- ● Improved formatting of ulink footnotes.\r
-\r
- ● Fixed bugs in graphic width/height calculations.\r
-\r
- ● Added class attributes to inline elements.\r
-\r
- ● Don't add “.html” to the filenames identified with the “dbhtml” PI.\r
-\r
- ● Don't force a ToC when sections contain refentrys.\r
-\r
- ● Make section title sizes a function of the body.master.size.\r
-\r
-Release 1.59.2\r
-\r
-The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail.\r
-\r
- ● Removed the region-name from the region-body of blank pages. There's no\r
- reason to give the body of blank pages a unique name and doing so causes a\r
- mismatch that FOP detects.\r
-\r
- ● Output IDs for the first paragraphs in listitems.\r
-\r
- ● Fixed some small bugs in the handling of page numbers in double-sided mode.\r
-\r
- ● Attempt to prevent duplicated IDs from being produced when endterm on xref\r
- points to something with nested structure.\r
-\r
- ● Fix aligment problems in equations.\r
-\r
- ● Output the type attribute on unordered lists (UL) in HTML only if the\r
- css.decoration parameter is true.\r
-\r
- ● Calculate the font size in formal.title.properties so that it's 1.2 times\r
- the base font size, not a fixed "12pt".\r
-\r
-Release 1.59.1\r
-\r
-The 1.59.1 fixes a few bugs.\r
-\r
- ● Added Bulgarian localization.\r
-\r
- ● Indexing improvements; localize book indexes to books but allow setindex to\r
- index an entire set.\r
-\r
- ● The default value for rowsep and colsep is now "1" as per CALS.\r
-\r
- ● Added support for titleabbrev (use them for cross references).\r
-\r
- ● Improvements to mediaobject for selecting print vs. online images.\r
-\r
- ● Added seperate property sets for figures, examples, equations, tabless, and\r
- procedures.\r
-\r
- ● Make lineannotations italic.\r
-\r
- ● Support xrefstyle attribute.\r
-\r
- ● Make endterm on xref higher priority than xreflabel target.\r
-\r
- ● Glossary formatting improvements.\r
-\r
-Release 1.58.0\r
-\r
-The 1.58.0 adds some initial support for extensions in xsltproc, adds a few\r
-features, and fixes bugs.\r
-\r
- ● This release contains the first attempt at extension support for xsltproc.\r
- The only extension available to date is the one that adjusts table column\r
- widths. Run extensions/xsltproc/python/xslt.py.\r
-\r
- ● Fixed bugs in calculation of adjusted column widths to correct for rounding\r
- errors.\r
-\r
- ● Support nested refsection elements correctly.\r
-\r
- ● Reworked gentext.template to take context into consideration. The name of\r
- elements in localization files is now an xpath-like context list, not just\r
- a simple name.\r
-\r
- ● Made some improvements to bibliography formatting.\r
-\r
- ● Improved graphical formatting of admonitions.\r
-\r
- ● Added support for entrytbl.\r
-\r
- ● Support spanning index terms.\r
-\r
- ● Support bibliosource.\r
-\r
-Release 1.57.0\r
-\r
- ● The 1.57.0 release wasn't documented here. Oops.\r
-\r
-Release 1.56.0\r
-\r
-The 1.56.0 release fixes bugs.\r
-\r
- ● Reworked chunking. This will break all existing customizations layers that\r
- change the chunking algorithm. If you're customizing chunking, look at the\r
- new “content” parameter that's passed to process-chunk-element and friends.\r
-\r
- ● Support continued and inherited numeration in orderedlist formatting for\r
- FOs.\r
-\r
- ● Added Thai localization.\r
-\r
- ● Tweaked stylesheet documentation stylesheets to link to TDG and the\r
- parameter references.\r
-\r
- ● Allow title on tables of contents ("Table of Contents") to be optional.\r
- Added new keyword to generate.toc. Support tables of contents on sections.\r
-\r
- ● Made separate parameters for table borders and table cell borders:\r
- table.frame.border.color, table.frame.border.style,\r
- table.frame.border.thickness, table.cell.border.color,\r
- table.cell.border.style, and table.cell.border.thickness.\r
-\r
- ● Suppress formatting of “endofrange” indexterms. This is only half-right.\r
- They should generate a range, but I haven't figured out how to do that yet.\r
-\r
- ● Support revdescription. (Bug #582192)\r
-\r
- ● Added default.float.class and fixed figure floats. (Bug #497603)\r
-\r
- ● Fixed formatting of sbr in FOs.\r
-\r
- ● Added context to the “missing template” error message.\r
-\r
- ● Process arg correctly in a group. (Bug #605150)\r
-\r
- ● Removed 'keep-with-next' from formal.title.properties attribute set now\r
- that the stylesheets support the option of putting such titles below the\r
- object. Now the $placement value determines if 'keep-with-next' or\r
- 'keep-with-previous' is used in the title block.\r
-\r
- ● Wrap “url()” around external-destinations when appropriate.\r
-\r
- ● Fixed typo in compact list spacing. (Bug #615464)\r
-\r
- ● Removed spurious hash in anchor name. (Bug #617717)\r
-\r
- ● Address is now displayed verbatim on title pages. (Bug #618600)\r
-\r
- ● The bridgehead.in.toc parameter is now properly supported.\r
-\r
- ● Improved effectiveness of HTML cleanup by increasing the number of places\r
- where it is used. Improve use of HTML cleanup in XHTML stylesheets.\r
-\r
- ● Support table of contents for appendix in article. (Bug #596599)\r
-\r
- ● Don't duplicate footnotes in bibliographys and glossarys. (Bug #583282)\r
-\r
- ● Added default.image.width. (Bug #516859)\r
-\r
- ● Totally reworked funcsynopsis code; it now supports a 'tabular'\r
- presentation style for 'wide' prototypes; see\r
- funcsynopsis.tabular.threshold. (HTML only right now, I think, FO support,\r
- uh, real soon now.)\r
-\r
- ● Reworked support for difference marking; toned down the colors a bit and\r
- added a “system.head.content” template so that the diff CSS wasn't\r
- overriding “user.head.content”. (Bug #610660)\r
-\r
- ● Added call to the “*.head.content” elements when writing out long\r
- description chunks.\r
-\r
- ● Make sure legalnotice link is correct even when chunking to a different\r
- base.dir.\r
-\r
- ● Use CSS to set viewport characteristics if css.decoration is non-zero, use\r
- div instead of p for making graphic a block element; make figure titles the\r
- default alt text for images in a figure.\r
-\r
- ● Added space-after to list.block.spacing.\r
-\r
- ● Reworked section.level template to give “correct” answer instead of being\r
- off by one.\r
-\r
- ● When processing tables, use the tabstyle attribute as the division class.\r
-\r
- ● Fixed bug in html2xhtml.xsl that was causing the XHTML chunker to output\r
- HTML instead of XHTML.\r
-\r
-Older releases\r
-\r
-To view the release notes for older releases, see http://cvs.sourceforge.net/\r
-viewcvs.py/docbook/xsl/RELEASE-NOTES.xml. Be aware that there were no release\r
-notes for releases prior to the 1.50.0 release.\r
-\r
-About dot-zero releases\r
-\r
-DocBook Project “dot zero” releases should be considered experimental and are\r
-always followed by stable “dot one plus” releases, usually within two or three\r
-weeks. Please help to ensure the stability of “dot one plus” releases by\r
-carefully testing each “dot zero” release and reporting back about any problems\r
-you find.\r
-\r
-It is not recommended that you use a “dot zero” release in a production system.\r
-Instead, you should wait for the “dot one” or greater versions.\r
-\r