1 Release Notes for the DocBook XSL Stylesheets
\r
3 $Revision: 8504 $ $Date: 2009-07-21 07:22:11 -0700 (Tue, 21 Jul 2009) $
\r
7 This release-notes document is available in the following formats: HTML, PDF,
\r
8 plain text; it provides a per-release list of enhancements and changes to the
\r
9 stylesheets’ public APIs (user-configurable parameters) and excludes
\r
10 descriptions of most bug fixes. For a complete list of all changes (including
\r
11 all bug fixes) that have been made since the previous release, see the separate
\r
12 NEWS (plain text) or NEWS.html files. Also available: An online hyperlinked
\r
13 change history (warning: big file) of all changes made over the entire history
\r
16 As with all DocBook Project “dot one plus” releases, this release aspires to be
\r
17 stable (in contrast to dot-zero releases, which are experimental).
\r
19 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
\r
23 Release Notes: 1.75.2
\r
35 Release Notes: 1.75.1
\r
42 Release Notes: 1.75.0
\r
56 Release Notes: 1.74.3
\r
57 Release Notes: 1.74.2
\r
58 Release Notes: 1.74.1
\r
69 Release Notes: 1.74.0
\r
91 Release Notes: 1.73.2
\r
197 About dot-zero releases
\r
199 Release Notes: 1.75.2
\r
201 The following is a list of changes that have been made since the 1.75.1
\r
206 The following changes have been made to the gentext code since the 1.75.1
\r
209 ● dleidert: locale/ja.xml
\r
211 Improved Japanese translation for Note(s). Closes bug #2823965.
\r
213 ● dleidert: locale/pl.xml
\r
215 Polish alphabet contains O with acute accent, not with grave accent. Closes bug #2823964.
\r
217 ● Robert Stayton: locale/ja.xml
\r
219 Fix translation of "index", per bug report 2796064.
\r
221 ● Robert Stayton: locale/is.xml
\r
223 New Icelandic locale file.
\r
227 The following changes have been made to the common code since the 1.75.1
\r
230 ● Norman Walsh: stripns.xsl
\r
232 Support more downconvert cases
\r
234 ● Robert Stayton: titles.xsl
\r
236 Make sure title inside info is used if no other title.
\r
240 The following changes have been made to the fo code since the 1.75.1 release.
\r
242 ● Robert Stayton: pi.xsl
\r
244 Turn off dbfo-need for fop1.extensions also, per bug #2816141.
\r
248 The following changes have been made to the html code since the 1.75.1 release.
\r
250 ● Mauritz Jeanson: titlepage.xsl
\r
252 Output "Copyright" heading in XHTML too.
\r
254 ● Mauritz Jeanson: titlepage.xsl
\r
256 Added stylesheet.result.type test for copyright. Closes bug #2813289.
\r
258 ● Norman Walsh: htmltbl.xsl
\r
260 Remove ambiguity wrt @span, @rowspan, and @colspan
\r
264 The following changes have been made to the manpages code since the 1.75.1
\r
267 ● Mauritz Jeanson: endnotes.xsl
\r
269 Added normalize-space() for ulink content. Closes bug #2793877.
\r
271 ● Mauritz Jeanson: docbook.xsl
\r
273 Added stylesheet.result.type test for copyright. Closes bug #2813289.
\r
277 The following changes have been made to the epub code since the 1.75.1 release.
\r
279 ● Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb
\r
281 Corrected bugs caused by path and file assumptions were not met
\r
283 ● Keith Fahlgren: bin/lib/docbook.rb; docbook.xsl
\r
285 Cleaning up hardcoded values into parameters and fixing Ruby library to pass them properly; all thanks to patch from Liza Daly
\r
289 The following changes have been made to the profiling code since the 1.75.1
\r
292 ● Robert Stayton: profile.xsl
\r
294 Fix bug 2815493 missing exsl.node.set.available parameter.
\r
298 The following changes have been made to the xsl-saxon code since the 1.75.1
\r
301 ● Mauritz Jeanson: src/com/nwalsh/saxon/ColumnUpdateEmitter.java; src/com/
\r
302 nwalsh/saxon/Colum⋯
\r
304 Added fixes so that colgroups in the XHTML namespace are processed properly.
\r
308 The following changes have been made to the xsl-xalan code since the 1.75.1
\r
311 ● Mauritz Jeanson: nbproject/project.xml
\r
313 Added missing NetBeans configuration.
\r
315 Release Notes: 1.75.1
\r
317 This release includes bug fixes.
\r
319 The following is a list of changes that have been made since the 1.75.0
\r
324 The following changes have been made to the fo code since the 1.75.0 release.
\r
326 ● Keith Fahlgren: block.xsl
\r
328 Switching to em dash for character before attribution in epigraph; resolves Bug #2793878
\r
330 ● Robert Stayton: lists.xsl
\r
332 Fixed bug 2789947, id attribute missing on simplelist fo output.
\r
336 The following changes have been made to the html code since the 1.75.0 release.
\r
338 ● Keith Fahlgren: block.xsl
\r
340 Switching to em dash for character before attribution in epigraph; resolves Bug #2793878
\r
342 ● Robert Stayton: lists.xsl
\r
344 Fixed bug 2789678: apply-templates line accidentally deleted.
\r
348 The following changes have been made to the epub code since the 1.75.0 release.
\r
350 ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
\r
352 Added regression and fix to correct "bug" with namespace-prefixed container elements in META-INF/container.xml ; resolves Issue #2790017
\r
354 ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
\r
355 onegraphic.xinclude.xml;⋯
\r
357 Another attempt at flexible named entity and XInclude processing
\r
359 ● Keith Fahlgren: bin/lib/docbook.rb
\r
361 Tweaking solution to Bug #2750442 following regression reported by Michael Wiedmann.
\r
365 The following changes have been made to the params code since the 1.75.0
\r
368 ● Mauritz Jeanson: highlight.source.xml
\r
370 Updated documentation to reflect changes made in r8419.
\r
372 Release Notes: 1.75.0
\r
374 This release includes important bug fixes and adds the following significant
\r
379 Modifications to translations have been made.
\r
383 Added support for some format properties on tables using HTML table markup.
\r
385 Added two new qanda.defaultlabel values so that numbered sections and
\r
386 numbered questions can be distinguished. Satisfies Feature Request #
\r
389 Added code to handle acknowledgements in book and part. The element is
\r
390 processed similarly to dedication. All acknowledgements will appear as
\r
391 front matter, after any dedications.
\r
395 The inclusion of highlighting code has been simplified.
\r
397 Add support for pgwide on informal objects.
\r
399 Added a new parameter, bookmarks.collapse, that controls the initial state
\r
400 of the bookmark tree. Closes FR #1792326.
\r
402 Add support for more dbfo processing instructions.
\r
404 Add new variablelist.term.properties to format terms, per request #
\r
407 Add support for @width on screen and programlisting, fixes bug #2012736.
\r
409 Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.
\r
411 Add writing.mode param for FO output.
\r
415 Convert all calls to class.attribute to calls to common.html.attributes to
\r
416 support dir, lang, and title attributes in html output for all elements.
\r
417 Fulfills feature request #1993833.
\r
419 Inclusion of highlighting code was simplified. Only one import is now
\r
422 Add new param index.links.to.section.
\r
424 Add support for the new index.links.to.section param which permits precise
\r
425 links to indexterms in HTML output rather than to the section title.
\r
429 Slightly more nuanced handling of imageobject alternatives and better
\r
430 support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442
\r
431 reported by Raphael Hertzog.
\r
433 Added a colon after an abstract/title when mapping into the dc:description
\r
434 for OPF metadata in ePub output to help the flat text have more
\r
435 pseudo-semantics (sugestions from Michael Wiedmann)
\r
437 Added DocBook subjectset -> OPF dc:subject mapping and tests
\r
439 Added DocBook date -> OPF dc:date mapping and tests
\r
441 Added DocBook abstract -> OPF dc:description mapping and tests
\r
443 Added --output option to dbtoepub based on user request
\r
447 Add support for generating olink target database for htmlhelp files.
\r
451 Add default setting for @rules attribute on HTML markup tables.
\r
453 Added a new parameter, bookmarks.collapse, that controls the initial state
\r
454 of the bookmark tree. When the parameter has a non-zero value (the
\r
455 default), only the top-level bookmarks are displayed initially. Otherwise,
\r
456 the whole tree of bookmarks is displayed. This is implemented for FOP 0.9X.
\r
457 Closes FR #1792326.
\r
459 Add new variablelist.term.properties to format terms, per request #
\r
462 Add two new qanda.defaultlabel values so that numbered sections and
\r
463 numbered questions can be distinguished. Satisfies Feature Request #
\r
466 Add param to control whether an index entry links to a section title or to
\r
467 the precise location of the indexterm.
\r
469 New attribute list for glossentry in glossary.
\r
471 New parameter to support @width on programlisting and screen.
\r
473 Add attribute-sets for formatting glossary terms and defs.
\r
477 Inclusion of highlighting code was simplified. Only one import is now
\r
480 The following is a list of changes that have been made since the 1.74.3
\r
485 The following changes have been made to the gentext code since the 1.74.3
\r
488 ● Robert Stayton: locale/sv.xml; locale/ja.xml; locale/pl.xml
\r
490 Check in translations of Legalnotice submitted on mailing list.
\r
492 ● Robert Stayton: locale/es.xml
\r
494 Fix spelling errors in Acknowledgements entries.
\r
496 ● Robert Stayton: locale/es.xml
\r
498 Check in translations for 4 elements submitted through docbook-apps
\r
499 message of 14 April 2009.
\r
501 ● David Cramer: locale/zh.xml; locale/ca.xml; locale/ru.xml; locale/ga.xml;
\r
504 Internationalized punctuation in glosssee and glossseealso
\r
506 ● Robert Stayton: Makefile
\r
508 Check in fixes for DSSSL gentext targets from submitted patch #1689633.
\r
510 ● Robert Stayton: locale/uk.xml
\r
512 Check in major update submitted with bug report #2008524.
\r
514 ● Robert Stayton: locale/zh_tw.xml
\r
516 Check in fix to Note string submitted in bug #2441051.
\r
518 ● Robert Stayton: locale/ru.xml
\r
520 Checkin typo fix submitted in bug #2453406.
\r
524 The following changes have been made to the common code since the 1.74.3
\r
527 ● Robert Stayton: gentext.xsl
\r
529 Fix extra generated space when xrefstyle includes 'nopage'.
\r
531 ● Robert Stayton: table.xsl
\r
533 Add support for some format properties on tables using
\r
534 HTML table markup. These include:
\r
535 - frame attribute on table (or uses $default.table.frame parameter).
\r
536 - rules attribute on table (or uses $default.table.rules parameter).
\r
537 - align attribute on td and th
\r
538 - valign attribute on td and th
\r
539 - colspan on td and th
\r
540 - rowspan on td and th
\r
541 - bgcolor on td and th
\r
543 ● Robert Stayton: olink.xsl
\r
545 Add placeholder template to massage olink hot text to make
\r
546 customization easier, per Feature Request 1828608.
\r
548 ● Robert Stayton: targets.xsl
\r
550 Add support for collecting olink targets from a glossary
\r
551 generated from a glossary.collection.
\r
553 ● Robert Stayton: titles.xsl
\r
555 Handle firstterm like glossterm in mode="title.markup".
\r
557 ● Robert Stayton: titles.xsl
\r
559 Add match on info/title in title.markup templates where missing.
\r
561 ● Mauritz Jeanson: titles.xsl
\r
563 Changed "ancestor::title" to "(ancestor::title and (@id or @xml:id))".
\r
564 This enables proper formatting of inline elements in titles in TOCs,
\r
565 as long as these inlines don't have id or xml:id attributes.
\r
567 ● Robert Stayton: labels.xsl
\r
569 Add two new qanda.defaultlabel values so that numbered sections
\r
570 and numbered questions can be distinguished. Satisfies
\r
571 Feature Request #1539045.
\r
573 ● Robert Stayton: stripns.xsl; pi.xsl
\r
575 Convert function-available(exsl:node-set) to use the new param
\r
576 so Xalan bug is isolated.
\r
578 ● Mauritz Jeanson: titles.xsl
\r
580 Added fixes for bugs #2112656 and #1759205:
\r
581 1. Reverted mistaken commits r7485 and r7523.
\r
582 2. Updated the template with match="link" and mode="no.anchor.mode" so that
\r
583 @endterm is used if it exists and if the link has no content.
\r
585 ● Mauritz Jeanson: titles.xsl
\r
587 Added code to handle acknowledgements in book and part. The element is processed
\r
588 similarly to dedication. All acknowledgements will appear as front matter, after
\r
591 ● Robert Stayton: olink.xsl
\r
593 Fix bug #2018717 use.local.olink.style uses wrong gentext context.
\r
595 ● Robert Stayton: olink.xsl
\r
597 Fix bug #1787167 incorrect hot text for some olinks.
\r
599 ● Robert Stayton: common.xsl
\r
601 Fix bug #1669654 Broken output if copyright <year> contains a range.
\r
603 ● Robert Stayton: labels.xsl
\r
605 Fix bug in labelling figure inside appendix inside article inside book.
\r
609 The following changes have been made to the fo code since the 1.74.3 release.
\r
611 ● Jirka Kosek: highlight.xsl
\r
613 Inclusion of highlighting code was simplified. Only one import is now necessary.
\r
615 ● Robert Stayton: fop1.xsl
\r
617 Add the new fop extensions namespace declaration, in case FOP
\r
618 extension functions are used.
\r
620 ● Robert Stayton: formal.xsl
\r
622 Add support for pgwide on informal objects.
\r
624 ● Robert Stayton: docbook.xsl
\r
626 Fixed spurious closing quote on line 134.
\r
628 ● Robert Stayton: docbook.xsl; autoidx-kosek.xsl; autoidx.xsl
\r
630 Convert function-available for node-set() to use
\r
631 new $exsl.node.set.available param in test.
\r
633 ● David Cramer: xref.xsl
\r
635 Suppress extra space after xref when xrefstyle='select: label nopage' (#2740472)
\r
637 ● Mauritz Jeanson: pi.xsl
\r
639 Fixed doc bug for row-height.
\r
641 ● David Cramer: glossary.xsl
\r
643 Internationalized punctuation in glosssee and glossseealso
\r
645 ● Robert Stayton: param.xweb; param.ent; htmltbl.xsl; table.xsl
\r
647 Add support for some format properties on tables using
\r
648 HTML table markup. These include:
\r
649 - frame attribute on table (or uses $default.table.frame parameter).
\r
650 - rules attribute on table (or uses $default.table.rules parameter).
\r
651 - align attribute on td and th
\r
652 - valign attribute on td and th
\r
653 - colspan on td and th
\r
654 - rowspan on td and th
\r
655 - bgcolor on td and th
\r
657 ● Robert Stayton: table.xsl
\r
659 Add support bgcolor in td and th
\r
660 elements in HTML table markup.
\r
662 ● Robert Stayton: htmltbl.xsl
\r
664 Add support for colspan and rowspan and bgcolor in td and th
\r
665 elements in HTML table markup.
\r
667 ● Robert Stayton: param.xweb
\r
669 Fix working of page-master left and right margins.
\r
671 ● Mauritz Jeanson: param.xweb; param.ent; fop1.xsl
\r
673 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
675 ● Robert Stayton: table.xsl; pi.xsl
\r
677 Add support for dbfo row-height processing instruction, like that in dbhtml.
\r
679 ● Robert Stayton: lists.xsl
\r
681 Add support for dbfo keep-together processing instruction for
\r
682 entire list instances.
\r
684 ● Robert Stayton: lists.xsl; block.xsl
\r
686 Add support fo dbfo keep-together processing instruction to
\r
687 more blocks like list items and paras.
\r
689 ● Robert Stayton: lists.xsl; param.xweb; param.ent
\r
691 Add new variablelist.term.properties to format terms, per request # 1968513.
\r
693 ● Robert Stayton: inline.xsl
\r
695 In simple.xlink, rearrange order of processing.
\r
697 ● Robert Stayton: xref.xsl
\r
699 Handle firstterm like glossterm in mode="xref-to".
\r
701 ● Robert Stayton: glossary.xsl; xref.xsl; pi.xsl; footnote.xsl
\r
703 Implement simple.xlink for glosssee and glossseealso so they can use
\r
704 other types of linking besides otherterm.
\r
706 ● Robert Stayton: qandaset.xsl
\r
708 Add two new qanda.defaultlabel values so that numbered sections and numbered questions can be distinguished. Satisfies Feature Request #1539045.
\r
710 ● Robert Stayton: titlepage.xsl
\r
712 For the book title templates, I changed info/title to book/info/title
\r
713 so other element's titles will not be affected.
\r
715 ● Robert Stayton: xref.xsl; verbatim.xsl
\r
717 Use param exsl.node.set.available to test for function.
\r
719 ● Robert Stayton: param.xweb; param.ent; footnote.xsl
\r
721 Start using new param exsl.node.set.available to work around Xalan bug.
\r
723 ● Robert Stayton: titlepage.templates.xml
\r
725 Add comment on use of t:predicate for editor to prevent
\r
726 extra processing of multiple editors. Fixes bug 2687842.
\r
728 ● Robert Stayton: xref.xsl; autoidx.xsl
\r
730 An indexterm primary, secondary, or tertiary element with an id or xml:id
\r
731 now outputs that ID, so that index entries can be cross referenced to.
\r
733 ● Mauritz Jeanson: synop.xsl
\r
735 Added modeless template for ooclass|oointerface|ooexception.
\r
736 Closes bug #1623468.
\r
738 ● Robert Stayton: xref.xsl
\r
740 Add template with match on indexterm in mode="xref-to" to fix bug 2102592.
\r
742 ● Robert Stayton: xref.xsl
\r
744 Now xref to qandaentry will use the label element in a question for
\r
745 the link text if it has one.
\r
747 ● Robert Stayton: inline.xsl
\r
749 Add id if specified from @id to output for quote and phrase so
\r
750 they can be xref'ed to.
\r
752 ● Robert Stayton: xref.xsl
\r
754 Add support for xref to phrase, simpara, anchor, and quote.
\r
755 This assumes the author specifies something using xrefstyle since
\r
756 the elements don't have ordinary link text.
\r
758 ● Robert Stayton: toc.xsl
\r
760 Fix bug in new toc templates.
\r
762 ● Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl;
\r
763 titlepage.templates⋯
\r
765 Added code to handle acknowledgements in book and part. The element is processed
\r
766 similarly to dedication. All acknowledgements will appear as front matter, after
\r
769 ● Robert Stayton: toc.xsl
\r
771 Rewrite toc templates to support an empty toc or populated toc
\r
772 in all permitted contexts. Same for lot elements.
\r
773 This fixes bug #1595969 for FO outputs.
\r
775 ● Robert Stayton: index.xsl
\r
777 Fix indents for seealsoie so they are consistent.
\r
779 ● Mauritz Jeanson: param.xweb
\r
781 Removed duplicate (monospace.font.family).
\r
783 ● Robert Stayton: param.xweb; param.ent
\r
785 Add glossentry.list.item.properties.
\r
787 ● Robert Stayton: param.xweb; param.ent
\r
789 Add monospace.verbatim.font.width param to support @width on programlisting.
\r
791 ● Robert Stayton: verbatim.xsl
\r
793 Put programlisting in fo:block-container with writing-mode="lr-tb"
\r
794 when text direction is right to left because all program languages
\r
797 ● Robert Stayton: verbatim.xsl
\r
799 Add support for @width on screen and programlisting, fixes bug #2012736.
\r
801 ● Robert Stayton: xref.xsl
\r
803 Fix bug #1973585 xref to para with xrefstyle not handled correctly.
\r
805 ● Mauritz Jeanson: block.xsl
\r
807 Added support for acknowledgements in article.
\r
808 Support in book/part remains to be added.
\r
810 ● Robert Stayton: xref.xsl
\r
812 Fix bug #1787167 incorrect hot text for some olinks.
\r
814 ● Robert Stayton: fo.xsl
\r
816 Add writing-mode="tb-rl" as well since some XSL-FO processors support it.
\r
818 ● Robert Stayton: autotoc.xsl; lists.xsl; glossary.xsl; fo.xsl; table.xsl;
\r
821 Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.
\r
822 Changed instances of margin-left to margin-{$direction.align.start}
\r
823 and margin-right to margin-{$direction.align.end}. Those direction.align
\r
824 params are computed from the writing mode value in each locale's
\r
825 gentext key named 'writing-mode', introduced in 1.74.3 to add
\r
826 right-to-left support to HTML outputs.
\r
828 ● Robert Stayton: param.xweb; param.ent
\r
830 Add attribute-sets for formatting glossary terms and defs.
\r
832 ● Robert Stayton: param.xweb; param.ent
\r
834 Add writing.mode param for FO output.
\r
836 ● Robert Stayton: autotoc.xsl
\r
838 Fix bug 1546008: in qandaentry in a TOC, use its blockinfo/titleabbrev or blockinfo/title
\r
839 instead of question, if available. For DocBook 5, use the info versions.
\r
841 ● Keith Fahlgren: verbatim.xsl
\r
843 Add better pointer to README for XSLTHL
\r
845 ● Keith Fahlgren: verbatim.xsl
\r
847 More tweaking the way that XSLTHL does or does not get called
\r
849 ● Keith Fahlgren: verbatim.xsl
\r
851 Alternate attempt at sanely including/excluding XSLTHT code
\r
855 The following changes have been made to the html code since the 1.74.3 release.
\r
857 ● Robert Stayton: lists.xsl
\r
859 Removed redundant lang and title attributes on list element inside
\r
860 div element for lists.
\r
862 ● Robert Stayton: inline.xsl; titlepage.xsl; division.xsl; toc.xsl;
\r
863 sections.xsl; table.xsl;⋯
\r
865 Convert all calls to class.attribute to calls to common.html.attributes
\r
866 to support dir, lang, and title attributes in html output for all elements.
\r
867 Fulfills feature request #1993833.
\r
869 ● Robert Stayton: chunk-common.xsl
\r
871 Fix bug #2750253 wrong links in list of figures in chunk.html
\r
872 when target html is in a subdirectory and dbhtml filename used.
\r
874 ● Jirka Kosek: highlight.xsl
\r
876 Inclusion of highlighting code was simplified. Only one import is now necessary.
\r
878 ● Robert Stayton: chunk-common.xsl; chunktoc.xsl; docbook.xsl;
\r
879 chunk-changebars.xsl; autoidx⋯
\r
881 Convert function-available for node-set() to use
\r
882 new $exsl.node.set.available param in test.
\r
884 ● Mauritz Jeanson: pi.xsl
\r
886 Fixed doc bug for row-height.
\r
888 ● David Cramer: glossary.xsl
\r
890 Internationalized punctuation in glosssee and glossseealso
\r
892 ● Robert Stayton: lists.xsl; html.xsl; block.xsl
\r
894 More elements get common.html.attributes.
\r
895 Added locale.html.attributes template which does the lang,
\r
896 dir, and title attributes, but not the class attribute
\r
897 (used on para, for example).
\r
899 ● Robert Stayton: lists.xsl
\r
901 Replace more literal class atts with mode="class.attribute" to support
\r
902 easier customization.
\r
904 ● Robert Stayton: glossary.xsl
\r
906 Support olinking in glosssee and glossseealso.
\r
908 ● Robert Stayton: inline.xsl
\r
910 In simple.xlink, rearrange order of processing.
\r
912 ● Robert Stayton: xref.xsl
\r
914 Handle firstterm like glossterm in mode="xref-to".
\r
916 ● Robert Stayton: lists.xsl; html.xsl; block.xsl
\r
918 Added template named common.html.attributes to output
\r
919 class, title, lang, and dir for most elements.
\r
920 Started adding it to some list and block elements.
\r
922 ● Robert Stayton: qandaset.xsl
\r
924 Add two new qanda.defaultlabel values so that numbered sections
\r
925 and numbered questions can be distinguished. Satisfies
\r
926 Feature Request #1539045.
\r
928 ● Robert Stayton: param.xweb; chunk-code.xsl; param.ent; xref.xsl;
\r
929 chunkfast.xsl; verbatim.x⋯
\r
931 Use new param exsl.node.set.available to test, handles Xalan bug.
\r
933 ● Robert Stayton: autoidx.xsl
\r
935 Use named anchors for primary, secondary, and tertiary ids so
\r
936 duplicate entries with different ids can still have an id output.
\r
938 ● Robert Stayton: param.xweb; param.ent
\r
940 Add new param index.links.to.section.
\r
942 ● Robert Stayton: xref.xsl; autoidx.xsl
\r
944 Pass through an id on primary, secondary, or tertiary to
\r
945 the index entry, so that one could link to an index entry.
\r
946 You can't link to the id on an indexterm because that is
\r
947 used to place the main anchor in the text flow.
\r
949 ● Robert Stayton: autoidx.xsl
\r
951 Add support for the new index.links.to.section param which permits
\r
952 precise links to indexterms in HTML output rather than to
\r
955 ● Mauritz Jeanson: synop.xsl
\r
957 Added modeless template for ooclass|oointerface|ooexception.
\r
958 Closes bug #1623468.
\r
960 ● Robert Stayton: qandaset.xsl
\r
962 Make sure a qandaset has an anchor, even when it has no title,
\r
963 because it may be referenced in a TOC or xref.
\r
964 Before, the anchor was output by the title, but there was no
\r
965 anchor if there was no title.
\r
967 ● Robert Stayton: xref.xsl
\r
969 Add a template for indexterm with mode="xref-to" to fix bug 2102592.
\r
971 ● Robert Stayton: xref.xsl
\r
973 Now xref to qandaentry will use the label element in a question for
\r
974 the link text if it has one.
\r
976 ● Robert Stayton: qandaset.xsl; html.xsl
\r
978 Create separate templates for computing label of question and answer
\r
979 in a qandaentry, so such can be used for the alt text of an xref
\r
982 ● Robert Stayton: inline.xsl; xref.xsl
\r
984 Now support xref to phrase, simpara, anchor, and quote,
\r
985 most useful when an xrefstyle is used.
\r
987 ● Robert Stayton: toc.xsl
\r
989 Rewrite toc templates to support an empty toc or populated toc
\r
990 in all permitted contexts. Same for lot elements.
\r
991 This fixes bug #1595969 for HTML outputs.
\r
993 ● Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl;
\r
994 titlepage.templates⋯
\r
996 Added code to handle acknowledgements in book and part. The element is processed
\r
997 similarly to dedication. All acknowledgements will appear as front matter, after
\r
1000 ● Robert Stayton: index.xsl
\r
1002 Rewrote primaryie, secondaryie and tertiaryie templates to handle
\r
1003 nesting of elements and seeie and seealsoie, as reported in
\r
1006 ● Robert Stayton: autotoc.xsl
\r
1008 Fix simplesect in toc problem.
\r
1010 ● Robert Stayton: verbatim.xsl
\r
1012 Add support for @width per bug report #2012736.
\r
1014 ● Robert Stayton: formal.xsl; htmltbl.xsl
\r
1016 Fix bug #1787140 HTML tables not handling attributes correctly.
\r
1018 ● Robert Stayton: param.xweb
\r
1020 Move writing-mode param.
\r
1022 ● Keith Fahlgren: refentry.xsl
\r
1024 Remove a nesting of <p> inside <p> for refclass (made XHTML* invalid, made HTML silly)
\r
1026 ● Robert Stayton: table.xsl
\r
1028 Fix bug #1945872 to allow passthrough of colwidth values to
\r
1029 HTML table when no tablecolumns.extension is available and
\r
1030 when no instance of * appears in the table's colspecs.
\r
1032 ● Mauritz Jeanson: block.xsl
\r
1034 Added support for acknowledgements in article.
\r
1035 Support in book/part remains to be added.
\r
1037 ● Robert Stayton: chunk-common.xsl
\r
1039 Fix bug #1787167 incorrect hot text for some olinks.
\r
1041 ● Robert Stayton: qandaset.xsl
\r
1043 Fix bug 1546008: in qandaentry in a TOC, use its blockinfo/titleabbrev or blockinfo/title
\r
1044 instead of question, if available. For DocBook 5, use the info versions.
\r
1046 ● Robert Stayton: chunktoc.xsl
\r
1048 Add support for generating olink database when using chunktoc.xsl.
\r
1050 ● Keith Fahlgren: verbatim.xsl
\r
1052 Add better pointer to README for XSLTHL
\r
1054 ● Keith Fahlgren: verbatim.xsl
\r
1056 Another stab at fixing the stupid XSLTHT includes across processors (Saxon regression reported by Sorin Ristache)
\r
1058 ● Keith Fahlgren: verbatim.xsl
\r
1060 More tweaking the way that XSLTHL does or does not get called
\r
1062 ● Keith Fahlgren: verbatim.xsl
\r
1064 Alternate attempt at sanely including/excluding XSLTHT code
\r
1068 The following changes have been made to the manpages code since the 1.74.3
\r
1071 ● Robert Stayton: table.xsl
\r
1073 Convert function-available test for node-set() function to
\r
1074 test of $exsl.node.set.available param.
\r
1076 ● Mauritz Jeanson: lists.xsl
\r
1078 Added a template for bibliolist. Closes bug #1815916.
\r
1082 The following changes have been made to the epub code since the 1.74.3 release.
\r
1084 ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
\r
1085 onegraphic.xinclude.xml;⋯
\r
1087 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
1089 ● Keith Fahlgren: docbook.xsl
\r
1091 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
1093 ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/
\r
1096 Correctly set dc:language in OPF metadata when i18nizing. Closes Bug #2755150
\r
1098 ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
\r
1100 Corrected namespace declarations for literal XHTML elements to make them serialize "normally"
\r
1102 ● Keith Fahlgren: docbook.xsl
\r
1104 Be a little bit more nuanced about dates
\r
1106 ● Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
\r
1109 Add DocBook subjectset -> OPF dc:subject mapping and tests
\r
1111 ● Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
\r
1114 Add DocBook date -> OPF dc:date mapping and tests
\r
1116 ● Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
\r
1119 Add DocBook abstract -> OPF dc:description mapping and tests
\r
1121 ● Robert Stayton: docbook.xsl
\r
1123 Check in patch submitted by user to add opf:file-as attribute
\r
1124 to dc:creator element.
\r
1126 ● Keith Fahlgren: bin/dbtoepub
\r
1128 Adding --output option to dbtoepub based on user request
\r
1130 ● Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb
\r
1132 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
1134 ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
\r
1137 Remove a nesting of <p> inside <p> for refclass (made XHTML* invalid, made HTML silly)
\r
1139 ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
\r
1142 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
1146 The following changes have been made to the htmlhelp code since the 1.74.3
\r
1149 ● Robert Stayton: htmlhelp-common.xsl
\r
1151 Add support for generating olink target database for htmlhelp files.
\r
1155 The following changes have been made to the params code since the 1.74.3
\r
1158 ● Robert Stayton: default.table.rules.xml
\r
1160 Add default setting for @rules attribute on HTML markup tables.
\r
1162 ● Mauritz Jeanson: bookmarks.collapse.xml
\r
1164 Added a new parameter, bookmarks.collapse, that controls the initial state
\r
1165 of the bookmark tree. When the parameter has a non-zero value (the default),
\r
1166 only the top-level bookmarks are displayed initially. Otherwise, the whole
\r
1167 tree of bookmarks is displayed.
\r
1169 This is implemented for FOP 0.9X. Closes FR #1792326.
\r
1171 ● Robert Stayton: variablelist.term.properties.xml
\r
1173 Add new variablelist.term.properties to format terms, per
\r
1174 request # 1968513.
\r
1176 ● Robert Stayton: qanda.defaultlabel.xml
\r
1178 Add two new qanda.defaultlabel values so that numbered sections
\r
1179 and numbered questions can be distinguished. Satisfies
\r
1180 Feature Request #1539045.
\r
1182 ● Robert Stayton: index.links.to.section.xml
\r
1184 Change default to 1 to match past behavior.
\r
1186 ● Robert Stayton: exsl.node.set.available.xml
\r
1188 Isolate this text for Xalan bug regarding exsl:node-set available.
\r
1189 If it is ever fixed in Xalan, just fix it here.
\r
1191 ● Robert Stayton: index.links.to.section.xml
\r
1193 Add param to control whether an index entry links to
\r
1194 a section title or to the precise location of the
\r
1197 ● Robert Stayton: glossentry.list.item.properties.xml
\r
1199 New attribute list for glossentry in glossary.
\r
1201 ● Robert Stayton: monospace.verbatim.font.width.xml
\r
1203 New parameter to support @width on programlisting and screen.
\r
1205 ● Mauritz Jeanson: highlight.source.xml
\r
1207 Updated and reorganized the description.
\r
1209 ● Robert Stayton: page.margin.outer.xml; page.margin.inner.xml
\r
1211 Add caveat about XEP bug when writing-mode is right-to-left.
\r
1213 ● Robert Stayton: article.appendix.title.properties.xml; writing.mode.xml;
\r
1214 body.start.indent⋯
\r
1216 Change 'left' to 'start' and 'right' to 'end' to support right-to-left
\r
1219 ● Robert Stayton: glossdef.block.properties.xml;
\r
1220 glossdef.list.properties.xml; glossterm.blo⋯
\r
1222 Add attribute-sets for formatting glossary terms and defs.
\r
1224 ● Robert Stayton: glossterm.separation.xml
\r
1226 Clarify the description.
\r
1228 ● Robert Stayton: make.year.ranges.xml
\r
1230 Now handles year element containing a comma or dash without error.
\r
1234 The following changes have been made to the highlighting code since the 1.74.3
\r
1237 ● Jirka Kosek: README
\r
1239 Inclusion of highlighting code was simplified. Only one import is now necessary.
\r
1241 ● Keith Fahlgren: README
\r
1243 Adding XSLTHL readme
\r
1245 ● Keith Fahlgren: common.xsl
\r
1247 Alternate attempt at sanely including/excluding XSLTHT code
\r
1251 The following changes have been made to the xsl-saxon code since the 1.74.3
\r
1254 ● Mauritz Jeanson: src/com/nwalsh/saxon/Text.java
\r
1256 Added a fix that prevents output of extra blank line.
\r
1257 Hopefully this closes bug #894805.
\r
1261 The following changes have been made to the xsl-xalan code since the 1.74.3
\r
1264 ● Mauritz Jeanson: src/com/nwalsh/xalan/Text.java
\r
1266 Added a fix that prevents output of extra blank line.
\r
1267 Hopefully this closes bug #894805.
\r
1269 Release Notes: 1.74.3
\r
1271 This release fixes some bugs in the 1.74.2 release.
\r
1273 See highlighting/README for XSLTHL usage instructions.
\r
1275 Release Notes: 1.74.2
\r
1277 This release fixes some bugs in the 1.74.1 release.
\r
1279 Release Notes: 1.74.1
\r
1281 This release includes important bug fixes and adds the following significant
\r
1286 Kirghiz locale added and Chinese translations have been simplified.
\r
1288 Somme support for gentext and right-to-left languages has been added.
\r
1292 Various bugs have been resolved.
\r
1294 Support for a new processing instruction: dbfo funcsynopsis-style has been
\r
1297 Added new param email.mailto.enabled for FO output. Patch from Paolo
\r
1300 Support for documented metadata in fop1 mode has been added.
\r
1304 Support for the latest version of XSLTHL 2.0 and some new language syntaxes
\r
1305 have been added to a variety of outputs.
\r
1309 Added man.output.better.ps.enabled param (zero default). It non-zero, no
\r
1310 such markup is embedded in generated man pages, and no enhancements are
\r
1311 included in the PostScript output generated from those man pages by the man
\r
1316 Support for writing.mode to set text direction and alignment based on
\r
1317 document locale has been added.
\r
1319 Added a new top-level stylesheet module, chunk-changebars.xsl, to be used
\r
1320 for generating chunked output with highlighting based on change
\r
1321 (@revisionflag) markup. The module imports/includes the standard chunking
\r
1322 and changebars templates and contains additional logic for chunked output.
\r
1323 See FRs #1015180 and #1819915.
\r
1327 Covers now look better in Adobe Digital Editions thanks to a patch from
\r
1328 Paul Norton of Adobe
\r
1330 Cover handling now more generic (including limited DocBook 5.0 cover
\r
1331 support thanks to patch contributed by Liza Daly.
\r
1333 Cover markup now carries more reliably into files destined for .mobi and
\r
1336 dc:identifiers are now generated from more types of numbering schemes.
\r
1338 Both SEO and semantic structure of chunked ePub output by ensuring that we
\r
1339 always send out one and only one h1 in each XHTML chunk.
\r
1341 Primitive support for embedding a single font added.
\r
1343 Support for embedding a CSS customizations added.
\r
1347 Support for imagedata-metadata and table as images added.
\r
1349 Support for imagedata-metadata and legalnotice as images added.
\r
1353 man.output.better.ps.enabled added for Manpages output
\r
1355 writing.mode.xml added to set text direction.
\r
1357 Added new param email.mailto.enabled for FO output. Patch from Paolo
\r
1358 Borelli. Closes #2086321.
\r
1360 highlight.source upgraded to support the latest version of XSLTHL 2.0.
\r
1362 The following is a list of changes that have been made since the 1.74.0
\r
1367 The following changes have been made to the gentext code since the 1.74.0
\r
1370 ● Michael(tm) Smith: locale/ky.xml; Makefile
\r
1372 new Kirghiz locale from Ilyas Bakirov
\r
1374 ● Mauritz Jeanson: locale/en.xml
\r
1376 Added "Acknowledgements".
\r
1378 ● Dongsheng Song: locale/zh_cn.xml
\r
1380 Simplified Chinese translation.
\r
1382 ● Robert Stayton: locale/lv.xml; locale/ca.xml; locale/pt.xml; locale/tr.xml;
\r
1385 Add writing-mode gentext string to support right-to-left languages.
\r
1389 The following changes have been made to the fo code since the 1.74.0 release.
\r
1391 ● David Cramer: footnote.xsl
\r
1393 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
1395 ● Mauritz Jeanson: spaces.xsl
\r
1397 Convert spaces to fo:leader also in elements in the DB 5 namespace.
\r
1399 ● Mauritz Jeanson: pi.xsl; synop.xsl
\r
1401 Added support for a new processing instruction: dbfo funcsynopsis-style.
\r
1402 Closes bug #1838213.
\r
1404 ● Michael(tm) Smith: inline.xsl; param.xweb; param.ent
\r
1406 Added new param email.mailto.enabled for FO output.
\r
1407 Patch from Paolo Borelli. Closes #2086321.
\r
1409 ● Mauritz Jeanson: docbook.xsl
\r
1411 Added support for document metadata for fop1 (patch #2067318).
\r
1413 ● Jirka Kosek: param.ent; param.xweb; highlight.xsl
\r
1415 Upgraded to support the latest version of XSLTHL 2.0
\r
1416 -- nested markup in highlited code is now processed
\r
1417 -- it is no longer needed to specify path XSLTHL configuration file using Java property
\r
1418 -- support for new languages, including Perl, Python and Ruby was added
\r
1422 The following changes have been made to the html code since the 1.74.0 release.
\r
1424 ● Robert Stayton: param.xweb; docbook.xsl; param.ent; html.xsl
\r
1426 Add support for writing.mode to set text direction and alignment based on document locale.
\r
1428 ● Mauritz Jeanson: chunk-changebars.xsl
\r
1430 Added a new top-level stylesheet module, chunk-changebars.xsl, to be
\r
1431 used for generating chunked output with highlighting based on change
\r
1432 (@revisionflag) markup. The module imports/includes the standard chunking
\r
1433 and changebars templates and contains additional logic for chunked output.
\r
1434 See FRs #1015180 and #1819915.
\r
1438 The following changes have been made to the manpages code since the 1.74.0
\r
1441 ● Michael(tm) Smith: docbook.xsl
\r
1443 Put the following at the top of generated roff for each page:
\r
1445 purpose is to explicitly tell AT&T troff that the page needs to be
\r
1446 pre-processed through tbl(1); groff can figure it out
\r
1447 automatically, but apparently AT&T troff needs to be explicitly told
\r
1451 The following changes have been made to the epub code since the 1.74.0 release.
\r
1453 ● Keith Fahlgren: docbook.xsl
\r
1455 Patch from Paul Norton of Adobe to get covers to look better in Adobe Digital Editions
\r
1457 ● Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
\r
1458 v5cover.xml; bin/spec/sp⋯
\r
1460 Patch contributed by Liza Daly to make ePub cover handling more generic. Additionally
\r
1461 DocBook 5.0's <cover> now has some limited support:
\r
1463 - should reference a cover in the OPF guide for a DocBook 5.0 test document
\r
1465 ● Keith Fahlgren: bin/spec/files/isbn.xml; bin/spec/files/issn.xml; bin/spec/
\r
1468 Liza Daly reported that the dc:identifer-generation code was garbage (she was right).
\r
1471 - should include at least one dc:identifier
\r
1472 - should include an ISBN as URN for dc:identifier if an ISBN was in the metadata
\r
1473 - should include an ISSN as URN for dc:identifier if an ISSN was in the metadata
\r
1474 - should include an biblioid as a dc:identifier if an biblioid was in the metadata
\r
1475 - should include a URN for a biblioid with @class attribute as a dc:identifier if an biblioid was in the metadata
\r
1477 ● Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb
\r
1479 Improve both SEO and semantic structure of chunked ePub output by ensuring that
\r
1480 we always send out one and only one h1 in each XHTML chunk.
\r
1483 - should include one and only one <h1> in each HTML file in rendered ePub files
\r
1485 - should include one and only one <h1> in each HTML file in rendered ePub files
\r
1486 for <book>s even if they do not have section markup
\r
1488 ● Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
\r
1491 Adding better support for covers in epub files destined for .mobi and the Kindle
\r
1493 ● Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/
\r
1494 DejaVuSerif.otf; docbook.⋯
\r
1496 Adding primitive support for embedding a single font
\r
1498 ● Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/
\r
1499 test_cust.xsl; bin/spec/e⋯
\r
1501 Adding support for user-specified customization layers in dbtoepub
\r
1503 ● Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/
\r
1504 docbook.rb; bin/s⋯
\r
1506 Adding CSS support to .epub target & dbtoepub:
\r
1507 -c, --css [FILE] Use FILE for CSS on generated XHTML.
\r
1512 - should include a CSS link in HTML files when a CSS file has been provided
\r
1513 - should include CSS file in .epub when a CSS file has been provided
\r
1514 - should include a CSS link in OPF file when a CSS file has been provided
\r
1518 The following changes have been made to the roundtrip code since the 1.74.0
\r
1521 ● Steve Ball: blocks2dbk.xsl; template.xml; template.dot
\r
1523 added support for imagedata-metadata
\r
1524 added support for table as images
\r
1526 ● Steve Ball: blocks2dbk.xsl; normalise2sections.xsl; sections2blocks.xsl
\r
1528 Improved support for personname inlines.
\r
1530 ● Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml
\r
1532 Added support for legalnotice.
\r
1534 ● Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl
\r
1536 added support for orgname in author
\r
1538 ● Steve Ball: specifications.xml; supported.xml; blocks2dbk.xsl;
\r
1539 wordml2normalise.xsl; dbk2w⋯
\r
1541 Updated specification.
\r
1542 to-DocBook: add cols attribute to tgroup
\r
1543 from-DocBook: fix for blockquote title
\r
1547 The following changes have been made to the params since the 1.74.0 release.
\r
1549 ● The change was to add man.output.better.ps.enabled parameter, with its
\r
1550 default value set to zero. If the value of the man.output.better.ps.enabled
\r
1551 parameter is non-zero, certain markup is embedded in each generated man
\r
1552 page such that PostScript output from the man -Tps command for that page
\r
1553 will include a number of enhancements designed to improve the quality of
\r
1554 that output. If man.output.better.ps.enabled is zero (the default), no such
\r
1555 markup is embedded in generated man pages, and no enhancements are included
\r
1556 in the PostScript output generated from those man pages by the man -Tps
\r
1557 command. WARNING: The enhancements provided by this parameter rely on
\r
1558 features that are specific to groff (GNU troff) and that are not part of
\r
1559 "classic" AT&T troff or any of its derivatives. Therefore, any man pages
\r
1560 you generate with this parameter enabled will be readable only on systems
\r
1561 on which the groff (GNU troff) program is installed, such as GNU/Linux
\r
1562 systems. The pages will not not be readable on systems on with the classic
\r
1563 troff (AT&T troff) command is installed. NOTE: The value of this parameter
\r
1564 only affects PostScript output generated from the man command. It has no
\r
1565 effect on output generated using the FO backend. TIP: You can generate
\r
1566 PostScript output for any man page by running the following command: man
\r
1567 FOO -Tps > FOO.ps You can then generate PDF output by running the following
\r
1568 command: ps2pdf FOO.ps
\r
1570 ● Robert Stayton: writing.mode.xml
\r
1572 writing mode param used to set text direction.
\r
1574 ● Michael(tm) Smith: email.mailto.enabled.xml
\r
1576 Added new param email.mailto.enabled for FO output.
\r
1577 Patch from Paolo Borelli. Closes #2086321.
\r
1579 ● Jirka Kosek: highlight.source.xml; highlight.xslthl.config.xml
\r
1581 Upgraded to support the latest version of XSLTHL 2.0
\r
1582 -- nested markup in highlited code is now processed
\r
1583 -- it is no longer needed to specify path XSLTHL configuration file using Java property
\r
1584 -- support for new languages, including Perl, Python and Ruby was added
\r
1588 The following changes have been made to the highlighting code since the 1.74.0
\r
1591 ● Jirka Kosek: cpp-hl.xml; c-hl.xml; tcl-hl.xml; php-hl.xml; common.xsl;
\r
1592 perl-hl.xml; delphi⋯
\r
1594 Upgraded to support the latest version of XSLTHL 2.0
\r
1595 -- nested markup in highlited code is now processed
\r
1596 -- it is no longer needed to specify path XSLTHL configuration file using Java property
\r
1597 -- support for new languages, including Perl, Python and Ruby was added
\r
1599 Release Notes: 1.74.0
\r
1601 This release includes important bug fixes and adds the following significant
\r
1606 Paul Norton (Adobe) and Keith Fahlgren(O'Reilly Media) have donated code
\r
1607 that generates .epub documents from DocBook input. An alpha-reference
\r
1608 implementation in Ruby has also been provided.
\r
1610 .epub is an open standard of the The International Digital Publishing Forum
\r
1611 (IDPF), a the trade and standards association for the digital publishing
\r
1614 Read more about this target in epub/README
\r
1618 To support .epub output, a strict XHTML 1.1 target has been added. The
\r
1619 stylesheets for this output are generated and are quite similar to the
\r
1624 A number of locales have been updated.
\r
1626 Roundtrip improvements
\r
1628 Table, figure, template syncronization, and character style improvements
\r
1629 have been made for WordML & Pages. Support added for OpenOffice.org.
\r
1631 First implementation of a libxslt extension
\r
1633 A stylesheet extension for libxslt, written in Python, has been added. The
\r
1634 extension is a function for adjusting column widths in CALS tables. See
\r
1635 extensions/README.LIBXSLT for more information.
\r
1637 The following is a list of changes that have been made since the 1.73.2
\r
1642 The following changes have been made to the gentext code since the 1.73.2
\r
1645 ● Michael(tm) Smith: locale/id.xml
\r
1647 Checked in changes to Indonesion locale submitted by Euis Luhuanam a long time ago.
\r
1649 ● Michael(tm) Smith: locale/lt.xml
\r
1651 Added changes to Lithuanian locate submitted a long time back by Nikolajus Krauklis.
\r
1653 ● Michael(tm) Smith: locale/hu.xml
\r
1655 fixed error in lowercase.alpha definition in Hungarian locale
\r
1657 ● Michael(tm) Smith: locale/nb.xml
\r
1659 Corrected language code for nb locale, and restored missing "startquote" key.
\r
1661 ● Michael(tm) Smith: locale/ja.xml
\r
1663 Committed changes to ja locale file, from Akagi Kobayashi. Adds bracket quotes around many xref instances that did not have them
\r
1666 ● Michael(tm) Smith: Makefile
\r
1668 "no" locale is now "nb"
\r
1670 ● Michael(tm) Smith: locale/nb.xml
\r
1672 Update Norwegian Bokmål translation. Thanks to Hans F. Nordhaug.
\r
1674 ● Michael(tm) Smith: locale/no.xml; locale/nb.xml
\r
1676 per message from Hans F. Nordhaug, correct identifier for
\r
1677 Norwegian Bokmål is "nb" (not "no") and has been for quite some
\r
1680 ● Michael(tm) Smith: locale/ja.xml
\r
1682 Converted ja.xml source file to use real unicode characters so
\r
1683 that the actual glyphs so up when you edit it in a text editor
\r
1684 (instead of the character references).
\r
1686 ● Michael(tm) Smith: locale/ja.xml
\r
1688 Checked in changes to ja.xml locale file. Thanks to Akagi Kobayashi.
\r
1690 ● Michael(tm) Smith: locale/it.xml
\r
1692 Changes from Federico Zenith
\r
1694 ● Dongsheng Song: locale/zh_cn.xml
\r
1696 Added missing translations.
\r
1700 The following changes have been made to the common code since the 1.73.2
\r
1703 ● Michael(tm) Smith: l10n.xsl
\r
1705 Added new template "l10.language.name" for retrieving the
\r
1706 English-language name of the lang setting of the current document.
\r
1707 Closes #1916837. Thanks to Simon Kennedy.
\r
1709 ● Michael(tm) Smith: refentry.xsl
\r
1711 fixed syntax error
\r
1713 ● Michael(tm) Smith: refentry.xsl
\r
1715 fixed a couple of typos
\r
1717 ● Michael(tm) Smith: refentry.xsl
\r
1719 refined handling of cases where refentry "source" or "manual"
\r
1720 metadata is missing or when we use fallback content instead. We
\r
1721 now report a Warning if we use fallback content.
\r
1723 ● Michael(tm) Smith: refentry.xsl
\r
1725 don't use refmiscinfo@class=date value as fallback for refentry
\r
1726 "source" or "manual" metadata fields
\r
1728 ● Michael(tm) Smith: refentry.xsl
\r
1730 Made reporting of missing refentry metadata more quiet:
\r
1732 - we no longer report anything if usable-but-not-preferred
\r
1733 metadata is found; we just quietly use whatever we manage to
\r
1736 - we now only report missing "source" metadata if the refentry
\r
1737 is missing BOTH "source name" and "version" metadata; if it
\r
1738 has one but not the other, we use whichever one it has and
\r
1739 don't report anything as missing
\r
1741 The above changes were made because testing with some "real world"
\r
1742 source reveals that some authors are intentionally choosing to use
\r
1743 "non preferred" markup for some metadata, and also choosing to
\r
1744 omit "source name" or "version" metadata in there DocBook XML. So
\r
1745 it does no good to give them pedantic reminders about what they
\r
1748 Also, changed code to cause "fixme" text to be inserted in output
\r
1749 in particular cases:
\r
1751 - if we can't manage to find any "source" metadata at all, we
\r
1752 now put fixme text into the output
\r
1754 - if we can't manage to find any "manual" metadata a all, we
\r
1755 now put fixme text into the output
\r
1757 The "source" and "manual" metadata is necessary information, so
\r
1758 buy putting the fixme stuff in the output, we alert users to the
\r
1759 need problem of it being missing.
\r
1761 ● Michael(tm) Smith: refentry.xsl
\r
1763 When generating manpages output, we no longer report anything if
\r
1764 the refentry source is missing date or pubdate content. In
\r
1765 practice, many users intentionally omit the date from the source
\r
1766 because they explicitly want it to be generated.
\r
1768 ● Michael(tm) Smith: l10n.xml
\r
1770 further change needed for switch from no locale to nb.
\r
1772 ● Michael(tm) Smith: common.xsl
\r
1774 Added support for orgname in authorgroup. Thanks to Camille
\r
1777 ● Michael(tm) Smith: Makefile
\r
1779 "no" locale is now "nb"
\r
1781 ● Mauritz Jeanson: stripns.xsl
\r
1783 Removed the template matching "ng:link|db:link" (in order to make @xlink:show
\r
1784 work with <link> elements). As far as I can tell, this template is no longer needed.
\r
1786 ● Mauritz Jeanson: entities.ent
\r
1788 Moved declaration of comment.block.parents entity to common/entities.ent.
\r
1790 ● Mauritz Jeanson: titles.xsl
\r
1792 Added an update the fix made in revision 7528 (handling of xref/link in no.anchor.mode mode).
\r
1793 Having xref in title is not a problem as long as the target is not an ancestor element.
\r
1794 Closes bug #1838136.
\r
1796 Note that an xref that is in a title and whose target is an ancestor element is still not
\r
1797 rendered in the TOC. This could be considered a bug, but on the other hand I cannot really
\r
1798 see the point in having such an xref in a document.
\r
1800 ● Mauritz Jeanson: titles.xsl
\r
1802 Added a "not(ancestor::title)" test to work around "too many nested
\r
1803 apply-templates" problems when processing xrefs or links in no.anchor.mode mode.
\r
1804 Hopefully, this closes bug #1811721.
\r
1806 ● Mauritz Jeanson: titles.xsl
\r
1808 Removed old template matching "link" in no.anchor.mode mode.
\r
1810 ● Mauritz Jeanson: titles.xsl
\r
1812 Process <link> in no.anchor.mode mode with the same template as <xref>.
\r
1813 Closes bug #1759205 (Empty link in no.anchor.mode mode).
\r
1815 ● Mauritz Jeanson: titles.xsl
\r
1817 In no.anchor.mode mode, do not output anchors for elements that are descendants
\r
1818 of <title>. Previously, having inline elements with @id/@xml:id in <title>s
\r
1819 resulted in anchors both in the TOC and in the main flow. Closes bug #1797492.
\r
1823 The following changes have been made to the fo code since the 1.73.2 release.
\r
1825 ● Mauritz Jeanson: pi.xsl
\r
1827 Updated documentation for keep-together.
\r
1829 ● Mauritz Jeanson: task.xsl
\r
1831 Enabled use of the keep-together PI on task elements.
\r
1833 ● Robert Stayton: index.xsl
\r
1835 FOP1 requires fo:wrapper for inline index entries, not fo:inline.
\r
1837 ● Robert Stayton: index.xsl
\r
1839 Fixed non-working inline.or.block template for indexterm wrappers.
\r
1840 Add fop1 to list of processors using inline.or.block.
\r
1842 ● Mauritz Jeanson: table.xsl
\r
1844 Fixed bug #1891965 (colsep in entytbl not working).
\r
1846 ● Mauritz Jeanson: titlepage.xsl
\r
1848 Added support for title in revhistory. Closes bug #1842847.
\r
1850 ● Mauritz Jeanson: pi.xsl
\r
1852 Small doc cleanup (dbfo float-type).
\r
1854 ● Mauritz Jeanson: titlepage.xsl
\r
1856 Insert commas between multiple copyright holders.
\r
1858 ● Mauritz Jeanson: autotoc.xsl; division.xsl
\r
1860 Added modifications to support nested set elements. See bug #1853172.
\r
1862 ● David Cramer: glossary.xsl
\r
1864 Added normalize-space to xsl:sorts to avoid missorting of glossterms due to stray leading spaces.
\r
1866 ● David Cramer: glossary.xsl
\r
1868 Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry
\r
1870 ● Mauritz Jeanson: inline.xsl
\r
1872 Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,
\r
1873 and the "hot text" is the biblioid itself enclosed in brackets.
\r
1875 ● Mauritz Jeanson: inline.xsl
\r
1877 Moved declaration of comment.block.parents entity to common/entities.ent.
\r
1879 ● Mauritz Jeanson: docbook.xsl
\r
1881 Updated message about unmatched element.
\r
1883 ● Mauritz Jeanson: param.xweb
\r
1885 Added link to profiling chapter of TCG.
\r
1887 ● Mauritz Jeanson: refentry.xsl
\r
1889 Fixed typo (refsynopsysdiv -> refsynopsisdiv).
\r
1891 ● David Cramer: fop.xsl; fop1.xsl; ptc.xsl; xep.xsl
\r
1893 Added test to check generate.index param when generating pdf bookmarks
\r
1895 ● Mauritz Jeanson: graphics.xsl
\r
1897 Added support for MathML in imagedata.
\r
1899 ● Michael(tm) Smith: math.xsl
\r
1901 Removed unnecessary extra test condition in test express that
\r
1902 checks for passivetex.
\r
1904 ● Michael(tm) Smith: math.xsl
\r
1906 Don't use fo:instream-foreign-object if we are processing with
\r
1907 passivetex. Closes #1806899. Thanks to Justus Piater.
\r
1909 ● Mauritz Jeanson: component.xsl
\r
1911 Added code to output a TOC for an appendix in an article when
\r
1912 generate.toc='article/appendix toc'. Closes bug #1669658.
\r
1914 ● Dongsheng Song: biblio-iso690.xsl
\r
1916 Change encoding from "windows-1250" to "UTF-8".
\r
1918 ● Mauritz Jeanson: pi.xsl
\r
1920 Updated documentation for dbfo_label-width.
\r
1922 ● Mauritz Jeanson: lists.xsl
\r
1924 Added support for the dbfo_label-width PI in calloutlists.
\r
1926 ● Robert Stayton: biblio.xsl
\r
1928 Support finding glossary database entries inside bibliodivs.
\r
1930 ● Robert Stayton: formal.xsl
\r
1932 Complete support for <?dbfo pgwide="1"?> for informal
\r
1935 ● Mauritz Jeanson: table.xsl
\r
1937 In the table.block template, added a check for the dbfo_keep-together PI, so that
\r
1938 a table may break (depending on the PI value) at a page break. This was needed
\r
1939 since the outer fo:block that surrounds fo:table has keep-together.within-column="always"
\r
1940 by default, which prevents the table from breaking. Closes bug #1740964 (Titled
\r
1941 table does not respect dbfo PI).
\r
1943 ● Mauritz Jeanson: pi.xsl
\r
1945 Added a few missing @role="tcg".
\r
1947 ● Mauritz Jeanson: inline.xsl
\r
1949 Use normalize-space() in glossterm comparisons (as in html/inline.xsl).
\r
1951 ● Mauritz Jeanson: autoidx.xsl
\r
1953 Removed the [&scope;] predicate from the target variable in the template with name="reference".
\r
1954 This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
\r
1955 with index.on.type=1. Closes bug #1680836.
\r
1957 ● Michael(tm) Smith: inline.xsl; xref.xsl; footnote.xsl
\r
1959 Added capability in FO output for displaying URLs for all
\r
1960 hyperlinks (elements marked up with xlink:href attributes) in the
\r
1961 same way as URLs for ulinks are already handled (which is to say,
\r
1962 either inline or as numbered footnotes).
\r
1964 Background on this change:
\r
1965 DocBook 5 allows "ubiquitous" linking, which means you can make
\r
1966 any element a hyperlink just by adding an xlink:href attribute to
\r
1967 it, with the value set to an external URL. That's in contrast to
\r
1968 DocBook 4, which only allows you to use specific elements (e.g.,
\r
1969 the link and ulink elements) to mark up hyperlinks.
\r
1971 The existing FO stylesheets have a mechanism for handling display
\r
1972 of URLs for hyperlinks that are marked up with ulink, but they did
\r
1973 not handle display of URLs for elements that were marked up with
\r
1974 xlink:href attributes. This change adds handling for those other
\r
1975 elements, enabling the URLs they link to be displayed either
\r
1976 inline or as numbered footnotes (depending on what values the user
\r
1977 has the ulink.show and ulink.footnotes params set to).
\r
1979 Note that this change only adds URL display support for elements
\r
1980 that call the simple.xlink template -- which currently is most
\r
1981 (but not all) inline elements.
\r
1983 This change also moves the URL display handling out of the ulink
\r
1984 template and into a new "hyperlink.url.display" named template;
\r
1985 the ulink template and the simple.xlink named template now both
\r
1986 call the hyperlink.url.display template.
\r
1988 Warning: In the stylesheet code that determines what footnote
\r
1989 number to assign to each footnote or external hyperlink, there is
\r
1990 an XPath expression for determining whether a particular
\r
1991 xlink:href instance is an external hyperlink; that expression is
\r
1992 necessarily a bit complicated and further testing may reveal that
\r
1993 it doesn't handle all cases as expected -- so some refinements to
\r
1994 it may need to be done later.
\r
1996 Closes #1785519. Thanks to Ken Morse for reporting and
\r
1997 troubleshooting the problem.
\r
2001 The following changes have been made to the html code since the 1.73.2 release.
\r
2003 ● Keith Fahlgren: inline.xsl; synop.xsl
\r
2005 Work to make HTML and XHTML targets more valid
\r
2007 ● Keith Fahlgren: table.xsl
\r
2009 Add better handling for tables that have footnotes in the titles
\r
2011 ● Keith Fahlgren: biblio.xsl
\r
2013 Add anchors to bibliodivs
\r
2015 ● Keith Fahlgren: formal.xsl; Makefile; htmltbl.xsl
\r
2017 Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
\r
2018 and Keith Fahlgren of O'Reilly.
\r
2020 This change includes new code for generating the XHTML 1.1 target sanely.
\r
2022 ● Mauritz Jeanson: biblio.xsl
\r
2024 Added code for creating URLs from biblioids with @class="doi" (representing Digital
\r
2025 Object Identifiers). See FR #1934434 and http://doi.org.
\r
2027 To do: 1) Add support for FO output. 2) Figure out how @class="doi" should be handled
\r
2028 for bibliorelation, bibliosource and citebiblioid.
\r
2030 ● Norman Walsh: formal.xsl
\r
2032 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
2034 ● Michael(tm) Smith: Makefile
\r
2036 Added checks and hacks to various makefiles to enable building
\r
2037 under Cygwin. This stuff is ugly and maybe not worth the mess and
\r
2038 trouble, but does seem to work as expected and not break anything
\r
2041 ● Michael(tm) Smith: docbook.xsl
\r
2043 added "exslt" namespace binding to html/docbook.xsl file (in
\r
2044 addition to existing "exsl" binding. reason is because lack of it
\r
2045 seems to cause processing problems when using the profiled
\r
2046 version of the stylsheet
\r
2048 ● Norman Walsh: chunk-common.xsl
\r
2052 ● Mauritz Jeanson: table.xsl
\r
2054 Added a fix to make rowsep apply to the last row of thead in entrytbl.
\r
2056 ● Michael(tm) Smith: synop.xsl
\r
2058 Simplified and streamlined handling of output for ANSI-style
\r
2059 funcprototype output, to correct a problem that was causing type
\r
2060 data to be lost in the output parameter definitions. For example,
\r
2061 for an instance like this:
\r
2062 <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
\r
2063 ... the brackets (indicating an array type) were being dropped.
\r
2065 ● Michael(tm) Smith: synop.xsl
\r
2067 Changed HTML handling of K&R-style paramdef output. The parameter
\r
2068 definitions are no longer output in a table (though the prototype
\r
2069 still is). The reason for the change is that the
\r
2070 kr-tabular-funcsynopsis-mode template was causing type data to be
\r
2071 lost in the output parameter definitions. For example, for an
\r
2072 instance like this:
\r
2073 <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
\r
2074 ... the brackets (indicating an array type) were being dropped.
\r
2075 The easiest way to deal with the problem is to not try to chop up
\r
2076 the parameter definitions and display them in table format, but to
\r
2077 instead just output them as-is. May not look quite as pretty, but
\r
2078 at least we can be sure no information is being lost...
\r
2080 ● Michael(tm) Smith: pi.xsl
\r
2082 updated wording of doc for funcsynopsis-style PI
\r
2084 ● Michael(tm) Smith: param.xweb; param.ent; synop.xsl
\r
2086 Removed the funcsynopsis.tabular.threshold param. It's no longer
\r
2087 being used in the code and hasn't been since mid 2006.
\r
2089 ● Mauritz Jeanson: graphics.xsl
\r
2091 Added support for the img.src.path parameter for SVG graphics. Closes bug #1888169.
\r
2093 ● Mauritz Jeanson: chunk-common.xsl
\r
2095 Added missing space.
\r
2097 ● Norman Walsh: component.xsl
\r
2099 Fix bug where component titles inside info elements were not handled properly
\r
2101 ● Michael(tm) Smith: pi.xsl
\r
2103 Moved dbhtml_stop-chunking embedded doc into alphabetical order,
\r
2104 fixed text of TCG section it see-also'ed.
\r
2106 ● David Cramer: pi.xsl
\r
2108 Added support for <?dbhtml stop-chunking?> processing instruction
\r
2110 ● David Cramer: chunk-common.xsl; pi.xsl
\r
2112 Added support for <?dbhtml stop-chunking?> processing instruction
\r
2114 ● David Cramer: glossary.xsl
\r
2116 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
2118 ● Mauritz Jeanson: inline.xsl
\r
2120 Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,
\r
2121 and the "hot text" is the biblioid itself enclosed in brackets.
\r
2123 ● Mauritz Jeanson: inline.xsl
\r
2125 Added support for @xlink:show in the simple.xlink template. The "new" and "replace"
\r
2126 values are supported (corresponding to values of "_blank" and "_top" for the
\r
2127 ulink.target parameter). I have assumed that @xlink:show should override ulink.target
\r
2128 for external URI links. This closes bugs #1762023 and #1727498.
\r
2130 ● Mauritz Jeanson: inline.xsl
\r
2132 Moved declaration of comment.block.parents entity to common/entities.ent.
\r
2134 ● Mauritz Jeanson: param.xweb
\r
2136 Added link to profiling chapter of TCG.
\r
2138 ● Dongsheng Song: biblio-iso690.xsl
\r
2140 Change encoding from "windows-1250" to "UTF-8".
\r
2142 ● Robert Stayton: biblio.xsl
\r
2144 Add support in biblio collection to entries in bibliodivs.
\r
2146 ● Mauritz Jeanson: pi.xsl
\r
2148 Added missing @role="tcg".
\r
2150 ● Mauritz Jeanson: chunk-common.xsl; titlepage.xsl
\r
2152 Refactored legalnotice/revhistory chunking, so that the use.id.as.filename
\r
2153 parameter as well as the dbhtml_filename PI are taken into account. A new named
\r
2154 template in titlepage.xsl is used to compute the filename.
\r
2156 ● Mauritz Jeanson: chunk-common.xsl; titlepage.xsl
\r
2158 An update to the fix for bug #1790495 (r7433):
\r
2159 The "ln-" prefix is output only when the legalnotice doesn't have an
\r
2160 @id/@xml:id, in which case the stylesheets generate an ID value,
\r
2161 resulting in a filename like "ln-7e0fwgj.html". This is useful because
\r
2162 without the prefix, you wouldn't know that the file contained a legalnotice.
\r
2163 The same logic is also applied to revhistory, using an "rh-" prefix.
\r
2165 ● Mauritz Jeanson: autoidx.xsl
\r
2167 Removed the [&scope;] predicate from the target variable in the template with name="reference".
\r
2168 This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
\r
2169 with index.on.type=1. Closes bug #1680836.
\r
2171 ● Mauritz Jeanson: titlepage.xsl
\r
2173 Added 'ln-' prefix to the name of the legalnotice chunk, in order to match the
\r
2174 <link href"..."> that is output by make.legalnotice.head.links (chunk-common.xsl).
\r
2175 Modified the href attribute on the legalnotice link.
\r
2176 Closes bug #1790495.
\r
2180 The following changes have been made to the manpages code since the 1.73.2
\r
2183 ● Michael(tm) Smith: other.xsl
\r
2185 slightly adjusted spacing around admonition markers
\r
2187 ● Michael(tm) Smith: refentry.xsl; utility.xsl
\r
2189 make sure refsect3 titles are preceded by a line of space, and
\r
2190 make the indenting of their child content less severe
\r
2192 ● Michael(tm) Smith: block.xsl
\r
2194 only indent verbatim environments in TTY output, not in non-TTY/PS
\r
2196 ● Michael(tm) Smith: block.xsl
\r
2198 made another adjustment to correct vertical alignment of admonition marker
\r
2200 ● Michael(tm) Smith: block.xsl; other.xsl
\r
2202 Adjusted/corrected alignment of adominition marker in PS/non-TTY output.
\r
2204 ● Michael(tm) Smith: endnotes.xsl
\r
2206 For PS/non-TTY output, display footnote/endnote numbers in
\r
2209 ● Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl
\r
2211 Changed handling of hanging indents for cmdsynopsis, funcsynopsis,
\r
2212 and synopfragment such that they now look correct in non-TTY/PS
\r
2213 output. We now use the groff \w escape to hang by the actual width
\r
2214 -- in the current font -- of the command, funcdef, or
\r
2215 synopfragment references number (as opposed to hanging by the
\r
2216 number of characters). This rendering in TTY output remains the
\r
2217 same, since the width in monospaced TTY output is the same as the
\r
2218 number of characters.
\r
2220 Also, created new synopsis-block-start and synopsis-block-end
\r
2221 templates to use for cmdsynopsis and funcsynopsis instead of the
\r
2222 corresponding verbatim-* templates.
\r
2224 Along with those changes, also corrected a problem that caused the
\r
2225 content of synopfragment to be dropped, and made a
\r
2226 vertical-spacing change to adjust spacing around table titles and
\r
2227 among sibling synopfragment instances.
\r
2229 ● Michael(tm) Smith: other.xsl
\r
2231 use common l10.language.name template to retrieve English-language name
\r
2233 ● Michael(tm) Smith: synop.xsl; inline.xsl
\r
2235 added comment in code explaining why we don't put filename output
\r
2236 in italic (despite the fact that man guidelines say we should)
\r
2238 ● Michael(tm) Smith: inline.xsl
\r
2240 put filename output in monospace instead of italic
\r
2242 ● Michael(tm) Smith: synop.xsl
\r
2244 put cmdsynopsis in monospace
\r
2246 ● Michael(tm) Smith: inline.xsl
\r
2248 removed template match for literal. template matches for monospace
\r
2249 inlines are all imported from the HTML stylesheet
\r
2251 ● Michael(tm) Smith: block.xsl
\r
2253 don't indent verbatim environments that are descendants of
\r
2254 refsynopsisdiv, not put backgrounds behind them
\r
2256 ● Michael(tm) Smith: inline.xsl
\r
2258 set output of the literal element in monospace. this causes all
\r
2259 inline monospace instances in the git man pages to be set in
\r
2260 monospace (since DocBook XML source for git docs is generated with
\r
2261 asciidoc and asciidoc consistently outputs only <literal> for
\r
2262 inline monospace (not <command> or <code> or anything else).
\r
2263 Of course this only affects non-TTY output...
\r
2265 ● Michael(tm) Smith: utility.xsl
\r
2267 Added inline.monoseq named template.
\r
2269 ● Michael(tm) Smith: utility.xsl
\r
2271 don't bother using a custom register to store the previous
\r
2272 font-family value when setting blocks of text in code font; just
\r
2273 use \F[] .fam with no arg to switch back
\r
2275 ● Michael(tm) Smith: endnotes.xsl
\r
2277 put links in blue in PS output (note that this matches how groff
\r
2278 renders content marked up with the .URL macro)
\r
2280 ● Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent
\r
2282 removed man.links.are.underlined and added man.font.links. Also,
\r
2283 changed the default font formatting for links to bold.
\r
2285 ● Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent
\r
2287 Added new param man.base.url.for.relative.links .. specifies a
\r
2288 base URL for relative links (for ulink, @xlink:href, imagedata,
\r
2289 audiodata, videodata) shown in the generated NOTES section of
\r
2290 man-page output. The value of man.base.url.for.relative.links is
\r
2291 prepended to any relative URI that is a value of ulink url,
\r
2292 xlink:href, or fileref attribute.
\r
2294 If you use relative URIs in link sources in your DocBook refentry
\r
2295 source, and you leave man.base.url.for.relative.links unset, the
\r
2296 relative links will appear "as is" in the NOTES section of any
\r
2297 man-page output generated from your source. That's probably not
\r
2298 what you want, because such relative links are only usable in the
\r
2299 context of HTML output. So, to make the links meaningful and
\r
2300 usable in the context of man-page output, set a value for
\r
2301 man.base.url.for.relative.links that points
\r
2302 to the online version of HTML output generated from your DocBook
\r
2303 refentry source. For example:
\r
2305 <xsl:param name="man.base.url.for.relative.links"
\r
2306 >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param>
\r
2308 ● Michael(tm) Smith: info.xsl
\r
2310 If a source refentry contains a Documentation or DOCUMENTATION
\r
2311 section, don't report it as having missing AUTHOR information.
\r
2312 Also, if missing a contrib/personblurb for a person or org, report
\r
2313 pointers to http://docbook.sf.net/el/personblurb and to
\r
2314 http://docbook.sf.net/el/contrib
\r
2316 ● Michael(tm) Smith: info.xsl
\r
2318 If we encounter an author|editor|othercredit instance that lacks a
\r
2319 personblurb or contrib, report it to the user (because that means
\r
2320 we have no information about that author|editor|othercredit to
\r
2321 display in the generated AUTHOR|AUTHORS section...)
\r
2323 ● Michael(tm) Smith: info.xsl; docbook.xsl; other.xsl
\r
2325 if we can't find any usable author data, emit a warning and insert
\r
2326 a fixme in the output
\r
2328 ● Michael(tm) Smith: info.xsl
\r
2330 fixed bug in indenting of output for contrib instances in AUTHORS
\r
2331 section. Thanks to Daniel Leidert and the fglrx docs for exposing
\r
2334 ● Michael(tm) Smith: block.xsl
\r
2336 for a para or simpara that is the first child of a callout,
\r
2337 suppress the .sp or .PP that would normally be output (because in
\r
2338 those cases, the output goes into a table cell, and the .sp or .PP
\r
2339 markup causes a spurious linebreak before it when displayed
\r
2341 ● Michael(tm) Smith: lists.xsl
\r
2343 Added support for rendering co callouts and calloutlist instances.
\r
2344 So you can now use simple callouts -- marking up programlisting
\r
2345 and such with co instances -- and have the callouts displayed in
\r
2346 man-page output. ("simple callouts" means using co@id and
\r
2347 callout@arearefs pointing to co@id instances; in man/roff output,
\r
2348 we can't/don't support markup that uses areaset and area)
\r
2350 ● Michael(tm) Smith: block.xsl
\r
2352 only put a line of space after a verbatim if it's followed by a
\r
2353 text node or a paragraph
\r
2355 ● Michael(tm) Smith: utility.xsl
\r
2357 put verbatim environments in slightly smaller font in non-TTY
\r
2360 ● Michael(tm) Smith: lists.xsl
\r
2362 minor whitespace-only reformatting of lists.xsl source
\r
2364 ● Michael(tm) Smith: lists.xsl
\r
2366 Made refinements/fixes to output of orderedlist and itemizedlist
\r
2367 -- in part, to get mysql man pages to display correctly. This
\r
2368 change causes a "\c" continuation marker to be added between
\r
2369 listitem markers and contents (to ensure that the content remains
\r
2370 on the same line as the marker when displayed)
\r
2372 ● Michael(tm) Smith: block.xsl
\r
2374 put a line of vertical space after all verbatim output that has
\r
2375 sibling content following it (not just if that sibling content is
\r
2378 ● Michael(tm) Smith: block.xsl
\r
2380 refined spacing around titles for admonitions
\r
2382 ● Michael(tm) Smith: block.xsl; other.xsl
\r
2384 Deal with case of verbatim environments that have a linebreak
\r
2385 after the opening tag. Assumption is that users generally don't
\r
2386 want that linebreak to appear in output, so we do some groff
\r
2387 hackery to mess with vertical spacing and close the space.
\r
2389 ● Michael(tm) Smith: inline.xsl
\r
2391 indexterm instances now produce groff comments like this:
\r
2393 .\" primary: secondary: tertiary
\r
2395 remark instances, if non-empty, now produce groff comments
\r
2397 ● Michael(tm) Smith: charmap.groff.xsl; other.xsl
\r
2399 convert no-break space character to groff "\ \&" (instead of just
\r
2400 "\ "). the reason is that if a space occurs at the end of a line,
\r
2401 our processing causes it to be eaten. a real-world case of this is
\r
2402 the mysql(1) man page. appending the "\&" prevents that
\r
2404 ● Michael(tm) Smith: block.xsl
\r
2406 output "sp" before simpara output, not after it (outputting it
\r
2407 after results in undesirable whitespace in particular cases; for
\r
2408 example, in the hg/mercurial docs
\r
2410 ● Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl
\r
2412 renamed from title-preamble to pinch.together and replaced "sp -1"
\r
2413 between synopsis fragments with call to pinch.together instead
\r
2415 ● Michael(tm) Smith: table.xsl
\r
2417 use title-preamble template for table titles (instead of "sp -1"
\r
2418 hack), and "sp 1" after all tables (instead of just "sp"
\r
2420 ● Michael(tm) Smith: utility.xsl
\r
2422 created title-preamble template for suppressing line spacing after
\r
2425 ● Michael(tm) Smith: info.xsl
\r
2427 further refinement of indenting in AUTHORS section
\r
2429 ● Michael(tm) Smith: block.xsl; other.xsl
\r
2431 refined handling of admonitions
\r
2433 ● Michael(tm) Smith: lists.xsl
\r
2435 Use RS/RE in another place where we had IP ""
\r
2437 ● Michael(tm) Smith: info.xsl
\r
2439 Replace (ab)use of IP with "sp -1" in AUTHORS section with RS/RE
\r
2442 ● Michael(tm) Smith: table.xsl; synop.xsl; info.xsl
\r
2444 changed all instances of ".sp -1n" to ".sp -1"
\r
2446 ● Michael(tm) Smith: other.xsl
\r
2448 add extra line before SH heads only in non-TTY output
\r
2450 ● Michael(tm) Smith: block.xsl
\r
2452 Reworked output for admonitions (caution, important, note, tip,
\r
2453 warning). In TTY output, admonitions now get indented. In non-TTY
\r
2454 output, a colored marker (yellow) is displayed next to them.
\r
2456 ● Michael(tm) Smith: other.xsl
\r
2458 Added BM/EM macros for putting a colored marker in margin next to
\r
2461 ● Michael(tm) Smith: utility.xsl
\r
2463 created make.bold.title template by moving title-bolding part out
\r
2464 from nested-section-title template. This allows the bolding to
\r
2465 also be used by the template for formatting admonitions
\r
2467 ● Michael(tm) Smith: info.xsl
\r
2469 put .br before copyright contents to prevent them from getting run in
\r
2471 ● Michael(tm) Smith: refentry.xsl; other.xsl; utility.xsl
\r
2473 made point size of output for Refsect2 and Refsect3 heads bigger
\r
2475 ● Michael(tm) Smith: other.xsl
\r
2477 put slightly more space between SH head and underline in non-TTY
\r
2480 ● Michael(tm) Smith: param.xweb; param.ent; other.xsl
\r
2482 Added the man.charmap.subset.profile.english parameter and refined
\r
2483 the handling of charmap subsets to differentiate between English
\r
2484 and non-English source.
\r
2486 This way charmap subsets are now handled is this:
\r
2488 If the value of the man.charmap.use.subset parameter is non-zero,
\r
2489 and your DocBook source is not written in English (that is, if its
\r
2490 lang or xml:lang attribute has a value other than en), then the
\r
2491 character-map subset specified by the man.charmap.subset.profile
\r
2492 parameter is used instead of the full roff character map.
\r
2494 Otherwise, if the lang or xml:lang attribute on the root element
\r
2495 in your DocBook source or on the first refentry element in your
\r
2496 source has the value en or if it has no lang or xml:lang
\r
2497 attribute, then the character-map subset specified by the
\r
2498 man.charmap.subset.profile.english parameter is used instead of
\r
2499 man.charmap.subset.profile.
\r
2501 The difference between the two subsets is that
\r
2502 man.charmap.subset.profile provides mappings for characters in
\r
2503 Western European languages that are not part of the Roman
\r
2504 (English) alphabet (ASCII character set).
\r
2506 ● Michael(tm) Smith: other.xsl
\r
2508 Various updates, mainly related to uppercasing SH titles:
\r
2510 - added a "Language: " metadata line to the top comment area of
\r
2511 output man pages, to indicate the language the page is in
\r
2513 - added a "toupper" macro of doing locale-aware uppercasing of
\r
2514 SH titles and cross-references to SH titles; the mechanism
\r
2515 relies on the uppercase.alpha and lowercase.alpha DocBook
\r
2516 gentext keys to do locale-aware uppercasing based on the
\r
2517 language the page is written in
\r
2519 - added a "string.shuffle" template, which provides a library
\r
2520 function for "shuffling" two strings together into a single
\r
2521 string; it takes the first character for the first string, the
\r
2522 first character from second string, etc. The only current use
\r
2523 for it is to generate the argument for the groff tr request
\r
2524 that does string uppercasing.
\r
2526 - added make.tr.uppercase.arg and make.tr.normalcase.arg named
\r
2527 templates for use in generating groff code for uppercasing and
\r
2528 "normal"-casing SH titles
\r
2530 - made the BB/BE "background drawing" macros have effect only in
\r
2533 - output a few comments in the top part of source
\r
2535 ● Michael(tm) Smith: utility.xsl
\r
2537 removed some leftover kruft
\r
2539 ● Michael(tm) Smith: refentry.xsl
\r
2541 To create the name(s) for each man page, we now replace any spaces
\r
2542 in the refname(s) with underscores. This ensures that tools like
\r
2543 lexgrog(1) will be able to parse the name (lexgrog won't parse
\r
2544 names that contain spaces).
\r
2546 ● Michael(tm) Smith: docbook.xsl
\r
2548 Put a comment into source of man page to indicate where the main
\r
2549 content starts. (We now have a few of macro definitions at the
\r
2550 start of the source, so putting this comment in helps those that
\r
2551 might be viewing the source.)
\r
2553 ● Michael(tm) Smith: refentry.xsl
\r
2555 refined mechanism for generating SH titles
\r
2557 ● Michael(tm) Smith: charmap.groff.xsl
\r
2559 Added zcaron, Zcaron, scaron, and Scaron to the groff character map.
\r
2560 This means that generated Finnish man pages will no longer contain
\r
2561 any raw accented characters -- they'll instead by marked up with
\r
2564 ● Michael(tm) Smith: other.xsl; utility.xsl
\r
2566 corrected a regression I introduced about a year ago that caused
\r
2567 dots to be output just as "\." -- instead needs to be "\&." (which
\r
2568 is what it will be now, after this change)
\r
2570 ● Michael(tm) Smith: refentry.xsl
\r
2572 Changed backend handling for generating titles for SH sections and
\r
2573 for cross-references to those sections. This should have no effect
\r
2574 on TTY output (behavior should remain the same hopefully) but
\r
2575 results in titles in normal case (instead of uppercase) in PS
\r
2578 ● Michael(tm) Smith: info.xsl
\r
2580 use make.subheading template to make subheadings for AUTHORS and
\r
2581 COPYRIGHT sections (instead of harcoding roff markup)
\r
2583 ● Michael(tm) Smith: block.xsl
\r
2585 put code font around programlisting etc.
\r
2587 ● Michael(tm) Smith: synop.xsl; docbook.xsl
\r
2589 embed custom macro definitions in man pages, plus wrap synopsis in
\r
2592 ● Michael(tm) Smith: endnotes.xsl
\r
2594 use the make.subheading template to generated SH subheading for
\r
2597 ● Michael(tm) Smith: lists.xsl
\r
2599 Added some templates for generating if-then-else conditional
\r
2600 markup in groff, so let's use those instead of hard-coding it in
\r
2601 multiple places...
\r
2603 ● Michael(tm) Smith: other.xsl; utility.xsl
\r
2605 Initial checkin of some changes related to making PS/PDF output
\r
2606 from "man -l -Tps" look better. The current changes:
\r
2608 - render synopsis and verbatim sections in a monospace/code font
\r
2610 - put a light-grey background behind all programlisting, screen,
\r
2611 and literallayout instances
\r
2613 - prevent SH heads in PS output from being rendered in uppercase
\r
2614 (as they are in console output)
\r
2616 - also display xrefs to SH heads in PS output in normal case
\r
2617 (instead of uppercase)
\r
2619 - draw a line under SH heads in PS output
\r
2621 The changes made to the code to support the above features were:
\r
2623 - added some embedded/custom macros: one for conditionally
\r
2624 upper-casing SH x-refs, one for redefining the SH macro
\r
2625 itself, with some conditional handling for PS output, and
\r
2626 finally a macro for putting a background/screen (filled box)
\r
2627 around a block of text (e.g., a program listing) in PS output
\r
2629 - added utility templates for wrapping blocks of text in code
\r
2630 font; also templates for inline code font
\r
2632 ● Robert Stayton: refentry.xsl
\r
2634 refpurpose nodes now get apply-templates instead of just normalize-space().
\r
2636 ● Michael(tm) Smith: lists.xsl
\r
2638 Fixed alignment of first lined of text for each listitem in
\r
2639 orderedlist output for TTY. Existing code seemed to have been
\r
2640 causing an extra undesirable space to appear.
\r
2642 ● Michael(tm) Smith: lists.xsl
\r
2644 Wrapped some roff conditionals around roff markup for orderedlist
\r
2645 and itemizedlist output, so that the lists look acceptable in PS
\r
2646 output as well as TTY.
\r
2648 ● Michael(tm) Smith: pi.xsl; synop.xsl; param.xweb; param.ent
\r
2650 Added the man.funcsynopsis.style parameter. Has the same effect in
\r
2651 manpages output as the funcsynopsis.style parameter has in HTML
\r
2652 output -- except that its default value is 'ansi' instead of 'kr'.
\r
2654 ● Michael(tm) Smith: synop.xsl
\r
2656 Reworked handling of K&R funcprototype output. It no longer relies
\r
2657 on the HTML kr-tabular templates, but instead just does direct
\r
2658 transformation to roff. For K&R output, it displays the paramdef
\r
2659 output in an indented list following the prototype.
\r
2661 ● Michael(tm) Smith: synop.xsl
\r
2663 Properly integrated handling for K&R output into manpages
\r
2664 stylesheet. The choice between K&R output and ANSI output is
\r
2665 currently controlled through use of the (HTML) funcsynopsis.style
\r
2666 parameter. Note that because the mechanism does currently rely on
\r
2667 funcsynopsis.style, the default in manpages output is now K&R
\r
2668 (because that's the default of that param). But I suppose I ought
\r
2669 to create a man.funcsynopsis.style and make the default for that
\r
2670 ANSI (to preserve the existing default behavior).
\r
2672 ● Michael(tm) Smith: docbook.xsl
\r
2674 added manpages/pi.xsl file
\r
2676 ● Michael(tm) Smith: .cvsignore; pi.xsl
\r
2678 Added "dbman funcsynopsis-style" PI and incorporated it into the
\r
2681 ● Michael(tm) Smith: refentry.xsl
\r
2683 Fixed regression that caused an unescaped dash to be output
\r
2684 between refname and refpurpose content. Closes bug #1894244.
\r
2685 Thanks to Daniel Leidert.
\r
2687 ● Michael(tm) Smith: other.xsl
\r
2689 Fixed problem with dots being escaped in filenames of generated
\r
2690 man files. Closes #1827195. Thanks to Daniel Leidert.
\r
2692 ● Michael(tm) Smith: inline.xsl
\r
2694 Added support for processing structfield (was appearing in roff
\r
2695 output surrounded by HTML <em> tags; fixed so that it gets roff
\r
2696 ital markup). Closes bug #1858329. Thanks to Sam Varshavchik.
\r
2700 The following changes have been made to the epub code since the 1.73.2 release.
\r
2702 ● Keith Fahlgren: bin/spec/README; bin/spec/epub_realbook_spec.rb
\r
2704 'Realbook' spec now passes
\r
2706 ● Keith Fahlgren: bin/dbtoepub; README; bin/spec/README; bin/lib/docbook.rb;
\r
2709 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
2711 ● Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/
\r
2712 docbook.rb; bin/s⋯
\r
2714 Changes to OPF spine to not duplicate idrefs for documents with parts not at the root; regression specs for same
\r
2716 ● Keith Fahlgren: docbook.xsl
\r
2718 Fixing linking to cover @id, distinct from other needs of cover-image-id (again, thanks to Martin Goerner)
\r
2720 ● Keith Fahlgren: docbook.xsl
\r
2722 Updating the title of the toc element in the guide to be more explicit (thanks to Martin Goerner)
\r
2724 ● Keith Fahlgren: bin/spec/examples/amasque_exploded/content.opf; bin/spec/
\r
2725 examples/amasque_⋯
\r
2727 Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
\r
2728 and Keith Fahlgren of O'Reilly.
\r
2730 ● Keith Fahlgren: docbook.xsl
\r
2732 == General epub test support
\r
2734 $ spec -O ~/.spec.opts spec/epub_spec.rb
\r
2737 - should be able to be created
\r
2738 - should fail on a nonexistent file
\r
2739 - should be able to render to a file
\r
2740 - should create a file after rendering
\r
2741 - should have the correct mimetype after rendering
\r
2742 - should be valid .epub after rendering an article
\r
2743 - should be valid .epub after rendering an article without sections
\r
2744 - should be valid .epub after rendering a book
\r
2745 - should be valid .epub after rendering a book even if it has one graphic
\r
2746 - should be valid .epub after rendering a book even if it has many graphics
\r
2747 - should be valid .epub after rendering a book even if it has many duplicated graphics
\r
2748 - should report an empty file as invalid
\r
2749 - should confirm that a valid .epub file is valid
\r
2750 - should not include PDFs in rendered epub files as valid image inclusions
\r
2751 - should include a TOC link in rendered epub files for <book>s
\r
2753 Finished in 20.608395 seconds
\r
2755 15 examples, 0 failures
\r
2758 == Verbose epub test coverage against _all_ of the testdocs
\r
2760 Fails on only (errors truncated):
\r
2762 '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
2763 '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
2766 Finished in 629.89194 seconds
\r
2768 224 examples, 15 failures
\r
2770 224 examples, 15 failures yields 6% failure rate
\r
2774 The following changes have been made to the htmlhelp code since the 1.73.2
\r
2777 ● Mauritz Jeanson: htmlhelp-common.xsl
\r
2779 Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
\r
2780 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
\r
2781 This makes chunk.quietly=1 suppress chunk filename messages also for help
\r
2782 support files (which seems to be what one would expect). See bug #1648360.
\r
2786 The following changes have been made to the eclipse code since the 1.73.2
\r
2789 ● David Cramer: eclipse.xsl
\r
2791 Use sortas attributes (if they exist) when sorting indexterms
\r
2793 ● David Cramer: eclipse.xsl
\r
2795 Added support for indexterm/see in eclipse index.xml
\r
2797 ● Mauritz Jeanson: eclipse.xsl
\r
2799 Added <xsl:with-param name="quiet" select="$chunk.quietly"/>
\r
2800 to helpidx template.
\r
2802 ● David Cramer: eclipse.xsl
\r
2804 Generate index.xml file and add related goo to plugin.xml file. Does not yet support see and seealso.
\r
2806 ● Mauritz Jeanson: eclipse.xsl
\r
2808 Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
\r
2809 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
\r
2810 This makes chunk.quietly=1 suppress chunk filename messages also for help
\r
2811 support files (which seems to be what one would expect). See bug #1648360.
\r
2815 The following changes have been made to the javahelp code since the 1.73.2
\r
2818 ● Mauritz Jeanson: javahelp.xsl
\r
2820 Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
\r
2821 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
\r
2822 This makes chunk.quietly=1 suppress chunk filename messages also for help
\r
2823 support files (which seems to be what one would expect). See bug #1648360.
\r
2827 The following changes have been made to the roundtrip code since the 1.73.2
\r
2830 ● Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl
\r
2832 fix table/cell borders for wordml, fix formal figure, add emphasis-strong
\r
2834 ● Mauritz Jeanson: supported.xml
\r
2836 Changed @cols to 5.
\r
2838 ● Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml
\r
2840 added pubdate, fixed metadata handling in biblioentry
\r
2842 ● Steve Ball: supported.xml
\r
2844 Added support for edition.
\r
2846 ● Steve Ball: docbook-pages.xsl; wordml-blocks.xsl; docbook.xsl; wordml.xsl;
\r
2849 Removed stylesheets for old, deprecated conversion method.
\r
2851 ● Steve Ball: specifications.xml; dbk2ooo.xsl; blocks2dbk.xsl; dbk2pages.xsl;
\r
2854 Added support for Open Office, added edition element, improved list and table support in Word and Pages
\r
2856 ● Steve Ball: normalise-common.xsl; blocks2dbk.xsl; dbk2pages.xsl;
\r
2857 template-pages.xml; templ⋯
\r
2859 Fixed bug in WordML table handling, improved table handling for Pages 08, synchronised WordML and Pages templates.
\r
2861 ● Steve Ball: normalise-common.xsl; blocks2dbk.xsl; wordml2normalise.xsl;
\r
2864 fix caption, attributes
\r
2866 ● Steve Ball: specifications.xml; blocks2dbk.xsl; wordml2normalise.xsl;
\r
2867 blocks2dbk.dtd; temp⋯
\r
2869 Fixes to table and list handling
\r
2871 ● Steve Ball: blocks2dbk.xsl
\r
2873 added support for explicit emphasis character styles
\r
2875 ● Steve Ball: wordml2normalise.xsl
\r
2877 added support for customisation in image handling
\r
2879 ● Steve Ball: blocks2dbk.xsl
\r
2881 Added inlinemediaobject support for metadata.
\r
2883 ● Steve Ball: normalise-common.xsl; blocks2dbk.xsl; template.xml;
\r
2884 dbk2wordml.xsl; dbk2wp.xsl
\r
2886 Added support file. Added style locking. Conversion bug fixes.
\r
2890 The following changes have been made to the slides code since the 1.73.2
\r
2893 ● Michael(tm) Smith: fo/Makefile; html/Makefile
\r
2895 Added checks and hacks to various makefiles to enable building
\r
2896 under Cygwin. This stuff is ugly and maybe not worth the mess and
\r
2897 trouble, but does seem to work as expected and not break anything
\r
2900 ● Jirka Kosek: html/plain.xsl
\r
2902 Added support for showing foil number
\r
2906 The following changes have been made to the website code since the 1.73.2
\r
2909 ● Michael(tm) Smith: extensions/saxon64/.classes/.gitignore; extensions/
\r
2910 xalan2/.classes/com/⋯
\r
2912 renamed a bunch more .cvsignore files to .gitignore (to facilitate use of git-svn)
\r
2916 The following changes have been made to the params code since the 1.73.2
\r
2919 ● Keith Fahlgren: epub.autolabel.xml
\r
2921 New parameter for epub, epub.autolabel
\r
2923 ● Mauritz Jeanson: table.frame.border.color.xml; table.cell.padding.xml;
\r
2924 table.cell.border.t⋯
\r
2926 Added missing refpurposes and descriptions.
\r
2928 ● Keith Fahlgren: ade.extensions.xml
\r
2930 Extensions to support Adobe Digital Editions extensions in .epub output.
\r
2932 ● Mauritz Jeanson: fop.extensions.xml; fop1.extensions.xml
\r
2934 Clarified that fop1.extensions is for FOP 0.90 and later. Version 1 is not here yet...
\r
2936 ● Michael(tm) Smith: man.links.are.underlined.xml;
\r
2937 man.endnotes.list.enabled.xml; man.font.l⋯
\r
2939 removed man.links.are.underlined and added man.font.links. Also,
\r
2940 changed the default font formatting for links to bold.
\r
2942 ● Michael(tm) Smith: man.base.url.for.relative.links.xml
\r
2944 Added new param man.base.url.for.relative.links .. specifies a
\r
2945 base URL for relative links (for ulink, @xlink:href, imagedata,
\r
2946 audiodata, videodata) shown in the generated NOTES section of
\r
2947 man-page output. The value of man.base.url.for.relative.links is
\r
2948 prepended to any relative URI that is a value of ulink url,
\r
2949 xlink:href, or fileref attribute.
\r
2951 If you use relative URIs in link sources in your DocBook refentry
\r
2952 source, and you leave man.base.url.for.relative.links unset, the
\r
2953 relative links will appear "as is" in the NOTES section of any
\r
2954 man-page output generated from your source. That's probably not
\r
2955 what you want, because such relative links are only usable in the
\r
2956 context of HTML output. So, to make the links meaningful and
\r
2957 usable in the context of man-page output, set a value for
\r
2958 man.base.url.for.relative.links that points
\r
2959 to the online version of HTML output generated from your DocBook
\r
2960 refentry source. For example:
\r
2962 <xsl:param name="man.base.url.for.relative.links"
\r
2963 >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param>
\r
2965 ● Michael(tm) Smith: man.string.subst.map.xml
\r
2967 squeeze .sp\n.sp into a single .sp (to prevent a extra, spurious
\r
2968 line of whitespace from being inserted after programlisting etc.
\r
2971 ● Michael(tm) Smith: refentry.manual.fallback.profile.xml;
\r
2972 refentry.source.fallback.profile.⋯
\r
2974 don't use refmiscinfo@class=date value as fallback for refentry
\r
2975 "source" or "manual" metadata fields
\r
2977 ● Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml;
\r
2980 made some further doc tweaks related to the
\r
2981 man.charmap.subset.profile.english param
\r
2983 ● Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml;
\r
2986 Added the man.charmap.subset.profile.english parameter and refined
\r
2987 the handling of charmap subsets to differentiate between English
\r
2988 and non-English source.
\r
2990 This way charmap subsets are now handled is this:
\r
2992 If the value of the man.charmap.use.subset parameter is non-zero,
\r
2993 and your DocBook source is not written in English (that is, if its
\r
2994 lang or xml:lang attribute has a value other than en), then the
\r
2995 character-map subset specified by the man.charmap.subset.profile
\r
2996 parameter is used instead of the full roff character map.
\r
2998 Otherwise, if the lang or xml:lang attribute on the root element
\r
2999 in your DocBook source or on the first refentry element in your
\r
3000 source has the value en or if it has no lang or xml:lang
\r
3001 attribute, then the character-map subset specified by the
\r
3002 man.charmap.subset.profile.english parameter is used instead of
\r
3003 man.charmap.subset.profile.
\r
3005 The difference between the two subsets is that
\r
3006 man.charmap.subset.profile provides mappings for characters in
\r
3007 Western European languages that are not part of the Roman
\r
3008 (English) alphabet (ASCII character set).
\r
3010 ● Michael(tm) Smith: man.charmap.subset.profile.xml
\r
3012 Added to default charmap used by manpages:
\r
3014 - the "letters" part of the 'C1 Controls And Latin-1 Supplement
\r
3015 (Latin-1 Supplement)' Unicode block
\r
3016 - Latin Extended-A block (but not all of the characters from
\r
3017 that block have mappings in groff, so some of them are still
\r
3018 passed through as-is)
\r
3020 The effects of this change are that in man pages generated for
\r
3021 most Western European languages and for Finnish, all characters
\r
3022 not part of the Roman alphabet are (e.g., "accented" characters)
\r
3023 are converted to groff escapes.
\r
3025 Previously, by default we passed through those characters as is
\r
3026 (and users needed to use the full charmap if they wanted to have
\r
3027 those characters converted).
\r
3029 As a result of this change, man pages generated for Western
\r
3030 European languages will be viewable in some environments in which
\r
3031 they are not viewable if the "raw" non-Roman characters are in them.
\r
3033 ● Mauritz Jeanson: generate.legalnotice.link.xml;
\r
3034 generate.revhistory.link.xml
\r
3036 Added information on how the filename is computed.
\r
3038 ● Mauritz Jeanson: default.table.width.xml
\r
3040 Clarified PI usage.
\r
3042 ● Michael(tm) Smith: man.funcsynopsis.style.xml
\r
3044 Added the man.funcsynopsis.style parameter. Has the same effect in
\r
3045 manpages output as the funcsynopsis.style parameter has in HTML
\r
3046 output -- except that its default value is 'ansi' instead of 'kr'.
\r
3048 ● Michael(tm) Smith: funcsynopsis.tabular.threshold.xml
\r
3050 Removed the funcsynopsis.tabular.threshold param. It's no longer
\r
3051 being used in the code and hasn't been since mid 2006.
\r
3053 ● Mauritz Jeanson: table.properties.xml
\r
3055 Set keep-together.within-column to "auto". This seems to be the most sensible
\r
3056 default value for tables.
\r
3058 ● Mauritz Jeanson: informal.object.properties.xml;
\r
3059 admon.graphics.extension.xml; informalequ⋯
\r
3061 Several small documentation fixes.
\r
3063 ● Mauritz Jeanson: manifest.in.base.dir.xml
\r
3067 ● Mauritz Jeanson: header.content.properties.xml;
\r
3068 footer.content.properties.xml
\r
3072 ● Mauritz Jeanson: ulink.footnotes.xml; ulink.show.xml
\r
3074 Updated for DocBook 5.
\r
3076 ● Mauritz Jeanson: index.method.xml; glossterm.auto.link.xml
\r
3078 Spelling and wording fixes.
\r
3080 ● Mauritz Jeanson: callout.graphics.extension.xml
\r
3082 Clarifed available graphics formats and extensions.
\r
3084 ● Mauritz Jeanson: footnote.sep.leader.properties.xml
\r
3086 Corrected refpurpose.
\r
3088 ● Jirka Kosek: footnote.properties.xml
\r
3090 Added more properties which make it possible to render correctly footnotes placed inside verbatim elements.
\r
3092 ● Mauritz Jeanson: img.src.path.xml
\r
3094 img.src.path works with inlinegraphic too.
\r
3096 ● Mauritz Jeanson: saxon.character.representation.xml
\r
3100 ● Mauritz Jeanson: img.src.path.xml
\r
3102 Updated description of img.src.path. Bug #1785224 revealed that
\r
3103 there was a risk of misunderstanding how it works.
\r
3107 The following changes have been made to the profiling code since the 1.73.2
\r
3110 ● Jirka Kosek: xsl2profile.xsl
\r
3112 Added new rules to profile all content generated by HTML Help (including alias files)
\r
3114 ● Robert Stayton: profile-mode.xsl
\r
3116 use mode="profile" instead of xsl:copy-of for attributes so
\r
3117 they can be more easily customized.
\r
3121 The following changes have been made to the tools code since the 1.73.2
\r
3124 ● Michael(tm) Smith: make/Makefile.DocBook
\r
3126 various changes and additions to support making with asciidoc as
\r
3129 ● Michael(tm) Smith: make/Makefile.DocBook
\r
3131 make dblatex the default PDF maker for the example makefile
\r
3133 ● Michael(tm) Smith: xsl/build/html2roff.xsl
\r
3135 Reworked handling of K&R funcprototype output. It no longer relies
\r
3136 on the HTML kr-tabular templates, but instead just does direct
\r
3137 transformation to roff. For K&R output, it displays the paramdef
\r
3138 output in an indented list following the prototype.
\r
3140 ● Mauritz Jeanson: xsl/build/make-xsl-params.xsl
\r
3142 Made attribute-sets members of the param list. This enables links to attribute-sets in the
\r
3143 reference documentation.
\r
3145 ● Michael(tm) Smith: xsl/build/html2roff.xsl
\r
3147 use .BI handling in K&R funsynopsis output for manpages, just as
\r
3148 we do already of ANSI output
\r
3150 ● Michael(tm) Smith: xsl/build/html2roff.xsl
\r
3152 Implemented initial support for handling tabular K&R output of
\r
3153 funcprototype in manpages output. Accomplished by adding more
\r
3154 templates to the intermediate HTML-to-roff stylesheet that the
\r
3155 build uses to create the manpages/html-synop.xsl stylesheet.
\r
3157 ● Michael(tm) Smith: xsl/build/doc-link-docbook.xsl
\r
3159 Made the xsl/tools/xsl/build/doc-link-docbook.xsl stylesheet
\r
3160 import profile-docbook.xsl, so that we can do profiling of release
\r
3161 notes. Corrected some problems in the target for the release-notes
\r
3166 The following changes have been made to the extensions code since the 1.73.2
\r
3169 ● Keith Fahlgren: Makefile
\r
3171 Use DOCBOOK_SVN variable everywhere, please; build with PDF_MAKER
\r
3173 ● Michael(tm) Smith: Makefile
\r
3175 moved extensions build targets from master xsl/Makefile to
\r
3176 xsl/extensions/Makefile
\r
3178 ● Michael(tm) Smith: .cvsignore
\r
3180 re-adding empty extensions subdir
\r
3184 The following changes have been made to the xsl-saxon code since the 1.73.2
\r
3187 ● Michael(tm) Smith: VERSION
\r
3189 bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
\r
3190 recent change to snapshot build infrastructure
\r
3192 ● Michael(tm) Smith: nbproject/build-impl.xml; nbproject/project.properties
\r
3194 Changed hard-coded file references in "clean" target to variable
\r
3195 references. Closes #1792043. Thanks to Daniel Leidert.
\r
3197 ● Michael(tm) Smith: VERSION; Makefile
\r
3199 Did post-release wrap-up of xsl-saxon and xsl-xalan dirs
\r
3201 ● Michael(tm) Smith: nbproject/build-impl.xml; VERSION; Makefile; test
\r
3203 More tweaks to get release-ready
\r
3207 The following changes have been made to the xsl-xalan code since the 1.73.2
\r
3210 ● Michael(tm) Smith: VERSION
\r
3212 bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
\r
3213 recent change to snapshot build infrastructure
\r
3215 ● Michael(tm) Smith: nbproject/build-impl.xml
\r
3217 Changed hard-coded file references in "clean" target to variable
\r
3218 references. Closes #1792043. Thanks to Daniel Leidert.
\r
3220 ● Michael(tm) Smith: Makefile; VERSION
\r
3222 Did post-release wrap-up of xsl-saxon and xsl-xalan dirs
\r
3224 ● Michael(tm) Smith: Makefile; nbproject/build-impl.xml; VERSION
\r
3226 More tweaks to get release-ready
\r
3230 The following changes have been made to the xsl-libxslt code since the 1.73.2
\r
3233 ● Mauritz Jeanson: python/xslt.py
\r
3235 Print the result to stdout if no outfile has been given.
\r
3236 Some unnecessary semicolons removed.
\r
3238 ● Mauritz Jeanson: python/xslt.py
\r
3240 Added a function that quotes parameter values (to ensure that they are interpreted as strings).
\r
3241 Replaced deprecated functions from the string module with string methods.
\r
3243 ● Michael(tm) Smith: python/README; python/README.LIBXSLT
\r
3245 renamed xsl-libxslt/python/README to xsl-libxslt/python/README.LIBXSLT
\r
3247 ● Mauritz Jeanson: python/README
\r
3249 Tweaked the text a little.
\r
3251 Release Notes: 1.73.2
\r
3253 This is solely a minor bug-fix update to the 1.73.1 release. It fixes a
\r
3254 packaging error in the 1.73.1 package, as well as a bug in footnote handling in
\r
3259 This is mostly a bug-fix update to the 1.73.0 release.
\r
3263 The following changes have been made to the gentext code since the 1.73.0
\r
3266 ● Mauritz Jeanson: locale/de.xml
\r
3268 Applied patch #1766009.
\r
3270 ● Michael(tm) Smith: locale/lv.xml
\r
3272 Added localization for ProductionSet.
\r
3276 The following changes have been made to the fo code since the 1.73.0 release.
\r
3278 ● Mauritz Jeanson: table.xsl
\r
3280 Modified the tgroup template so that, for tables with multiple tgroups,
\r
3281 a width attribute is output on all corresponding fo:tables. Previously,
\r
3282 there was a test prohibiting this (and a comment saying that outputting more
\r
3283 than one width attribute will cause an error). But this seems to be no longer
\r
3284 relevant; it is not a problem with FOP 0.93 or XEP 4.10. Closes bug #1760559.
\r
3286 ● Mauritz Jeanson: graphics.xsl
\r
3288 Replaced useless <a> elements with warning messages (textinsert extension).
\r
3290 ● Mauritz Jeanson: admon.xsl
\r
3292 Enabled generation of ids (on fo:wrapper) for indexterms in admonition titles, so that page
\r
3293 references in the index can be created. Closes bug #1775086.
\r
3297 The following changes have been made to the html code since the 1.73.0 release.
\r
3299 ● Mauritz Jeanson: titlepage.xsl
\r
3301 Added <xsl:call-template name="process.footnotes"/> to abstract template
\r
3302 so that footnotes in info/abstract are processed. Closes bug #1760907.
\r
3304 ● Michael(tm) Smith: pi.xsl; synop.xsl
\r
3306 Changed handling of HTML output for the cmdsynopsis and
\r
3307 funcsynopsis elements, such that a@id instances are generated for
\r
3308 them if they are descendants of any element containing a dbcmdlist
\r
3309 or dbfunclist PI. Also, update the embedded reference docs for the
\r
3310 dbcmdlist and dbfunclist PIs to make it clear that they can be
\r
3311 used within any element for which cmdsynopsis or funcsynopsis are
\r
3314 ● Michael(tm) Smith: formal.xsl
\r
3316 Reverted the part of revision 6952 that caused a@id anchors to be
\r
3317 generated for output of informal objects. Thanks to Sam Steingold
\r
3320 ● Robert Stayton: glossary.xsl
\r
3322 Account for a glossary with no glossdiv or glossentry children.
\r
3324 ● Mauritz Jeanson: titlepage.xsl
\r
3326 Modified legalnotice template so that the base.name parameter is calculated
\r
3327 in the same way as for revhistory chunks. Using <xsl:apply-templates
\r
3328 mode="chunk-filename" select="."/> did not work for single-page output since
\r
3329 the template with that mode is in chunk-code.xsl.
\r
3331 ● Mauritz Jeanson: graphics.xsl
\r
3333 Updated support for SVG (must be a child of imagedata in DB 5).
\r
3334 Added support for MathML in imagedata.
\r
3336 ● Mauritz Jeanson: pi.xsl
\r
3338 Added documentation for the dbhh PI (used for context-sensitive HTML Help).
\r
3339 (The two templates matching 'dbhh' are still in htmlhelp-common.xsl).
\r
3343 The following changes have been made to the manpages code since the 1.73.0
\r
3346 ● Michael(tm) Smith: endnotes.xsl
\r
3348 In manpages output, generate warnings about notesources with
\r
3349 non-para children only if the notesource is a footnote or
\r
3350 annotation. Thanks to Sam Steingold for reporting problems with
\r
3351 the existing handling.
\r
3355 The following changes have been made to the htmlhelp code since the 1.73.0
\r
3358 ● Michael(tm) Smith: htmlhelp-common.xsl
\r
3360 Added single-pass namespace-stripping support to the htmlhelp,
\r
3361 eclipse, and javahelp stylesheets.
\r
3365 The following changes have been made to the eclipse code since the 1.73.0
\r
3368 ● Michael(tm) Smith: eclipse.xsl
\r
3370 Added single-pass namespace-stripping support to the htmlhelp,
\r
3371 eclipse, and javahelp stylesheets.
\r
3375 The following changes have been made to the javahelp code since the 1.73.0
\r
3378 ● Michael(tm) Smith: javahelp.xsl
\r
3380 Added single-pass namespace-stripping support to the htmlhelp,
\r
3381 eclipse, and javahelp stylesheets.
\r
3385 The following changes have been made to the roundtrip code since the 1.73.0
\r
3388 ● Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; pages2normalise.xsl
\r
3390 Modularised blocks2dbk to allow customisation,
\r
3391 Added support for tables to pages2normalise
\r
3395 The following changes have been made to the params code since the 1.73.0
\r
3398 ● Robert Stayton: procedure.properties.xml
\r
3400 procedure was inheriting keep-together from formal.object.properties, but
\r
3401 a procedure does not need to be kept together by default.
\r
3403 ● Dave Pawson: title.font.family.xml;
\r
3404 component.label.includes.part.label.xml; table.frame.b⋯
\r
3406 Regular formatting re-org.
\r
3410 This release includes important bug fixes and adds the following significant
\r
3413 New localizations and localization updates
\r
3415 We added two new localizations: Latvian and Esperanto, and made updates to
\r
3416 the Czech, Chinese Simplified, Mongolian, Serbian, Italian, and Ukrainian
\r
3419 ISO690 citation style for bibliography output.
\r
3421 Set the bibliography.style parameter to iso690 to use ISO690 style.
\r
3423 New documentation for processing instructions (PI)
\r
3425 The reference documentation that ships with the release now includes
\r
3426 documentation on all PIs that you can use to control output from the
\r
3429 New profiling parameters for audience and wordsize
\r
3431 You can now do profiling based on the values of the audience and wordsize
\r
3434 Changes to man-page output
\r
3436 The manpages stylesheet now supports single-pass profiling and single-pass
\r
3437 DocBook 5 namespace stripping (just as the HTML and FO stylesheets also
\r
3438 do). Also, added handling for mediaobject & inlinemediaobject. (Each
\r
3439 imagedata, audiodata, or videodata element within a mediaobject or inline
\r
3440 mediaobject is now treated as a "notesource" and so handled in much the
\r
3441 same way as links and annotation/alt/footnote are in manpages output.) And
\r
3442 added the man.authors.section.enabled and man.copyright.section.enabled
\r
3443 parameters to enable control over whether output includes auto-generated
\r
3444 AUTHORS and COPYRIGHT sections.
\r
3446 Highlighting support for C
\r
3448 The highlighting mechanism for generating syntax-highlighted code snippets
\r
3449 in output now supports C code listings (along with Java, PHP, XSLT, and
\r
3452 Experimental docbook-xsl-update script
\r
3454 We added an experimental docbook-xsl-update script, the purpose of which is
\r
3455 to facilitate easy sync-up to the latest docbook-xsl snapshot (by means of
\r
3460 The following changes have been made to the gentext code since the 1.72.0
\r
3463 ● Michael(tm) Smith: locale/lv.xml; Makefile
\r
3465 Added Latvian localization file, from Girts Ziemelis.
\r
3467 ● Dongsheng Song: locale/zh_cn.xml
\r
3469 Brought up to date with en.xml in terms of items. A few strings marked for translation.
\r
3471 ● Jirka Kosek: locale/cs.xml
\r
3473 Added missing translations
\r
3475 ● Robert Stayton: locale/eo.xml
\r
3477 New locale for Esperanto.
\r
3479 ● Robert Stayton: locale/mn.xml
\r
3481 Update from Ganbold Tsagaankhuu.
\r
3483 ● Jirka Kosek: locale/en.xml; locale/cs.xml
\r
3485 Rules for normalizing glossary entries before they are sorted can be now different for each language.
\r
3487 ● Michael(tm) Smith: locale/sr_Latn.xml; locale/sr.xml
\r
3489 Committed changes from Miloš Komarčević to Serbian files.
\r
3491 ● Robert Stayton: locale/ja.xml
\r
3493 Fix chapter in context xref-number-and-title
\r
3495 ● Robert Stayton: locale/it.xml
\r
3497 Improved version from contributor.
\r
3499 ● Mauritz Jeanson: locale/uk.xml
\r
3501 Applied patch 1592083.
\r
3505 The following changes have been made to the common code since the 1.72.0
\r
3508 ● Michael(tm) Smith: labels.xsl
\r
3510 Changed handling of reference auto-labeling such that reference
\r
3511 (when it appears at the component level) is now affected by the
\r
3512 label.from.part param, just as preface, chapter, and appendix.
\r
3514 ● Michael(tm) Smith: common.xsl
\r
3516 Added support to the HTML stylesheets for proper processing of
\r
3517 orgname as a child of author.
\r
3519 ● Michael(tm) Smith: refentry.xsl
\r
3521 Refined logging output of refentry metadata-gathering template;
\r
3522 for some cases of "missing" elements (refmiscinfo stuff, etc.),
\r
3523 the log messages now include URL to corresponding page in the
\r
3524 Definitive Guide (TDG).
\r
3526 ● Robert Stayton: titles.xsl
\r
3528 Add refsection/info/title support.
\r
3530 ● Michael(tm) Smith: titles.xsl
\r
3532 Added support for correct handling of xref to elements that
\r
3533 contain info/title descendants but no title children.
\r
3535 This should be further refined so that it handles any *info
\r
3536 elements. And there are probably some other places where similar
\r
3537 handling for *info/title should be added.
\r
3539 ● Mauritz Jeanson: pi.xsl
\r
3541 Modified <xsl:when> in datetime.format template to work
\r
3546 The following changes have been made to the fo code since the 1.72.0 release.
\r
3548 ● Robert Stayton: component.xsl
\r
3550 Add parameters to the page.sequence utility template.
\r
3552 ● Mauritz Jeanson: xref.xsl
\r
3554 Added template for xref to area/areaset.
\r
3555 Part of fix for bug #1675513 (xref to area broken).
\r
3557 ● Michael(tm) Smith: inline.xsl
\r
3559 Added template match for person element to fo stylesheet.
\r
3561 ● Robert Stayton: lists.xsl
\r
3563 Added support for spacing="compact" in variablelist, per bug report #1722540.
\r
3565 ● Robert Stayton: table.xsl
\r
3567 table pgwide="1" should also use pgwide.properties attribute-set.
\r
3569 ● Mauritz Jeanson: inline.xsl
\r
3571 Make citations numbered if bibliography.numbered != 0.
\r
3573 ● Robert Stayton: param.xweb; param.ent
\r
3575 Add new profiling parameters for audience and wordsize.
\r
3577 ● Robert Stayton: param.xweb; param.ent
\r
3579 Added callout.icon.size parameter.
\r
3581 ● Robert Stayton: inline.xsl; xref.xsl
\r
3583 Add support for xlink as olink.
\r
3585 ● Robert Stayton: autotoc.xsl; param.xweb; param.ent
\r
3587 Add support for qanda.in.toc to fo TOC.
\r
3589 ● Robert Stayton: component.xsl
\r
3591 Improved the page.sequence utility template for use with book.
\r
3593 ● Robert Stayton: division.xsl
\r
3595 Refactored the big book template into smaller pieces.
\r
3596 Used the "page.sequence" utility template in
\r
3597 component.xsl to shorten the toc piece.
\r
3598 Added placeholder templates for front.cover and back.cover.
\r
3600 ● Robert Stayton: param.xweb; param.ent; sections.xsl
\r
3602 Add section.container.element parameter to enable
\r
3603 pgwide spans inside sections.
\r
3605 ● Robert Stayton: param.xweb; param.ent; component.xsl
\r
3607 Add component.titlepage.properties attribute-set to
\r
3608 support span="all" and other properties.
\r
3610 ● Robert Stayton: htmltbl.xsl; table.xsl
\r
3612 Apply table.row.properties template to html tr rows too.
\r
3613 Add keep-with-next to table.row.properties when row is in thead.
\r
3615 ● Robert Stayton: table.xsl
\r
3617 Add support for default.table.frame parameter.
\r
3618 Fix bug 1575446 rowsep last check for @morerows.
\r
3620 ● Robert Stayton: refentry.xsl
\r
3622 Add support for info/title in refsections.
\r
3624 ● David Cramer: qandaset.xsl
\r
3626 Make fo questions and answers behave the same way as html
\r
3628 ● Jirka Kosek: lists.xsl
\r
3630 Added missing attribute set for procedure
\r
3632 ● Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent;
\r
3635 Added support for formatting biblioentries according to ISO690 citation style.
\r
3636 New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
\r
3637 The code was provided by Jana Dvorakova
\r
3639 ● Robert Stayton: param.xweb; param.ent; pagesetup.xsl
\r
3641 Add header.table.properties and footer.table.properties attribute-sets.
\r
3643 ● Robert Stayton: inline.xsl
\r
3645 Add fop1.extensions for menuchoice arrow handling exception.
\r
3649 The following changes have been made to the html code since the 1.72.0 release.
\r
3651 ● Mauritz Jeanson: param.xweb; param.ent
\r
3653 Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the
\r
3654 regular "parameter machinery".
\r
3656 ● Michael(tm) Smith: admon.xsl
\r
3658 Changed handling of titles for note, warning, caution, important,
\r
3659 tip admonitions: We now output and HTML h3 head only if
\r
3660 admon.textlabel is non-zero or if the admonition actually contains
\r
3661 a title; otherwise, we don't output an h3 head at all.
\r
3662 (Previously, we were outputting an empty h3 if the admon.textlabel
\r
3663 was zero and if the admonition had no title.)
\r
3665 ● Mauritz Jeanson: xref.xsl
\r
3667 Added template for xref to area/areaset.
\r
3668 Part of fix for bug #1675513 (xref to area broken).
\r
3670 ● Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; sections.xsl
\r
3672 Added fixes to avoid duplicate ids when generate.id.attributes = 1.
\r
3673 This (hopefully) closes bug #1671052.
\r
3675 ● Michael(tm) Smith: formal.xsl; pi.xsl
\r
3677 Made the dbfunclist PI work as intended. Also added doc for
\r
3678 dbfunclist and dbcmdlist PIs.
\r
3680 ● Michael(tm) Smith: pi.xsl; synop.xsl
\r
3682 Made the dbcmdlist work the way it appears to have been intended
\r
3683 to work. Restored dbhtml-dir template back to pi.xsl.
\r
3685 ● Michael(tm) Smith: titlepage.xsl; param.xweb; param.ent
\r
3687 Added new param abstract.notitle.enabled.
\r
3688 If non-zero, in output of the abstract element on titlepages,
\r
3689 display of the abstract title is suppressed.
\r
3690 Because sometimes you really don't want or need that title
\r
3693 ● Michael(tm) Smith: chunk-code.xsl; graphics.xsl
\r
3695 When we are chunking long descriptions for mediaobject instances
\r
3696 into separate HTML output files, and use.id.as.filename is
\r
3697 non-zero, if a mediaobject has an ID, use that ID as the basename
\r
3698 for the long-description file (otherwise, we generate an ID for it
\r
3699 and use that ID as the basename for the file).
\r
3700 The parallels the recent change made to cause IDs for legalnotice
\r
3701 instances to be used as basenames for legalnotice chunks.
\r
3702 Also, made some minor refinements to the recent changes for
\r
3703 legalnotice chunk handling.
\r
3705 ● Michael(tm) Smith: titlepage.xsl
\r
3707 Added support to the HTML stylesheets for proper processing of
\r
3708 orgname as a child of author.
\r
3710 ● Michael(tm) Smith: chunk-code.xsl
\r
3712 When $generate.legalnotice.link is non-zero and
\r
3713 $use.id.as.filename is also non-zero, if a legalnotice has an ID,
\r
3714 then instead of assigning the "ln-<generatedID>" basename to the
\r
3715 output file for that legalnotice, just use its real ID as the
\r
3716 basename for the file -- as we do when chunking other elements
\r
3719 ● David Cramer: xref.xsl
\r
3721 Handle alt text on xrefs to steps when the step doesn't have a title.
\r
3723 ● David Cramer: lists.xsl
\r
3725 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
3727 ● David Cramer: qandaset.xsl
\r
3729 Added <p> element around question and answer labels to avoid misalignment of label and listitem in xhtml (non-quirks mode) output
\r
3731 ● David Cramer: lists.xsl
\r
3733 Added <p> element around callouts to avoid misalignment of callout and listitem in xhtml (non-quirks mode) output
\r
3735 ● Mauritz Jeanson: inline.xsl
\r
3737 Make citations numbered if bibliography.numbered != 0.
\r
3739 ● Robert Stayton: param.xweb; param.ent
\r
3741 Add support for new profiling attributes audience and wordsize.
\r
3743 ● Robert Stayton: inline.xsl; xref.xsl
\r
3745 Add support for xlink olinks.
\r
3747 ● Jirka Kosek: glossary.xsl
\r
3749 Rules for normalizing glossary entries before they are sorted can be now different for each language.
\r
3751 ● Robert Stayton: chunk-common.xsl; chunk-code.xsl; manifest.xsl; chunk.xsl
\r
3753 Refactored the chunking modules to move all named templates to
\r
3754 chunk-common.xsl and all match templates to chunk-code.xsl, in
\r
3755 order to enable better chunk customization.
\r
3756 See the comments in chunk.xsl for more details.
\r
3758 ● Robert Stayton: lists.xsl
\r
3760 Add anchor for xml:id for listitem in varlistentry.
\r
3762 ● Robert Stayton: refentry.xsl
\r
3764 Add support for info/title in refsections for db5.
\r
3766 ● Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent;
\r
3769 Added support for formatting biblioentries according to ISO690 citation style.
\r
3770 New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
\r
3771 The code was provided by Jana Dvorakova
\r
3773 ● Robert Stayton: inline.xsl; xref.xsl
\r
3775 Add call to class.attribute to <a> output elements so they can
\r
3776 have a class value too.
\r
3778 ● Mauritz Jeanson: glossary.xsl
\r
3780 Fixed bug #1644881:
\r
3781 * Added curly braces around all $language attribute values.
\r
3782 * Moved declaration of language variable to top level of stylesheet.
\r
3783 Tested with Xalan, Saxon, and xsltproc.
\r
3787 The following changes have been made to the manpages code since the 1.72.0
\r
3790 ● Michael(tm) Smith: param.xweb; docbook.xsl; param.ent
\r
3792 Added the man.authors.section.enabled and
\r
3793 man.copyright.section.enabled parameters. Set those to zero when
\r
3794 you want to suppress display of the auto-generated AUTHORS and
\r
3795 COPYRIGHT sections. Closes request #1467806. Thanks to Daniel
\r
3798 ● Michael(tm) Smith: docbook.xsl
\r
3800 Took the test that the manpages stylesheet does to see if there
\r
3801 are any Refentry chilren in current doc, and made it
\r
3802 namespace-agnostic. Reason for that is because the test otherwise
\r
3803 won't work when it is copied over into the generated
\r
3804 profile-docbook.xsl stylesheet.
\r
3806 ● Michael(tm) Smith: Makefile
\r
3808 Added a manpages/profile-docbook.xsl file to enable single-pass
\r
3809 profiling for manpages output.
\r
3811 ● Michael(tm) Smith: info.xsl
\r
3813 Output copyright and legalnotice in man-page output in whatever
\r
3814 place they are in in document order. Closes #1690539. Thanks to
\r
3815 Daniel Leidert for reporting.
\r
3817 ● Michael(tm) Smith: docbook.xsl
\r
3819 Restored support for single-pass namespace stripping to manpages
\r
3822 ● Michael(tm) Smith: synop.xsl; block.xsl; info.xsl; inline.xsl; lists.xsl;
\r
3825 Changed handling of bold and italic/underline output in manpages
\r
3826 output. Should be transparent to users, but...
\r
3828 This touches handling of all bold and italic/underline output. The
\r
3829 exact change is that the mode="bold" and mode="italic" utility
\r
3830 templates were changed to named templates. (I think maybe I've
\r
3831 changed it back and forth from mode to named before, so this is
\r
3832 maybe re-reverting it yet again).
\r
3834 Anyway, the reason for the change is that the templates are
\r
3835 sometimes call on dynamically node-sets, and using modes to format
\r
3836 those doesn't allow passing info about the current/real context
\r
3837 node from the source (not the node-set created by the stylesheet)
\r
3838 to that formatting stage.
\r
3840 The named templates allow the context to be passed in as a
\r
3841 parameter, so that the bold/ital formatting template can use
\r
3842 context-aware condition checking.
\r
3844 This was basically necessary in order to suppress bold formatting
\r
3845 in titles, which otherwise gets screwed up because of the numbnut
\r
3846 way that roff handles nested bold/ital.
\r
3848 Closes #1674534). Much thanks to Daniel Leidert, whose in his
\r
3849 docbook-xsl bug-finding kung-fu has achieved Grand Master status.
\r
3851 ● Michael(tm) Smith: block.xsl
\r
3853 Fixed handling of example instances by adding the example element
\r
3854 to the same template we use for processing figure. Closes
\r
3855 #1674538. Thanks to Daniel Leidert.
\r
3857 ● Michael(tm) Smith: utility.xsl
\r
3859 Don't include lang in manpages filename/pathname if lang=en (that
\r
3860 is, only generate lang-qualified file-/pathnames for non-English).
\r
3862 ● Michael(tm) Smith: endnotes.xsl
\r
3864 In manpages output, emit warnings for notesources (footnote, etc.)
\r
3865 that have something other than para as a child.
\r
3867 The numbered-with-hanging-indent formatting that's used for
\r
3868 rendering endnotes in the NOTES section of man pages places some
\r
3869 limits/assumptions on how the DocBook source is marked up; namely,
\r
3870 for notesources (footnote, annotation, etc.) that can contain
\r
3871 block-level children, if the they have a block-level child such as
\r
3872 a table or itemizedlist or orderedlist that is the first child of
\r
3873 a footnote, we have no way of rendering/indenting its content
\r
3874 properly in the endnotes list.
\r
3876 Thus, the manpages stylesheet not emits a warning message for that
\r
3877 case, and suggests the "fix" (which is to wrap the table or
\r
3878 itemizedlist or whatever in a para that has some preferatory text.
\r
3880 ● Michael(tm) Smith: utility.xsl
\r
3882 Added support to mixed-block template for handling tables in
\r
3883 mixed-blocks (e.g., as child of para) correctly.
\r
3885 ● Michael(tm) Smith: table.xsl; synop.xsl; block.xsl; info.xsl; lists.xsl;
\r
3886 refentry.xsl; end⋯
\r
3888 Reverted necessary escaping of backslash, dot, and dash
\r
3889 out of the well-intentioned (but it now appears,
\r
3890 misguided) "marker" mechanism (introduced in the 1.72.0
\r
3891 release) -- which made use of alternative "marker"
\r
3892 characters as internal representations of those
\r
3893 characters, and then replaced them just prior to
\r
3894 serialization -- and back into what's basically the
\r
3895 system that was used prior to the 1.69.0 release; that
\r
3896 is, into a part of stylesheet code that gets executed
\r
3897 at the beginning of processing -- before any other roff
\r
3898 markup up is. This change obviates the need for the
\r
3899 marker system. It also requires a lot less RAM during
\r
3900 processing (for large files, the marker mechanism
\r
3901 ending up requiring gigabytes of memory).
\r
3903 Closes bug #1661177. Thanks to Scott Smedley for
\r
3904 providing a test case (the fvwm man page) that exposed
\r
3905 the problem with the marker mechanism.
\r
3907 Also moved the mechanism for converting non-breaking
\r
3908 spaces back into the same area of the stylesheet code.
\r
3910 ● Michael(tm) Smith: lists.xsl
\r
3912 Fixed problem with incorrect formatting of nested variablelist.
\r
3913 Closes bug #1650931. Thanks to Daniel "Eagle Eye" Leidert.
\r
3915 ● Michael(tm) Smith: lists.xsl
\r
3917 Make sure that all listitems in itemizedlist and orderedlist are
\r
3918 preceded by a blank line. This fixes a regression that occurred
\r
3919 when instances of the TP macro that were use in a previous
\r
3920 versions of the list-handling code were switched to RS/RE (because
\r
3921 TP doesn't support nesting). TP automatically generates a blank
\r
3922 line, but RS doesn't. So I added a .sp before each .RS
\r
3924 ● Michael(tm) Smith: block.xsl; inline.xsl; param.xweb; docbook.xsl;
\r
3925 links.xsl; param.ent
\r
3927 Made a number of changes related to elements with
\r
3928 out-of-line content:
\r
3930 - Added handling for mediaobject & inlinemediaobject.
\r
3931 Each imagedata, audiodata, or videodata element
\r
3932 within a mediaobject or inline mediaobject is now
\r
3933 treated as a "notesource" and so handled in much the
\r
3934 same way as links and annotation/alt/footnotes.
\r
3936 That means a numbered marker is generated inline to
\r
3937 mark the place in the main flow where the imagedata,
\r
3938 audiodata, or videodata element occurs, and a
\r
3939 corresponding numbered endnote for it is generated in
\r
3940 the endnotes list at the end of the man page; the
\r
3941 endnote contains the URL from the fileref attribute
\r
3942 of the imagedata, audiodata, or videodata element.
\r
3944 For mediobject and inlinemediaobject instances that
\r
3945 have a textobject child, the textobject is displayed
\r
3946 within the main text flow.
\r
3948 - Renamed several man.link.* params to man.endnotes.*,
\r
3949 to reflect that fact that the endnotes list now
\r
3950 contains more than just links. Also did similar
\r
3951 renaming for a number of stylesheet-internal vars.
\r
3953 - Added support for xlink:href (along with existing
\r
3954 support for the legacy ulink element).
\r
3956 - Cleaned up and streamlined the endnotes-handling
\r
3957 code. It's still messy and klunky and the basic
\r
3958 mechanism it uses is very inefficent for documents
\r
3959 that contain a lot of notesources, but at least it's
\r
3960 a bit better than it was.
\r
3964 The following changes have been made to the eclipse code since the 1.72.0
\r
3967 ● Mauritz Jeanson: Makefile
\r
3969 Fixed bug #1715093: Makefile for creating profiled version of eclipse.xsl added.
\r
3971 ● David Cramer: eclipse.xsl
\r
3973 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
3977 The following changes have been made to the javahelp code since the 1.72.0
\r
3980 ● Mauritz Jeanson: javahelp.xsl
\r
3982 Implemented FR #1230233 (sorted index in javahelp).
\r
3984 ● Mauritz Jeanson: javahelp.xsl
\r
3986 Added normalize-space() around titles and index entries to work around whitespace problems.
\r
3987 Added support for glossary and bibliography in toc and map files.
\r
3991 The following changes have been made to the roundtrip code since the 1.72.0
\r
3994 ● Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl; normalise2sections.xsl;
\r
3997 new stylesheets for better word processor support and easier maintenance
\r
3999 ● Steve Ball: template-pages.xml; dbk2wp.xsl; sections-spec.xml
\r
4005 The following changes have been made to the params code since the 1.72.0
\r
4008 ● Mauritz Jeanson: htmlhelp.button.back.xml; htmlhelp.button.forward.xml;
\r
4009 htmlhelp.button.zo⋯
\r
4011 Modified refpurpose text.
\r
4013 ● Mauritz Jeanson: htmlhelp.map.file.xml; htmlhelp.force.map.and.alias.xml;
\r
4016 Fixed typos, made some small changes.
\r
4018 ● Mauritz Jeanson: javahelp.encoding.xml
\r
4020 Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the
\r
4021 regular "parameter machinery".
\r
4023 ● Mauritz Jeanson: generate.id.attributes.xml
\r
4025 Added refpurpose text.
\r
4027 ● Mauritz Jeanson: annotation.js.xml; annotation.graphic.open.xml;
\r
4028 annotation.graphic.close.⋯
\r
4030 Added better refpurpose texts.
\r
4032 ● Michael(tm) Smith: chunker.output.cdata-section-elements.xml;
\r
4033 chunker.output.standalone.xm⋯
\r
4035 Fixed some broken formatting in source files for chunker.* params,
\r
4036 as pointed out by Dave Pawson.
\r
4038 ● Michael(tm) Smith: label.from.part.xml
\r
4040 Changed handling of reference auto-labeling such that reference
\r
4041 (when it appears at the component level) is now affected by the
\r
4042 label.from.part param, just as preface, chapter, and appendix.
\r
4044 ● Mauritz Jeanson: callout.graphics.extension.xml
\r
4046 Clarified that 'extension' refers to file names.
\r
4048 ● Michael(tm) Smith: abstract.notitle.enabled.xml
\r
4050 Added new param abstract.notitle.enabled.
\r
4051 If non-zero, in output of the abstract element on titlepages,
\r
4052 display of the abstract title is suppressed.
\r
4053 Because sometimes you really don't want or need that title
\r
4056 ● Michael(tm) Smith: man.string.subst.map.xml
\r
4058 Updated manpages string-substitute map to reflect fact that
\r
4059 because of another recent change to suppress bold markup in .SH
\r
4060 output, we no longer need to add a workaround for the accidental
\r
4061 uppercasing of roff escapes that occurred previously.
\r
4063 ● Jirka Kosek: margin.note.float.type.xml; title.font.family.xml;
\r
4064 table.frame.border.color.x⋯
\r
4066 Improved parameter metadata
\r
4068 ● Robert Stayton: profile.wordsize.xml; profile.audience.xml
\r
4070 Add support for profiling on new attributes audience and wordsize.
\r
4072 ● Robert Stayton: callout.graphics.number.limit.xml;
\r
4073 callout.graphics.extension.xml
\r
4075 Added SVG graphics for fo output.
\r
4077 ● Robert Stayton: callout.icon.size.xml
\r
4079 Set size of callout graphics.
\r
4081 ● Jirka Kosek: default.units.xml; chunker.output.method.xml;
\r
4082 toc.list.type.xml; output.inden⋯
\r
4084 Updated parameter metadata to the new format.
\r
4086 ● Jirka Kosek: man.output.quietly.xml; title.font.family.xml;
\r
4087 footnote.sep.leader.properties⋯
\r
4089 Added type annotations into parameter definition files.
\r
4091 ● Robert Stayton: section.container.element.xml
\r
4093 Support spans in sections for certain processors.
\r
4095 ● Robert Stayton: component.titlepage.properties.xml
\r
4097 Empty attribute set for top level component titlepage block.
\r
4098 Allows setting a span on title info.
\r
4100 ● Jirka Kosek: bibliography.style.xml
\r
4102 Added link to WiKi page with description of special markup needed for ISO690 biblioentries
\r
4104 ● Robert Stayton: make.year.ranges.xml
\r
4106 Clarify that multiple year elements are required.
\r
4108 ● Robert Stayton: id.warnings.xml
\r
4110 Turn off id.warnings by default.
\r
4112 ● Jirka Kosek: bibliography.style.xml
\r
4114 Added support for formatting biblioentries according to ISO690 citation style.
\r
4115 New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
\r
4116 The code was provided by Jana Dvorakova
\r
4118 ● Robert Stayton: header.table.properties.xml; footer.table.properties.xml
\r
4120 Support adding table properties to header and footer tables.
\r
4124 The following changes have been made to the highlighting code since the 1.72.0
\r
4127 ● Jirka Kosek: c-hl.xml; xslthl-config.xml
\r
4129 Added support for C language. Provided by Bruno Guegan.
\r
4133 The following changes have been made to the profiling code since the 1.72.0
\r
4136 ● Robert Stayton: profile-mode.xsl
\r
4138 Add support for new profiling attributes audience and wordsize.
\r
4142 The following changes have been made to the lib code since the 1.72.0 release.
\r
4144 ● Michael(tm) Smith: lib.xweb
\r
4146 Changed name of prepend-pad template to pad-string and twheeked so
\r
4147 it can do both right/left padding.
\r
4151 The following changes have been made to the tools code since the 1.72.0
\r
4154 ● Michael(tm) Smith: bin; bin/docbook-xsl-update
\r
4156 Did some cleanup to the install.sh source and added a
\r
4157 docbook-xsl-update script to the docbook-xsl distro, the purpose
\r
4158 of which is to facilitate easy sync-up to the latest docbook-xsl
\r
4159 snapshot (by means of rsync).
\r
4163 The following changes have been made to the xsl-saxon code since the 1.72.0
\r
4166 ● Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/
\r
4167 com/nwalsh/xalan/⋯
\r
4169 Added modifications so that the new callout.icon.size parameter is taken into account. This
\r
4170 parameter is used for FO output (where SVG now is the default graphics format for callouts).
\r
4172 ● Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/
\r
4175 Added code for generating id attributes on callouts in HTML and FO output.
\r
4176 These patches enable cross-references to callouts placed by area coordinates.
\r
4177 It works for graphic, unicode and text callouts.
\r
4178 Part of fix for bug #1675513 (xref to area broken).
\r
4180 ● Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/
\r
4183 Copied over Website XSL Java extensions.
\r
4187 The following changes have been made to the xsl-xalan code since the 1.72.0
\r
4190 ● Michael(tm) Smith: Makefile; xalan2
\r
4192 Turned off xalan2.jar build. This removes DocBook XSL
\r
4193 Java extensions support for versions of Xalan prior to
\r
4194 Xalan 2.7. If you are currently using the extensions
\r
4195 with an earlier version of Xalan, you need to upgrade
\r
4198 ● Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/
\r
4199 com/nwalsh/xalan/⋯
\r
4201 Added modifications so that the new callout.icon.size parameter is taken into account. This
\r
4202 parameter is used for FO output (where SVG now is the default graphics format for callouts).
\r
4204 ● Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/
\r
4207 Added code for generating id attributes on callouts in HTML and FO output.
\r
4208 These patches enable cross-references to callouts placed by area coordinates.
\r
4209 It works for graphic, unicode and text callouts.
\r
4210 Part of fix for bug #1675513 (xref to area broken).
\r
4212 ● Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/
\r
4215 Copied over Website XSL Java extensions.
\r
4219 This release includes important bug fixes and adds the following significant
\r
4222 Automatic sorting of glossary entries
\r
4224 The HTML and FO stylesheets now support automatic sorting of glossary
\r
4225 entries. To enable glossary sorting, set the value of the glossary.sort
\r
4226 parameter to 1 (by default, it’s value is 0). When you enable glossary
\r
4227 sorting, glossentry elements within a glossary, glossdiv, or glosslist are
\r
4228 sorted on the glossterm, using the current language setting. If you don’t
\r
4229 enable glossary sorting, then the order of glossentry elements is left “as
\r
4230 is” — that is, they are not sorted but are instead just displayed in
\r
4233 WordML renamed to Roundtrip, OpenOffice support added
\r
4235 Stylesheets for “roundtrip” conversion between documents in OpenOffice
\r
4236 format (ODF) and DocBook XML have been added to the set of stylesheets that
\r
4237 formerly had the collective title WordML, and that set of stylesheets has
\r
4238 been renamed to Roundtrip to better reflect the actual scope and purpose of
\r
4241 So the DocBook XSL Stylesheets now support roundtrip conversion (with
\r
4242 certain limitations) of WordML, OpenOffice, and Apple Pages documents to
\r
4243 and from DocBook XML.
\r
4245 Including QandASet questions in TOCs
\r
4247 The HTML stylesheet now provides support for including QandASet questions
\r
4248 in the document TOC. To enable display of questions in the document TOC,
\r
4249 set the value of the qanda.in.toc to 1 (by default, it’s 0). When you
\r
4250 enable qanda.in.toc, then the generated table of contents for a document
\r
4251 will include qandaset titles, qandadiv titles, and question elements. The
\r
4252 default value of zero excludes them from the TOC.
\r
4256 The qanda.in.toc parameter does not affect any tables of contents that may
\r
4257 be generated within a qandaset or qandadiv (only in the document TOC).
\r
4259 Language identifier in man-page filenames and pathnames
\r
4261 Added new parameter man.output.lang.in.name.enabled, which controls whether
\r
4262 a language identifier is included in man-page filenames and pathnames. It
\r
4265 If the value of man.output.lang.in.name.enabled is non-zero, man-page files
\r
4266 are output with a language identifier included in their filenames or
\r
4267 pathnames as follows:
\r
4269 ● if man.output.subdirs.enabled is non-zero, each file is output to,
\r
4270 e.g., a /$lang/man8/foo.8 pathname
\r
4272 ● if man.output.subdirs.enabled is zero, each file is output with a
\r
4273 foo.$lang.8 filename
\r
4275 index.page.number.properties property set
\r
4277 For FO output, use the index.page.number.properties to control formatting
\r
4278 of page numbers in index output — to (for example) to display page numbers
\r
4279 in index output in a different color (to indicate that they are links).
\r
4281 Crop marks in output from Antenna House XSL Formatter
\r
4283 Support has been added for generating crop marks in print/PDF output
\r
4284 generated using Antenna House XSL Formatter
\r
4286 More string-substitution hooks in manpages output
\r
4288 The man.string.subst.map.local.pre and man.string.subst.map.local.post
\r
4289 parameters have been added to enable easier control over custom string
\r
4292 Moved verbatim properties to attribute-set
\r
4294 The hardcoded properties used in verbatim elements (literallayout,
\r
4295 programlisting, screen) were moved to the verbatim.properties attribute-set
\r
4296 so they can be more easily customized.
\r
4298 enhanced simple.xlink template
\r
4300 Now the simple.xlink template in inline.xsl works with cross reference
\r
4301 elements xref and link as well. Also, more elements call simple.xlink,
\r
4302 which enables DB5 xlink functionality.
\r
4304 DocBook 5 compatibility
\r
4306 Stylesheets now consistently support DocBook 5 attributes (such as xml:id).
\r
4307 Also, DocBook 5 info elements are now checked along with other *info
\r
4308 elements, and the use of name() function was replaced by local-name() so it
\r
4309 also matches on DocBook 5 elements. These changes enable reusing the
\r
4310 stylesheets with DocBook 5 documents with minimal fixup.
\r
4312 HTML class attributes now handled in class.attribute mode
\r
4314 The HTML class attributes were formerly hardcoded to the element name. Now
\r
4315 the class attribute is generated by applying templates in class.attribute
\r
4316 mode so class attribute names can be customized. The default is still the
\r
4319 arabic-indic numbering enabled in autolabels
\r
4321 Numbering of chapter, sections, and pages can now use arabic-indic
\r
4322 numbering when number format is set to 'arabicindic' or to ١.
\r
4324 The following is a detailed list of changes (not including bug fixes) that have
\r
4325 been made since the 1.71.1 release.
\r
4329 The following changes have been made to the common code since the 1.71.1
\r
4332 ● Add support for arabicindic numbering to autolabel.format template.
\r
4334 ● Finish support for @xml:id everywhere @id is used.
\r
4336 ● replace name() with local-name() in most cases.
\r
4338 ● Add support for info.
\r
4340 ● Add utility template tabstyle to return the tabstyle from
\r
4341 any table element.
\r
4345 The following changes have been made to the fo code since the 1.71.1 release.
\r
4347 ● Add support for sorting glossary entries
\r
4349 ● Add table.row.properties template to customize table rows.
\r
4351 ● Moved all properties to attribute-sets so can be customized more easily.
\r
4353 ● Add index.page.number.properties attribute-set to format page numbers.
\r
4355 ● xref now supports xlink:href, using simple.xlink template.
\r
4357 ● Rewrote simple.xlink, and call it with all charseq templates.
\r
4359 ● Add simple.xlink processing to term and member elements.
\r
4361 ● Add support for crop marks in Antenna House.
\r
4365 The following changes have been made to the html code since the 1.71.1 release.
\r
4367 ● Add support for sorting glossary entries
\r
4369 ● Add support for qanda.in.toc to add qandaentry questions to document TOC.
\r
4371 ● add simple.xlink support to variablelist term and simplelist member.
\r
4373 ● *.propagates.style now handled in class.attribute mode.
\r
4375 ● add class parameter to class.attribute mode to set default class.
\r
4377 ● Convert all class attributes to use the class.attribute mode
\r
4378 so class names can be customized more easily.
\r
4380 ● Add class.attribute mode to generate class attributes.
\r
4382 ● Added simple.xlink to most remaining inlines.
\r
4383 Changed class attributes to applying class.attributes mode.
\r
4385 ● Changed xref template to use simple.xlink tempalte.
\r
4387 ● Improve generate.html.title to work with link targets too.
\r
4389 ● Improved simple.xlink to support link and xref.
\r
4391 ● Use new link.title.attribute now.
\r
4393 ● Rewrote simple.xlink to handle linkend also.
\r
4394 Better computation of title attribute on link too.
\r
4396 ● Handle Xalan quirk as special case.
\r
4398 ● Add support for info.
\r
4400 ● Fixed imagemaps so they work properly going from calspair coords
\r
4401 to HTML area coords.
\r
4405 The following changes have been made to the manpages code since the 1.71.1
\r
4408 ● Added doc for man.output.lang.in.name.enabled parameter. This
\r
4409 checkin completes support for writing file/pathnames for man-pages
\r
4410 with $lang include in the names. Closes #1585967. knightly
\r
4411 accolades to Daniel Leidert for providing the feature request.
\r
4413 ● Added new param man.output.lang.in.name.enabled, which
\r
4414 controls whether $LANG value is included in manpages
\r
4415 filenames and pathnames. It works like this:
\r
4417 If the value of man.output.lang.in.name.enabled is non-zero,
\r
4418 man-page files are output with the $lang value included in
\r
4419 their filenames or pathnames as follows;
\r
4421 - if man.output.subdirs.enabled is non-zero, each file is
\r
4422 output to, e.g., a /$lang/man8/foo.8 pathname
\r
4424 - if man.output.subdirs.enabled is zero, each file is output
\r
4425 with a foo.$lang.8 filename
\r
4427 ● Use "\e" instead of "\\" for backslash output, because the
\r
4428 groff docs say that's the correct thing to do; also because
\r
4429 testing (thanks, Paul Dubois) shows that "\\" doesn't always
\r
4430 work as expected; for example, "\\" within a table seems to
\r
4433 ● Added the man.string.subst.map.local.pre and
\r
4434 man.string.subst.map.local.post parameters. Those parameters
\r
4435 enable local additions and changes to string-substitution mappings
\r
4436 without the need to change the value of man.string.subst.map
\r
4437 parameter (which is for standard system mappings). Closes
\r
4438 #1456738. Thanks to Sam Steingold for constructing a true
\r
4439 stylesheet torture test (the clisp docs) that exposed the need for
\r
4442 ● Added the Markup element to the list of elements that get output
\r
4443 in bold. Thanks to Eric S. Raymond.
\r
4445 ● Replaced all dots in roff requests with U+2302 ("house"
\r
4446 character), and added escaping in output for all instances of dot
\r
4447 that are not in roff requests. This fixes the problem case where a
\r
4448 string beginning with a dot (for example, the string ".bashrc")
\r
4449 might occur at the beginning of a line in output, in which case
\r
4450 would mistakenly get interpreted as a roff request. Thanks to Eric
\r
4451 S. Raymond for pushing to fix this.
\r
4453 ● Made change to ensure that list content nested in
\r
4454 itemizedlist and orderedlist instances is properly indented. This
\r
4455 is a switch from using .TP to format those lists to using .RS/.RE
\r
4456 to format them instead (because .TP does not allow nesting). Closes bug #
\r
4458 Thanks to Daniel Leidert.
\r
4462 The following changes have been made to the params code since the 1.71.1
\r
4465 ● Added doc for man.output.lang.in.name.enabled parameter. This
\r
4466 checkin completes support for writing file/pathnames for man-pages
\r
4467 with $lang include in the names. Closes #1585967. knightly
\r
4468 accolades to Daniel Leidert for providing the feature request.
\r
4470 ● Added new param man.output.lang.in.name.enabled, which
\r
4471 controls whether $LANG value is included in manpages
\r
4472 filenames and pathnames. It works like this:
\r
4474 If the value of man.output.lang.in.name.enabled is non-zero,
\r
4475 man-page files are output with the $lang value included in
\r
4476 their filenames or pathnames as follows;
\r
4478 - if man.output.subdirs.enabled is non-zero, each file is
\r
4479 output to, e.g., a /$lang/man8/foo.8 pathname
\r
4481 - if man.output.subdirs.enabled is zero, each file is output
\r
4482 with a foo.$lang.8 filename
\r
4484 ● Added the man.string.subst.map.local.pre and
\r
4485 man.string.subst.map.local.post parameters. Those parameters
\r
4486 enable local additions and changes to string-substitution mappings
\r
4487 without the need to change the value of man.string.subst.map
\r
4488 parameter (which is for standard system mappings). Closes
\r
4489 #1456738. Thanks to Sam Steingold for constructing a true
\r
4490 stylesheet torture test (the clisp docs) that exposed the need for
\r
4493 ● Add index.page.number.properties by default.
\r
4495 ● Added index.page.number.properties
\r
4496 to allow customizations of page numbers in indexes.
\r
4498 ● Move show-destination="replace" property from template to attribute-set
\r
4499 so it can be customized.
\r
4501 ● Add support for sorting glossary entries
\r
4503 ● Add option to include qanda in tables of contents.
\r
4505 ● Moved all properties to attribute-sets so can be customized more easily.
\r
4509 The following changes have been made to the template code since the 1.71.1
\r
4512 ● Added workaround for Xalan bug: use for-each and copy instead of copy-of (#
\r
4517 The following changes have been made to the roundtrip code since the 1.71.1
\r
4520 ● rename to roundtrip, add OpenOffice support
\r
4524 This is a minor update to the 1.71.0 release. Along with a number of bug fixes,
\r
4525 it includes two feature changes:
\r
4527 ● Added support for profiling based on xml:lang and status attributes.
\r
4529 ● Added initial support in manpages output for footnote, annotation, and alt
\r
4530 instances. Basically, they all now get handled the same way ulink instances
\r
4531 are. They are treated as a class as "note sources": A numbered marker is
\r
4532 generated at the place in the main text flow where they occur, then their
\r
4533 contents are displayed in an endnotes section at the end of the man page.
\r
4537 The following changes have been made to the common code since the 1.71.1
\r
4540 ● For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
\r
4542 ● Add support for Xalan generating a root xml:base like saxon.
\r
4546 The following changes have been made to the fo code since the 1.71.1 release.
\r
4548 ● For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
\r
4550 ● Add support for Xalan to add root node xml:base for db5 docs.
\r
4552 ● Added support for profiling based on xml:lang and status attributes.
\r
4556 The following changes have been made to the html code since the 1.71.1 release.
\r
4558 ● For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
\r
4560 ● Add support for Xalan to add root node xml:base for db5 docs.
\r
4562 ● Added support for profiling based on xml:lang and status attributes.
\r
4564 ● Made changes in namespace declarations to prevent xmllint's
\r
4565 canonicalizer from treating them as relative namespace URIs.
\r
4567 - Changed xmlns:k="java:com.isogen.saxoni18n.Saxoni18nService"
\r
4568 to xmlns:k="http://www.isogen.com/functions/
\r
4569 com.isogen.saxoni18n.Saxoni18nService";
\r
4570 Saxon accepts either form
\r
4571 (see http://www.saxonica.com/documentation/extensibility/
\r
4573 to Saxon, "the part of the URI before the final '/' is immaterial".
\r
4575 - Changed, e.g. xmlns:xverb="com.nwalsh.xalan.Verbatim" to
\r
4576 xmlns:xverb="xalan://com.nwalsh.xalan.Verbatim"; Xalan accepts
\r
4578 (see http://xml.apache.org/xalan-j/extensions.html#
\r
4579 java-namespace-declare);
\r
4580 just as Saxon does, it will "simply use the string to the
\r
4581 right of the rightmost forward slash as the Java class name".
\r
4583 - Changed xmlns:xalanredirect="org.apache.xalan.xslt.extensions.Redirect"
\r
4584 to xmlns:redirect="http://xml.apache.org/xalan/redirect", and
\r
4585 adjusted associated code to make the current Xalan redirect spec.
\r
4586 (see http://xml.apache.org/xalan-j/apidocs/org/apache/xalan/lib/
\r
4589 ● Added the html.append and chunk.append parameters. By default, the
\r
4590 value of both is empty; but the internal DocBook XSL stylesheets
\r
4591 build sets their value to "<xsl:text>
</xsl:text>", in order
\r
4592 to ensure that all files in the docbook-xsl-doc package end in a
\r
4593 newline character. (Because diff and some other tools may emit
\r
4594 error messages and/or not behave as expected when processing
\r
4595 files that are not newline-terminated.)
\r
4599 The following changes have been made to the highlighting code since the 1.71.1
\r
4602 ● Added license information
\r
4606 The following changes have been made to the manpages code since the 1.71.1
\r
4609 ● Added initial support in manpages output for footnote, annotation,
\r
4610 and alt instances. Basically, they all now get handled the same
\r
4611 way ulink instances are. They are treated as a class as "note
\r
4612 sources": A numbered marker is generated at the place in the main
\r
4613 text flow where they occur, then their contents are displayed in
\r
4614 an endnotes section at the end of the man page (currently titled
\r
4615 REFERENCES, for English output, but will be changed to NOTES).
\r
4617 This support is not yet complete. It works for most "normal"
\r
4618 cases, but probably mishandles a good number of cases. More
\r
4619 testing will be needed to expose the problems. It may well also
\r
4620 introduce some bugs and regressions in other areas, including
\r
4621 basic paragraph handling, handling of "mixed block" content,
\r
4622 handling of other indented content, and handling of authorblurb
\r
4623 and personblurb in the AUTHORS section.
\r
4627 The following changes have been made to the params code since the 1.71.1
\r
4630 ● Added support for profiling based on xml:lang and status attributes.
\r
4632 ● Added the html.append and chunk.append parameters. By default, the
\r
4633 value of both is empty; but the internal DocBook XSL stylesheets
\r
4634 build sets their value to "<xsl:text>
</xsl:text>", in order
\r
4635 to ensure that all files in the docbook-xsl-doc package end in a
\r
4636 newline character. (Because diff and some other tools may emit
\r
4637 error messages and/or not behave as expected when processing
\r
4638 files that are not newline-terminated.)
\r
4642 The following changes have been made to the profiling code since the 1.71.1
\r
4645 ● Added support for profiling based on xml:lang and status attributes.
\r
4649 This is mainly a bug fix release, but it also includes two significant feature
\r
4652 Highlighting support added
\r
4654 The stylesheets now include support for source-code highlighting in output
\r
4655 of programlisting instances (controlled through the highlight.source
\r
4656 parameter). The Java-based implementation requires Saxon and makes use of
\r
4657 Michal Molhanec’s XSLTHL. More details are available at Jirka Kosek’s
\r
4660 http://xmlguru.cz/2006/07/docbook-syntax-highlighting
\r
4662 The support is currently limited to highlighting of XML, Java, PHP, Delphi,
\r
4663 Modula-2 sources, and INI files.
\r
4665 Changes to autoindexing
\r
4667 The templates that handle alternative indexing methods were reworked to
\r
4668 avoid errors produced by certain processors not being able to tolerate the
\r
4669 presence of unused functions. With this release, none of the code for the
\r
4670 'kimber' or 'kosek' methods is included in the default stylesheets. In
\r
4671 order to use one of those methods, your customization layer must import one
\r
4672 of the optional stylesheet modules:
\r
4674 ● html/autoidx-kosek.xsl
\r
4675 ● html/autoidx-kimber.xsl
\r
4676 ● fo/autoidx-kosek.xsl
\r
4677 ● fo/autoidx-kimber.xsl
\r
4679 See the index.method parameter reference page for more information.
\r
4681 Two other changes to note:
\r
4683 ● The default indexing method now can handle accented characters in
\r
4684 latin-based alphabets, not just English. This means accented latin
\r
4685 letters will group and sort with their unaccented counterpart.
\r
4686 ● The default value for the index.method parameter was changed from
\r
4687 'english' to 'basic' because now the default method can handle
\r
4688 latin-based alphabets, not just English.
\r
4690 The following is a list of changes that have been made since the 1.70.1
\r
4695 The following changes have been made to the common code since the 1.70.1
\r
4698 ● Added reference.autolabel parameter for controlling labels on
\r
4701 ● Support rows that are *completely* overlapped by the preceding row
\r
4703 ● New modules for supporting indexing extensions.
\r
4705 ● Support startinglinenumber on orderedlist
\r
4709 The following changes have been made to the extensions code since the 1.70.1
\r
4712 ● Completely reworked extensions build system; now uses NetBeans and ant
\r
4716 The following changes have been made to the fo code since the 1.70.1 release.
\r
4718 ● xsl:sort lang attribute now uses two-char substring of lang attribute.
\r
4720 ● Support titlecase "Java", "Perl", and "IDL" as values for the
\r
4721 language attribute on classsynopsis, etc. (instead of just
\r
4722 lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
\r
4723 (instead of just "cpp").
\r
4725 Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
\r
4726 to "Brian A. Vanderburg II".
\r
4728 ● Added support for the reference.autolabel param in (X)HTML and FO
\r
4731 ● Support rows that are *completely* overlapped by the preceding row
\r
4733 ● Rearranged templates for the 3 indexing methods
\r
4734 and changed method named 'english' to 'basic'.
\r
4736 ● New modules for supporting indexing extensions.
\r
4738 ● Turn off blank-body for fop1.extensions too since fop 0.92
\r
4739 does not support it either.
\r
4741 ● Add Xalan variant to test for exslt:node-set function.
\r
4742 Xalan can use function named node-set(), but doesn't
\r
4743 recognize it using function-available().
\r
4745 ● Added support to FO stylesheets for handling instances of Org
\r
4746 where it occurs outside of *info content. In HTML stylesheets,
\r
4747 moved handling of Org out of info.xsl and into inline.xsl. In both
\r
4748 FO and HTML stylesheets, added support for correctly processing
\r
4749 Affiliation and Jobtitle.
\r
4751 ● Don't output punctuation between Refname and Refpurpose if
\r
4752 Refpurpose is empty. Also corrected handling of Refsect2/title
\r
4753 instances, and removed some debugging stuff that was generated in
\r
4754 manpages output to mark the ends of sections.
\r
4756 ● Added new email.delimiters.enabled param. If non-zero (the
\r
4757 default), delimiters are generated around e-mail addresses (output
\r
4758 of the email element). If zero, the delimiters are suppressed.
\r
4760 ● Initial support of syntax highlighting of programlistings.
\r
4762 ● Chapter after preface should restart numbering of pages.
\r
4766 The following changes have been made to the html code since the 1.70.1 release.
\r
4768 ● xsl:sort lang attribute now uses two-char substring of lang attribute.
\r
4770 ● Support titlecase "Java", "Perl", and "IDL" as values for the
\r
4771 language attribute on classsynopsis, etc. (instead of just
\r
4772 lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
\r
4773 (instead of just "cpp").
\r
4775 Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
\r
4776 to "Brian A. Vanderburg II".
\r
4778 ● Added support for the reference.autolabel param in (X)HTML and FO
\r
4781 ● Support rows that are *completely* overlapped by the preceding row
\r
4783 ● Rearranged templates for the 3 indexing methods
\r
4784 and changed method named 'english' to 'basic'.
\r
4786 ● New modules for supporting indexing extensions.
\r
4788 ● Added several new HTML parameters for controlling appearance of
\r
4789 content on HTML title pages:
\r
4791 contrib.inline.enabled:
\r
4792 If non-zero (the default), output of the contrib element is
\r
4793 displayed as inline content rather than as block content.
\r
4795 othercredit.like.author.enabled:
\r
4796 If non-zero, output of the othercredit element on titlepages is
\r
4797 displayed in the same style as author and editor output. If zero
\r
4798 (the default), othercredit output is displayed using a style
\r
4799 different than that of author and editor.
\r
4801 blurb.on.titlepage.enabled:
\r
4802 If non-zero, output from authorblurb and personblurb elements is
\r
4803 displayed on title pages. If zero (the default), output from
\r
4804 those elements is suppressed on title pages (unless you are
\r
4805 using a titlepage customization that causes them to be included).
\r
4808 If non-zero (the default), a localized Edited by heading is
\r
4809 displayed above editor names in output of the editor element.
\r
4811 ● Add Xalan variant to test for exslt:node-set function.
\r
4812 Xalan can use function named node-set(), but doesn't
\r
4813 recognize it using function-available().
\r
4815 ● Added support to FO stylesheets for handling instances of Org
\r
4816 where it occurs outside of *info content. In HTML stylesheets,
\r
4817 moved handling of Org out of info.xsl and into inline.xsl. In both
\r
4818 FO and HTML stylesheets, added support for correctly processing
\r
4819 Affiliation and Jobtitle.
\r
4821 ● Don't output punctuation between Refname and Refpurpose if
\r
4822 Refpurpose is empty. Also corrected handling of Refsect2/title
\r
4823 instances, and removed some debugging stuff that was generated in
\r
4824 manpages output to mark the ends of sections.
\r
4826 ● Added new email.delimiters.enabled param. If non-zero (the
\r
4827 default), delimiters are generated around e-mail addresses (output
\r
4828 of the email element). If zero, the delimiters are suppressed.
\r
4830 ● Added qanda.nested.in.toc param. Default value is zero. If
\r
4831 non-zero, instances of "nested" Qandaentry (ones that are children
\r
4832 of Answer elements) are displayed in the TOC. Closes patch 1509018
\r
4833 (from Daniel Leidert). Currently on affects HTML output (no patch
\r
4834 for FO output provided).
\r
4836 ● Improved handling of relative locations generated files
\r
4838 ● Initial support of syntax highlighting of programlistings.
\r
4844 ● Support $keep.relative.image.uris also when chunking
\r
4848 The following changes have been made to the highlighting code since the 1.70.1
\r
4851 ● Initial support of syntax highlighting of programlistings.
\r
4855 The following changes have been made to the manpages code since the 1.70.1
\r
4858 ● Suppress footnote markers and output warning that footnotes are
\r
4859 not yet supported.
\r
4861 ● Handle instances of address/otheraddr/ulink in author et al in the
\r
4862 same way as email instances; that is, display them on the same
\r
4863 linke as the author, editor, etc., name.
\r
4865 ● Don't number or link-list any Ulink instance whose string value is
\r
4866 identical to the value of its url attribute. Just display it inline.
\r
4868 ● Don't output punctuation between Refname and Refpurpose if
\r
4869 Refpurpose is empty. Also corrected handling of Refsect2/title
\r
4870 instances, and removed some debugging stuff that was generated in
\r
4871 manpages output to mark the ends of sections.
\r
4873 ● Added new email.delimiters.enabled param. If non-zero (the
\r
4874 default), delimiters are generated around e-mail addresses (output
\r
4875 of the email element). If zero, the delimiters are suppressed.
\r
4877 ● In manpages output, if the last/nearest *info element for
\r
4878 particular Refentry has multiple Copyright and/or Legalnotice
\r
4879 children, process them all (not just the first ones). Closes bug
\r
4880 1524576. Thanks to Sam Steingold for the report and to Daniel
\r
4881 Leidert for providing a patch.
\r
4885 The following changes have been made to the params code since the 1.70.1
\r
4888 ● Added reference.autolabel parameter for controlling labels on
\r
4891 ● Added namespace declarations to document elements for all param files.
\r
4893 ● Updated index.method doc to describe revised setup for importing index
\r
4896 ● Added several new HTML parameters for controlling appearance of
\r
4897 content on HTML title pages:
\r
4899 contrib.inline.enabled:
\r
4900 If non-zero (the default), output of the contrib element is
\r
4901 displayed as inline content rather than as block content.
\r
4903 othercredit.like.author.enabled:
\r
4904 If non-zero, output of the othercredit element on titlepages is
\r
4905 displayed in the same style as author and editor output. If zero
\r
4906 (the default), othercredit output is displayed using a style
\r
4907 different than that of author and editor.
\r
4909 blurb.on.titlepage.enabled:
\r
4910 If non-zero, output from authorblurb and personblurb elements is
\r
4911 displayed on title pages. If zero (the default), output from
\r
4912 those elements is suppressed on title pages (unless you are
\r
4913 using a titlepage customization that causes them to be included).
\r
4916 If non-zero (the default), a localized Edited by heading is
\r
4917 displayed above editor names in output of the editor element.
\r
4919 ● Added new email.delimiters.enabled param. If non-zero (the
\r
4920 default), delimiters are generated around e-mail addresses (output
\r
4921 of the email element). If zero, the delimiters are suppressed.
\r
4923 ● Added qanda.nested.in.toc param. Default value is zero. If
\r
4924 non-zero, instances of "nested" Qandaentry (ones that are children
\r
4925 of Answer elements) are displayed in the TOC. Closes patch 1509018
\r
4926 (from Daniel Leidert). Currently on affects HTML output (no patch
\r
4927 for FO output provided).
\r
4929 ● Initial support of syntax highlighting of programlistings.
\r
4933 The following changes have been made to the tools code since the 1.70.1
\r
4936 ● Racheted down font sizes of headings in example makefile FO output.
\r
4938 ● Added param and attribute set to example makefile, for getting
\r
4939 wrapping in verbatims in FO output.
\r
4941 ● Renamed Makefile.paramDoc to Makefile.docParam.
\r
4943 ● Added Makefile.paramDoc file, for creating versions of param.xsl
\r
4944 files with doc embedded.
\r
4946 ● Added variable to example makefile for controlling whether HTML or
\r
4947 XHTML is generated.
\r
4951 This is a stable release of the 1.70 stylesheets. It includes only a few small
\r
4952 changes from 1.70.0.
\r
4954 The following is a list of changes that have been made since the 1.70.0
\r
4959 The following changes have been made to the fo code since the 1.70.0 release.
\r
4961 ● Added three new attribute sets (revhistory.title.properties,
\r
4962 revhistory.table.properties and revhistory.table.cell.properties) for
\r
4963 controlling appearance of revhistory in FO output.
\r
4965 Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/
\r
4966 titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params
\r
4967 /revhistory.table.properties.xml,1.1; params/
\r
4968 revhistory.title.properties.xml,1.1 - Jirka Kosek
\r
4970 ● Support DBv5 revisions with full author name (not only authorinitials)
\r
4972 Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek
\r
4976 The following changes have been made to the html code since the 1.70.0 release.
\r
4978 ● Support DBv5 revisions with full author name (not only authorinitials)
\r
4980 Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek
\r
4984 The following changes have been made to the htmlhelp code since the 1.70.0
\r
4987 ● htmlhelp.generate.index is now param, not variable. This means that you can
\r
4988 override its setting from outside. This is useful when you generate
\r
4989 indexterms on the fly (see http://www.xml.com/pub/a/2004/07/14/dbndx.html?
\r
4992 Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek
\r
4994 ● Support chunk.tocs.and.lots in HTML Help
\r
4996 Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek
\r
5000 The following changes have been made to the params code since the 1.70.0
\r
5003 ● Added three new attribute sets (revhistory.title.properties,
\r
5004 revhistory.table.properties and revhistory.table.cell.properties) for
\r
5005 controlling appearance of revhistory in FO output.
\r
5007 Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/
\r
5008 titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params
\r
5009 /revhistory.table.properties.xml,1.1; params/
\r
5010 revhistory.title.properties.xml,1.1 - Jirka Kosek
\r
5014 As with all DocBook Project dot-zero releases, this is an experimental release.
\r
5015 It will be followed shortly by a stable release.
\r
5017 This release adds a number of new features, including:
\r
5019 ● support for selecting alternative index-collation methods (in particular,
\r
5020 support for using a collation library developed by Eliot Kimber)
\r
5022 ● improved handling of DocBook 5 document instances (through a
\r
5023 namespace-stripping mechanism)
\r
5025 ● full support for CALS and HTML tables in manpages output
\r
5027 ● a mechanism for preserving relative URIs in documents that make use of
\r
5030 ● support for the "new" .90 version of FOP
\r
5032 ● enhanced capabilities for controlling formatting of lists in HTML and FO
\r
5035 ● autogeneration of AUTHOR and COPYRIGHT sections in manpages output
\r
5037 ● support for generating crop marks in FO/PDF output
\r
5039 ● support for qandaset as a root element in FO output
\r
5041 ● support for floatstyle and orient on all table types
\r
5043 ● support for floatstyle in figure, and example
\r
5045 ● pgwide.properties attribute-set supports extending figure, example and
\r
5046 table into the left indent area instead of spanning multiple columns.
\r
5048 The following is a detailed list of enhancements and API changes that have been
\r
5049 made since the 1.69.1 release.
\r
5053 The following changes have been made to the common code since the 1.69.1
\r
5056 ● Add the xsl:key for the kimber indexing method.
\r
5058 Modified: common/autoidx-ng.xsl,1.2 - Robert Stayton
\r
5060 ● Add support for qandaset.
\r
5062 Modified: common/labels.xsl,1.37; common/subtitles.xsl,1.7; common/
\r
5063 titles.xsl,1.35 - Robert Stayton
\r
5065 ● Support dbhtml/dbfo start PI for orderedlist numbering in both HTML and FO
\r
5067 Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman Walsh
\r
5069 ● Added CVS header.
\r
5071 Modified: common/stripns.xsl,1.12 - Robert Stayton
\r
5073 ● Changed content model of text element to ANY rather than #PCDATA because
\r
5074 they could contain markup.
\r
5076 Modified: common/targetdatabase.dtd,1.7 - Robert Stayton
\r
5078 ● Added refentry.meta.get.quietly param.
\r
5080 If zero (the default), notes and warnings about "missing" markup are
\r
5081 generated during gathering of refentry metadata. If non-zero, the metadata
\r
5082 is gathered "quietly" -- that is, the notes and warnings are suppressed.
\r
5084 NOTE: If you are processing a large amount of refentry content, you may be
\r
5085 able to speed up processing significantly by setting a non-zero value for
\r
5086 refentry.meta.get.quietly.
\r
5088 Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/
\r
5089 param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
\r
5092 ● After namespace stripping, the source document is the temporary tree
\r
5093 created by the stripping process and it has the wrong base URI for relative
\r
5094 references. Earlier versions of this code used to try to fix that by
\r
5095 patching the elements with relative @fileref attributes. That was
\r
5096 inadequate because it calculated an absolute base URI without considering
\r
5097 that there might be xml:base attributes already in effect. It seems obvious
\r
5098 now that the right thing to do is simply to put the xml:base on the root of
\r
5099 the document. And that seems to work.
\r
5101 Modified: common/stripns.xsl,1.7 - Norman Walsh
\r
5103 ● Added support for "software" and "sectdesc" class values on refmiscinfo;
\r
5104 "software" is treated identically to "source", and "setdesc" is treated
\r
5105 identically to "manual".
\r
5107 Modified: common/refentry.xsl,1.10; params/
\r
5108 man.th.extra2.max.length.xml,1.3; params/
\r
5109 refentry.source.name.profile.xml,1.4 - Michael(tm) Smith
\r
5111 ● Added support for DocBook 5 namespace-stripping in manpages stylesheet.
\r
5112 Closes request #1210692.
\r
5114 Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm)
\r
5117 ● Added <xsl:template match="/"> to make stripns.xsl usable as a standalone
\r
5118 stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that DocBook
\r
5119 XSLT drivers that include this stylesheet all override the match="/"
\r
5122 Modified: common/stripns.xsl,1.4 - Michael(tm) Smith
\r
5124 ● Number figures, examples, and tables from book if there is no prefix (i.e.
\r
5125 if chapter.autolabel is set to 0). This avoids having the list of figures
\r
5126 where the figures mysteriously restart their numeration periodically when
\r
5127 chapter.autolabel is set to 0.
\r
5129 Modified: common/labels.xsl,1.36 - David Cramer
\r
5131 ● Add task template in title.markup mode.
\r
5133 Modified: common/titles.xsl,1.34 - Robert Stayton
\r
5135 ● Add children (with ids) of formal objects to target data.
\r
5137 Modified: common/targets.xsl,1.10 - Robert Stayton
\r
5139 ● Added support for case when personname doesn't contain specific name markup
\r
5140 (as allowed in DocBook 5.0)
\r
5142 Modified: common/common.xsl,1.54 - Jirka Kosek
\r
5146 The following changes have been made to the extensions code since the 1.69.1
\r
5149 ● Support Xalan 2.7
\r
5151 Modified: extensions/xalan27/.cvsignore,1.1; extensions/xalan27/
\r
5152 build.xml,1.1; extensions/xalan27/nbproject/.cvsignore,1.1; extensions/
\r
5153 xalan27/nbproject/build-impl.xml,1.1; extensions/xalan27/nbproject/
\r
5154 genfiles.properties,1.1; extensions/xalan27/nbproject/
\r
5155 project.properties,1.1; extensions/xalan27/nbproject/project.xml,1.1;
\r
5156 extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1; extensions/xalan27/
\r
5157 src/com/nwalsh/xalan/Callout.java,1.1; extensions/xalan27/src/com/nwalsh/
\r
5158 xalan/FormatCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
\r
5159 FormatDingbatCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
\r
5160 FormatGraphicCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
\r
5161 FormatTextCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
\r
5162 FormatUnicodeCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
\r
5163 Func.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
\r
5164 ImageIntrinsics.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
\r
5165 Params.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1;
\r
5166 extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1; extensions/xalan27/
\r
5167 src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman Walsh
\r
5169 ● Handle the case where the imageFn is actually a URI. This still needs work.
\r
5171 Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4 -
\r
5176 The following changes have been made to the fo code since the 1.69.1 release.
\r
5178 ● Adapted to the new indexing code. Now works just like a wrapper that calls
\r
5179 kosek indexing method, originally implemented here.
\r
5181 Modified: fo/autoidx-ng.xsl,1.5 - Jirka Kosek
\r
5183 ● Added parameters for header/footer table minimum height.
\r
5185 Modified: fo/pagesetup.xsl,1.60; fo/param.ent,1.100; fo/param.xweb,1.113 -
\r
5188 ● Add the index.method parameter.
\r
5190 Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert Stayton
\r
5192 ● Integrate support for three indexing methods: - the original English-only
\r
5193 method. - Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's
\r
5194 method using Saxon extensions. Use the 'index.method' parameter to select.
\r
5196 Modified: fo/autoidx.xsl,1.38 - Robert Stayton
\r
5198 ● Add support for TOC for qandaset in fo output.
\r
5200 Modified: fo/autotoc.xsl,1.30; fo/qandaset.xsl,1.20 - Robert Stayton
\r
5202 ● Added parameter ulink.hyphenate.chars. Added parameter insert.link
\r
5205 Modified: fo/param.ent,1.98; fo/param.xweb,1.111 - Robert Stayton
\r
5207 ● Implemented feature request #942524 to add insert.link.page.number to allow
\r
5208 link element cross references to have a page number.
\r
5210 Modified: fo/xref.xsl,1.67 - Robert Stayton
\r
5212 ● Add support for ulink.hyphenate.chars so more characters can be break
\r
5215 Modified: fo/xref.xsl,1.66 - Robert Stayton
\r
5217 ● Implemented patch #1075144 to make the url text in a ulink in FO output an
\r
5218 active link as well.
\r
5220 Modified: fo/xref.xsl,1.65 - Robert Stayton
\r
5222 ● table footnotes now have their own table.footnote.properties attribute set.
\r
5224 Modified: fo/footnote.xsl,1.23 - Robert Stayton
\r
5226 ● Add qandaset to root.elements.
\r
5228 Modified: fo/docbook.xsl,1.41 - Robert Stayton
\r
5230 ● Added mode="page.sequence" to make it easier to put content into a page
\r
5231 sequence. First used for qandaset.
\r
5233 Modified: fo/component.xsl,1.37 - Robert Stayton
\r
5235 ● Implemented feature request #1434408 to support formatting of biblioentry.
\r
5237 Modified: fo/biblio.xsl,1.35 - Robert Stayton
\r
5239 ● Added biblioentry.properties.
\r
5241 Modified: fo/param.ent,1.97; fo/param.xweb,1.110 - Robert Stayton
\r
5243 ● Support PTC/Arbortext bookmarks
\r
5245 Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman Walsh
\r
5247 ● Added table.footnote.properties to permit table footnotes to format
\r
5248 differently from regular footnotes.
\r
5250 Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert Stayton
\r
5252 ● Refactored table templates to unify their processing and support all
\r
5253 options in all types. Now table and informaltable, in both Cals and Html
\r
5254 markup, use the same templates where possible, and all support pgwide,
\r
5255 rotation, and floats. There is also a placeholder table.container template
\r
5256 to support wrapping a table in a layout table, so the XEP table title
\r
5257 "continued" extension can be more easily implemented.
\r
5259 Modified: fo/formal.xsl,1.52; fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 -
\r
5262 ● Added new attribute set toc.line.properties for controlling appearance of
\r
5265 Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95; fo/param.xweb,1.108 -
\r
5268 ● Added support for float to example and equation. Added support for pgwide
\r
5269 to figure, example, and equation (the latter two via a dbfo pgwide="1"
\r
5270 processing instruction).
\r
5272 Modified: fo/formal.xsl,1.51 - Robert Stayton
\r
5274 ● Add pgwide.properties attribute-set.
\r
5276 Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert Stayton
\r
5278 ● Added refclass.suppress param.
\r
5280 If the value of refclass.suppress is non-zero, then display refclass
\r
5281 contents is suppressed in output. Affects HTML and FO output only.
\r
5283 Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html
\r
5284 /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith
\r
5286 ● Improved support for task subelements
\r
5288 Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - Jirka Kosek
\r
5290 ● Adjusted spacing around K&R-formatted Funcdef and Paramdef output such that
\r
5291 it can more easily be discerned where one ends and the other begins. Closes
\r
5294 Modified: fo/synop.xsl,1.18 - Michael(tm) Smith
\r
5296 ● Made handling of paramdef/parameter in FO output consistent with that in
\r
5297 HTML and manpages output. Closes #1213259.
\r
5299 Modified: fo/synop.xsl,1.17 - Michael(tm) Smith
\r
5301 ● Made handling of Refnamediv consistent with formatting in HTML and manpages
\r
5302 output; specifically, changed so that Refname (comma-separated list of
\r
5303 multiple instances found) is used (instead of Refentrytitle as previously),
\r
5304 then em-dash, then the Refpurpose. Closes #1212562.
\r
5306 Modified: fo/refentry.xsl,1.30 - Michael(tm) Smith
\r
5308 ● Added output of Releaseinfo to recto titlepage ("copyright" page) for Book
\r
5309 in FO output. This makes it consistent with HTML output. Closes #1327034.
\r
5310 Thanks to Paul DuBois for reporting.
\r
5312 Modified: fo/titlepage.templates.xml,1.28 - Michael(tm) Smith
\r
5314 ● Added condition for setting block-progression-dimension.minimum on
\r
5315 table-row, instead of height, when fop1.extensions is non-zero. For an
\r
5316 explanation of the reason for the change, see: http://wiki.apache.org/
\r
5317 xmlgraphics-fop/Troubleshooting/CommonLogMessages
\r
5319 Modified: fo/pagesetup.xsl,1.59 - Michael(tm) Smith
\r
5321 ● Added new refclass.suppress param for suppressing display of Refclass in
\r
5322 HTML and FO output. Did not add it to manpages because manpages stylesheet
\r
5323 is currently just silently ignoring Refclass anyway. Closes request #
\r
5324 1461065. Thanks to Davor Ocelic (docelic) for reporting.
\r
5326 Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - Michael(tm) Smith
\r
5328 ● Add support for keep-together PI to informal objects.
\r
5330 Modified: fo/formal.xsl,1.50 - Robert Stayton
\r
5332 ● Add support for fop1.extensions.
\r
5334 Modified: fo/formal.xsl,1.49; fo/graphics.xsl,1.44; fo/table.xsl,1.47 -
\r
5337 ● Add support for fop1 bookmarks.
\r
5339 Modified: fo/docbook.xsl,1.39 - Robert Stayton
\r
5341 ● Add fop1.extentions parameter to add support for fop development version.
\r
5343 Modified: fo/param.ent,1.92; fo/param.xweb,1.105 - Robert Stayton
\r
5345 ● Start supporting fop development version, which will become fop version 1.
\r
5347 Modified: fo/fop1.xsl,1.1 - Robert Stayton
\r
5349 ● Add template for task in mode="xref-to".
\r
5351 Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert Stayton
\r
5353 ● table footnotes now also get footnote.properties attribute-set.
\r
5355 Modified: fo/footnote.xsl,1.22 - Robert Stayton
\r
5357 ● Added index.separator named template to compute the separator punctuation
\r
5360 Modified: fo/autoidx.xsl,1.36 - Robert Stayton
\r
5362 ● Added support for link, olink, and xref within OO Classsynopsis and
\r
5363 children. (Because DocBook NG/5 allows it).
\r
5365 Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith
\r
5367 ● Support date as an inline
\r
5369 Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh
\r
5371 ● Added new parameter keep.relative.image.uris
\r
5373 Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html
\r
5374 /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh
\r
5376 ● Map Unicode space characters U+2000-U+200A to fo:leaders.
\r
5378 Modified: fo/docbook.xsl,1.38; fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 -
\r
5381 ● Output a real em dash for em-dash dingbat (instead of two hypens).
\r
5383 Modified: fo/fo.xsl,1.7 - Michael(tm) Smith
\r
5385 ● Support default label width parameters for itemized and ordered lists
\r
5387 Modified: fo/lists.xsl,1.64; fo/param.ent,1.90; fo/param.xweb,1.103; params
\r
5388 /itemizedlist.label.width.xml,1.1; params/orderedlist.label.width.xml,1.1 -
\r
5391 ● Generate localized title for Refsynopsisdiv if no appropriate Title
\r
5392 descendant found in source. Closes #1212398. This change makes behavior for
\r
5393 the Synopsis title consistent with the behavior of HTML and manpages
\r
5396 Also, added xsl:use-attribute-sets="normal.para.spacing" to block generated
\r
5397 for Cmdsynopsis output. Previously, that block had no spacing at all
\r
5398 specified, which resulted it being crammed up to closely to the Synopsis
\r
5401 Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm) Smith
\r
5403 ● Added parameters to support localization of index item punctuation.
\r
5405 Modified: fo/autoidx.xsl,1.35 - Robert Stayton
\r
5407 ● Added index.number.separator, index.range.separator, and
\r
5408 index.term.separator parameters to support localization of punctuation in
\r
5411 Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert Stayton
\r
5413 ● Added "Cross References" section in HTML doc (for consistency with the FO
\r
5414 doc). Also, moved the existing FO "Cross References" section to follow the
\r
5415 "Linking" section.
\r
5417 Modified: fo/param.xweb,1.101; html/param.xweb,1.95 - Michael(tm) Smith
\r
5419 ● Added ID attribues to all Reference elements (e.g., id="tables" for the doc
\r
5420 for section on Table params). So pages for all subsections of ref docs now
\r
5421 have stable filenames instead of arbitrary generated filenames.
\r
5423 Modified: fo/param.xweb,1.100; html/param.xweb,1.94 - Michael(tm) Smith
\r
5425 ● Added two new parameters for handling of multi-term varlistentry elements:
\r
5427 variablelist.term.break.after: When the variablelist.term.break.after is
\r
5428 non-zero, it will generate a line break after each term multi-term
\r
5431 variablelist.term.separator: When a varlistentry contains multiple term
\r
5432 elements, the string specified in the value of the
\r
5433 variablelist.term.separator parameter is placed after each term except the
\r
5434 last. The default is ", " (a comma followed by a space). To suppress
\r
5435 rendering of the separator, set the value of variablelist.term.separator to
\r
5436 the empty string ("").
\r
5438 These parameters are primarily intended to be useful if you have multi-term
\r
5439 varlistentries that have long terms.
\r
5441 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
\r
5442 long terms" doc that demonstrated the value of having these options.
\r
5444 Also, added normalize-space() call to processing of each term.
\r
5446 This change affects all output formats (HTML, PDF, manpages). The default
\r
5447 behavior should pretty much remain the same as before, but it is possible
\r
5448 (as always) that the change may introduce some new bugginess.
\r
5450 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
\r
5451 lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
\r
5452 lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
\r
5453 variablelist.term.break.after.xml,1.1; params/
\r
5454 variablelist.term.separator.xml,1.1 - Michael(tm) Smith
\r
5456 ● Add sidebar titlepage placeholder attset for styles.
\r
5458 Modified: fo/titlepage.xsl,1.37 - Robert Stayton
\r
5460 ● Add titlepage for sidebar.
\r
5462 Modified: fo/titlepage.templates.xml,1.27 - Robert Stayton
\r
5464 ● Implemented RFE #1292615.
\r
5466 Added bunch of new parameters (attribute sets) that affect list
\r
5467 presentation: list.block.properties, itemizedlist.properties, orderedlist
\r
5468 .properties, itemizedlist.label.properties and orderedlist.label
\r
5469 .properties. Default behaviour of stylesheets has not been changed but
\r
5470 further customizations will be much more easier.
\r
5472 Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; params/
\r
5473 itemizedlist.label.properties.xml,1.1; params/
\r
5474 itemizedlist.properties.xml,1.1; params/list.block.properties.xml,1.1;
\r
5475 params/orderedlist.label.properties.xml,1.1; params/
\r
5476 orderedlist.properties.xml,1.1 - Jirka Kosek
\r
5478 ● Implemented RFE #1242092.
\r
5480 You can enable crop marks in your document by setting crop.marks=1 and
\r
5481 xep.extensions=1. Appearance of crop marks can be controlled by parameters
\r
5482 crop.mark.bleed (6pt), crop.mark.offset (24pt) and crop.mark.width (0.5pt).
\r
5484 Also there is new named template called user-xep-pis. You can overwrite it
\r
5485 in order to produce some PIs that can control XEP as described in http://
\r
5486 www.renderx.com/reference.html#Output_Formats
\r
5488 Modified: fo/docbook.xsl,1.36; fo/param.ent,1.86; fo/param.xweb,1.97; fo/
\r
5489 xep.xsl,1.23; params/crop.mark.bleed.xml,1.1; params/
\r
5490 crop.mark.offset.xml,1.1; params/crop.mark.width.xml,1.1; params/
\r
5491 crop.marks.xml,1.1 - Jirka Kosek
\r
5495 The following changes have been made to the html code since the 1.69.1 release.
\r
5497 ● implemented index.method parameter and three methods.
\r
5499 Modified: html/autoidx.xsl,1.28 - Robert Stayton
\r
5501 ● added index.method parameter to support 3 indexing methods.
\r
5503 Modified: html/param.ent,1.94; html/param.xweb,1.103 - Robert Stayton
\r
5505 ● Implemented feature request #1072510 as a processing instruction to permit
\r
5506 including external HTML content into HTML output.
\r
5508 Modified: html/pi.xsl,1.9 - Robert Stayton
\r
5510 ● Added new parameter chunk.tocs.and.lots.has.title which controls presence
\r
5511 of title in a separate chunk with ToC/LoT. Disabling title can be very
\r
5512 useful if you are generating frameset output (well, yes those frames, but
\r
5513 some customers really want them ;-).
\r
5515 Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; html/
\r
5516 param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
\r
5519 ● Support dbhtml/dbfo start PI for orderedlist numbering in both HTML and FO
\r
5521 Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman Walsh
\r
5523 ● Allow ToC without title also for set and book.
\r
5525 Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 - Jirka Kosek
\r
5527 ● Implemented floats uniformly for figure, example, equation and
\r
5528 informalfigure, informalexample, and informalequation.
\r
5530 Modified: html/formal.xsl,1.22 - Robert Stayton
\r
5532 ● Added the autotoc.label.in.hyperlink param.
\r
5534 If the value of autotoc.label.in.hyperlink is non-zero, labels are included
\r
5535 in hyperlinked titles in the TOC. If it is instead zero, labels are still
\r
5536 displayed prior to the hyperlinked titles, but are not hyperlinked along
\r
5539 Closes patch #1065868. Thanks to anatoly techtonik for the patch.
\r
5541 Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; html/
\r
5542 param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - Michael(tm)
\r
5545 ● Added two new params: html.head.legalnotice.link.types and html.head.
\r
5546 legalnotice.link.multiple.
\r
5548 If the value of the generate.legalnotice.link is non-zero, then the
\r
5549 stylesheet generates (in the head section of the HTML source) either a
\r
5550 single HTML link element or, if the value of the html.head.legalnotice.link
\r
5551 .multiple is non-zero, one link element for each link type specified. Each
\r
5552 link has the following attributes:
\r
5554 - a rel attribute whose value is derived from the value of html.head.
\r
5555 legalnotice.link.types
\r
5557 - an href attribute whose value is set to the URL of the file containing
\r
5560 - a title attribute whose value is set to the title of the corresponding
\r
5561 legalnotice (or a title programatically determined by the stylesheet)
\r
5565 <link rel="copyright" href="ln-id2524073.html" title="Legal Notice">
\r
5567 Closes #1476450. Thanks to Sam Steingold.
\r
5569 Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; html/
\r
5570 param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; params/
\r
5571 html.head.legalnotice.link.multiple.xml,1.1; params/
\r
5572 html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith
\r
5574 ● Added refclass.suppress param.
\r
5576 If the value of refclass.suppress is non-zero, then display refclass
\r
5577 contents is suppressed in output. Affects HTML and FO output only.
\r
5579 Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html
\r
5580 /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith
\r
5582 ● Improved support for task subelements
\r
5584 Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - Jirka Kosek
\r
5586 ● Added new refclass.suppress param for suppressing display of Refclass in
\r
5587 HTML and FO output. Did not add it to manpages because manpages stylesheet
\r
5588 is currently just silently ignoring Refclass anyway. Closes request #
\r
5589 1461065. Thanks to Davor Ocelic (docelic) for reporting.
\r
5591 Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - Michael(tm) Smith
\r
5593 ● Process alt text with normalize-space(). Replace tab indents with spaces.
\r
5595 Modified: html/graphics.xsl,1.57 - Robert Stayton
\r
5597 ● Content of citation element is automatically linked to the bibliographic
\r
5598 entry with the corresponding abbrev.
\r
5600 Modified: html/biblio.xsl,1.26; html/inline.xsl,1.47; html/xref.xsl,1.58 -
\r
5603 ● Add template for task in mode="xref-to".
\r
5605 Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert Stayton
\r
5607 ● Suppress ID warnings if the .warnings parameter is 0
\r
5609 Modified: html/html.xsl,1.17 - Norman Walsh
\r
5611 ● Add support for floatstyle to figure.
\r
5613 Modified: html/formal.xsl,1.21 - Robert Stayton
\r
5615 ● Handling of xref to area/areaset need support in extensions code also. I
\r
5616 currently have no time to touch extensions code, so code is here to be
\r
5617 enabled when extension is fixed also.
\r
5619 Modified: html/xref.xsl,1.56 - Jirka Kosek
\r
5621 ● Added 3 parameters for overriding gentext for index punctuation.
\r
5623 Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert Stayton
\r
5625 ● Added parameters to support localization of index item punctuation. Added
\r
5626 index.separator named template to compute the separator punctuation based
\r
5629 Modified: html/autoidx.xsl,1.27 - Robert Stayton
\r
5631 ● Added a <div class="{$class}-contents"> wrapper around output of contents
\r
5632 of all formal objects. Also, added an optional <br class="{class}-break"/>
\r
5633 linebreak after all formal objects.
\r
5635 WARNING: Because this change places an additional DIV between the DIV
\r
5636 wrapper for the equation and the equation contents, it may break some
\r
5637 existing CSS stylesheets that have been created with the assumption that
\r
5638 there would never be an intervening DIV there.
\r
5640 The following is an example of what Equation output looks like as a result
\r
5641 of the changes described above.
\r
5643 <div class="equation"> <a name="three" id="three"></a>
\r
5645 <p class="title"><b>(1.3)</b></p>
\r
5647 <div class="equation-contents"> <span class="mathphrase">1+1=3</span> </
\r
5648 div> </div><br class="equation-break">
\r
5650 Rationale: These changes allow CSS control of the placement of the
\r
5651 formal-object title relative to the formal-object contents. For example,
\r
5652 using the CSS "float" property enables the title and contents to be
\r
5653 rendered on the same line. Example stylesheet:
\r
5655 .equation { margin-top: 20px; margin-bottom: 20px; } .equation-contents {
\r
5658 .equation .title { margin-top: 0; float: right; margin-right: 200px; }
\r
5660 .equation .title b { font-weight: normal; }
\r
5662 .equation-break { clear: both; }
\r
5664 Note that the purpose of the ".equation-break" class is to provide a way to
\r
5665 clear off the floats.
\r
5667 If you want to instead have the equation title rendered to the left of the
\r
5668 equation contents, you can do something like this:
\r
5670 .equation { margin-top: 20px; width: 300px; margin-bottom: 20px; }
\r
5671 .equation-contents { float: right; }
\r
5673 .equation .title { margin-top: 0; float: left; margin-right: 200px; }
\r
5675 .equation .title b { font-weight: normal; }
\r
5677 .equation-break { clear: both; }
\r
5679 Modified: html/formal.xsl,1.20 - Michael(tm) Smith
\r
5681 ● Added a chunker.output.quiet top-level parameter so that the chunker can be
\r
5682 made quiet by default
\r
5684 Modified: html/chunker.xsl,1.26 - Norman Walsh
\r
5686 ● Added support for link, olink, and xref within OO Classsynopsis and
\r
5687 children. (Because DocBook NG/5 allows it).
\r
5689 Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith
\r
5691 ● New parameter: id.warnings. If non-zero, warnings are generated for titled
\r
5692 objects that don't have titles. True by default; I wonder if this will be
\r
5695 Modified: html/biblio.xsl,1.25; html/component.xsl,1.27; html/
\r
5696 division.xsl,1.11; html/formal.xsl,1.19; html/glossary.xsl,1.20; html/
\r
5697 html.xsl,1.13; html/index.xsl,1.16; html/param.ent,1.88; html/
\r
5698 param.xweb,1.97; html/refentry.xsl,1.22; html/sections.xsl,1.30; params/
\r
5699 id.warnings.xml,1.1 - Norman Walsh
\r
5701 ● If the keep.relative.image.uris parameter is true, don't use the absolute
\r
5702 URI (as calculated from xml:base) in the img src attribute, us the value
\r
5703 the author specified. Note that we still have to calculate the absolute
\r
5704 filename for use in the image intrinsics extension.
\r
5706 Modified: html/graphics.xsl,1.56 - Norman Walsh
\r
5708 ● Support date as an inline
\r
5710 Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh
\r
5712 ● Added new parameter keep.relative.image.uris
\r
5714 Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html
\r
5715 /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh
\r
5717 ● Added two new parameters for handling of multi-term varlistentry elements:
\r
5719 variablelist.term.break.after: When the variablelist.term.break.after is
\r
5720 non-zero, it will generate a line break after each term multi-term
\r
5723 variablelist.term.separator: When a varlistentry contains multiple term
\r
5724 elements, the string specified in the value of the
\r
5725 variablelist.term.separator parameter is placed after each term except the
\r
5726 last. The default is ", " (a comma followed by a space). To suppress
\r
5727 rendering of the separator, set the value of variablelist.term.separator to
\r
5728 the empty string ("").
\r
5730 These parameters are primarily intended to be useful if you have multi-term
\r
5731 varlistentries that have long terms.
\r
5733 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
\r
5734 long terms" doc that demonstrated the value of having these options.
\r
5736 Also, added normalize-space() call to processing of each term.
\r
5738 This change affects all output formats (HTML, PDF, manpages). The default
\r
5739 behavior should pretty much remain the same as before, but it is possible
\r
5740 (as always) that the change may introduce some new bugginess.
\r
5742 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
\r
5743 lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
\r
5744 lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
\r
5745 variablelist.term.break.after.xml,1.1; params/
\r
5746 variablelist.term.separator.xml,1.1 - Michael(tm) Smith
\r
5748 ● Added "wrapper-name" param to inline.charseq named template, enabling it to
\r
5749 output inlines other than just "span". Acronym and Abbrev templates now use
\r
5750 inline.charseq to output HTML "acronym" and "abbr" elements (instead of
\r
5751 "span"). Closes #1305468. Thanks to Sam Steingold for suggesting the
\r
5754 Modified: html/inline.xsl,1.45 - Michael(tm) Smith
\r
5758 The following changes have been made to the manpages code since the 1.69.1
\r
5761 ● Added the following params:
\r
5763 - man.indent.width (string-valued) - man.indent.refsect (boolean) -
\r
5764 man.indent.blurbs (boolean) - man.indent.lists (boolean) -
\r
5765 man.indent.verbatims (boolean)
\r
5767 Note that in earlier snapshots, man.indent.width was named
\r
5768 man.indentation.default.value and the boolean params had names like
\r
5769 man.indentation.*.adjust. Also the man.indent.blurbs param was called
\r
5770 man.indentation.authors.adjust (or something).
\r
5772 The behavior now is: If the value of a particular man.indent.* boolean
\r
5773 param is non-zero, the corresponding contents (refsect*, list items,
\r
5774 authorblurb/personblurb, vervatims) are displayed with a left margin
\r
5775 indented by a width equal to the value of man.indent.width.
\r
5777 Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74;
\r
5778 manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
\r
5779 manpages/param.ent,1.22; manpages/param.xweb,1.24; manpages/
\r
5780 refentry.xsl,1.14; params/man.indent.lists.xml,1.1; params/
\r
5781 man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; params/
\r
5782 man.indent.width.xml,1.1 - Michael(tm) Smith
\r
5784 ● Added man.table.footnotes.divider param.
\r
5786 In each table that contains footenotes, the string specified by the man.
\r
5787 table.footnotes.divider parameter is output before the list of footnotes
\r
5790 Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; manpages/
\r
5791 param.ent,1.21; manpages/param.xweb,1.23; params/
\r
5792 man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith
\r
5794 ● Added the man.output.in.separate.dir, man.output.base.dir, and
\r
5795 man.output.subdirs.enabled parameters.
\r
5797 The man.output.base.dir parameter specifies the base directory into which
\r
5798 man-page files are output. The man.output.subdirs.enabled parameter
\r
5799 controls whether the files are output in subdirectories within the base
\r
5802 The values of the man.output.base.dir and man.output.subdirs.enabled
\r
5803 parameters are used only if the value of man.output.in.separate.dir
\r
5804 parameter is non-zero. If the value of man.output.in.separate.dir is zero,
\r
5805 man-page files are not output in a separate directory.
\r
5807 Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; manpages/
\r
5808 param.xweb,1.22; params/man.output.base.dir.xml,1.1; params/
\r
5809 man.output.in.separate.dir.xml,1.1; params/
\r
5810 man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith
\r
5812 ● Added man.font.table.headings and man.font.table.title params, for
\r
5813 controlling font in table headings and titles.
\r
5815 Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; manpages/
\r
5816 param.xweb,1.21; params/man.font.table.headings.xml,1.1; params/
\r
5817 man.font.table.title.xml,1.1 - Michael(tm) Smith
\r
5819 ● Added man.font.funcsynopsisinfo and man.font.funcprototype params, for
\r
5820 specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and
\r
5821 funcprototype output.
\r
5823 Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; manpages/
\r
5824 param.ent,1.18; manpages/param.xweb,1.20; manpages/synop.xsl,1.29; manpages
\r
5825 /table.xsl,1.21; params/man.font.funcprototype.xml,1.1; params/
\r
5826 man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith
\r
5828 ● Added man.segtitle.suppress param.
\r
5830 If the value of man.segtitle.suppress is non-zero, then display of segtitle
\r
5831 contents is suppressed in output.
\r
5833 Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; manpages/
\r
5834 param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - Michael(tm) Smith
\r
5836 ● Added man.output.manifest.enabled and man.output.manifest.filename params.
\r
5838 If man.output.manifest.enabled is non-zero, a list of filenames for man
\r
5839 pages generated by the stylesheet transformation is written to the file
\r
5840 named by man.output.manifest.filename
\r
5842 Modified: manpages/docbook.xsl,1.67; manpages/other.xsl,1.19; manpages/
\r
5843 param.ent,1.16; manpages/param.xweb,1.18; params/
\r
5844 man.output.manifest.enabled.xml,1.1; params/
\r
5845 man.output.manifest.filename.xml,1.1; tools/make/Makefile.DocBook,1.4 -
\r
5848 ● Added refentry.meta.get.quietly param.
\r
5850 If zero (the default), notes and warnings about "missing" markup are
\r
5851 generated during gathering of refentry metadata. If non-zero, the metadata
\r
5852 is gathered "quietly" -- that is, the notes and warnings are suppressed.
\r
5854 NOTE: If you are processing a large amount of refentry content, you may be
\r
5855 able to speed up processing significantly by setting a non-zero value for
\r
5856 refentry.meta.get.quietly.
\r
5858 Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/
\r
5859 param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
\r
5862 ● Changed names of all boolean indentation params to man.indent.* Also
\r
5863 discarded individual man.indent.*.value params and switched to just using a
\r
5864 common man.indent.width param (3n by default).
\r
5866 Modified: manpages/docbook.xsl,1.66; manpages/info.xsl,1.19; manpages/
\r
5867 lists.xsl,1.29; manpages/other.xsl,1.18; manpages/refentry.xsl,1.13 -
\r
5870 ● Added boolean man.output.in.separate.dir param, to control whether or not
\r
5871 man files are output in separate directory.
\r
5873 Modified: manpages/docbook.xsl,1.65; manpages/utility.xsl,1.14 - Michael
\r
5876 ● Added options for controlling indentation of verbatim output. Controlled
\r
5877 through the man.indentation.verbatims.adjust and
\r
5878 man.indentation.verbatims.value params. Closes #1242997
\r
5880 Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 - Michael(tm)
\r
5883 ● Added options for controlling indentation in lists and in *blurb output in
\r
5884 the AUTHORS section. Controlled through the man.indentation.lists.adjust,
\r
5885 man.indentation.lists.value, man.indentation.authors.adjust, and
\r
5886 man.indentation.authors.value parameters. Default is 3 characters (instead
\r
5887 of the roff default of 8 characters). Closes #1449369.
\r
5889 Also, removed the indent that was being set on informalexample outuput. I
\r
5890 will instead add an option for indenting verbatims, which I think is what
\r
5891 the informalexample indent was intended for originally.
\r
5893 Modified: manpages/block.xsl,1.14; manpages/docbook.xsl,1.63; manpages/
\r
5894 info.xsl,1.18; manpages/lists.xsl,1.28 - Michael(tm) Smith
\r
5896 ● Changed line-spacing call before synopfragment to use ".sp -1n" ("n" units
\r
5897 specified) instead of plain ".sp -1"
\r
5899 Modified: manpages/synop.xsl,1.28 - Michael(tm) Smith
\r
5901 ● Added support for writing man files into a specific output directory and
\r
5902 into appropriate subdirectories within that output directory. Controlled
\r
5903 through the man.base.dir parameter (similar to the base.dir support in the
\r
5904 HTML stylesheet) and the man.subdirs.enabled parameter, which automatically
\r
5905 determines the name of an appropriate subdir (for example, man/man7, man/
\r
5906 man1, etc.) based on the section number/manvolnum of the source Refentry.
\r
5908 Closes #1255036 and #1170317. Thanks to Denis Bradford for the original
\r
5909 feature request, and to Costin Stroie for submitting a patch that was very
\r
5910 helpful in implementing the support.
\r
5912 Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 - Michael
\r
5915 ● Refined XPath statements and notification messages for refentry metadata
\r
5918 Modified: common/common.xsl,1.59; common/refentry.xsl,1.14; manpages/
\r
5919 docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm) Smith
\r
5921 ● Added support for copyright and legalnotice. The manpages stylesheets now
\r
5922 output a COPYRIGHT section, after the AUTHORS section, if a copyright or
\r
5923 legalnotice is found in the source. The section contains the copyright
\r
5924 contents followed by the legalnotice contents. Closes #1450209.
\r
5926 Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 - Michael(tm)
\r
5929 ● Drastically reworked all of the XPath expressions used in refentry metadata
\r
5930 gathering -- completely removed $parentinfo and turned $info into a set of
\r
5931 nodes that includes the *info contents of the Refentry plus the *info
\r
5932 contents all all of its ancestor elements. The basic XPath expression now
\r
5933 used throughout is (using the example of checking for a date):
\r
5935 (($info[//date])[last()]/date)[1].
\r
5937 That selects the "last" *info/date date in document order -- that is, the
\r
5938 one eitther on the Refentry itself or on the closest ancestor to the
\r
5941 It's likely this change may break some things; may need to pick up some
\r
5944 Also, changed the default value for the man.th.extra2.max.length from 40 to
\r
5947 Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; params/
\r
5948 man.th.extra2.max.length.xml,1.2; params/refentry.date.profile.xml,1.2;
\r
5949 params/refentry.manual.profile.xml,1.2; params/
\r
5950 refentry.source.name.profile.xml,1.2; params/
\r
5951 refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; manpages/
\r
5952 other.xsl,1.15 - Michael(tm) Smith
\r
5954 ● Added support for DocBook 5 namespace-stripping in manpages stylesheet.
\r
5955 Closes request #1210692.
\r
5957 Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm)
\r
5960 ● Fixed handling of table footnotes. With this checkin, the table support in
\r
5961 the manpages stylesheet is now basically feature complete. So this change
\r
5962 closes request #619532, "No support for tables" -- the oldest currently
\r
5963 open manpages feature request, submitted by Ben Secrest (blsecres) on
\r
5964 2002-10-07. Congratulations to me [patting myself on the back].
\r
5966 Modified: manpages/block.xsl,1.11; manpages/docbook.xsl,1.55; manpages/
\r
5967 table.xsl,1.15 - Michael(tm) Smith
\r
5969 ● Added handling for table titles. Also fixed handling of nested tables; nest
\r
5970 tables are now "extracted" and displayed just after their parent tables.
\r
5972 Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14 - Michael(tm)
\r
5975 ● Added option for turning off bold formatting in Funcsynopsis. Boldface
\r
5976 formatting in function synopsis is mandated in the man(7) man page and is
\r
5977 used almost universally in existing man pages. Despite that, it really does
\r
5978 look like crap to have an entire Funcsynopsis output in bold, so I added
\r
5979 params for turning off the bold formatting and/or replacing it with a
\r
5980 different roff special font (e.g., "RI" for alternating roman/italic
\r
5981 instead of the default "BI" for alternating bold/italic). The new params
\r
5982 are "man.funcprototype.font" and "man.funcsynopsisinfo.font". To be
\r
5985 Closes #1452247. Thanks to Joe Orton for the feature request.
\r
5987 Modified: params/man.string.subst.map.xml,1.16; manpages/block.xsl,1.10;
\r
5988 manpages/docbook.xsl,1.51; manpages/inline.xsl,1.16; manpages/
\r
5989 synop.xsl,1.27 - Michael(tm) Smith
\r
5991 ● Use AUTHORS instead of AUTHOR if we have multiple people to attribute.
\r
5992 Also, fixed checking such that we generate author section even if we don't
\r
5993 have an author (as long as there is at least one other person/entity we can
\r
5994 put in the section). Also adjusted assembly of content for Author metainfo
\r
5995 field such that we now not only use author, but try to find a "best match"
\r
5996 if we can't find an author name to put there.
\r
5998 Closes #1233592. Thanks to Sam Steingold for the request.
\r
6000 Modified: manpages/info.xsl,1.12 - Michael(tm) Smith
\r
6002 ● Changes for request #1243027, "Impove handling of AUTHOR section." This
\r
6003 adds support for Collab, Corpauthor, Corpcredt, Orgname, Publishername, and
\r
6004 Publisher. Also adds support for output of Affiliation and its children,
\r
6005 and support for using gentext strings for auto-attributing roles (Author,
\r
6006 Editor, Publisher, Translator, etc.). Also did a lot of code cleanup and
\r
6007 modularization of all the AUTHOR handling code. And fixed a bug that was
\r
6008 causing Author info to not be picked up correctly for metainfo comment we
\r
6009 embed in man-page source.
\r
6011 Modified: manpages/info.xsl,1.11 - Michael(tm) Smith
\r
6013 ● Support bold output for "emphasis remap='B'". (because Eric Raymond's
\r
6014 doclifter(1) tool converts groff source marked up with ".B" request or "\
\r
6015 fB" escapes to DocBook "emphasis remap='B'".)
\r
6017 Modified: manpages/inline.xsl,1.14 - Michael(tm) Smith
\r
6019 ● Added support for Segmentedlist. Details: Output is tabular, with no option
\r
6020 for "list" type output. Output for Segtitle elements can be supressed by
\r
6021 setting man.segtitle.suppress. If Segtitle content is output, it is
\r
6022 rendered in italic type (not bold because not all terminals support bold
\r
6023 and so italic ensures the stand out on those terminals). Extra space (.sp
\r
6024 line) at end of table code ensures that it gets handled correctly in the
\r
6025 case where its source is the child of a Para. Closes feature-request #
\r
6026 1400097. Thanks to Daniel Leidert for the patch and push, and to Alastair
\r
6027 Rankine for filing the original feature request.
\r
6029 Modified: manpages/lists.xsl,1.23; manpages/utility.xsl,1.10 - Michael(tm)
\r
6032 ● Improved handling or Author/Editor/Othercredit.
\r
6034 Reworked content of (non-visible) comment added at top of each page
\r
6037 Added support for generating a manifest file (useful for cleaning up after
\r
6040 Modified: manpages/docbook.xsl,1.46; manpages/info.xsl,1.9; manpages/
\r
6041 other.xsl,1.12; manpages/utility.xsl,1.6 - Michael(tm) Smith
\r
6043 ● Added two new parameters for handling of multi-term varlistentry elements:
\r
6045 variablelist.term.break.after: When the variablelist.term.break.after is
\r
6046 non-zero, it will generate a line break after each term multi-term
\r
6049 variablelist.term.separator: When a varlistentry contains multiple term
\r
6050 elements, the string specified in the value of the
\r
6051 variablelist.term.separator parameter is placed after each term except the
\r
6052 last. The default is ", " (a comma followed by a space). To suppress
\r
6053 rendering of the separator, set the value of variablelist.term.separator to
\r
6054 the empty string ("").
\r
6056 These parameters are primarily intended to be useful if you have multi-term
\r
6057 varlistentries that have long terms.
\r
6059 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
\r
6060 long terms" doc that demonstrated the value of having these options.
\r
6062 Also, added normalize-space() call to processing of each term.
\r
6064 This change affects all output formats (HTML, PDF, manpages). The default
\r
6065 behavior should pretty much remain the same as before, but it is possible
\r
6066 (as always) that the change may introduce some new bugginess.
\r
6068 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
\r
6069 lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
\r
6070 lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
\r
6071 variablelist.term.break.after.xml,1.1; params/
\r
6072 variablelist.term.separator.xml,1.1 - Michael(tm) Smith
\r
6076 The following changes have been made to the params code since the 1.69.1
\r
6079 ● New parameters to set header/footer table minimum height.
\r
6081 Modified: params/footer.table.height.xml,1.1; params/
\r
6082 header.table.height.xml,1.1 - Robert Stayton
\r
6084 ● Support multiple indexing methods for different languages.
\r
6086 Modified: params/index.method.xml,1.1 - Robert Stayton
\r
6088 ● Remove qandaset and qandadiv from generate.toc for fo output because
\r
6089 formerly it wasn't working, but now it is and the default behavior should
\r
6092 Modified: params/generate.toc.xml,1.8 - Robert Stayton
\r
6094 ● add support for page number references to link element too.
\r
6096 Modified: params/insert.link.page.number.xml,1.1 - Robert Stayton
\r
6098 ● Add support for more characters to hyphen on when ulink.hyphenate is turned
\r
6101 Modified: params/ulink.hyphenate.chars.xml,1.1; params/
\r
6102 ulink.hyphenate.xml,1.3 - Robert Stayton
\r
6104 ● New attribute-set to format biblioentry and bibliomixed.
\r
6106 Modified: params/biblioentry.properties.xml,1.1 - Robert Stayton
\r
6108 ● Added new parameter chunk.tocs.and.lots.has.title which controls presence
\r
6109 of title in a separate chunk with ToC/LoT. Disabling title can be very
\r
6110 useful if you are generating frameset output (well, yes those frames, but
\r
6111 some customers really want them ;-).
\r
6113 Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; html/
\r
6114 param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
\r
6117 ● Added new attribute set toc.line.properties for controlling appearance of
\r
6120 Modified: params/toc.line.properties.xml,1.1 - Jirka Kosek
\r
6122 ● Allow table footnotes to have different properties from regular footnotes.
\r
6124 Modified: params/table.footnote.properties.xml,1.1 - Robert Stayton
\r
6126 ● Set properties for pgwide="1" objects.
\r
6128 Modified: params/pgwide.properties.xml,1.1 - Robert Stayton
\r
6130 ● Added the autotoc.label.in.hyperlink param.
\r
6132 If the value of autotoc.label.in.hyperlink is non-zero, labels are included
\r
6133 in hyperlinked titles in the TOC. If it is instead zero, labels are still
\r
6134 displayed prior to the hyperlinked titles, but are not hyperlinked along
\r
6137 Closes patch #1065868. Thanks to anatoly techtonik for the patch.
\r
6139 Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; html/
\r
6140 param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - Michael(tm)
\r
6143 ● Added two new params: html.head.legalnotice.link.types and html.head.
\r
6144 legalnotice.link.multiple.
\r
6146 If the value of the generate.legalnotice.link is non-zero, then the
\r
6147 stylesheet generates (in the head section of the HTML source) either a
\r
6148 single HTML link element or, if the value of the html.head.legalnotice.link
\r
6149 .multiple is non-zero, one link element for each link type specified. Each
\r
6150 link has the following attributes:
\r
6152 - a rel attribute whose value is derived from the value of html.head.
\r
6153 legalnotice.link.types
\r
6155 - an href attribute whose value is set to the URL of the file containing
\r
6158 - a title attribute whose value is set to the title of the corresponding
\r
6159 legalnotice (or a title programatically determined by the stylesheet)
\r
6163 <link rel="copyright" href="ln-id2524073.html" title="Legal Notice">
\r
6165 Closes #1476450. Thanks to Sam Steingold.
\r
6167 Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; html/
\r
6168 param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; params/
\r
6169 html.head.legalnotice.link.multiple.xml,1.1; params/
\r
6170 html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith
\r
6172 ● Added the following params:
\r
6174 - man.indent.width (string-valued) - man.indent.refsect (boolean) -
\r
6175 man.indent.blurbs (boolean) - man.indent.lists (boolean) -
\r
6176 man.indent.verbatims (boolean)
\r
6178 Note that in earlier snapshots, man.indent.width was named
\r
6179 man.indentation.default.value and the boolean params had names like
\r
6180 man.indentation.*.adjust. Also the man.indent.blurbs param was called
\r
6181 man.indentation.authors.adjust (or something).
\r
6183 The behavior now is: If the value of a particular man.indent.* boolean
\r
6184 param is non-zero, the corresponding contents (refsect*, list items,
\r
6185 authorblurb/personblurb, vervatims) are displayed with a left margin
\r
6186 indented by a width equal to the value of man.indent.width.
\r
6188 Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74;
\r
6189 manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
\r
6190 manpages/param.ent,1.22; manpages/param.xweb,1.24; manpages/
\r
6191 refentry.xsl,1.14; params/man.indent.lists.xml,1.1; params/
\r
6192 man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; params/
\r
6193 man.indent.width.xml,1.1 - Michael(tm) Smith
\r
6195 ● Added man.table.footnotes.divider param.
\r
6197 In each table that contains footenotes, the string specified by the man.
\r
6198 table.footnotes.divider parameter is output before the list of footnotes
\r
6201 Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; manpages/
\r
6202 param.ent,1.21; manpages/param.xweb,1.23; params/
\r
6203 man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith
\r
6205 ● Added the man.output.in.separate.dir, man.output.base.dir, and
\r
6206 man.output.subdirs.enabled parameters.
\r
6208 The man.output.base.dir parameter specifies the base directory into which
\r
6209 man-page files are output. The man.output.subdirs.enabled parameter
\r
6210 controls whether the files are output in subdirectories within the base
\r
6213 The values of the man.output.base.dir and man.output.subdirs.enabled
\r
6214 parameters are used only if the value of man.output.in.separate.dir
\r
6215 parameter is non-zero. If the value of man.output.in.separate.dir is zero,
\r
6216 man-page files are not output in a separate directory.
\r
6218 Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; manpages/
\r
6219 param.xweb,1.22; params/man.output.base.dir.xml,1.1; params/
\r
6220 man.output.in.separate.dir.xml,1.1; params/
\r
6221 man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith
\r
6223 ● Added man.font.table.headings and man.font.table.title params, for
\r
6224 controlling font in table headings and titles.
\r
6226 Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; manpages/
\r
6227 param.xweb,1.21; params/man.font.table.headings.xml,1.1; params/
\r
6228 man.font.table.title.xml,1.1 - Michael(tm) Smith
\r
6230 ● Added man.font.funcsynopsisinfo and man.font.funcprototype params, for
\r
6231 specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and
\r
6232 funcprototype output.
\r
6234 Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; manpages/
\r
6235 param.ent,1.18; manpages/param.xweb,1.20; manpages/synop.xsl,1.29; manpages
\r
6236 /table.xsl,1.21; params/man.font.funcprototype.xml,1.1; params/
\r
6237 man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith
\r
6239 ● Changed to select="0" in refclass.suppress (instead of ..>0</..)
\r
6241 Modified: params/refclass.suppress.xml,1.3 - Michael(tm) Smith
\r
6243 ● Added man.segtitle.suppress param.
\r
6245 If the value of man.segtitle.suppress is non-zero, then display of segtitle
\r
6246 contents is suppressed in output.
\r
6248 Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; manpages/
\r
6249 param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - Michael(tm) Smith
\r
6251 ● Added man.output.manifest.enabled and man.output.manifest.filename params.
\r
6253 If man.output.manifest.enabled is non-zero, a list of filenames for man
\r
6254 pages generated by the stylesheet transformation is written to the file
\r
6255 named by man.output.manifest.filename
\r
6257 Modified: manpages/docbook.xsl,1.67; manpages/other.xsl,1.19; manpages/
\r
6258 param.ent,1.16; manpages/param.xweb,1.18; params/
\r
6259 man.output.manifest.enabled.xml,1.1; params/
\r
6260 man.output.manifest.filename.xml,1.1; tools/make/Makefile.DocBook,1.4 -
\r
6263 ● Added refclass.suppress param.
\r
6265 If the value of refclass.suppress is non-zero, then display refclass
\r
6266 contents is suppressed in output. Affects HTML and FO output only.
\r
6268 Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html
\r
6269 /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith
\r
6271 ● Added refentry.meta.get.quietly param.
\r
6273 If zero (the default), notes and warnings about "missing" markup are
\r
6274 generated during gathering of refentry metadata. If non-zero, the metadata
\r
6275 is gathered "quietly" -- that is, the notes and warnings are suppressed.
\r
6277 NOTE: If you are processing a large amount of refentry content, you may be
\r
6278 able to speed up processing significantly by setting a non-zero value for
\r
6279 refentry.meta.get.quietly.
\r
6281 Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/
\r
6282 param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
\r
6285 ● Added support for "software" and "sectdesc" class values on refmiscinfo;
\r
6286 "software" is treated identically to "source", and "setdesc" is treated
\r
6287 identically to "manual".
\r
6289 Modified: common/refentry.xsl,1.10; params/
\r
6290 man.th.extra2.max.length.xml,1.3; params/
\r
6291 refentry.source.name.profile.xml,1.4 - Michael(tm) Smith
\r
6293 ● Drastically reworked all of the XPath expressions used in refentry metadata
\r
6294 gathering -- completely removed $parentinfo and turned $info into a set of
\r
6295 nodes that includes the *info contents of the Refentry plus the *info
\r
6296 contents all all of its ancestor elements. The basic XPath expression now
\r
6297 used throughout is (using the example of checking for a date):
\r
6299 (($info[//date])[last()]/date)[1].
\r
6301 That selects the "last" *info/date date in document order -- that is, the
\r
6302 one eitther on the Refentry itself or on the closest ancestor to the
\r
6305 It's likely this change may break some things; may need to pick up some
\r
6308 Also, changed the default value for the man.th.extra2.max.length from 40 to
\r
6311 Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; params/
\r
6312 man.th.extra2.max.length.xml,1.2; params/refentry.date.profile.xml,1.2;
\r
6313 params/refentry.manual.profile.xml,1.2; params/
\r
6314 refentry.source.name.profile.xml,1.2; params/
\r
6315 refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; manpages/
\r
6316 other.xsl,1.15 - Michael(tm) Smith
\r
6318 ● Added option for turning off bold formatting in Funcsynopsis. Boldface
\r
6319 formatting in function synopsis is mandated in the man(7) man page and is
\r
6320 used almost universally in existing man pages. Despite that, it really does
\r
6321 look like crap to have an entire Funcsynopsis output in bold, so I added
\r
6322 params for turning off the bold formatting and/or replacing it with a
\r
6323 different roff special font (e.g., "RI" for alternating roman/italic
\r
6324 instead of the default "BI" for alternating bold/italic). The new params
\r
6325 are "man.funcprototype.font" and "man.funcsynopsisinfo.font". To be
\r
6328 Closes #1452247. Thanks to Joe Orton for the feature request.
\r
6330 Modified: params/man.string.subst.map.xml,1.16; manpages/block.xsl,1.10;
\r
6331 manpages/docbook.xsl,1.51; manpages/inline.xsl,1.16; manpages/
\r
6332 synop.xsl,1.27 - Michael(tm) Smith
\r
6334 ● fop.extensions now only for FOP version 0.20.5 and earlier.
\r
6336 Modified: params/fop.extensions.xml,1.4 - Robert Stayton
\r
6338 ● Support for fop1 different from fop 0.20.5 and earlier.
\r
6340 Modified: params/fop1.extensions.xml,1.1 - Robert Stayton
\r
6342 ● Reset default value to empty string so template uses gentext first, then
\r
6343 the parameter value if not empty.
\r
6345 Modified: params/index.number.separator.xml,1.2; params/
\r
6346 index.range.separator.xml,1.2; params/index.term.separator.xml,1.2 - Robert
\r
6349 ● New parameter: id.warnings. If non-zero, warnings are generated for titled
\r
6350 objects that don't have titles. True by default; I wonder if this will be
\r
6353 Modified: html/biblio.xsl,1.25; html/component.xsl,1.27; html/
\r
6354 division.xsl,1.11; html/formal.xsl,1.19; html/glossary.xsl,1.20; html/
\r
6355 html.xsl,1.13; html/index.xsl,1.16; html/param.ent,1.88; html/
\r
6356 param.xweb,1.97; html/refentry.xsl,1.22; html/sections.xsl,1.30; params/
\r
6357 id.warnings.xml,1.1 - Norman Walsh
\r
6359 ● Added new parameter keep.relative.image.uris
\r
6361 Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html
\r
6362 /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh
\r
6364 ● Support default label width parameters for itemized and ordered lists
\r
6366 Modified: fo/lists.xsl,1.64; fo/param.ent,1.90; fo/param.xweb,1.103; params
\r
6367 /itemizedlist.label.width.xml,1.1; params/orderedlist.label.width.xml,1.1 -
\r
6370 ● Added parameters to localize punctuation in indexes.
\r
6372 Modified: params/index.number.separator.xml,1.1; params/
\r
6373 index.range.separator.xml,1.1; params/index.term.separator.xml,1.1 - Robert
\r
6376 ● Added two new parameters for handling of multi-term varlistentry elements:
\r
6378 variablelist.term.break.after: When the variablelist.term.break.after is
\r
6379 non-zero, it will generate a line break after each term multi-term
\r
6382 variablelist.term.separator: When a varlistentry contains multiple term
\r
6383 elements, the string specified in the value of the
\r
6384 variablelist.term.separator parameter is placed after each term except the
\r
6385 last. The default is ", " (a comma followed by a space). To suppress
\r
6386 rendering of the separator, set the value of variablelist.term.separator to
\r
6387 the empty string ("").
\r
6389 These parameters are primarily intended to be useful if you have multi-term
\r
6390 varlistentries that have long terms.
\r
6392 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
\r
6393 long terms" doc that demonstrated the value of having these options.
\r
6395 Also, added normalize-space() call to processing of each term.
\r
6397 This change affects all output formats (HTML, PDF, manpages). The default
\r
6398 behavior should pretty much remain the same as before, but it is possible
\r
6399 (as always) that the change may introduce some new bugginess.
\r
6401 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
\r
6402 lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
\r
6403 lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
\r
6404 variablelist.term.break.after.xml,1.1; params/
\r
6405 variablelist.term.separator.xml,1.1 - Michael(tm) Smith
\r
6407 ● Convert 'no' to string in default value.
\r
6409 Modified: params/olink.doctitle.xml,1.4 - Robert Stayton
\r
6411 ● Implemented RFE #1292615.
\r
6413 Added bunch of new parameters (attribute sets) that affect list
\r
6414 presentation: list.block.properties, itemizedlist.properties, orderedlist
\r
6415 .properties, itemizedlist.label.properties and orderedlist.label
\r
6416 .properties. Default behaviour of stylesheets has not been changed but
\r
6417 further customizations will be much more easier.
\r
6419 Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; params/
\r
6420 itemizedlist.label.properties.xml,1.1; params/
\r
6421 itemizedlist.properties.xml,1.1; params/list.block.properties.xml,1.1;
\r
6422 params/orderedlist.label.properties.xml,1.1; params/
\r
6423 orderedlist.properties.xml,1.1 - Jirka Kosek
\r
6425 ● Implemented RFE #1242092.
\r
6427 You can enable crop marks in your document by setting crop.marks=1 and
\r
6428 xep.extensions=1. Appearance of crop marks can be controlled by parameters
\r
6429 crop.mark.bleed (6pt), crop.mark.offset (24pt) and crop.mark.width (0.5pt).
\r
6431 Also there is new named template called user-xep-pis. You can overwrite it
\r
6432 in order to produce some PIs that can control XEP as described in http://
\r
6433 www.renderx.com/reference.html#Output_Formats
\r
6435 Modified: fo/docbook.xsl,1.36; fo/param.ent,1.86; fo/param.xweb,1.97; fo/
\r
6436 xep.xsl,1.23; params/crop.mark.bleed.xml,1.1; params/
\r
6437 crop.mark.offset.xml,1.1; params/crop.mark.width.xml,1.1; params/
\r
6438 crop.marks.xml,1.1 - Jirka Kosek
\r
6440 ● Changed short descriptions in doc for *autolabel* params to match new
\r
6441 autolabel behavior.
\r
6443 Modified: params/appendix.autolabel.xml,1.5; params/
\r
6444 chapter.autolabel.xml,1.4; params/part.autolabel.xml,1.5; params/
\r
6445 preface.autolabel.xml,1.4 - Michael(tm) Smith
\r
6449 The following changes have been made to the profiling code since the 1.69.1
\r
6452 ● Profiling now works together with namespace stripping (V5 documents).
\r
6453 Namespace striping should work with all stylesheets named profile-, even if
\r
6454 they are not supporting namespace stripping in a non-profiling variant.
\r
6456 Modified: profiling/profile-mode.xsl,1.4; profiling/xsl2profile.xsl,1.7 -
\r
6459 ● Moved profiling stage out of templates. This make possible to reuse
\r
6460 profiled content by several templates and still maintaing node indentity
\r
6461 (needed for example for HTML Help where content is processed multiple
\r
6464 I don't know why this was not on the top level before. Maybe some XSLT
\r
6465 processors choked on it. I hope this will be OK now.
\r
6467 Modified: profiling/xsl2profile.xsl,1.5 - Jirka Kosek
\r
6471 The following changes have been made to the tools code since the 1.69.1
\r
6474 ● Moved Makefile.DocBook from contrib module to xsl module.
\r
6476 Modified: tools/make/Makefile.DocBook,1.1 - Michael(tm) Smith
\r
6480 The following changes have been made to the wordml code since the 1.69.1
\r
6483 ● added contrib element, better handling of default paragraph style
\r
6485 Modified: wordml/pages-normalise.xsl,1.6; wordml/supported.xml,1.2; wordml/
\r
6486 wordml-final.xsl,1.14 - Steve Ball
\r
6488 ● added bridgehead
\r
6490 Modified: wordml/docbook-pages.xsl,1.6; wordml/docbook.xsl,1.17; wordml/
\r
6491 pages-normalise.xsl,1.5; wordml/template-pages.xml,1.7; wordml/
\r
6492 template.dot,1.4; wordml/template.xml,1.14; wordml/wordml-final.xsl,1.13 -
\r
6495 ● added blocks stylesheet to support bibliographies, glossaries and qandasets
\r
6497 Modified: wordml/Makefile,1.4; wordml/README,1.3; wordml/
\r
6498 blocks-spec.xml,1.1; wordml/docbook-pages.xsl,1.5; wordml/docbook.xsl,1.16;
\r
6499 wordml/pages-normalise.xsl,1.4; wordml/sections-spec.xml,1.3; wordml/
\r
6500 specifications.xml,1.13; wordml/template-pages.xml,1.6; wordml/
\r
6501 template.dot,1.3; wordml/template.xml,1.13; wordml/wordml-blocks.xsl,1.1;
\r
6502 wordml/wordml-final.xsl,1.12; wordml/wordml-sections.xsl,1.3 - Steve Ball
\r
6504 ● added mediaobject caption
\r
6506 Modified: wordml/docbook-pages.xsl,1.4; wordml/docbook.xsl,1.15; wordml/
\r
6507 specifications.xml,1.12; wordml/template-pages.xml,1.5; wordml/
\r
6508 template.dot,1.2; wordml/template.xml,1.12; wordml/wordml-final.xsl,1.11 -
\r
6513 Modified: wordml/docbook-pages.xsl,1.3; wordml/docbook.xsl,1.14; wordml/
\r
6514 pages-normalise.xsl,1.3; wordml/specifications.xml,1.11; wordml/
\r
6515 template-pages.xml,1.4; wordml/wordml-final.xsl,1.10 - Steve Ball
\r
6517 ● added Word template file
\r
6519 Modified: wordml/template.dot,1.1 - Steve Ball
\r
6521 ● added abstract, fixed itemizedlist, ulink
\r
6523 Modified: wordml/specifications.xml,1.10; wordml/wordml-final.xsl,1.9 -
\r
6526 ● fixed Makefile added many features to Pages support added revhistory,
\r
6527 inlines, highlights, abstract
\r
6529 Modified: wordml/Makefile,1.2; wordml/docbook-pages.xsl,1.2; wordml/
\r
6530 pages-normalise.xsl,1.2; wordml/sections-spec.xml,1.2; wordml/
\r
6531 specifications.xml,1.9; wordml/template-pages.xml,1.3; wordml/
\r
6532 template.xml,1.11; wordml/wordml-final.xsl,1.8; wordml/
\r
6533 wordml-sections.xsl,1.2 - Steve Ball
\r
6535 ● fixed handling linebreaks when generating WordML added Apple Pages support
\r
6537 Modified: wordml/docbook.xsl,1.13; wordml/template-pages.xml,1.2 - Steve
\r
6542 This release is a minor bug-fix update to the 1.69.0 release. Along with bug
\r
6543 fixes, it includes one configuration-parameter change: The default value of the
\r
6544 annotation.support parameter is now 0 (off). The reason for that change is that
\r
6545 there have been reports that annotation handling is causing a significant
\r
6546 performance degradation in processing of large documents with xsltproc.
\r
6550 The release includes major feature changes, particularly in the manpages
\r
6551 stylesheets, as well as a large number of bug fixes.
\r
6553 As with all DocBook Project “dot zero” releases, this is an experimental
\r
6558 ● This release adds localizations for the following languages: Albanian,
\r
6559 Amharic, Azerbaijani, Hindi, Irish (Gaelic), Gujarati, Kannada, Mongolian,
\r
6560 Oriya, Punjabi, Tagalog, Tamil, and Welsh.
\r
6562 ● Added support for specifying number format for auto labels for chapter,
\r
6563 appendix, part, and preface. Contolled with the appendix.autolabel,
\r
6564 chapter.autolabel, part.autolabel, and preface.autolabel parameters.
\r
6566 ● Added basic support for biblioref cross referencing.
\r
6568 ● Added support for align on caption in mediaobject.
\r
6570 ● Added support for processing documents that use the DocBook V5 namespace.
\r
6572 ● Added support for termdef and mathphrase.
\r
6574 ● EXPERIMENTAL: Incorporated the Slides and Website stylesheets into the
\r
6575 DocBook XSL stylesheets package. So, for example, Website documents can now
\r
6576 be processed using the following URI for the driver Website tabular.xsl
\r
6579 http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl
\r
6581 ● A procedure without a title is now treated as an “informal” procedure
\r
6582 (meaning that it is not added to any generated “list of procedures” and has
\r
6583 no affect on numbering of generated labels for other procedures).
\r
6585 ● docname is no longer added to olink when pointing to a root element.
\r
6587 ● Added support for generation of choice separator in inline simplelist. This
\r
6588 enables auto-generation of an appropriate localized “choice separator” (for
\r
6589 example, “and” or “or”) before the final item in an inline simplelist.
\r
6591 To indicate that you want a choice separator generated for a particular
\r
6592 list, you need to put a processing instruction (PI) of the form <?
\r
6593 dbchoice choice="foo"?> as a child of the list. For example:
\r
6596 ONE and ONLY ONE of the following:
\r
6597 <simplelist type="inline">
\r
6598 <?dbchoice choice="or" ?>
\r
6599 <member>A</member>
\r
6600 <member>B</member>
\r
6601 <member>C</member>.</simplelist></para>
\r
6603 Output (for English):
\r
6605 Choose from ONE and only ONE of the following choices: A, B, or C.
\r
6607 As a temporary workaround for the fact that most of the DocBook non-English
\r
6608 locale files don't have a localization for the word “or”, you can put in a
\r
6609 literal string to be used; example for French: <?dbchoice choice="ou">.
\r
6610 That is, use “ou” instead of “or”.
\r
6614 ● Added content-type property to external-graphic element, based on imagedata
\r
6617 ● Added support for generating <rx:meta-field creator="$VERSION"/> field for
\r
6618 XEP output. This makes the DocBook XSL stylesheet version information
\r
6619 available through the Document Properties menu in Acrobat Reader and other
\r
6622 ● Trademark symbol handling made consistent with handling of same in HTML
\r
6623 stylesheets. Prior to this change, if you processed a document that
\r
6624 contained no value for the class attribute on the trademark element, the
\r
6625 HTML stylesheets would default to rendering a superscript TM symbol after
\r
6626 the trademark contents, but the FO stylesheets would render nothing.
\r
6628 ● Added support for generating XEP bookmarks for refentry.
\r
6630 ● Added support for HTML markup table border attribute, applied to each table
\r
6633 ● The table.width template can now sum column specs if none use % or *.
\r
6635 ● Added fox:destination extension inside fox:outline to support linking to
\r
6636 internal destinations.
\r
6638 ● Added support for customizing abstract with property sets. Controlled with
\r
6639 the abstract.properties and abstract.title.properties parameters.
\r
6641 ● Add footnotes in table title to table footnote set, and add support for
\r
6642 table footnotes to HTML table markup.
\r
6644 ● Added support for title in glosslist.
\r
6646 ● Added support for itemizedlist symbol none.
\r
6648 ● Implemented the new graphical.admonition.properties and
\r
6649 nongraphical.admonition.properties attribute sets.
\r
6651 ● Added id to formalpara and some other blocks that were missing it.
\r
6653 ● Changed the anchor template to output fo:inline instead of fo:wrapper.
\r
6655 ● Added support for toc.max.depth parameter.
\r
6659 ● Eclipse Help: Added support for generating olink database.
\r
6663 ● Added a first cut at support in HTML output for DocBook 5 style annotation
\r
6664 s. Controlled using the annotation.support parameter, and implemented using
\r
6665 JavaScript and CSS styling. For more details, see the documentation for the
\r
6666 annotation.js, annotation.css, annotation.graphic.open, and
\r
6667 annotation.graphic.close parameters.
\r
6669 ● Generate client-side image map for imageobjectco with areas using calspair
\r
6672 ● Added support for <?img.src.path?> PI.
\r
6674 ● Added support for passing img.src.path to DocBook Java XSLT image
\r
6675 extensions when appropriate. Controlled using the
\r
6676 graphicsize.use.img.src.path parameter.
\r
6678 ● Added support for (not valid for DocBook 4) xlink:href on area and (not
\r
6679 valid for DocBook 4) alt in area.
\r
6681 ● Added new parameter default.table.frame to control table framing if there
\r
6682 is no frame attribute on a table.
\r
6684 ● Added initial, experimental support for generating content for the HTML
\r
6685 title attribute from content of the alt element. This change adds support
\r
6686 for the following inline elements only (none of them are block elements):
\r
6687 abbrev, accel, acronym, action, application, authorinitials, beginpage,
\r
6688 citation, citerefentry, citetitle, city, classname, code, command,
\r
6689 computeroutput, constant, country, database, email, envar, errorcode,
\r
6690 errorname, errortext, errortype, exceptionname, fax, filename, firstname,
\r
6691 firstterm, foreignphrase, function, glossterm, guibutton, guiicon, guilabel
\r
6692 , guimenu, guimenuitem, guisubmenu, hardware, honorific, interface,
\r
6693 interfacename, keycap, keycode, keysym, lineage, lineannotation, literal,
\r
6694 markup, medialabel, methodname, mousebutton, option, optional, otheraddr,
\r
6695 othername, package, parameter, personname, phone, pob, postcode,
\r
6696 productname, productnumber, prompt, property, quote, refentrytitle, remark,
\r
6697 replaceable, returnvalue, tag, shortcut, state, street, structfield,
\r
6698 structname, subscript, superscript, surname, symbol, systemitem, tag,
\r
6699 termdef, token, trademark, type, uri, userinput, varname, and wordasword
\r
6701 ● Added support for chunking revhistory into separate file (similar to the
\r
6702 support for doing same with legalnotice). Patch from Thomas Schraitle.
\r
6703 Controlled through new generate.revhistory.link parameter.
\r
6705 ● l10n.xsl: Made language codes RFC compliant. Added a new boolean config
\r
6706 parameter, l10n.lang.value.rfc.compliant. If it is non-zero (the default),
\r
6707 any underscore in a language code will be converted to a hyphen in HTML
\r
6708 output. If it is zero, the language code will be left as-is.
\r
6712 This release closes out 44 manpages stylesheet bug reports and feature
\r
6713 requests. It adds more than 35 new configuration parameters for controlling
\r
6714 aspects of man-page output -- including hyphenation and justification, handling
\r
6715 of links, conversion of Unicode characters, and contents of man-page headers
\r
6718 ● New options for globally disabling/enabling hyphenation and justification:
\r
6719 man.justify and man.hyphenate.
\r
6721 Note that the default for the both of those is zero (off), because
\r
6722 justified text looks good only when it is also hyphenated; to quote the
\r
6723 “Hyphenation” node from the groff info page:
\r
6725 Since the odds are not great for finding a set of words, for every
\r
6726 output line, which fit nicely on a line without inserting excessive
\r
6727 amounts of space between words, `gtroff' hyphenates words so that it
\r
6728 can justify lines without inserting too much space between words.
\r
6730 The problem is that groff can end up hyphenating a lot of things that you
\r
6731 don't want hyphenated (variable names and command names, for example).
\r
6732 Keeping both justification and hyphenation disabled ensures that hyphens
\r
6733 won't get inserted where you don't want to them, and you don't end up with
\r
6734 lines containing excessive amounts of space between words. These default
\r
6735 settings run counter to how most existing man pages are formatted. But
\r
6736 there are some notable exceptions, such as the perl man pages.
\r
6738 ● Added parameters for controlling hyphenation of computer inlines,
\r
6739 filenames, and URLs. By default, even when hyphenation is enabled
\r
6740 (globally), hyphenation is now suppressed for "computer inlines"
\r
6741 (currently, just classname, constant, envar, errorcode, option, replaceable
\r
6742 , userinput, type, and varname, and for filenames, and for URLs from link.
\r
6743 It can be (re)enabled using the man.hyphenate.computer.inlines,
\r
6744 man.hyphenate.filenames, and man.hyphenate.urls parameters.
\r
6746 ● Implemented a new system for replacing Unicode characters. There are two
\r
6747 parts to the new system: a “string substitution map” for doing “essential”
\r
6748 replacements, and a “character map” that can optionally be disabled and
\r
6751 The new system fixes all open bugs that had to do with literal Unicode
\r
6752 numbered entities such as “ and ” showing up in output, and
\r
6753 greatly expands the ability of the stylesheets to generate “good” roff
\r
6754 equivalents for Unicode symbols and special characters.
\r
6756 Here are some details...
\r
6758 The previous manpages mechanism for replacing Unicode symbols and special
\r
6759 characters with roff equivalents (the replace-entities template) was not
\r
6760 scalable and not complete. The mechanism handled a somewhat arbitrary
\r
6761 selection of less than 20 or so Unicode characters. But there are
\r
6762 potentially more than 800 Unicode special characters that have some groff
\r
6763 equivalent they can be mapped to. And there are about 34 symbols in the
\r
6764 Latin-1 (ISO-8859-1) block alone. Users might reasonably expect that if
\r
6765 they include any of those Latin-1 characters in their DocBook source
\r
6766 documents, they will get correctly converted to known roff equivalents in
\r
6769 In addition to those common symbols, certain users may have a need to use
\r
6770 symbols from other Unicode blocks. Say, somebody who is documenting an
\r
6771 application related to math might need to use a bunch of symbols from the
\r
6772 “Mathematical Operators” Unicode block (there are about 65 characters in
\r
6773 that block that have reasonable roff equivalents). Or somebody else might
\r
6774 really like Dingbats -- such as the checkmark character -- and so might use
\r
6775 a bunch of things from the “Dingbat” block (141 characters in that that
\r
6776 have roff equivalents or that can at least be “degraded” somewhat
\r
6777 gracefully into roff).
\r
6779 So, the old replace-entities mechanism was replaced with a completely
\r
6780 different mechanism that is based on use of two “maps”: a “substitution
\r
6781 map” and a “character map” (the latter in a format compliant with the XSLT
\r
6782 2.0 spec and therefore completely “forward compatible” with XSLT 2.0).
\r
6784 The substitution map is controlled through the man.string.subst.map
\r
6785 parameter, and is used to replace things like the backslash character
\r
6786 (which needs special handling to prevent it from being interpreted as a
\r
6787 roff escape). The substitution map cannot be disabled, because disabling it
\r
6788 will cause the output to be broken. However, you can add to it and change
\r
6791 The “character map” mechanism, on the other hand, can be completely
\r
6792 disabled. It is enabled by default, and, by default, does replacement of
\r
6793 all Latin-1 symbols, along with most special spaces, dashes, and quotes
\r
6794 (about 75 characters by default). Also, you can optionally enable a “full”
\r
6795 character map that provides support for converting all 800 or so of the
\r
6796 characters that have some reasonable groff equivalent.
\r
6798 The character-map mechanism is controlled through the following parameters:
\r
6800 man.charmap.enabled
\r
6802 turns character-map support on/off
\r
6804 man.charmap.use.subset
\r
6806 specifies that a subset of the character map is used instead of the
\r
6809 man.charmap.subset.profile
\r
6811 specifies profile of character-map subset
\r
6815 specifies an alternate character map to use instead of the “standard”
\r
6816 character map provided in the distribution
\r
6818 ● Implemented out-of-line handling of display of URLs for links (currently,
\r
6819 only for ulink). This gives you three choices for handling of links:
\r
6821 1. Number and list links. Each link is numbered inline, with a number in
\r
6822 square brackets preceding the link contents, and a numbered list of all
\r
6823 links is added to the end of the document.
\r
6825 2. Only list links. Links are not numbered, but an (unnumbered) list of
\r
6826 links is added to the end of the document.
\r
6828 3. Suppress links. Don't number links and don't add any list of links to
\r
6829 the end of the document.
\r
6831 You can also choose whether links should be underlined. The default is “the
\r
6832 works” -- list, number, and underline links. You can use the
\r
6833 man.links.list.enabled, man.links.are.numbered, and
\r
6834 man.links.are.underlined parameters to change the defaults. The default
\r
6835 heading for the link list is REFERENCES. You can be change that using the
\r
6836 man.links.list.heading parameter.
\r
6838 ● Changed default output encoding to UTF-8. This does not mean that man pages
\r
6839 are output in raw UTF-8, because the character map is applied before final
\r
6840 output, causing all UTF-8 characters covered in the map to be converted to
\r
6843 ● Added support for processing refsect3 and formalpara and nested refsection
\r
6844 elements, down to any arbitrary level of nesting.
\r
6846 ● Output of the NAME and SYNOPSIS and AUTHOR headings and the headings for
\r
6847 admonitions (note, caution, etc.) are no longer hard-coded for English.
\r
6848 Instead, headings are generated for those in the correct locale (just as
\r
6849 the FO and HTML stylesheets do).
\r
6851 ● Re-worked mechanism for assembling page headers/footers (the contents of
\r
6852 the .TH macro “title line”).
\r
6854 Here are some details...
\r
6856 All man pages contain a .TH roff macro whose contents are used for
\r
6857 rendering the “title line” displayed in the header and footer of each page.
\r
6858 Here are a couple of examples of real-world man pages that have useful page
\r
6861 gtk-options(7) GTK+ User's Manual gtk-options(7) <-- header
\r
6862 GTK+ 1.2 2003-10-20 gtk-options(7) <-- footer
\r
6864 svgalib(7) Svgalib User Manual svgalib(7) <-- header
\r
6865 Svgalib 1.4.1 16 December 1999 svgalib(7) <-- footer
\r
6867 And here are the terms with which the groff_man(7) man page refers to the
\r
6868 various parts of the header/footer:
\r
6870 title(section) extra3 title(section) <- header
\r
6871 extra2 extra1 title(section) <- footer
\r
6873 Or, using the names with which the man(7) man page refers to those same
\r
6876 title(section) manual title(section) <- page header
\r
6877 source date title(section) <- page footer
\r
6879 The easiest way to control the contents of those fields is to mark up your
\r
6880 refentry content like the following (note that this is a “minimal”
\r
6885 <date>2003-10-20</date> 1
\r
6888 <refentrytitle>gtk-options</refentrytitle> 2
\r
6889 <manvolnum>7</manvolnum> 3
\r
6890 <refmiscinfo class="source-name">GTK+</refmiscinfo> 4
\r
6891 <refmiscinfo class="version">1.2</refmiscinfo> 5
\r
6892 <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> 6
\r
6895 <refname>gtk-options</refname>
\r
6896 <refpurpose>Standard Command Line Options for GTK+ Programs</refpurpose>
\r
6899 <title>Description</title>
\r
6900 <para>This manual page describes the command line options, which
\r
6901 are common to all GTK+ based applications.</para>
\r
6905 1 Sets the “date” part of the header/footer.
\r
6907 2 Sets the “title” part.
\r
6909 3 Sets the “section” part.
\r
6911 4 Sets the “source name” part.
\r
6913 5 Sets the “version” part.
\r
6915 6 Sets the “manual” part.
\r
6917 Below are explanations of the steps the stylesheets take to attempt to
\r
6918 assemble and display “good” headers and footer. [In the descriptions, note
\r
6919 that *info is the refentry “info” child (whatever its name), and parentinfo
\r
6920 is the “info” child of its parent (again, whatever its name).]
\r
6922 extra1 field (date)
\r
6924 Content of the “extra1” field is what shows up in the center footer
\r
6925 position of each page. The man(7) man page describes it as “the date of
\r
6926 the last revision”.
\r
6928 To provide this content, if the refentry.date.profile.enabled is
\r
6929 non-zero, the stylesheets check the value of refentry.date.profile.
\r
6931 Otherwise, by default, they check for a date or pubdate not only in the
\r
6932 *info contents, but also in the parentinfo contents.
\r
6934 If a date cannot be found, the stylesheets now automatically generate a
\r
6935 localized “long format” date, ensuring that this field always has
\r
6936 content in output.
\r
6938 However, if for some reason you want to suppress this field, you can do
\r
6939 so by setting a non-zero value for man.th.extra1.suppress.
\r
6941 extra2 field (source)
\r
6943 On Linux systems and on systems with a modern groff, the content of the
\r
6944 “extra2” field are what shows up in the left footer position of each
\r
6947 The man(7) man page describes this as “the source of the command”, and
\r
6948 provides the following examples:
\r
6950 ○ For binaries, use somwething like: GNU, NET-2, SLS Distribution,
\r
6953 ○ For system calls, use the version of the kernel that you are
\r
6954 currently looking at: Linux 0.99.11.
\r
6956 ○ For library calls, use the source of the function: GNU, BSD 4.3,
\r
6959 In practice, there are many pages that simply have a version number in
\r
6960 the “source” field. So, it looks like what we have is a two-part field,
\r
6961 Name Version, where:
\r
6965 product name (e.g., BSD) or org. name (e.g., GNU)
\r
6971 Each part is optional. If the Name is a product name, then the Version
\r
6972 is probably the version of the product. Or there may be no Name, in
\r
6973 which case, if there is a Version, it is probably the version of the
\r
6974 item itself, not the product it is part of. Or, if the Name is an
\r
6975 organization name, then there probably will be no Version.
\r
6977 To provide this content, if the refentry.source.name.profile.enabled
\r
6978 and refentry.version.profile.enabled parameter are non-zero, the
\r
6979 stylesheets check the value of refentry.source.name.profile
\r
6980 refentry.version.profile.
\r
6982 Otherwise, by default, they check the following places, in the
\r
6985 1. *info/productnumber
\r
6987 2. *info/productnumber
\r
6989 3. refmeta/refmiscinfo[@class = 'version']
\r
6991 4. parentinfo/productnumber
\r
6993 5. *info/productname
\r
6995 6. parentinfo/productname
\r
6997 7. refmeta/refmiscinfo
\r
6999 8. [nothing found, so leave it empty]
\r
7003 On Linux systems and on systems with a modern groff, the content of the
\r
7004 “extra3” field are what shows up in the center header position of each
\r
7005 page. Some man pages have “extra2” content, some don't. If a particular
\r
7006 man page has it, it is most often “context” data about some larger
\r
7007 system the documented item belongs to (for example, the name or
\r
7008 description of a group of related applications). The stylesheets now
\r
7009 check the following places, in the following order, to look for content
\r
7010 to add to the “extra3” field.
\r
7012 1. parentinfo/title
\r
7016 3. refmeta/refmiscinfo
\r
7018 4. [nothing found, so leave it empty]
\r
7020 ● Reworked *info gathering. For each refentry found, the stylesheets now
\r
7021 cache its *info content, then check for any valid parent of it that might
\r
7022 have metainfo content and cache that, if found; they then then do all
\r
7023 further matches against those node-sets (rather than re-selecting the
\r
7024 original *info nodes each time they are needed).
\r
7026 ● New option for breaking strings after forward slashes. This enables long
\r
7027 URLs and pathnames to be broken across lines. Controlled through
\r
7028 man.break.after.slash parameter.
\r
7030 ● Output for servicemark and trademark are now (SM) and (TM). There is a
\r
7031 groff "\(tm" escape, but output from that is not acceptable.
\r
7033 ● New option for controlling the length of the title part of the .TH title
\r
7034 line. Controlled through the man.th.title.max.length parameter.
\r
7036 ● New option for specifying output encoding of each man page; controlled with
\r
7037 man.output.encoding (similar to the HTML chunker.output.encoding
\r
7040 ● New option for suppressing filename messages when generating output;
\r
7041 controlled with man.output.quietly (similar to the HTML chunk.quietly
\r
7044 ● The text of cross-references to first-level refentry (refsect1, top-level
\r
7045 refsection, refnamediv, and refsynopsisdiv) are now capitalized.
\r
7047 ● Cross-references to refnamediv now use the localized NAME title instead of
\r
7048 using the first refname child. This makes the output inconsistent with HTML
\r
7049 and FO output, but for man-page output, it seems to make better sense to
\r
7050 have the NAME. (It may actually make better sense to do it that way in HTML
\r
7051 and FO output as well...)
\r
7053 ● Added support for processing funcparams.
\r
7055 ● Removed the space that was being output between funcdef and paramdef;
\r
7056 example: was: float rand (void); now: float rand(void)
\r
7058 ● Turned off bold formatting for the type element when it occurs within a
\r
7059 funcdef or paramdef
\r
7061 ● Corrected rendering of simplelist. Any <simplelist type="inline" instance
\r
7062 is now rendered as a comma-separated list (also with an optional localized
\r
7063 “and” or “or” before the last item -- see description elsewhere in these
\r
7064 release notes). Any simplelist instance whose type is not inline is
\r
7065 rendered as a one-column vertical list (ignoring the values of the type and
\r
7066 columns attributes if present)
\r
7068 ● Comment added at top of roff source for each page now includes DocBook XSL
\r
7069 stylesheets version number (as in the HTML stylesheets)
\r
7071 ● Made change to prevent “sticky” fonts changes. Now, when the manpages
\r
7072 stylesheets encounter node sets that need to be boldfaced or italicized,
\r
7073 they put the \fBfoo\fR and \fIbar\fR groff bold/italic instructions
\r
7074 separately around each node in the set.
\r
7076 ● synop.xsl: Boldface everything in funcsynopsis output except parameters
\r
7077 (which are in ital). The man(7) man page says:
\r
7079 For functions, the arguments are always specified using italics, even
\r
7080 in the SYNOPSIS section, where the rest of the function is specified in
\r
7083 A look through the contents of the man/man2 directory shows that most (all)
\r
7084 existing pages do follow this “everything in funcsynopsis bold” rule. That
\r
7085 means the type content and any punctuation (parens, semicolons, varargs)
\r
7086 also must be bolded.
\r
7088 ● Removed code for adding backslashes before periods/dots in roff source,
\r
7089 because backslashes in front of periods/dots in roff source are needed only
\r
7090 in the very rare case where a period is the very first character in a line,
\r
7091 without any space in front of it. A better way to deal with that rare case
\r
7092 is for you to add a zero-width space in front of the offending dot(s) in
\r
7095 ● Removed special handling of the quote element. That was hard-coded to cause
\r
7096 anything marked up with the quote element to be output preceded by two
\r
7097 backticks and followed by two apostrophes -- that is, that old-school
\r
7098 kludge for generating “curly” quotes in Emacs and in X-Windows fonts. While
\r
7099 Emacs still seems to support that, I don't think X-Windows has for a long
\r
7100 time now. And, anyway, it looks (and has always looked) like crap when
\r
7101 viewed on a normal tty/console. In addition, it breaks localiztion of quote
\r
7102 . By default, quote content is output with localized quotation marks,
\r
7103 which, depending on the locale, may or may not be left and right double
\r
7106 ● Changed mappings for left and right single quotation marks. Those had
\r
7107 previously been incorrectly mapped to the backtick (`) and apostrophe
\r
7108 (&39;) characters (for kludgy reasons -- see above). They are now correctly
\r
7109 mapped to the \(oq and \(cq roff escapes. If you want the old (broken)
\r
7110 behavior, you need to manually change the mappings for those in the value
\r
7111 of the man.string.subst.map parameter.
\r
7113 ● Removed xref.xsl file. Now, of the various cross-reference elements, only
\r
7114 the ulink element is handled differently; the rest are handled exactly as
\r
7115 the HTML stylesheets handle them, except that no hypertext links are
\r
7116 generated. (Because there is no equivalent hypertext mechanism is man
\r
7119 ● New option for making “subheading dividers” in generated roff source. The
\r
7120 dividers are not visible in the rendered man page; they are just there to
\r
7121 make the source readable. Controlled using man.subheading.divider.
\r
7123 ● Fixed many places where too much space was being added between lines.
\r
7127 The release adds localization support for Farsi (thanks to Sina Heshmati) and
\r
7128 improved support for the XLink-based DocBook NG db:link element. Other than
\r
7129 that, it is a minor bug-fix update to the 1.68.0 release. The main thing it
\r
7130 fixes is a build error that caused the XSLT Java extensions to be jarred up
\r
7131 with the wrong package structure. Thanks to Jens Stavnstrup for quickly
\r
7132 reporting the problem, and to Mauritz Jeanson for investigating and finding the
\r
7137 This release includes some features changes, particularly for FO/PDF output,
\r
7138 and a number of bug fixes.
\r
7142 ● Moved footnote properties to attribute-sets.
\r
7144 ● Added support for side floats, margin notes, and custom floats.
\r
7146 ● Added new parameters body.start.indent and body.end.indent to the
\r
7147 set.flow.properties template.
\r
7149 ● Added support for xml:id
\r
7151 ● Added support for refdescriptor.
\r
7153 ● Added support for multiple refnamedivs.
\r
7155 ● Added index.entry.properties attribute-set to support customization of
\r
7158 ● Added set.flow.properties template call to each fo:flow to support
\r
7159 customizations entry point.
\r
7161 ● Add support for @floatstyle in figure
\r
7163 ● Moved hardcoded properties for index division titles to the
\r
7164 index.div.title.properties attribute-set.
\r
7166 ● Added support for table-layout="auto" for XEP.
\r
7168 ● Added index.div.title.properties attribute-set.
\r
7170 ● $verbose parameter is now passed to most elements.
\r
7172 ● Added refentry to toc in part, as it is permitted by the DocBook schema/
\r
7175 ● Added backmatter elements and article to toc in part, since they are
\r
7176 permitted by the DocBook schema/DTD.
\r
7178 ● Added mode="toc" for simplesect, since it is now permitted in the toc if
\r
7179 simplesect.in.toc is set.
\r
7181 ● Moved hard-coded properties to nongraphical.admonintion.properties and
\r
7182 graphical.admonition.properties attribute sets.
\r
7184 ● Added support for sidebar-width and float-type processing instructions in
\r
7187 ● For tables with HTML markup elements, added support for dbfo bgcolor PI,
\r
7188 the attribute-sets named table.properties, informaltable.properties,
\r
7189 table.table.properties, and table.cell.padding. Also added support for the
\r
7190 templates named table.cell.properties and table.cell.block.properties so
\r
7191 that tabstyles can be implemented. Also added support for tables containing
\r
7192 only tr instead of tbody with tr.
\r
7194 ● Added new paramater hyphenate.verbatim.characters which can specify
\r
7195 characters after which a line break can occur in verbatim environments.
\r
7196 This parameter can be used to extend the initial set of characters which
\r
7197 contain only space and non-breakable space.
\r
7199 ● Added itemizedlist.label.markup to enable selection of different bullet
\r
7200 symbol. Also added several potential bullet characters, commented out by
\r
7203 ● Enabled all id's in XEP output for external olinking.
\r
7207 ● Added support for refdescriptor.
\r
7209 ● Added support for multiple refnamedivs.
\r
7211 ● Added support for xml:id
\r
7213 ● refsynopsisdiv as a section for counting section levels
\r
7217 ● Added new SVG admonition graphics and navigation images.
\r
7221 This release fixes a table bug introduced in the 1.67.1 release.
\r
7225 This release includes a number of bug fixes.
\r
7227 The following lists provide details about API and feature changes.
\r
7231 ● Tables: Inherited cell properties are now passed to the
\r
7232 table.cell.properties template so they can be overridden by a
\r
7235 ● Tables: Added support for bgcolor PI on table row element.
\r
7237 ● TOCs: Added new parameter simplesect.in.toc; default value of 0 causes
\r
7238 simplesect to be omitted from TOCs; to cause simplesect to be included in
\r
7239 TOCs, you must set the value of simplesect.in.toc to 1.Comment from Norm:
\r
7241 Simplesect elements aren't supposed to appear in the ToC at all... The
\r
7242 use case for simplesect is when, for example, every chapter in a book
\r
7243 ends with "Exercises" or "For More Information" sections and you don't
\r
7244 want those to appear in the ToC.
\r
7246 ● Sections: Reverted change that caused a variable reference to be used in a
\r
7247 template match and rewrote code to preserve intended semantics.
\r
7249 ● Lists: Added workaround to prevent "* 0.60 + 1em" garbage in list output
\r
7252 ● Moved the literal attributes from component.title to the
\r
7253 component.title.properties attribute-set so they can be customized.
\r
7255 ● Lists: Added glossdef's first para to special handling in
\r
7256 fo:list-item-body.
\r
7260 ● TOCs: Added new parameter simplesect.in.toc; for details, see the list of
\r
7261 FO changes for this release.
\r
7263 ● Indexing: Added new parameter index.prefer.titleabbrev; when set to 1,
\r
7264 index references will use titleabbrev instead of title when available.
\r
7268 ● Added support for generating windows-1252-encoded output using Saxon; for
\r
7269 more details, see the list of XSL Java extensions changes for this release.
\r
7273 ● Replaced named/numeric character-entity references for non-breaking space
\r
7274 with groff equivalent (backslash-tilde).
\r
7276 XSL Java extensions
\r
7278 ● Saxon extensions: Added the Windows1252 class. It extends Saxon 6.5.x with
\r
7279 the windows-1252 character set, which is particularly useful when
\r
7280 generating HTML Help for Western European Languages (code from Pontus
\r
7281 Haglund and contributed to the DocBook community by Sectra AB, Sweden).
\r
7285 1. Make sure that the Saxon 6.5.x jar file and the jar file for the
\r
7286 DocBook XSL Java extensions are in your CLASSPATH
\r
7288 2. Create a DocBook XSL customization layer -- a file named
\r
7289 mystylesheet.xsl or whatever -- that, at a minimum, contains the
\r
7293 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
\r
7295 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/>
\r
7296 <xsl:output method="html" encoding="WINDOWS-1252" indent="no"/>
\r
7297 <xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"></xsl:param>
\r
7298 <xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"></xsl:param>
\r
7299 <xsl:param name="saxon.character.representation" select="'native'"></xsl:param>
\r
7302 Invoke Saxon with the encoding.windows-1252 Java system property set to
\r
7303 com.nwalsh.saxon.Windows1252; for example
\r
7306 -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
\r
7307 com.icl.saxon.StyleSheet \
\r
7308 mydoc.xml mystylesheet.xsl
\r
7310 Or, for a more complete "real world" case showing other options you'll
\r
7311 typically want to use:
\r
7314 -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
\r
7315 -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \
\r
7316 -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \
\r
7317 -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \
\r
7318 com.icl.saxon.StyleSheet \
\r
7319 -x org.apache.xml.resolver.tools.ResolvingXMLReader \
\r
7320 -y org.apache.xml.resolver.tools.ResolvingXMLReader \
\r
7321 -r org.apache.xml.resolver.tools.CatalogResolver \
\r
7322 mydoc.xml mystylesheet.xsl
\r
7324 In both cases, the "mystylesheet.xsl" file should be a DocBook
\r
7325 customization layer containing the parameters show in step 2.
\r
7327 ● Saxon extensions: Removed Saxon 8 extensions from release package
\r
7331 ● A number of important bug fixes.
\r
7333 ● Added Saxon8 extensions
\r
7335 ● Enabled dbfo table-width on entrytbl in FO output
\r
7337 ● Added support for role=strong on emphasis in FO output
\r
7339 ● Added new FO parameter hyphenate.verbatim that can be used to turn on
\r
7340 "intelligent" wrapping of verbatim environments.
\r
7342 ● Replaced all <tt></tt> output with <code></code>
\r
7344 ● Changed admon.graphic.width template to a mode so that different
\r
7345 admonitions can have different graphical widths.
\r
7347 ● Deprecated the HTML shade.verbatim parameter (use CSS instead)
\r
7349 ● Wrapped ToC refentrytitle/refname and refpurpose in span with class values.
\r
7350 This makes it possible to style them using a CSS stylesheet.
\r
7352 ● Use strong/em instead of b/i in HTML output
\r
7354 ● Added support for converting Emphasis to groff italic and Emphasis role=
\r
7355 'bold' to bold. Controlled by emphasis.propagates.style param, but not
\r
7356 documented yet using litprog system. Will do that next (planning to add
\r
7357 some other parameter-controllable options for hyphenation and handling of
\r
7360 ● callout.graphics.number.limit.xml param: Changed the default from 10 to 15.
\r
7362 ● verbatim.properties: Added hyphenate=false
\r
7364 ● Saxon and Xalan Text.java extensions: Added support for URIResolver() on
\r
7367 ● Added generated RELEASE-NOTES.txt file.
\r
7369 ● Added INSTALL file (executable file for generating catalog.xml)
\r
7371 ● Removed obsolete tools directory from package
\r
7375 ● A number of important bug fixes.
\r
7377 ● Now xml:base attributes that are generated by an XInclude processor are
\r
7378 resolved for image files.
\r
7380 ● Rewrote olink templates to support several new features.
\r
7382 ○ Extended full olink support to FO output.
\r
7384 ○ Add support for xrefstyle attribute in olinks.
\r
7386 ○ New parameters to support new olink features: insert.olink.page.number,
\r
7387 insert.olink.pdf.frag, olink.debug, olink.lang.fallback.sequence,
\r
7388 olink.properties, prefer.internal.olink. See the reference page for
\r
7389 each parameter for more information.
\r
7391 ● Added index.on.type parameter for new type attribute introduced in DocBook
\r
7392 4.3 for indexterms and index. This allows you to create multiple indices
\r
7393 containing different categories of entries. For users of 4.2 and earlier,
\r
7394 you can use the new parameter index.on.role instead.
\r
7396 ● Added new section.autolabel.max.depth parameter to turn off section
\r
7397 numbering below a certain depth. This permits you to number major section
\r
7398 levels and leave minor section levels unnumbered.
\r
7400 ● Added footnote.sep.leader.properties attribute set to format the line
\r
7401 separating footnotes in printed output.
\r
7403 ● Added parameter img.src.path as a prefix to HTML img src attributes. The
\r
7404 prefix is added to whatever path is already generated by the stylesheet for
\r
7407 ● Added new attribute-sets informalequation.properties,
\r
7408 informalexample.properties, informalfigure.properties, and
\r
7409 informaltable.properties, so each such element type can be formatted
\r
7410 individually if needed.
\r
7412 ● Add component.label.includes.part.label parameter to add any part number to
\r
7413 chapter, appendix and other component labels when the label.from.part
\r
7414 parameter is nonzero. This permits you to distinguish multiple chapters
\r
7415 with the same chapter number in cross references and the TOC.
\r
7417 ● Added chunk.separate.lots parameter for HTML output. This parameter lets
\r
7418 you generate separate chunk files for each LOT (list of tables, list of
\r
7421 ● Added several table features:
\r
7423 ○ Added table.table.properties attribute set to add properties to the
\r
7426 ○ Added placeholder templates named table.cell.properties and
\r
7427 table.cell.block.properties to enable adding properties to any
\r
7428 fo:table-cell or the cell's fo:block, respectively. These templates are
\r
7429 a start for implementing table styles.
\r
7431 ● Added new attribute set component.title.properties for easy modifications
\r
7432 of component's title formatting in FO output.
\r
7434 ● Added Saxon support for an encoding attribute on the textdata element.
\r
7435 Added new parameter textdata.default.encoding which specifies encoding when
\r
7436 encoding attribute on textdata is missing.
\r
7438 ● Template label.this.section now controls whole section label, not only
\r
7439 sub-label which corresponds to particular label. Former behaviour was IMHO
\r
7440 bug as it was not usable.
\r
7442 ● Formatting in titleabbrev for TOC and headers is preserved when there are
\r
7443 no hotlink elements in the title. Formerly the title showed only the text
\r
7444 of the title, no font changes or other markup.
\r
7446 ● Added intial.page.number template to set the initial-page-number property
\r
7447 for page sequences in print output. Customizing this template lets you
\r
7448 change when page numbering restarts. This is similar to the
\r
7449 format.page.number template that lets you change how the page number
\r
7450 formatting changes in the output.
\r
7452 ● Added force.page.count template to set the force-page-count property for
\r
7453 page sequences in print output. This is similar to the format.page.number
\r
7456 ● Sort language for localized index sorting in autoidx-ng.xsl is now taken
\r
7457 from document lang, not from system environment.
\r
7459 ● Numbering and formatting of normal and ulink footnotes (if turned on) has
\r
7460 been unified. Now ulink footnotes are mixed in with any other footnotes.
\r
7462 ● Added support for renderas attribute in section and sect1 et al. This
\r
7463 permits you to render a given section title as if it were a different
\r
7466 ● Added support for label attribute in footnote to manually supply the
\r
7469 ● Added support for DocBook 4.3 corpcredit element.
\r
7471 ● Added support for a dbfo keep-together PI for formal objects (table,
\r
7472 figure, example, equation, programlisting). That permits a formal object to
\r
7473 be kept together if it is not already, or to be broken if it is very long
\r
7474 and the default keep-together is not appropriate.
\r
7476 ● For graphics files, made file extension matching case insensitive, and
\r
7477 updated the list of graphics extensions.
\r
7479 ● Allow calloutlist to have block content before the first callout
\r
7481 ● Added dbfo-need processing instruction to provide soft page breaks.
\r
7483 ● Added implementation of existing but unused default.image.width parameter
\r
7486 ● Support DocBook NG tag inline element.
\r
7488 ● It appears that XEP now supports Unicode characters in bookmarks. There is
\r
7489 no further need to strip accents from characters.
\r
7491 ● Make segmentedlist HTML markup more semantic and available to CSS styles.
\r
7493 ● Added user.preroot placeholder template to permit xsl-stylesheet and other
\r
7494 PIs and comments to be output before the HTML root element.
\r
7496 ● Non-chunked legalnotice now gets an <a name="id"> element in HTML output so
\r
7497 it can be referenced with xref or link.
\r
7499 ● In chunked HTML output, changed link rel="home" to rel="start", and link
\r
7500 rel="previous" to rel="prev", per W3C HTML 4.01 spec.
\r
7502 ● Added several patches to htmlhelp from W. Borgert
\r
7504 ● Added Bosnian locale file as common/bs.xml.
\r
7508 ● A number of important bug fixes.
\r
7510 ● Added a workaround to allow these stylesheets to process DocBook NG
\r
7511 documents. (It’s a hack that pre-processes the document to strip off the
\r
7512 namespace and then uses exsl:node-set to process the result.)
\r
7514 ● Added alternative indexing mechanism which has better internationalization
\r
7515 support. New indexing method allows grouping of accented letters like e, é,
\r
7516 ë into the same group under letter "e". It can also treat special letters
\r
7517 (e.g. "ch") as one character and place them in the correct position (e.g.
\r
7518 between "h" and "i" in Czech language).
\r
7520 In order to use this mechanism you must create customization layer which
\r
7521 imports some base stylesheet (like fo/docbook.xsl, html/chunk.xsl) and then
\r
7522 includes appropriate stylesheet with new indexing code (fo/autoidx-ng.xsl
\r
7523 or html/autoidx-ng.xsl). For example:
\r
7525 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
\r
7528 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/>
\r
7529 <xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/>
\r
7533 New method is known to work with Saxon and it should also work with
\r
7534 xsltproc 1.1.1 and later. Currently supported languages are English, Czech,
\r
7535 German, French, Spanish and Danish.
\r
7539 General bug fixes and improvements. Sorry about the failure to produce an
\r
7540 updated release notes file for 1.62.0—1.63.2
\r
7542 ● In the course of fixing bug #849787, wrapping Unicode callouts with an
\r
7543 appropriate font change in the Xalan extensions, I discovered that the
\r
7544 Xalan APIs have changed a bit. So xalan2.jar will work with older Xalan 2
\r
7545 implementations, xalan25.jar works with Xalan 2.5.
\r
7549 Lots of bug fixes and improvements.
\r
7551 ● Initial support for timestamp PI. From now you can use <?dbtimestamp format
\r
7552 ="Y-m-d H:M:S"?> to get current datetime in your document. Added
\r
7553 localization support for datetime PI
\r
7555 ● Added level 6 to test for section depth in section.level template so that
\r
7556 section.title.level6.properties will be used for sections that are 6 deep
\r
7557 or deeper. This should also cause a h6 to be created in html output.
\r
7559 ● Don't use SVG graphics if use.svg=0
\r
7561 ● Now uses number-and-title-template for sections only if section.autolabel
\r
7564 ● Added missing 'english-language-name' attribute to the l10n element, and
\r
7565 the missing 'style' attribute to the template element so the current
\r
7566 gentext documents will validate.
\r
7568 ● Corrected several references to parameter qanda.defaultlabel that were
\r
7571 ● Now accepts admon.textlabel parameter to turn off Note, Warning, etc.
\r
7574 ● FeatReq #684561: support more XEP metadata
\r
7576 ● Added hyphenation support. Added support for coref. Added beginpage
\r
7577 support. (does nothing; see TDG).
\r
7579 ● Added support for hyphenation-character, hyphenation-push-character-count,
\r
7580 and hyphenation-remain-character-count
\r
7582 ● Added root.properties, ebnf.assignment, and ebnf.statement.terminator
\r
7584 ● Support bgcolor PI in table cells; make sure rowsep and colsep don't have
\r
7585 any effect on the last row or column
\r
7587 ● Handle othercredit on titlepage a little better
\r
7589 ● Applied fix from Jeff Beal that fixed the bug that put secondary page
\r
7590 numbers on primary entries. Same with tertiary page numbers on secondary
\r
7593 ● Added definition of missing variable collection.
\r
7595 ● Make footnote formatting 'normal' even when it occurs in a context that has
\r
7596 special formatting
\r
7598 ● Added warning when glossary.collection is not blank, but it cannot open the
\r
7601 ● Pick up the frame attribute on table and informaltable.
\r
7603 ● indexdiv/title in non-autogenerated indexes are now picked up.
\r
7605 ● Removed (unused) component.title.properties
\r
7607 ● Move IDs from page-sequences down to titlepage blocks
\r
7609 ● Use proportional-column-width(1) on more tables.
\r
7611 Use proportional-column-width() for header/footer tables; suppress
\r
7612 relative-align when when using FOP
\r
7614 ● Check for glossterm.auto.link when linking firstterms; don't output gl.
\r
7615 prefix on glossterm links
\r
7617 ● Generate Part ToCs
\r
7619 ● Support glossary, bibliography, and index in component ToCs.
\r
7621 ● Refactored chunking code so that customization of chunk algorithm and chunk
\r
7622 elements is more practical
\r
7624 ● Support textobject/phrase on inlinemediaobject.
\r
7626 ● Support 'start' PI on ordered lists
\r
7628 ● Fixed test of $toc PI to turn on qandaset TOC.
\r
7630 ● Added process.chunk.footnotes to sect2 through 5 to fix bug of missing
\r
7631 footnotes when chunk level greater than 1.
\r
7633 ● Added paramater toc.max.depth which controls maximal depth of ToC as
\r
7634 requested by PHP-DOC group.
\r
7636 ● Exempted titleabbrev from preamble processing in lists, and fixed
\r
7637 variablelist preamble code to use the same syntax as the other lists.
\r
7639 ● Added support for elements between variablelist and first varlistentry
\r
7640 since DocBook 4.2 supports that now.
\r
7644 Lots of bug fixes.
\r
7646 ● The format of the titlepage.templates.xml files and the stylesheet that
\r
7647 transforms them have been significantly changed. All of the attributes used
\r
7648 to control the templates are now namespace qualified. So what used to be:
\r
7650 <t:titlepage element="article" wrapper="fo:block">
\r
7654 <t:titlepage t:element="article" t:wrapper="fo:block">
\r
7656 Attributes from other namespaces (including those that are unqualified) are
\r
7657 now copied directly through. In practice, this means that the names that
\r
7658 used to be “fo:” qualified:
\r
7660 <title named-template="component.title"
\r
7661 param:node="ancestor-or-self::article[1]"
\r
7662 fo:text-align="center"
\r
7663 fo:keep-with-next="always"
\r
7664 fo:font-size="&hsize5;"
\r
7665 fo:font-weight="bold"
\r
7666 fo:font-family="{$title.font.family}"/>
\r
7668 are now unqualified:
\r
7670 <title t:named-template="component.title"
\r
7671 param:node="ancestor-or-self::article[1]"
\r
7672 text-align="center"
\r
7673 keep-with-next="always"
\r
7674 font-size="&hsize5;"
\r
7675 font-weight="bold"
\r
7676 font-family="{$title.font.family}"/>
\r
7678 The t:titlepage and t:titlepage-content elements both generate wrappers
\r
7679 now. And unqualified attributes on those elements are passed through. This
\r
7680 means that you can now make the title font apply to ane entire titlepage
\r
7681 and make the entire “recto” titlepage centered by specifying the font and
\r
7682 alignment on the those elements:
\r
7684 <t:titlepage t:element="article" t:wrapper="fo:block"
\r
7685 font-family="{$title.font.family}">
\r
7687 <t:titlepage-content t:side="recto"
\r
7688 text-align="center">
\r
7690 ● Support use of titleabbrev in running headers and footers.
\r
7692 ● Added (experimental) xref.with.number.and.title parameter to enable number/
\r
7693 title cross references even when the default would be just the number.
\r
7695 ● Generate part ToCs if they're requested.
\r
7697 ● Use proportional-column-width() in header/footer tables.
\r
7699 ● Handle alignment correctly when screenshot wraps a graphic in a figure.
\r
7701 ● Format chapter and appendix cross references consistently.
\r
7703 ● Attempt to support tables with multiple tgroups in FO.
\r
7705 ● Output fo:table-columns in simplelist tables.
\r
7707 ● Use titlepage.templates.xml for indexdiv and glossdiv formatting.
\r
7709 ● Improve support for new bibliography elements.
\r
7711 ● Added footnote.number.format, table.footnote.number.format,
\r
7712 footnote.number.symbols, and table.footnote.number.symbols for better
\r
7713 control of footnote markers.
\r
7715 ● Added glossentry.show.acronyms.
\r
7717 ● Suppress the draft-mode page masters when draft-mode is “no”.
\r
7719 ● Make blank pages verso not recto. D'Oh!
\r
7721 ● Improved formatting of ulink footnotes.
\r
7723 ● Fixed bugs in graphic width/height calculations.
\r
7725 ● Added class attributes to inline elements.
\r
7727 ● Don't add “.html” to the filenames identified with the “dbhtml” PI.
\r
7729 ● Don't force a ToC when sections contain refentrys.
\r
7731 ● Make section title sizes a function of the body.master.size.
\r
7735 The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail.
\r
7737 ● Removed the region-name from the region-body of blank pages. There's no
\r
7738 reason to give the body of blank pages a unique name and doing so causes a
\r
7739 mismatch that FOP detects.
\r
7741 ● Output IDs for the first paragraphs in listitems.
\r
7743 ● Fixed some small bugs in the handling of page numbers in double-sided mode.
\r
7745 ● Attempt to prevent duplicated IDs from being produced when endterm on xref
\r
7746 points to something with nested structure.
\r
7748 ● Fix aligment problems in equations.
\r
7750 ● Output the type attribute on unordered lists (UL) in HTML only if the
\r
7751 css.decoration parameter is true.
\r
7753 ● Calculate the font size in formal.title.properties so that it's 1.2 times
\r
7754 the base font size, not a fixed "12pt".
\r
7758 The 1.59.1 fixes a few bugs.
\r
7760 ● Added Bulgarian localization.
\r
7762 ● Indexing improvements; localize book indexes to books but allow setindex to
\r
7763 index an entire set.
\r
7765 ● The default value for rowsep and colsep is now "1" as per CALS.
\r
7767 ● Added support for titleabbrev (use them for cross references).
\r
7769 ● Improvements to mediaobject for selecting print vs. online images.
\r
7771 ● Added seperate property sets for figures, examples, equations, tabless, and
\r
7774 ● Make lineannotations italic.
\r
7776 ● Support xrefstyle attribute.
\r
7778 ● Make endterm on xref higher priority than xreflabel target.
\r
7780 ● Glossary formatting improvements.
\r
7784 The 1.58.0 adds some initial support for extensions in xsltproc, adds a few
\r
7785 features, and fixes bugs.
\r
7787 ● This release contains the first attempt at extension support for xsltproc.
\r
7788 The only extension available to date is the one that adjusts table column
\r
7789 widths. Run extensions/xsltproc/python/xslt.py.
\r
7791 ● Fixed bugs in calculation of adjusted column widths to correct for rounding
\r
7794 ● Support nested refsection elements correctly.
\r
7796 ● Reworked gentext.template to take context into consideration. The name of
\r
7797 elements in localization files is now an xpath-like context list, not just
\r
7800 ● Made some improvements to bibliography formatting.
\r
7802 ● Improved graphical formatting of admonitions.
\r
7804 ● Added support for entrytbl.
\r
7806 ● Support spanning index terms.
\r
7808 ● Support bibliosource.
\r
7812 ● The 1.57.0 release wasn't documented here. Oops.
\r
7816 The 1.56.0 release fixes bugs.
\r
7818 ● Reworked chunking. This will break all existing customizations layers that
\r
7819 change the chunking algorithm. If you're customizing chunking, look at the
\r
7820 new “content” parameter that's passed to process-chunk-element and friends.
\r
7822 ● Support continued and inherited numeration in orderedlist formatting for
\r
7825 ● Added Thai localization.
\r
7827 ● Tweaked stylesheet documentation stylesheets to link to TDG and the
\r
7828 parameter references.
\r
7830 ● Allow title on tables of contents ("Table of Contents") to be optional.
\r
7831 Added new keyword to generate.toc. Support tables of contents on sections.
\r
7833 ● Made separate parameters for table borders and table cell borders:
\r
7834 table.frame.border.color, table.frame.border.style,
\r
7835 table.frame.border.thickness, table.cell.border.color,
\r
7836 table.cell.border.style, and table.cell.border.thickness.
\r
7838 ● Suppress formatting of “endofrange” indexterms. This is only half-right.
\r
7839 They should generate a range, but I haven't figured out how to do that yet.
\r
7841 ● Support revdescription. (Bug #582192)
\r
7843 ● Added default.float.class and fixed figure floats. (Bug #497603)
\r
7845 ● Fixed formatting of sbr in FOs.
\r
7847 ● Added context to the “missing template” error message.
\r
7849 ● Process arg correctly in a group. (Bug #605150)
\r
7851 ● Removed 'keep-with-next' from formal.title.properties attribute set now
\r
7852 that the stylesheets support the option of putting such titles below the
\r
7853 object. Now the $placement value determines if 'keep-with-next' or
\r
7854 'keep-with-previous' is used in the title block.
\r
7856 ● Wrap “url()” around external-destinations when appropriate.
\r
7858 ● Fixed typo in compact list spacing. (Bug #615464)
\r
7860 ● Removed spurious hash in anchor name. (Bug #617717)
\r
7862 ● Address is now displayed verbatim on title pages. (Bug #618600)
\r
7864 ● The bridgehead.in.toc parameter is now properly supported.
\r
7866 ● Improved effectiveness of HTML cleanup by increasing the number of places
\r
7867 where it is used. Improve use of HTML cleanup in XHTML stylesheets.
\r
7869 ● Support table of contents for appendix in article. (Bug #596599)
\r
7871 ● Don't duplicate footnotes in bibliographys and glossarys. (Bug #583282)
\r
7873 ● Added default.image.width. (Bug #516859)
\r
7875 ● Totally reworked funcsynopsis code; it now supports a 'tabular'
\r
7876 presentation style for 'wide' prototypes; see
\r
7877 funcsynopsis.tabular.threshold. (HTML only right now, I think, FO support,
\r
7878 uh, real soon now.)
\r
7880 ● Reworked support for difference marking; toned down the colors a bit and
\r
7881 added a “system.head.content” template so that the diff CSS wasn't
\r
7882 overriding “user.head.content”. (Bug #610660)
\r
7884 ● Added call to the “*.head.content” elements when writing out long
\r
7885 description chunks.
\r
7887 ● Make sure legalnotice link is correct even when chunking to a different
\r
7890 ● Use CSS to set viewport characteristics if css.decoration is non-zero, use
\r
7891 div instead of p for making graphic a block element; make figure titles the
\r
7892 default alt text for images in a figure.
\r
7894 ● Added space-after to list.block.spacing.
\r
7896 ● Reworked section.level template to give “correct” answer instead of being
\r
7899 ● When processing tables, use the tabstyle attribute as the division class.
\r
7901 ● Fixed bug in html2xhtml.xsl that was causing the XHTML chunker to output
\r
7902 HTML instead of XHTML.
\r
7906 To view the release notes for older releases, see http://cvs.sourceforge.net/
\r
7907 viewcvs.py/docbook/xsl/RELEASE-NOTES.xml. Be aware that there were no release
\r
7908 notes for releases prior to the 1.50.0 release.
\r
7910 About dot-zero releases
\r
7912 DocBook Project “dot zero” releases should be considered experimental and are
\r
7913 always followed by stable “dot one plus” releases, usually within two or three
\r
7914 weeks. Please help to ensure the stability of “dot one plus” releases by
\r
7915 carefully testing each “dot zero” release and reporting back about any problems
\r
7918 It is not recommended that you use a “dot zero” release in a production system.
\r
7919 Instead, you should wait for the “dot one” or greater versions.
\r