1 Release Notes for the DocBook XSL Stylesheets
3 $Revision: 9401 $ $Date: 2012-06-04 21:47:26 +0000 (Mon, 04 Jun 2012) $
7 This release-notes document is available in the following formats: HTML, PDF,
8 plain text; it provides a per-release list of enhancements and changes to the
9 stylesheets’ public APIs (user-configurable parameters) and excludes
10 descriptions of most bug fixes. For a complete list of all changes (including
11 all bug fixes) that have been made since the previous release, see the separate
12 NEWS (plain text) or NEWS.html files. Also available: An online hyperlinked
13 change history (warning: big file) of all changes made over the entire history
16 As with all DocBook Project “dot one plus” releases, this release aspires to be
17 stable (in contrast to dot-zero releases, which are experimental).
19 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
102 Release Notes: 1.74.3
103 Release Notes: 1.74.2
104 Release Notes: 1.74.1
115 Release Notes: 1.74.0
137 Release Notes: 1.73.2
243 About dot-zero releases
245 Release Notes: 1.77.1
247 The following list summarizes the major changes that have been made since the
248 1.76.1 release. It is followed by sections detailing changes to individual
249 files from the SVN checkin logs, edited to remove housekeeping changes and bug
250 fixes. See the NEWS.xml file for a complete unedited list of SVN changes.
256 Many improvements to the generated text for webhelp output.
260 Support more media types
262 Expanded list of supported filename extensions for media to include
263 video and audio, mostly for HTML5 and EPUB3 outputs.
267 Add basic support for new topic element, which is available in DocBook
268 5.1. Generally a topic element will be used with assembly and may be
269 transformed to some other hierarchical element during processing, but
270 it can also be formatted as a plain topic.
274 Add para.properties attribute-set
276 Add a para.properties attribute-set that applies only to para elements.
277 That allows still using normal.para.spacing attribute-set for many
278 block elements for uniform spacing, but allows separate formatting of
281 List of titles in article
283 Add support for List of Tables, List of Figures, etc. for articles and
284 other component-level elements. Includes a new template for each in
285 autotoc.xsl, new attribute-sets in titlepage.xsl, and new entries in
286 the titlepage.templates.xml file tu support customization.
288 Customizing links in FO
290 Add template mode simple.xlink.properties to allow easy customization
291 of formatting of links generated from elements that use the xlink
292 attributes. This extends link formatting beyond that of xref, link, and
293 olink which use xref.properties attribute-set.
297 The caption element in an HTML table is now handled like a title in a
298 CALS table, using the formal.object.title template with all its
299 features, including placement. Now caption template in mode="htmlTable"
300 does nothing, because caption handled by formal.object.title template.
301 Also adds support for table caption element in a CALS table, placing it
304 Graphics attribute handling
306 Refactored the big process.image template to use individual templates
307 such as image.width for most attributes to allow easier customization
308 of individual properties.
312 Add support for side page regions in addition to header and footer
313 regions. This feature lets you add running content to the side margins,
314 and by default the content is rotated 90 degrees. Adds new templates
315 named running.side.content, region.inner and region.outer; new template
316 modes region.inner.mode and region.outer.mode; new parameters named
317 region.inner.extent, region.outer.extent, body.margin.inner,
318 body.margin.outer, and side.region.precedence; and new attribute-sets
319 named inner.region.content.properties, outer.region.content.properties,
320 region.inner.properties, and region.outer.properties.
324 Add new attribute-sets for calloutlist.
328 Add basic support for formatting a topic element, which is available in
335 Add variables to the base HTML stylesheets that can be adjusted for the
338 Insert Javascript reference
340 Add support for html.script param to insert reference to a Javascript
343 Namespace for titlepage mechanism.
345 Titlepage mechanism is now namespace aware to support XHTML.
347 Chunked filename prefix
349 New param named chunked.filename.prefix lets you add a filename prefix
350 to each chunked file. This replaces the buggy practice of adding such a
351 prefix to the base.dir param. Now the base.dir param will always have a
352 trailing slash added if it is not present, so you no longer have to
353 remember to add it to the param value.
355 Generate id attributes
357 The stylesheet param generate.id.attributes already existed but was
358 incompletely implemented. Now when it is set to 1, only id attributes
359 should be output, not <a name> named anchors.
361 Generate consistent id attributes
363 New generate.consistent.ids parameter which allows generating a more
364 stable id values based on XPath rather than the generate-id() function,
365 which may not produce consistent values between runs. Stable output ids
366 allow you to make stable links to generated content from the outside.
370 Add basic support for formatting a topic element, which is available in
371 DocBook 5.1. Generally a topic element will be used with assembly and
372 may be transformed to some other hierarchical element during
373 processing, but it can also be formatted as a plain topic.
379 Webhelp templates refactored to better support customization.
383 More and better documentation added.
385 Webhelp generated text
387 Many improvements to the generated text for webhelp output.
391 New stylesheets to generate HTML5 output, in an XML serialization. These
392 templates are a customization layer on top of the XHTML stylesheet files.
396 New stylesheets to generate EPUB3 output. These templates are a
397 customization layer on top of the xhtml5 stylesheet files.
401 New assembly.xsl stylesheet to convert a DocBook 5.1 assembly into a
402 standard DocBook 5 document. Also includes a topic-maker-chunk.xsl
403 stylesheet that can convert a DocBook 5 book or article document into an
404 assembly with a collection of modular files, including converting some
405 elements to topic files.
409 The following changes have been made to the gentext code since the 1.76.1
412 • stefanhinz: locale/de.xml
414 Translated German WebHelp strings
416 • David Cramer: locale/zh.xml; locale/en.xml; locale/fr.xml; locale/de.xml;
419 Webhelp: Update non-en gentext strings
421 • Robert Stayton: locale/en.xml
423 Add topic to title-numbered context.
425 • Robert Stayton: locale/en.xml
427 Add basic topic element templates.
429 • Mauritz Jeanson: locale/el.xml
431 Updated gentext for quotation marks. Fixes bug #3512440.
433 • Jirka Kosek: locale/cs.xml
435 Adding missing context for webhelp
437 • David Cramer: locale/en.xml
439 Fixing syntax of webhelp gentext entries
441 • David Cramer: locale/en.xml
443 Moving webhelp gentext strings into a context
445 • tom_schr: locale/zh.xml; locale/en.xml; locale/cs.xml; locale/fr.xml;
446 locale/de.xml; local⋯
448 Moved language specific of WebHelp to gentext/locale/ as discussed with
449 Stefan following the "minimal intrusive approach". :)
450 In the long run, maybe moving the text into a context, not sure.
452 • Jirka Kosek: locale/ru.xml
454 Aligned capitalization of first letters with English original
458 The following changes have been made to the common code since the 1.76.1
461 • Robert Stayton: common.xsl
463 In "select.mediaobject.index" template, add selection of videoobject
464 and audioobject since now supported in HTML5.
466 • Robert Stayton: labels.xsl; titles.xsl; entities.ent; targets.xsl;
467 subtitles.xsl; gentext.⋯
469 Add basic support for new <topic> element.
471 • Robert Stayton: common.xsl
473 Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.
475 • Robert Stayton: olink.xsl
477 Generate error message if olink data in targetset is in a namespace.
479 • Robert Stayton: common.xsl
481 Add support for generate.consistent.ids parameter.
483 • Robert Stayton: subtitles.xsl
485 Add verbose param to subtitle.markup templates to allow its
486 error message to be ignored.
487 Add that param to fop1.xsl application of subtitle.markup
488 to avoid unnecessary error message in document information.
490 • Robert Stayton: labels.xsl
492 Add empty templates for glossdiv, glosslist, and glossentry in
497 The following changes have been made to the fo code since the 1.76.1 release.
499 • Robert Stayton: graphics.xsl
501 qualify caption template to mediaobject/caption so not confused with table/caption.
503 • Robert Stayton: table.xsl
505 Add template to process table/caption element.
507 • Robert Stayton: titlepage.xsl; autotoc.xsl; component.xsl; xref.xsl;
508 titlepage.templates.x⋯
510 Add basic support for new <topic> element.
512 • Robert Stayton: graphics.xsl
514 Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.
516 • Robert Stayton: titlepage.xsl
518 Add default style att-sets for component.list.of.titles, etc.
520 • Robert Stayton: autotoc.xsl; component.xsl; titlepage.templates.xml
522 Add make.component.tocs to support lists of tables, etc. for
523 article and other components. Added component.list.of.tables to
524 titlepage.templates.xml to format the title.
526 • Robert Stayton: param.xweb; param.ent
528 Add new para.properties attribute-set for paragraphs.
530 • Robert Stayton: inline.xsl
532 Add template mode 'simple.xlink.properties' to allow
533 easy customization of formatting of links generated
534 from elements other than xref, link, and olink using
535 the xlink attributes.
537 • Robert Stayton: param.xweb; param.ent
539 Add table.caption.properties to format table captions.
541 • Robert Stayton: table.xsl
543 Add support for caption in a CALS table.
545 • Robert Stayton: graphics.xsl; math.xsl
547 Refactored the 'process.image' template to create modular
548 templates for each attribute so they can be individually
549 customized. Also merged in support for embedded svg and
550 mml content so they can have image attributes too.
552 • Robert Stayton: param.xweb; param.ent
554 Check in new params for FO side regions in page masters.
556 • Robert Stayton: titlepage.xsl; titlepage.templates.xml
558 Add support for itermset in info elements, using titlepage mechanism
559 to ensure entries are placed inside page-sequence.
561 • Robert Stayton: pagesetup.xsl
563 Add support for side body margins and side static content regions.
566 • Robert Stayton: param.xweb; param.ent; task.xsl
568 Add attribute-set task.properties to task element to
569 support customization.
571 • Robert Stayton: lists.xsl; param.xweb; param.ent
573 Add new attribute-sets calloutlist.properties and callout.properties
574 to better support customization of calloutlists, fixing bug 3160341.
576 • Jirka Kosek: Makefile
578 Titlepage mechanism is now namespace aware to support XHTML. Please note that when generating titlepage template stylesheets you have to pass FO or XHTML namespace inside ns parameter. For HTML parameter should be empty.
580 • Robert Stayton: graphics.xsl
582 Allow selection by role for multiple imageobject elements
583 within an imageobjectco, which since Docbook 5 allows multiple imageobjects.
585 • Mauritz Jeanson: titlepage.xsl
587 Added template for collabname. Fixes bug #3414436.
589 • David Cramer: verbatim.xsl
591 Support the keep-together processing-instruction on programlisting, screen, synopsis, and literallayout. Tracker id #3396906.
593 • Robert Stayton: pagesetup.xsl
595 Pass the pageclass, sequence, and gentext-key to the template
596 named header.footer.widths to enable further customization
597 based on page master.
599 • Jirka Kosek: xref.xsl
601 hyphenation of URL content must be disabled for link, not only for ulink because od DB5
603 • Jirka Kosek: xref.xsl
605 URLs shouldn't be hyphenated as normal text
607 • Jirka Kosek: callout.xsl
609 Added support for alternative circled numbers
611 • Mauritz Jeanson: axf.xsl; fop1.xsl; xep.xsl
613 Added support for author/orgname in document metadata. Closes bug #3132862.
615 • Robert Stayton: component.xsl
617 Add template for article/colophon to avoid nested page-sequence.
621 The following changes have been made to the html code since the 1.76.1 release.
623 • Robert Stayton: xref.xsl
625 Add support for using info/title as well as title in target element.
627 • Robert Stayton: component.xsl
629 Enable support for html5 features, including using <section> instead of
630 <div> for certain elements, and setting heading level to <h1> for chapters.
631 These features are not changed in the base html stylesheet for backwards
634 • Robert Stayton: docbook.css.xml
636 Add style for footnote rule.
638 • Robert Stayton: biblio-iso690.xsl
640 Add support for subtitle inside info.
642 • Robert Stayton: docbook.xsl
644 Add call to new 'root.attributes' placeholder template to allow
645 adding attributes to the <html> output element.
647 • Robert Stayton: inline.xsl; titlepage.xsl; formal.xsl; division.xsl;
648 toc.xsl; sections.xsl⋯
650 Finish implementation of generate.id.attributes for all elements
651 using the template named id.attribute.
653 • Robert Stayton: autotoc.xsl; chunktoc.xsl; titlepage.xsl; chunk-code.xsl;
656 Add basic support for new <topic> element.
658 • Robert Stayton: graphics.xsl
660 Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.
662 • Robert Stayton: callout.xsl; verbatim.xsl
664 Restore programlisting to use <pre> instead of <div> and instead
665 wrap callout img elements in <span> to make valid HTML.
667 • Robert Stayton: graphics.xsl
669 Turn off img longdesc attribute because not supported by browsers.
671 • Robert Stayton: footnote.xsl
673 Move square brackets and <sup> inside <a> element for footnote
674 marks to fix display problems in some browsers.
676 • Robert Stayton: param.xweb; param.ent
678 Add new params html.script and html.script.type to support
679 Javascript references.
681 • Robert Stayton: chunk-common.xsl; chunktoc.xsl; titlepage.xsl; chunker.xsl;
684 Add support for chunked.filename.prefix param.
685 Make sure base.dir value has a trailing slash in
686 the chunk.base.dir internal param used by the templates.
688 • Robert Stayton: formal.xsl; htmltbl.xsl
690 Now handles caption in html markup table like title,
691 so formal.object.title is used with all its features, including
692 formatting and placement.
693 Added htmlTable.with.caption template to handle the wrapper, and
694 left htmlTable template unchanged.
695 Now caption template in mode="htmlTable" does nothing, because
696 caption handled by formal.object.title template.
698 • Robert Stayton: html.xsl
700 Turn off generating the title attribute for block and hierarchical elements.
701 Should only be used for inline elements, usually using the alt element.
702 Also used for links to show the target title.
704 • Robert Stayton: lists.xsl
706 The spacing="compact" attribute on lists in HTML no longer outputs compact="compact"
707 (or just "compact" in the case of Saxon 6), since that attribute is
708 deprecated and improperly supported. Instead, the output uses a
709 multiple class attribute such as class="orderedlist compact".
710 Use CSS to style such lists without margin above.
712 • Robert Stayton: graphics.xsl
714 Allow selection by role for multiple imageobject elements
715 within an imageobjectco, which since Docbook 5 allows multiple imageobjects.
717 • Robert Stayton: pi.xsl
719 Improve doc descriptions of dbhtml filename and dir.
721 • Robert Stayton: autoidx.xsl
723 Add setindex to context param in mode="reference" to better
726 • Robert Stayton: autotoc.xsl
728 Support set as child of set in set.toc template.
730 • Robert Stayton: qandaset.xsl
732 Change question and title templates to replace hard-coded
733 class="local-name()" with mode="class.attribute" to support customization
736 • Norman Walsh: chunktoc.xsl
738 Separate book appendixes from article appendixes (so that they can be customized independently)
740 • Mauritz Jeanson: graphics.xsl
742 Added condition to prevent "Failed to interpret image" messages (SVG is not supported
743 by the graphic size extension).
747 The following changes have been made to the epub code since the 1.76.1 release.
749 • Robert Stayton: docbook.xsl
751 Replace $base.dir with $chunk.base.dir to ensure trailing slash in place.
755 The following changes have been made to the htmlhelp code since the 1.76.1
758 • Robert Stayton: htmlhelp-common.xsl
760 Change $base.dir to $chunk.base.dir to ensure trailing slash in place.
764 The following changes have been made to the eclipse code since the 1.76.1
767 • Robert Stayton: eclipse.xsl; eclipse3.xsl
769 Use $chunk.base.dir instead of $base.dir to ensure trailing slash is in place.
773 The following changes have been made to the javahelp code since the 1.76.1
776 • Robert Stayton: javahelp.xsl
778 Change $base.dir to $chunk.base.dir to ensure trailing slash is present.
780 • Mauritz Jeanson: javahelp.xsl
782 Replaced empty header.navigation and footer.navigation templates with parameter suppress.navigation=1,
783 which simplifies customization. See bug #3310904.
787 The following changes have been made to the webhelp code since the 1.76.1
790 • David Cramer: template/common/css/positioning.css
792 Webhelp: Adding print-only css rules
794 • David Cramer: template/common/main.js
796 Webhelp: Arun's fix for bug where heading was partially hidden by header in some situations.
798 • David Cramer: xsl/webhelp-common.xsl
800 Webhelp: turn off autolabeling by default
802 • David Cramer: xsl/webhelp.xsl
804 Webhelp: Import xhtml base stylesheets
806 • David Cramer: docsrc/readme.xml
808 Webhelp: Link to the DocBook reference docs from the webhelp readme
810 • David Cramer: xsl/webhelp-common.xsl
812 Webhelp: Use gentext value for noscript warning
814 • David Cramer: Makefile
816 Webhelp: Delete tempfile after DocBook xsl build
818 • David Cramer: xsl/webhelp.xsl
820 Webhelp: moving parameters into the standard location so they will be part of the parameter reference
822 • David Cramer: xsl/webhelp.xsl; xsl/webhelp-common.xsl
824 Webhelp: moving parameters into the standard location so they will be part of the parameter reference
826 • David Cramer: template/common/main.js
828 Webhelp: tweaking scrolldown offset for anchors
830 • David Cramer: docsrc/images; docsrc/images/sample.jpg; docsrc/readme.xml;
833 Webhelp: updating docs. Ant version, install instructions, handling of images.
835 • David Cramer: xsl/webhelp.xsl
837 Patch from Arun Bharadwaj to display message if JavaScript is disabled
839 • David Cramer: template/content/search/nwSearchFnt.js
841 Patch from Arun Bharadwaj to strip quotes from search query strings
843 • Robert Stayton: xsl/webhelp.xsl
845 Add basic support for new <topic> element.
847 • Jirka Kosek: xsl/webhelp.xsl
849 Put back old extensibility point.
851 Guys, please don't remove existing extensibility points like named templates, it will break existing customizations.
853 • David Cramer: xsl/webhelp.xsl
855 Moving webhelp gentext strings into a context
857 • tom_schr: param.ent
859 Disabled branding and brandname entities for the time being
861 • tom_schr: param.xweb; param.ent
863 Prepared WebHelp reference documentation :)
864 Not clear about parameters brandname and branding: Should they renamed
865 to "webhelp.branding" and "webhelp.brandname"?
866 Currently, docsrc/reference.xml contains only a comment for the WebHelp
867 ref doc to be non-intrusive.
868 Idea is to enable it when it is ready
870 • tom_schr: xsl/webhelp.xsl
872 Moved language specific of WebHelp to gentext/locale/ as discussed with
873 Stefan following the "minimal intrusive approach". :)
874 In the long run, maybe moving the text into a context, not sure.
876 • David Cramer: template/common/css/positioning.css
878 Webhelp: Lower the minimum width of content pane
880 • kasunbg: xsl/webhelp.xsl; template/common/main.js
882 If an user moved to another page by clicking on a toc link, and then clicked on #searchDiv,
883 search should be performed if the cookie textToSearch is not empty.
885 • David Cramer: xsl/webhelp.xsl
887 Webhelp: Left align titles in nav header. Display for all but the topmost page
889 • David Cramer: template/content/search/stemmers/en_stemmer.js; docsrc/
892 Webhelp: Cleanup related to en_stemmer.js changes
894 • David Cramer: template/common/css/positioning.css
896 Webhelp: Don't put borders around qandaset list
898 • David Cramer: template/common/main.js
900 Webhelp: Avoid unnecessary scroll ups when anchor is clicked on
902 • David Cramer: build.properties
904 Webhelp: Show footer nav by default
906 • David Cramer: build.properties; build.xml
908 Webhelp: Support setting suppress.footer.navigation from build.properties
910 • David Cramer: build.properties; build.xml
912 Webhelp: Support admon.graphics param in build.properties
914 • David Cramer: docsrc/xinclude-test.xml; docsrc/readme.xml
916 Webhelp: Adding xinclude example to the demo/readme doc
918 • David Cramer: template/common/css/positioning.css
920 Webhelp: Remove border around table used to format callout list
922 • David Cramer: xsl/webhelp.xsl; template/common/images/admon/tip.png;
923 template/common/image⋯
925 Webhelp: Support admon graphics (still off by default)
927 • David Cramer: xsl/webhelp.xsl; template/common/css/positioning.css
929 Webhelp: Turn on navfooter and fix related css
931 • David Cramer: xsl/webhelp.xsl
933 Webhelp: Fix error about undeclared doc.title param
935 • David Cramer: docsrc/readme.xml
937 Webhelp: Adding some test search terms to the readme
939 • David Cramer: template/content/search/stemmers/en_stemmer.js
941 Handle exceptional cases listed in the Porter 2 stemming algo
943 • David Cramer: template/content/search/stemmers/en_stemmer.js
945 Webhelp: adding special case word 'say' to en js stemmer
947 • David Cramer: template/content/search/stemmers/en_stemmer.js
949 Webhelp: Refine stemming of terms that end in (only stem if there's a consonant before the -y)
951 • David Cramer: template/content/search/stemmers/en_stemmer.js; template/
954 Webhelp: fixed bug where words like key, day, and nucleus, were not found due to differences in the way the client stemmer and indexer stemmed words
956 • David Cramer: build.xml
958 Webhelp: Support xinclude and two-pass profiling in build.xml
960 • David Cramer: xsl/webhelp.xsl
962 Fix bad link to default topic.
964 • kasunbg: docsrc/readme.xml
966 Automatically limit the size of the search description to something 140 characters
968 • kasunbg: xsl/webhelp.xsl
970 removing outline in 'contents' and 'search' buttons that is visible when clicked. tabindex for SIDEBAR button.
972 • kasunbg: xsl/webhelp.xsl; build.xml
974 Webhelp ant script changes - HTML transformation support for WebHelp - Uses Tagsoup for parsing the bad html.
975 tagsoup-1.2.1.jar is added to trunk/xsl-webhelpindexer/lib/
977 • kasunbg: xsl/webhelp.xsl
979 proper support for saxon xhtml transformation.
981 • kasunbg: template/common/images/callouts/10.png; template/common/images/
984 webhelp - adding callouts
986 • kasunbg: xsl/webhelp.xsl; template/common/main.js; template/common/css/
989 webhelp - animations for show/hide Sidebar
991 • kasunbg: build.properties
993 commenting about brand and brandname
997 parameterized MAKE for webhelp
999 • kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css;
1000 build.properties; build.xml
1002 webhelp xsl customization - logo
1004 • kasunbg: template/content/search/nwSearchFnt.js
1006 remove some JS warninings
1008 • kasunbg: template/content/search/nwSearchFnt.js
1010 Fix for missing "No results found for..." bug
1012 • kasunbg: xsl/webhelp.xsl
1014 commented about the importance of the order of css contents. Order is important between the in-html-file css and the linked css files. Some css declarations in jquery-ui-1.8.2.custom.css are over-ridden. If that's a concern, just remove the additional css contents inside these default jquery css files. I thought of keeping them intact for easier maintenance.
1016 • Jirka Kosek: xsl/webhelp.xsl; template/common/css/positioning.css
1018 Minor cleanup, added extensibility hook, some styling moved into CSS for easier customization
1020 • David Cramer: template/content/search/nwSearchFnt.js
1022 Removing onclick that came from Oxygen's dita stuff
1024 • kasunbg: docsrc/readme.xml
1026 webhelp - documenting about features
1028 • kasunbg: template/common/css/positioning.css
1030 webhelp search text box
1032 • kasunbg: template/common/css/positioning.css
1034 adding header background image
1036 • kasunbg: xsl/webhelp.xsl; template/common/images/header-bg.png
1038 new header background image
1040 • kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css
1044 • kasunbg: template/common/css/positioning.css
1048 • kasunbg: build.xml
1050 Adding html.extension property
1052 • kasunbg: template/common/css/positioning.css; build.properties; build.xml
1054 webhelp - Adding enable.stemming, toc.file build properties
1056 • David Cramer: template/common/css/positioning.css
1058 Make the webhelp banner slightly larger.
1060 • David Cramer: template/common/main.js; template/common/css/positioning.css
1062 Adjust colors and positioning of header and search/toc tabs
1064 • David Cramer: xsl/webhelp.xsl
1066 Only put doc title in header
1068 • David Cramer: template/common/css/positioning.css; template/common/images/
1071 Adjusting default color of the header
1073 • kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css
1075 adjustments to header title. Now output in Opera looks good.
1077 • kasunbg: template/common/images/sidebar.png; template/content/search/
1078 punctuation.props; te⋯
1080 deleting svn:executable flag from webhelp files
1082 • kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css; template/
1085 Customized the left navagation headers; Contents and Search.
1086 Adding custom css for the current redmond ui of jquery-ui. These override jquery-ui's default css customizations. These are supposed to take precedence.
1088 • kasunbg: docsrc/readme.xml
1092 • kasunbg: template/common/images/next-arrow.png; xsl/webhelp.xsl; template/
1096 Moved search highligher to search tab.
1097 Added nice icons for navigation buttons etc.
1098 Removed footer navigation
1099 Corrected tree colorings
1100 Overall, some css magic
1102 • David Cramer: docsrc/readme.xml
1104 Added listitem thinking SyncRO Soft for their contributions.
1106 • kasunbg: build.xml
1108 support for default classpath for Gentoo Linux
1110 • kasunbg: docsrc/readme.xml
1112 webhelp - some updates to the documentation about search
1114 • kasunbg: template/common/css/positioning.css
1116 Fix for issue 'Keep "search" & "contents" titles always visible in webhelp - ID: 3403438'
1118 • David Cramer: template/common/images/starsSmall.png
1120 Changed icons used to show search weightings from stars to boxes so they won't look like user ratings
1122 • David Cramer: xsl/webhelp.xsl; template/common/main.js; template/common/
1125 Merged Oxygen webhelp improvements (search weightings etc) into trunk: -r9031:9039
1127 • kasunbg: docsrc/readme.xml
1129 webhelp documentation - search indexing, faq
1131 • kasunbg: docsrc/readme.xml
1133 update webhelp documentation
1135 • David Cramer: xsl/webhelp.xsl
1137 Fixed bug where webhelp.default.topic was not being used if it was set
1139 • David Cramer: xsl/webhelp.xsl; template/content/search/nwSearchFnt.js
1141 Localize string in nwSearchFnt.js file
1143 • David Cramer: xsl/webhelp.xsl
1145 Added tabindex attributes to make tab order in UI more logical in webhelp.
1147 • David Cramer: template/common/main.js
1149 Fixed bug where anchors in pages landed beneath the banner.
1151 • kasunbg: xsl/webhelp.xsl
1153 Added more comments to the xsl/webhelp/xsl/webhelp.xsl file. Removed some clutter.
1155 • David Cramer: template/common/main.js
1157 Fixed problem reported in IE 8. See tracker id # 373747.
1159 • David Cramer: xsl/webhelp.xsl
1161 Addressed tracker #3247166 by removing hard-coded reference to ch01.html.
1163 • kasunbg: build.xml
1165 Changed the webhelp build.xml to reflect the changes to xsl-webhelpindexer.
1166 Added classpaths for xercesImpl and xml-api jars to the indexer. Paths added for *nix environments, need to look at how the current system behaves in Windows. Discussion: http://lists.oasis-open.org/archives/docbook-apps/201011/msg00116.html
1168 • kasunbg: template/common/images/loading.gif; template/common/jquery/
1169 treeview/jquery.treevi⋯
1171 webhelp: Removing some unnecessary JQuery JS files
1173 • kasunbg: template/common/main.js
1175 webhelp: Usability improvement - when click on a node in the TOC tree, the child nodes will auto populate now.
1177 • kasunbg: xsl/webhelp.xsl
1179 Added google translated localizations for Japanese, German, French, and Chinese. The translations might not be pretty accurate.
1180 Better translations are appreciated.
1182 • kasunbg: docsrc/readme.xml; template/content/images; template/content/
1185 Added documentation for how to add images to WebHelp
1187 • Jirka Kosek: xsl/webhelp.xsl
1189 Added more customization hooks
1190 Search code output only when search tab is active
1191 Added cs localization
1193 • Jirka Kosek: xsl/webhelp.xsl
1195 Added parameter webhelp.common.dir for specifying location of common files (JS+CSS)
1196 Added hooks for adding additional user defined tabs
1200 The following changes have been made to the params code since the 1.76.1
1203 • David Cramer: webhelp.indexer.language.xml
1205 Webhelp: Fixing list of supported languages
1207 • David Cramer: webhelp.indexer.language.xml
1209 Webhelp: Correct language code in docs for Chinese
1211 • Mauritz Jeanson: admon.graphics.extension.xml
1213 Added list of graphics formats.
1215 • Mauritz Jeanson: passivetex.extensions.xml
1219 • tom_schr: webhelp.indexer.language.xml; webhelp.default.topic.xml;
1220 webhelp.tree.cookie.id.⋯
1222 Prepared WebHelp reference documentation :)
1223 Not clear about parameters brandname and branding: Should they renamed
1224 to "webhelp.branding" and "webhelp.brandname"?
1225 Currently, docsrc/reference.xml contains only a comment for the WebHelp
1226 ref doc to be non-intrusive.
1227 Idea is to enable it when it is ready
1229 • Robert Stayton: glossary.collection.xml
1231 Add info about relative paths.
1233 • Robert Stayton: para.properties.xml
1235 Special attribute-set for para only.
1237 • Robert Stayton: table.caption.properties.xml
1239 To format table captions.
1241 • Robert Stayton: html.script.type.xml; html.script.xml
1243 Add support for specifying javascript references like css references.
1245 • Robert Stayton: body.margin.outer.xml; region.outer.extent.xml;
1246 body.margin.inner.xml; reg⋯
1248 Add support for side regions in FO output.
1250 • Robert Stayton: chunked.filename.prefix.xml
1252 New param chunked.filename.prefix to separate any such prefix from
1253 the base.dir param, which helps fix bug 3087359.
1255 • Robert Stayton: generate.consistent.ids.xml
1257 New param to support replacing generate-id() with xsl:number
1258 for more consistent id values.
1260 • Robert Stayton: task.properties.xml
1262 Allow task to be customized more easily.
1264 • Robert Stayton: calloutlist.properties.xml; callout.properties.xml
1266 Support better customization of callout lists.
1268 • Jirka Kosek: callout.unicode.start.character.xml
1270 Added support for alternative circled numbers
1272 • David Cramer: example.properties.xml
1274 Made example.properties use keep-together='auto' like table.properies to avoid problems where example/programlisting takes more than one page
1276 • Mauritz Jeanson: graphicsize.extension.xml
1278 Added info about supported image formats.
1282 The following changes have been made to the highlighting code since the 1.76.1
1285 • Jirka Kosek: csharp-hl.xml
1289 • Jirka Kosek: delphi-hl.xml
1291 Additional keywords from Yuri Zhilin
1295 The following changes have been made to the profiling code since the 1.76.1
1298 • David Cramer: profile-mode.xsl
1300 When profile.* params only consist of space characters, then ignore them.
1304 The following changes have been made to the lib code since the 1.76.1 release.
1306 • Robert Stayton: lib.xweb
1308 Added two utility templates to make lib.xsl work
1309 without reference to other modules since it is used
1310 that way with profiling/xsl2profile.xsl.
1312 • Robert Stayton: lib.xweb
1314 Fix trim.common.uri.paths to first resolve any ../ in
1319 The following changes have been made to the template code since the 1.76.1
1322 • Jirka Kosek: titlepage.xsl
1324 Titlepage mechanism is now namespace aware to support XHTML. Please note that when generating titlepage template stylesheets you have to pass FO or XHTML namespace inside ns parameter. For HTML parameter should be empty.
1328 The following changes have been made to the extensions code since the 1.76.1
1333 webhelp - Adding enable.stemming, toc.file build properties
1335 • David Cramer: Makefile
1337 Attempt to convince Makefile that webhelpindexer is dirty
1341 The following changes have been made to the xsl-saxon code since the 1.76.1
1344 • Mauritz Jeanson: src/com/nwalsh/saxon/Verbatim.java; src/com/nwalsh/saxon/
1347 Added fixes to ensure that generated XHTML markup for callouts is in the proper namespace.
1349 Release Notes: 1.77.1
1351 The following is a list of changes that have been made since the 1.77.0
1356 The following changes have been made to the fo code since the 1.77.0 release.
1358 • Robert Stayton: docbook.xsl
1360 Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
1363 • Robert Stayton: block.xsl
1365 In sidebar, turn off space before first para if there is no title.
1367 • Robert Stayton: math.xsl
1369 Restored templates for mml:* elements that were accidentally deleted.
1373 The following changes have been made to the html code since the 1.77.0 release.
1375 • Robert Stayton: docbook.xsl
1377 Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
1380 • Robert Stayton: sections.xsl
1382 Use $div.element variable in place of div to support html5 section element.
1385 • Robert Stayton: autoidx.xsl
1387 Fix bug 3528673, missing "separator" param on template with
1388 match="indexterm" mode="reference". That param is passed
1389 for endofrange processing to output the range separator.
1393 The following changes have been made to the roundtrip code since the 1.77.0
1396 • Robert Stayton: dbk2ooo.xsl; dbk2pages.xsl; dbk2wordml.xsl; dbk2wp.xsl
1398 Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
1403 The following changes have been made to the slides code since the 1.77.0
1406 • Robert Stayton: html/slides-common.xsl
1408 Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
1413 The following changes have been made to the website code since the 1.77.0
1416 • Robert Stayton: website-common.xsl
1418 Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
1423 The following changes have been made to the webhelp code since the 1.77.0
1426 • kasunbg: docsrc/readme.xml
1428 updated webhelp documentation
1430 • kasunbg: template/content/search/nwSearchFnt.js; xsl/webhelp-common.xsl
1432 Removed the script htmlFileList.js since it's content is in htmlFileInfoList.js
1434 • Robert Stayton: xsl/webhelp-common.xsl
1436 In the <h1> output, replace call to 'get.doc.title' with
1437 mode="title.markup" because get.doc.title returns only
1438 the string value of the title, losing any markup such
1439 as <trademark> or <superscript>.
1441 • kasunbg: template/common/css/positioning.css; template/content/search/
1444 Remove unnecessary bits of code from webhelp
1446 • David Cramer: docsrc/readme.xml
1448 Webhelp: Minor edits to the readme
1450 • David Cramer: xsl/webhelp.xsl; xsl/titlepage.templates.xsl; xsl/
1451 titlepage.templates.xml
1453 Webhelp: Suppress abstracts from titlepages. These are used to create the search result summary sentence and should not be shown
1455 • David Cramer: build.xml
1457 Webhelp: calculate path to profile.xsl from main build.xml file
1459 Release Notes: 1.76.1
1461 The following is a list of changes that have been made since the 1.76.0
1466 The following changes have been made to the fo code since the 1.76.0 release.
1468 • Robert Stayton: docbook.xsl; xref.xsl; fop1.xsl
1470 Apply patch to support named destination in fop1.xsl, per Sourceforge
1471 bug report #3029845.
1475 The following changes have been made to the html code since the 1.76.0 release.
1477 • Keith Fahlgren: highlight.xsl
1479 Implementing handling for <b> and <i>: transform to <strong> and <em> for XHTML outputs and do not use in the highliting output (per Mauritz Jeanson)
1483 The following changes have been made to the params code since the 1.76.0
1486 • Robert Stayton: draft.mode.xml
1488 Change default for draft.mode to 'no'.
1490 Release Notes: 1.76.0
1492 This release includes important bug fixes and adds the following significant
1497 A new browser-based, cross-platform help format with full-text search and
1498 other features typically found in help systems. See webhelp/docs/content/
1499 ch01.html for more information and a demo.
1503 Many updates and additions to translation/locales thanks to Red Hat, the
1504 Fedora Project, and other contributors.
1508 Faster localization support, as language files are loaded on demand.
1512 Support for SVG content in imagedata added.
1516 Output improved when using 'make.clean.html' and a stock CSS file is now
1521 A number of improvements to NCX, cover and image selection, and XHTML 1.1
1524 The following is a list of changes that have been made since the 1.75.2
1529 The following changes have been made to the gentext code since the 1.75.2
1532 • rlandmann: locale/fa.xml
1534 Update to Persian translation from the Fedora Project
1537 • rlandmann: locale/nds.xml
1539 Locale for Low German
1542 • Mauritz Jeanson: locale/ka.xml; Makefile
1544 Added support for Georgian based on patch #2917147.
1547 • rlandmann: locale/nl.xml; locale/ja.xml
1549 Updated translations from Red Hat and the Fedora Project
1552 • rlandmann: locale/bs.xml; locale/ru.xml; locale/hr.xml
1554 Updated locales from Red Hat and the Fedora Project
1557 • rlandmann: locale/pt.xml; locale/cs.xml; locale/es.xml; locale/bg.xml;
1558 locale/nl.xml; loca⋯
1560 Updated translations from Red Hat and the Fedora Project
1563 • rlandmann: locale/as.xml; locale/bn_IN.xml; locale/ast.xml; locale/ml.xml;
1566 New translations from Red Hat and the Fedora Project
1569 • rlandmann: locale/pt.xml; locale/ca.xml; locale/da.xml; locale/sr.xml;
1570 locale/ru.xml; loca⋯
1572 Updated translations from Red Hat and the Fedora Project
1577 The following changes have been made to the common code since the 1.75.2
1580 • Mauritz Jeanson: common.xsl
1582 Fixed bug in output-orderedlist-starting-number template (@startingnumber did not work for FO).
1585 • Mauritz Jeanson: gentext.xsl
1587 Added fix to catch ID also of descendants of listitem. Closes bug #2955077.
1590 • Jirka Kosek: l10n.xsl
1592 Stripped down, faster version of gentext.template is used when there is no localization customization.
1595 • Mauritz Jeanson: stripns.xsl
1597 Added fix that preserves link/@role (makes links in the reference documentation
1598 with @role="tcg" work).
1601 • Mauritz Jeanson: l10n.xsl
1603 Fixed bugs related to manpages and L10n.
1606 • Jirka Kosek: entities.ent; autoidx-kosek.xsl
1608 Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.
1611 • Jirka Kosek: l10n.xsl; l10n.dtd; l10n.xml; autoidx-kosek.xsl
1613 Refactored localization support. Language files are loaded on demand. Speedup is about 30%.
1616 • Jirka Kosek: l10n.xsl
1618 Added xsl:keys for improved performance of localization texts look up. Performance gain around 15%.
1621 • Mauritz Jeanson: titles.xsl
1623 Fixed bug #2912677 (error with xref in title).
1626 • Robert Stayton: olink.xsl
1628 Fix bug in xrefstyle "title" handling introduced with
1629 the 'insert.targetdb.data' template.
1632 • Robert Stayton: gentext.xsl
1634 Fix bug in xref to equation without title to use context="xref-number" instead
1635 of "xref-number-and-title".
1638 • Robert Stayton: labels.xsl
1640 Number all equations in one sequence, with or without title.
1643 • Robert Stayton: entities.ent
1645 Fix bug #2896909 where duplicate @sortas on indexterms caused
1646 some indexterms to drop out of index.
1649 • Robert Stayton: stripns.xsl
1651 Expand the "Stripping namespace ..." message to advise users to
1652 use the namespaced stylesheets.
1655 • Robert Stayton: stripns.xsl
1657 need a local version of $exsl.node.set.available variable because
1658 this module imported many places.
1661 • Mauritz Jeanson: olink.xsl
1663 Added /node() to the select expression that is used to compute the title text
1664 so that no <ttl> elements end up in the output. Closes bug #2830119.
1669 The following changes have been made to the fo code since the 1.75.2 release.
1671 • Robert Stayton: table.xsl
1673 Fix bug 2979166 able - Attribute @rowheader not working
1676 • Mauritz Jeanson: inline.xsl
1678 Improved glossterm auto-linking by using keys. The old code was inefficient when processing documents
1679 with many inline glossterms.
1682 • Robert Stayton: titlepage.xsl
1684 Fix bug 2805530 author/orgname not appearing on title page.
1687 • Mauritz Jeanson: graphics.xsl
1689 Added support for SVG content in imagedata (inspired by patch #2909154).
1692 • Mauritz Jeanson: table.xsl
1694 Removed superfluous test used when computing column-width. Closes bug #3000898.
1697 • Mauritz Jeanson: inline.xsl
1699 Added missing <xsl:call-template name="anchor"/>. Closes bug #2998567.
1702 • Mauritz Jeanson: lists.xsl
1704 Added table-layout="fixed" on segmentedlist table (required by XSL spec when proportional-column-width() is used).
1707 • Jirka Kosek: autoidx-kosek.xsl
1709 Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.
1712 • Jirka Kosek: index.xsl
1714 Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.
1717 • Robert Stayton: xref.xsl
1719 Fix bug in olink template when an olink has an id.
1720 Add warning message with id value when trying to link
1721 to an element that has no generated text.
1724 • Mauritz Jeanson: refentry.xsl
1726 Fixed bug #2930968 (indexterm in refmeta not handled correctly).
1729 • Robert Stayton: block.xsl
1731 fix bug 2949567 title in revhistory breaks FO transform.
1734 • Robert Stayton: glossary.xsl
1736 Output id attributes on glossdiv blocks so they can be added to
1740 • Jirka Kosek: xref.xsl
1742 Enabled hyphenation of URLs when ulink content is the same as link target
1745 • Robert Stayton: table.xsl
1747 Apply patch to turn off row recursion if no @morerows attributes present.
1748 This will enable very large tables without row spanning to
1749 process without running into recursion limits.
1752 • Robert Stayton: formal.xsl
1754 Format equation without title using table layout with equation number
1755 next to the equation.
1758 • Robert Stayton: param.xweb; param.ent
1760 Add equation.number.properties.
1765 The following changes have been made to the html code since the 1.75.2 release.
1767 • Mauritz Jeanson: block.xsl
1769 Modified acknowledgements template to avoid invalid output (<p> in <p>).
1772 • Mauritz Jeanson: titlepage.xsl
1774 Added default sidebar attribute-sets.
1777 • Robert Stayton: table.xsl
1779 Fix bug 2979166 able - Attribute @rowheader not working
1782 • Robert Stayton: footnote.xsl
1784 Fix bug 3033191 footnotes in html tables.
1787 • Mauritz Jeanson: inline.xsl
1789 Improved glossterm auto-linking by using keys. The old code was inefficient when processing documents
1790 with many inline glossterms.
1793 • Robert Stayton: docbook.css.xml; verbatim.xsl
1795 Fix bug 2844927 Validity error for callout bugs.
1798 • Robert Stayton: formal.xsl
1800 Convert formal.object.heading to respect make.clean.html param.
1803 • Robert Stayton: titlepage.templates.xml; block.xsl
1805 Fix bug 2840768 sidebar without title inserts empty b tag.
1808 • Mauritz Jeanson: docbook.xsl
1810 Moved the template that outputs <base> so that the base URI also applies to relative CSS paths that come later.
1814 • Jirka Kosek: autoidx-kosek.xsl
1816 Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.
1819 • Robert Stayton: chunk-code.xsl
1821 fix bug 2948363 generated filename for refentry not unique, when
1825 • Robert Stayton: component.xsl
1827 Fix missing "Chapter n" label when use chapter/info/title.
1830 • Robert Stayton: table.xsl
1832 Row recursion turned off if no @morerows attributes in the table.
1833 This will prevent failure on long table (with no @morerows) due
1834 to excessive depth of recursion.
1837 • Robert Stayton: autotoc.xsl; docbook.css.xml
1839 Support make.clean.html in autotoc.xsl.
1842 • Robert Stayton: docbook.css.xml; block.xsl
1844 Add support for make.clean.html setting in block elements.
1847 • Robert Stayton: docbook.css.xml
1849 Stock CSS styles for DocBook HTML output when 'make.clean.html' is non-zero.
1852 • Robert Stayton: html.xsl
1854 Add templates for generating CSS files and links to them.
1857 • Robert Stayton: param.xweb
1859 Fix bugs in new entity references.
1862 • Robert Stayton: chunk-common.xsl
1864 List of Equations now includes on equations with titles.
1867 • Robert Stayton: table.xsl
1869 If a colspec has a colname attribute, add it to the HTML col
1870 element as a class attribute so it can be styled.
1873 • Robert Stayton: formal.xsl
1875 Fix bug 2825842 where table footnotes not appearing in HTML-coded table.
1878 • Robert Stayton: chunktoc.xsl
1880 Fix bug #2834826 where appendix inside part was not chunked as it should be.
1883 • Mauritz Jeanson: chunktoc.xsl
1885 Added missing namespace declarations. Closes bug #2890069.
1888 • Mauritz Jeanson: footnote.xsl
1890 Updated the template for footnote paras to use the 'paragraph' template. Closes bug #2803739.
1893 • Keith Fahlgren: inline.xsl; lists.xsl
1895 Remove <b> and <i> elements "discouraged in favor of style sheets" from
1896 XHTML, XHTML 1.1 (and therefore EPUB) outputs by changing html2xhtml.xsl.
1898 Fixes bug #2873153: No <b> and <i> tags in XHTML/EPUB
1900 Added regression to EPUB specs:
1903 • Mauritz Jeanson: inline.xsl
1905 Fixed bug #2844916 (don't output @target if ulink.target is empty).
1908 • Keith Fahlgren: autoidx.xsl
1910 Fix a bug when using index.on.type: an 'index symbols' section was created
1911 even if that typed index didn't include any symbols (they were in the other types).
1916 The following changes have been made to the manpages code since the 1.75.2
1919 • Mauritz Jeanson: other.xsl
1921 Modified the write.stubs template so that the section directory name is not output twice. Should fix bug #2831602.
1922 Also ensured that $lang is added to the .so path (when man.output.lang.in.name.enabled=1).
1925 • Mauritz Jeanson: docbook.xsl; other.xsl
1927 Fixed bug #2412738 (apostrophe escaping) by applying the submitted patch.
1930 • Norman Walsh: block.xsl; endnotes.xsl
1932 Fix bug where simpara in footnote didn't work. Patch by Jonathan Nieder, jrnieder@gmail.com
1935 • dleidert: lists.xsl
1937 Fix two indentation issues: In the first case there is no corresponding .RS
1938 macro (Debian #519438, sf.net 2793873). In the second case an .RS instead of
1939 the probably intended .sp leads to an indentation bug (Debian #527309,
1945 The following changes have been made to the epub code since the 1.75.2 release.
1947 • Keith Fahlgren: bin/spec/examples/AMasqueOfDays.epub; docbook.xsl; bin/spec
1950 Resolve some actual regressions in date output spotted by more recent versions of epubcheck
1953 • Keith Fahlgren: docbook.xsl
1955 Updated mediaobject selection code that better uses roles (when available); based on contributons by Glenn McDonald
1958 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
1960 Ensure that NCX documents are always outputted with a default namespace
1961 to prevent problems with the kindlegen machinery
1964 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
1965 partintro.xml; docbook.x⋯
1967 Adding support for partintros with sect2s, 3s, etc
1970 • Keith Fahlgren: docbook.xsl
1972 Adding param to workaround horrific ADE bug with the inability to process <br>
1975 • Keith Fahlgren: docbook.xsl
1977 Add support for authorgroup/author in OPF metadata (via Michael Wiedmann)
1980 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb
1982 Remove <b> and <i> elements "discouraged in favor of style sheets" from
1983 XHTML, XHTML 1.1 (and therefore EPUB) outputs by changing html2xhtml.xsl.
1985 Fixes bug #2873153: No <b> and <i> tags in XHTML/EPUB
1987 Added regression to EPUB specs:
1990 • Keith Fahlgren: bin/lib/docbook.rb; bin/spec/files/DejaVuSerif-Italic.otf;
1993 This resolves bug #2873142, Please add support for multiple embedded fonts
1996 If you navigate to a checkout of DocBook-XSL and go to:
1997 xsl/epub/bin/spec/files
1998 You can now run the following command:
2000 ../../dbtoepub -f DejaVuSerif.otf -f DejaVuSerif-Italic.otf -c test.css
2001 -s test_cust.xsl orm.book.001.xml
2003 In dbtoepub, the following option can be used more than once:
2004 -f, --font [OTF FILE] Embed OTF FILE in .epub.
2006 The underlying stylesheet now accepts a comma-separated list of font file
2007 names rather than just one as the RENAMED epub.embedded.fonts ('s' added).
2009 The runnable EPUB spec now includes:
2010 - should be valid .epub after including more than one embedded font
2013 • Keith Fahlgren: docbook.xsl
2015 Improve the selection of cover images when working in DocBook 4.x land (work in progress)
2018 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
2020 Improve the quality of the OPF spine regression by ensuring that the spine
2021 elements for deeply nested refentries are in order and adjacent to their
2022 opening wrapper XHTML chunk.
2025 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/
2028 Add more careful handling of refentries to ensure that they always appear in the opf:spine.
2029 This was only a problem when refentries were pushed deep into the hierarchy (like inside
2030 a sect2), but presented navigational problems for many reading systems (despite the
2031 correct NCX references). This may *not* be the best solution, but attacking a better
2032 chunking strategy for refentries was too big a nut to crack at this time.
2037 The following changes have been made to the eclipse code since the 1.75.2
2040 • Mauritz Jeanson: eclipse3.xsl
2042 Added a stylesheet module that generates plug-ins conforming to the standard (OSGi-based) Eclipse 3.x
2043 architecture. The main difference to the older format is that metadata is stored in a separate
2044 manifest file. The module imports and extends the existing eclipse.xsl module. Based on code
2045 contributed in patch #2624668.
2050 The following changes have been made to the params code since the 1.75.2
2053 • Robert Stayton: draft.watermark.image.xml
2055 Fix bug 2922488 draft.watermark.image pointing to web resource.
2056 Now the value is images/draft.png, and may require customization
2057 for local resolution.
2060 • Mauritz Jeanson: equation.number.properties.xml
2062 Corrected refpurpose.
2065 • Norman Walsh: paper.type.xml
2067 Added USlegal and USlegallandscape paper types.
2070 • Jirka Kosek: highlight.xslthl.config.xml
2072 Added note about specifying location as URL
2075 • Robert Stayton: docbook.css.source.xml; generate.css.header.xml;
2076 custom.css.source.xml; ma⋯
2078 Params to support generated CSS files.
2081 • Robert Stayton: equation.number.properties.xml
2083 New attribute set for numbers appearing next to equations.
2088 The following changes have been made to the xsl-xalan code since the 1.75.2
2091 • dleidert: nbproject/genfiles.properties; nbproject/build-impl.xml
2093 Rebuild netbeans build files after adding missing Netbeans configuration to allow easier packaging for Debian.
2096 Release Notes: 1.75.2
2098 The following is a list of changes that have been made since the 1.75.1
2103 The following changes have been made to the gentext code since the 1.75.1
2106 • dleidert: locale/ja.xml
2108 Improved Japanese translation for Note(s). Closes bug #2823965.
2110 • dleidert: locale/pl.xml
2112 Polish alphabet contains O with acute accent, not with grave accent. Closes bug #2823964.
2114 • Robert Stayton: locale/ja.xml
2116 Fix translation of "index", per bug report 2796064.
2118 • Robert Stayton: locale/is.xml
2120 New Icelandic locale file.
2124 The following changes have been made to the common code since the 1.75.1
2127 • Norman Walsh: stripns.xsl
2129 Support more downconvert cases
2131 • Robert Stayton: titles.xsl
2133 Make sure title inside info is used if no other title.
2137 The following changes have been made to the fo code since the 1.75.1 release.
2139 • Robert Stayton: pi.xsl
2141 Turn off dbfo-need for fop1.extensions also, per bug #2816141.
2145 The following changes have been made to the html code since the 1.75.1 release.
2147 • Mauritz Jeanson: titlepage.xsl
2149 Output "Copyright" heading in XHTML too.
2151 • Mauritz Jeanson: titlepage.xsl
2153 Added stylesheet.result.type test for copyright. Closes bug #2813289.
2155 • Norman Walsh: htmltbl.xsl
2157 Remove ambiguity wrt @span, @rowspan, and @colspan
2161 The following changes have been made to the manpages code since the 1.75.1
2164 • Mauritz Jeanson: endnotes.xsl
2166 Added normalize-space() for ulink content. Closes bug #2793877.
2168 • Mauritz Jeanson: docbook.xsl
2170 Added stylesheet.result.type test for copyright. Closes bug #2813289.
2174 The following changes have been made to the epub code since the 1.75.1 release.
2176 • Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb
2178 Corrected bugs caused by path and file assumptions were not met
2180 • Keith Fahlgren: bin/lib/docbook.rb; docbook.xsl
2182 Cleaning up hardcoded values into parameters and fixing Ruby library to pass them properly; all thanks to patch from Liza Daly
2186 The following changes have been made to the profiling code since the 1.75.1
2189 • Robert Stayton: profile.xsl
2191 Fix bug 2815493 missing exsl.node.set.available parameter.
2195 The following changes have been made to the xsl-saxon code since the 1.75.1
2198 • Mauritz Jeanson: src/com/nwalsh/saxon/ColumnUpdateEmitter.java; src/com/
2201 Added fixes so that colgroups in the XHTML namespace are processed properly.
2205 The following changes have been made to the xsl-xalan code since the 1.75.1
2208 • Mauritz Jeanson: nbproject/project.xml
2210 Added missing NetBeans configuration.
2212 Release Notes: 1.75.1
2214 This release includes bug fixes.
2216 The following is a list of changes that have been made since the 1.75.0
2221 The following changes have been made to the fo code since the 1.75.0 release.
2223 • Keith Fahlgren: block.xsl
2225 Switching to em dash for character before attribution in epigraph; resolves Bug #2793878
2227 • Robert Stayton: lists.xsl
2229 Fixed bug 2789947, id attribute missing on simplelist fo output.
2233 The following changes have been made to the html code since the 1.75.0 release.
2235 • Keith Fahlgren: block.xsl
2237 Switching to em dash for character before attribution in epigraph; resolves Bug #2793878
2239 • Robert Stayton: lists.xsl
2241 Fixed bug 2789678: apply-templates line accidentally deleted.
2245 The following changes have been made to the epub code since the 1.75.0 release.
2247 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
2249 Added regression and fix to correct "bug" with namespace-prefixed container elements in META-INF/container.xml ; resolves Issue #2790017
2251 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
2252 onegraphic.xinclude.xml;⋯
2254 Another attempt at flexible named entity and XInclude processing
2256 • Keith Fahlgren: bin/lib/docbook.rb
2258 Tweaking solution to Bug #2750442 following regression reported by Michael Wiedmann.
2262 The following changes have been made to the params code since the 1.75.0
2265 • Mauritz Jeanson: highlight.source.xml
2267 Updated documentation to reflect changes made in r8419.
2269 Release Notes: 1.75.0
2271 This release includes important bug fixes and adds the following significant
2276 Modifications to translations have been made.
2280 Added support for some format properties on tables using HTML table markup.
2282 Added two new qanda.defaultlabel values so that numbered sections and
2283 numbered questions can be distinguished. Satisfies Feature Request #
2286 Added code to handle acknowledgements in book and part. The element is
2287 processed similarly to dedication. All acknowledgements will appear as
2288 front matter, after any dedications.
2292 The inclusion of highlighting code has been simplified.
2294 Add support for pgwide on informal objects.
2296 Added a new parameter, bookmarks.collapse, that controls the initial state
2297 of the bookmark tree. Closes FR #1792326.
2299 Add support for more dbfo processing instructions.
2301 Add new variablelist.term.properties to format terms, per request #
2304 Add support for @width on screen and programlisting, fixes bug #2012736.
2306 Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.
2308 Add writing.mode param for FO output.
2312 Convert all calls to class.attribute to calls to common.html.attributes to
2313 support dir, lang, and title attributes in html output for all elements.
2314 Fulfills feature request #1993833.
2316 Inclusion of highlighting code was simplified. Only one import is now
2319 Add new param index.links.to.section.
2321 Add support for the new index.links.to.section param which permits precise
2322 links to indexterms in HTML output rather than to the section title.
2326 Slightly more nuanced handling of imageobject alternatives and better
2327 support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442
2328 reported by Raphael Hertzog.
2330 Added a colon after an abstract/title when mapping into the dc:description
2331 for OPF metadata in ePub output to help the flat text have more
2332 pseudo-semantics (sugestions from Michael Wiedmann)
2334 Added DocBook subjectset -> OPF dc:subject mapping and tests
2336 Added DocBook date -> OPF dc:date mapping and tests
2338 Added DocBook abstract -> OPF dc:description mapping and tests
2340 Added --output option to dbtoepub based on user request
2344 Add support for generating olink target database for htmlhelp files.
2348 Add default setting for @rules attribute on HTML markup tables.
2350 Added a new parameter, bookmarks.collapse, that controls the initial state
2351 of the bookmark tree. When the parameter has a non-zero value (the
2352 default), only the top-level bookmarks are displayed initially. Otherwise,
2353 the whole tree of bookmarks is displayed. This is implemented for FOP 0.9X.
2356 Add new variablelist.term.properties to format terms, per request #
2359 Add two new qanda.defaultlabel values so that numbered sections and
2360 numbered questions can be distinguished. Satisfies Feature Request #
2363 Add param to control whether an index entry links to a section title or to
2364 the precise location of the indexterm.
2366 New attribute list for glossentry in glossary.
2368 New parameter to support @width on programlisting and screen.
2370 Add attribute-sets for formatting glossary terms and defs.
2374 Inclusion of highlighting code was simplified. Only one import is now
2377 The following is a list of changes that have been made since the 1.74.3
2382 The following changes have been made to the gentext code since the 1.74.3
2385 • Robert Stayton: locale/sv.xml; locale/ja.xml; locale/pl.xml
2387 Check in translations of Legalnotice submitted on mailing list.
2389 • Robert Stayton: locale/es.xml
2391 Fix spelling errors in Acknowledgements entries.
2393 • Robert Stayton: locale/es.xml
2395 Check in translations for 4 elements submitted through docbook-apps
2396 message of 14 April 2009.
2398 • David Cramer: locale/zh.xml; locale/ca.xml; locale/ru.xml; locale/ga.xml;
2401 Internationalized punctuation in glosssee and glossseealso
2403 • Robert Stayton: Makefile
2405 Check in fixes for DSSSL gentext targets from submitted patch #1689633.
2407 • Robert Stayton: locale/uk.xml
2409 Check in major update submitted with bug report #2008524.
2411 • Robert Stayton: locale/zh_tw.xml
2413 Check in fix to Note string submitted in bug #2441051.
2415 • Robert Stayton: locale/ru.xml
2417 Checkin typo fix submitted in bug #2453406.
2421 The following changes have been made to the common code since the 1.74.3
2424 • Robert Stayton: gentext.xsl
2426 Fix extra generated space when xrefstyle includes 'nopage'.
2428 • Robert Stayton: table.xsl
2430 Add support for some format properties on tables using
2431 HTML table markup. These include:
2432 - frame attribute on table (or uses $default.table.frame parameter).
2433 - rules attribute on table (or uses $default.table.rules parameter).
2434 - align attribute on td and th
2435 - valign attribute on td and th
2436 - colspan on td and th
2437 - rowspan on td and th
2438 - bgcolor on td and th
2440 • Robert Stayton: olink.xsl
2442 Add placeholder template to massage olink hot text to make
2443 customization easier, per Feature Request 1828608.
2445 • Robert Stayton: targets.xsl
2447 Add support for collecting olink targets from a glossary
2448 generated from a glossary.collection.
2450 • Robert Stayton: titles.xsl
2452 Handle firstterm like glossterm in mode="title.markup".
2454 • Robert Stayton: titles.xsl
2456 Add match on info/title in title.markup templates where missing.
2458 • Mauritz Jeanson: titles.xsl
2460 Changed "ancestor::title" to "(ancestor::title and (@id or @xml:id))".
2461 This enables proper formatting of inline elements in titles in TOCs,
2462 as long as these inlines don't have id or xml:id attributes.
2464 • Robert Stayton: labels.xsl
2466 Add two new qanda.defaultlabel values so that numbered sections
2467 and numbered questions can be distinguished. Satisfies
2468 Feature Request #1539045.
2470 • Robert Stayton: stripns.xsl; pi.xsl
2472 Convert function-available(exsl:node-set) to use the new param
2473 so Xalan bug is isolated.
2475 • Mauritz Jeanson: titles.xsl
2477 Added fixes for bugs #2112656 and #1759205:
2478 1. Reverted mistaken commits r7485 and r7523.
2479 2. Updated the template with match="link" and mode="no.anchor.mode" so that
2480 @endterm is used if it exists and if the link has no content.
2482 • Mauritz Jeanson: titles.xsl
2484 Added code to handle acknowledgements in book and part. The element is processed
2485 similarly to dedication. All acknowledgements will appear as front matter, after
2488 • Robert Stayton: olink.xsl
2490 Fix bug #2018717 use.local.olink.style uses wrong gentext context.
2492 • Robert Stayton: olink.xsl
2494 Fix bug #1787167 incorrect hot text for some olinks.
2496 • Robert Stayton: common.xsl
2498 Fix bug #1669654 Broken output if copyright <year> contains a range.
2500 • Robert Stayton: labels.xsl
2502 Fix bug in labelling figure inside appendix inside article inside book.
2506 The following changes have been made to the fo code since the 1.74.3 release.
2508 • Jirka Kosek: highlight.xsl
2510 Inclusion of highlighting code was simplified. Only one import is now necessary.
2512 • Robert Stayton: fop1.xsl
2514 Add the new fop extensions namespace declaration, in case FOP
2515 extension functions are used.
2517 • Robert Stayton: formal.xsl
2519 Add support for pgwide on informal objects.
2521 • Robert Stayton: docbook.xsl
2523 Fixed spurious closing quote on line 134.
2525 • Robert Stayton: docbook.xsl; autoidx-kosek.xsl; autoidx.xsl
2527 Convert function-available for node-set() to use
2528 new $exsl.node.set.available param in test.
2530 • David Cramer: xref.xsl
2532 Suppress extra space after xref when xrefstyle='select: label nopage' (#2740472)
2534 • Mauritz Jeanson: pi.xsl
2536 Fixed doc bug for row-height.
2538 • David Cramer: glossary.xsl
2540 Internationalized punctuation in glosssee and glossseealso
2542 • Robert Stayton: param.xweb; param.ent; htmltbl.xsl; table.xsl
2544 Add support for some format properties on tables using
2545 HTML table markup. These include:
2546 - frame attribute on table (or uses $default.table.frame parameter).
2547 - rules attribute on table (or uses $default.table.rules parameter).
2548 - align attribute on td and th
2549 - valign attribute on td and th
2550 - colspan on td and th
2551 - rowspan on td and th
2552 - bgcolor on td and th
2554 • Robert Stayton: table.xsl
2556 Add support bgcolor in td and th
2557 elements in HTML table markup.
2559 • Robert Stayton: htmltbl.xsl
2561 Add support for colspan and rowspan and bgcolor in td and th
2562 elements in HTML table markup.
2564 • Robert Stayton: param.xweb
2566 Fix working of page-master left and right margins.
2568 • Mauritz Jeanson: param.xweb; param.ent; fop1.xsl
2570 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.
2572 • Robert Stayton: table.xsl; pi.xsl
2574 Add support for dbfo row-height processing instruction, like that in dbhtml.
2576 • Robert Stayton: lists.xsl
2578 Add support for dbfo keep-together processing instruction for
2579 entire list instances.
2581 • Robert Stayton: lists.xsl; block.xsl
2583 Add support fo dbfo keep-together processing instruction to
2584 more blocks like list items and paras.
2586 • Robert Stayton: lists.xsl; param.xweb; param.ent
2588 Add new variablelist.term.properties to format terms, per request # 1968513.
2590 • Robert Stayton: inline.xsl
2592 In simple.xlink, rearrange order of processing.
2594 • Robert Stayton: xref.xsl
2596 Handle firstterm like glossterm in mode="xref-to".
2598 • Robert Stayton: glossary.xsl; xref.xsl; pi.xsl; footnote.xsl
2600 Implement simple.xlink for glosssee and glossseealso so they can use
2601 other types of linking besides otherterm.
2603 • Robert Stayton: qandaset.xsl
2605 Add two new qanda.defaultlabel values so that numbered sections and numbered questions can be distinguished. Satisfies Feature Request #1539045.
2607 • Robert Stayton: titlepage.xsl
2609 For the book title templates, I changed info/title to book/info/title
2610 so other element's titles will not be affected.
2612 • Robert Stayton: xref.xsl; verbatim.xsl
2614 Use param exsl.node.set.available to test for function.
2616 • Robert Stayton: param.xweb; param.ent; footnote.xsl
2618 Start using new param exsl.node.set.available to work around Xalan bug.
2620 • Robert Stayton: titlepage.templates.xml
2622 Add comment on use of t:predicate for editor to prevent
2623 extra processing of multiple editors. Fixes bug 2687842.
2625 • Robert Stayton: xref.xsl; autoidx.xsl
2627 An indexterm primary, secondary, or tertiary element with an id or xml:id
2628 now outputs that ID, so that index entries can be cross referenced to.
2630 • Mauritz Jeanson: synop.xsl
2632 Added modeless template for ooclass|oointerface|ooexception.
2633 Closes bug #1623468.
2635 • Robert Stayton: xref.xsl
2637 Add template with match on indexterm in mode="xref-to" to fix bug 2102592.
2639 • Robert Stayton: xref.xsl
2641 Now xref to qandaentry will use the label element in a question for
2642 the link text if it has one.
2644 • Robert Stayton: inline.xsl
2646 Add id if specified from @id to output for quote and phrase so
2647 they can be xref'ed to.
2649 • Robert Stayton: xref.xsl
2651 Add support for xref to phrase, simpara, anchor, and quote.
2652 This assumes the author specifies something using xrefstyle since
2653 the elements don't have ordinary link text.
2655 • Robert Stayton: toc.xsl
2657 Fix bug in new toc templates.
2659 • Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl;
2660 titlepage.templates⋯
2662 Added code to handle acknowledgements in book and part. The element is processed
2663 similarly to dedication. All acknowledgements will appear as front matter, after
2666 • Robert Stayton: toc.xsl
2668 Rewrite toc templates to support an empty toc or populated toc
2669 in all permitted contexts. Same for lot elements.
2670 This fixes bug #1595969 for FO outputs.
2672 • Robert Stayton: index.xsl
2674 Fix indents for seealsoie so they are consistent.
2676 • Mauritz Jeanson: param.xweb
2678 Removed duplicate (monospace.font.family).
2680 • Robert Stayton: param.xweb; param.ent
2682 Add glossentry.list.item.properties.
2684 • Robert Stayton: param.xweb; param.ent
2686 Add monospace.verbatim.font.width param to support @width on programlisting.
2688 • Robert Stayton: verbatim.xsl
2690 Put programlisting in fo:block-container with writing-mode="lr-tb"
2691 when text direction is right to left because all program languages
2694 • Robert Stayton: verbatim.xsl
2696 Add support for @width on screen and programlisting, fixes bug #2012736.
2698 • Robert Stayton: xref.xsl
2700 Fix bug #1973585 xref to para with xrefstyle not handled correctly.
2702 • Mauritz Jeanson: block.xsl
2704 Added support for acknowledgements in article.
2705 Support in book/part remains to be added.
2707 • Robert Stayton: xref.xsl
2709 Fix bug #1787167 incorrect hot text for some olinks.
2711 • Robert Stayton: fo.xsl
2713 Add writing-mode="tb-rl" as well since some XSL-FO processors support it.
2715 • Robert Stayton: autotoc.xsl; lists.xsl; glossary.xsl; fo.xsl; table.xsl;
2718 Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.
2719 Changed instances of margin-left to margin-{$direction.align.start}
2720 and margin-right to margin-{$direction.align.end}. Those direction.align
2721 params are computed from the writing mode value in each locale's
2722 gentext key named 'writing-mode', introduced in 1.74.3 to add
2723 right-to-left support to HTML outputs.
2725 • Robert Stayton: param.xweb; param.ent
2727 Add attribute-sets for formatting glossary terms and defs.
2729 • Robert Stayton: param.xweb; param.ent
2731 Add writing.mode param for FO output.
2733 • Robert Stayton: autotoc.xsl
2735 Fix bug 1546008: in qandaentry in a TOC, use its blockinfo/titleabbrev or blockinfo/title
2736 instead of question, if available. For DocBook 5, use the info versions.
2738 • Keith Fahlgren: verbatim.xsl
2740 Add better pointer to README for XSLTHL
2742 • Keith Fahlgren: verbatim.xsl
2744 More tweaking the way that XSLTHL does or does not get called
2746 • Keith Fahlgren: verbatim.xsl
2748 Alternate attempt at sanely including/excluding XSLTHT code
2752 The following changes have been made to the html code since the 1.74.3 release.
2754 • Robert Stayton: lists.xsl
2756 Removed redundant lang and title attributes on list element inside
2757 div element for lists.
2759 • Robert Stayton: inline.xsl; titlepage.xsl; division.xsl; toc.xsl;
2760 sections.xsl; table.xsl;⋯
2762 Convert all calls to class.attribute to calls to common.html.attributes
2763 to support dir, lang, and title attributes in html output for all elements.
2764 Fulfills feature request #1993833.
2766 • Robert Stayton: chunk-common.xsl
2768 Fix bug #2750253 wrong links in list of figures in chunk.html
2769 when target html is in a subdirectory and dbhtml filename used.
2771 • Jirka Kosek: highlight.xsl
2773 Inclusion of highlighting code was simplified. Only one import is now necessary.
2775 • Robert Stayton: chunk-common.xsl; chunktoc.xsl; docbook.xsl;
2776 chunk-changebars.xsl; autoidx⋯
2778 Convert function-available for node-set() to use
2779 new $exsl.node.set.available param in test.
2781 • Mauritz Jeanson: pi.xsl
2783 Fixed doc bug for row-height.
2785 • David Cramer: glossary.xsl
2787 Internationalized punctuation in glosssee and glossseealso
2789 • Robert Stayton: lists.xsl; html.xsl; block.xsl
2791 More elements get common.html.attributes.
2792 Added locale.html.attributes template which does the lang,
2793 dir, and title attributes, but not the class attribute
2794 (used on para, for example).
2796 • Robert Stayton: lists.xsl
2798 Replace more literal class atts with mode="class.attribute" to support
2799 easier customization.
2801 • Robert Stayton: glossary.xsl
2803 Support olinking in glosssee and glossseealso.
2805 • Robert Stayton: inline.xsl
2807 In simple.xlink, rearrange order of processing.
2809 • Robert Stayton: xref.xsl
2811 Handle firstterm like glossterm in mode="xref-to".
2813 • Robert Stayton: lists.xsl; html.xsl; block.xsl
2815 Added template named common.html.attributes to output
2816 class, title, lang, and dir for most elements.
2817 Started adding it to some list and block elements.
2819 • Robert Stayton: qandaset.xsl
2821 Add two new qanda.defaultlabel values so that numbered sections
2822 and numbered questions can be distinguished. Satisfies
2823 Feature Request #1539045.
2825 • Robert Stayton: param.xweb; chunk-code.xsl; param.ent; xref.xsl;
2826 chunkfast.xsl; verbatim.x⋯
2828 Use new param exsl.node.set.available to test, handles Xalan bug.
2830 • Robert Stayton: autoidx.xsl
2832 Use named anchors for primary, secondary, and tertiary ids so
2833 duplicate entries with different ids can still have an id output.
2835 • Robert Stayton: param.xweb; param.ent
2837 Add new param index.links.to.section.
2839 • Robert Stayton: xref.xsl; autoidx.xsl
2841 Pass through an id on primary, secondary, or tertiary to
2842 the index entry, so that one could link to an index entry.
2843 You can't link to the id on an indexterm because that is
2844 used to place the main anchor in the text flow.
2846 • Robert Stayton: autoidx.xsl
2848 Add support for the new index.links.to.section param which permits
2849 precise links to indexterms in HTML output rather than to
2852 • Mauritz Jeanson: synop.xsl
2854 Added modeless template for ooclass|oointerface|ooexception.
2855 Closes bug #1623468.
2857 • Robert Stayton: qandaset.xsl
2859 Make sure a qandaset has an anchor, even when it has no title,
2860 because it may be referenced in a TOC or xref.
2861 Before, the anchor was output by the title, but there was no
2862 anchor if there was no title.
2864 • Robert Stayton: xref.xsl
2866 Add a template for indexterm with mode="xref-to" to fix bug 2102592.
2868 • Robert Stayton: xref.xsl
2870 Now xref to qandaentry will use the label element in a question for
2871 the link text if it has one.
2873 • Robert Stayton: qandaset.xsl; html.xsl
2875 Create separate templates for computing label of question and answer
2876 in a qandaentry, so such can be used for the alt text of an xref
2879 • Robert Stayton: inline.xsl; xref.xsl
2881 Now support xref to phrase, simpara, anchor, and quote,
2882 most useful when an xrefstyle is used.
2884 • Robert Stayton: toc.xsl
2886 Rewrite toc templates to support an empty toc or populated toc
2887 in all permitted contexts. Same for lot elements.
2888 This fixes bug #1595969 for HTML outputs.
2890 • Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl;
2891 titlepage.templates⋯
2893 Added code to handle acknowledgements in book and part. The element is processed
2894 similarly to dedication. All acknowledgements will appear as front matter, after
2897 • Robert Stayton: index.xsl
2899 Rewrote primaryie, secondaryie and tertiaryie templates to handle
2900 nesting of elements and seeie and seealsoie, as reported in
2903 • Robert Stayton: autotoc.xsl
2905 Fix simplesect in toc problem.
2907 • Robert Stayton: verbatim.xsl
2909 Add support for @width per bug report #2012736.
2911 • Robert Stayton: formal.xsl; htmltbl.xsl
2913 Fix bug #1787140 HTML tables not handling attributes correctly.
2915 • Robert Stayton: param.xweb
2917 Move writing-mode param.
2919 • Keith Fahlgren: refentry.xsl
2921 Remove a nesting of <p> inside <p> for refclass (made XHTML* invalid, made HTML silly)
2923 • Robert Stayton: table.xsl
2925 Fix bug #1945872 to allow passthrough of colwidth values to
2926 HTML table when no tablecolumns.extension is available and
2927 when no instance of * appears in the table's colspecs.
2929 • Mauritz Jeanson: block.xsl
2931 Added support for acknowledgements in article.
2932 Support in book/part remains to be added.
2934 • Robert Stayton: chunk-common.xsl
2936 Fix bug #1787167 incorrect hot text for some olinks.
2938 • Robert Stayton: qandaset.xsl
2940 Fix bug 1546008: in qandaentry in a TOC, use its blockinfo/titleabbrev or blockinfo/title
2941 instead of question, if available. For DocBook 5, use the info versions.
2943 • Robert Stayton: chunktoc.xsl
2945 Add support for generating olink database when using chunktoc.xsl.
2947 • Keith Fahlgren: verbatim.xsl
2949 Add better pointer to README for XSLTHL
2951 • Keith Fahlgren: verbatim.xsl
2953 Another stab at fixing the stupid XSLTHT includes across processors (Saxon regression reported by Sorin Ristache)
2955 • Keith Fahlgren: verbatim.xsl
2957 More tweaking the way that XSLTHL does or does not get called
2959 • Keith Fahlgren: verbatim.xsl
2961 Alternate attempt at sanely including/excluding XSLTHT code
2965 The following changes have been made to the manpages code since the 1.74.3
2968 • Robert Stayton: table.xsl
2970 Convert function-available test for node-set() function to
2971 test of $exsl.node.set.available param.
2973 • Mauritz Jeanson: lists.xsl
2975 Added a template for bibliolist. Closes bug #1815916.
2979 The following changes have been made to the epub code since the 1.74.3 release.
2981 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
2982 onegraphic.xinclude.xml;⋯
2984 Slightly more nuanced handling of imageobject alternatives and better support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442 reported by Raphael Hertzog.
2986 • Keith Fahlgren: docbook.xsl
2988 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)
2990 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/
2993 Correctly set dc:language in OPF metadata when i18nizing. Closes Bug #2755150
2995 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
2997 Corrected namespace declarations for literal XHTML elements to make them serialize "normally"
2999 • Keith Fahlgren: docbook.xsl
3001 Be a little bit more nuanced about dates
3003 • Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
3006 Add DocBook subjectset -> OPF dc:subject mapping and tests
3008 • Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
3011 Add DocBook date -> OPF dc:date mapping and tests
3013 • Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
3016 Add DocBook abstract -> OPF dc:description mapping and tests
3018 • Robert Stayton: docbook.xsl
3020 Check in patch submitted by user to add opf:file-as attribute
3021 to dc:creator element.
3023 • Keith Fahlgren: bin/dbtoepub
3025 Adding --output option to dbtoepub based on user request
3027 • Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb
3029 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)
3031 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
3034 Remove a nesting of <p> inside <p> for refclass (made XHTML* invalid, made HTML silly)
3036 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
3039 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.
3043 The following changes have been made to the htmlhelp code since the 1.74.3
3046 • Robert Stayton: htmlhelp-common.xsl
3048 Add support for generating olink target database for htmlhelp files.
3052 The following changes have been made to the params code since the 1.74.3
3055 • Robert Stayton: default.table.rules.xml
3057 Add default setting for @rules attribute on HTML markup tables.
3059 • Mauritz Jeanson: bookmarks.collapse.xml
3061 Added a new parameter, bookmarks.collapse, that controls the initial state
3062 of the bookmark tree. When the parameter has a non-zero value (the default),
3063 only the top-level bookmarks are displayed initially. Otherwise, the whole
3064 tree of bookmarks is displayed.
3066 This is implemented for FOP 0.9X. Closes FR #1792326.
3068 • Robert Stayton: variablelist.term.properties.xml
3070 Add new variablelist.term.properties to format terms, per
3073 • Robert Stayton: qanda.defaultlabel.xml
3075 Add two new qanda.defaultlabel values so that numbered sections
3076 and numbered questions can be distinguished. Satisfies
3077 Feature Request #1539045.
3079 • Robert Stayton: index.links.to.section.xml
3081 Change default to 1 to match past behavior.
3083 • Robert Stayton: exsl.node.set.available.xml
3085 Isolate this text for Xalan bug regarding exsl:node-set available.
3086 If it is ever fixed in Xalan, just fix it here.
3088 • Robert Stayton: index.links.to.section.xml
3090 Add param to control whether an index entry links to
3091 a section title or to the precise location of the
3094 • Robert Stayton: glossentry.list.item.properties.xml
3096 New attribute list for glossentry in glossary.
3098 • Robert Stayton: monospace.verbatim.font.width.xml
3100 New parameter to support @width on programlisting and screen.
3102 • Mauritz Jeanson: highlight.source.xml
3104 Updated and reorganized the description.
3106 • Robert Stayton: page.margin.outer.xml; page.margin.inner.xml
3108 Add caveat about XEP bug when writing-mode is right-to-left.
3110 • Robert Stayton: article.appendix.title.properties.xml; writing.mode.xml;
3113 Change 'left' to 'start' and 'right' to 'end' to support right-to-left
3116 • Robert Stayton: glossdef.block.properties.xml;
3117 glossdef.list.properties.xml; glossterm.blo⋯
3119 Add attribute-sets for formatting glossary terms and defs.
3121 • Robert Stayton: glossterm.separation.xml
3123 Clarify the description.
3125 • Robert Stayton: make.year.ranges.xml
3127 Now handles year element containing a comma or dash without error.
3131 The following changes have been made to the highlighting code since the 1.74.3
3134 • Jirka Kosek: README
3136 Inclusion of highlighting code was simplified. Only one import is now necessary.
3138 • Keith Fahlgren: README
3140 Adding XSLTHL readme
3142 • Keith Fahlgren: common.xsl
3144 Alternate attempt at sanely including/excluding XSLTHT code
3148 The following changes have been made to the xsl-saxon code since the 1.74.3
3151 • Mauritz Jeanson: src/com/nwalsh/saxon/Text.java
3153 Added a fix that prevents output of extra blank line.
3154 Hopefully this closes bug #894805.
3158 The following changes have been made to the xsl-xalan code since the 1.74.3
3161 • Mauritz Jeanson: src/com/nwalsh/xalan/Text.java
3163 Added a fix that prevents output of extra blank line.
3164 Hopefully this closes bug #894805.
3166 Release Notes: 1.74.3
3168 This release fixes some bugs in the 1.74.2 release.
3170 See highlighting/README for XSLTHL usage instructions.
3172 Release Notes: 1.74.2
3174 This release fixes some bugs in the 1.74.1 release.
3176 Release Notes: 1.74.1
3178 This release includes important bug fixes and adds the following significant
3183 Kirghiz locale added and Chinese translations have been simplified.
3185 Somme support for gentext and right-to-left languages has been added.
3189 Various bugs have been resolved.
3191 Support for a new processing instruction: dbfo funcsynopsis-style has been
3194 Added new param email.mailto.enabled for FO output. Patch from Paolo
3197 Support for documented metadata in fop1 mode has been added.
3201 Support for the latest version of XSLTHL 2.0 and some new language syntaxes
3202 have been added to a variety of outputs.
3206 Added man.output.better.ps.enabled param (zero default). It non-zero, no
3207 such markup is embedded in generated man pages, and no enhancements are
3208 included in the PostScript output generated from those man pages by the man
3213 Support for writing.mode to set text direction and alignment based on
3214 document locale has been added.
3216 Added a new top-level stylesheet module, chunk-changebars.xsl, to be used
3217 for generating chunked output with highlighting based on change
3218 (@revisionflag) markup. The module imports/includes the standard chunking
3219 and changebars templates and contains additional logic for chunked output.
3220 See FRs #1015180 and #1819915.
3224 Covers now look better in Adobe Digital Editions thanks to a patch from
3225 Paul Norton of Adobe
3227 Cover handling now more generic (including limited DocBook 5.0 cover
3228 support thanks to patch contributed by Liza Daly.
3230 Cover markup now carries more reliably into files destined for .mobi and
3233 dc:identifiers are now generated from more types of numbering schemes.
3235 Both SEO and semantic structure of chunked ePub output by ensuring that we
3236 always send out one and only one h1 in each XHTML chunk.
3238 Primitive support for embedding a single font added.
3240 Support for embedding a CSS customizations added.
3244 Support for imagedata-metadata and table as images added.
3246 Support for imagedata-metadata and legalnotice as images added.
3250 man.output.better.ps.enabled added for Manpages output
3252 writing.mode.xml added to set text direction.
3254 Added new param email.mailto.enabled for FO output. Patch from Paolo
3255 Borelli. Closes #2086321.
3257 highlight.source upgraded to support the latest version of XSLTHL 2.0.
3259 The following is a list of changes that have been made since the 1.74.0
3264 The following changes have been made to the gentext code since the 1.74.0
3267 • Michael(tm) Smith: locale/ky.xml; Makefile
3269 new Kirghiz locale from Ilyas Bakirov
3271 • Mauritz Jeanson: locale/en.xml
3273 Added "Acknowledgements".
3275 • Dongsheng Song: locale/zh_cn.xml
3277 Simplified Chinese translation.
3279 • Robert Stayton: locale/lv.xml; locale/ca.xml; locale/pt.xml; locale/tr.xml;
3282 Add writing-mode gentext string to support right-to-left languages.
3286 The following changes have been made to the fo code since the 1.74.0 release.
3288 • David Cramer: footnote.xsl
3290 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.
3292 • Mauritz Jeanson: spaces.xsl
3294 Convert spaces to fo:leader also in elements in the DB 5 namespace.
3296 • Mauritz Jeanson: pi.xsl; synop.xsl
3298 Added support for a new processing instruction: dbfo funcsynopsis-style.
3299 Closes bug #1838213.
3301 • Michael(tm) Smith: inline.xsl; param.xweb; param.ent
3303 Added new param email.mailto.enabled for FO output.
3304 Patch from Paolo Borelli. Closes #2086321.
3306 • Mauritz Jeanson: docbook.xsl
3308 Added support for document metadata for fop1 (patch #2067318).
3310 • Jirka Kosek: param.ent; param.xweb; highlight.xsl
3312 Upgraded to support the latest version of XSLTHL 2.0
3313 -- nested markup in highlited code is now processed
3314 -- it is no longer needed to specify path XSLTHL configuration file using Java property
3315 -- support for new languages, including Perl, Python and Ruby was added
3319 The following changes have been made to the html code since the 1.74.0 release.
3321 • Robert Stayton: param.xweb; docbook.xsl; param.ent; html.xsl
3323 Add support for writing.mode to set text direction and alignment based on document locale.
3325 • Mauritz Jeanson: chunk-changebars.xsl
3327 Added a new top-level stylesheet module, chunk-changebars.xsl, to be
3328 used for generating chunked output with highlighting based on change
3329 (@revisionflag) markup. The module imports/includes the standard chunking
3330 and changebars templates and contains additional logic for chunked output.
3331 See FRs #1015180 and #1819915.
3335 The following changes have been made to the manpages code since the 1.74.0
3338 • Michael(tm) Smith: docbook.xsl
3340 Put the following at the top of generated roff for each page:
3342 purpose is to explicitly tell AT&T troff that the page needs to be
3343 pre-processed through tbl(1); groff can figure it out
3344 automatically, but apparently AT&T troff needs to be explicitly told
3348 The following changes have been made to the epub code since the 1.74.0 release.
3350 • Keith Fahlgren: docbook.xsl
3352 Patch from Paul Norton of Adobe to get covers to look better in Adobe Digital Editions
3354 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
3355 v5cover.xml; bin/spec/sp⋯
3357 Patch contributed by Liza Daly to make ePub cover handling more generic. Additionally
3358 DocBook 5.0's <cover> now has some limited support:
3360 - should reference a cover in the OPF guide for a DocBook 5.0 test document
3362 • Keith Fahlgren: bin/spec/files/isbn.xml; bin/spec/files/issn.xml; bin/spec/
3365 Liza Daly reported that the dc:identifer-generation code was garbage (she was right).
3368 - should include at least one dc:identifier
3369 - should include an ISBN as URN for dc:identifier if an ISBN was in the metadata
3370 - should include an ISSN as URN for dc:identifier if an ISSN was in the metadata
3371 - should include an biblioid as a dc:identifier if an biblioid was in the metadata
3372 - should include a URN for a biblioid with @class attribute as a dc:identifier if an biblioid was in the metadata
3374 • Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb
3376 Improve both SEO and semantic structure of chunked ePub output by ensuring that
3377 we always send out one and only one h1 in each XHTML chunk.
3380 - should include one and only one <h1> in each HTML file in rendered ePub files
3382 - should include one and only one <h1> in each HTML file in rendered ePub files
3383 for <book>s even if they do not have section markup
3385 • Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
3388 Adding better support for covers in epub files destined for .mobi and the Kindle
3390 • Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/
3391 DejaVuSerif.otf; docbook.⋯
3393 Adding primitive support for embedding a single font
3395 • Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/
3396 test_cust.xsl; bin/spec/e⋯
3398 Adding support for user-specified customization layers in dbtoepub
3400 • Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/
3403 Adding CSS support to .epub target & dbtoepub:
3404 -c, --css [FILE] Use FILE for CSS on generated XHTML.
3409 - should include a CSS link in HTML files when a CSS file has been provided
3410 - should include CSS file in .epub when a CSS file has been provided
3411 - should include a CSS link in OPF file when a CSS file has been provided
3415 The following changes have been made to the roundtrip code since the 1.74.0
3418 • Steve Ball: blocks2dbk.xsl; template.xml; template.dot
3420 added support for imagedata-metadata
3421 added support for table as images
3423 • Steve Ball: blocks2dbk.xsl; normalise2sections.xsl; sections2blocks.xsl
3425 Improved support for personname inlines.
3427 • Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml
3429 Added support for legalnotice.
3431 • Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl
3433 added support for orgname in author
3435 • Steve Ball: specifications.xml; supported.xml; blocks2dbk.xsl;
3436 wordml2normalise.xsl; dbk2w⋯
3438 Updated specification.
3439 to-DocBook: add cols attribute to tgroup
3440 from-DocBook: fix for blockquote title
3444 The following changes have been made to the params since the 1.74.0 release.
3446 • The change was to add man.output.better.ps.enabled parameter, with its
3447 default value set to zero. If the value of the man.output.better.ps.enabled
3448 parameter is non-zero, certain markup is embedded in each generated man
3449 page such that PostScript output from the man -Tps command for that page
3450 will include a number of enhancements designed to improve the quality of
3451 that output. If man.output.better.ps.enabled is zero (the default), no such
3452 markup is embedded in generated man pages, and no enhancements are included
3453 in the PostScript output generated from those man pages by the man -Tps
3454 command. WARNING: The enhancements provided by this parameter rely on
3455 features that are specific to groff (GNU troff) and that are not part of
3456 "classic" AT&T troff or any of its derivatives. Therefore, any man pages
3457 you generate with this parameter enabled will be readable only on systems
3458 on which the groff (GNU troff) program is installed, such as GNU/Linux
3459 systems. The pages will not not be readable on systems on with the classic
3460 troff (AT&T troff) command is installed. NOTE: The value of this parameter
3461 only affects PostScript output generated from the man command. It has no
3462 effect on output generated using the FO backend. TIP: You can generate
3463 PostScript output for any man page by running the following command: man
3464 FOO -Tps > FOO.ps You can then generate PDF output by running the following
3465 command: ps2pdf FOO.ps
3467 • Robert Stayton: writing.mode.xml
3469 writing mode param used to set text direction.
3471 • Michael(tm) Smith: email.mailto.enabled.xml
3473 Added new param email.mailto.enabled for FO output.
3474 Patch from Paolo Borelli. Closes #2086321.
3476 • Jirka Kosek: highlight.source.xml; highlight.xslthl.config.xml
3478 Upgraded to support the latest version of XSLTHL 2.0
3479 -- nested markup in highlited code is now processed
3480 -- it is no longer needed to specify path XSLTHL configuration file using Java property
3481 -- support for new languages, including Perl, Python and Ruby was added
3485 The following changes have been made to the highlighting code since the 1.74.0
3488 • Jirka Kosek: cpp-hl.xml; c-hl.xml; tcl-hl.xml; php-hl.xml; common.xsl;
3489 perl-hl.xml; delphi⋯
3491 Upgraded to support the latest version of XSLTHL 2.0
3492 -- nested markup in highlited code is now processed
3493 -- it is no longer needed to specify path XSLTHL configuration file using Java property
3494 -- support for new languages, including Perl, Python and Ruby was added
3496 Release Notes: 1.74.0
3498 This release includes important bug fixes and adds the following significant
3503 Paul Norton (Adobe) and Keith Fahlgren(O'Reilly Media) have donated code
3504 that generates .epub documents from DocBook input. An alpha-reference
3505 implementation in Ruby has also been provided.
3507 .epub is an open standard of the The International Digital Publishing Forum
3508 (IDPF), a the trade and standards association for the digital publishing
3511 Read more about this target in epub/README
3515 To support .epub output, a strict XHTML 1.1 target has been added. The
3516 stylesheets for this output are generated and are quite similar to the
3521 A number of locales have been updated.
3523 Roundtrip improvements
3525 Table, figure, template syncronization, and character style improvements
3526 have been made for WordML & Pages. Support added for OpenOffice.org.
3528 First implementation of a libxslt extension
3530 A stylesheet extension for libxslt, written in Python, has been added. The
3531 extension is a function for adjusting column widths in CALS tables. See
3532 extensions/README.LIBXSLT for more information.
3534 The following is a list of changes that have been made since the 1.73.2
3539 The following changes have been made to the gentext code since the 1.73.2
3542 • Michael(tm) Smith: locale/id.xml
3544 Checked in changes to Indonesion locale submitted by Euis Luhuanam a long time ago.
3546 • Michael(tm) Smith: locale/lt.xml
3548 Added changes to Lithuanian locate submitted a long time back by Nikolajus Krauklis.
3550 • Michael(tm) Smith: locale/hu.xml
3552 fixed error in lowercase.alpha definition in Hungarian locale
3554 • Michael(tm) Smith: locale/nb.xml
3556 Corrected language code for nb locale, and restored missing "startquote" key.
3558 • Michael(tm) Smith: locale/ja.xml
3560 Committed changes to ja locale file, from Akagi Kobayashi. Adds bracket quotes around many xref instances that did not have them
3563 • Michael(tm) Smith: Makefile
3565 "no" locale is now "nb"
3567 • Michael(tm) Smith: locale/nb.xml
3569 Update Norwegian Bokmål translation. Thanks to Hans F. Nordhaug.
3571 • Michael(tm) Smith: locale/no.xml; locale/nb.xml
3573 per message from Hans F. Nordhaug, correct identifier for
3574 Norwegian Bokmål is "nb" (not "no") and has been for quite some
3577 • Michael(tm) Smith: locale/ja.xml
3579 Converted ja.xml source file to use real unicode characters so
3580 that the actual glyphs so up when you edit it in a text editor
3581 (instead of the character references).
3583 • Michael(tm) Smith: locale/ja.xml
3585 Checked in changes to ja.xml locale file. Thanks to Akagi Kobayashi.
3587 • Michael(tm) Smith: locale/it.xml
3589 Changes from Federico Zenith
3591 • Dongsheng Song: locale/zh_cn.xml
3593 Added missing translations.
3597 The following changes have been made to the common code since the 1.73.2
3600 • Michael(tm) Smith: l10n.xsl
3602 Added new template "l10.language.name" for retrieving the
3603 English-language name of the lang setting of the current document.
3604 Closes #1916837. Thanks to Simon Kennedy.
3606 • Michael(tm) Smith: refentry.xsl
3610 • Michael(tm) Smith: refentry.xsl
3612 fixed a couple of typos
3614 • Michael(tm) Smith: refentry.xsl
3616 refined handling of cases where refentry "source" or "manual"
3617 metadata is missing or when we use fallback content instead. We
3618 now report a Warning if we use fallback content.
3620 • Michael(tm) Smith: refentry.xsl
3622 don't use refmiscinfo@class=date value as fallback for refentry
3623 "source" or "manual" metadata fields
3625 • Michael(tm) Smith: refentry.xsl
3627 Made reporting of missing refentry metadata more quiet:
3629 - we no longer report anything if usable-but-not-preferred
3630 metadata is found; we just quietly use whatever we manage to
3633 - we now only report missing "source" metadata if the refentry
3634 is missing BOTH "source name" and "version" metadata; if it
3635 has one but not the other, we use whichever one it has and
3636 don't report anything as missing
3638 The above changes were made because testing with some "real world"
3639 source reveals that some authors are intentionally choosing to use
3640 "non preferred" markup for some metadata, and also choosing to
3641 omit "source name" or "version" metadata in there DocBook XML. So
3642 it does no good to give them pedantic reminders about what they
3645 Also, changed code to cause "fixme" text to be inserted in output
3646 in particular cases:
3648 - if we can't manage to find any "source" metadata at all, we
3649 now put fixme text into the output
3651 - if we can't manage to find any "manual" metadata a all, we
3652 now put fixme text into the output
3654 The "source" and "manual" metadata is necessary information, so
3655 buy putting the fixme stuff in the output, we alert users to the
3656 need problem of it being missing.
3658 • Michael(tm) Smith: refentry.xsl
3660 When generating manpages output, we no longer report anything if
3661 the refentry source is missing date or pubdate content. In
3662 practice, many users intentionally omit the date from the source
3663 because they explicitly want it to be generated.
3665 • Michael(tm) Smith: l10n.xml
3667 further change needed for switch from no locale to nb.
3669 • Michael(tm) Smith: common.xsl
3671 Added support for orgname in authorgroup. Thanks to Camille
3674 • Michael(tm) Smith: Makefile
3676 "no" locale is now "nb"
3678 • Mauritz Jeanson: stripns.xsl
3680 Removed the template matching "ng:link|db:link" (in order to make @xlink:show
3681 work with <link> elements). As far as I can tell, this template is no longer needed.
3683 • Mauritz Jeanson: entities.ent
3685 Moved declaration of comment.block.parents entity to common/entities.ent.
3687 • Mauritz Jeanson: titles.xsl
3689 Added an update the fix made in revision 7528 (handling of xref/link in no.anchor.mode mode).
3690 Having xref in title is not a problem as long as the target is not an ancestor element.
3691 Closes bug #1838136.
3693 Note that an xref that is in a title and whose target is an ancestor element is still not
3694 rendered in the TOC. This could be considered a bug, but on the other hand I cannot really
3695 see the point in having such an xref in a document.
3697 • Mauritz Jeanson: titles.xsl
3699 Added a "not(ancestor::title)" test to work around "too many nested
3700 apply-templates" problems when processing xrefs or links in no.anchor.mode mode.
3701 Hopefully, this closes bug #1811721.
3703 • Mauritz Jeanson: titles.xsl
3705 Removed old template matching "link" in no.anchor.mode mode.
3707 • Mauritz Jeanson: titles.xsl
3709 Process <link> in no.anchor.mode mode with the same template as <xref>.
3710 Closes bug #1759205 (Empty link in no.anchor.mode mode).
3712 • Mauritz Jeanson: titles.xsl
3714 In no.anchor.mode mode, do not output anchors for elements that are descendants
3715 of <title>. Previously, having inline elements with @id/@xml:id in <title>s
3716 resulted in anchors both in the TOC and in the main flow. Closes bug #1797492.
3720 The following changes have been made to the fo code since the 1.73.2 release.
3722 • Mauritz Jeanson: pi.xsl
3724 Updated documentation for keep-together.
3726 • Mauritz Jeanson: task.xsl
3728 Enabled use of the keep-together PI on task elements.
3730 • Robert Stayton: index.xsl
3732 FOP1 requires fo:wrapper for inline index entries, not fo:inline.
3734 • Robert Stayton: index.xsl
3736 Fixed non-working inline.or.block template for indexterm wrappers.
3737 Add fop1 to list of processors using inline.or.block.
3739 • Mauritz Jeanson: table.xsl
3741 Fixed bug #1891965 (colsep in entytbl not working).
3743 • Mauritz Jeanson: titlepage.xsl
3745 Added support for title in revhistory. Closes bug #1842847.
3747 • Mauritz Jeanson: pi.xsl
3749 Small doc cleanup (dbfo float-type).
3751 • Mauritz Jeanson: titlepage.xsl
3753 Insert commas between multiple copyright holders.
3755 • Mauritz Jeanson: autotoc.xsl; division.xsl
3757 Added modifications to support nested set elements. See bug #1853172.
3759 • David Cramer: glossary.xsl
3761 Added normalize-space to xsl:sorts to avoid missorting of glossterms due to stray leading spaces.
3763 • David Cramer: glossary.xsl
3765 Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry
3767 • Mauritz Jeanson: inline.xsl
3769 Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,
3770 and the "hot text" is the biblioid itself enclosed in brackets.
3772 • Mauritz Jeanson: inline.xsl
3774 Moved declaration of comment.block.parents entity to common/entities.ent.
3776 • Mauritz Jeanson: docbook.xsl
3778 Updated message about unmatched element.
3780 • Mauritz Jeanson: param.xweb
3782 Added link to profiling chapter of TCG.
3784 • Mauritz Jeanson: refentry.xsl
3786 Fixed typo (refsynopsysdiv -> refsynopsisdiv).
3788 • David Cramer: fop.xsl; fop1.xsl; ptc.xsl; xep.xsl
3790 Added test to check generate.index param when generating pdf bookmarks
3792 • Mauritz Jeanson: graphics.xsl
3794 Added support for MathML in imagedata.
3796 • Michael(tm) Smith: math.xsl
3798 Removed unnecessary extra test condition in test express that
3799 checks for passivetex.
3801 • Michael(tm) Smith: math.xsl
3803 Don't use fo:instream-foreign-object if we are processing with
3804 passivetex. Closes #1806899. Thanks to Justus Piater.
3806 • Mauritz Jeanson: component.xsl
3808 Added code to output a TOC for an appendix in an article when
3809 generate.toc='article/appendix toc'. Closes bug #1669658.
3811 • Dongsheng Song: biblio-iso690.xsl
3813 Change encoding from "windows-1250" to "UTF-8".
3815 • Mauritz Jeanson: pi.xsl
3817 Updated documentation for dbfo_label-width.
3819 • Mauritz Jeanson: lists.xsl
3821 Added support for the dbfo_label-width PI in calloutlists.
3823 • Robert Stayton: biblio.xsl
3825 Support finding glossary database entries inside bibliodivs.
3827 • Robert Stayton: formal.xsl
3829 Complete support for <?dbfo pgwide="1"?> for informal
3832 • Mauritz Jeanson: table.xsl
3834 In the table.block template, added a check for the dbfo_keep-together PI, so that
3835 a table may break (depending on the PI value) at a page break. This was needed
3836 since the outer fo:block that surrounds fo:table has keep-together.within-column="always"
3837 by default, which prevents the table from breaking. Closes bug #1740964 (Titled
3838 table does not respect dbfo PI).
3840 • Mauritz Jeanson: pi.xsl
3842 Added a few missing @role="tcg".
3844 • Mauritz Jeanson: inline.xsl
3846 Use normalize-space() in glossterm comparisons (as in html/inline.xsl).
3848 • Mauritz Jeanson: autoidx.xsl
3850 Removed the [&scope;] predicate from the target variable in the template with name="reference".
3851 This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
3852 with index.on.type=1. Closes bug #1680836.
3854 • Michael(tm) Smith: inline.xsl; xref.xsl; footnote.xsl
3856 Added capability in FO output for displaying URLs for all
3857 hyperlinks (elements marked up with xlink:href attributes) in the
3858 same way as URLs for ulinks are already handled (which is to say,
3859 either inline or as numbered footnotes).
3861 Background on this change:
3862 DocBook 5 allows "ubiquitous" linking, which means you can make
3863 any element a hyperlink just by adding an xlink:href attribute to
3864 it, with the value set to an external URL. That's in contrast to
3865 DocBook 4, which only allows you to use specific elements (e.g.,
3866 the link and ulink elements) to mark up hyperlinks.
3868 The existing FO stylesheets have a mechanism for handling display
3869 of URLs for hyperlinks that are marked up with ulink, but they did
3870 not handle display of URLs for elements that were marked up with
3871 xlink:href attributes. This change adds handling for those other
3872 elements, enabling the URLs they link to be displayed either
3873 inline or as numbered footnotes (depending on what values the user
3874 has the ulink.show and ulink.footnotes params set to).
3876 Note that this change only adds URL display support for elements
3877 that call the simple.xlink template -- which currently is most
3878 (but not all) inline elements.
3880 This change also moves the URL display handling out of the ulink
3881 template and into a new "hyperlink.url.display" named template;
3882 the ulink template and the simple.xlink named template now both
3883 call the hyperlink.url.display template.
3885 Warning: In the stylesheet code that determines what footnote
3886 number to assign to each footnote or external hyperlink, there is
3887 an XPath expression for determining whether a particular
3888 xlink:href instance is an external hyperlink; that expression is
3889 necessarily a bit complicated and further testing may reveal that
3890 it doesn't handle all cases as expected -- so some refinements to
3891 it may need to be done later.
3893 Closes #1785519. Thanks to Ken Morse for reporting and
3894 troubleshooting the problem.
3898 The following changes have been made to the html code since the 1.73.2 release.
3900 • Keith Fahlgren: inline.xsl; synop.xsl
3902 Work to make HTML and XHTML targets more valid
3904 • Keith Fahlgren: table.xsl
3906 Add better handling for tables that have footnotes in the titles
3908 • Keith Fahlgren: biblio.xsl
3910 Add anchors to bibliodivs
3912 • Keith Fahlgren: formal.xsl; Makefile; htmltbl.xsl
3914 Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
3915 and Keith Fahlgren of O'Reilly.
3917 This change includes new code for generating the XHTML 1.1 target sanely.
3919 • Mauritz Jeanson: biblio.xsl
3921 Added code for creating URLs from biblioids with @class="doi" (representing Digital
3922 Object Identifiers). See FR #1934434 and http://doi.org.
3924 To do: 1) Add support for FO output. 2) Figure out how @class="doi" should be handled
3925 for bibliorelation, bibliosource and citebiblioid.
3927 • Norman Walsh: formal.xsl
3929 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.
3931 • Michael(tm) Smith: Makefile
3933 Added checks and hacks to various makefiles to enable building
3934 under Cygwin. This stuff is ugly and maybe not worth the mess and
3935 trouble, but does seem to work as expected and not break anything
3938 • Michael(tm) Smith: docbook.xsl
3940 added "exslt" namespace binding to html/docbook.xsl file (in
3941 addition to existing "exsl" binding. reason is because lack of it
3942 seems to cause processing problems when using the profiled
3943 version of the stylsheet
3945 • Norman Walsh: chunk-common.xsl
3949 • Mauritz Jeanson: table.xsl
3951 Added a fix to make rowsep apply to the last row of thead in entrytbl.
3953 • Michael(tm) Smith: synop.xsl
3955 Simplified and streamlined handling of output for ANSI-style
3956 funcprototype output, to correct a problem that was causing type
3957 data to be lost in the output parameter definitions. For example,
3958 for an instance like this:
3959 <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
3960 ... the brackets (indicating an array type) were being dropped.
3962 • Michael(tm) Smith: synop.xsl
3964 Changed HTML handling of K&R-style paramdef output. The parameter
3965 definitions are no longer output in a table (though the prototype
3966 still is). The reason for the change is that the
3967 kr-tabular-funcsynopsis-mode template was causing type data to be
3968 lost in the output parameter definitions. For example, for an
3970 <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
3971 ... the brackets (indicating an array type) were being dropped.
3972 The easiest way to deal with the problem is to not try to chop up
3973 the parameter definitions and display them in table format, but to
3974 instead just output them as-is. May not look quite as pretty, but
3975 at least we can be sure no information is being lost...
3977 • Michael(tm) Smith: pi.xsl
3979 updated wording of doc for funcsynopsis-style PI
3981 • Michael(tm) Smith: param.xweb; param.ent; synop.xsl
3983 Removed the funcsynopsis.tabular.threshold param. It's no longer
3984 being used in the code and hasn't been since mid 2006.
3986 • Mauritz Jeanson: graphics.xsl
3988 Added support for the img.src.path parameter for SVG graphics. Closes bug #1888169.
3990 • Mauritz Jeanson: chunk-common.xsl
3992 Added missing space.
3994 • Norman Walsh: component.xsl
3996 Fix bug where component titles inside info elements were not handled properly
3998 • Michael(tm) Smith: pi.xsl
4000 Moved dbhtml_stop-chunking embedded doc into alphabetical order,
4001 fixed text of TCG section it see-also'ed.
4003 • David Cramer: pi.xsl
4005 Added support for <?dbhtml stop-chunking?> processing instruction
4007 • David Cramer: chunk-common.xsl; pi.xsl
4009 Added support for <?dbhtml stop-chunking?> processing instruction
4011 • David Cramer: glossary.xsl
4013 Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry. Also added normalize-space to avoid missorting due to stray leading spaces.
4015 • Mauritz Jeanson: inline.xsl
4017 Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,
4018 and the "hot text" is the biblioid itself enclosed in brackets.
4020 • Mauritz Jeanson: inline.xsl
4022 Added support for @xlink:show in the simple.xlink template. The "new" and "replace"
4023 values are supported (corresponding to values of "_blank" and "_top" for the
4024 ulink.target parameter). I have assumed that @xlink:show should override ulink.target
4025 for external URI links. This closes bugs #1762023 and #1727498.
4027 • Mauritz Jeanson: inline.xsl
4029 Moved declaration of comment.block.parents entity to common/entities.ent.
4031 • Mauritz Jeanson: param.xweb
4033 Added link to profiling chapter of TCG.
4035 • Dongsheng Song: biblio-iso690.xsl
4037 Change encoding from "windows-1250" to "UTF-8".
4039 • Robert Stayton: biblio.xsl
4041 Add support in biblio collection to entries in bibliodivs.
4043 • Mauritz Jeanson: pi.xsl
4045 Added missing @role="tcg".
4047 • Mauritz Jeanson: chunk-common.xsl; titlepage.xsl
4049 Refactored legalnotice/revhistory chunking, so that the use.id.as.filename
4050 parameter as well as the dbhtml_filename PI are taken into account. A new named
4051 template in titlepage.xsl is used to compute the filename.
4053 • Mauritz Jeanson: chunk-common.xsl; titlepage.xsl
4055 An update to the fix for bug #1790495 (r7433):
4056 The "ln-" prefix is output only when the legalnotice doesn't have an
4057 @id/@xml:id, in which case the stylesheets generate an ID value,
4058 resulting in a filename like "ln-7e0fwgj.html". This is useful because
4059 without the prefix, you wouldn't know that the file contained a legalnotice.
4060 The same logic is also applied to revhistory, using an "rh-" prefix.
4062 • Mauritz Jeanson: autoidx.xsl
4064 Removed the [&scope;] predicate from the target variable in the template with name="reference".
4065 This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
4066 with index.on.type=1. Closes bug #1680836.
4068 • Mauritz Jeanson: titlepage.xsl
4070 Added 'ln-' prefix to the name of the legalnotice chunk, in order to match the
4071 <link href"..."> that is output by make.legalnotice.head.links (chunk-common.xsl).
4072 Modified the href attribute on the legalnotice link.
4073 Closes bug #1790495.
4077 The following changes have been made to the manpages code since the 1.73.2
4080 • Michael(tm) Smith: other.xsl
4082 slightly adjusted spacing around admonition markers
4084 • Michael(tm) Smith: refentry.xsl; utility.xsl
4086 make sure refsect3 titles are preceded by a line of space, and
4087 make the indenting of their child content less severe
4089 • Michael(tm) Smith: block.xsl
4091 only indent verbatim environments in TTY output, not in non-TTY/PS
4093 • Michael(tm) Smith: block.xsl
4095 made another adjustment to correct vertical alignment of admonition marker
4097 • Michael(tm) Smith: block.xsl; other.xsl
4099 Adjusted/corrected alignment of adominition marker in PS/non-TTY output.
4101 • Michael(tm) Smith: endnotes.xsl
4103 For PS/non-TTY output, display footnote/endnote numbers in
4106 • Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl
4108 Changed handling of hanging indents for cmdsynopsis, funcsynopsis,
4109 and synopfragment such that they now look correct in non-TTY/PS
4110 output. We now use the groff \w escape to hang by the actual width
4111 -- in the current font -- of the command, funcdef, or
4112 synopfragment references number (as opposed to hanging by the
4113 number of characters). This rendering in TTY output remains the
4114 same, since the width in monospaced TTY output is the same as the
4115 number of characters.
4117 Also, created new synopsis-block-start and synopsis-block-end
4118 templates to use for cmdsynopsis and funcsynopsis instead of the
4119 corresponding verbatim-* templates.
4121 Along with those changes, also corrected a problem that caused the
4122 content of synopfragment to be dropped, and made a
4123 vertical-spacing change to adjust spacing around table titles and
4124 among sibling synopfragment instances.
4126 • Michael(tm) Smith: other.xsl
4128 use common l10.language.name template to retrieve English-language name
4130 • Michael(tm) Smith: synop.xsl; inline.xsl
4132 added comment in code explaining why we don't put filename output
4133 in italic (despite the fact that man guidelines say we should)
4135 • Michael(tm) Smith: inline.xsl
4137 put filename output in monospace instead of italic
4139 • Michael(tm) Smith: synop.xsl
4141 put cmdsynopsis in monospace
4143 • Michael(tm) Smith: inline.xsl
4145 removed template match for literal. template matches for monospace
4146 inlines are all imported from the HTML stylesheet
4148 • Michael(tm) Smith: block.xsl
4150 don't indent verbatim environments that are descendants of
4151 refsynopsisdiv, not put backgrounds behind them
4153 • Michael(tm) Smith: inline.xsl
4155 set output of the literal element in monospace. this causes all
4156 inline monospace instances in the git man pages to be set in
4157 monospace (since DocBook XML source for git docs is generated with
4158 asciidoc and asciidoc consistently outputs only <literal> for
4159 inline monospace (not <command> or <code> or anything else).
4160 Of course this only affects non-TTY output...
4162 • Michael(tm) Smith: utility.xsl
4164 Added inline.monoseq named template.
4166 • Michael(tm) Smith: utility.xsl
4168 don't bother using a custom register to store the previous
4169 font-family value when setting blocks of text in code font; just
4170 use \F[] .fam with no arg to switch back
4172 • Michael(tm) Smith: endnotes.xsl
4174 put links in blue in PS output (note that this matches how groff
4175 renders content marked up with the .URL macro)
4177 • Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent
4179 removed man.links.are.underlined and added man.font.links. Also,
4180 changed the default font formatting for links to bold.
4182 • Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent
4184 Added new param man.base.url.for.relative.links .. specifies a
4185 base URL for relative links (for ulink, @xlink:href, imagedata,
4186 audiodata, videodata) shown in the generated NOTES section of
4187 man-page output. The value of man.base.url.for.relative.links is
4188 prepended to any relative URI that is a value of ulink url,
4189 xlink:href, or fileref attribute.
4191 If you use relative URIs in link sources in your DocBook refentry
4192 source, and you leave man.base.url.for.relative.links unset, the
4193 relative links will appear "as is" in the NOTES section of any
4194 man-page output generated from your source. That's probably not
4195 what you want, because such relative links are only usable in the
4196 context of HTML output. So, to make the links meaningful and
4197 usable in the context of man-page output, set a value for
4198 man.base.url.for.relative.links that points
4199 to the online version of HTML output generated from your DocBook
4200 refentry source. For example:
4202 <xsl:param name="man.base.url.for.relative.links"
4203 >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param>
4205 • Michael(tm) Smith: info.xsl
4207 If a source refentry contains a Documentation or DOCUMENTATION
4208 section, don't report it as having missing AUTHOR information.
4209 Also, if missing a contrib/personblurb for a person or org, report
4210 pointers to http://docbook.sf.net/el/personblurb and to
4211 http://docbook.sf.net/el/contrib
4213 • Michael(tm) Smith: info.xsl
4215 If we encounter an author|editor|othercredit instance that lacks a
4216 personblurb or contrib, report it to the user (because that means
4217 we have no information about that author|editor|othercredit to
4218 display in the generated AUTHOR|AUTHORS section...)
4220 • Michael(tm) Smith: info.xsl; docbook.xsl; other.xsl
4222 if we can't find any usable author data, emit a warning and insert
4223 a fixme in the output
4225 • Michael(tm) Smith: info.xsl
4227 fixed bug in indenting of output for contrib instances in AUTHORS
4228 section. Thanks to Daniel Leidert and the fglrx docs for exposing
4231 • Michael(tm) Smith: block.xsl
4233 for a para or simpara that is the first child of a callout,
4234 suppress the .sp or .PP that would normally be output (because in
4235 those cases, the output goes into a table cell, and the .sp or .PP
4236 markup causes a spurious linebreak before it when displayed
4238 • Michael(tm) Smith: lists.xsl
4240 Added support for rendering co callouts and calloutlist instances.
4241 So you can now use simple callouts -- marking up programlisting
4242 and such with co instances -- and have the callouts displayed in
4243 man-page output. ("simple callouts" means using co@id and
4244 callout@arearefs pointing to co@id instances; in man/roff output,
4245 we can't/don't support markup that uses areaset and area)
4247 • Michael(tm) Smith: block.xsl
4249 only put a line of space after a verbatim if it's followed by a
4250 text node or a paragraph
4252 • Michael(tm) Smith: utility.xsl
4254 put verbatim environments in slightly smaller font in non-TTY
4257 • Michael(tm) Smith: lists.xsl
4259 minor whitespace-only reformatting of lists.xsl source
4261 • Michael(tm) Smith: lists.xsl
4263 Made refinements/fixes to output of orderedlist and itemizedlist
4264 -- in part, to get mysql man pages to display correctly. This
4265 change causes a "\c" continuation marker to be added between
4266 listitem markers and contents (to ensure that the content remains
4267 on the same line as the marker when displayed)
4269 • Michael(tm) Smith: block.xsl
4271 put a line of vertical space after all verbatim output that has
4272 sibling content following it (not just if that sibling content is
4275 • Michael(tm) Smith: block.xsl
4277 refined spacing around titles for admonitions
4279 • Michael(tm) Smith: block.xsl; other.xsl
4281 Deal with case of verbatim environments that have a linebreak
4282 after the opening tag. Assumption is that users generally don't
4283 want that linebreak to appear in output, so we do some groff
4284 hackery to mess with vertical spacing and close the space.
4286 • Michael(tm) Smith: inline.xsl
4288 indexterm instances now produce groff comments like this:
4290 .\" primary: secondary: tertiary
4292 remark instances, if non-empty, now produce groff comments
4294 • Michael(tm) Smith: charmap.groff.xsl; other.xsl
4296 convert no-break space character to groff "\ \&" (instead of just
4297 "\ "). the reason is that if a space occurs at the end of a line,
4298 our processing causes it to be eaten. a real-world case of this is
4299 the mysql(1) man page. appending the "\&" prevents that
4301 • Michael(tm) Smith: block.xsl
4303 output "sp" before simpara output, not after it (outputting it
4304 after results in undesirable whitespace in particular cases; for
4305 example, in the hg/mercurial docs
4307 • Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl
4309 renamed from title-preamble to pinch.together and replaced "sp -1"
4310 between synopsis fragments with call to pinch.together instead
4312 • Michael(tm) Smith: table.xsl
4314 use title-preamble template for table titles (instead of "sp -1"
4315 hack), and "sp 1" after all tables (instead of just "sp"
4317 • Michael(tm) Smith: utility.xsl
4319 created title-preamble template for suppressing line spacing after
4322 • Michael(tm) Smith: info.xsl
4324 further refinement of indenting in AUTHORS section
4326 • Michael(tm) Smith: block.xsl; other.xsl
4328 refined handling of admonitions
4330 • Michael(tm) Smith: lists.xsl
4332 Use RS/RE in another place where we had IP ""
4334 • Michael(tm) Smith: info.xsl
4336 Replace (ab)use of IP with "sp -1" in AUTHORS section with RS/RE
4339 • Michael(tm) Smith: table.xsl; synop.xsl; info.xsl
4341 changed all instances of ".sp -1n" to ".sp -1"
4343 • Michael(tm) Smith: other.xsl
4345 add extra line before SH heads only in non-TTY output
4347 • Michael(tm) Smith: block.xsl
4349 Reworked output for admonitions (caution, important, note, tip,
4350 warning). In TTY output, admonitions now get indented. In non-TTY
4351 output, a colored marker (yellow) is displayed next to them.
4353 • Michael(tm) Smith: other.xsl
4355 Added BM/EM macros for putting a colored marker in margin next to
4358 • Michael(tm) Smith: utility.xsl
4360 created make.bold.title template by moving title-bolding part out
4361 from nested-section-title template. This allows the bolding to
4362 also be used by the template for formatting admonitions
4364 • Michael(tm) Smith: info.xsl
4366 put .br before copyright contents to prevent them from getting run in
4368 • Michael(tm) Smith: refentry.xsl; other.xsl; utility.xsl
4370 made point size of output for Refsect2 and Refsect3 heads bigger
4372 • Michael(tm) Smith: other.xsl
4374 put slightly more space between SH head and underline in non-TTY
4377 • Michael(tm) Smith: param.xweb; param.ent; other.xsl
4379 Added the man.charmap.subset.profile.english parameter and refined
4380 the handling of charmap subsets to differentiate between English
4381 and non-English source.
4383 This way charmap subsets are now handled is this:
4385 If the value of the man.charmap.use.subset parameter is non-zero,
4386 and your DocBook source is not written in English (that is, if its
4387 lang or xml:lang attribute has a value other than en), then the
4388 character-map subset specified by the man.charmap.subset.profile
4389 parameter is used instead of the full roff character map.
4391 Otherwise, if the lang or xml:lang attribute on the root element
4392 in your DocBook source or on the first refentry element in your
4393 source has the value en or if it has no lang or xml:lang
4394 attribute, then the character-map subset specified by the
4395 man.charmap.subset.profile.english parameter is used instead of
4396 man.charmap.subset.profile.
4398 The difference between the two subsets is that
4399 man.charmap.subset.profile provides mappings for characters in
4400 Western European languages that are not part of the Roman
4401 (English) alphabet (ASCII character set).
4403 • Michael(tm) Smith: other.xsl
4405 Various updates, mainly related to uppercasing SH titles:
4407 - added a "Language: " metadata line to the top comment area of
4408 output man pages, to indicate the language the page is in
4410 - added a "toupper" macro of doing locale-aware uppercasing of
4411 SH titles and cross-references to SH titles; the mechanism
4412 relies on the uppercase.alpha and lowercase.alpha DocBook
4413 gentext keys to do locale-aware uppercasing based on the
4414 language the page is written in
4416 - added a "string.shuffle" template, which provides a library
4417 function for "shuffling" two strings together into a single
4418 string; it takes the first character for the first string, the
4419 first character from second string, etc. The only current use
4420 for it is to generate the argument for the groff tr request
4421 that does string uppercasing.
4423 - added make.tr.uppercase.arg and make.tr.normalcase.arg named
4424 templates for use in generating groff code for uppercasing and
4425 "normal"-casing SH titles
4427 - made the BB/BE "background drawing" macros have effect only in
4430 - output a few comments in the top part of source
4432 • Michael(tm) Smith: utility.xsl
4434 removed some leftover kruft
4436 • Michael(tm) Smith: refentry.xsl
4438 To create the name(s) for each man page, we now replace any spaces
4439 in the refname(s) with underscores. This ensures that tools like
4440 lexgrog(1) will be able to parse the name (lexgrog won't parse
4441 names that contain spaces).
4443 • Michael(tm) Smith: docbook.xsl
4445 Put a comment into source of man page to indicate where the main
4446 content starts. (We now have a few of macro definitions at the
4447 start of the source, so putting this comment in helps those that
4448 might be viewing the source.)
4450 • Michael(tm) Smith: refentry.xsl
4452 refined mechanism for generating SH titles
4454 • Michael(tm) Smith: charmap.groff.xsl
4456 Added zcaron, Zcaron, scaron, and Scaron to the groff character map.
4457 This means that generated Finnish man pages will no longer contain
4458 any raw accented characters -- they'll instead by marked up with
4461 • Michael(tm) Smith: other.xsl; utility.xsl
4463 corrected a regression I introduced about a year ago that caused
4464 dots to be output just as "\." -- instead needs to be "\&." (which
4465 is what it will be now, after this change)
4467 • Michael(tm) Smith: refentry.xsl
4469 Changed backend handling for generating titles for SH sections and
4470 for cross-references to those sections. This should have no effect
4471 on TTY output (behavior should remain the same hopefully) but
4472 results in titles in normal case (instead of uppercase) in PS
4475 • Michael(tm) Smith: info.xsl
4477 use make.subheading template to make subheadings for AUTHORS and
4478 COPYRIGHT sections (instead of harcoding roff markup)
4480 • Michael(tm) Smith: block.xsl
4482 put code font around programlisting etc.
4484 • Michael(tm) Smith: synop.xsl; docbook.xsl
4486 embed custom macro definitions in man pages, plus wrap synopsis in
4489 • Michael(tm) Smith: endnotes.xsl
4491 use the make.subheading template to generated SH subheading for
4494 • Michael(tm) Smith: lists.xsl
4496 Added some templates for generating if-then-else conditional
4497 markup in groff, so let's use those instead of hard-coding it in
4500 • Michael(tm) Smith: other.xsl; utility.xsl
4502 Initial checkin of some changes related to making PS/PDF output
4503 from "man -l -Tps" look better. The current changes:
4505 - render synopsis and verbatim sections in a monospace/code font
4507 - put a light-grey background behind all programlisting, screen,
4508 and literallayout instances
4510 - prevent SH heads in PS output from being rendered in uppercase
4511 (as they are in console output)
4513 - also display xrefs to SH heads in PS output in normal case
4514 (instead of uppercase)
4516 - draw a line under SH heads in PS output
4518 The changes made to the code to support the above features were:
4520 - added some embedded/custom macros: one for conditionally
4521 upper-casing SH x-refs, one for redefining the SH macro
4522 itself, with some conditional handling for PS output, and
4523 finally a macro for putting a background/screen (filled box)
4524 around a block of text (e.g., a program listing) in PS output
4526 - added utility templates for wrapping blocks of text in code
4527 font; also templates for inline code font
4529 • Robert Stayton: refentry.xsl
4531 refpurpose nodes now get apply-templates instead of just normalize-space().
4533 • Michael(tm) Smith: lists.xsl
4535 Fixed alignment of first lined of text for each listitem in
4536 orderedlist output for TTY. Existing code seemed to have been
4537 causing an extra undesirable space to appear.
4539 • Michael(tm) Smith: lists.xsl
4541 Wrapped some roff conditionals around roff markup for orderedlist
4542 and itemizedlist output, so that the lists look acceptable in PS
4543 output as well as TTY.
4545 • Michael(tm) Smith: pi.xsl; synop.xsl; param.xweb; param.ent
4547 Added the man.funcsynopsis.style parameter. Has the same effect in
4548 manpages output as the funcsynopsis.style parameter has in HTML
4549 output -- except that its default value is 'ansi' instead of 'kr'.
4551 • Michael(tm) Smith: synop.xsl
4553 Reworked handling of K&R funcprototype output. It no longer relies
4554 on the HTML kr-tabular templates, but instead just does direct
4555 transformation to roff. For K&R output, it displays the paramdef
4556 output in an indented list following the prototype.
4558 • Michael(tm) Smith: synop.xsl
4560 Properly integrated handling for K&R output into manpages
4561 stylesheet. The choice between K&R output and ANSI output is
4562 currently controlled through use of the (HTML) funcsynopsis.style
4563 parameter. Note that because the mechanism does currently rely on
4564 funcsynopsis.style, the default in manpages output is now K&R
4565 (because that's the default of that param). But I suppose I ought
4566 to create a man.funcsynopsis.style and make the default for that
4567 ANSI (to preserve the existing default behavior).
4569 • Michael(tm) Smith: docbook.xsl
4571 added manpages/pi.xsl file
4573 • Michael(tm) Smith: .cvsignore; pi.xsl
4575 Added "dbman funcsynopsis-style" PI and incorporated it into the
4578 • Michael(tm) Smith: refentry.xsl
4580 Fixed regression that caused an unescaped dash to be output
4581 between refname and refpurpose content. Closes bug #1894244.
4582 Thanks to Daniel Leidert.
4584 • Michael(tm) Smith: other.xsl
4586 Fixed problem with dots being escaped in filenames of generated
4587 man files. Closes #1827195. Thanks to Daniel Leidert.
4589 • Michael(tm) Smith: inline.xsl
4591 Added support for processing structfield (was appearing in roff
4592 output surrounded by HTML <em> tags; fixed so that it gets roff
4593 ital markup). Closes bug #1858329. Thanks to Sam Varshavchik.
4597 The following changes have been made to the epub code since the 1.73.2 release.
4599 • Keith Fahlgren: bin/spec/README; bin/spec/epub_realbook_spec.rb
4601 'Realbook' spec now passes
4603 • Keith Fahlgren: bin/dbtoepub; README; bin/spec/README; bin/lib/docbook.rb;
4606 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)
4608 • Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/
4611 Changes to OPF spine to not duplicate idrefs for documents with parts not at the root; regression specs for same
4613 • Keith Fahlgren: docbook.xsl
4615 Fixing linking to cover @id, distinct from other needs of cover-image-id (again, thanks to Martin Goerner)
4617 • Keith Fahlgren: docbook.xsl
4619 Updating the title of the toc element in the guide to be more explicit (thanks to Martin Goerner)
4621 • Keith Fahlgren: bin/spec/examples/amasque_exploded/content.opf; bin/spec/
4624 Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
4625 and Keith Fahlgren of O'Reilly.
4627 • Keith Fahlgren: docbook.xsl
4629 == General epub test support
4631 $ spec -O ~/.spec.opts spec/epub_spec.rb
4634 - should be able to be created
4635 - should fail on a nonexistent file
4636 - should be able to render to a file
4637 - should create a file after rendering
4638 - should have the correct mimetype after rendering
4639 - should be valid .epub after rendering an article
4640 - should be valid .epub after rendering an article without sections
4641 - should be valid .epub after rendering a book
4642 - should be valid .epub after rendering a book even if it has one graphic
4643 - should be valid .epub after rendering a book even if it has many graphics
4644 - should be valid .epub after rendering a book even if it has many duplicated graphics
4645 - should report an empty file as invalid
4646 - should confirm that a valid .epub file is valid
4647 - should not include PDFs in rendered epub files as valid image inclusions
4648 - should include a TOC link in rendered epub files for <book>s
4650 Finished in 20.608395 seconds
4652 15 examples, 0 failures
4655 == Verbose epub test coverage against _all_ of the testdocs
4657 Fails on only (errors truncated):
4659 '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
4660 '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
4663 Finished in 629.89194 seconds
4665 224 examples, 15 failures
4667 224 examples, 15 failures yields 6% failure rate
4671 The following changes have been made to the htmlhelp code since the 1.73.2
4674 • Mauritz Jeanson: htmlhelp-common.xsl
4676 Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
4677 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
4678 This makes chunk.quietly=1 suppress chunk filename messages also for help
4679 support files (which seems to be what one would expect). See bug #1648360.
4683 The following changes have been made to the eclipse code since the 1.73.2
4686 • David Cramer: eclipse.xsl
4688 Use sortas attributes (if they exist) when sorting indexterms
4690 • David Cramer: eclipse.xsl
4692 Added support for indexterm/see in eclipse index.xml
4694 • Mauritz Jeanson: eclipse.xsl
4696 Added <xsl:with-param name="quiet" select="$chunk.quietly"/>
4697 to helpidx template.
4699 • David Cramer: eclipse.xsl
4701 Generate index.xml file and add related goo to plugin.xml file. Does not yet support see and seealso.
4703 • Mauritz Jeanson: eclipse.xsl
4705 Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
4706 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
4707 This makes chunk.quietly=1 suppress chunk filename messages also for help
4708 support files (which seems to be what one would expect). See bug #1648360.
4712 The following changes have been made to the javahelp code since the 1.73.2
4715 • Mauritz Jeanson: javahelp.xsl
4717 Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
4718 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
4719 This makes chunk.quietly=1 suppress chunk filename messages also for help
4720 support files (which seems to be what one would expect). See bug #1648360.
4724 The following changes have been made to the roundtrip code since the 1.73.2
4727 • Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl
4729 fix table/cell borders for wordml, fix formal figure, add emphasis-strong
4731 • Mauritz Jeanson: supported.xml
4735 • Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml
4737 added pubdate, fixed metadata handling in biblioentry
4739 • Steve Ball: supported.xml
4741 Added support for edition.
4743 • Steve Ball: docbook-pages.xsl; wordml-blocks.xsl; docbook.xsl; wordml.xsl;
4746 Removed stylesheets for old, deprecated conversion method.
4748 • Steve Ball: specifications.xml; dbk2ooo.xsl; blocks2dbk.xsl; dbk2pages.xsl;
4751 Added support for Open Office, added edition element, improved list and table support in Word and Pages
4753 • Steve Ball: normalise-common.xsl; blocks2dbk.xsl; dbk2pages.xsl;
4754 template-pages.xml; templ⋯
4756 Fixed bug in WordML table handling, improved table handling for Pages 08, synchronised WordML and Pages templates.
4758 • Steve Ball: normalise-common.xsl; blocks2dbk.xsl; wordml2normalise.xsl;
4761 fix caption, attributes
4763 • Steve Ball: specifications.xml; blocks2dbk.xsl; wordml2normalise.xsl;
4764 blocks2dbk.dtd; temp⋯
4766 Fixes to table and list handling
4768 • Steve Ball: blocks2dbk.xsl
4770 added support for explicit emphasis character styles
4772 • Steve Ball: wordml2normalise.xsl
4774 added support for customisation in image handling
4776 • Steve Ball: blocks2dbk.xsl
4778 Added inlinemediaobject support for metadata.
4780 • Steve Ball: normalise-common.xsl; blocks2dbk.xsl; template.xml;
4781 dbk2wordml.xsl; dbk2wp.xsl
4783 Added support file. Added style locking. Conversion bug fixes.
4787 The following changes have been made to the slides code since the 1.73.2
4790 • Michael(tm) Smith: fo/Makefile; html/Makefile
4792 Added checks and hacks to various makefiles to enable building
4793 under Cygwin. This stuff is ugly and maybe not worth the mess and
4794 trouble, but does seem to work as expected and not break anything
4797 • Jirka Kosek: html/plain.xsl
4799 Added support for showing foil number
4803 The following changes have been made to the website code since the 1.73.2
4806 • Michael(tm) Smith: extensions/saxon64/.classes/.gitignore; extensions/
4807 xalan2/.classes/com/⋯
4809 renamed a bunch more .cvsignore files to .gitignore (to facilitate use of git-svn)
4813 The following changes have been made to the params code since the 1.73.2
4816 • Keith Fahlgren: epub.autolabel.xml
4818 New parameter for epub, epub.autolabel
4820 • Mauritz Jeanson: table.frame.border.color.xml; table.cell.padding.xml;
4821 table.cell.border.t⋯
4823 Added missing refpurposes and descriptions.
4825 • Keith Fahlgren: ade.extensions.xml
4827 Extensions to support Adobe Digital Editions extensions in .epub output.
4829 • Mauritz Jeanson: fop.extensions.xml; fop1.extensions.xml
4831 Clarified that fop1.extensions is for FOP 0.90 and later. Version 1 is not here yet...
4833 • Michael(tm) Smith: man.links.are.underlined.xml;
4834 man.endnotes.list.enabled.xml; man.font.l⋯
4836 removed man.links.are.underlined and added man.font.links. Also,
4837 changed the default font formatting for links to bold.
4839 • Michael(tm) Smith: man.base.url.for.relative.links.xml
4841 Added new param man.base.url.for.relative.links .. specifies a
4842 base URL for relative links (for ulink, @xlink:href, imagedata,
4843 audiodata, videodata) shown in the generated NOTES section of
4844 man-page output. The value of man.base.url.for.relative.links is
4845 prepended to any relative URI that is a value of ulink url,
4846 xlink:href, or fileref attribute.
4848 If you use relative URIs in link sources in your DocBook refentry
4849 source, and you leave man.base.url.for.relative.links unset, the
4850 relative links will appear "as is" in the NOTES section of any
4851 man-page output generated from your source. That's probably not
4852 what you want, because such relative links are only usable in the
4853 context of HTML output. So, to make the links meaningful and
4854 usable in the context of man-page output, set a value for
4855 man.base.url.for.relative.links that points
4856 to the online version of HTML output generated from your DocBook
4857 refentry source. For example:
4859 <xsl:param name="man.base.url.for.relative.links"
4860 >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param>
4862 • Michael(tm) Smith: man.string.subst.map.xml
4864 squeeze .sp\n.sp into a single .sp (to prevent a extra, spurious
4865 line of whitespace from being inserted after programlisting etc.
4868 • Michael(tm) Smith: refentry.manual.fallback.profile.xml;
4869 refentry.source.fallback.profile.⋯
4871 don't use refmiscinfo@class=date value as fallback for refentry
4872 "source" or "manual" metadata fields
4874 • Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml;
4877 made some further doc tweaks related to the
4878 man.charmap.subset.profile.english param
4880 • Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml;
4883 Added the man.charmap.subset.profile.english parameter and refined
4884 the handling of charmap subsets to differentiate between English
4885 and non-English source.
4887 This way charmap subsets are now handled is this:
4889 If the value of the man.charmap.use.subset parameter is non-zero,
4890 and your DocBook source is not written in English (that is, if its
4891 lang or xml:lang attribute has a value other than en), then the
4892 character-map subset specified by the man.charmap.subset.profile
4893 parameter is used instead of the full roff character map.
4895 Otherwise, if the lang or xml:lang attribute on the root element
4896 in your DocBook source or on the first refentry element in your
4897 source has the value en or if it has no lang or xml:lang
4898 attribute, then the character-map subset specified by the
4899 man.charmap.subset.profile.english parameter is used instead of
4900 man.charmap.subset.profile.
4902 The difference between the two subsets is that
4903 man.charmap.subset.profile provides mappings for characters in
4904 Western European languages that are not part of the Roman
4905 (English) alphabet (ASCII character set).
4907 • Michael(tm) Smith: man.charmap.subset.profile.xml
4909 Added to default charmap used by manpages:
4911 - the "letters" part of the 'C1 Controls And Latin-1 Supplement
4912 (Latin-1 Supplement)' Unicode block
4913 - Latin Extended-A block (but not all of the characters from
4914 that block have mappings in groff, so some of them are still
4915 passed through as-is)
4917 The effects of this change are that in man pages generated for
4918 most Western European languages and for Finnish, all characters
4919 not part of the Roman alphabet are (e.g., "accented" characters)
4920 are converted to groff escapes.
4922 Previously, by default we passed through those characters as is
4923 (and users needed to use the full charmap if they wanted to have
4924 those characters converted).
4926 As a result of this change, man pages generated for Western
4927 European languages will be viewable in some environments in which
4928 they are not viewable if the "raw" non-Roman characters are in them.
4930 • Mauritz Jeanson: generate.legalnotice.link.xml;
4931 generate.revhistory.link.xml
4933 Added information on how the filename is computed.
4935 • Mauritz Jeanson: default.table.width.xml
4939 • Michael(tm) Smith: man.funcsynopsis.style.xml
4941 Added the man.funcsynopsis.style parameter. Has the same effect in
4942 manpages output as the funcsynopsis.style parameter has in HTML
4943 output -- except that its default value is 'ansi' instead of 'kr'.
4945 • Michael(tm) Smith: funcsynopsis.tabular.threshold.xml
4947 Removed the funcsynopsis.tabular.threshold param. It's no longer
4948 being used in the code and hasn't been since mid 2006.
4950 • Mauritz Jeanson: table.properties.xml
4952 Set keep-together.within-column to "auto". This seems to be the most sensible
4953 default value for tables.
4955 • Mauritz Jeanson: informal.object.properties.xml;
4956 admon.graphics.extension.xml; informalequ⋯
4958 Several small documentation fixes.
4960 • Mauritz Jeanson: manifest.in.base.dir.xml
4964 • Mauritz Jeanson: header.content.properties.xml;
4965 footer.content.properties.xml
4969 • Mauritz Jeanson: ulink.footnotes.xml; ulink.show.xml
4971 Updated for DocBook 5.
4973 • Mauritz Jeanson: index.method.xml; glossterm.auto.link.xml
4975 Spelling and wording fixes.
4977 • Mauritz Jeanson: callout.graphics.extension.xml
4979 Clarifed available graphics formats and extensions.
4981 • Mauritz Jeanson: footnote.sep.leader.properties.xml
4983 Corrected refpurpose.
4985 • Jirka Kosek: footnote.properties.xml
4987 Added more properties which make it possible to render correctly footnotes placed inside verbatim elements.
4989 • Mauritz Jeanson: img.src.path.xml
4991 img.src.path works with inlinegraphic too.
4993 • Mauritz Jeanson: saxon.character.representation.xml
4997 • Mauritz Jeanson: img.src.path.xml
4999 Updated description of img.src.path. Bug #1785224 revealed that
5000 there was a risk of misunderstanding how it works.
5004 The following changes have been made to the profiling code since the 1.73.2
5007 • Jirka Kosek: xsl2profile.xsl
5009 Added new rules to profile all content generated by HTML Help (including alias files)
5011 • Robert Stayton: profile-mode.xsl
5013 use mode="profile" instead of xsl:copy-of for attributes so
5014 they can be more easily customized.
5018 The following changes have been made to the tools code since the 1.73.2
5021 • Michael(tm) Smith: make/Makefile.DocBook
5023 various changes and additions to support making with asciidoc as
5026 • Michael(tm) Smith: make/Makefile.DocBook
5028 make dblatex the default PDF maker for the example makefile
5030 • Michael(tm) Smith: xsl/build/html2roff.xsl
5032 Reworked handling of K&R funcprototype output. It no longer relies
5033 on the HTML kr-tabular templates, but instead just does direct
5034 transformation to roff. For K&R output, it displays the paramdef
5035 output in an indented list following the prototype.
5037 • Mauritz Jeanson: xsl/build/make-xsl-params.xsl
5039 Made attribute-sets members of the param list. This enables links to attribute-sets in the
5040 reference documentation.
5042 • Michael(tm) Smith: xsl/build/html2roff.xsl
5044 use .BI handling in K&R funsynopsis output for manpages, just as
5045 we do already of ANSI output
5047 • Michael(tm) Smith: xsl/build/html2roff.xsl
5049 Implemented initial support for handling tabular K&R output of
5050 funcprototype in manpages output. Accomplished by adding more
5051 templates to the intermediate HTML-to-roff stylesheet that the
5052 build uses to create the manpages/html-synop.xsl stylesheet.
5054 • Michael(tm) Smith: xsl/build/doc-link-docbook.xsl
5056 Made the xsl/tools/xsl/build/doc-link-docbook.xsl stylesheet
5057 import profile-docbook.xsl, so that we can do profiling of release
5058 notes. Corrected some problems in the target for the release-notes
5063 The following changes have been made to the extensions code since the 1.73.2
5066 • Keith Fahlgren: Makefile
5068 Use DOCBOOK_SVN variable everywhere, please; build with PDF_MAKER
5070 • Michael(tm) Smith: Makefile
5072 moved extensions build targets from master xsl/Makefile to
5073 xsl/extensions/Makefile
5075 • Michael(tm) Smith: .cvsignore
5077 re-adding empty extensions subdir
5081 The following changes have been made to the xsl-saxon code since the 1.73.2
5084 • Michael(tm) Smith: VERSION
5086 bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
5087 recent change to snapshot build infrastructure
5089 • Michael(tm) Smith: nbproject/build-impl.xml; nbproject/project.properties
5091 Changed hard-coded file references in "clean" target to variable
5092 references. Closes #1792043. Thanks to Daniel Leidert.
5094 • Michael(tm) Smith: VERSION; Makefile
5096 Did post-release wrap-up of xsl-saxon and xsl-xalan dirs
5098 • Michael(tm) Smith: nbproject/build-impl.xml; VERSION; Makefile; test
5100 More tweaks to get release-ready
5104 The following changes have been made to the xsl-xalan code since the 1.73.2
5107 • Michael(tm) Smith: VERSION
5109 bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
5110 recent change to snapshot build infrastructure
5112 • Michael(tm) Smith: nbproject/build-impl.xml
5114 Changed hard-coded file references in "clean" target to variable
5115 references. Closes #1792043. Thanks to Daniel Leidert.
5117 • Michael(tm) Smith: Makefile; VERSION
5119 Did post-release wrap-up of xsl-saxon and xsl-xalan dirs
5121 • Michael(tm) Smith: Makefile; nbproject/build-impl.xml; VERSION
5123 More tweaks to get release-ready
5127 The following changes have been made to the xsl-libxslt code since the 1.73.2
5130 • Mauritz Jeanson: python/xslt.py
5132 Print the result to stdout if no outfile has been given.
5133 Some unnecessary semicolons removed.
5135 • Mauritz Jeanson: python/xslt.py
5137 Added a function that quotes parameter values (to ensure that they are interpreted as strings).
5138 Replaced deprecated functions from the string module with string methods.
5140 • Michael(tm) Smith: python/README; python/README.LIBXSLT
5142 renamed xsl-libxslt/python/README to xsl-libxslt/python/README.LIBXSLT
5144 • Mauritz Jeanson: python/README
5146 Tweaked the text a little.
5148 Release Notes: 1.73.2
5150 This is solely a minor bug-fix update to the 1.73.1 release. It fixes a
5151 packaging error in the 1.73.1 package, as well as a bug in footnote handling in
5156 This is mostly a bug-fix update to the 1.73.0 release.
5160 The following changes have been made to the gentext code since the 1.73.0
5163 • Mauritz Jeanson: locale/de.xml
5165 Applied patch #1766009.
5167 • Michael(tm) Smith: locale/lv.xml
5169 Added localization for ProductionSet.
5173 The following changes have been made to the fo code since the 1.73.0 release.
5175 • Mauritz Jeanson: table.xsl
5177 Modified the tgroup template so that, for tables with multiple tgroups,
5178 a width attribute is output on all corresponding fo:tables. Previously,
5179 there was a test prohibiting this (and a comment saying that outputting more
5180 than one width attribute will cause an error). But this seems to be no longer
5181 relevant; it is not a problem with FOP 0.93 or XEP 4.10. Closes bug #1760559.
5183 • Mauritz Jeanson: graphics.xsl
5185 Replaced useless <a> elements with warning messages (textinsert extension).
5187 • Mauritz Jeanson: admon.xsl
5189 Enabled generation of ids (on fo:wrapper) for indexterms in admonition titles, so that page
5190 references in the index can be created. Closes bug #1775086.
5194 The following changes have been made to the html code since the 1.73.0 release.
5196 • Mauritz Jeanson: titlepage.xsl
5198 Added <xsl:call-template name="process.footnotes"/> to abstract template
5199 so that footnotes in info/abstract are processed. Closes bug #1760907.
5201 • Michael(tm) Smith: pi.xsl; synop.xsl
5203 Changed handling of HTML output for the cmdsynopsis and
5204 funcsynopsis elements, such that a@id instances are generated for
5205 them if they are descendants of any element containing a dbcmdlist
5206 or dbfunclist PI. Also, update the embedded reference docs for the
5207 dbcmdlist and dbfunclist PIs to make it clear that they can be
5208 used within any element for which cmdsynopsis or funcsynopsis are
5211 • Michael(tm) Smith: formal.xsl
5213 Reverted the part of revision 6952 that caused a@id anchors to be
5214 generated for output of informal objects. Thanks to Sam Steingold
5217 • Robert Stayton: glossary.xsl
5219 Account for a glossary with no glossdiv or glossentry children.
5221 • Mauritz Jeanson: titlepage.xsl
5223 Modified legalnotice template so that the base.name parameter is calculated
5224 in the same way as for revhistory chunks. Using <xsl:apply-templates
5225 mode="chunk-filename" select="."/> did not work for single-page output since
5226 the template with that mode is in chunk-code.xsl.
5228 • Mauritz Jeanson: graphics.xsl
5230 Updated support for SVG (must be a child of imagedata in DB 5).
5231 Added support for MathML in imagedata.
5233 • Mauritz Jeanson: pi.xsl
5235 Added documentation for the dbhh PI (used for context-sensitive HTML Help).
5236 (The two templates matching 'dbhh' are still in htmlhelp-common.xsl).
5240 The following changes have been made to the manpages code since the 1.73.0
5243 • Michael(tm) Smith: endnotes.xsl
5245 In manpages output, generate warnings about notesources with
5246 non-para children only if the notesource is a footnote or
5247 annotation. Thanks to Sam Steingold for reporting problems with
5248 the existing handling.
5252 The following changes have been made to the htmlhelp code since the 1.73.0
5255 • Michael(tm) Smith: htmlhelp-common.xsl
5257 Added single-pass namespace-stripping support to the htmlhelp,
5258 eclipse, and javahelp stylesheets.
5262 The following changes have been made to the eclipse code since the 1.73.0
5265 • Michael(tm) Smith: eclipse.xsl
5267 Added single-pass namespace-stripping support to the htmlhelp,
5268 eclipse, and javahelp stylesheets.
5272 The following changes have been made to the javahelp code since the 1.73.0
5275 • Michael(tm) Smith: javahelp.xsl
5277 Added single-pass namespace-stripping support to the htmlhelp,
5278 eclipse, and javahelp stylesheets.
5282 The following changes have been made to the roundtrip code since the 1.73.0
5285 • Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; pages2normalise.xsl
5287 Modularised blocks2dbk to allow customisation,
5288 Added support for tables to pages2normalise
5292 The following changes have been made to the params code since the 1.73.0
5295 • Robert Stayton: procedure.properties.xml
5297 procedure was inheriting keep-together from formal.object.properties, but
5298 a procedure does not need to be kept together by default.
5300 • Dave Pawson: title.font.family.xml;
5301 component.label.includes.part.label.xml; table.frame.b⋯
5303 Regular formatting re-org.
5307 This release includes important bug fixes and adds the following significant
5310 New localizations and localization updates
5312 We added two new localizations: Latvian and Esperanto, and made updates to
5313 the Czech, Chinese Simplified, Mongolian, Serbian, Italian, and Ukrainian
5316 ISO690 citation style for bibliography output.
5318 Set the bibliography.style parameter to iso690 to use ISO690 style.
5320 New documentation for processing instructions (PI)
5322 The reference documentation that ships with the release now includes
5323 documentation on all PIs that you can use to control output from the
5326 New profiling parameters for audience and wordsize
5328 You can now do profiling based on the values of the audience and wordsize
5331 Changes to man-page output
5333 The manpages stylesheet now supports single-pass profiling and single-pass
5334 DocBook 5 namespace stripping (just as the HTML and FO stylesheets also
5335 do). Also, added handling for mediaobject & inlinemediaobject. (Each
5336 imagedata, audiodata, or videodata element within a mediaobject or inline
5337 mediaobject is now treated as a "notesource" and so handled in much the
5338 same way as links and annotation/alt/footnote are in manpages output.) And
5339 added the man.authors.section.enabled and man.copyright.section.enabled
5340 parameters to enable control over whether output includes auto-generated
5341 AUTHORS and COPYRIGHT sections.
5343 Highlighting support for C
5345 The highlighting mechanism for generating syntax-highlighted code snippets
5346 in output now supports C code listings (along with Java, PHP, XSLT, and
5349 Experimental docbook-xsl-update script
5351 We added an experimental docbook-xsl-update script, the purpose of which is
5352 to facilitate easy sync-up to the latest docbook-xsl snapshot (by means of
5357 The following changes have been made to the gentext code since the 1.72.0
5360 • Michael(tm) Smith: locale/lv.xml; Makefile
5362 Added Latvian localization file, from Girts Ziemelis.
5364 • Dongsheng Song: locale/zh_cn.xml
5366 Brought up to date with en.xml in terms of items. A few strings marked for translation.
5368 • Jirka Kosek: locale/cs.xml
5370 Added missing translations
5372 • Robert Stayton: locale/eo.xml
5374 New locale for Esperanto.
5376 • Robert Stayton: locale/mn.xml
5378 Update from Ganbold Tsagaankhuu.
5380 • Jirka Kosek: locale/en.xml; locale/cs.xml
5382 Rules for normalizing glossary entries before they are sorted can be now different for each language.
5384 • Michael(tm) Smith: locale/sr_Latn.xml; locale/sr.xml
5386 Committed changes from Miloš Komarčević to Serbian files.
5388 • Robert Stayton: locale/ja.xml
5390 Fix chapter in context xref-number-and-title
5392 • Robert Stayton: locale/it.xml
5394 Improved version from contributor.
5396 • Mauritz Jeanson: locale/uk.xml
5398 Applied patch 1592083.
5402 The following changes have been made to the common code since the 1.72.0
5405 • Michael(tm) Smith: labels.xsl
5407 Changed handling of reference auto-labeling such that reference
5408 (when it appears at the component level) is now affected by the
5409 label.from.part param, just as preface, chapter, and appendix.
5411 • Michael(tm) Smith: common.xsl
5413 Added support to the HTML stylesheets for proper processing of
5414 orgname as a child of author.
5416 • Michael(tm) Smith: refentry.xsl
5418 Refined logging output of refentry metadata-gathering template;
5419 for some cases of "missing" elements (refmiscinfo stuff, etc.),
5420 the log messages now include URL to corresponding page in the
5421 Definitive Guide (TDG).
5423 • Robert Stayton: titles.xsl
5425 Add refsection/info/title support.
5427 • Michael(tm) Smith: titles.xsl
5429 Added support for correct handling of xref to elements that
5430 contain info/title descendants but no title children.
5432 This should be further refined so that it handles any *info
5433 elements. And there are probably some other places where similar
5434 handling for *info/title should be added.
5436 • Mauritz Jeanson: pi.xsl
5438 Modified <xsl:when> in datetime.format template to work
5443 The following changes have been made to the fo code since the 1.72.0 release.
5445 • Robert Stayton: component.xsl
5447 Add parameters to the page.sequence utility template.
5449 • Mauritz Jeanson: xref.xsl
5451 Added template for xref to area/areaset.
5452 Part of fix for bug #1675513 (xref to area broken).
5454 • Michael(tm) Smith: inline.xsl
5456 Added template match for person element to fo stylesheet.
5458 • Robert Stayton: lists.xsl
5460 Added support for spacing="compact" in variablelist, per bug report #1722540.
5462 • Robert Stayton: table.xsl
5464 table pgwide="1" should also use pgwide.properties attribute-set.
5466 • Mauritz Jeanson: inline.xsl
5468 Make citations numbered if bibliography.numbered != 0.
5470 • Robert Stayton: param.xweb; param.ent
5472 Add new profiling parameters for audience and wordsize.
5474 • Robert Stayton: param.xweb; param.ent
5476 Added callout.icon.size parameter.
5478 • Robert Stayton: inline.xsl; xref.xsl
5480 Add support for xlink as olink.
5482 • Robert Stayton: autotoc.xsl; param.xweb; param.ent
5484 Add support for qanda.in.toc to fo TOC.
5486 • Robert Stayton: component.xsl
5488 Improved the page.sequence utility template for use with book.
5490 • Robert Stayton: division.xsl
5492 Refactored the big book template into smaller pieces.
5493 Used the "page.sequence" utility template in
5494 component.xsl to shorten the toc piece.
5495 Added placeholder templates for front.cover and back.cover.
5497 • Robert Stayton: param.xweb; param.ent; sections.xsl
5499 Add section.container.element parameter to enable
5500 pgwide spans inside sections.
5502 • Robert Stayton: param.xweb; param.ent; component.xsl
5504 Add component.titlepage.properties attribute-set to
5505 support span="all" and other properties.
5507 • Robert Stayton: htmltbl.xsl; table.xsl
5509 Apply table.row.properties template to html tr rows too.
5510 Add keep-with-next to table.row.properties when row is in thead.
5512 • Robert Stayton: table.xsl
5514 Add support for default.table.frame parameter.
5515 Fix bug 1575446 rowsep last check for @morerows.
5517 • Robert Stayton: refentry.xsl
5519 Add support for info/title in refsections.
5521 • David Cramer: qandaset.xsl
5523 Make fo questions and answers behave the same way as html
5525 • Jirka Kosek: lists.xsl
5527 Added missing attribute set for procedure
5529 • Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent;
5532 Added support for formatting biblioentries according to ISO690 citation style.
5533 New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
5534 The code was provided by Jana Dvorakova
5536 • Robert Stayton: param.xweb; param.ent; pagesetup.xsl
5538 Add header.table.properties and footer.table.properties attribute-sets.
5540 • Robert Stayton: inline.xsl
5542 Add fop1.extensions for menuchoice arrow handling exception.
5546 The following changes have been made to the html code since the 1.72.0 release.
5548 • Mauritz Jeanson: param.xweb; param.ent
5550 Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the
5551 regular "parameter machinery".
5553 • Michael(tm) Smith: admon.xsl
5555 Changed handling of titles for note, warning, caution, important,
5556 tip admonitions: We now output and HTML h3 head only if
5557 admon.textlabel is non-zero or if the admonition actually contains
5558 a title; otherwise, we don't output an h3 head at all.
5559 (Previously, we were outputting an empty h3 if the admon.textlabel
5560 was zero and if the admonition had no title.)
5562 • Mauritz Jeanson: xref.xsl
5564 Added template for xref to area/areaset.
5565 Part of fix for bug #1675513 (xref to area broken).
5567 • Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; sections.xsl
5569 Added fixes to avoid duplicate ids when generate.id.attributes = 1.
5570 This (hopefully) closes bug #1671052.
5572 • Michael(tm) Smith: formal.xsl; pi.xsl
5574 Made the dbfunclist PI work as intended. Also added doc for
5575 dbfunclist and dbcmdlist PIs.
5577 • Michael(tm) Smith: pi.xsl; synop.xsl
5579 Made the dbcmdlist work the way it appears to have been intended
5580 to work. Restored dbhtml-dir template back to pi.xsl.
5582 • Michael(tm) Smith: titlepage.xsl; param.xweb; param.ent
5584 Added new param abstract.notitle.enabled.
5585 If non-zero, in output of the abstract element on titlepages,
5586 display of the abstract title is suppressed.
5587 Because sometimes you really don't want or need that title
5590 • Michael(tm) Smith: chunk-code.xsl; graphics.xsl
5592 When we are chunking long descriptions for mediaobject instances
5593 into separate HTML output files, and use.id.as.filename is
5594 non-zero, if a mediaobject has an ID, use that ID as the basename
5595 for the long-description file (otherwise, we generate an ID for it
5596 and use that ID as the basename for the file).
5597 The parallels the recent change made to cause IDs for legalnotice
5598 instances to be used as basenames for legalnotice chunks.
5599 Also, made some minor refinements to the recent changes for
5600 legalnotice chunk handling.
5602 • Michael(tm) Smith: titlepage.xsl
5604 Added support to the HTML stylesheets for proper processing of
5605 orgname as a child of author.
5607 • Michael(tm) Smith: chunk-code.xsl
5609 When $generate.legalnotice.link is non-zero and
5610 $use.id.as.filename is also non-zero, if a legalnotice has an ID,
5611 then instead of assigning the "ln-<generatedID>" basename to the
5612 output file for that legalnotice, just use its real ID as the
5613 basename for the file -- as we do when chunking other elements
5616 • David Cramer: xref.xsl
5618 Handle alt text on xrefs to steps when the step doesn't have a title.
5620 • David Cramer: lists.xsl
5622 Added <p> element around term in variablelist when formatted as table to avoid misalignment of term and listitem in xhtml (non-quirks mode) output
5624 • David Cramer: qandaset.xsl
5626 Added <p> element around question and answer labels to avoid misalignment of label and listitem in xhtml (non-quirks mode) output
5628 • David Cramer: lists.xsl
5630 Added <p> element around callouts to avoid misalignment of callout and listitem in xhtml (non-quirks mode) output
5632 • Mauritz Jeanson: inline.xsl
5634 Make citations numbered if bibliography.numbered != 0.
5636 • Robert Stayton: param.xweb; param.ent
5638 Add support for new profiling attributes audience and wordsize.
5640 • Robert Stayton: inline.xsl; xref.xsl
5642 Add support for xlink olinks.
5644 • Jirka Kosek: glossary.xsl
5646 Rules for normalizing glossary entries before they are sorted can be now different for each language.
5648 • Robert Stayton: chunk-common.xsl; chunk-code.xsl; manifest.xsl; chunk.xsl
5650 Refactored the chunking modules to move all named templates to
5651 chunk-common.xsl and all match templates to chunk-code.xsl, in
5652 order to enable better chunk customization.
5653 See the comments in chunk.xsl for more details.
5655 • Robert Stayton: lists.xsl
5657 Add anchor for xml:id for listitem in varlistentry.
5659 • Robert Stayton: refentry.xsl
5661 Add support for info/title in refsections for db5.
5663 • Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent;
5666 Added support for formatting biblioentries according to ISO690 citation style.
5667 New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
5668 The code was provided by Jana Dvorakova
5670 • Robert Stayton: inline.xsl; xref.xsl
5672 Add call to class.attribute to <a> output elements so they can
5673 have a class value too.
5675 • Mauritz Jeanson: glossary.xsl
5678 * Added curly braces around all $language attribute values.
5679 * Moved declaration of language variable to top level of stylesheet.
5680 Tested with Xalan, Saxon, and xsltproc.
5684 The following changes have been made to the manpages code since the 1.72.0
5687 • Michael(tm) Smith: param.xweb; docbook.xsl; param.ent
5689 Added the man.authors.section.enabled and
5690 man.copyright.section.enabled parameters. Set those to zero when
5691 you want to suppress display of the auto-generated AUTHORS and
5692 COPYRIGHT sections. Closes request #1467806. Thanks to Daniel
5695 • Michael(tm) Smith: docbook.xsl
5697 Took the test that the manpages stylesheet does to see if there
5698 are any Refentry chilren in current doc, and made it
5699 namespace-agnostic. Reason for that is because the test otherwise
5700 won't work when it is copied over into the generated
5701 profile-docbook.xsl stylesheet.
5703 • Michael(tm) Smith: Makefile
5705 Added a manpages/profile-docbook.xsl file to enable single-pass
5706 profiling for manpages output.
5708 • Michael(tm) Smith: info.xsl
5710 Output copyright and legalnotice in man-page output in whatever
5711 place they are in in document order. Closes #1690539. Thanks to
5712 Daniel Leidert for reporting.
5714 • Michael(tm) Smith: docbook.xsl
5716 Restored support for single-pass namespace stripping to manpages
5719 • Michael(tm) Smith: synop.xsl; block.xsl; info.xsl; inline.xsl; lists.xsl;
5722 Changed handling of bold and italic/underline output in manpages
5723 output. Should be transparent to users, but...
5725 This touches handling of all bold and italic/underline output. The
5726 exact change is that the mode="bold" and mode="italic" utility
5727 templates were changed to named templates. (I think maybe I've
5728 changed it back and forth from mode to named before, so this is
5729 maybe re-reverting it yet again).
5731 Anyway, the reason for the change is that the templates are
5732 sometimes call on dynamically node-sets, and using modes to format
5733 those doesn't allow passing info about the current/real context
5734 node from the source (not the node-set created by the stylesheet)
5735 to that formatting stage.
5737 The named templates allow the context to be passed in as a
5738 parameter, so that the bold/ital formatting template can use
5739 context-aware condition checking.
5741 This was basically necessary in order to suppress bold formatting
5742 in titles, which otherwise gets screwed up because of the numbnut
5743 way that roff handles nested bold/ital.
5745 Closes #1674534). Much thanks to Daniel Leidert, whose in his
5746 docbook-xsl bug-finding kung-fu has achieved Grand Master status.
5748 • Michael(tm) Smith: block.xsl
5750 Fixed handling of example instances by adding the example element
5751 to the same template we use for processing figure. Closes
5752 #1674538. Thanks to Daniel Leidert.
5754 • Michael(tm) Smith: utility.xsl
5756 Don't include lang in manpages filename/pathname if lang=en (that
5757 is, only generate lang-qualified file-/pathnames for non-English).
5759 • Michael(tm) Smith: endnotes.xsl
5761 In manpages output, emit warnings for notesources (footnote, etc.)
5762 that have something other than para as a child.
5764 The numbered-with-hanging-indent formatting that's used for
5765 rendering endnotes in the NOTES section of man pages places some
5766 limits/assumptions on how the DocBook source is marked up; namely,
5767 for notesources (footnote, annotation, etc.) that can contain
5768 block-level children, if the they have a block-level child such as
5769 a table or itemizedlist or orderedlist that is the first child of
5770 a footnote, we have no way of rendering/indenting its content
5771 properly in the endnotes list.
5773 Thus, the manpages stylesheet not emits a warning message for that
5774 case, and suggests the "fix" (which is to wrap the table or
5775 itemizedlist or whatever in a para that has some preferatory text.
5777 • Michael(tm) Smith: utility.xsl
5779 Added support to mixed-block template for handling tables in
5780 mixed-blocks (e.g., as child of para) correctly.
5782 • Michael(tm) Smith: table.xsl; synop.xsl; block.xsl; info.xsl; lists.xsl;
5785 Reverted necessary escaping of backslash, dot, and dash
5786 out of the well-intentioned (but it now appears,
5787 misguided) "marker" mechanism (introduced in the 1.72.0
5788 release) -- which made use of alternative "marker"
5789 characters as internal representations of those
5790 characters, and then replaced them just prior to
5791 serialization -- and back into what's basically the
5792 system that was used prior to the 1.69.0 release; that
5793 is, into a part of stylesheet code that gets executed
5794 at the beginning of processing -- before any other roff
5795 markup up is. This change obviates the need for the
5796 marker system. It also requires a lot less RAM during
5797 processing (for large files, the marker mechanism
5798 ending up requiring gigabytes of memory).
5800 Closes bug #1661177. Thanks to Scott Smedley for
5801 providing a test case (the fvwm man page) that exposed
5802 the problem with the marker mechanism.
5804 Also moved the mechanism for converting non-breaking
5805 spaces back into the same area of the stylesheet code.
5807 • Michael(tm) Smith: lists.xsl
5809 Fixed problem with incorrect formatting of nested variablelist.
5810 Closes bug #1650931. Thanks to Daniel "Eagle Eye" Leidert.
5812 • Michael(tm) Smith: lists.xsl
5814 Make sure that all listitems in itemizedlist and orderedlist are
5815 preceded by a blank line. This fixes a regression that occurred
5816 when instances of the TP macro that were use in a previous
5817 versions of the list-handling code were switched to RS/RE (because
5818 TP doesn't support nesting). TP automatically generates a blank
5819 line, but RS doesn't. So I added a .sp before each .RS
5821 • Michael(tm) Smith: block.xsl; inline.xsl; param.xweb; docbook.xsl;
5822 links.xsl; param.ent
5824 Made a number of changes related to elements with
5825 out-of-line content:
5827 - Added handling for mediaobject & inlinemediaobject.
5828 Each imagedata, audiodata, or videodata element
5829 within a mediaobject or inline mediaobject is now
5830 treated as a "notesource" and so handled in much the
5831 same way as links and annotation/alt/footnotes.
5833 That means a numbered marker is generated inline to
5834 mark the place in the main flow where the imagedata,
5835 audiodata, or videodata element occurs, and a
5836 corresponding numbered endnote for it is generated in
5837 the endnotes list at the end of the man page; the
5838 endnote contains the URL from the fileref attribute
5839 of the imagedata, audiodata, or videodata element.
5841 For mediobject and inlinemediaobject instances that
5842 have a textobject child, the textobject is displayed
5843 within the main text flow.
5845 - Renamed several man.link.* params to man.endnotes.*,
5846 to reflect that fact that the endnotes list now
5847 contains more than just links. Also did similar
5848 renaming for a number of stylesheet-internal vars.
5850 - Added support for xlink:href (along with existing
5851 support for the legacy ulink element).
5853 - Cleaned up and streamlined the endnotes-handling
5854 code. It's still messy and klunky and the basic
5855 mechanism it uses is very inefficent for documents
5856 that contain a lot of notesources, but at least it's
5857 a bit better than it was.
5861 The following changes have been made to the eclipse code since the 1.72.0
5864 • Mauritz Jeanson: Makefile
5866 Fixed bug #1715093: Makefile for creating profiled version of eclipse.xsl added.
5868 • David Cramer: eclipse.xsl
5870 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
5874 The following changes have been made to the javahelp code since the 1.72.0
5877 • Mauritz Jeanson: javahelp.xsl
5879 Implemented FR #1230233 (sorted index in javahelp).
5881 • Mauritz Jeanson: javahelp.xsl
5883 Added normalize-space() around titles and index entries to work around whitespace problems.
5884 Added support for glossary and bibliography in toc and map files.
5888 The following changes have been made to the roundtrip code since the 1.72.0
5891 • Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl; normalise2sections.xsl;
5894 new stylesheets for better word processor support and easier maintenance
5896 • Steve Ball: template-pages.xml; dbk2wp.xsl; sections-spec.xml
5902 The following changes have been made to the params code since the 1.72.0
5905 • Mauritz Jeanson: htmlhelp.button.back.xml; htmlhelp.button.forward.xml;
5908 Modified refpurpose text.
5910 • Mauritz Jeanson: htmlhelp.map.file.xml; htmlhelp.force.map.and.alias.xml;
5913 Fixed typos, made some small changes.
5915 • Mauritz Jeanson: javahelp.encoding.xml
5917 Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the
5918 regular "parameter machinery".
5920 • Mauritz Jeanson: generate.id.attributes.xml
5922 Added refpurpose text.
5924 • Mauritz Jeanson: annotation.js.xml; annotation.graphic.open.xml;
5925 annotation.graphic.close.⋯
5927 Added better refpurpose texts.
5929 • Michael(tm) Smith: chunker.output.cdata-section-elements.xml;
5930 chunker.output.standalone.xm⋯
5932 Fixed some broken formatting in source files for chunker.* params,
5933 as pointed out by Dave Pawson.
5935 • Michael(tm) Smith: label.from.part.xml
5937 Changed handling of reference auto-labeling such that reference
5938 (when it appears at the component level) is now affected by the
5939 label.from.part param, just as preface, chapter, and appendix.
5941 • Mauritz Jeanson: callout.graphics.extension.xml
5943 Clarified that 'extension' refers to file names.
5945 • Michael(tm) Smith: abstract.notitle.enabled.xml
5947 Added new param abstract.notitle.enabled.
5948 If non-zero, in output of the abstract element on titlepages,
5949 display of the abstract title is suppressed.
5950 Because sometimes you really don't want or need that title
5953 • Michael(tm) Smith: man.string.subst.map.xml
5955 Updated manpages string-substitute map to reflect fact that
5956 because of another recent change to suppress bold markup in .SH
5957 output, we no longer need to add a workaround for the accidental
5958 uppercasing of roff escapes that occurred previously.
5960 • Jirka Kosek: margin.note.float.type.xml; title.font.family.xml;
5961 table.frame.border.color.x⋯
5963 Improved parameter metadata
5965 • Robert Stayton: profile.wordsize.xml; profile.audience.xml
5967 Add support for profiling on new attributes audience and wordsize.
5969 • Robert Stayton: callout.graphics.number.limit.xml;
5970 callout.graphics.extension.xml
5972 Added SVG graphics for fo output.
5974 • Robert Stayton: callout.icon.size.xml
5976 Set size of callout graphics.
5978 • Jirka Kosek: default.units.xml; chunker.output.method.xml;
5979 toc.list.type.xml; output.inden⋯
5981 Updated parameter metadata to the new format.
5983 • Jirka Kosek: man.output.quietly.xml; title.font.family.xml;
5984 footnote.sep.leader.properties⋯
5986 Added type annotations into parameter definition files.
5988 • Robert Stayton: section.container.element.xml
5990 Support spans in sections for certain processors.
5992 • Robert Stayton: component.titlepage.properties.xml
5994 Empty attribute set for top level component titlepage block.
5995 Allows setting a span on title info.
5997 • Jirka Kosek: bibliography.style.xml
5999 Added link to WiKi page with description of special markup needed for ISO690 biblioentries
6001 • Robert Stayton: make.year.ranges.xml
6003 Clarify that multiple year elements are required.
6005 • Robert Stayton: id.warnings.xml
6007 Turn off id.warnings by default.
6009 • Jirka Kosek: bibliography.style.xml
6011 Added support for formatting biblioentries according to ISO690 citation style.
6012 New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
6013 The code was provided by Jana Dvorakova
6015 • Robert Stayton: header.table.properties.xml; footer.table.properties.xml
6017 Support adding table properties to header and footer tables.
6021 The following changes have been made to the highlighting code since the 1.72.0
6024 • Jirka Kosek: c-hl.xml; xslthl-config.xml
6026 Added support for C language. Provided by Bruno Guegan.
6030 The following changes have been made to the profiling code since the 1.72.0
6033 • Robert Stayton: profile-mode.xsl
6035 Add support for new profiling attributes audience and wordsize.
6039 The following changes have been made to the lib code since the 1.72.0 release.
6041 • Michael(tm) Smith: lib.xweb
6043 Changed name of prepend-pad template to pad-string and twheeked so
6044 it can do both right/left padding.
6048 The following changes have been made to the tools code since the 1.72.0
6051 • Michael(tm) Smith: bin; bin/docbook-xsl-update
6053 Did some cleanup to the install.sh source and added a
6054 docbook-xsl-update script to the docbook-xsl distro, the purpose
6055 of which is to facilitate easy sync-up to the latest docbook-xsl
6056 snapshot (by means of rsync).
6060 The following changes have been made to the xsl-saxon code since the 1.72.0
6063 • Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/
6066 Added modifications so that the new callout.icon.size parameter is taken into account. This
6067 parameter is used for FO output (where SVG now is the default graphics format for callouts).
6069 • Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/
6072 Added code for generating id attributes on callouts in HTML and FO output.
6073 These patches enable cross-references to callouts placed by area coordinates.
6074 It works for graphic, unicode and text callouts.
6075 Part of fix for bug #1675513 (xref to area broken).
6077 • Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/
6080 Copied over Website XSL Java extensions.
6084 The following changes have been made to the xsl-xalan code since the 1.72.0
6087 • Michael(tm) Smith: Makefile; xalan2
6089 Turned off xalan2.jar build. This removes DocBook XSL
6090 Java extensions support for versions of Xalan prior to
6091 Xalan 2.7. If you are currently using the extensions
6092 with an earlier version of Xalan, you need to upgrade
6095 • Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/
6098 Added modifications so that the new callout.icon.size parameter is taken into account. This
6099 parameter is used for FO output (where SVG now is the default graphics format for callouts).
6101 • Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/
6104 Added code for generating id attributes on callouts in HTML and FO output.
6105 These patches enable cross-references to callouts placed by area coordinates.
6106 It works for graphic, unicode and text callouts.
6107 Part of fix for bug #1675513 (xref to area broken).
6109 • Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/
6112 Copied over Website XSL Java extensions.
6116 This release includes important bug fixes and adds the following significant
6119 Automatic sorting of glossary entries
6121 The HTML and FO stylesheets now support automatic sorting of glossary
6122 entries. To enable glossary sorting, set the value of the glossary.sort
6123 parameter to 1 (by default, it’s value is 0). When you enable glossary
6124 sorting, glossentry elements within a glossary, glossdiv, or glosslist are
6125 sorted on the glossterm, using the current language setting. If you don’t
6126 enable glossary sorting, then the order of glossentry elements is left “as
6127 is” — that is, they are not sorted but are instead just displayed in
6130 WordML renamed to Roundtrip, OpenOffice support added
6132 Stylesheets for “roundtrip” conversion between documents in OpenOffice
6133 format (ODF) and DocBook XML have been added to the set of stylesheets that
6134 formerly had the collective title WordML, and that set of stylesheets has
6135 been renamed to Roundtrip to better reflect the actual scope and purpose of
6138 So the DocBook XSL Stylesheets now support roundtrip conversion (with
6139 certain limitations) of WordML, OpenOffice, and Apple Pages documents to
6140 and from DocBook XML.
6142 Including QandASet questions in TOCs
6144 The HTML stylesheet now provides support for including QandASet questions
6145 in the document TOC. To enable display of questions in the document TOC,
6146 set the value of the qanda.in.toc to 1 (by default, it’s 0). When you
6147 enable qanda.in.toc, then the generated table of contents for a document
6148 will include qandaset titles, qandadiv titles, and question elements. The
6149 default value of zero excludes them from the TOC.
6153 The qanda.in.toc parameter does not affect any tables of contents that may
6154 be generated within a qandaset or qandadiv (only in the document TOC).
6156 Language identifier in man-page filenames and pathnames
6158 Added new parameter man.output.lang.in.name.enabled, which controls whether
6159 a language identifier is included in man-page filenames and pathnames. It
6162 If the value of man.output.lang.in.name.enabled is non-zero, man-page files
6163 are output with a language identifier included in their filenames or
6164 pathnames as follows:
6166 □ if man.output.subdirs.enabled is non-zero, each file is output to,
6167 e.g., a /$lang/man8/foo.8 pathname
6169 □ if man.output.subdirs.enabled is zero, each file is output with a
6170 foo.$lang.8 filename
6172 index.page.number.properties property set
6174 For FO output, use the index.page.number.properties to control formatting
6175 of page numbers in index output — to (for example) to display page numbers
6176 in index output in a different color (to indicate that they are links).
6178 Crop marks in output from Antenna House XSL Formatter
6180 Support has been added for generating crop marks in print/PDF output
6181 generated using Antenna House XSL Formatter
6183 More string-substitution hooks in manpages output
6185 The man.string.subst.map.local.pre and man.string.subst.map.local.post
6186 parameters have been added to enable easier control over custom string
6189 Moved verbatim properties to attribute-set
6191 The hardcoded properties used in verbatim elements (literallayout,
6192 programlisting, screen) were moved to the verbatim.properties attribute-set
6193 so they can be more easily customized.
6195 enhanced simple.xlink template
6197 Now the simple.xlink template in inline.xsl works with cross reference
6198 elements xref and link as well. Also, more elements call simple.xlink,
6199 which enables DB5 xlink functionality.
6201 DocBook 5 compatibility
6203 Stylesheets now consistently support DocBook 5 attributes (such as xml:id).
6204 Also, DocBook 5 info elements are now checked along with other *info
6205 elements, and the use of name() function was replaced by local-name() so it
6206 also matches on DocBook 5 elements. These changes enable reusing the
6207 stylesheets with DocBook 5 documents with minimal fixup.
6209 HTML class attributes now handled in class.attribute mode
6211 The HTML class attributes were formerly hardcoded to the element name. Now
6212 the class attribute is generated by applying templates in class.attribute
6213 mode so class attribute names can be customized. The default is still the
6216 arabic-indic numbering enabled in autolabels
6218 Numbering of chapter, sections, and pages can now use arabic-indic
6219 numbering when number format is set to 'arabicindic' or to ١.
6221 The following is a detailed list of changes (not including bug fixes) that have
6222 been made since the 1.71.1 release.
6226 The following changes have been made to the common code since the 1.71.1
6229 • Add support for arabicindic numbering to autolabel.format template.
6231 • Finish support for @xml:id everywhere @id is used.
6233 • replace name() with local-name() in most cases.
6235 • Add support for info.
6237 • Add utility template tabstyle to return the tabstyle from
6242 The following changes have been made to the fo code since the 1.71.1 release.
6244 • Add support for sorting glossary entries
6246 • Add table.row.properties template to customize table rows.
6248 • Moved all properties to attribute-sets so can be customized more easily.
6250 • Add index.page.number.properties attribute-set to format page numbers.
6252 • xref now supports xlink:href, using simple.xlink template.
6254 • Rewrote simple.xlink, and call it with all charseq templates.
6256 • Add simple.xlink processing to term and member elements.
6258 • Add support for crop marks in Antenna House.
6262 The following changes have been made to the html code since the 1.71.1 release.
6264 • Add support for sorting glossary entries
6266 • Add support for qanda.in.toc to add qandaentry questions to document TOC.
6268 • add simple.xlink support to variablelist term and simplelist member.
6270 • *.propagates.style now handled in class.attribute mode.
6272 • add class parameter to class.attribute mode to set default class.
6274 • Convert all class attributes to use the class.attribute mode
6275 so class names can be customized more easily.
6277 • Add class.attribute mode to generate class attributes.
6279 • Added simple.xlink to most remaining inlines.
6280 Changed class attributes to applying class.attributes mode.
6282 • Changed xref template to use simple.xlink tempalte.
6284 • Improve generate.html.title to work with link targets too.
6286 • Improved simple.xlink to support link and xref.
6288 • Use new link.title.attribute now.
6290 • Rewrote simple.xlink to handle linkend also.
6291 Better computation of title attribute on link too.
6293 • Handle Xalan quirk as special case.
6295 • Add support for info.
6297 • Fixed imagemaps so they work properly going from calspair coords
6298 to HTML area coords.
6302 The following changes have been made to the manpages code since the 1.71.1
6305 • Added doc for man.output.lang.in.name.enabled parameter. This
6306 checkin completes support for writing file/pathnames for man-pages
6307 with $lang include in the names. Closes #1585967. knightly
6308 accolades to Daniel Leidert for providing the feature request.
6310 • Added new param man.output.lang.in.name.enabled, which
6311 controls whether $LANG value is included in manpages
6312 filenames and pathnames. It works like this:
6314 If the value of man.output.lang.in.name.enabled is non-zero,
6315 man-page files are output with the $lang value included in
6316 their filenames or pathnames as follows;
6318 - if man.output.subdirs.enabled is non-zero, each file is
6319 output to, e.g., a /$lang/man8/foo.8 pathname
6321 - if man.output.subdirs.enabled is zero, each file is output
6322 with a foo.$lang.8 filename
6324 • Use "\e" instead of "\\" for backslash output, because the
6325 groff docs say that's the correct thing to do; also because
6326 testing (thanks, Paul Dubois) shows that "\\" doesn't always
6327 work as expected; for example, "\\" within a table seems to
6330 • Added the man.string.subst.map.local.pre and
6331 man.string.subst.map.local.post parameters. Those parameters
6332 enable local additions and changes to string-substitution mappings
6333 without the need to change the value of man.string.subst.map
6334 parameter (which is for standard system mappings). Closes
6335 #1456738. Thanks to Sam Steingold for constructing a true
6336 stylesheet torture test (the clisp docs) that exposed the need for
6339 • Added the Markup element to the list of elements that get output
6340 in bold. Thanks to Eric S. Raymond.
6342 • Replaced all dots in roff requests with U+2302 ("house"
6343 character), and added escaping in output for all instances of dot
6344 that are not in roff requests. This fixes the problem case where a
6345 string beginning with a dot (for example, the string ".bashrc")
6346 might occur at the beginning of a line in output, in which case
6347 would mistakenly get interpreted as a roff request. Thanks to Eric
6348 S. Raymond for pushing to fix this.
6350 • Made change to ensure that list content nested in
6351 itemizedlist and orderedlist instances is properly indented. This
6352 is a switch from using .TP to format those lists to using .RS/.RE
6353 to format them instead (because .TP does not allow nesting). Closes bug #
6355 Thanks to Daniel Leidert.
6359 The following changes have been made to the params code since the 1.71.1
6362 • Added doc for man.output.lang.in.name.enabled parameter. This
6363 checkin completes support for writing file/pathnames for man-pages
6364 with $lang include in the names. Closes #1585967. knightly
6365 accolades to Daniel Leidert for providing the feature request.
6367 • Added new param man.output.lang.in.name.enabled, which
6368 controls whether $LANG value is included in manpages
6369 filenames and pathnames. It works like this:
6371 If the value of man.output.lang.in.name.enabled is non-zero,
6372 man-page files are output with the $lang value included in
6373 their filenames or pathnames as follows;
6375 - if man.output.subdirs.enabled is non-zero, each file is
6376 output to, e.g., a /$lang/man8/foo.8 pathname
6378 - if man.output.subdirs.enabled is zero, each file is output
6379 with a foo.$lang.8 filename
6381 • Added the man.string.subst.map.local.pre and
6382 man.string.subst.map.local.post parameters. Those parameters
6383 enable local additions and changes to string-substitution mappings
6384 without the need to change the value of man.string.subst.map
6385 parameter (which is for standard system mappings). Closes
6386 #1456738. Thanks to Sam Steingold for constructing a true
6387 stylesheet torture test (the clisp docs) that exposed the need for
6390 • Add index.page.number.properties by default.
6392 • Added index.page.number.properties
6393 to allow customizations of page numbers in indexes.
6395 • Move show-destination="replace" property from template to attribute-set
6396 so it can be customized.
6398 • Add support for sorting glossary entries
6400 • Add option to include qanda in tables of contents.
6402 • Moved all properties to attribute-sets so can be customized more easily.
6406 The following changes have been made to the template code since the 1.71.1
6409 • Added workaround for Xalan bug: use for-each and copy instead of copy-of (#
6414 The following changes have been made to the roundtrip code since the 1.71.1
6417 • rename to roundtrip, add OpenOffice support
6421 This is a minor update to the 1.71.0 release. Along with a number of bug fixes,
6422 it includes two feature changes:
6424 • Added support for profiling based on xml:lang and status attributes.
6426 • Added initial support in manpages output for footnote, annotation, and alt
6427 instances. Basically, they all now get handled the same way ulink instances
6428 are. They are treated as a class as "note sources": A numbered marker is
6429 generated at the place in the main text flow where they occur, then their
6430 contents are displayed in an endnotes section at the end of the man page.
6434 The following changes have been made to the common code since the 1.71.1
6437 • For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
6439 • Add support for Xalan generating a root xml:base like saxon.
6443 The following changes have been made to the fo code since the 1.71.1 release.
6445 • For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
6447 • Add support for Xalan to add root node xml:base for db5 docs.
6449 • Added support for profiling based on xml:lang and status attributes.
6453 The following changes have been made to the html code since the 1.71.1 release.
6455 • For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
6457 • Add support for Xalan to add root node xml:base for db5 docs.
6459 • Added support for profiling based on xml:lang and status attributes.
6461 • Made changes in namespace declarations to prevent xmllint's
6462 canonicalizer from treating them as relative namespace URIs.
6464 - Changed xmlns:k="java:com.isogen.saxoni18n.Saxoni18nService"
6465 to xmlns:k="http://www.isogen.com/functions/
6466 com.isogen.saxoni18n.Saxoni18nService";
6467 Saxon accepts either form
6468 (see http://www.saxonica.com/documentation/extensibility/
6470 to Saxon, "the part of the URI before the final '/' is immaterial".
6472 - Changed, e.g. xmlns:xverb="com.nwalsh.xalan.Verbatim" to
6473 xmlns:xverb="xalan://com.nwalsh.xalan.Verbatim"; Xalan accepts
6475 (see http://xml.apache.org/xalan-j/extensions.html#
6476 java-namespace-declare);
6477 just as Saxon does, it will "simply use the string to the
6478 right of the rightmost forward slash as the Java class name".
6480 - Changed xmlns:xalanredirect="org.apache.xalan.xslt.extensions.Redirect"
6481 to xmlns:redirect="http://xml.apache.org/xalan/redirect", and
6482 adjusted associated code to make the current Xalan redirect spec.
6483 (see http://xml.apache.org/xalan-j/apidocs/org/apache/xalan/lib/
6486 • Added the html.append and chunk.append parameters. By default, the
6487 value of both is empty; but the internal DocBook XSL stylesheets
6488 build sets their value to "<xsl:text>
</xsl:text>", in order
6489 to ensure that all files in the docbook-xsl-doc package end in a
6490 newline character. (Because diff and some other tools may emit
6491 error messages and/or not behave as expected when processing
6492 files that are not newline-terminated.)
6496 The following changes have been made to the highlighting code since the 1.71.1
6499 • Added license information
6503 The following changes have been made to the manpages code since the 1.71.1
6506 • Added initial support in manpages output for footnote, annotation,
6507 and alt instances. Basically, they all now get handled the same
6508 way ulink instances are. They are treated as a class as "note
6509 sources": A numbered marker is generated at the place in the main
6510 text flow where they occur, then their contents are displayed in
6511 an endnotes section at the end of the man page (currently titled
6512 REFERENCES, for English output, but will be changed to NOTES).
6514 This support is not yet complete. It works for most "normal"
6515 cases, but probably mishandles a good number of cases. More
6516 testing will be needed to expose the problems. It may well also
6517 introduce some bugs and regressions in other areas, including
6518 basic paragraph handling, handling of "mixed block" content,
6519 handling of other indented content, and handling of authorblurb
6520 and personblurb in the AUTHORS section.
6524 The following changes have been made to the params code since the 1.71.1
6527 • Added support for profiling based on xml:lang and status attributes.
6529 • Added the html.append and chunk.append parameters. By default, the
6530 value of both is empty; but the internal DocBook XSL stylesheets
6531 build sets their value to "<xsl:text>
</xsl:text>", in order
6532 to ensure that all files in the docbook-xsl-doc package end in a
6533 newline character. (Because diff and some other tools may emit
6534 error messages and/or not behave as expected when processing
6535 files that are not newline-terminated.)
6539 The following changes have been made to the profiling code since the 1.71.1
6542 • Added support for profiling based on xml:lang and status attributes.
6546 This is mainly a bug fix release, but it also includes two significant feature
6549 Highlighting support added
6551 The stylesheets now include support for source-code highlighting in output
6552 of programlisting instances (controlled through the highlight.source
6553 parameter). The Java-based implementation requires Saxon and makes use of
6554 Michal Molhanec’s XSLTHL. More details are available at Jirka Kosek’s
6557 http://xmlguru.cz/2006/07/docbook-syntax-highlighting
6559 The support is currently limited to highlighting of XML, Java, PHP, Delphi,
6560 Modula-2 sources, and INI files.
6562 Changes to autoindexing
6564 The templates that handle alternative indexing methods were reworked to
6565 avoid errors produced by certain processors not being able to tolerate the
6566 presence of unused functions. With this release, none of the code for the
6567 'kimber' or 'kosek' methods is included in the default stylesheets. In
6568 order to use one of those methods, your customization layer must import one
6569 of the optional stylesheet modules:
6571 □ html/autoidx-kosek.xsl
6572 □ html/autoidx-kimber.xsl
6573 □ fo/autoidx-kosek.xsl
6574 □ fo/autoidx-kimber.xsl
6576 See the index.method parameter reference page for more information.
6578 Two other changes to note:
6580 □ The default indexing method now can handle accented characters in
6581 latin-based alphabets, not just English. This means accented latin
6582 letters will group and sort with their unaccented counterpart.
6583 □ The default value for the index.method parameter was changed from
6584 'english' to 'basic' because now the default method can handle
6585 latin-based alphabets, not just English.
6587 The following is a list of changes that have been made since the 1.70.1
6592 The following changes have been made to the common code since the 1.70.1
6595 • Added reference.autolabel parameter for controlling labels on
6598 • Support rows that are *completely* overlapped by the preceding row
6600 • New modules for supporting indexing extensions.
6602 • Support startinglinenumber on orderedlist
6606 The following changes have been made to the extensions code since the 1.70.1
6609 • Completely reworked extensions build system; now uses NetBeans and ant
6613 The following changes have been made to the fo code since the 1.70.1 release.
6615 • xsl:sort lang attribute now uses two-char substring of lang attribute.
6617 • Support titlecase "Java", "Perl", and "IDL" as values for the
6618 language attribute on classsynopsis, etc. (instead of just
6619 lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
6620 (instead of just "cpp").
6622 Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
6623 to "Brian A. Vanderburg II".
6625 • Added support for the reference.autolabel param in (X)HTML and FO
6628 • Support rows that are *completely* overlapped by the preceding row
6630 • Rearranged templates for the 3 indexing methods
6631 and changed method named 'english' to 'basic'.
6633 • New modules for supporting indexing extensions.
6635 • Turn off blank-body for fop1.extensions too since fop 0.92
6636 does not support it either.
6638 • Add Xalan variant to test for exslt:node-set function.
6639 Xalan can use function named node-set(), but doesn't
6640 recognize it using function-available().
6642 • Added support to FO stylesheets for handling instances of Org
6643 where it occurs outside of *info content. In HTML stylesheets,
6644 moved handling of Org out of info.xsl and into inline.xsl. In both
6645 FO and HTML stylesheets, added support for correctly processing
6646 Affiliation and Jobtitle.
6648 • Don't output punctuation between Refname and Refpurpose if
6649 Refpurpose is empty. Also corrected handling of Refsect2/title
6650 instances, and removed some debugging stuff that was generated in
6651 manpages output to mark the ends of sections.
6653 • Added new email.delimiters.enabled param. If non-zero (the
6654 default), delimiters are generated around e-mail addresses (output
6655 of the email element). If zero, the delimiters are suppressed.
6657 • Initial support of syntax highlighting of programlistings.
6659 • Chapter after preface should restart numbering of pages.
6663 The following changes have been made to the html code since the 1.70.1 release.
6665 • xsl:sort lang attribute now uses two-char substring of lang attribute.
6667 • Support titlecase "Java", "Perl", and "IDL" as values for the
6668 language attribute on classsynopsis, etc. (instead of just
6669 lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
6670 (instead of just "cpp").
6672 Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
6673 to "Brian A. Vanderburg II".
6675 • Added support for the reference.autolabel param in (X)HTML and FO
6678 • Support rows that are *completely* overlapped by the preceding row
6680 • Rearranged templates for the 3 indexing methods
6681 and changed method named 'english' to 'basic'.
6683 • New modules for supporting indexing extensions.
6685 • Added several new HTML parameters for controlling appearance of
6686 content on HTML title pages:
6688 contrib.inline.enabled:
6689 If non-zero (the default), output of the contrib element is
6690 displayed as inline content rather than as block content.
6692 othercredit.like.author.enabled:
6693 If non-zero, output of the othercredit element on titlepages is
6694 displayed in the same style as author and editor output. If zero
6695 (the default), othercredit output is displayed using a style
6696 different than that of author and editor.
6698 blurb.on.titlepage.enabled:
6699 If non-zero, output from authorblurb and personblurb elements is
6700 displayed on title pages. If zero (the default), output from
6701 those elements is suppressed on title pages (unless you are
6702 using a titlepage customization that causes them to be included).
6705 If non-zero (the default), a localized Edited by heading is
6706 displayed above editor names in output of the editor element.
6708 • Add Xalan variant to test for exslt:node-set function.
6709 Xalan can use function named node-set(), but doesn't
6710 recognize it using function-available().
6712 • Added support to FO stylesheets for handling instances of Org
6713 where it occurs outside of *info content. In HTML stylesheets,
6714 moved handling of Org out of info.xsl and into inline.xsl. In both
6715 FO and HTML stylesheets, added support for correctly processing
6716 Affiliation and Jobtitle.
6718 • Don't output punctuation between Refname and Refpurpose if
6719 Refpurpose is empty. Also corrected handling of Refsect2/title
6720 instances, and removed some debugging stuff that was generated in
6721 manpages output to mark the ends of sections.
6723 • Added new email.delimiters.enabled param. If non-zero (the
6724 default), delimiters are generated around e-mail addresses (output
6725 of the email element). If zero, the delimiters are suppressed.
6727 • Added qanda.nested.in.toc param. Default value is zero. If
6728 non-zero, instances of "nested" Qandaentry (ones that are children
6729 of Answer elements) are displayed in the TOC. Closes patch 1509018
6730 (from Daniel Leidert). Currently on affects HTML output (no patch
6731 for FO output provided).
6733 • Improved handling of relative locations generated files
6735 • Initial support of syntax highlighting of programlistings.
6741 • Support $keep.relative.image.uris also when chunking
6745 The following changes have been made to the highlighting code since the 1.70.1
6748 • Initial support of syntax highlighting of programlistings.
6752 The following changes have been made to the manpages code since the 1.70.1
6755 • Suppress footnote markers and output warning that footnotes are
6758 • Handle instances of address/otheraddr/ulink in author et al in the
6759 same way as email instances; that is, display them on the same
6760 linke as the author, editor, etc., name.
6762 • Don't number or link-list any Ulink instance whose string value is
6763 identical to the value of its url attribute. Just display it inline.
6765 • Don't output punctuation between Refname and Refpurpose if
6766 Refpurpose is empty. Also corrected handling of Refsect2/title
6767 instances, and removed some debugging stuff that was generated in
6768 manpages output to mark the ends of sections.
6770 • Added new email.delimiters.enabled param. If non-zero (the
6771 default), delimiters are generated around e-mail addresses (output
6772 of the email element). If zero, the delimiters are suppressed.
6774 • In manpages output, if the last/nearest *info element for
6775 particular Refentry has multiple Copyright and/or Legalnotice
6776 children, process them all (not just the first ones). Closes bug
6777 1524576. Thanks to Sam Steingold for the report and to Daniel
6778 Leidert for providing a patch.
6782 The following changes have been made to the params code since the 1.70.1
6785 • Added reference.autolabel parameter for controlling labels on
6788 • Added namespace declarations to document elements for all param files.
6790 • Updated index.method doc to describe revised setup for importing index
6793 • Added several new HTML parameters for controlling appearance of
6794 content on HTML title pages:
6796 contrib.inline.enabled:
6797 If non-zero (the default), output of the contrib element is
6798 displayed as inline content rather than as block content.
6800 othercredit.like.author.enabled:
6801 If non-zero, output of the othercredit element on titlepages is
6802 displayed in the same style as author and editor output. If zero
6803 (the default), othercredit output is displayed using a style
6804 different than that of author and editor.
6806 blurb.on.titlepage.enabled:
6807 If non-zero, output from authorblurb and personblurb elements is
6808 displayed on title pages. If zero (the default), output from
6809 those elements is suppressed on title pages (unless you are
6810 using a titlepage customization that causes them to be included).
6813 If non-zero (the default), a localized Edited by heading is
6814 displayed above editor names in output of the editor element.
6816 • Added new email.delimiters.enabled param. If non-zero (the
6817 default), delimiters are generated around e-mail addresses (output
6818 of the email element). If zero, the delimiters are suppressed.
6820 • Added qanda.nested.in.toc param. Default value is zero. If
6821 non-zero, instances of "nested" Qandaentry (ones that are children
6822 of Answer elements) are displayed in the TOC. Closes patch 1509018
6823 (from Daniel Leidert). Currently on affects HTML output (no patch
6824 for FO output provided).
6826 • Initial support of syntax highlighting of programlistings.
6830 The following changes have been made to the tools code since the 1.70.1
6833 • Racheted down font sizes of headings in example makefile FO output.
6835 • Added param and attribute set to example makefile, for getting
6836 wrapping in verbatims in FO output.
6838 • Renamed Makefile.paramDoc to Makefile.docParam.
6840 • Added Makefile.paramDoc file, for creating versions of param.xsl
6841 files with doc embedded.
6843 • Added variable to example makefile for controlling whether HTML or
6848 This is a stable release of the 1.70 stylesheets. It includes only a few small
6849 changes from 1.70.0.
6851 The following is a list of changes that have been made since the 1.70.0
6856 The following changes have been made to the fo code since the 1.70.0 release.
6858 • Added three new attribute sets (revhistory.title.properties,
6859 revhistory.table.properties and revhistory.table.cell.properties) for
6860 controlling appearance of revhistory in FO output.
6862 Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/
6863 titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params
6864 /revhistory.table.properties.xml,1.1; params/
6865 revhistory.title.properties.xml,1.1 - Jirka Kosek
6867 • Support DBv5 revisions with full author name (not only authorinitials)
6869 Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek
6873 The following changes have been made to the html code since the 1.70.0 release.
6875 • Support DBv5 revisions with full author name (not only authorinitials)
6877 Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek
6881 The following changes have been made to the htmlhelp code since the 1.70.0
6884 • htmlhelp.generate.index is now param, not variable. This means that you can
6885 override its setting from outside. This is useful when you generate
6886 indexterms on the fly (see http://www.xml.com/pub/a/2004/07/14/dbndx.html?
6889 Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek
6891 • Support chunk.tocs.and.lots in HTML Help
6893 Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek
6897 The following changes have been made to the params code since the 1.70.0
6900 • Added three new attribute sets (revhistory.title.properties,
6901 revhistory.table.properties and revhistory.table.cell.properties) for
6902 controlling appearance of revhistory in FO output.
6904 Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/
6905 titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params
6906 /revhistory.table.properties.xml,1.1; params/
6907 revhistory.title.properties.xml,1.1 - Jirka Kosek
6911 As with all DocBook Project dot-zero releases, this is an experimental release.
6912 It will be followed shortly by a stable release.
6914 This release adds a number of new features, including:
6916 • support for selecting alternative index-collation methods (in particular,
6917 support for using a collation library developed by Eliot Kimber)
6919 • improved handling of DocBook 5 document instances (through a
6920 namespace-stripping mechanism)
6922 • full support for CALS and HTML tables in manpages output
6924 • a mechanism for preserving relative URIs in documents that make use of
6927 • support for the "new" .90 version of FOP
6929 • enhanced capabilities for controlling formatting of lists in HTML and FO
6932 • autogeneration of AUTHOR and COPYRIGHT sections in manpages output
6934 • support for generating crop marks in FO/PDF output
6936 • support for qandaset as a root element in FO output
6938 • support for floatstyle and orient on all table types
6940 • support for floatstyle in figure, and example
6942 • pgwide.properties attribute-set supports extending figure, example and
6943 table into the left indent area instead of spanning multiple columns.
6945 The following is a detailed list of enhancements and API changes that have been
6946 made since the 1.69.1 release.
6950 The following changes have been made to the common code since the 1.69.1
6953 • Add the xsl:key for the kimber indexing method.
6955 Modified: common/autoidx-ng.xsl,1.2 - Robert Stayton
6957 • Add support for qandaset.
6959 Modified: common/labels.xsl,1.37; common/subtitles.xsl,1.7; common/
6960 titles.xsl,1.35 - Robert Stayton
6962 • Support dbhtml/dbfo start PI for orderedlist numbering in both HTML and FO
6964 Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman Walsh
6968 Modified: common/stripns.xsl,1.12 - Robert Stayton
6970 • Changed content model of text element to ANY rather than #PCDATA because
6971 they could contain markup.
6973 Modified: common/targetdatabase.dtd,1.7 - Robert Stayton
6975 • Added refentry.meta.get.quietly param.
6977 If zero (the default), notes and warnings about "missing" markup are
6978 generated during gathering of refentry metadata. If non-zero, the metadata
6979 is gathered "quietly" -- that is, the notes and warnings are suppressed.
6981 NOTE: If you are processing a large amount of refentry content, you may be
6982 able to speed up processing significantly by setting a non-zero value for
6983 refentry.meta.get.quietly.
6985 Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/
6986 param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
6989 • After namespace stripping, the source document is the temporary tree
6990 created by the stripping process and it has the wrong base URI for relative
6991 references. Earlier versions of this code used to try to fix that by
6992 patching the elements with relative @fileref attributes. That was
6993 inadequate because it calculated an absolute base URI without considering
6994 that there might be xml:base attributes already in effect. It seems obvious
6995 now that the right thing to do is simply to put the xml:base on the root of
6996 the document. And that seems to work.
6998 Modified: common/stripns.xsl,1.7 - Norman Walsh
7000 • Added support for "software" and "sectdesc" class values on refmiscinfo;
7001 "software" is treated identically to "source", and "setdesc" is treated
7002 identically to "manual".
7004 Modified: common/refentry.xsl,1.10; params/
7005 man.th.extra2.max.length.xml,1.3; params/
7006 refentry.source.name.profile.xml,1.4 - Michael(tm) Smith
7008 • Added support for DocBook 5 namespace-stripping in manpages stylesheet.
7009 Closes request #1210692.
7011 Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm)
7014 • Added <xsl:template match="/"> to make stripns.xsl usable as a standalone
7015 stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that DocBook
7016 XSLT drivers that include this stylesheet all override the match="/"
7019 Modified: common/stripns.xsl,1.4 - Michael(tm) Smith
7021 • Number figures, examples, and tables from book if there is no prefix (i.e.
7022 if chapter.autolabel is set to 0). This avoids having the list of figures
7023 where the figures mysteriously restart their numeration periodically when
7024 chapter.autolabel is set to 0.
7026 Modified: common/labels.xsl,1.36 - David Cramer
7028 • Add task template in title.markup mode.
7030 Modified: common/titles.xsl,1.34 - Robert Stayton
7032 • Add children (with ids) of formal objects to target data.
7034 Modified: common/targets.xsl,1.10 - Robert Stayton
7036 • Added support for case when personname doesn't contain specific name markup
7037 (as allowed in DocBook 5.0)
7039 Modified: common/common.xsl,1.54 - Jirka Kosek
7043 The following changes have been made to the extensions code since the 1.69.1
7048 Modified: extensions/xalan27/.cvsignore,1.1; extensions/xalan27/
7049 build.xml,1.1; extensions/xalan27/nbproject/.cvsignore,1.1; extensions/
7050 xalan27/nbproject/build-impl.xml,1.1; extensions/xalan27/nbproject/
7051 genfiles.properties,1.1; extensions/xalan27/nbproject/
7052 project.properties,1.1; extensions/xalan27/nbproject/project.xml,1.1;
7053 extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1; extensions/xalan27/
7054 src/com/nwalsh/xalan/Callout.java,1.1; extensions/xalan27/src/com/nwalsh/
7055 xalan/FormatCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
7056 FormatDingbatCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
7057 FormatGraphicCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
7058 FormatTextCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
7059 FormatUnicodeCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
7060 Func.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
7061 ImageIntrinsics.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
7062 Params.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1;
7063 extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1; extensions/xalan27/
7064 src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman Walsh
7066 • Handle the case where the imageFn is actually a URI. This still needs work.
7068 Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4 -
7073 The following changes have been made to the fo code since the 1.69.1 release.
7075 • Adapted to the new indexing code. Now works just like a wrapper that calls
7076 kosek indexing method, originally implemented here.
7078 Modified: fo/autoidx-ng.xsl,1.5 - Jirka Kosek
7080 • Added parameters for header/footer table minimum height.
7082 Modified: fo/pagesetup.xsl,1.60; fo/param.ent,1.100; fo/param.xweb,1.113 -
7085 • Add the index.method parameter.
7087 Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert Stayton
7089 • Integrate support for three indexing methods: - the original English-only
7090 method. - Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's
7091 method using Saxon extensions. Use the 'index.method' parameter to select.
7093 Modified: fo/autoidx.xsl,1.38 - Robert Stayton
7095 • Add support for TOC for qandaset in fo output.
7097 Modified: fo/autotoc.xsl,1.30; fo/qandaset.xsl,1.20 - Robert Stayton
7099 • Added parameter ulink.hyphenate.chars. Added parameter insert.link
7102 Modified: fo/param.ent,1.98; fo/param.xweb,1.111 - Robert Stayton
7104 • Implemented feature request #942524 to add insert.link.page.number to allow
7105 link element cross references to have a page number.
7107 Modified: fo/xref.xsl,1.67 - Robert Stayton
7109 • Add support for ulink.hyphenate.chars so more characters can be break
7112 Modified: fo/xref.xsl,1.66 - Robert Stayton
7114 • Implemented patch #1075144 to make the url text in a ulink in FO output an
7115 active link as well.
7117 Modified: fo/xref.xsl,1.65 - Robert Stayton
7119 • table footnotes now have their own table.footnote.properties attribute set.
7121 Modified: fo/footnote.xsl,1.23 - Robert Stayton
7123 • Add qandaset to root.elements.
7125 Modified: fo/docbook.xsl,1.41 - Robert Stayton
7127 • Added mode="page.sequence" to make it easier to put content into a page
7128 sequence. First used for qandaset.
7130 Modified: fo/component.xsl,1.37 - Robert Stayton
7132 • Implemented feature request #1434408 to support formatting of biblioentry.
7134 Modified: fo/biblio.xsl,1.35 - Robert Stayton
7136 • Added biblioentry.properties.
7138 Modified: fo/param.ent,1.97; fo/param.xweb,1.110 - Robert Stayton
7140 • Support PTC/Arbortext bookmarks
7142 Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman Walsh
7144 • Added table.footnote.properties to permit table footnotes to format
7145 differently from regular footnotes.
7147 Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert Stayton
7149 • Refactored table templates to unify their processing and support all
7150 options in all types. Now table and informaltable, in both Cals and Html
7151 markup, use the same templates where possible, and all support pgwide,
7152 rotation, and floats. There is also a placeholder table.container template
7153 to support wrapping a table in a layout table, so the XEP table title
7154 "continued" extension can be more easily implemented.
7156 Modified: fo/formal.xsl,1.52; fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 -
7159 • Added new attribute set toc.line.properties for controlling appearance of
7162 Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95; fo/param.xweb,1.108 -
7165 • Added support for float to example and equation. Added support for pgwide
7166 to figure, example, and equation (the latter two via a dbfo pgwide="1"
7167 processing instruction).
7169 Modified: fo/formal.xsl,1.51 - Robert Stayton
7171 • Add pgwide.properties attribute-set.
7173 Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert Stayton
7175 • Added refclass.suppress param.
7177 If the value of refclass.suppress is non-zero, then display refclass
7178 contents is suppressed in output. Affects HTML and FO output only.
7180 Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html
7181 /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith
7183 • Improved support for task subelements
7185 Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - Jirka Kosek
7187 • Adjusted spacing around K&R-formatted Funcdef and Paramdef output such that
7188 it can more easily be discerned where one ends and the other begins. Closes
7191 Modified: fo/synop.xsl,1.18 - Michael(tm) Smith
7193 • Made handling of paramdef/parameter in FO output consistent with that in
7194 HTML and manpages output. Closes #1213259.
7196 Modified: fo/synop.xsl,1.17 - Michael(tm) Smith
7198 • Made handling of Refnamediv consistent with formatting in HTML and manpages
7199 output; specifically, changed so that Refname (comma-separated list of
7200 multiple instances found) is used (instead of Refentrytitle as previously),
7201 then em-dash, then the Refpurpose. Closes #1212562.
7203 Modified: fo/refentry.xsl,1.30 - Michael(tm) Smith
7205 • Added output of Releaseinfo to recto titlepage ("copyright" page) for Book
7206 in FO output. This makes it consistent with HTML output. Closes #1327034.
7207 Thanks to Paul DuBois for reporting.
7209 Modified: fo/titlepage.templates.xml,1.28 - Michael(tm) Smith
7211 • Added condition for setting block-progression-dimension.minimum on
7212 table-row, instead of height, when fop1.extensions is non-zero. For an
7213 explanation of the reason for the change, see: http://wiki.apache.org/
7214 xmlgraphics-fop/Troubleshooting/CommonLogMessages
7216 Modified: fo/pagesetup.xsl,1.59 - Michael(tm) Smith
7218 • Added new refclass.suppress param for suppressing display of Refclass in
7219 HTML and FO output. Did not add it to manpages because manpages stylesheet
7220 is currently just silently ignoring Refclass anyway. Closes request #
7221 1461065. Thanks to Davor Ocelic (docelic) for reporting.
7223 Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - Michael(tm) Smith
7225 • Add support for keep-together PI to informal objects.
7227 Modified: fo/formal.xsl,1.50 - Robert Stayton
7229 • Add support for fop1.extensions.
7231 Modified: fo/formal.xsl,1.49; fo/graphics.xsl,1.44; fo/table.xsl,1.47 -
7234 • Add support for fop1 bookmarks.
7236 Modified: fo/docbook.xsl,1.39 - Robert Stayton
7238 • Add fop1.extentions parameter to add support for fop development version.
7240 Modified: fo/param.ent,1.92; fo/param.xweb,1.105 - Robert Stayton
7242 • Start supporting fop development version, which will become fop version 1.
7244 Modified: fo/fop1.xsl,1.1 - Robert Stayton
7246 • Add template for task in mode="xref-to".
7248 Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert Stayton
7250 • table footnotes now also get footnote.properties attribute-set.
7252 Modified: fo/footnote.xsl,1.22 - Robert Stayton
7254 • Added index.separator named template to compute the separator punctuation
7257 Modified: fo/autoidx.xsl,1.36 - Robert Stayton
7259 • Added support for link, olink, and xref within OO Classsynopsis and
7260 children. (Because DocBook NG/5 allows it).
7262 Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith
7264 • Support date as an inline
7266 Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh
7268 • Added new parameter keep.relative.image.uris
7270 Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html
7271 /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh
7273 • Map Unicode space characters U+2000-U+200A to fo:leaders.
7275 Modified: fo/docbook.xsl,1.38; fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 -
7278 • Output a real em dash for em-dash dingbat (instead of two hypens).
7280 Modified: fo/fo.xsl,1.7 - Michael(tm) Smith
7282 • Support default label width parameters for itemized and ordered lists
7284 Modified: fo/lists.xsl,1.64; fo/param.ent,1.90; fo/param.xweb,1.103; params
7285 /itemizedlist.label.width.xml,1.1; params/orderedlist.label.width.xml,1.1 -
7288 • Generate localized title for Refsynopsisdiv if no appropriate Title
7289 descendant found in source. Closes #1212398. This change makes behavior for
7290 the Synopsis title consistent with the behavior of HTML and manpages
7293 Also, added xsl:use-attribute-sets="normal.para.spacing" to block generated
7294 for Cmdsynopsis output. Previously, that block had no spacing at all
7295 specified, which resulted it being crammed up to closely to the Synopsis
7298 Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm) Smith
7300 • Added parameters to support localization of index item punctuation.
7302 Modified: fo/autoidx.xsl,1.35 - Robert Stayton
7304 • Added index.number.separator, index.range.separator, and
7305 index.term.separator parameters to support localization of punctuation in
7308 Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert Stayton
7310 • Added "Cross References" section in HTML doc (for consistency with the FO
7311 doc). Also, moved the existing FO "Cross References" section to follow the
7314 Modified: fo/param.xweb,1.101; html/param.xweb,1.95 - Michael(tm) Smith
7316 • Added ID attribues to all Reference elements (e.g., id="tables" for the doc
7317 for section on Table params). So pages for all subsections of ref docs now
7318 have stable filenames instead of arbitrary generated filenames.
7320 Modified: fo/param.xweb,1.100; html/param.xweb,1.94 - Michael(tm) Smith
7322 • Added two new parameters for handling of multi-term varlistentry elements:
7324 variablelist.term.break.after: When the variablelist.term.break.after is
7325 non-zero, it will generate a line break after each term multi-term
7328 variablelist.term.separator: When a varlistentry contains multiple term
7329 elements, the string specified in the value of the
7330 variablelist.term.separator parameter is placed after each term except the
7331 last. The default is ", " (a comma followed by a space). To suppress
7332 rendering of the separator, set the value of variablelist.term.separator to
7333 the empty string ("").
7335 These parameters are primarily intended to be useful if you have multi-term
7336 varlistentries that have long terms.
7338 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
7339 long terms" doc that demonstrated the value of having these options.
7341 Also, added normalize-space() call to processing of each term.
7343 This change affects all output formats (HTML, PDF, manpages). The default
7344 behavior should pretty much remain the same as before, but it is possible
7345 (as always) that the change may introduce some new bugginess.
7347 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
7348 lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
7349 lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
7350 variablelist.term.break.after.xml,1.1; params/
7351 variablelist.term.separator.xml,1.1 - Michael(tm) Smith
7353 • Add sidebar titlepage placeholder attset for styles.
7355 Modified: fo/titlepage.xsl,1.37 - Robert Stayton
7357 • Add titlepage for sidebar.
7359 Modified: fo/titlepage.templates.xml,1.27 - Robert Stayton
7361 • Implemented RFE #1292615.
7363 Added bunch of new parameters (attribute sets) that affect list
7364 presentation: list.block.properties, itemizedlist.properties, orderedlist
7365 .properties, itemizedlist.label.properties and orderedlist.label
7366 .properties. Default behaviour of stylesheets has not been changed but
7367 further customizations will be much more easier.
7369 Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; params/
7370 itemizedlist.label.properties.xml,1.1; params/
7371 itemizedlist.properties.xml,1.1; params/list.block.properties.xml,1.1;
7372 params/orderedlist.label.properties.xml,1.1; params/
7373 orderedlist.properties.xml,1.1 - Jirka Kosek
7375 • Implemented RFE #1242092.
7377 You can enable crop marks in your document by setting crop.marks=1 and
7378 xep.extensions=1. Appearance of crop marks can be controlled by parameters
7379 crop.mark.bleed (6pt), crop.mark.offset (24pt) and crop.mark.width (0.5pt).
7381 Also there is new named template called user-xep-pis. You can overwrite it
7382 in order to produce some PIs that can control XEP as described in http://
7383 www.renderx.com/reference.html#Output_Formats
7385 Modified: fo/docbook.xsl,1.36; fo/param.ent,1.86; fo/param.xweb,1.97; fo/
7386 xep.xsl,1.23; params/crop.mark.bleed.xml,1.1; params/
7387 crop.mark.offset.xml,1.1; params/crop.mark.width.xml,1.1; params/
7388 crop.marks.xml,1.1 - Jirka Kosek
7392 The following changes have been made to the html code since the 1.69.1 release.
7394 • implemented index.method parameter and three methods.
7396 Modified: html/autoidx.xsl,1.28 - Robert Stayton
7398 • added index.method parameter to support 3 indexing methods.
7400 Modified: html/param.ent,1.94; html/param.xweb,1.103 - Robert Stayton
7402 • Implemented feature request #1072510 as a processing instruction to permit
7403 including external HTML content into HTML output.
7405 Modified: html/pi.xsl,1.9 - Robert Stayton
7407 • Added new parameter chunk.tocs.and.lots.has.title which controls presence
7408 of title in a separate chunk with ToC/LoT. Disabling title can be very
7409 useful if you are generating frameset output (well, yes those frames, but
7410 some customers really want them ;-).
7412 Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; html/
7413 param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
7416 • Support dbhtml/dbfo start PI for orderedlist numbering in both HTML and FO
7418 Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman Walsh
7420 • Allow ToC without title also for set and book.
7422 Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 - Jirka Kosek
7424 • Implemented floats uniformly for figure, example, equation and
7425 informalfigure, informalexample, and informalequation.
7427 Modified: html/formal.xsl,1.22 - Robert Stayton
7429 • Added the autotoc.label.in.hyperlink param.
7431 If the value of autotoc.label.in.hyperlink is non-zero, labels are included
7432 in hyperlinked titles in the TOC. If it is instead zero, labels are still
7433 displayed prior to the hyperlinked titles, but are not hyperlinked along
7436 Closes patch #1065868. Thanks to anatoly techtonik for the patch.
7438 Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; html/
7439 param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - Michael(tm)
7442 • Added two new params: html.head.legalnotice.link.types and html.head.
7443 legalnotice.link.multiple.
7445 If the value of the generate.legalnotice.link is non-zero, then the
7446 stylesheet generates (in the head section of the HTML source) either a
7447 single HTML link element or, if the value of the html.head.legalnotice.link
7448 .multiple is non-zero, one link element for each link type specified. Each
7449 link has the following attributes:
7451 - a rel attribute whose value is derived from the value of html.head.
7452 legalnotice.link.types
7454 - an href attribute whose value is set to the URL of the file containing
7457 - a title attribute whose value is set to the title of the corresponding
7458 legalnotice (or a title programatically determined by the stylesheet)
7462 <link rel="copyright" href="ln-id2524073.html" title="Legal Notice">
7464 Closes #1476450. Thanks to Sam Steingold.
7466 Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; html/
7467 param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; params/
7468 html.head.legalnotice.link.multiple.xml,1.1; params/
7469 html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith
7471 • Added refclass.suppress param.
7473 If the value of refclass.suppress is non-zero, then display refclass
7474 contents is suppressed in output. Affects HTML and FO output only.
7476 Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html
7477 /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith
7479 • Improved support for task subelements
7481 Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - Jirka Kosek
7483 • Added new refclass.suppress param for suppressing display of Refclass in
7484 HTML and FO output. Did not add it to manpages because manpages stylesheet
7485 is currently just silently ignoring Refclass anyway. Closes request #
7486 1461065. Thanks to Davor Ocelic (docelic) for reporting.
7488 Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - Michael(tm) Smith
7490 • Process alt text with normalize-space(). Replace tab indents with spaces.
7492 Modified: html/graphics.xsl,1.57 - Robert Stayton
7494 • Content of citation element is automatically linked to the bibliographic
7495 entry with the corresponding abbrev.
7497 Modified: html/biblio.xsl,1.26; html/inline.xsl,1.47; html/xref.xsl,1.58 -
7500 • Add template for task in mode="xref-to".
7502 Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert Stayton
7504 • Suppress ID warnings if the .warnings parameter is 0
7506 Modified: html/html.xsl,1.17 - Norman Walsh
7508 • Add support for floatstyle to figure.
7510 Modified: html/formal.xsl,1.21 - Robert Stayton
7512 • Handling of xref to area/areaset need support in extensions code also. I
7513 currently have no time to touch extensions code, so code is here to be
7514 enabled when extension is fixed also.
7516 Modified: html/xref.xsl,1.56 - Jirka Kosek
7518 • Added 3 parameters for overriding gentext for index punctuation.
7520 Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert Stayton
7522 • Added parameters to support localization of index item punctuation. Added
7523 index.separator named template to compute the separator punctuation based
7526 Modified: html/autoidx.xsl,1.27 - Robert Stayton
7528 • Added a <div class="{$class}-contents"> wrapper around output of contents
7529 of all formal objects. Also, added an optional <br class="{class}-break"/>
7530 linebreak after all formal objects.
7532 WARNING: Because this change places an additional DIV between the DIV
7533 wrapper for the equation and the equation contents, it may break some
7534 existing CSS stylesheets that have been created with the assumption that
7535 there would never be an intervening DIV there.
7537 The following is an example of what Equation output looks like as a result
7538 of the changes described above.
7540 <div class="equation"> <a name="three" id="three"></a>
7542 <p class="title"><b>(1.3)</b></p>
7544 <div class="equation-contents"> <span class="mathphrase">1+1=3</span> </
7545 div> </div><br class="equation-break">
7547 Rationale: These changes allow CSS control of the placement of the
7548 formal-object title relative to the formal-object contents. For example,
7549 using the CSS "float" property enables the title and contents to be
7550 rendered on the same line. Example stylesheet:
7552 .equation { margin-top: 20px; margin-bottom: 20px; } .equation-contents {
7555 .equation .title { margin-top: 0; float: right; margin-right: 200px; }
7557 .equation .title b { font-weight: normal; }
7559 .equation-break { clear: both; }
7561 Note that the purpose of the ".equation-break" class is to provide a way to
7562 clear off the floats.
7564 If you want to instead have the equation title rendered to the left of the
7565 equation contents, you can do something like this:
7567 .equation { margin-top: 20px; width: 300px; margin-bottom: 20px; }
7568 .equation-contents { float: right; }
7570 .equation .title { margin-top: 0; float: left; margin-right: 200px; }
7572 .equation .title b { font-weight: normal; }
7574 .equation-break { clear: both; }
7576 Modified: html/formal.xsl,1.20 - Michael(tm) Smith
7578 • Added a chunker.output.quiet top-level parameter so that the chunker can be
7579 made quiet by default
7581 Modified: html/chunker.xsl,1.26 - Norman Walsh
7583 • Added support for link, olink, and xref within OO Classsynopsis and
7584 children. (Because DocBook NG/5 allows it).
7586 Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith
7588 • New parameter: id.warnings. If non-zero, warnings are generated for titled
7589 objects that don't have titles. True by default; I wonder if this will be
7592 Modified: html/biblio.xsl,1.25; html/component.xsl,1.27; html/
7593 division.xsl,1.11; html/formal.xsl,1.19; html/glossary.xsl,1.20; html/
7594 html.xsl,1.13; html/index.xsl,1.16; html/param.ent,1.88; html/
7595 param.xweb,1.97; html/refentry.xsl,1.22; html/sections.xsl,1.30; params/
7596 id.warnings.xml,1.1 - Norman Walsh
7598 • If the keep.relative.image.uris parameter is true, don't use the absolute
7599 URI (as calculated from xml:base) in the img src attribute, us the value
7600 the author specified. Note that we still have to calculate the absolute
7601 filename for use in the image intrinsics extension.
7603 Modified: html/graphics.xsl,1.56 - Norman Walsh
7605 • Support date as an inline
7607 Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh
7609 • Added new parameter keep.relative.image.uris
7611 Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html
7612 /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh
7614 • Added two new parameters for handling of multi-term varlistentry elements:
7616 variablelist.term.break.after: When the variablelist.term.break.after is
7617 non-zero, it will generate a line break after each term multi-term
7620 variablelist.term.separator: When a varlistentry contains multiple term
7621 elements, the string specified in the value of the
7622 variablelist.term.separator parameter is placed after each term except the
7623 last. The default is ", " (a comma followed by a space). To suppress
7624 rendering of the separator, set the value of variablelist.term.separator to
7625 the empty string ("").
7627 These parameters are primarily intended to be useful if you have multi-term
7628 varlistentries that have long terms.
7630 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
7631 long terms" doc that demonstrated the value of having these options.
7633 Also, added normalize-space() call to processing of each term.
7635 This change affects all output formats (HTML, PDF, manpages). The default
7636 behavior should pretty much remain the same as before, but it is possible
7637 (as always) that the change may introduce some new bugginess.
7639 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
7640 lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
7641 lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
7642 variablelist.term.break.after.xml,1.1; params/
7643 variablelist.term.separator.xml,1.1 - Michael(tm) Smith
7645 • Added "wrapper-name" param to inline.charseq named template, enabling it to
7646 output inlines other than just "span". Acronym and Abbrev templates now use
7647 inline.charseq to output HTML "acronym" and "abbr" elements (instead of
7648 "span"). Closes #1305468. Thanks to Sam Steingold for suggesting the
7651 Modified: html/inline.xsl,1.45 - Michael(tm) Smith
7655 The following changes have been made to the manpages code since the 1.69.1
7658 • Added the following params:
7660 - man.indent.width (string-valued) - man.indent.refsect (boolean) -
7661 man.indent.blurbs (boolean) - man.indent.lists (boolean) -
7662 man.indent.verbatims (boolean)
7664 Note that in earlier snapshots, man.indent.width was named
7665 man.indentation.default.value and the boolean params had names like
7666 man.indentation.*.adjust. Also the man.indent.blurbs param was called
7667 man.indentation.authors.adjust (or something).
7669 The behavior now is: If the value of a particular man.indent.* boolean
7670 param is non-zero, the corresponding contents (refsect*, list items,
7671 authorblurb/personblurb, vervatims) are displayed with a left margin
7672 indented by a width equal to the value of man.indent.width.
7674 Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74;
7675 manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
7676 manpages/param.ent,1.22; manpages/param.xweb,1.24; manpages/
7677 refentry.xsl,1.14; params/man.indent.lists.xml,1.1; params/
7678 man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; params/
7679 man.indent.width.xml,1.1 - Michael(tm) Smith
7681 • Added man.table.footnotes.divider param.
7683 In each table that contains footenotes, the string specified by the man.
7684 table.footnotes.divider parameter is output before the list of footnotes
7687 Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; manpages/
7688 param.ent,1.21; manpages/param.xweb,1.23; params/
7689 man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith
7691 • Added the man.output.in.separate.dir, man.output.base.dir, and
7692 man.output.subdirs.enabled parameters.
7694 The man.output.base.dir parameter specifies the base directory into which
7695 man-page files are output. The man.output.subdirs.enabled parameter
7696 controls whether the files are output in subdirectories within the base
7699 The values of the man.output.base.dir and man.output.subdirs.enabled
7700 parameters are used only if the value of man.output.in.separate.dir
7701 parameter is non-zero. If the value of man.output.in.separate.dir is zero,
7702 man-page files are not output in a separate directory.
7704 Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; manpages/
7705 param.xweb,1.22; params/man.output.base.dir.xml,1.1; params/
7706 man.output.in.separate.dir.xml,1.1; params/
7707 man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith
7709 • Added man.font.table.headings and man.font.table.title params, for
7710 controlling font in table headings and titles.
7712 Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; manpages/
7713 param.xweb,1.21; params/man.font.table.headings.xml,1.1; params/
7714 man.font.table.title.xml,1.1 - Michael(tm) Smith
7716 • Added man.font.funcsynopsisinfo and man.font.funcprototype params, for
7717 specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and
7718 funcprototype output.
7720 Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; manpages/
7721 param.ent,1.18; manpages/param.xweb,1.20; manpages/synop.xsl,1.29; manpages
7722 /table.xsl,1.21; params/man.font.funcprototype.xml,1.1; params/
7723 man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith
7725 • Added man.segtitle.suppress param.
7727 If the value of man.segtitle.suppress is non-zero, then display of segtitle
7728 contents is suppressed in output.
7730 Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; manpages/
7731 param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - Michael(tm) Smith
7733 • Added man.output.manifest.enabled and man.output.manifest.filename params.
7735 If man.output.manifest.enabled is non-zero, a list of filenames for man
7736 pages generated by the stylesheet transformation is written to the file
7737 named by man.output.manifest.filename
7739 Modified: manpages/docbook.xsl,1.67; manpages/other.xsl,1.19; manpages/
7740 param.ent,1.16; manpages/param.xweb,1.18; params/
7741 man.output.manifest.enabled.xml,1.1; params/
7742 man.output.manifest.filename.xml,1.1; tools/make/Makefile.DocBook,1.4 -
7745 • Added refentry.meta.get.quietly param.
7747 If zero (the default), notes and warnings about "missing" markup are
7748 generated during gathering of refentry metadata. If non-zero, the metadata
7749 is gathered "quietly" -- that is, the notes and warnings are suppressed.
7751 NOTE: If you are processing a large amount of refentry content, you may be
7752 able to speed up processing significantly by setting a non-zero value for
7753 refentry.meta.get.quietly.
7755 Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/
7756 param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
7759 • Changed names of all boolean indentation params to man.indent.* Also
7760 discarded individual man.indent.*.value params and switched to just using a
7761 common man.indent.width param (3n by default).
7763 Modified: manpages/docbook.xsl,1.66; manpages/info.xsl,1.19; manpages/
7764 lists.xsl,1.29; manpages/other.xsl,1.18; manpages/refentry.xsl,1.13 -
7767 • Added boolean man.output.in.separate.dir param, to control whether or not
7768 man files are output in separate directory.
7770 Modified: manpages/docbook.xsl,1.65; manpages/utility.xsl,1.14 - Michael
7773 • Added options for controlling indentation of verbatim output. Controlled
7774 through the man.indentation.verbatims.adjust and
7775 man.indentation.verbatims.value params. Closes #1242997
7777 Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 - Michael(tm)
7780 • Added options for controlling indentation in lists and in *blurb output in
7781 the AUTHORS section. Controlled through the man.indentation.lists.adjust,
7782 man.indentation.lists.value, man.indentation.authors.adjust, and
7783 man.indentation.authors.value parameters. Default is 3 characters (instead
7784 of the roff default of 8 characters). Closes #1449369.
7786 Also, removed the indent that was being set on informalexample outuput. I
7787 will instead add an option for indenting verbatims, which I think is what
7788 the informalexample indent was intended for originally.
7790 Modified: manpages/block.xsl,1.14; manpages/docbook.xsl,1.63; manpages/
7791 info.xsl,1.18; manpages/lists.xsl,1.28 - Michael(tm) Smith
7793 • Changed line-spacing call before synopfragment to use ".sp -1n" ("n" units
7794 specified) instead of plain ".sp -1"
7796 Modified: manpages/synop.xsl,1.28 - Michael(tm) Smith
7798 • Added support for writing man files into a specific output directory and
7799 into appropriate subdirectories within that output directory. Controlled
7800 through the man.base.dir parameter (similar to the base.dir support in the
7801 HTML stylesheet) and the man.subdirs.enabled parameter, which automatically
7802 determines the name of an appropriate subdir (for example, man/man7, man/
7803 man1, etc.) based on the section number/manvolnum of the source Refentry.
7805 Closes #1255036 and #1170317. Thanks to Denis Bradford for the original
7806 feature request, and to Costin Stroie for submitting a patch that was very
7807 helpful in implementing the support.
7809 Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 - Michael
7812 • Refined XPath statements and notification messages for refentry metadata
7815 Modified: common/common.xsl,1.59; common/refentry.xsl,1.14; manpages/
7816 docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm) Smith
7818 • Added support for copyright and legalnotice. The manpages stylesheets now
7819 output a COPYRIGHT section, after the AUTHORS section, if a copyright or
7820 legalnotice is found in the source. The section contains the copyright
7821 contents followed by the legalnotice contents. Closes #1450209.
7823 Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 - Michael(tm)
7826 • Drastically reworked all of the XPath expressions used in refentry metadata
7827 gathering -- completely removed $parentinfo and turned $info into a set of
7828 nodes that includes the *info contents of the Refentry plus the *info
7829 contents all all of its ancestor elements. The basic XPath expression now
7830 used throughout is (using the example of checking for a date):
7832 (($info[//date])[last()]/date)[1].
7834 That selects the "last" *info/date date in document order -- that is, the
7835 one eitther on the Refentry itself or on the closest ancestor to the
7838 It's likely this change may break some things; may need to pick up some
7841 Also, changed the default value for the man.th.extra2.max.length from 40 to
7844 Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; params/
7845 man.th.extra2.max.length.xml,1.2; params/refentry.date.profile.xml,1.2;
7846 params/refentry.manual.profile.xml,1.2; params/
7847 refentry.source.name.profile.xml,1.2; params/
7848 refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; manpages/
7849 other.xsl,1.15 - Michael(tm) Smith
7851 • Added support for DocBook 5 namespace-stripping in manpages stylesheet.
7852 Closes request #1210692.
7854 Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm)
7857 • Fixed handling of table footnotes. With this checkin, the table support in
7858 the manpages stylesheet is now basically feature complete. So this change
7859 closes request #619532, "No support for tables" -- the oldest currently
7860 open manpages feature request, submitted by Ben Secrest (blsecres) on
7861 2002-10-07. Congratulations to me [patting myself on the back].
7863 Modified: manpages/block.xsl,1.11; manpages/docbook.xsl,1.55; manpages/
7864 table.xsl,1.15 - Michael(tm) Smith
7866 • Added handling for table titles. Also fixed handling of nested tables; nest
7867 tables are now "extracted" and displayed just after their parent tables.
7869 Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14 - Michael(tm)
7872 • Added option for turning off bold formatting in Funcsynopsis. Boldface
7873 formatting in function synopsis is mandated in the man(7) man page and is
7874 used almost universally in existing man pages. Despite that, it really does
7875 look like crap to have an entire Funcsynopsis output in bold, so I added
7876 params for turning off the bold formatting and/or replacing it with a
7877 different roff special font (e.g., "RI" for alternating roman/italic
7878 instead of the default "BI" for alternating bold/italic). The new params
7879 are "man.funcprototype.font" and "man.funcsynopsisinfo.font". To be
7882 Closes #1452247. Thanks to Joe Orton for the feature request.
7884 Modified: params/man.string.subst.map.xml,1.16; manpages/block.xsl,1.10;
7885 manpages/docbook.xsl,1.51; manpages/inline.xsl,1.16; manpages/
7886 synop.xsl,1.27 - Michael(tm) Smith
7888 • Use AUTHORS instead of AUTHOR if we have multiple people to attribute.
7889 Also, fixed checking such that we generate author section even if we don't
7890 have an author (as long as there is at least one other person/entity we can
7891 put in the section). Also adjusted assembly of content for Author metainfo
7892 field such that we now not only use author, but try to find a "best match"
7893 if we can't find an author name to put there.
7895 Closes #1233592. Thanks to Sam Steingold for the request.
7897 Modified: manpages/info.xsl,1.12 - Michael(tm) Smith
7899 • Changes for request #1243027, "Impove handling of AUTHOR section." This
7900 adds support for Collab, Corpauthor, Corpcredt, Orgname, Publishername, and
7901 Publisher. Also adds support for output of Affiliation and its children,
7902 and support for using gentext strings for auto-attributing roles (Author,
7903 Editor, Publisher, Translator, etc.). Also did a lot of code cleanup and
7904 modularization of all the AUTHOR handling code. And fixed a bug that was
7905 causing Author info to not be picked up correctly for metainfo comment we
7906 embed in man-page source.
7908 Modified: manpages/info.xsl,1.11 - Michael(tm) Smith
7910 • Support bold output for "emphasis remap='B'". (because Eric Raymond's
7911 doclifter(1) tool converts groff source marked up with ".B" request or "\
7912 fB" escapes to DocBook "emphasis remap='B'".)
7914 Modified: manpages/inline.xsl,1.14 - Michael(tm) Smith
7916 • Added support for Segmentedlist. Details: Output is tabular, with no option
7917 for "list" type output. Output for Segtitle elements can be supressed by
7918 setting man.segtitle.suppress. If Segtitle content is output, it is
7919 rendered in italic type (not bold because not all terminals support bold
7920 and so italic ensures the stand out on those terminals). Extra space (.sp
7921 line) at end of table code ensures that it gets handled correctly in the
7922 case where its source is the child of a Para. Closes feature-request #
7923 1400097. Thanks to Daniel Leidert for the patch and push, and to Alastair
7924 Rankine for filing the original feature request.
7926 Modified: manpages/lists.xsl,1.23; manpages/utility.xsl,1.10 - Michael(tm)
7929 • Improved handling or Author/Editor/Othercredit.
7931 Reworked content of (non-visible) comment added at top of each page
7934 Added support for generating a manifest file (useful for cleaning up after
7937 Modified: manpages/docbook.xsl,1.46; manpages/info.xsl,1.9; manpages/
7938 other.xsl,1.12; manpages/utility.xsl,1.6 - Michael(tm) Smith
7940 • Added two new parameters for handling of multi-term varlistentry elements:
7942 variablelist.term.break.after: When the variablelist.term.break.after is
7943 non-zero, it will generate a line break after each term multi-term
7946 variablelist.term.separator: When a varlistentry contains multiple term
7947 elements, the string specified in the value of the
7948 variablelist.term.separator parameter is placed after each term except the
7949 last. The default is ", " (a comma followed by a space). To suppress
7950 rendering of the separator, set the value of variablelist.term.separator to
7951 the empty string ("").
7953 These parameters are primarily intended to be useful if you have multi-term
7954 varlistentries that have long terms.
7956 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
7957 long terms" doc that demonstrated the value of having these options.
7959 Also, added normalize-space() call to processing of each term.
7961 This change affects all output formats (HTML, PDF, manpages). The default
7962 behavior should pretty much remain the same as before, but it is possible
7963 (as always) that the change may introduce some new bugginess.
7965 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
7966 lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
7967 lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
7968 variablelist.term.break.after.xml,1.1; params/
7969 variablelist.term.separator.xml,1.1 - Michael(tm) Smith
7973 The following changes have been made to the params code since the 1.69.1
7976 • New parameters to set header/footer table minimum height.
7978 Modified: params/footer.table.height.xml,1.1; params/
7979 header.table.height.xml,1.1 - Robert Stayton
7981 • Support multiple indexing methods for different languages.
7983 Modified: params/index.method.xml,1.1 - Robert Stayton
7985 • Remove qandaset and qandadiv from generate.toc for fo output because
7986 formerly it wasn't working, but now it is and the default behavior should
7989 Modified: params/generate.toc.xml,1.8 - Robert Stayton
7991 • add support for page number references to link element too.
7993 Modified: params/insert.link.page.number.xml,1.1 - Robert Stayton
7995 • Add support for more characters to hyphen on when ulink.hyphenate is turned
7998 Modified: params/ulink.hyphenate.chars.xml,1.1; params/
7999 ulink.hyphenate.xml,1.3 - Robert Stayton
8001 • New attribute-set to format biblioentry and bibliomixed.
8003 Modified: params/biblioentry.properties.xml,1.1 - Robert Stayton
8005 • Added new parameter chunk.tocs.and.lots.has.title which controls presence
8006 of title in a separate chunk with ToC/LoT. Disabling title can be very
8007 useful if you are generating frameset output (well, yes those frames, but
8008 some customers really want them ;-).
8010 Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; html/
8011 param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
8014 • Added new attribute set toc.line.properties for controlling appearance of
8017 Modified: params/toc.line.properties.xml,1.1 - Jirka Kosek
8019 • Allow table footnotes to have different properties from regular footnotes.
8021 Modified: params/table.footnote.properties.xml,1.1 - Robert Stayton
8023 • Set properties for pgwide="1" objects.
8025 Modified: params/pgwide.properties.xml,1.1 - Robert Stayton
8027 • Added the autotoc.label.in.hyperlink param.
8029 If the value of autotoc.label.in.hyperlink is non-zero, labels are included
8030 in hyperlinked titles in the TOC. If it is instead zero, labels are still
8031 displayed prior to the hyperlinked titles, but are not hyperlinked along
8034 Closes patch #1065868. Thanks to anatoly techtonik for the patch.
8036 Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; html/
8037 param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - Michael(tm)
8040 • Added two new params: html.head.legalnotice.link.types and html.head.
8041 legalnotice.link.multiple.
8043 If the value of the generate.legalnotice.link is non-zero, then the
8044 stylesheet generates (in the head section of the HTML source) either a
8045 single HTML link element or, if the value of the html.head.legalnotice.link
8046 .multiple is non-zero, one link element for each link type specified. Each
8047 link has the following attributes:
8049 - a rel attribute whose value is derived from the value of html.head.
8050 legalnotice.link.types
8052 - an href attribute whose value is set to the URL of the file containing
8055 - a title attribute whose value is set to the title of the corresponding
8056 legalnotice (or a title programatically determined by the stylesheet)
8060 <link rel="copyright" href="ln-id2524073.html" title="Legal Notice">
8062 Closes #1476450. Thanks to Sam Steingold.
8064 Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; html/
8065 param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; params/
8066 html.head.legalnotice.link.multiple.xml,1.1; params/
8067 html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith
8069 • Added the following params:
8071 - man.indent.width (string-valued) - man.indent.refsect (boolean) -
8072 man.indent.blurbs (boolean) - man.indent.lists (boolean) -
8073 man.indent.verbatims (boolean)
8075 Note that in earlier snapshots, man.indent.width was named
8076 man.indentation.default.value and the boolean params had names like
8077 man.indentation.*.adjust. Also the man.indent.blurbs param was called
8078 man.indentation.authors.adjust (or something).
8080 The behavior now is: If the value of a particular man.indent.* boolean
8081 param is non-zero, the corresponding contents (refsect*, list items,
8082 authorblurb/personblurb, vervatims) are displayed with a left margin
8083 indented by a width equal to the value of man.indent.width.
8085 Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74;
8086 manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
8087 manpages/param.ent,1.22; manpages/param.xweb,1.24; manpages/
8088 refentry.xsl,1.14; params/man.indent.lists.xml,1.1; params/
8089 man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; params/
8090 man.indent.width.xml,1.1 - Michael(tm) Smith
8092 • Added man.table.footnotes.divider param.
8094 In each table that contains footenotes, the string specified by the man.
8095 table.footnotes.divider parameter is output before the list of footnotes
8098 Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; manpages/
8099 param.ent,1.21; manpages/param.xweb,1.23; params/
8100 man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith
8102 • Added the man.output.in.separate.dir, man.output.base.dir, and
8103 man.output.subdirs.enabled parameters.
8105 The man.output.base.dir parameter specifies the base directory into which
8106 man-page files are output. The man.output.subdirs.enabled parameter
8107 controls whether the files are output in subdirectories within the base
8110 The values of the man.output.base.dir and man.output.subdirs.enabled
8111 parameters are used only if the value of man.output.in.separate.dir
8112 parameter is non-zero. If the value of man.output.in.separate.dir is zero,
8113 man-page files are not output in a separate directory.
8115 Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; manpages/
8116 param.xweb,1.22; params/man.output.base.dir.xml,1.1; params/
8117 man.output.in.separate.dir.xml,1.1; params/
8118 man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith
8120 • Added man.font.table.headings and man.font.table.title params, for
8121 controlling font in table headings and titles.
8123 Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; manpages/
8124 param.xweb,1.21; params/man.font.table.headings.xml,1.1; params/
8125 man.font.table.title.xml,1.1 - Michael(tm) Smith
8127 • Added man.font.funcsynopsisinfo and man.font.funcprototype params, for
8128 specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and
8129 funcprototype output.
8131 Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; manpages/
8132 param.ent,1.18; manpages/param.xweb,1.20; manpages/synop.xsl,1.29; manpages
8133 /table.xsl,1.21; params/man.font.funcprototype.xml,1.1; params/
8134 man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith
8136 • Changed to select="0" in refclass.suppress (instead of ..>0</..)
8138 Modified: params/refclass.suppress.xml,1.3 - Michael(tm) Smith
8140 • Added man.segtitle.suppress param.
8142 If the value of man.segtitle.suppress is non-zero, then display of segtitle
8143 contents is suppressed in output.
8145 Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; manpages/
8146 param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - Michael(tm) Smith
8148 • Added man.output.manifest.enabled and man.output.manifest.filename params.
8150 If man.output.manifest.enabled is non-zero, a list of filenames for man
8151 pages generated by the stylesheet transformation is written to the file
8152 named by man.output.manifest.filename
8154 Modified: manpages/docbook.xsl,1.67; manpages/other.xsl,1.19; manpages/
8155 param.ent,1.16; manpages/param.xweb,1.18; params/
8156 man.output.manifest.enabled.xml,1.1; params/
8157 man.output.manifest.filename.xml,1.1; tools/make/Makefile.DocBook,1.4 -
8160 • Added refclass.suppress param.
8162 If the value of refclass.suppress is non-zero, then display refclass
8163 contents is suppressed in output. Affects HTML and FO output only.
8165 Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html
8166 /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith
8168 • Added refentry.meta.get.quietly param.
8170 If zero (the default), notes and warnings about "missing" markup are
8171 generated during gathering of refentry metadata. If non-zero, the metadata
8172 is gathered "quietly" -- that is, the notes and warnings are suppressed.
8174 NOTE: If you are processing a large amount of refentry content, you may be
8175 able to speed up processing significantly by setting a non-zero value for
8176 refentry.meta.get.quietly.
8178 Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/
8179 param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
8182 • Added support for "software" and "sectdesc" class values on refmiscinfo;
8183 "software" is treated identically to "source", and "setdesc" is treated
8184 identically to "manual".
8186 Modified: common/refentry.xsl,1.10; params/
8187 man.th.extra2.max.length.xml,1.3; params/
8188 refentry.source.name.profile.xml,1.4 - Michael(tm) Smith
8190 • Drastically reworked all of the XPath expressions used in refentry metadata
8191 gathering -- completely removed $parentinfo and turned $info into a set of
8192 nodes that includes the *info contents of the Refentry plus the *info
8193 contents all all of its ancestor elements. The basic XPath expression now
8194 used throughout is (using the example of checking for a date):
8196 (($info[//date])[last()]/date)[1].
8198 That selects the "last" *info/date date in document order -- that is, the
8199 one eitther on the Refentry itself or on the closest ancestor to the
8202 It's likely this change may break some things; may need to pick up some
8205 Also, changed the default value for the man.th.extra2.max.length from 40 to
8208 Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; params/
8209 man.th.extra2.max.length.xml,1.2; params/refentry.date.profile.xml,1.2;
8210 params/refentry.manual.profile.xml,1.2; params/
8211 refentry.source.name.profile.xml,1.2; params/
8212 refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; manpages/
8213 other.xsl,1.15 - Michael(tm) Smith
8215 • Added option for turning off bold formatting in Funcsynopsis. Boldface
8216 formatting in function synopsis is mandated in the man(7) man page and is
8217 used almost universally in existing man pages. Despite that, it really does
8218 look like crap to have an entire Funcsynopsis output in bold, so I added
8219 params for turning off the bold formatting and/or replacing it with a
8220 different roff special font (e.g., "RI" for alternating roman/italic
8221 instead of the default "BI" for alternating bold/italic). The new params
8222 are "man.funcprototype.font" and "man.funcsynopsisinfo.font". To be
8225 Closes #1452247. Thanks to Joe Orton for the feature request.
8227 Modified: params/man.string.subst.map.xml,1.16; manpages/block.xsl,1.10;
8228 manpages/docbook.xsl,1.51; manpages/inline.xsl,1.16; manpages/
8229 synop.xsl,1.27 - Michael(tm) Smith
8231 • fop.extensions now only for FOP version 0.20.5 and earlier.
8233 Modified: params/fop.extensions.xml,1.4 - Robert Stayton
8235 • Support for fop1 different from fop 0.20.5 and earlier.
8237 Modified: params/fop1.extensions.xml,1.1 - Robert Stayton
8239 • Reset default value to empty string so template uses gentext first, then
8240 the parameter value if not empty.
8242 Modified: params/index.number.separator.xml,1.2; params/
8243 index.range.separator.xml,1.2; params/index.term.separator.xml,1.2 - Robert
8246 • New parameter: id.warnings. If non-zero, warnings are generated for titled
8247 objects that don't have titles. True by default; I wonder if this will be
8250 Modified: html/biblio.xsl,1.25; html/component.xsl,1.27; html/
8251 division.xsl,1.11; html/formal.xsl,1.19; html/glossary.xsl,1.20; html/
8252 html.xsl,1.13; html/index.xsl,1.16; html/param.ent,1.88; html/
8253 param.xweb,1.97; html/refentry.xsl,1.22; html/sections.xsl,1.30; params/
8254 id.warnings.xml,1.1 - Norman Walsh
8256 • Added new parameter keep.relative.image.uris
8258 Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html
8259 /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh
8261 • Support default label width parameters for itemized and ordered lists
8263 Modified: fo/lists.xsl,1.64; fo/param.ent,1.90; fo/param.xweb,1.103; params
8264 /itemizedlist.label.width.xml,1.1; params/orderedlist.label.width.xml,1.1 -
8267 • Added parameters to localize punctuation in indexes.
8269 Modified: params/index.number.separator.xml,1.1; params/
8270 index.range.separator.xml,1.1; params/index.term.separator.xml,1.1 - Robert
8273 • Added two new parameters for handling of multi-term varlistentry elements:
8275 variablelist.term.break.after: When the variablelist.term.break.after is
8276 non-zero, it will generate a line break after each term multi-term
8279 variablelist.term.separator: When a varlistentry contains multiple term
8280 elements, the string specified in the value of the
8281 variablelist.term.separator parameter is placed after each term except the
8282 last. The default is ", " (a comma followed by a space). To suppress
8283 rendering of the separator, set the value of variablelist.term.separator to
8284 the empty string ("").
8286 These parameters are primarily intended to be useful if you have multi-term
8287 varlistentries that have long terms.
8289 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
8290 long terms" doc that demonstrated the value of having these options.
8292 Also, added normalize-space() call to processing of each term.
8294 This change affects all output formats (HTML, PDF, manpages). The default
8295 behavior should pretty much remain the same as before, but it is possible
8296 (as always) that the change may introduce some new bugginess.
8298 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
8299 lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
8300 lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
8301 variablelist.term.break.after.xml,1.1; params/
8302 variablelist.term.separator.xml,1.1 - Michael(tm) Smith
8304 • Convert 'no' to string in default value.
8306 Modified: params/olink.doctitle.xml,1.4 - Robert Stayton
8308 • Implemented RFE #1292615.
8310 Added bunch of new parameters (attribute sets) that affect list
8311 presentation: list.block.properties, itemizedlist.properties, orderedlist
8312 .properties, itemizedlist.label.properties and orderedlist.label
8313 .properties. Default behaviour of stylesheets has not been changed but
8314 further customizations will be much more easier.
8316 Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; params/
8317 itemizedlist.label.properties.xml,1.1; params/
8318 itemizedlist.properties.xml,1.1; params/list.block.properties.xml,1.1;
8319 params/orderedlist.label.properties.xml,1.1; params/
8320 orderedlist.properties.xml,1.1 - Jirka Kosek
8322 • Implemented RFE #1242092.
8324 You can enable crop marks in your document by setting crop.marks=1 and
8325 xep.extensions=1. Appearance of crop marks can be controlled by parameters
8326 crop.mark.bleed (6pt), crop.mark.offset (24pt) and crop.mark.width (0.5pt).
8328 Also there is new named template called user-xep-pis. You can overwrite it
8329 in order to produce some PIs that can control XEP as described in http://
8330 www.renderx.com/reference.html#Output_Formats
8332 Modified: fo/docbook.xsl,1.36; fo/param.ent,1.86; fo/param.xweb,1.97; fo/
8333 xep.xsl,1.23; params/crop.mark.bleed.xml,1.1; params/
8334 crop.mark.offset.xml,1.1; params/crop.mark.width.xml,1.1; params/
8335 crop.marks.xml,1.1 - Jirka Kosek
8337 • Changed short descriptions in doc for *autolabel* params to match new
8340 Modified: params/appendix.autolabel.xml,1.5; params/
8341 chapter.autolabel.xml,1.4; params/part.autolabel.xml,1.5; params/
8342 preface.autolabel.xml,1.4 - Michael(tm) Smith
8346 The following changes have been made to the profiling code since the 1.69.1
8349 • Profiling now works together with namespace stripping (V5 documents).
8350 Namespace striping should work with all stylesheets named profile-, even if
8351 they are not supporting namespace stripping in a non-profiling variant.
8353 Modified: profiling/profile-mode.xsl,1.4; profiling/xsl2profile.xsl,1.7 -
8356 • Moved profiling stage out of templates. This make possible to reuse
8357 profiled content by several templates and still maintaing node indentity
8358 (needed for example for HTML Help where content is processed multiple
8361 I don't know why this was not on the top level before. Maybe some XSLT
8362 processors choked on it. I hope this will be OK now.
8364 Modified: profiling/xsl2profile.xsl,1.5 - Jirka Kosek
8368 The following changes have been made to the tools code since the 1.69.1
8371 • Moved Makefile.DocBook from contrib module to xsl module.
8373 Modified: tools/make/Makefile.DocBook,1.1 - Michael(tm) Smith
8377 The following changes have been made to the wordml code since the 1.69.1
8380 • added contrib element, better handling of default paragraph style
8382 Modified: wordml/pages-normalise.xsl,1.6; wordml/supported.xml,1.2; wordml/
8383 wordml-final.xsl,1.14 - Steve Ball
8387 Modified: wordml/docbook-pages.xsl,1.6; wordml/docbook.xsl,1.17; wordml/
8388 pages-normalise.xsl,1.5; wordml/template-pages.xml,1.7; wordml/
8389 template.dot,1.4; wordml/template.xml,1.14; wordml/wordml-final.xsl,1.13 -
8392 • added blocks stylesheet to support bibliographies, glossaries and qandasets
8394 Modified: wordml/Makefile,1.4; wordml/README,1.3; wordml/
8395 blocks-spec.xml,1.1; wordml/docbook-pages.xsl,1.5; wordml/docbook.xsl,1.16;
8396 wordml/pages-normalise.xsl,1.4; wordml/sections-spec.xml,1.3; wordml/
8397 specifications.xml,1.13; wordml/template-pages.xml,1.6; wordml/
8398 template.dot,1.3; wordml/template.xml,1.13; wordml/wordml-blocks.xsl,1.1;
8399 wordml/wordml-final.xsl,1.12; wordml/wordml-sections.xsl,1.3 - Steve Ball
8401 • added mediaobject caption
8403 Modified: wordml/docbook-pages.xsl,1.4; wordml/docbook.xsl,1.15; wordml/
8404 specifications.xml,1.12; wordml/template-pages.xml,1.5; wordml/
8405 template.dot,1.2; wordml/template.xml,1.12; wordml/wordml-final.xsl,1.11 -
8410 Modified: wordml/docbook-pages.xsl,1.3; wordml/docbook.xsl,1.14; wordml/
8411 pages-normalise.xsl,1.3; wordml/specifications.xml,1.11; wordml/
8412 template-pages.xml,1.4; wordml/wordml-final.xsl,1.10 - Steve Ball
8414 • added Word template file
8416 Modified: wordml/template.dot,1.1 - Steve Ball
8418 • added abstract, fixed itemizedlist, ulink
8420 Modified: wordml/specifications.xml,1.10; wordml/wordml-final.xsl,1.9 -
8423 • fixed Makefile added many features to Pages support added revhistory,
8424 inlines, highlights, abstract
8426 Modified: wordml/Makefile,1.2; wordml/docbook-pages.xsl,1.2; wordml/
8427 pages-normalise.xsl,1.2; wordml/sections-spec.xml,1.2; wordml/
8428 specifications.xml,1.9; wordml/template-pages.xml,1.3; wordml/
8429 template.xml,1.11; wordml/wordml-final.xsl,1.8; wordml/
8430 wordml-sections.xsl,1.2 - Steve Ball
8432 • fixed handling linebreaks when generating WordML added Apple Pages support
8434 Modified: wordml/docbook.xsl,1.13; wordml/template-pages.xml,1.2 - Steve
8439 This release is a minor bug-fix update to the 1.69.0 release. Along with bug
8440 fixes, it includes one configuration-parameter change: The default value of the
8441 annotation.support parameter is now 0 (off). The reason for that change is that
8442 there have been reports that annotation handling is causing a significant
8443 performance degradation in processing of large documents with xsltproc.
8447 The release includes major feature changes, particularly in the manpages
8448 stylesheets, as well as a large number of bug fixes.
8450 As with all DocBook Project “dot zero” releases, this is an experimental
8455 • This release adds localizations for the following languages: Albanian,
8456 Amharic, Azerbaijani, Hindi, Irish (Gaelic), Gujarati, Kannada, Mongolian,
8457 Oriya, Punjabi, Tagalog, Tamil, and Welsh.
8459 • Added support for specifying number format for auto labels for chapter,
8460 appendix, part, and preface. Contolled with the appendix.autolabel,
8461 chapter.autolabel, part.autolabel, and preface.autolabel parameters.
8463 • Added basic support for biblioref cross referencing.
8465 • Added support for align on caption in mediaobject.
8467 • Added support for processing documents that use the DocBook V5 namespace.
8469 • Added support for termdef and mathphrase.
8471 • EXPERIMENTAL: Incorporated the Slides and Website stylesheets into the
8472 DocBook XSL stylesheets package. So, for example, Website documents can now
8473 be processed using the following URI for the driver Website tabular.xsl
8476 http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl
8478 • A procedure without a title is now treated as an “informal” procedure
8479 (meaning that it is not added to any generated “list of procedures” and has
8480 no affect on numbering of generated labels for other procedures).
8482 • docname is no longer added to olink when pointing to a root element.
8484 • Added support for generation of choice separator in inline simplelist. This
8485 enables auto-generation of an appropriate localized “choice separator” (for
8486 example, “and” or “or”) before the final item in an inline simplelist.
8488 To indicate that you want a choice separator generated for a particular
8489 list, you need to put a processing instruction (PI) of the form <?
8490 dbchoice choice="foo"?> as a child of the list. For example:
8493 ONE and ONLY ONE of the following:
8494 <simplelist type="inline">
8495 <?dbchoice choice="or" ?>
8498 <member>C</member>.</simplelist></para>
8500 Output (for English):
8502 Choose from ONE and only ONE of the following choices: A, B, or C.
8504 As a temporary workaround for the fact that most of the DocBook non-English
8505 locale files don't have a localization for the word “or”, you can put in a
8506 literal string to be used; example for French: <?dbchoice choice="ou">.
8507 That is, use “ou” instead of “or”.
8511 • Added content-type property to external-graphic element, based on imagedata
8514 • Added support for generating <rx:meta-field creator="$VERSION"/> field for
8515 XEP output. This makes the DocBook XSL stylesheet version information
8516 available through the Document Properties menu in Acrobat Reader and other
8519 • Trademark symbol handling made consistent with handling of same in HTML
8520 stylesheets. Prior to this change, if you processed a document that
8521 contained no value for the class attribute on the trademark element, the
8522 HTML stylesheets would default to rendering a superscript TM symbol after
8523 the trademark contents, but the FO stylesheets would render nothing.
8525 • Added support for generating XEP bookmarks for refentry.
8527 • Added support for HTML markup table border attribute, applied to each table
8530 • The table.width template can now sum column specs if none use % or *.
8532 • Added fox:destination extension inside fox:outline to support linking to
8533 internal destinations.
8535 • Added support for customizing abstract with property sets. Controlled with
8536 the abstract.properties and abstract.title.properties parameters.
8538 • Add footnotes in table title to table footnote set, and add support for
8539 table footnotes to HTML table markup.
8541 • Added support for title in glosslist.
8543 • Added support for itemizedlist symbol none.
8545 • Implemented the new graphical.admonition.properties and
8546 nongraphical.admonition.properties attribute sets.
8548 • Added id to formalpara and some other blocks that were missing it.
8550 • Changed the anchor template to output fo:inline instead of fo:wrapper.
8552 • Added support for toc.max.depth parameter.
8556 • Eclipse Help: Added support for generating olink database.
8560 • Added a first cut at support in HTML output for DocBook 5 style annotation
8561 s. Controlled using the annotation.support parameter, and implemented using
8562 JavaScript and CSS styling. For more details, see the documentation for the
8563 annotation.js, annotation.css, annotation.graphic.open, and
8564 annotation.graphic.close parameters.
8566 • Generate client-side image map for imageobjectco with areas using calspair
8569 • Added support for <?img.src.path?> PI.
8571 • Added support for passing img.src.path to DocBook Java XSLT image
8572 extensions when appropriate. Controlled using the
8573 graphicsize.use.img.src.path parameter.
8575 • Added support for (not valid for DocBook 4) xlink:href on area and (not
8576 valid for DocBook 4) alt in area.
8578 • Added new parameter default.table.frame to control table framing if there
8579 is no frame attribute on a table.
8581 • Added initial, experimental support for generating content for the HTML
8582 title attribute from content of the alt element. This change adds support
8583 for the following inline elements only (none of them are block elements):
8584 abbrev, accel, acronym, action, application, authorinitials, beginpage,
8585 citation, citerefentry, citetitle, city, classname, code, command,
8586 computeroutput, constant, country, database, email, envar, errorcode,
8587 errorname, errortext, errortype, exceptionname, fax, filename, firstname,
8588 firstterm, foreignphrase, function, glossterm, guibutton, guiicon, guilabel
8589 , guimenu, guimenuitem, guisubmenu, hardware, honorific, interface,
8590 interfacename, keycap, keycode, keysym, lineage, lineannotation, literal,
8591 markup, medialabel, methodname, mousebutton, option, optional, otheraddr,
8592 othername, package, parameter, personname, phone, pob, postcode,
8593 productname, productnumber, prompt, property, quote, refentrytitle, remark,
8594 replaceable, returnvalue, tag, shortcut, state, street, structfield,
8595 structname, subscript, superscript, surname, symbol, systemitem, tag,
8596 termdef, token, trademark, type, uri, userinput, varname, and wordasword
8598 • Added support for chunking revhistory into separate file (similar to the
8599 support for doing same with legalnotice). Patch from Thomas Schraitle.
8600 Controlled through new generate.revhistory.link parameter.
8602 • l10n.xsl: Made language codes RFC compliant. Added a new boolean config
8603 parameter, l10n.lang.value.rfc.compliant. If it is non-zero (the default),
8604 any underscore in a language code will be converted to a hyphen in HTML
8605 output. If it is zero, the language code will be left as-is.
8609 This release closes out 44 manpages stylesheet bug reports and feature
8610 requests. It adds more than 35 new configuration parameters for controlling
8611 aspects of man-page output -- including hyphenation and justification, handling
8612 of links, conversion of Unicode characters, and contents of man-page headers
8615 • New options for globally disabling/enabling hyphenation and justification:
8616 man.justify and man.hyphenate.
8618 Note that the default for the both of those is zero (off), because
8619 justified text looks good only when it is also hyphenated; to quote the
8620 “Hyphenation” node from the groff info page:
8622 Since the odds are not great for finding a set of words, for every
8623 output line, which fit nicely on a line without inserting excessive
8624 amounts of space between words, `gtroff' hyphenates words so that it
8625 can justify lines without inserting too much space between words.
8627 The problem is that groff can end up hyphenating a lot of things that you
8628 don't want hyphenated (variable names and command names, for example).
8629 Keeping both justification and hyphenation disabled ensures that hyphens
8630 won't get inserted where you don't want to them, and you don't end up with
8631 lines containing excessive amounts of space between words. These default
8632 settings run counter to how most existing man pages are formatted. But
8633 there are some notable exceptions, such as the perl man pages.
8635 • Added parameters for controlling hyphenation of computer inlines,
8636 filenames, and URLs. By default, even when hyphenation is enabled
8637 (globally), hyphenation is now suppressed for "computer inlines"
8638 (currently, just classname, constant, envar, errorcode, option, replaceable
8639 , userinput, type, and varname, and for filenames, and for URLs from link.
8640 It can be (re)enabled using the man.hyphenate.computer.inlines,
8641 man.hyphenate.filenames, and man.hyphenate.urls parameters.
8643 • Implemented a new system for replacing Unicode characters. There are two
8644 parts to the new system: a “string substitution map” for doing “essential”
8645 replacements, and a “character map” that can optionally be disabled and
8648 The new system fixes all open bugs that had to do with literal Unicode
8649 numbered entities such as “ and ” showing up in output, and
8650 greatly expands the ability of the stylesheets to generate “good” roff
8651 equivalents for Unicode symbols and special characters.
8653 Here are some details...
8655 The previous manpages mechanism for replacing Unicode symbols and special
8656 characters with roff equivalents (the replace-entities template) was not
8657 scalable and not complete. The mechanism handled a somewhat arbitrary
8658 selection of less than 20 or so Unicode characters. But there are
8659 potentially more than 800 Unicode special characters that have some groff
8660 equivalent they can be mapped to. And there are about 34 symbols in the
8661 Latin-1 (ISO-8859-1) block alone. Users might reasonably expect that if
8662 they include any of those Latin-1 characters in their DocBook source
8663 documents, they will get correctly converted to known roff equivalents in
8666 In addition to those common symbols, certain users may have a need to use
8667 symbols from other Unicode blocks. Say, somebody who is documenting an
8668 application related to math might need to use a bunch of symbols from the
8669 “Mathematical Operators” Unicode block (there are about 65 characters in
8670 that block that have reasonable roff equivalents). Or somebody else might
8671 really like Dingbats -- such as the checkmark character -- and so might use
8672 a bunch of things from the “Dingbat” block (141 characters in that that
8673 have roff equivalents or that can at least be “degraded” somewhat
8674 gracefully into roff).
8676 So, the old replace-entities mechanism was replaced with a completely
8677 different mechanism that is based on use of two “maps”: a “substitution
8678 map” and a “character map” (the latter in a format compliant with the XSLT
8679 2.0 spec and therefore completely “forward compatible” with XSLT 2.0).
8681 The substitution map is controlled through the man.string.subst.map
8682 parameter, and is used to replace things like the backslash character
8683 (which needs special handling to prevent it from being interpreted as a
8684 roff escape). The substitution map cannot be disabled, because disabling it
8685 will cause the output to be broken. However, you can add to it and change
8688 The “character map” mechanism, on the other hand, can be completely
8689 disabled. It is enabled by default, and, by default, does replacement of
8690 all Latin-1 symbols, along with most special spaces, dashes, and quotes
8691 (about 75 characters by default). Also, you can optionally enable a “full”
8692 character map that provides support for converting all 800 or so of the
8693 characters that have some reasonable groff equivalent.
8695 The character-map mechanism is controlled through the following parameters:
8699 turns character-map support on/off
8701 man.charmap.use.subset
8703 specifies that a subset of the character map is used instead of the
8706 man.charmap.subset.profile
8708 specifies profile of character-map subset
8712 specifies an alternate character map to use instead of the “standard”
8713 character map provided in the distribution
8715 • Implemented out-of-line handling of display of URLs for links (currently,
8716 only for ulink). This gives you three choices for handling of links:
8718 1. Number and list links. Each link is numbered inline, with a number in
8719 square brackets preceding the link contents, and a numbered list of all
8720 links is added to the end of the document.
8722 2. Only list links. Links are not numbered, but an (unnumbered) list of
8723 links is added to the end of the document.
8725 3. Suppress links. Don't number links and don't add any list of links to
8726 the end of the document.
8728 You can also choose whether links should be underlined. The default is “the
8729 works” -- list, number, and underline links. You can use the
8730 man.links.list.enabled, man.links.are.numbered, and
8731 man.links.are.underlined parameters to change the defaults. The default
8732 heading for the link list is REFERENCES. You can be change that using the
8733 man.links.list.heading parameter.
8735 • Changed default output encoding to UTF-8. This does not mean that man pages
8736 are output in raw UTF-8, because the character map is applied before final
8737 output, causing all UTF-8 characters covered in the map to be converted to
8740 • Added support for processing refsect3 and formalpara and nested refsection
8741 elements, down to any arbitrary level of nesting.
8743 • Output of the NAME and SYNOPSIS and AUTHOR headings and the headings for
8744 admonitions (note, caution, etc.) are no longer hard-coded for English.
8745 Instead, headings are generated for those in the correct locale (just as
8746 the FO and HTML stylesheets do).
8748 • Re-worked mechanism for assembling page headers/footers (the contents of
8749 the .TH macro “title line”).
8751 Here are some details...
8753 All man pages contain a .TH roff macro whose contents are used for
8754 rendering the “title line” displayed in the header and footer of each page.
8755 Here are a couple of examples of real-world man pages that have useful page
8758 gtk-options(7) GTK+ User's Manual gtk-options(7) <-- header
8759 GTK+ 1.2 2003-10-20 gtk-options(7) <-- footer
8761 svgalib(7) Svgalib User Manual svgalib(7) <-- header
8762 Svgalib 1.4.1 16 December 1999 svgalib(7) <-- footer
8764 And here are the terms with which the groff_man(7) man page refers to the
8765 various parts of the header/footer:
8767 title(section) extra3 title(section) <- header
8768 extra2 extra1 title(section) <- footer
8770 Or, using the names with which the man(7) man page refers to those same
8773 title(section) manual title(section) <- page header
8774 source date title(section) <- page footer
8776 The easiest way to control the contents of those fields is to mark up your
8777 refentry content like the following (note that this is a “minimal”
8782 <date>2003-10-20</date> 1
8785 <refentrytitle>gtk-options</refentrytitle> 2
8786 <manvolnum>7</manvolnum> 3
8787 <refmiscinfo class="source-name">GTK+</refmiscinfo> 4
8788 <refmiscinfo class="version">1.2</refmiscinfo> 5
8789 <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> 6
8792 <refname>gtk-options</refname>
8793 <refpurpose>Standard Command Line Options for GTK+ Programs</refpurpose>
8796 <title>Description</title>
8797 <para>This manual page describes the command line options, which
8798 are common to all GTK+ based applications.</para>
8802 1 Sets the “date” part of the header/footer.
8804 2 Sets the “title” part.
8806 3 Sets the “section” part.
8808 4 Sets the “source name” part.
8810 5 Sets the “version” part.
8812 6 Sets the “manual” part.
8814 Below are explanations of the steps the stylesheets take to attempt to
8815 assemble and display “good” headers and footer. [In the descriptions, note
8816 that *info is the refentry “info” child (whatever its name), and parentinfo
8817 is the “info” child of its parent (again, whatever its name).]
8821 Content of the “extra1” field is what shows up in the center footer
8822 position of each page. The man(7) man page describes it as “the date of
8825 To provide this content, if the refentry.date.profile.enabled is
8826 non-zero, the stylesheets check the value of refentry.date.profile.
8828 Otherwise, by default, they check for a date or pubdate not only in the
8829 *info contents, but also in the parentinfo contents.
8831 If a date cannot be found, the stylesheets now automatically generate a
8832 localized “long format” date, ensuring that this field always has
8835 However, if for some reason you want to suppress this field, you can do
8836 so by setting a non-zero value for man.th.extra1.suppress.
8838 extra2 field (source)
8840 On Linux systems and on systems with a modern groff, the content of the
8841 “extra2” field are what shows up in the left footer position of each
8844 The man(7) man page describes this as “the source of the command”, and
8845 provides the following examples:
8847 ☆ For binaries, use somwething like: GNU, NET-2, SLS Distribution,
8850 ☆ For system calls, use the version of the kernel that you are
8851 currently looking at: Linux 0.99.11.
8853 ☆ For library calls, use the source of the function: GNU, BSD 4.3,
8856 In practice, there are many pages that simply have a version number in
8857 the “source” field. So, it looks like what we have is a two-part field,
8858 Name Version, where:
8862 product name (e.g., BSD) or org. name (e.g., GNU)
8868 Each part is optional. If the Name is a product name, then the Version
8869 is probably the version of the product. Or there may be no Name, in
8870 which case, if there is a Version, it is probably the version of the
8871 item itself, not the product it is part of. Or, if the Name is an
8872 organization name, then there probably will be no Version.
8874 To provide this content, if the refentry.source.name.profile.enabled
8875 and refentry.version.profile.enabled parameter are non-zero, the
8876 stylesheets check the value of refentry.source.name.profile
8877 refentry.version.profile.
8879 Otherwise, by default, they check the following places, in the
8882 1. *info/productnumber
8884 2. *info/productnumber
8886 3. refmeta/refmiscinfo[@class = 'version']
8888 4. parentinfo/productnumber
8890 5. *info/productname
8892 6. parentinfo/productname
8894 7. refmeta/refmiscinfo
8896 8. [nothing found, so leave it empty]
8900 On Linux systems and on systems with a modern groff, the content of the
8901 “extra3” field are what shows up in the center header position of each
8902 page. Some man pages have “extra2” content, some don't. If a particular
8903 man page has it, it is most often “context” data about some larger
8904 system the documented item belongs to (for example, the name or
8905 description of a group of related applications). The stylesheets now
8906 check the following places, in the following order, to look for content
8907 to add to the “extra3” field.
8913 3. refmeta/refmiscinfo
8915 4. [nothing found, so leave it empty]
8917 • Reworked *info gathering. For each refentry found, the stylesheets now
8918 cache its *info content, then check for any valid parent of it that might
8919 have metainfo content and cache that, if found; they then then do all
8920 further matches against those node-sets (rather than re-selecting the
8921 original *info nodes each time they are needed).
8923 • New option for breaking strings after forward slashes. This enables long
8924 URLs and pathnames to be broken across lines. Controlled through
8925 man.break.after.slash parameter.
8927 • Output for servicemark and trademark are now (SM) and (TM). There is a
8928 groff "\(tm" escape, but output from that is not acceptable.
8930 • New option for controlling the length of the title part of the .TH title
8931 line. Controlled through the man.th.title.max.length parameter.
8933 • New option for specifying output encoding of each man page; controlled with
8934 man.output.encoding (similar to the HTML chunker.output.encoding
8937 • New option for suppressing filename messages when generating output;
8938 controlled with man.output.quietly (similar to the HTML chunk.quietly
8941 • The text of cross-references to first-level refentry (refsect1, top-level
8942 refsection, refnamediv, and refsynopsisdiv) are now capitalized.
8944 • Cross-references to refnamediv now use the localized NAME title instead of
8945 using the first refname child. This makes the output inconsistent with HTML
8946 and FO output, but for man-page output, it seems to make better sense to
8947 have the NAME. (It may actually make better sense to do it that way in HTML
8948 and FO output as well...)
8950 • Added support for processing funcparams.
8952 • Removed the space that was being output between funcdef and paramdef;
8953 example: was: float rand (void); now: float rand(void)
8955 • Turned off bold formatting for the type element when it occurs within a
8958 • Corrected rendering of simplelist. Any <simplelist type="inline" instance
8959 is now rendered as a comma-separated list (also with an optional localized
8960 “and” or “or” before the last item -- see description elsewhere in these
8961 release notes). Any simplelist instance whose type is not inline is
8962 rendered as a one-column vertical list (ignoring the values of the type and
8963 columns attributes if present)
8965 • Comment added at top of roff source for each page now includes DocBook XSL
8966 stylesheets version number (as in the HTML stylesheets)
8968 • Made change to prevent “sticky” fonts changes. Now, when the manpages
8969 stylesheets encounter node sets that need to be boldfaced or italicized,
8970 they put the \fBfoo\fR and \fIbar\fR groff bold/italic instructions
8971 separately around each node in the set.
8973 • synop.xsl: Boldface everything in funcsynopsis output except parameters
8974 (which are in ital). The man(7) man page says:
8976 For functions, the arguments are always specified using italics, even
8977 in the SYNOPSIS section, where the rest of the function is specified in
8980 A look through the contents of the man/man2 directory shows that most (all)
8981 existing pages do follow this “everything in funcsynopsis bold” rule. That
8982 means the type content and any punctuation (parens, semicolons, varargs)
8983 also must be bolded.
8985 • Removed code for adding backslashes before periods/dots in roff source,
8986 because backslashes in front of periods/dots in roff source are needed only
8987 in the very rare case where a period is the very first character in a line,
8988 without any space in front of it. A better way to deal with that rare case
8989 is for you to add a zero-width space in front of the offending dot(s) in
8992 • Removed special handling of the quote element. That was hard-coded to cause
8993 anything marked up with the quote element to be output preceded by two
8994 backticks and followed by two apostrophes -- that is, that old-school
8995 kludge for generating “curly” quotes in Emacs and in X-Windows fonts. While
8996 Emacs still seems to support that, I don't think X-Windows has for a long
8997 time now. And, anyway, it looks (and has always looked) like crap when
8998 viewed on a normal tty/console. In addition, it breaks localiztion of quote
8999 . By default, quote content is output with localized quotation marks,
9000 which, depending on the locale, may or may not be left and right double
9003 • Changed mappings for left and right single quotation marks. Those had
9004 previously been incorrectly mapped to the backtick (`) and apostrophe
9005 (&39;) characters (for kludgy reasons -- see above). They are now correctly
9006 mapped to the \(oq and \(cq roff escapes. If you want the old (broken)
9007 behavior, you need to manually change the mappings for those in the value
9008 of the man.string.subst.map parameter.
9010 • Removed xref.xsl file. Now, of the various cross-reference elements, only
9011 the ulink element is handled differently; the rest are handled exactly as
9012 the HTML stylesheets handle them, except that no hypertext links are
9013 generated. (Because there is no equivalent hypertext mechanism is man
9016 • New option for making “subheading dividers” in generated roff source. The
9017 dividers are not visible in the rendered man page; they are just there to
9018 make the source readable. Controlled using man.subheading.divider.
9020 • Fixed many places where too much space was being added between lines.
9024 The release adds localization support for Farsi (thanks to Sina Heshmati) and
9025 improved support for the XLink-based DocBook NG db:link element. Other than
9026 that, it is a minor bug-fix update to the 1.68.0 release. The main thing it
9027 fixes is a build error that caused the XSLT Java extensions to be jarred up
9028 with the wrong package structure. Thanks to Jens Stavnstrup for quickly
9029 reporting the problem, and to Mauritz Jeanson for investigating and finding the
9034 This release includes some features changes, particularly for FO/PDF output,
9035 and a number of bug fixes.
9039 • Moved footnote properties to attribute-sets.
9041 • Added support for side floats, margin notes, and custom floats.
9043 • Added new parameters body.start.indent and body.end.indent to the
9044 set.flow.properties template.
9046 • Added support for xml:id
9048 • Added support for refdescriptor.
9050 • Added support for multiple refnamedivs.
9052 • Added index.entry.properties attribute-set to support customization of
9055 • Added set.flow.properties template call to each fo:flow to support
9056 customizations entry point.
9058 • Add support for @floatstyle in figure
9060 • Moved hardcoded properties for index division titles to the
9061 index.div.title.properties attribute-set.
9063 • Added support for table-layout="auto" for XEP.
9065 • Added index.div.title.properties attribute-set.
9067 • $verbose parameter is now passed to most elements.
9069 • Added refentry to toc in part, as it is permitted by the DocBook schema/
9072 • Added backmatter elements and article to toc in part, since they are
9073 permitted by the DocBook schema/DTD.
9075 • Added mode="toc" for simplesect, since it is now permitted in the toc if
9076 simplesect.in.toc is set.
9078 • Moved hard-coded properties to nongraphical.admonintion.properties and
9079 graphical.admonition.properties attribute sets.
9081 • Added support for sidebar-width and float-type processing instructions in
9084 • For tables with HTML markup elements, added support for dbfo bgcolor PI,
9085 the attribute-sets named table.properties, informaltable.properties,
9086 table.table.properties, and table.cell.padding. Also added support for the
9087 templates named table.cell.properties and table.cell.block.properties so
9088 that tabstyles can be implemented. Also added support for tables containing
9089 only tr instead of tbody with tr.
9091 • Added new paramater hyphenate.verbatim.characters which can specify
9092 characters after which a line break can occur in verbatim environments.
9093 This parameter can be used to extend the initial set of characters which
9094 contain only space and non-breakable space.
9096 • Added itemizedlist.label.markup to enable selection of different bullet
9097 symbol. Also added several potential bullet characters, commented out by
9100 • Enabled all id's in XEP output for external olinking.
9104 • Added support for refdescriptor.
9106 • Added support for multiple refnamedivs.
9108 • Added support for xml:id
9110 • refsynopsisdiv as a section for counting section levels
9114 • Added new SVG admonition graphics and navigation images.
9118 This release fixes a table bug introduced in the 1.67.1 release.
9122 This release includes a number of bug fixes.
9124 The following lists provide details about API and feature changes.
9128 • Tables: Inherited cell properties are now passed to the
9129 table.cell.properties template so they can be overridden by a
9132 • Tables: Added support for bgcolor PI on table row element.
9134 • TOCs: Added new parameter simplesect.in.toc; default value of 0 causes
9135 simplesect to be omitted from TOCs; to cause simplesect to be included in
9136 TOCs, you must set the value of simplesect.in.toc to 1.Comment from Norm:
9138 Simplesect elements aren't supposed to appear in the ToC at all... The
9139 use case for simplesect is when, for example, every chapter in a book
9140 ends with "Exercises" or "For More Information" sections and you don't
9141 want those to appear in the ToC.
9143 • Sections: Reverted change that caused a variable reference to be used in a
9144 template match and rewrote code to preserve intended semantics.
9146 • Lists: Added workaround to prevent "* 0.60 + 1em" garbage in list output
9149 • Moved the literal attributes from component.title to the
9150 component.title.properties attribute-set so they can be customized.
9152 • Lists: Added glossdef's first para to special handling in
9157 • TOCs: Added new parameter simplesect.in.toc; for details, see the list of
9158 FO changes for this release.
9160 • Indexing: Added new parameter index.prefer.titleabbrev; when set to 1,
9161 index references will use titleabbrev instead of title when available.
9165 • Added support for generating windows-1252-encoded output using Saxon; for
9166 more details, see the list of XSL Java extensions changes for this release.
9170 • Replaced named/numeric character-entity references for non-breaking space
9171 with groff equivalent (backslash-tilde).
9175 • Saxon extensions: Added the Windows1252 class. It extends Saxon 6.5.x with
9176 the windows-1252 character set, which is particularly useful when
9177 generating HTML Help for Western European Languages (code from Pontus
9178 Haglund and contributed to the DocBook community by Sectra AB, Sweden).
9182 1. Make sure that the Saxon 6.5.x jar file and the jar file for the
9183 DocBook XSL Java extensions are in your CLASSPATH
9185 2. Create a DocBook XSL customization layer -- a file named
9186 mystylesheet.xsl or whatever -- that, at a minimum, contains the
9190 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
9192 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/>
9193 <xsl:output method="html" encoding="WINDOWS-1252" indent="no"/>
9194 <xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"></xsl:param>
9195 <xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"></xsl:param>
9196 <xsl:param name="saxon.character.representation" select="'native'"></xsl:param>
9199 Invoke Saxon with the encoding.windows-1252 Java system property set to
9200 com.nwalsh.saxon.Windows1252; for example
9203 -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
9204 com.icl.saxon.StyleSheet \
9205 mydoc.xml mystylesheet.xsl
9207 Or, for a more complete "real world" case showing other options you'll
9208 typically want to use:
9211 -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
9212 -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \
9213 -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \
9214 -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \
9215 com.icl.saxon.StyleSheet \
9216 -x org.apache.xml.resolver.tools.ResolvingXMLReader \
9217 -y org.apache.xml.resolver.tools.ResolvingXMLReader \
9218 -r org.apache.xml.resolver.tools.CatalogResolver \
9219 mydoc.xml mystylesheet.xsl
9221 In both cases, the "mystylesheet.xsl" file should be a DocBook
9222 customization layer containing the parameters show in step 2.
9224 • Saxon extensions: Removed Saxon 8 extensions from release package
9228 • A number of important bug fixes.
9230 • Added Saxon8 extensions
9232 • Enabled dbfo table-width on entrytbl in FO output
9234 • Added support for role=strong on emphasis in FO output
9236 • Added new FO parameter hyphenate.verbatim that can be used to turn on
9237 "intelligent" wrapping of verbatim environments.
9239 • Replaced all <tt></tt> output with <code></code>
9241 • Changed admon.graphic.width template to a mode so that different
9242 admonitions can have different graphical widths.
9244 • Deprecated the HTML shade.verbatim parameter (use CSS instead)
9246 • Wrapped ToC refentrytitle/refname and refpurpose in span with class values.
9247 This makes it possible to style them using a CSS stylesheet.
9249 • Use strong/em instead of b/i in HTML output
9251 • Added support for converting Emphasis to groff italic and Emphasis role=
9252 'bold' to bold. Controlled by emphasis.propagates.style param, but not
9253 documented yet using litprog system. Will do that next (planning to add
9254 some other parameter-controllable options for hyphenation and handling of
9257 • callout.graphics.number.limit.xml param: Changed the default from 10 to 15.
9259 • verbatim.properties: Added hyphenate=false
9261 • Saxon and Xalan Text.java extensions: Added support for URIResolver() on
9264 • Added generated RELEASE-NOTES.txt file.
9266 • Added INSTALL file (executable file for generating catalog.xml)
9268 • Removed obsolete tools directory from package
9272 • A number of important bug fixes.
9274 • Now xml:base attributes that are generated by an XInclude processor are
9275 resolved for image files.
9277 • Rewrote olink templates to support several new features.
9279 □ Extended full olink support to FO output.
9281 □ Add support for xrefstyle attribute in olinks.
9283 □ New parameters to support new olink features: insert.olink.page.number,
9284 insert.olink.pdf.frag, olink.debug, olink.lang.fallback.sequence,
9285 olink.properties, prefer.internal.olink. See the reference page for
9286 each parameter for more information.
9288 • Added index.on.type parameter for new type attribute introduced in DocBook
9289 4.3 for indexterms and index. This allows you to create multiple indices
9290 containing different categories of entries. For users of 4.2 and earlier,
9291 you can use the new parameter index.on.role instead.
9293 • Added new section.autolabel.max.depth parameter to turn off section
9294 numbering below a certain depth. This permits you to number major section
9295 levels and leave minor section levels unnumbered.
9297 • Added footnote.sep.leader.properties attribute set to format the line
9298 separating footnotes in printed output.
9300 • Added parameter img.src.path as a prefix to HTML img src attributes. The
9301 prefix is added to whatever path is already generated by the stylesheet for
9304 • Added new attribute-sets informalequation.properties,
9305 informalexample.properties, informalfigure.properties, and
9306 informaltable.properties, so each such element type can be formatted
9307 individually if needed.
9309 • Add component.label.includes.part.label parameter to add any part number to
9310 chapter, appendix and other component labels when the label.from.part
9311 parameter is nonzero. This permits you to distinguish multiple chapters
9312 with the same chapter number in cross references and the TOC.
9314 • Added chunk.separate.lots parameter for HTML output. This parameter lets
9315 you generate separate chunk files for each LOT (list of tables, list of
9318 • Added several table features:
9320 □ Added table.table.properties attribute set to add properties to the
9323 □ Added placeholder templates named table.cell.properties and
9324 table.cell.block.properties to enable adding properties to any
9325 fo:table-cell or the cell's fo:block, respectively. These templates are
9326 a start for implementing table styles.
9328 • Added new attribute set component.title.properties for easy modifications
9329 of component's title formatting in FO output.
9331 • Added Saxon support for an encoding attribute on the textdata element.
9332 Added new parameter textdata.default.encoding which specifies encoding when
9333 encoding attribute on textdata is missing.
9335 • Template label.this.section now controls whole section label, not only
9336 sub-label which corresponds to particular label. Former behaviour was IMHO
9337 bug as it was not usable.
9339 • Formatting in titleabbrev for TOC and headers is preserved when there are
9340 no hotlink elements in the title. Formerly the title showed only the text
9341 of the title, no font changes or other markup.
9343 • Added intial.page.number template to set the initial-page-number property
9344 for page sequences in print output. Customizing this template lets you
9345 change when page numbering restarts. This is similar to the
9346 format.page.number template that lets you change how the page number
9347 formatting changes in the output.
9349 • Added force.page.count template to set the force-page-count property for
9350 page sequences in print output. This is similar to the format.page.number
9353 • Sort language for localized index sorting in autoidx-ng.xsl is now taken
9354 from document lang, not from system environment.
9356 • Numbering and formatting of normal and ulink footnotes (if turned on) has
9357 been unified. Now ulink footnotes are mixed in with any other footnotes.
9359 • Added support for renderas attribute in section and sect1 et al. This
9360 permits you to render a given section title as if it were a different
9363 • Added support for label attribute in footnote to manually supply the
9366 • Added support for DocBook 4.3 corpcredit element.
9368 • Added support for a dbfo keep-together PI for formal objects (table,
9369 figure, example, equation, programlisting). That permits a formal object to
9370 be kept together if it is not already, or to be broken if it is very long
9371 and the default keep-together is not appropriate.
9373 • For graphics files, made file extension matching case insensitive, and
9374 updated the list of graphics extensions.
9376 • Allow calloutlist to have block content before the first callout
9378 • Added dbfo-need processing instruction to provide soft page breaks.
9380 • Added implementation of existing but unused default.image.width parameter
9383 • Support DocBook NG tag inline element.
9385 • It appears that XEP now supports Unicode characters in bookmarks. There is
9386 no further need to strip accents from characters.
9388 • Make segmentedlist HTML markup more semantic and available to CSS styles.
9390 • Added user.preroot placeholder template to permit xsl-stylesheet and other
9391 PIs and comments to be output before the HTML root element.
9393 • Non-chunked legalnotice now gets an <a name="id"> element in HTML output so
9394 it can be referenced with xref or link.
9396 • In chunked HTML output, changed link rel="home" to rel="start", and link
9397 rel="previous" to rel="prev", per W3C HTML 4.01 spec.
9399 • Added several patches to htmlhelp from W. Borgert
9401 • Added Bosnian locale file as common/bs.xml.
9405 • A number of important bug fixes.
9407 • Added a workaround to allow these stylesheets to process DocBook NG
9408 documents. (It’s a hack that pre-processes the document to strip off the
9409 namespace and then uses exsl:node-set to process the result.)
9411 • Added alternative indexing mechanism which has better internationalization
9412 support. New indexing method allows grouping of accented letters like e, é,
9413 ë into the same group under letter "e". It can also treat special letters
9414 (e.g. "ch") as one character and place them in the correct position (e.g.
9415 between "h" and "i" in Czech language).
9417 In order to use this mechanism you must create customization layer which
9418 imports some base stylesheet (like fo/docbook.xsl, html/chunk.xsl) and then
9419 includes appropriate stylesheet with new indexing code (fo/autoidx-ng.xsl
9420 or html/autoidx-ng.xsl). For example:
9422 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
9425 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/>
9426 <xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/>
9430 New method is known to work with Saxon and it should also work with
9431 xsltproc 1.1.1 and later. Currently supported languages are English, Czech,
9432 German, French, Spanish and Danish.
9436 General bug fixes and improvements. Sorry about the failure to produce an
9437 updated release notes file for 1.62.0—1.63.2
9439 • In the course of fixing bug #849787, wrapping Unicode callouts with an
9440 appropriate font change in the Xalan extensions, I discovered that the
9441 Xalan APIs have changed a bit. So xalan2.jar will work with older Xalan 2
9442 implementations, xalan25.jar works with Xalan 2.5.
9446 Lots of bug fixes and improvements.
9448 • Initial support for timestamp PI. From now you can use <?dbtimestamp format
9449 ="Y-m-d H:M:S"?> to get current datetime in your document. Added
9450 localization support for datetime PI
9452 • Added level 6 to test for section depth in section.level template so that
9453 section.title.level6.properties will be used for sections that are 6 deep
9454 or deeper. This should also cause a h6 to be created in html output.
9456 • Don't use SVG graphics if use.svg=0
9458 • Now uses number-and-title-template for sections only if section.autolabel
9461 • Added missing 'english-language-name' attribute to the l10n element, and
9462 the missing 'style' attribute to the template element so the current
9463 gentext documents will validate.
9465 • Corrected several references to parameter qanda.defaultlabel that were
9468 • Now accepts admon.textlabel parameter to turn off Note, Warning, etc.
9471 • FeatReq #684561: support more XEP metadata
9473 • Added hyphenation support. Added support for coref. Added beginpage
9474 support. (does nothing; see TDG).
9476 • Added support for hyphenation-character, hyphenation-push-character-count,
9477 and hyphenation-remain-character-count
9479 • Added root.properties, ebnf.assignment, and ebnf.statement.terminator
9481 • Support bgcolor PI in table cells; make sure rowsep and colsep don't have
9482 any effect on the last row or column
9484 • Handle othercredit on titlepage a little better
9486 • Applied fix from Jeff Beal that fixed the bug that put secondary page
9487 numbers on primary entries. Same with tertiary page numbers on secondary
9490 • Added definition of missing variable collection.
9492 • Make footnote formatting 'normal' even when it occurs in a context that has
9495 • Added warning when glossary.collection is not blank, but it cannot open the
9498 • Pick up the frame attribute on table and informaltable.
9500 • indexdiv/title in non-autogenerated indexes are now picked up.
9502 • Removed (unused) component.title.properties
9504 • Move IDs from page-sequences down to titlepage blocks
9506 • Use proportional-column-width(1) on more tables.
9508 Use proportional-column-width() for header/footer tables; suppress
9509 relative-align when when using FOP
9511 • Check for glossterm.auto.link when linking firstterms; don't output gl.
9512 prefix on glossterm links
9514 • Generate Part ToCs
9516 • Support glossary, bibliography, and index in component ToCs.
9518 • Refactored chunking code so that customization of chunk algorithm and chunk
9519 elements is more practical
9521 • Support textobject/phrase on inlinemediaobject.
9523 • Support 'start' PI on ordered lists
9525 • Fixed test of $toc PI to turn on qandaset TOC.
9527 • Added process.chunk.footnotes to sect2 through 5 to fix bug of missing
9528 footnotes when chunk level greater than 1.
9530 • Added paramater toc.max.depth which controls maximal depth of ToC as
9531 requested by PHP-DOC group.
9533 • Exempted titleabbrev from preamble processing in lists, and fixed
9534 variablelist preamble code to use the same syntax as the other lists.
9536 • Added support for elements between variablelist and first varlistentry
9537 since DocBook 4.2 supports that now.
9543 • The format of the titlepage.templates.xml files and the stylesheet that
9544 transforms them have been significantly changed. All of the attributes used
9545 to control the templates are now namespace qualified. So what used to be:
9547 <t:titlepage element="article" wrapper="fo:block">
9551 <t:titlepage t:element="article" t:wrapper="fo:block">
9553 Attributes from other namespaces (including those that are unqualified) are
9554 now copied directly through. In practice, this means that the names that
9555 used to be “fo:” qualified:
9557 <title named-template="component.title"
9558 param:node="ancestor-or-self::article[1]"
9559 fo:text-align="center"
9560 fo:keep-with-next="always"
9561 fo:font-size="&hsize5;"
9562 fo:font-weight="bold"
9563 fo:font-family="{$title.font.family}"/>
9565 are now unqualified:
9567 <title t:named-template="component.title"
9568 param:node="ancestor-or-self::article[1]"
9570 keep-with-next="always"
9571 font-size="&hsize5;"
9573 font-family="{$title.font.family}"/>
9575 The t:titlepage and t:titlepage-content elements both generate wrappers
9576 now. And unqualified attributes on those elements are passed through. This
9577 means that you can now make the title font apply to ane entire titlepage
9578 and make the entire “recto” titlepage centered by specifying the font and
9579 alignment on the those elements:
9581 <t:titlepage t:element="article" t:wrapper="fo:block"
9582 font-family="{$title.font.family}">
9584 <t:titlepage-content t:side="recto"
9585 text-align="center">
9587 • Support use of titleabbrev in running headers and footers.
9589 • Added (experimental) xref.with.number.and.title parameter to enable number/
9590 title cross references even when the default would be just the number.
9592 • Generate part ToCs if they're requested.
9594 • Use proportional-column-width() in header/footer tables.
9596 • Handle alignment correctly when screenshot wraps a graphic in a figure.
9598 • Format chapter and appendix cross references consistently.
9600 • Attempt to support tables with multiple tgroups in FO.
9602 • Output fo:table-columns in simplelist tables.
9604 • Use titlepage.templates.xml for indexdiv and glossdiv formatting.
9606 • Improve support for new bibliography elements.
9608 • Added footnote.number.format, table.footnote.number.format,
9609 footnote.number.symbols, and table.footnote.number.symbols for better
9610 control of footnote markers.
9612 • Added glossentry.show.acronyms.
9614 • Suppress the draft-mode page masters when draft-mode is “no”.
9616 • Make blank pages verso not recto. D'Oh!
9618 • Improved formatting of ulink footnotes.
9620 • Fixed bugs in graphic width/height calculations.
9622 • Added class attributes to inline elements.
9624 • Don't add “.html” to the filenames identified with the “dbhtml” PI.
9626 • Don't force a ToC when sections contain refentrys.
9628 • Make section title sizes a function of the body.master.size.
9632 The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail.
9634 • Removed the region-name from the region-body of blank pages. There's no
9635 reason to give the body of blank pages a unique name and doing so causes a
9636 mismatch that FOP detects.
9638 • Output IDs for the first paragraphs in listitems.
9640 • Fixed some small bugs in the handling of page numbers in double-sided mode.
9642 • Attempt to prevent duplicated IDs from being produced when endterm on xref
9643 points to something with nested structure.
9645 • Fix aligment problems in equations.
9647 • Output the type attribute on unordered lists (UL) in HTML only if the
9648 css.decoration parameter is true.
9650 • Calculate the font size in formal.title.properties so that it's 1.2 times
9651 the base font size, not a fixed "12pt".
9655 The 1.59.1 fixes a few bugs.
9657 • Added Bulgarian localization.
9659 • Indexing improvements; localize book indexes to books but allow setindex to
9660 index an entire set.
9662 • The default value for rowsep and colsep is now "1" as per CALS.
9664 • Added support for titleabbrev (use them for cross references).
9666 • Improvements to mediaobject for selecting print vs. online images.
9668 • Added seperate property sets for figures, examples, equations, tabless, and
9671 • Make lineannotations italic.
9673 • Support xrefstyle attribute.
9675 • Make endterm on xref higher priority than xreflabel target.
9677 • Glossary formatting improvements.
9681 The 1.58.0 adds some initial support for extensions in xsltproc, adds a few
9682 features, and fixes bugs.
9684 • This release contains the first attempt at extension support for xsltproc.
9685 The only extension available to date is the one that adjusts table column
9686 widths. Run extensions/xsltproc/python/xslt.py.
9688 • Fixed bugs in calculation of adjusted column widths to correct for rounding
9691 • Support nested refsection elements correctly.
9693 • Reworked gentext.template to take context into consideration. The name of
9694 elements in localization files is now an xpath-like context list, not just
9697 • Made some improvements to bibliography formatting.
9699 • Improved graphical formatting of admonitions.
9701 • Added support for entrytbl.
9703 • Support spanning index terms.
9705 • Support bibliosource.
9709 • The 1.57.0 release wasn't documented here. Oops.
9713 The 1.56.0 release fixes bugs.
9715 • Reworked chunking. This will break all existing customizations layers that
9716 change the chunking algorithm. If you're customizing chunking, look at the
9717 new “content” parameter that's passed to process-chunk-element and friends.
9719 • Support continued and inherited numeration in orderedlist formatting for
9722 • Added Thai localization.
9724 • Tweaked stylesheet documentation stylesheets to link to TDG and the
9725 parameter references.
9727 • Allow title on tables of contents ("Table of Contents") to be optional.
9728 Added new keyword to generate.toc. Support tables of contents on sections.
9730 • Made separate parameters for table borders and table cell borders:
9731 table.frame.border.color, table.frame.border.style,
9732 table.frame.border.thickness, table.cell.border.color,
9733 table.cell.border.style, and table.cell.border.thickness.
9735 • Suppress formatting of “endofrange” indexterms. This is only half-right.
9736 They should generate a range, but I haven't figured out how to do that yet.
9738 • Support revdescription. (Bug #582192)
9740 • Added default.float.class and fixed figure floats. (Bug #497603)
9742 • Fixed formatting of sbr in FOs.
9744 • Added context to the “missing template” error message.
9746 • Process arg correctly in a group. (Bug #605150)
9748 • Removed 'keep-with-next' from formal.title.properties attribute set now
9749 that the stylesheets support the option of putting such titles below the
9750 object. Now the $placement value determines if 'keep-with-next' or
9751 'keep-with-previous' is used in the title block.
9753 • Wrap “url()” around external-destinations when appropriate.
9755 • Fixed typo in compact list spacing. (Bug #615464)
9757 • Removed spurious hash in anchor name. (Bug #617717)
9759 • Address is now displayed verbatim on title pages. (Bug #618600)
9761 • The bridgehead.in.toc parameter is now properly supported.
9763 • Improved effectiveness of HTML cleanup by increasing the number of places
9764 where it is used. Improve use of HTML cleanup in XHTML stylesheets.
9766 • Support table of contents for appendix in article. (Bug #596599)
9768 • Don't duplicate footnotes in bibliographys and glossarys. (Bug #583282)
9770 • Added default.image.width. (Bug #516859)
9772 • Totally reworked funcsynopsis code; it now supports a 'tabular'
9773 presentation style for 'wide' prototypes; see
9774 funcsynopsis.tabular.threshold. (HTML only right now, I think, FO support,
9777 • Reworked support for difference marking; toned down the colors a bit and
9778 added a “system.head.content” template so that the diff CSS wasn't
9779 overriding “user.head.content”. (Bug #610660)
9781 • Added call to the “*.head.content” elements when writing out long
9784 • Make sure legalnotice link is correct even when chunking to a different
9787 • Use CSS to set viewport characteristics if css.decoration is non-zero, use
9788 div instead of p for making graphic a block element; make figure titles the
9789 default alt text for images in a figure.
9791 • Added space-after to list.block.spacing.
9793 • Reworked section.level template to give “correct” answer instead of being
9796 • When processing tables, use the tabstyle attribute as the division class.
9798 • Fixed bug in html2xhtml.xsl that was causing the XHTML chunker to output
9799 HTML instead of XHTML.
9803 To view the release notes for older releases, see http://cvs.sourceforge.net/
9804 viewcvs.py/docbook/xsl/RELEASE-NOTES.xml. Be aware that there were no release
9805 notes for releases prior to the 1.50.0 release.
9807 About dot-zero releases
9809 DocBook Project “dot zero” releases should be considered experimental and are
9810 always followed by stable “dot one plus” releases, usually within two or three
9811 weeks. Please help to ensure the stability of “dot one plus” releases by
9812 carefully testing each “dot zero” release and reporting back about any problems
9815 It is not recommended that you use a “dot zero” release in a production system.
9816 Instead, you should wait for the “dot one” or greater versions.