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 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
106 Release Notes: 1.75.1
113 Release Notes: 1.75.0
127 Release Notes: 1.74.3
128 Release Notes: 1.74.2
129 Release Notes: 1.74.1
140 Release Notes: 1.74.0
162 Release Notes: 1.73.2
268 About dot-zero releases
270 Release Notes: 1.78.1
272 The following is a list of changes that have been made since the 1.78.0
277 The following changes have been made to the common code since the 1.78.0
280 • Robert Stayton: titles.xsl
282 Make sure part and set titleabbrev are used in mode="titleabbrev.markup"
284 • Robert Stayton: titles.xsl
286 Add empty default template for titleabbrev since it is always processed in a mode.
288 • Robert Stayton: gentext.xsl
290 Make consistent handling of titleabbrev in xrefs.
292 • Robert Stayton: titles.xsl
294 for missing title in xref, provide parent information of target to help locate problem element.
295 Process bridgehead in mode="title.markup", not normal mode.
297 • Jirka Kosek: l10n.xsl
301 • Robert Stayton: gentext.xsl; labels.xsl
303 Make sure bridgeheads are not numbered in all contexts, including html title attributes.
307 The following changes have been made to the fo code since the 1.78.0 release.
309 • Robert Stayton: division.xsl
311 Fix bug where part TOC not generated when partintro is present.
313 • Jirka Kosek: xref.xsl
315 Footnotes can't be placed into fo:float
317 • Robert Stayton: titlepage.templates.xml
319 Remove margin-left when start-indent is used because they interfere
322 • Robert Stayton: fo.xsl; pagesetup.xsl
324 Use dingbat.fontset rather than dingbat.font.family so it falls
325 back to symbol font if glyph not found, like other font properties.
327 • Robert Stayton: inline.xsl
329 Change last instance of inline.charseq in inline glossterm to
330 inline.italicseq so it is consistent with the others.
332 • Robert Stayton: xref.xsl
334 Make consistent handling of titleabbrev in xrefs.
338 The following changes have been made to the html code since the 1.78.0 release.
340 • Robert Stayton: admon.xsl
342 Turn off $admon.style if $make.clean.html is set to non-zero.
344 • Jirka Kosek: highlight.xsl
346 Added new definitions for syntax highlighting
348 • Robert Stayton: chunk-common.xsl
350 Make active.olink.hrefs param work for chunked output too.
352 • Robert Stayton: xref.xsl
354 Make consistent handling of titleabbrev in xrefs.
356 • Robert Stayton: graphics.xsl
358 Add round() function when pixel counts are used for image width and height.
360 • Robert Stayton: glossary.xsl
362 fix missing class and id attributes on glossterm and glossdef.
364 • Robert Stayton: autoidx.xsl
366 Fix bug where prefer.index.titleabbrev ignored info/titleabbrev.
370 The following changes have been made to the manpages code since the 1.78.0
373 • Robert Stayton: utility.xsl
375 Fix bug 3599520: spurious newline in para when starts with
376 whitespace and inline element.
380 The following changes have been made to the webhelp code since the 1.78.0
383 • David Cramer: xsl/webhelp-common.xsl
385 Webhelp: Fix test for webhelp.include.search.tab param
387 • David Cramer: Makefile.sample
389 Webhelp: Fix order of args to xsltproc
391 • David Cramer: docsrc/readme.xml
393 Webhelp: Turn on xinclude-test.xml in readme to demo xinclude functionality
395 • David Cramer: Makefile; Makefile.sample
397 Webhelp: In Makefiles, do xinclude in first pass at document
401 The following changes have been made to the params code since the 1.78.0
404 • David Cramer: webhelp.include.search.tab.xml
406 Webhelp: Fix test for webhelp.include.search.tab param
408 • Robert Stayton: article.appendix.title.properties.xml
410 Remove unneeded margin-left property from article appendix title.
411 It interferes with the start-indent property.
415 The following changes have been made to the highlighting code since the 1.78.0
418 • Jirka Kosek: c-hl.xml; cpp-hl.xml; sql2003-hl.xml; php-hl.xml; upc-hl.xml;
421 Added new definitions for syntax highlighting
423 Release Notes: 1.78.0
425 The following is a list of changes that have been made since the 1.77.1
430 The following changes have been made to the gentext code since the 1.77.1
433 • Mauritz Jeanson: locale/nn.xml; locale/nb.xml
435 Bug #3556630: Updated nb and nn locale files.
437 • Mauritz Jeanson: locale/README
439 Bug #3556628: Updated information in README.
441 • tom_schr: locale/de.xml
443 Added keycap context from RFE#3540451 to support @function attribute
445 • tom_schr: locale/en.xml
447 Added keycap context from RFE#3540451 to support @function attribute
449 • Robert Stayton: locale/en.xml
451 Add support for title element in screenshot, now allowed in DocBook 5.
455 The following changes have been made to the common code since the 1.77.1
458 • Robert Stayton: titles.xsl
460 Corrected template for bridgehead in mode="title.markup" to
461 process its children in normal mode.
463 • Robert Stayton: labels.xsl
465 Convert hard wired xsl:number for production into a template
466 with mode="label.markup" to be consistent with other element numbering.
468 • Robert Stayton: olink.xsl
470 Remove all references and code for obsolete olink attributes
471 @linkmode @targetdocent and @localinfo.
473 • Robert Stayton: olink.xsl
475 Add parameter 'activate.external.olinks' to allow making
476 external olinks inactive, as for epub output.
480 The following changes have been made to the fo code since the 1.77.1 release.
482 • Robert Stayton: pagesetup.xsl
484 Change initial page number for book from 1 to auto so front
485 cover and title pages are sequential, and so that book inside
486 set will continue numbering.
488 • Robert Stayton: inline.xsl
490 Add missing closing tag for xsl:choose in new template.
492 • Robert Stayton: param.xweb; param.ent; pagesetup.xsl
494 Add force.blank.pages parameter to allow turning off blank
495 pages in double.sided output.
497 • Robert Stayton: lists.xsl; callout.xsl
499 Implement active links between co and callout elements for
500 PDF output, linking in both directions.
502 • Robert Stayton: table.xsl
504 Fix typo to replace "ro" with "row" in three places.
506 • Robert Stayton: ebnf.xsl
508 Convert hard wired xsl:number for production into a template
509 with mode="label.markup" to be consistent with other element numbering.
511 • Robert Stayton: inline.xsl
513 Make comma inserted after function/parameter or function/replaceable
514 conditional on $function.parens to be consistent with the function template.
516 • tom_schr: inline.xsl
518 Added new inline.sansseq template for consistency reasons.
519 Makes it easier for customization layers: Just use
520 <xsl:call-template name="inline.sansseq"/>
521 to change to sans serif font, but also takes into account
522 XLinks and direction of text.
524 • Robert Stayton: xref.xsl
526 Remove all references and code for obsolete olink attributes
527 @linkmode @targetdocent and @localinfo.
529 • Robert Stayton: table.xsl
531 Remove passivetex.extensions code.
533 • Robert Stayton: spaces.xsl; autotoc.xsl; docbook.xsl; division.xsl;
534 table.xsl; sections.xs⋯
536 Remove all passivetex code because it is obsolete.
538 • Robert Stayton: param.xweb; param.ent
540 Add parameter 'activate.external.olinks' to allow making
541 external olinks inactive, as for epub output.
543 • Mauritz Jeanson: table.xsl
545 Added support for keep-together PI on informaltable. Closes bug #3555609.
547 • tom_schr: verbatim.xsl
549 Fixed subtle typo when calling lastLineNumber template: must be $listing instead of listing
551 • tom_schr: autoidx.xsl
553 Fixed typo: fole -> role attribute for phrase
555 • tom_schr: inline.xsl
557 Added support for @function attribute in keycap (uses keycap context
558 from language files) => fixes RFE#3540451
559 If @function is set and keycap is empty, then template will use the
560 content from the keycap context, otherwise it will use just the given
563 • Robert Stayton: graphics.xsl; xref.xsl
565 Add support for title element in screenshot, now allowed in DocBook 5.
567 • Robert Stayton: graphics.xsl
569 Restore formatting of figure/caption that was broken in 1.77.1.
573 The following changes have been made to the html code since the 1.77.1 release.
575 • David Cramer: autotoc.xsl
577 Fixing bug where toc.title.p and nodes params had not been declared inside manual-toc template
579 • Robert Stayton: autotoc.xsl
581 Add 'toc.list.attributes' template to insert class and other
582 attributes on the top level list element in a table of contents.
584 • Robert Stayton: block.xsl
586 Fix bug 3590039 abstract/title not rendered.
588 • Jirka Kosek: chunk-common.xsl; footnote.xsl
590 Fixed positioning of footnote separate when CSS decoration is used.
592 • Robert Stayton: ebnf.xsl
594 Convert hard wired xsl:number for production into a template
595 with mode="label.markup" to be consistent with other element numbering.
597 • Robert Stayton: inline.xsl
599 Make comma inserted after function/parameter or function/replaceable
600 conditional on $function.parens to be consistent with the function template.
602 • Robert Stayton: graphics.xsl
604 Add support for mediaobject/alt, with precedence over
605 mediaobject/textobject/phrase.
607 • Robert Stayton: param.xweb
609 Remove src:fragref elements for deleted obsolete olink params.
611 • Robert Stayton: chunker.xsl
613 Fix bug #3563697 where template make-relative-filename was using a
614 global param chunk.base.dir instead of its local param base.dir. Now it uses base.dir.
616 • Robert Stayton: param.xweb; param.ent; xref.xsl
618 Remove all references and code for obsolete olink attributes
619 @linkmode @targetdocent and @localinfo.
621 • Robert Stayton: param.xweb; param.ent
623 Add parameter 'activate.external.olinks' to allow making
624 external olinks inactive, as for epub output.
626 • stefan: graphics.xsl
628 Add hook for customization.
630 • tom_schr: docbook.xsl
632 Splitting head.content into smaller chunks of templates.
633 See https://lists.oasis-open.org/archives/docbook-apps/201209/msg00037.html
635 • tom_schr: verbatim.xsl
637 Fixed subtle typo when calling lastLineNumber template: must be $listing instead of listing
639 • Robert Stayton: footnote.xsl
641 Fix bug in footnote link introduced in 1.77.1.
643 • Robert Stayton: formal.xsl; htmltbl.xsl
645 Resolve conflict of duplicate ids on html table with caption.
646 Wrap a div with class and id attribute around html table without caption.
648 • Robert Stayton: component.xsl
650 Remove call to 'generate.id' template in <h1> in component.title because the
651 id is already generated for the parent div element.
653 • Robert Stayton: chunker.xsl
655 Set omit-xml-declaration to 'yes' for write.text.chunk template, since a text
656 file should never have an xml declaration.
658 • tom_schr: inline.xsl
660 Added support for @function attribute in keycap (uses keycap context
661 from language files) => fixes RFE#3540451
662 If @function is set and keycap is empty, then template will use the
663 content from the keycap context, otherwise it will use just the given
666 • David Cramer: docbook.xsl
668 Also set the title param in head.content since it's sometimes
669 called without that param being passed in. Use the passed-in
670 value in user.head.title.
672 • Robert Stayton: docbook.xsl
674 Restore missing title param on 'head.content' template, and passed
675 it along to user.head.title. That param
676 is used for certain special chunkings such as Long Descriptions.
678 • Robert Stayton: graphics.xsl; xref.xsl
680 Add support for title in screenshot, available since DocBook 5.
682 • David Cramer: docbook.xsl
684 HTML: Add hook for easily customizing html/head/title
688 The following changes have been made to the manpages code since the 1.77.1
691 • Robert Stayton: lists.xsl
693 Add a line break at start of variablelist to fix bug #3595156.
695 • Robert Stayton: lists.xsl
697 Better fix for bug #3545150 by putting the title with the step number
698 rather than before it.
700 • Robert Stayton: utility.xsl
702 Add 'content' param to template name inline.monoseq to support
703 email format, fixing bug #3524417.
705 • Robert Stayton: utility.xsl
707 Fix bug #3512473 where an inline synopsis element produced
708 an extra line break in nroff output.
710 • Robert Stayton: lists.xsl
712 Fix bug 3545150 where procedure/step/title not rendered in man pages.
716 The following changes have been made to the roundtrip code since the 1.77.1
719 • Robert Stayton: dbk2wordml.xsl
721 Fix bug #3297553 error in Word metadata elements from including
722 WordML markup instead of just text.
726 The following changes have been made to the slides code since the 1.77.1
729 • gaborkovesdan: xhtml/plain.xsl
731 - Use real push-style processing in the foil/foilgroup page content, which
732 allows better customization in general (e.g. you can add PI templates)
733 and also let us render scattered speakernotes/handoutnotes if that is
736 • gaborkovesdan: xhtml/Makefile
738 - Titlepage markup belongs to the XHTML namespace
740 • gaborkovesdan: xhtml/plain.xsl
742 - Remove now unnecessary template redefinition
744 • gaborkovesdan: xhtml/plain.xsl
746 - Generate valid links from cross-references
748 • gaborkovesdan: xhtml/plain.xsl
750 - Do not add fallbacks for EXSLT extensions, the main DocBook XSL stylesheets
751 do not do that either
753 • Robert Stayton: schema/relaxng/slides.rnc
755 Update the import path for docbook.rnc after the slides directory was moved.
757 • stefan: xhtml/plain.xsl
759 Add missing stylesheet.
761 • stefan: schema/xsd/Makefile; schema/Makefile; schema/relaxng/Makefile
765 • stefan: locatingrules.xml; RELEASE-NOTES.xml; doc; images;
766 locatingrules.xml; Makefile; im⋯
768 Moved many files from slides/ to xsl/slides/
770 • stefan: fo/param.xweb; xhtml/Makefile; xhtml/param.xweb; fo/Makefile
772 Separate slides package.
778 • stefan: xhtml/Makefile; fo/Makefile
780 Add to 'clean' target.
782 • David Cramer: Makefile
784 Slides: Change html to xhtml passim.
786 • David Cramer: xhtml
788 Adding items to svn ignore for slides
792 Import slidy from vendor branch.
796 Import s5 from vendor branch.
798 • stefan: Makefile; common/common.xsl; common; fo/param.ent; graphics; xhtml/
801 Merge Slides GSoC project to trunk.
805 The following changes have been made to the webhelp code since the 1.77.1
808 • David Cramer: docsrc/readme.xml
810 Webhelp: More doc updates
812 • David Cramer: docsrc/readme.xml
814 Webhelp: Documentation updates.
816 • David Cramer: template/content; Makefile; Makefile.sample; build.xml;
819 Webhelp: Improving sample Makefile to allow for profiling params and other params, removing content dir from template and making related adjustments in Makefile and build.xml
821 • David Cramer: Makefile.sample
823 Attempting to include sample Makefile in webhelp output dir
825 • David Cramer: template/common/css/positioning.css
827 Webhelp: Do not display sidebar if js is disabled in browser since it will not be functional
829 • Jirka Kosek: build.xml
831 Xerces must be on the classpath in order to XInclude work
833 • David Cramer: Makefile
835 Adding generated files to various clean targets.
837 • David Cramer: build.properties
839 Webhelp: By default don't validate against dtd when using ant build
841 • David Cramer: Makefile
843 Webhelp: By default only exclude ix01.html from search in Makefile
845 • David Cramer: template/common/jquery/jquery-ui-1.8.2.custom.min.js;
846 template/common/jquery⋯
848 Webhelp: Reverting last commit
850 • David Cramer: template/common/jquery/jquery-ui-1.8.2.custom.min.js;
851 template/common/jquery⋯
853 Webhelp: Removing two more unused jquery files
855 • David Cramer: template/common/jquery/jquery-1.4.2.min.js
857 Webhelp: Removing old, unused jquery file
859 • David Cramer: xsl/webhelp-common.xsl
861 Webhelp: Fix header logo link
863 • David Cramer: xsl/webhelp-common.xsl
865 Webhelp: Fix bad link to favicon.ico
867 • David Cramer: template/common/jquery/jquery-1.7.2.min.js; template/common/
870 First part of the GSoC 2012 work by Arun and Visitha:
873 Remove content folder from Webhelp output
874 Build Webhelp using GNU Make/without ant
875 Support a parameterized list of files to exclude while indexing
876 Improve information message for browser with JavaScript disabled
877 Support searching for terms with punctuation like build.xml
880 Make it possible to include the doc title in head/title and
881 not in the search results
882 Improve performance in IE 8/9
884 Information message for browser with JavaScript disabled
886 • David Cramer: xsl/webhelp-common.xsl
888 Use user.head.title to add title to webhelp pages,
889 but do not yet add the book title to the page title.
891 • David Cramer: xsl/webhelp-common.xsl
893 Webhelp: Revert 9433. We need to fix the indexer before we can include the document title in the html/head/title
895 • David Cramer: xsl/webhelp-common.xsl
897 Webhelp: Append document title to html/head/title
899 • David Cramer: xsl/webhelp-common.xsl
901 Webhelp: fix missing reference to ie.css
905 The following changes have been made to the params code since the 1.77.1
908 • Robert Stayton: page.height.portrait.xml; page.width.portrait.xml
910 Add USlegal and USlegallandscape.
912 • Robert Stayton: force.blank.pages.xml
914 Improve the description.
916 • Robert Stayton: page.margin.outer.xml; writing.mode.xml; double.sided.xml;
919 Improve the description.
921 • Robert Stayton: force.blank.pages.xml
923 New param to control generating blank even-numbered pages.
925 • Robert Stayton: passivetex.extensions.xml
927 Indicate that passivetex is no longer supported.
929 • Robert Stayton: footnote.properties.xml
931 Fix bug #3555628 where a footnote inside a blockquote inherits the end-indent from the blockquote.
933 • stefan: foil.page-sequence.properties.xml; handoutnotes.properties.xml;
936 Merge Slides GSoC project to trunk.
938 • Robert Stayton: activate.external.olinks.xml
940 Add parameter 'activate.external.olinks' to allow making
941 external olinks inactive, as for epub output.
945 The following changes have been made to the profiling code since the 1.77.1
948 • Robert Stayton: xsl2profile.xsl
950 Test for @xml:id as well as @id for $rootid.
954 The following changes have been made to the tools code since the 1.77.1
957 • David Cramer: bin/docbook-xsl-update
959 s/VERSION/VERSION.xsl/ again.
961 • David Cramer: xsl/build/xsl-param-link.xsl; xsl/build/make-xsl-params.xsl
963 Slides: Change html to xhtml passim.
967 The following changes have been made to the template code since the 1.77.1
970 • Jirka Kosek: titlepage.xsl
972 Autoguess of proper parameter settings
974 Release Notes: 1.77.1
976 The following list summarizes the major changes that have been made since the
977 1.76.1 release. It is followed by sections detailing changes to individual
978 files from the SVN checkin logs, edited to remove housekeeping changes and bug
979 fixes. See the NEWS.xml file for a complete unedited list of SVN changes.
985 Many improvements to the generated text for webhelp output.
989 Support more media types
991 Expanded list of supported filename extensions for media to include
992 video and audio, mostly for HTML5 and EPUB3 outputs.
996 Add basic support for new topic element, which is available in DocBook
997 5.1. Generally a topic element will be used with assembly and may be
998 transformed to some other hierarchical element during processing, but
999 it can also be formatted as a plain topic.
1003 Add para.properties attribute-set
1005 Add a para.properties attribute-set that applies only to para elements.
1006 That allows still using normal.para.spacing attribute-set for many
1007 block elements for uniform spacing, but allows separate formatting of
1010 List of titles in article
1012 Add support for List of Tables, List of Figures, etc. for articles and
1013 other component-level elements. Includes a new template for each in
1014 autotoc.xsl, new attribute-sets in titlepage.xsl, and new entries in
1015 the titlepage.templates.xml file tu support customization.
1017 Customizing links in FO
1019 Add template mode simple.xlink.properties to allow easy customization
1020 of formatting of links generated from elements that use the xlink
1021 attributes. This extends link formatting beyond that of xref, link, and
1022 olink which use xref.properties attribute-set.
1026 The caption element in an HTML table is now handled like a title in a
1027 CALS table, using the formal.object.title template with all its
1028 features, including placement. Now caption template in mode="htmlTable"
1029 does nothing, because caption handled by formal.object.title template.
1030 Also adds support for table caption element in a CALS table, placing it
1033 Graphics attribute handling
1035 Refactored the big process.image template to use individual templates
1036 such as image.width for most attributes to allow easier customization
1037 of individual properties.
1041 Add support for side page regions in addition to header and footer
1042 regions. This feature lets you add running content to the side margins,
1043 and by default the content is rotated 90 degrees. Adds new templates
1044 named running.side.content, region.inner and region.outer; new template
1045 modes region.inner.mode and region.outer.mode; new parameters named
1046 region.inner.extent, region.outer.extent, body.margin.inner,
1047 body.margin.outer, and side.region.precedence; and new attribute-sets
1048 named inner.region.content.properties, outer.region.content.properties,
1049 region.inner.properties, and region.outer.properties.
1053 Add new attribute-sets for calloutlist.
1057 Add basic support for formatting a topic element, which is available in
1064 Add variables to the base HTML stylesheets that can be adjusted for the
1067 Insert Javascript reference
1069 Add support for html.script param to insert reference to a Javascript
1072 Namespace for titlepage mechanism.
1074 Titlepage mechanism is now namespace aware to support XHTML.
1076 Chunked filename prefix
1078 New param named chunked.filename.prefix lets you add a filename prefix
1079 to each chunked file. This replaces the buggy practice of adding such a
1080 prefix to the base.dir param. Now the base.dir param will always have a
1081 trailing slash added if it is not present, so you no longer have to
1082 remember to add it to the param value.
1084 Generate id attributes
1086 The stylesheet param generate.id.attributes already existed but was
1087 incompletely implemented. Now when it is set to 1, only id attributes
1088 should be output, not <a name> named anchors.
1090 Generate consistent id attributes
1092 New generate.consistent.ids parameter which allows generating a more
1093 stable id values based on XPath rather than the generate-id() function,
1094 which may not produce consistent values between runs. Stable output ids
1095 allow you to make stable links to generated content from the outside.
1099 Add basic support for formatting a topic element, which is available in
1100 DocBook 5.1. Generally a topic element will be used with assembly and
1101 may be transformed to some other hierarchical element during
1102 processing, but it can also be formatted as a plain topic.
1108 Webhelp templates refactored to better support customization.
1110 Added documentation.
1112 More and better documentation added.
1114 Webhelp generated text
1116 Many improvements to the generated text for webhelp output.
1120 New stylesheets to generate HTML5 output, in an XML serialization. These
1121 templates are a customization layer on top of the XHTML stylesheet files.
1125 New stylesheets to generate EPUB3 output. These templates are a
1126 customization layer on top of the xhtml5 stylesheet files.
1130 New assembly.xsl stylesheet to convert a DocBook 5.1 assembly into a
1131 standard DocBook 5 document. Also includes a topic-maker-chunk.xsl
1132 stylesheet that can convert a DocBook 5 book or article document into an
1133 assembly with a collection of modular files, including converting some
1134 elements to topic files.
1138 The following changes have been made to the gentext code since the 1.76.1
1141 • stefanhinz: locale/de.xml
1143 Translated German WebHelp strings
1145 • David Cramer: locale/zh.xml; locale/en.xml; locale/fr.xml; locale/de.xml;
1148 Webhelp: Update non-en gentext strings
1150 • Robert Stayton: locale/en.xml
1152 Add topic to title-numbered context.
1154 • Robert Stayton: locale/en.xml
1156 Add basic topic element templates.
1158 • Mauritz Jeanson: locale/el.xml
1160 Updated gentext for quotation marks. Fixes bug #3512440.
1162 • Jirka Kosek: locale/cs.xml
1164 Adding missing context for webhelp
1166 • David Cramer: locale/en.xml
1168 Fixing syntax of webhelp gentext entries
1170 • David Cramer: locale/en.xml
1172 Moving webhelp gentext strings into a context
1174 • tom_schr: locale/zh.xml; locale/en.xml; locale/cs.xml; locale/fr.xml;
1175 locale/de.xml; local⋯
1177 Moved language specific of WebHelp to gentext/locale/ as discussed with
1178 Stefan following the "minimal intrusive approach". :)
1179 In the long run, maybe moving the text into a context, not sure.
1181 • Jirka Kosek: locale/ru.xml
1183 Aligned capitalization of first letters with English original
1187 The following changes have been made to the common code since the 1.76.1
1190 • Robert Stayton: common.xsl
1192 In "select.mediaobject.index" template, add selection of videoobject
1193 and audioobject since now supported in HTML5.
1195 • Robert Stayton: labels.xsl; titles.xsl; entities.ent; targets.xsl;
1196 subtitles.xsl; gentext.⋯
1198 Add basic support for new <topic> element.
1200 • Robert Stayton: common.xsl
1202 Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.
1204 • Robert Stayton: olink.xsl
1206 Generate error message if olink data in targetset is in a namespace.
1208 • Robert Stayton: common.xsl
1210 Add support for generate.consistent.ids parameter.
1212 • Robert Stayton: subtitles.xsl
1214 Add verbose param to subtitle.markup templates to allow its
1215 error message to be ignored.
1216 Add that param to fop1.xsl application of subtitle.markup
1217 to avoid unnecessary error message in document information.
1219 • Robert Stayton: labels.xsl
1221 Add empty templates for glossdiv, glosslist, and glossentry in
1222 mode="label.markup".
1226 The following changes have been made to the fo code since the 1.76.1 release.
1228 • Robert Stayton: graphics.xsl
1230 qualify caption template to mediaobject/caption so not confused with table/caption.
1232 • Robert Stayton: table.xsl
1234 Add template to process table/caption element.
1236 • Robert Stayton: titlepage.xsl; autotoc.xsl; component.xsl; xref.xsl;
1237 titlepage.templates.x⋯
1239 Add basic support for new <topic> element.
1241 • Robert Stayton: graphics.xsl
1243 Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.
1245 • Robert Stayton: titlepage.xsl
1247 Add default style att-sets for component.list.of.titles, etc.
1249 • Robert Stayton: autotoc.xsl; component.xsl; titlepage.templates.xml
1251 Add make.component.tocs to support lists of tables, etc. for
1252 article and other components. Added component.list.of.tables to
1253 titlepage.templates.xml to format the title.
1255 • Robert Stayton: param.xweb; param.ent
1257 Add new para.properties attribute-set for paragraphs.
1259 • Robert Stayton: inline.xsl
1261 Add template mode 'simple.xlink.properties' to allow
1262 easy customization of formatting of links generated
1263 from elements other than xref, link, and olink using
1264 the xlink attributes.
1266 • Robert Stayton: param.xweb; param.ent
1268 Add table.caption.properties to format table captions.
1270 • Robert Stayton: table.xsl
1272 Add support for caption in a CALS table.
1274 • Robert Stayton: graphics.xsl; math.xsl
1276 Refactored the 'process.image' template to create modular
1277 templates for each attribute so they can be individually
1278 customized. Also merged in support for embedded svg and
1279 mml content so they can have image attributes too.
1281 • Robert Stayton: param.xweb; param.ent
1283 Check in new params for FO side regions in page masters.
1285 • Robert Stayton: titlepage.xsl; titlepage.templates.xml
1287 Add support for itermset in info elements, using titlepage mechanism
1288 to ensure entries are placed inside page-sequence.
1290 • Robert Stayton: pagesetup.xsl
1292 Add support for side body margins and side static content regions.
1295 • Robert Stayton: param.xweb; param.ent; task.xsl
1297 Add attribute-set task.properties to task element to
1298 support customization.
1300 • Robert Stayton: lists.xsl; param.xweb; param.ent
1302 Add new attribute-sets calloutlist.properties and callout.properties
1303 to better support customization of calloutlists, fixing bug 3160341.
1305 • Jirka Kosek: Makefile
1307 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.
1309 • Robert Stayton: graphics.xsl
1311 Allow selection by role for multiple imageobject elements
1312 within an imageobjectco, which since Docbook 5 allows multiple imageobjects.
1314 • Mauritz Jeanson: titlepage.xsl
1316 Added template for collabname. Fixes bug #3414436.
1318 • David Cramer: verbatim.xsl
1320 Support the keep-together processing-instruction on programlisting, screen, synopsis, and literallayout. Tracker id #3396906.
1322 • Robert Stayton: pagesetup.xsl
1324 Pass the pageclass, sequence, and gentext-key to the template
1325 named header.footer.widths to enable further customization
1326 based on page master.
1328 • Jirka Kosek: xref.xsl
1330 hyphenation of URL content must be disabled for link, not only for ulink because od DB5
1332 • Jirka Kosek: xref.xsl
1334 URLs shouldn't be hyphenated as normal text
1336 • Jirka Kosek: callout.xsl
1338 Added support for alternative circled numbers
1340 • Mauritz Jeanson: axf.xsl; fop1.xsl; xep.xsl
1342 Added support for author/orgname in document metadata. Closes bug #3132862.
1344 • Robert Stayton: component.xsl
1346 Add template for article/colophon to avoid nested page-sequence.
1350 The following changes have been made to the html code since the 1.76.1 release.
1352 • Robert Stayton: xref.xsl
1354 Add support for using info/title as well as title in target element.
1356 • Robert Stayton: component.xsl
1358 Enable support for html5 features, including using <section> instead of
1359 <div> for certain elements, and setting heading level to <h1> for chapters.
1360 These features are not changed in the base html stylesheet for backwards
1363 • Robert Stayton: docbook.css.xml
1365 Add style for footnote rule.
1367 • Robert Stayton: biblio-iso690.xsl
1369 Add support for subtitle inside info.
1371 • Robert Stayton: docbook.xsl
1373 Add call to new 'root.attributes' placeholder template to allow
1374 adding attributes to the <html> output element.
1376 • Robert Stayton: inline.xsl; titlepage.xsl; formal.xsl; division.xsl;
1377 toc.xsl; sections.xsl⋯
1379 Finish implementation of generate.id.attributes for all elements
1380 using the template named id.attribute.
1382 • Robert Stayton: autotoc.xsl; chunktoc.xsl; titlepage.xsl; chunk-code.xsl;
1385 Add basic support for new <topic> element.
1387 • Robert Stayton: graphics.xsl
1389 Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.
1391 • Robert Stayton: callout.xsl; verbatim.xsl
1393 Restore programlisting to use <pre> instead of <div> and instead
1394 wrap callout img elements in <span> to make valid HTML.
1396 • Robert Stayton: graphics.xsl
1398 Turn off img longdesc attribute because not supported by browsers.
1400 • Robert Stayton: footnote.xsl
1402 Move square brackets and <sup> inside <a> element for footnote
1403 marks to fix display problems in some browsers.
1405 • Robert Stayton: param.xweb; param.ent
1407 Add new params html.script and html.script.type to support
1408 Javascript references.
1410 • Robert Stayton: chunk-common.xsl; chunktoc.xsl; titlepage.xsl; chunker.xsl;
1413 Add support for chunked.filename.prefix param.
1414 Make sure base.dir value has a trailing slash in
1415 the chunk.base.dir internal param used by the templates.
1417 • Robert Stayton: formal.xsl; htmltbl.xsl
1419 Now handles caption in html markup table like title,
1420 so formal.object.title is used with all its features, including
1421 formatting and placement.
1422 Added htmlTable.with.caption template to handle the wrapper, and
1423 left htmlTable template unchanged.
1424 Now caption template in mode="htmlTable" does nothing, because
1425 caption handled by formal.object.title template.
1427 • Robert Stayton: html.xsl
1429 Turn off generating the title attribute for block and hierarchical elements.
1430 Should only be used for inline elements, usually using the alt element.
1431 Also used for links to show the target title.
1433 • Robert Stayton: lists.xsl
1435 The spacing="compact" attribute on lists in HTML no longer outputs compact="compact"
1436 (or just "compact" in the case of Saxon 6), since that attribute is
1437 deprecated and improperly supported. Instead, the output uses a
1438 multiple class attribute such as class="orderedlist compact".
1439 Use CSS to style such lists without margin above.
1441 • Robert Stayton: graphics.xsl
1443 Allow selection by role for multiple imageobject elements
1444 within an imageobjectco, which since Docbook 5 allows multiple imageobjects.
1446 • Robert Stayton: pi.xsl
1448 Improve doc descriptions of dbhtml filename and dir.
1450 • Robert Stayton: autoidx.xsl
1452 Add setindex to context param in mode="reference" to better
1455 • Robert Stayton: autotoc.xsl
1457 Support set as child of set in set.toc template.
1459 • Robert Stayton: qandaset.xsl
1461 Change question and title templates to replace hard-coded
1462 class="local-name()" with mode="class.attribute" to support customization
1465 • Norman Walsh: chunktoc.xsl
1467 Separate book appendixes from article appendixes (so that they can be customized independently)
1469 • Mauritz Jeanson: graphics.xsl
1471 Added condition to prevent "Failed to interpret image" messages (SVG is not supported
1472 by the graphic size extension).
1476 The following changes have been made to the epub code since the 1.76.1 release.
1478 • Robert Stayton: docbook.xsl
1480 Replace $base.dir with $chunk.base.dir to ensure trailing slash in place.
1484 The following changes have been made to the htmlhelp code since the 1.76.1
1487 • Robert Stayton: htmlhelp-common.xsl
1489 Change $base.dir to $chunk.base.dir to ensure trailing slash in place.
1493 The following changes have been made to the eclipse code since the 1.76.1
1496 • Robert Stayton: eclipse.xsl; eclipse3.xsl
1498 Use $chunk.base.dir instead of $base.dir to ensure trailing slash is in place.
1502 The following changes have been made to the javahelp code since the 1.76.1
1505 • Robert Stayton: javahelp.xsl
1507 Change $base.dir to $chunk.base.dir to ensure trailing slash is present.
1509 • Mauritz Jeanson: javahelp.xsl
1511 Replaced empty header.navigation and footer.navigation templates with parameter suppress.navigation=1,
1512 which simplifies customization. See bug #3310904.
1516 The following changes have been made to the webhelp code since the 1.76.1
1519 • David Cramer: template/common/css/positioning.css
1521 Webhelp: Adding print-only css rules
1523 • David Cramer: template/common/main.js
1525 Webhelp: Arun's fix for bug where heading was partially hidden by header in some situations.
1527 • David Cramer: xsl/webhelp-common.xsl
1529 Webhelp: turn off autolabeling by default
1531 • David Cramer: xsl/webhelp.xsl
1533 Webhelp: Import xhtml base stylesheets
1535 • David Cramer: docsrc/readme.xml
1537 Webhelp: Link to the DocBook reference docs from the webhelp readme
1539 • David Cramer: xsl/webhelp-common.xsl
1541 Webhelp: Use gentext value for noscript warning
1543 • David Cramer: Makefile
1545 Webhelp: Delete tempfile after DocBook xsl build
1547 • David Cramer: xsl/webhelp.xsl
1549 Webhelp: moving parameters into the standard location so they will be part of the parameter reference
1551 • David Cramer: xsl/webhelp.xsl; xsl/webhelp-common.xsl
1553 Webhelp: moving parameters into the standard location so they will be part of the parameter reference
1555 • David Cramer: template/common/main.js
1557 Webhelp: tweaking scrolldown offset for anchors
1559 • David Cramer: docsrc/images; docsrc/images/sample.jpg; docsrc/readme.xml;
1562 Webhelp: updating docs. Ant version, install instructions, handling of images.
1564 • David Cramer: xsl/webhelp.xsl
1566 Patch from Arun Bharadwaj to display message if JavaScript is disabled
1568 • David Cramer: template/content/search/nwSearchFnt.js
1570 Patch from Arun Bharadwaj to strip quotes from search query strings
1572 • Robert Stayton: xsl/webhelp.xsl
1574 Add basic support for new <topic> element.
1576 • Jirka Kosek: xsl/webhelp.xsl
1578 Put back old extensibility point.
1580 Guys, please don't remove existing extensibility points like named templates, it will break existing customizations.
1582 • David Cramer: xsl/webhelp.xsl
1584 Moving webhelp gentext strings into a context
1586 • tom_schr: param.ent
1588 Disabled branding and brandname entities for the time being
1590 • tom_schr: param.xweb; param.ent
1592 Prepared WebHelp reference documentation :)
1593 Not clear about parameters brandname and branding: Should they renamed
1594 to "webhelp.branding" and "webhelp.brandname"?
1595 Currently, docsrc/reference.xml contains only a comment for the WebHelp
1596 ref doc to be non-intrusive.
1597 Idea is to enable it when it is ready
1599 • tom_schr: xsl/webhelp.xsl
1601 Moved language specific of WebHelp to gentext/locale/ as discussed with
1602 Stefan following the "minimal intrusive approach". :)
1603 In the long run, maybe moving the text into a context, not sure.
1605 • David Cramer: template/common/css/positioning.css
1607 Webhelp: Lower the minimum width of content pane
1609 • kasunbg: xsl/webhelp.xsl; template/common/main.js
1611 If an user moved to another page by clicking on a toc link, and then clicked on #searchDiv,
1612 search should be performed if the cookie textToSearch is not empty.
1614 • David Cramer: xsl/webhelp.xsl
1616 Webhelp: Left align titles in nav header. Display for all but the topmost page
1618 • David Cramer: template/content/search/stemmers/en_stemmer.js; docsrc/
1621 Webhelp: Cleanup related to en_stemmer.js changes
1623 • David Cramer: template/common/css/positioning.css
1625 Webhelp: Don't put borders around qandaset list
1627 • David Cramer: template/common/main.js
1629 Webhelp: Avoid unnecessary scroll ups when anchor is clicked on
1631 • David Cramer: build.properties
1633 Webhelp: Show footer nav by default
1635 • David Cramer: build.properties; build.xml
1637 Webhelp: Support setting suppress.footer.navigation from build.properties
1639 • David Cramer: build.properties; build.xml
1641 Webhelp: Support admon.graphics param in build.properties
1643 • David Cramer: docsrc/xinclude-test.xml; docsrc/readme.xml
1645 Webhelp: Adding xinclude example to the demo/readme doc
1647 • David Cramer: template/common/css/positioning.css
1649 Webhelp: Remove border around table used to format callout list
1651 • David Cramer: xsl/webhelp.xsl; template/common/images/admon/tip.png;
1652 template/common/image⋯
1654 Webhelp: Support admon graphics (still off by default)
1656 • David Cramer: xsl/webhelp.xsl; template/common/css/positioning.css
1658 Webhelp: Turn on navfooter and fix related css
1660 • David Cramer: xsl/webhelp.xsl
1662 Webhelp: Fix error about undeclared doc.title param
1664 • David Cramer: docsrc/readme.xml
1666 Webhelp: Adding some test search terms to the readme
1668 • David Cramer: template/content/search/stemmers/en_stemmer.js
1670 Handle exceptional cases listed in the Porter 2 stemming algo
1672 • David Cramer: template/content/search/stemmers/en_stemmer.js
1674 Webhelp: adding special case word 'say' to en js stemmer
1676 • David Cramer: template/content/search/stemmers/en_stemmer.js
1678 Webhelp: Refine stemming of terms that end in (only stem if there's a consonant before the -y)
1680 • David Cramer: template/content/search/stemmers/en_stemmer.js; template/
1681 content/search/nwSe⋯
1683 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
1685 • David Cramer: build.xml
1687 Webhelp: Support xinclude and two-pass profiling in build.xml
1689 • David Cramer: xsl/webhelp.xsl
1691 Fix bad link to default topic.
1693 • kasunbg: docsrc/readme.xml
1695 Automatically limit the size of the search description to something 140 characters
1697 • kasunbg: xsl/webhelp.xsl
1699 removing outline in 'contents' and 'search' buttons that is visible when clicked. tabindex for SIDEBAR button.
1701 • kasunbg: xsl/webhelp.xsl; build.xml
1703 Webhelp ant script changes - HTML transformation support for WebHelp - Uses Tagsoup for parsing the bad html.
1704 tagsoup-1.2.1.jar is added to trunk/xsl-webhelpindexer/lib/
1706 • kasunbg: xsl/webhelp.xsl
1708 proper support for saxon xhtml transformation.
1710 • kasunbg: template/common/images/callouts/10.png; template/common/images/
1713 webhelp - adding callouts
1715 • kasunbg: xsl/webhelp.xsl; template/common/main.js; template/common/css/
1718 webhelp - animations for show/hide Sidebar
1720 • kasunbg: build.properties
1722 commenting about brand and brandname
1726 parameterized MAKE for webhelp
1728 • kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css;
1729 build.properties; build.xml
1731 webhelp xsl customization - logo
1733 • kasunbg: template/content/search/nwSearchFnt.js
1735 remove some JS warninings
1737 • kasunbg: template/content/search/nwSearchFnt.js
1739 Fix for missing "No results found for..." bug
1741 • kasunbg: xsl/webhelp.xsl
1743 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.
1745 • Jirka Kosek: xsl/webhelp.xsl; template/common/css/positioning.css
1747 Minor cleanup, added extensibility hook, some styling moved into CSS for easier customization
1749 • David Cramer: template/content/search/nwSearchFnt.js
1751 Removing onclick that came from Oxygen's dita stuff
1753 • kasunbg: docsrc/readme.xml
1755 webhelp - documenting about features
1757 • kasunbg: template/common/css/positioning.css
1759 webhelp search text box
1761 • kasunbg: template/common/css/positioning.css
1763 adding header background image
1765 • kasunbg: xsl/webhelp.xsl; template/common/images/header-bg.png
1767 new header background image
1769 • kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css
1773 • kasunbg: template/common/css/positioning.css
1777 • kasunbg: build.xml
1779 Adding html.extension property
1781 • kasunbg: template/common/css/positioning.css; build.properties; build.xml
1783 webhelp - Adding enable.stemming, toc.file build properties
1785 • David Cramer: template/common/css/positioning.css
1787 Make the webhelp banner slightly larger.
1789 • David Cramer: template/common/main.js; template/common/css/positioning.css
1791 Adjust colors and positioning of header and search/toc tabs
1793 • David Cramer: xsl/webhelp.xsl
1795 Only put doc title in header
1797 • David Cramer: template/common/css/positioning.css; template/common/images/
1800 Adjusting default color of the header
1802 • kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css
1804 adjustments to header title. Now output in Opera looks good.
1806 • kasunbg: template/common/images/sidebar.png; template/content/search/
1807 punctuation.props; te⋯
1809 deleting svn:executable flag from webhelp files
1811 • kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css; template/
1814 Customized the left navagation headers; Contents and Search.
1815 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.
1817 • kasunbg: docsrc/readme.xml
1821 • kasunbg: template/common/images/next-arrow.png; xsl/webhelp.xsl; template/
1825 Moved search highligher to search tab.
1826 Added nice icons for navigation buttons etc.
1827 Removed footer navigation
1828 Corrected tree colorings
1829 Overall, some css magic
1831 • David Cramer: docsrc/readme.xml
1833 Added listitem thinking SyncRO Soft for their contributions.
1835 • kasunbg: build.xml
1837 support for default classpath for Gentoo Linux
1839 • kasunbg: docsrc/readme.xml
1841 webhelp - some updates to the documentation about search
1843 • kasunbg: template/common/css/positioning.css
1845 Fix for issue 'Keep "search" & "contents" titles always visible in webhelp - ID: 3403438'
1847 • David Cramer: template/common/images/starsSmall.png
1849 Changed icons used to show search weightings from stars to boxes so they won't look like user ratings
1851 • David Cramer: xsl/webhelp.xsl; template/common/main.js; template/common/
1854 Merged Oxygen webhelp improvements (search weightings etc) into trunk: -r9031:9039
1856 • kasunbg: docsrc/readme.xml
1858 webhelp documentation - search indexing, faq
1860 • kasunbg: docsrc/readme.xml
1862 update webhelp documentation
1864 • David Cramer: xsl/webhelp.xsl
1866 Fixed bug where webhelp.default.topic was not being used if it was set
1868 • David Cramer: xsl/webhelp.xsl; template/content/search/nwSearchFnt.js
1870 Localize string in nwSearchFnt.js file
1872 • David Cramer: xsl/webhelp.xsl
1874 Added tabindex attributes to make tab order in UI more logical in webhelp.
1876 • David Cramer: template/common/main.js
1878 Fixed bug where anchors in pages landed beneath the banner.
1880 • kasunbg: xsl/webhelp.xsl
1882 Added more comments to the xsl/webhelp/xsl/webhelp.xsl file. Removed some clutter.
1884 • David Cramer: template/common/main.js
1886 Fixed problem reported in IE 8. See tracker id # 373747.
1888 • David Cramer: xsl/webhelp.xsl
1890 Addressed tracker #3247166 by removing hard-coded reference to ch01.html.
1892 • kasunbg: build.xml
1894 Changed the webhelp build.xml to reflect the changes to xsl-webhelpindexer.
1895 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
1897 • kasunbg: template/common/images/loading.gif; template/common/jquery/
1898 treeview/jquery.treevi⋯
1900 webhelp: Removing some unnecessary JQuery JS files
1902 • kasunbg: template/common/main.js
1904 webhelp: Usability improvement - when click on a node in the TOC tree, the child nodes will auto populate now.
1906 • kasunbg: xsl/webhelp.xsl
1908 Added google translated localizations for Japanese, German, French, and Chinese. The translations might not be pretty accurate.
1909 Better translations are appreciated.
1911 • kasunbg: docsrc/readme.xml; template/content/images; template/content/
1914 Added documentation for how to add images to WebHelp
1916 • Jirka Kosek: xsl/webhelp.xsl
1918 Added more customization hooks
1919 Search code output only when search tab is active
1920 Added cs localization
1922 • Jirka Kosek: xsl/webhelp.xsl
1924 Added parameter webhelp.common.dir for specifying location of common files (JS+CSS)
1925 Added hooks for adding additional user defined tabs
1929 The following changes have been made to the params code since the 1.76.1
1932 • David Cramer: webhelp.indexer.language.xml
1934 Webhelp: Fixing list of supported languages
1936 • David Cramer: webhelp.indexer.language.xml
1938 Webhelp: Correct language code in docs for Chinese
1940 • Mauritz Jeanson: admon.graphics.extension.xml
1942 Added list of graphics formats.
1944 • Mauritz Jeanson: passivetex.extensions.xml
1948 • tom_schr: webhelp.indexer.language.xml; webhelp.default.topic.xml;
1949 webhelp.tree.cookie.id.⋯
1951 Prepared WebHelp reference documentation :)
1952 Not clear about parameters brandname and branding: Should they renamed
1953 to "webhelp.branding" and "webhelp.brandname"?
1954 Currently, docsrc/reference.xml contains only a comment for the WebHelp
1955 ref doc to be non-intrusive.
1956 Idea is to enable it when it is ready
1958 • Robert Stayton: glossary.collection.xml
1960 Add info about relative paths.
1962 • Robert Stayton: para.properties.xml
1964 Special attribute-set for para only.
1966 • Robert Stayton: table.caption.properties.xml
1968 To format table captions.
1970 • Robert Stayton: html.script.type.xml; html.script.xml
1972 Add support for specifying javascript references like css references.
1974 • Robert Stayton: body.margin.outer.xml; region.outer.extent.xml;
1975 body.margin.inner.xml; reg⋯
1977 Add support for side regions in FO output.
1979 • Robert Stayton: chunked.filename.prefix.xml
1981 New param chunked.filename.prefix to separate any such prefix from
1982 the base.dir param, which helps fix bug 3087359.
1984 • Robert Stayton: generate.consistent.ids.xml
1986 New param to support replacing generate-id() with xsl:number
1987 for more consistent id values.
1989 • Robert Stayton: task.properties.xml
1991 Allow task to be customized more easily.
1993 • Robert Stayton: calloutlist.properties.xml; callout.properties.xml
1995 Support better customization of callout lists.
1997 • Jirka Kosek: callout.unicode.start.character.xml
1999 Added support for alternative circled numbers
2001 • David Cramer: example.properties.xml
2003 Made example.properties use keep-together='auto' like table.properies to avoid problems where example/programlisting takes more than one page
2005 • Mauritz Jeanson: graphicsize.extension.xml
2007 Added info about supported image formats.
2011 The following changes have been made to the highlighting code since the 1.76.1
2014 • Jirka Kosek: csharp-hl.xml
2018 • Jirka Kosek: delphi-hl.xml
2020 Additional keywords from Yuri Zhilin
2024 The following changes have been made to the profiling code since the 1.76.1
2027 • David Cramer: profile-mode.xsl
2029 When profile.* params only consist of space characters, then ignore them.
2033 The following changes have been made to the lib code since the 1.76.1 release.
2035 • Robert Stayton: lib.xweb
2037 Added two utility templates to make lib.xsl work
2038 without reference to other modules since it is used
2039 that way with profiling/xsl2profile.xsl.
2041 • Robert Stayton: lib.xweb
2043 Fix trim.common.uri.paths to first resolve any ../ in
2048 The following changes have been made to the template code since the 1.76.1
2051 • Jirka Kosek: titlepage.xsl
2053 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.
2057 The following changes have been made to the extensions code since the 1.76.1
2062 webhelp - Adding enable.stemming, toc.file build properties
2064 • David Cramer: Makefile
2066 Attempt to convince Makefile that webhelpindexer is dirty
2070 The following changes have been made to the xsl-saxon code since the 1.76.1
2073 • Mauritz Jeanson: src/com/nwalsh/saxon/Verbatim.java; src/com/nwalsh/saxon/
2076 Added fixes to ensure that generated XHTML markup for callouts is in the proper namespace.
2078 Release Notes: 1.77.1
2080 The following is a list of changes that have been made since the 1.77.0
2085 The following changes have been made to the fo code since the 1.77.0 release.
2087 • Robert Stayton: docbook.xsl
2089 Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
2092 • Robert Stayton: block.xsl
2094 In sidebar, turn off space before first para if there is no title.
2096 • Robert Stayton: math.xsl
2098 Restored templates for mml:* elements that were accidentally deleted.
2102 The following changes have been made to the html code since the 1.77.0 release.
2104 • Robert Stayton: docbook.xsl
2106 Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
2109 • Robert Stayton: sections.xsl
2111 Use $div.element variable in place of div to support html5 section element.
2114 • Robert Stayton: autoidx.xsl
2116 Fix bug 3528673, missing "separator" param on template with
2117 match="indexterm" mode="reference". That param is passed
2118 for endofrange processing to output the range separator.
2122 The following changes have been made to the roundtrip code since the 1.77.0
2125 • Robert Stayton: dbk2ooo.xsl; dbk2pages.xsl; dbk2wordml.xsl; dbk2wp.xsl
2127 Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
2132 The following changes have been made to the slides code since the 1.77.0
2135 • Robert Stayton: html/slides-common.xsl
2137 Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
2142 The following changes have been made to the website code since the 1.77.0
2145 • Robert Stayton: website-common.xsl
2147 Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
2152 The following changes have been made to the webhelp code since the 1.77.0
2155 • kasunbg: docsrc/readme.xml
2157 updated webhelp documentation
2159 • kasunbg: template/content/search/nwSearchFnt.js; xsl/webhelp-common.xsl
2161 Removed the script htmlFileList.js since it's content is in htmlFileInfoList.js
2163 • Robert Stayton: xsl/webhelp-common.xsl
2165 In the <h1> output, replace call to 'get.doc.title' with
2166 mode="title.markup" because get.doc.title returns only
2167 the string value of the title, losing any markup such
2168 as <trademark> or <superscript>.
2170 • kasunbg: template/common/css/positioning.css; template/content/search/
2173 Remove unnecessary bits of code from webhelp
2175 • David Cramer: docsrc/readme.xml
2177 Webhelp: Minor edits to the readme
2179 • David Cramer: xsl/webhelp.xsl; xsl/titlepage.templates.xsl; xsl/
2180 titlepage.templates.xml
2182 Webhelp: Suppress abstracts from titlepages. These are used to create the search result summary sentence and should not be shown
2184 • David Cramer: build.xml
2186 Webhelp: calculate path to profile.xsl from main build.xml file
2188 Release Notes: 1.76.1
2190 The following is a list of changes that have been made since the 1.76.0
2195 The following changes have been made to the fo code since the 1.76.0 release.
2197 • Robert Stayton: docbook.xsl; xref.xsl; fop1.xsl
2199 Apply patch to support named destination in fop1.xsl, per Sourceforge
2200 bug report #3029845.
2204 The following changes have been made to the html code since the 1.76.0 release.
2206 • Keith Fahlgren: highlight.xsl
2208 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)
2212 The following changes have been made to the params code since the 1.76.0
2215 • Robert Stayton: draft.mode.xml
2217 Change default for draft.mode to 'no'.
2219 Release Notes: 1.76.0
2221 This release includes important bug fixes and adds the following significant
2226 A new browser-based, cross-platform help format with full-text search and
2227 other features typically found in help systems. See webhelp/docs/content/
2228 ch01.html for more information and a demo.
2232 Many updates and additions to translation/locales thanks to Red Hat, the
2233 Fedora Project, and other contributors.
2237 Faster localization support, as language files are loaded on demand.
2241 Support for SVG content in imagedata added.
2245 Output improved when using 'make.clean.html' and a stock CSS file is now
2250 A number of improvements to NCX, cover and image selection, and XHTML 1.1
2253 The following is a list of changes that have been made since the 1.75.2
2258 The following changes have been made to the gentext code since the 1.75.2
2261 • rlandmann: locale/fa.xml
2263 Update to Persian translation from the Fedora Project
2266 • rlandmann: locale/nds.xml
2268 Locale for Low German
2271 • Mauritz Jeanson: locale/ka.xml; Makefile
2273 Added support for Georgian based on patch #2917147.
2276 • rlandmann: locale/nl.xml; locale/ja.xml
2278 Updated translations from Red Hat and the Fedora Project
2281 • rlandmann: locale/bs.xml; locale/ru.xml; locale/hr.xml
2283 Updated locales from Red Hat and the Fedora Project
2286 • rlandmann: locale/pt.xml; locale/cs.xml; locale/es.xml; locale/bg.xml;
2287 locale/nl.xml; loca⋯
2289 Updated translations from Red Hat and the Fedora Project
2292 • rlandmann: locale/as.xml; locale/bn_IN.xml; locale/ast.xml; locale/ml.xml;
2295 New translations from Red Hat and the Fedora Project
2298 • rlandmann: locale/pt.xml; locale/ca.xml; locale/da.xml; locale/sr.xml;
2299 locale/ru.xml; loca⋯
2301 Updated translations from Red Hat and the Fedora Project
2306 The following changes have been made to the common code since the 1.75.2
2309 • Mauritz Jeanson: common.xsl
2311 Fixed bug in output-orderedlist-starting-number template (@startingnumber did not work for FO).
2314 • Mauritz Jeanson: gentext.xsl
2316 Added fix to catch ID also of descendants of listitem. Closes bug #2955077.
2319 • Jirka Kosek: l10n.xsl
2321 Stripped down, faster version of gentext.template is used when there is no localization customization.
2324 • Mauritz Jeanson: stripns.xsl
2326 Added fix that preserves link/@role (makes links in the reference documentation
2327 with @role="tcg" work).
2330 • Mauritz Jeanson: l10n.xsl
2332 Fixed bugs related to manpages and L10n.
2335 • Jirka Kosek: entities.ent; autoidx-kosek.xsl
2337 Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.
2340 • Jirka Kosek: l10n.xsl; l10n.dtd; l10n.xml; autoidx-kosek.xsl
2342 Refactored localization support. Language files are loaded on demand. Speedup is about 30%.
2345 • Jirka Kosek: l10n.xsl
2347 Added xsl:keys for improved performance of localization texts look up. Performance gain around 15%.
2350 • Mauritz Jeanson: titles.xsl
2352 Fixed bug #2912677 (error with xref in title).
2355 • Robert Stayton: olink.xsl
2357 Fix bug in xrefstyle "title" handling introduced with
2358 the 'insert.targetdb.data' template.
2361 • Robert Stayton: gentext.xsl
2363 Fix bug in xref to equation without title to use context="xref-number" instead
2364 of "xref-number-and-title".
2367 • Robert Stayton: labels.xsl
2369 Number all equations in one sequence, with or without title.
2372 • Robert Stayton: entities.ent
2374 Fix bug #2896909 where duplicate @sortas on indexterms caused
2375 some indexterms to drop out of index.
2378 • Robert Stayton: stripns.xsl
2380 Expand the "Stripping namespace ..." message to advise users to
2381 use the namespaced stylesheets.
2384 • Robert Stayton: stripns.xsl
2386 need a local version of $exsl.node.set.available variable because
2387 this module imported many places.
2390 • Mauritz Jeanson: olink.xsl
2392 Added /node() to the select expression that is used to compute the title text
2393 so that no <ttl> elements end up in the output. Closes bug #2830119.
2398 The following changes have been made to the fo code since the 1.75.2 release.
2400 • Robert Stayton: table.xsl
2402 Fix bug 2979166 able - Attribute @rowheader not working
2405 • Mauritz Jeanson: inline.xsl
2407 Improved glossterm auto-linking by using keys. The old code was inefficient when processing documents
2408 with many inline glossterms.
2411 • Robert Stayton: titlepage.xsl
2413 Fix bug 2805530 author/orgname not appearing on title page.
2416 • Mauritz Jeanson: graphics.xsl
2418 Added support for SVG content in imagedata (inspired by patch #2909154).
2421 • Mauritz Jeanson: table.xsl
2423 Removed superfluous test used when computing column-width. Closes bug #3000898.
2426 • Mauritz Jeanson: inline.xsl
2428 Added missing <xsl:call-template name="anchor"/>. Closes bug #2998567.
2431 • Mauritz Jeanson: lists.xsl
2433 Added table-layout="fixed" on segmentedlist table (required by XSL spec when proportional-column-width() is used).
2436 • Jirka Kosek: autoidx-kosek.xsl
2438 Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.
2441 • Jirka Kosek: index.xsl
2443 Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.
2446 • Robert Stayton: xref.xsl
2448 Fix bug in olink template when an olink has an id.
2449 Add warning message with id value when trying to link
2450 to an element that has no generated text.
2453 • Mauritz Jeanson: refentry.xsl
2455 Fixed bug #2930968 (indexterm in refmeta not handled correctly).
2458 • Robert Stayton: block.xsl
2460 fix bug 2949567 title in revhistory breaks FO transform.
2463 • Robert Stayton: glossary.xsl
2465 Output id attributes on glossdiv blocks so they can be added to
2469 • Jirka Kosek: xref.xsl
2471 Enabled hyphenation of URLs when ulink content is the same as link target
2474 • Robert Stayton: table.xsl
2476 Apply patch to turn off row recursion if no @morerows attributes present.
2477 This will enable very large tables without row spanning to
2478 process without running into recursion limits.
2481 • Robert Stayton: formal.xsl
2483 Format equation without title using table layout with equation number
2484 next to the equation.
2487 • Robert Stayton: param.xweb; param.ent
2489 Add equation.number.properties.
2494 The following changes have been made to the html code since the 1.75.2 release.
2496 • Mauritz Jeanson: block.xsl
2498 Modified acknowledgements template to avoid invalid output (<p> in <p>).
2501 • Mauritz Jeanson: titlepage.xsl
2503 Added default sidebar attribute-sets.
2506 • Robert Stayton: table.xsl
2508 Fix bug 2979166 able - Attribute @rowheader not working
2511 • Robert Stayton: footnote.xsl
2513 Fix bug 3033191 footnotes in html tables.
2516 • Mauritz Jeanson: inline.xsl
2518 Improved glossterm auto-linking by using keys. The old code was inefficient when processing documents
2519 with many inline glossterms.
2522 • Robert Stayton: docbook.css.xml; verbatim.xsl
2524 Fix bug 2844927 Validity error for callout bugs.
2527 • Robert Stayton: formal.xsl
2529 Convert formal.object.heading to respect make.clean.html param.
2532 • Robert Stayton: titlepage.templates.xml; block.xsl
2534 Fix bug 2840768 sidebar without title inserts empty b tag.
2537 • Mauritz Jeanson: docbook.xsl
2539 Moved the template that outputs <base> so that the base URI also applies to relative CSS paths that come later.
2543 • Jirka Kosek: autoidx-kosek.xsl
2545 Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.
2548 • Robert Stayton: chunk-code.xsl
2550 fix bug 2948363 generated filename for refentry not unique, when
2554 • Robert Stayton: component.xsl
2556 Fix missing "Chapter n" label when use chapter/info/title.
2559 • Robert Stayton: table.xsl
2561 Row recursion turned off if no @morerows attributes in the table.
2562 This will prevent failure on long table (with no @morerows) due
2563 to excessive depth of recursion.
2566 • Robert Stayton: autotoc.xsl; docbook.css.xml
2568 Support make.clean.html in autotoc.xsl.
2571 • Robert Stayton: docbook.css.xml; block.xsl
2573 Add support for make.clean.html setting in block elements.
2576 • Robert Stayton: docbook.css.xml
2578 Stock CSS styles for DocBook HTML output when 'make.clean.html' is non-zero.
2581 • Robert Stayton: html.xsl
2583 Add templates for generating CSS files and links to them.
2586 • Robert Stayton: param.xweb
2588 Fix bugs in new entity references.
2591 • Robert Stayton: chunk-common.xsl
2593 List of Equations now includes on equations with titles.
2596 • Robert Stayton: table.xsl
2598 If a colspec has a colname attribute, add it to the HTML col
2599 element as a class attribute so it can be styled.
2602 • Robert Stayton: formal.xsl
2604 Fix bug 2825842 where table footnotes not appearing in HTML-coded table.
2607 • Robert Stayton: chunktoc.xsl
2609 Fix bug #2834826 where appendix inside part was not chunked as it should be.
2612 • Mauritz Jeanson: chunktoc.xsl
2614 Added missing namespace declarations. Closes bug #2890069.
2617 • Mauritz Jeanson: footnote.xsl
2619 Updated the template for footnote paras to use the 'paragraph' template. Closes bug #2803739.
2622 • Keith Fahlgren: inline.xsl; lists.xsl
2624 Remove <b> and <i> elements "discouraged in favor of style sheets" from
2625 XHTML, XHTML 1.1 (and therefore EPUB) outputs by changing html2xhtml.xsl.
2627 Fixes bug #2873153: No <b> and <i> tags in XHTML/EPUB
2629 Added regression to EPUB specs:
2632 • Mauritz Jeanson: inline.xsl
2634 Fixed bug #2844916 (don't output @target if ulink.target is empty).
2637 • Keith Fahlgren: autoidx.xsl
2639 Fix a bug when using index.on.type: an 'index symbols' section was created
2640 even if that typed index didn't include any symbols (they were in the other types).
2645 The following changes have been made to the manpages code since the 1.75.2
2648 • Mauritz Jeanson: other.xsl
2650 Modified the write.stubs template so that the section directory name is not output twice. Should fix bug #2831602.
2651 Also ensured that $lang is added to the .so path (when man.output.lang.in.name.enabled=1).
2654 • Mauritz Jeanson: docbook.xsl; other.xsl
2656 Fixed bug #2412738 (apostrophe escaping) by applying the submitted patch.
2659 • Norman Walsh: block.xsl; endnotes.xsl
2661 Fix bug where simpara in footnote didn't work. Patch by Jonathan Nieder, jrnieder@gmail.com
2664 • dleidert: lists.xsl
2666 Fix two indentation issues: In the first case there is no corresponding .RS
2667 macro (Debian #519438, sf.net 2793873). In the second case an .RS instead of
2668 the probably intended .sp leads to an indentation bug (Debian #527309,
2674 The following changes have been made to the epub code since the 1.75.2 release.
2676 • Keith Fahlgren: bin/spec/examples/AMasqueOfDays.epub; docbook.xsl; bin/spec
2679 Resolve some actual regressions in date output spotted by more recent versions of epubcheck
2682 • Keith Fahlgren: docbook.xsl
2684 Updated mediaobject selection code that better uses roles (when available); based on contributons by Glenn McDonald
2687 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
2689 Ensure that NCX documents are always outputted with a default namespace
2690 to prevent problems with the kindlegen machinery
2693 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
2694 partintro.xml; docbook.x⋯
2696 Adding support for partintros with sect2s, 3s, etc
2699 • Keith Fahlgren: docbook.xsl
2701 Adding param to workaround horrific ADE bug with the inability to process <br>
2704 • Keith Fahlgren: docbook.xsl
2706 Add support for authorgroup/author in OPF metadata (via Michael Wiedmann)
2709 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb
2711 Remove <b> and <i> elements "discouraged in favor of style sheets" from
2712 XHTML, XHTML 1.1 (and therefore EPUB) outputs by changing html2xhtml.xsl.
2714 Fixes bug #2873153: No <b> and <i> tags in XHTML/EPUB
2716 Added regression to EPUB specs:
2719 • Keith Fahlgren: bin/lib/docbook.rb; bin/spec/files/DejaVuSerif-Italic.otf;
2722 This resolves bug #2873142, Please add support for multiple embedded fonts
2725 If you navigate to a checkout of DocBook-XSL and go to:
2726 xsl/epub/bin/spec/files
2727 You can now run the following command:
2729 ../../dbtoepub -f DejaVuSerif.otf -f DejaVuSerif-Italic.otf -c test.css
2730 -s test_cust.xsl orm.book.001.xml
2732 In dbtoepub, the following option can be used more than once:
2733 -f, --font [OTF FILE] Embed OTF FILE in .epub.
2735 The underlying stylesheet now accepts a comma-separated list of font file
2736 names rather than just one as the RENAMED epub.embedded.fonts ('s' added).
2738 The runnable EPUB spec now includes:
2739 - should be valid .epub after including more than one embedded font
2742 • Keith Fahlgren: docbook.xsl
2744 Improve the selection of cover images when working in DocBook 4.x land (work in progress)
2747 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
2749 Improve the quality of the OPF spine regression by ensuring that the spine
2750 elements for deeply nested refentries are in order and adjacent to their
2751 opening wrapper XHTML chunk.
2754 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/
2757 Add more careful handling of refentries to ensure that they always appear in the opf:spine.
2758 This was only a problem when refentries were pushed deep into the hierarchy (like inside
2759 a sect2), but presented navigational problems for many reading systems (despite the
2760 correct NCX references). This may *not* be the best solution, but attacking a better
2761 chunking strategy for refentries was too big a nut to crack at this time.
2766 The following changes have been made to the eclipse code since the 1.75.2
2769 • Mauritz Jeanson: eclipse3.xsl
2771 Added a stylesheet module that generates plug-ins conforming to the standard (OSGi-based) Eclipse 3.x
2772 architecture. The main difference to the older format is that metadata is stored in a separate
2773 manifest file. The module imports and extends the existing eclipse.xsl module. Based on code
2774 contributed in patch #2624668.
2779 The following changes have been made to the params code since the 1.75.2
2782 • Robert Stayton: draft.watermark.image.xml
2784 Fix bug 2922488 draft.watermark.image pointing to web resource.
2785 Now the value is images/draft.png, and may require customization
2786 for local resolution.
2789 • Mauritz Jeanson: equation.number.properties.xml
2791 Corrected refpurpose.
2794 • Norman Walsh: paper.type.xml
2796 Added USlegal and USlegallandscape paper types.
2799 • Jirka Kosek: highlight.xslthl.config.xml
2801 Added note about specifying location as URL
2804 • Robert Stayton: docbook.css.source.xml; generate.css.header.xml;
2805 custom.css.source.xml; ma⋯
2807 Params to support generated CSS files.
2810 • Robert Stayton: equation.number.properties.xml
2812 New attribute set for numbers appearing next to equations.
2817 The following changes have been made to the xsl-xalan code since the 1.75.2
2820 • dleidert: nbproject/genfiles.properties; nbproject/build-impl.xml
2822 Rebuild netbeans build files after adding missing Netbeans configuration to allow easier packaging for Debian.
2825 Release Notes: 1.75.2
2827 The following is a list of changes that have been made since the 1.75.1
2832 The following changes have been made to the gentext code since the 1.75.1
2835 • dleidert: locale/ja.xml
2837 Improved Japanese translation for Note(s). Closes bug #2823965.
2839 • dleidert: locale/pl.xml
2841 Polish alphabet contains O with acute accent, not with grave accent. Closes bug #2823964.
2843 • Robert Stayton: locale/ja.xml
2845 Fix translation of "index", per bug report 2796064.
2847 • Robert Stayton: locale/is.xml
2849 New Icelandic locale file.
2853 The following changes have been made to the common code since the 1.75.1
2856 • Norman Walsh: stripns.xsl
2858 Support more downconvert cases
2860 • Robert Stayton: titles.xsl
2862 Make sure title inside info is used if no other title.
2866 The following changes have been made to the fo code since the 1.75.1 release.
2868 • Robert Stayton: pi.xsl
2870 Turn off dbfo-need for fop1.extensions also, per bug #2816141.
2874 The following changes have been made to the html code since the 1.75.1 release.
2876 • Mauritz Jeanson: titlepage.xsl
2878 Output "Copyright" heading in XHTML too.
2880 • Mauritz Jeanson: titlepage.xsl
2882 Added stylesheet.result.type test for copyright. Closes bug #2813289.
2884 • Norman Walsh: htmltbl.xsl
2886 Remove ambiguity wrt @span, @rowspan, and @colspan
2890 The following changes have been made to the manpages code since the 1.75.1
2893 • Mauritz Jeanson: endnotes.xsl
2895 Added normalize-space() for ulink content. Closes bug #2793877.
2897 • Mauritz Jeanson: docbook.xsl
2899 Added stylesheet.result.type test for copyright. Closes bug #2813289.
2903 The following changes have been made to the epub code since the 1.75.1 release.
2905 • Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb
2907 Corrected bugs caused by path and file assumptions were not met
2909 • Keith Fahlgren: bin/lib/docbook.rb; docbook.xsl
2911 Cleaning up hardcoded values into parameters and fixing Ruby library to pass them properly; all thanks to patch from Liza Daly
2915 The following changes have been made to the profiling code since the 1.75.1
2918 • Robert Stayton: profile.xsl
2920 Fix bug 2815493 missing exsl.node.set.available parameter.
2924 The following changes have been made to the xsl-saxon code since the 1.75.1
2927 • Mauritz Jeanson: src/com/nwalsh/saxon/ColumnUpdateEmitter.java; src/com/
2930 Added fixes so that colgroups in the XHTML namespace are processed properly.
2934 The following changes have been made to the xsl-xalan code since the 1.75.1
2937 • Mauritz Jeanson: nbproject/project.xml
2939 Added missing NetBeans configuration.
2941 Release Notes: 1.75.1
2943 This release includes bug fixes.
2945 The following is a list of changes that have been made since the 1.75.0
2950 The following changes have been made to the fo code since the 1.75.0 release.
2952 • Keith Fahlgren: block.xsl
2954 Switching to em dash for character before attribution in epigraph; resolves Bug #2793878
2956 • Robert Stayton: lists.xsl
2958 Fixed bug 2789947, id attribute missing on simplelist fo output.
2962 The following changes have been made to the html code since the 1.75.0 release.
2964 • Keith Fahlgren: block.xsl
2966 Switching to em dash for character before attribution in epigraph; resolves Bug #2793878
2968 • Robert Stayton: lists.xsl
2970 Fixed bug 2789678: apply-templates line accidentally deleted.
2974 The following changes have been made to the epub code since the 1.75.0 release.
2976 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
2978 Added regression and fix to correct "bug" with namespace-prefixed container elements in META-INF/container.xml ; resolves Issue #2790017
2980 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
2981 onegraphic.xinclude.xml;⋯
2983 Another attempt at flexible named entity and XInclude processing
2985 • Keith Fahlgren: bin/lib/docbook.rb
2987 Tweaking solution to Bug #2750442 following regression reported by Michael Wiedmann.
2991 The following changes have been made to the params code since the 1.75.0
2994 • Mauritz Jeanson: highlight.source.xml
2996 Updated documentation to reflect changes made in r8419.
2998 Release Notes: 1.75.0
3000 This release includes important bug fixes and adds the following significant
3005 Modifications to translations have been made.
3009 Added support for some format properties on tables using HTML table markup.
3011 Added two new qanda.defaultlabel values so that numbered sections and
3012 numbered questions can be distinguished. Satisfies Feature Request #
3015 Added code to handle acknowledgements in book and part. The element is
3016 processed similarly to dedication. All acknowledgements will appear as
3017 front matter, after any dedications.
3021 The inclusion of highlighting code has been simplified.
3023 Add support for pgwide on informal objects.
3025 Added a new parameter, bookmarks.collapse, that controls the initial state
3026 of the bookmark tree. Closes FR #1792326.
3028 Add support for more dbfo processing instructions.
3030 Add new variablelist.term.properties to format terms, per request #
3033 Add support for @width on screen and programlisting, fixes bug #2012736.
3035 Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.
3037 Add writing.mode param for FO output.
3041 Convert all calls to class.attribute to calls to common.html.attributes to
3042 support dir, lang, and title attributes in html output for all elements.
3043 Fulfills feature request #1993833.
3045 Inclusion of highlighting code was simplified. Only one import is now
3048 Add new param index.links.to.section.
3050 Add support for the new index.links.to.section param which permits precise
3051 links to indexterms in HTML output rather than to the section title.
3055 Slightly more nuanced handling of imageobject alternatives and better
3056 support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442
3057 reported by Raphael Hertzog.
3059 Added a colon after an abstract/title when mapping into the dc:description
3060 for OPF metadata in ePub output to help the flat text have more
3061 pseudo-semantics (sugestions from Michael Wiedmann)
3063 Added DocBook subjectset -> OPF dc:subject mapping and tests
3065 Added DocBook date -> OPF dc:date mapping and tests
3067 Added DocBook abstract -> OPF dc:description mapping and tests
3069 Added --output option to dbtoepub based on user request
3073 Add support for generating olink target database for htmlhelp files.
3077 Add default setting for @rules attribute on HTML markup tables.
3079 Added a new parameter, bookmarks.collapse, that controls the initial state
3080 of the bookmark tree. When the parameter has a non-zero value (the
3081 default), only the top-level bookmarks are displayed initially. Otherwise,
3082 the whole tree of bookmarks is displayed. This is implemented for FOP 0.9X.
3085 Add new variablelist.term.properties to format terms, per request #
3088 Add two new qanda.defaultlabel values so that numbered sections and
3089 numbered questions can be distinguished. Satisfies Feature Request #
3092 Add param to control whether an index entry links to a section title or to
3093 the precise location of the indexterm.
3095 New attribute list for glossentry in glossary.
3097 New parameter to support @width on programlisting and screen.
3099 Add attribute-sets for formatting glossary terms and defs.
3103 Inclusion of highlighting code was simplified. Only one import is now
3106 The following is a list of changes that have been made since the 1.74.3
3111 The following changes have been made to the gentext code since the 1.74.3
3114 • Robert Stayton: locale/sv.xml; locale/ja.xml; locale/pl.xml
3116 Check in translations of Legalnotice submitted on mailing list.
3118 • Robert Stayton: locale/es.xml
3120 Fix spelling errors in Acknowledgements entries.
3122 • Robert Stayton: locale/es.xml
3124 Check in translations for 4 elements submitted through docbook-apps
3125 message of 14 April 2009.
3127 • David Cramer: locale/zh.xml; locale/ca.xml; locale/ru.xml; locale/ga.xml;
3130 Internationalized punctuation in glosssee and glossseealso
3132 • Robert Stayton: Makefile
3134 Check in fixes for DSSSL gentext targets from submitted patch #1689633.
3136 • Robert Stayton: locale/uk.xml
3138 Check in major update submitted with bug report #2008524.
3140 • Robert Stayton: locale/zh_tw.xml
3142 Check in fix to Note string submitted in bug #2441051.
3144 • Robert Stayton: locale/ru.xml
3146 Checkin typo fix submitted in bug #2453406.
3150 The following changes have been made to the common code since the 1.74.3
3153 • Robert Stayton: gentext.xsl
3155 Fix extra generated space when xrefstyle includes 'nopage'.
3157 • Robert Stayton: table.xsl
3159 Add support for some format properties on tables using
3160 HTML table markup. These include:
3161 - frame attribute on table (or uses $default.table.frame parameter).
3162 - rules attribute on table (or uses $default.table.rules parameter).
3163 - align attribute on td and th
3164 - valign attribute on td and th
3165 - colspan on td and th
3166 - rowspan on td and th
3167 - bgcolor on td and th
3169 • Robert Stayton: olink.xsl
3171 Add placeholder template to massage olink hot text to make
3172 customization easier, per Feature Request 1828608.
3174 • Robert Stayton: targets.xsl
3176 Add support for collecting olink targets from a glossary
3177 generated from a glossary.collection.
3179 • Robert Stayton: titles.xsl
3181 Handle firstterm like glossterm in mode="title.markup".
3183 • Robert Stayton: titles.xsl
3185 Add match on info/title in title.markup templates where missing.
3187 • Mauritz Jeanson: titles.xsl
3189 Changed "ancestor::title" to "(ancestor::title and (@id or @xml:id))".
3190 This enables proper formatting of inline elements in titles in TOCs,
3191 as long as these inlines don't have id or xml:id attributes.
3193 • Robert Stayton: labels.xsl
3195 Add two new qanda.defaultlabel values so that numbered sections
3196 and numbered questions can be distinguished. Satisfies
3197 Feature Request #1539045.
3199 • Robert Stayton: stripns.xsl; pi.xsl
3201 Convert function-available(exsl:node-set) to use the new param
3202 so Xalan bug is isolated.
3204 • Mauritz Jeanson: titles.xsl
3206 Added fixes for bugs #2112656 and #1759205:
3207 1. Reverted mistaken commits r7485 and r7523.
3208 2. Updated the template with match="link" and mode="no.anchor.mode" so that
3209 @endterm is used if it exists and if the link has no content.
3211 • Mauritz Jeanson: titles.xsl
3213 Added code to handle acknowledgements in book and part. The element is processed
3214 similarly to dedication. All acknowledgements will appear as front matter, after
3217 • Robert Stayton: olink.xsl
3219 Fix bug #2018717 use.local.olink.style uses wrong gentext context.
3221 • Robert Stayton: olink.xsl
3223 Fix bug #1787167 incorrect hot text for some olinks.
3225 • Robert Stayton: common.xsl
3227 Fix bug #1669654 Broken output if copyright <year> contains a range.
3229 • Robert Stayton: labels.xsl
3231 Fix bug in labelling figure inside appendix inside article inside book.
3235 The following changes have been made to the fo code since the 1.74.3 release.
3237 • Jirka Kosek: highlight.xsl
3239 Inclusion of highlighting code was simplified. Only one import is now necessary.
3241 • Robert Stayton: fop1.xsl
3243 Add the new fop extensions namespace declaration, in case FOP
3244 extension functions are used.
3246 • Robert Stayton: formal.xsl
3248 Add support for pgwide on informal objects.
3250 • Robert Stayton: docbook.xsl
3252 Fixed spurious closing quote on line 134.
3254 • Robert Stayton: docbook.xsl; autoidx-kosek.xsl; autoidx.xsl
3256 Convert function-available for node-set() to use
3257 new $exsl.node.set.available param in test.
3259 • David Cramer: xref.xsl
3261 Suppress extra space after xref when xrefstyle='select: label nopage' (#2740472)
3263 • Mauritz Jeanson: pi.xsl
3265 Fixed doc bug for row-height.
3267 • David Cramer: glossary.xsl
3269 Internationalized punctuation in glosssee and glossseealso
3271 • Robert Stayton: param.xweb; param.ent; htmltbl.xsl; table.xsl
3273 Add support for some format properties on tables using
3274 HTML table markup. These include:
3275 - frame attribute on table (or uses $default.table.frame parameter).
3276 - rules attribute on table (or uses $default.table.rules parameter).
3277 - align attribute on td and th
3278 - valign attribute on td and th
3279 - colspan on td and th
3280 - rowspan on td and th
3281 - bgcolor on td and th
3283 • Robert Stayton: table.xsl
3285 Add support bgcolor in td and th
3286 elements in HTML table markup.
3288 • Robert Stayton: htmltbl.xsl
3290 Add support for colspan and rowspan and bgcolor in td and th
3291 elements in HTML table markup.
3293 • Robert Stayton: param.xweb
3295 Fix working of page-master left and right margins.
3297 • Mauritz Jeanson: param.xweb; param.ent; fop1.xsl
3299 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.
3301 • Robert Stayton: table.xsl; pi.xsl
3303 Add support for dbfo row-height processing instruction, like that in dbhtml.
3305 • Robert Stayton: lists.xsl
3307 Add support for dbfo keep-together processing instruction for
3308 entire list instances.
3310 • Robert Stayton: lists.xsl; block.xsl
3312 Add support fo dbfo keep-together processing instruction to
3313 more blocks like list items and paras.
3315 • Robert Stayton: lists.xsl; param.xweb; param.ent
3317 Add new variablelist.term.properties to format terms, per request # 1968513.
3319 • Robert Stayton: inline.xsl
3321 In simple.xlink, rearrange order of processing.
3323 • Robert Stayton: xref.xsl
3325 Handle firstterm like glossterm in mode="xref-to".
3327 • Robert Stayton: glossary.xsl; xref.xsl; pi.xsl; footnote.xsl
3329 Implement simple.xlink for glosssee and glossseealso so they can use
3330 other types of linking besides otherterm.
3332 • Robert Stayton: qandaset.xsl
3334 Add two new qanda.defaultlabel values so that numbered sections and numbered questions can be distinguished. Satisfies Feature Request #1539045.
3336 • Robert Stayton: titlepage.xsl
3338 For the book title templates, I changed info/title to book/info/title
3339 so other element's titles will not be affected.
3341 • Robert Stayton: xref.xsl; verbatim.xsl
3343 Use param exsl.node.set.available to test for function.
3345 • Robert Stayton: param.xweb; param.ent; footnote.xsl
3347 Start using new param exsl.node.set.available to work around Xalan bug.
3349 • Robert Stayton: titlepage.templates.xml
3351 Add comment on use of t:predicate for editor to prevent
3352 extra processing of multiple editors. Fixes bug 2687842.
3354 • Robert Stayton: xref.xsl; autoidx.xsl
3356 An indexterm primary, secondary, or tertiary element with an id or xml:id
3357 now outputs that ID, so that index entries can be cross referenced to.
3359 • Mauritz Jeanson: synop.xsl
3361 Added modeless template for ooclass|oointerface|ooexception.
3362 Closes bug #1623468.
3364 • Robert Stayton: xref.xsl
3366 Add template with match on indexterm in mode="xref-to" to fix bug 2102592.
3368 • Robert Stayton: xref.xsl
3370 Now xref to qandaentry will use the label element in a question for
3371 the link text if it has one.
3373 • Robert Stayton: inline.xsl
3375 Add id if specified from @id to output for quote and phrase so
3376 they can be xref'ed to.
3378 • Robert Stayton: xref.xsl
3380 Add support for xref to phrase, simpara, anchor, and quote.
3381 This assumes the author specifies something using xrefstyle since
3382 the elements don't have ordinary link text.
3384 • Robert Stayton: toc.xsl
3386 Fix bug in new toc templates.
3388 • Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl;
3389 titlepage.templates⋯
3391 Added code to handle acknowledgements in book and part. The element is processed
3392 similarly to dedication. All acknowledgements will appear as front matter, after
3395 • Robert Stayton: toc.xsl
3397 Rewrite toc templates to support an empty toc or populated toc
3398 in all permitted contexts. Same for lot elements.
3399 This fixes bug #1595969 for FO outputs.
3401 • Robert Stayton: index.xsl
3403 Fix indents for seealsoie so they are consistent.
3405 • Mauritz Jeanson: param.xweb
3407 Removed duplicate (monospace.font.family).
3409 • Robert Stayton: param.xweb; param.ent
3411 Add glossentry.list.item.properties.
3413 • Robert Stayton: param.xweb; param.ent
3415 Add monospace.verbatim.font.width param to support @width on programlisting.
3417 • Robert Stayton: verbatim.xsl
3419 Put programlisting in fo:block-container with writing-mode="lr-tb"
3420 when text direction is right to left because all program languages
3423 • Robert Stayton: verbatim.xsl
3425 Add support for @width on screen and programlisting, fixes bug #2012736.
3427 • Robert Stayton: xref.xsl
3429 Fix bug #1973585 xref to para with xrefstyle not handled correctly.
3431 • Mauritz Jeanson: block.xsl
3433 Added support for acknowledgements in article.
3434 Support in book/part remains to be added.
3436 • Robert Stayton: xref.xsl
3438 Fix bug #1787167 incorrect hot text for some olinks.
3440 • Robert Stayton: fo.xsl
3442 Add writing-mode="tb-rl" as well since some XSL-FO processors support it.
3444 • Robert Stayton: autotoc.xsl; lists.xsl; glossary.xsl; fo.xsl; table.xsl;
3447 Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.
3448 Changed instances of margin-left to margin-{$direction.align.start}
3449 and margin-right to margin-{$direction.align.end}. Those direction.align
3450 params are computed from the writing mode value in each locale's
3451 gentext key named 'writing-mode', introduced in 1.74.3 to add
3452 right-to-left support to HTML outputs.
3454 • Robert Stayton: param.xweb; param.ent
3456 Add attribute-sets for formatting glossary terms and defs.
3458 • Robert Stayton: param.xweb; param.ent
3460 Add writing.mode param for FO output.
3462 • Robert Stayton: autotoc.xsl
3464 Fix bug 1546008: in qandaentry in a TOC, use its blockinfo/titleabbrev or blockinfo/title
3465 instead of question, if available. For DocBook 5, use the info versions.
3467 • Keith Fahlgren: verbatim.xsl
3469 Add better pointer to README for XSLTHL
3471 • Keith Fahlgren: verbatim.xsl
3473 More tweaking the way that XSLTHL does or does not get called
3475 • Keith Fahlgren: verbatim.xsl
3477 Alternate attempt at sanely including/excluding XSLTHT code
3481 The following changes have been made to the html code since the 1.74.3 release.
3483 • Robert Stayton: lists.xsl
3485 Removed redundant lang and title attributes on list element inside
3486 div element for lists.
3488 • Robert Stayton: inline.xsl; titlepage.xsl; division.xsl; toc.xsl;
3489 sections.xsl; table.xsl;⋯
3491 Convert all calls to class.attribute to calls to common.html.attributes
3492 to support dir, lang, and title attributes in html output for all elements.
3493 Fulfills feature request #1993833.
3495 • Robert Stayton: chunk-common.xsl
3497 Fix bug #2750253 wrong links in list of figures in chunk.html
3498 when target html is in a subdirectory and dbhtml filename used.
3500 • Jirka Kosek: highlight.xsl
3502 Inclusion of highlighting code was simplified. Only one import is now necessary.
3504 • Robert Stayton: chunk-common.xsl; chunktoc.xsl; docbook.xsl;
3505 chunk-changebars.xsl; autoidx⋯
3507 Convert function-available for node-set() to use
3508 new $exsl.node.set.available param in test.
3510 • Mauritz Jeanson: pi.xsl
3512 Fixed doc bug for row-height.
3514 • David Cramer: glossary.xsl
3516 Internationalized punctuation in glosssee and glossseealso
3518 • Robert Stayton: lists.xsl; html.xsl; block.xsl
3520 More elements get common.html.attributes.
3521 Added locale.html.attributes template which does the lang,
3522 dir, and title attributes, but not the class attribute
3523 (used on para, for example).
3525 • Robert Stayton: lists.xsl
3527 Replace more literal class atts with mode="class.attribute" to support
3528 easier customization.
3530 • Robert Stayton: glossary.xsl
3532 Support olinking in glosssee and glossseealso.
3534 • Robert Stayton: inline.xsl
3536 In simple.xlink, rearrange order of processing.
3538 • Robert Stayton: xref.xsl
3540 Handle firstterm like glossterm in mode="xref-to".
3542 • Robert Stayton: lists.xsl; html.xsl; block.xsl
3544 Added template named common.html.attributes to output
3545 class, title, lang, and dir for most elements.
3546 Started adding it to some list and block elements.
3548 • Robert Stayton: qandaset.xsl
3550 Add two new qanda.defaultlabel values so that numbered sections
3551 and numbered questions can be distinguished. Satisfies
3552 Feature Request #1539045.
3554 • Robert Stayton: param.xweb; chunk-code.xsl; param.ent; xref.xsl;
3555 chunkfast.xsl; verbatim.x⋯
3557 Use new param exsl.node.set.available to test, handles Xalan bug.
3559 • Robert Stayton: autoidx.xsl
3561 Use named anchors for primary, secondary, and tertiary ids so
3562 duplicate entries with different ids can still have an id output.
3564 • Robert Stayton: param.xweb; param.ent
3566 Add new param index.links.to.section.
3568 • Robert Stayton: xref.xsl; autoidx.xsl
3570 Pass through an id on primary, secondary, or tertiary to
3571 the index entry, so that one could link to an index entry.
3572 You can't link to the id on an indexterm because that is
3573 used to place the main anchor in the text flow.
3575 • Robert Stayton: autoidx.xsl
3577 Add support for the new index.links.to.section param which permits
3578 precise links to indexterms in HTML output rather than to
3581 • Mauritz Jeanson: synop.xsl
3583 Added modeless template for ooclass|oointerface|ooexception.
3584 Closes bug #1623468.
3586 • Robert Stayton: qandaset.xsl
3588 Make sure a qandaset has an anchor, even when it has no title,
3589 because it may be referenced in a TOC or xref.
3590 Before, the anchor was output by the title, but there was no
3591 anchor if there was no title.
3593 • Robert Stayton: xref.xsl
3595 Add a template for indexterm with mode="xref-to" to fix bug 2102592.
3597 • Robert Stayton: xref.xsl
3599 Now xref to qandaentry will use the label element in a question for
3600 the link text if it has one.
3602 • Robert Stayton: qandaset.xsl; html.xsl
3604 Create separate templates for computing label of question and answer
3605 in a qandaentry, so such can be used for the alt text of an xref
3608 • Robert Stayton: inline.xsl; xref.xsl
3610 Now support xref to phrase, simpara, anchor, and quote,
3611 most useful when an xrefstyle is used.
3613 • Robert Stayton: toc.xsl
3615 Rewrite toc templates to support an empty toc or populated toc
3616 in all permitted contexts. Same for lot elements.
3617 This fixes bug #1595969 for HTML outputs.
3619 • Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl;
3620 titlepage.templates⋯
3622 Added code to handle acknowledgements in book and part. The element is processed
3623 similarly to dedication. All acknowledgements will appear as front matter, after
3626 • Robert Stayton: index.xsl
3628 Rewrote primaryie, secondaryie and tertiaryie templates to handle
3629 nesting of elements and seeie and seealsoie, as reported in
3632 • Robert Stayton: autotoc.xsl
3634 Fix simplesect in toc problem.
3636 • Robert Stayton: verbatim.xsl
3638 Add support for @width per bug report #2012736.
3640 • Robert Stayton: formal.xsl; htmltbl.xsl
3642 Fix bug #1787140 HTML tables not handling attributes correctly.
3644 • Robert Stayton: param.xweb
3646 Move writing-mode param.
3648 • Keith Fahlgren: refentry.xsl
3650 Remove a nesting of <p> inside <p> for refclass (made XHTML* invalid, made HTML silly)
3652 • Robert Stayton: table.xsl
3654 Fix bug #1945872 to allow passthrough of colwidth values to
3655 HTML table when no tablecolumns.extension is available and
3656 when no instance of * appears in the table's colspecs.
3658 • Mauritz Jeanson: block.xsl
3660 Added support for acknowledgements in article.
3661 Support in book/part remains to be added.
3663 • Robert Stayton: chunk-common.xsl
3665 Fix bug #1787167 incorrect hot text for some olinks.
3667 • Robert Stayton: qandaset.xsl
3669 Fix bug 1546008: in qandaentry in a TOC, use its blockinfo/titleabbrev or blockinfo/title
3670 instead of question, if available. For DocBook 5, use the info versions.
3672 • Robert Stayton: chunktoc.xsl
3674 Add support for generating olink database when using chunktoc.xsl.
3676 • Keith Fahlgren: verbatim.xsl
3678 Add better pointer to README for XSLTHL
3680 • Keith Fahlgren: verbatim.xsl
3682 Another stab at fixing the stupid XSLTHT includes across processors (Saxon regression reported by Sorin Ristache)
3684 • Keith Fahlgren: verbatim.xsl
3686 More tweaking the way that XSLTHL does or does not get called
3688 • Keith Fahlgren: verbatim.xsl
3690 Alternate attempt at sanely including/excluding XSLTHT code
3694 The following changes have been made to the manpages code since the 1.74.3
3697 • Robert Stayton: table.xsl
3699 Convert function-available test for node-set() function to
3700 test of $exsl.node.set.available param.
3702 • Mauritz Jeanson: lists.xsl
3704 Added a template for bibliolist. Closes bug #1815916.
3708 The following changes have been made to the epub code since the 1.74.3 release.
3710 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
3711 onegraphic.xinclude.xml;⋯
3713 Slightly more nuanced handling of imageobject alternatives and better support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442 reported by Raphael Hertzog.
3715 • Keith Fahlgren: docbook.xsl
3717 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)
3719 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/
3722 Correctly set dc:language in OPF metadata when i18nizing. Closes Bug #2755150
3724 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
3726 Corrected namespace declarations for literal XHTML elements to make them serialize "normally"
3728 • Keith Fahlgren: docbook.xsl
3730 Be a little bit more nuanced about dates
3732 • Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
3735 Add DocBook subjectset -> OPF dc:subject mapping and tests
3737 • Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
3740 Add DocBook date -> OPF dc:date mapping and tests
3742 • Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
3745 Add DocBook abstract -> OPF dc:description mapping and tests
3747 • Robert Stayton: docbook.xsl
3749 Check in patch submitted by user to add opf:file-as attribute
3750 to dc:creator element.
3752 • Keith Fahlgren: bin/dbtoepub
3754 Adding --output option to dbtoepub based on user request
3756 • Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb
3758 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)
3760 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
3763 Remove a nesting of <p> inside <p> for refclass (made XHTML* invalid, made HTML silly)
3765 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
3768 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.
3772 The following changes have been made to the htmlhelp code since the 1.74.3
3775 • Robert Stayton: htmlhelp-common.xsl
3777 Add support for generating olink target database for htmlhelp files.
3781 The following changes have been made to the params code since the 1.74.3
3784 • Robert Stayton: default.table.rules.xml
3786 Add default setting for @rules attribute on HTML markup tables.
3788 • Mauritz Jeanson: bookmarks.collapse.xml
3790 Added a new parameter, bookmarks.collapse, that controls the initial state
3791 of the bookmark tree. When the parameter has a non-zero value (the default),
3792 only the top-level bookmarks are displayed initially. Otherwise, the whole
3793 tree of bookmarks is displayed.
3795 This is implemented for FOP 0.9X. Closes FR #1792326.
3797 • Robert Stayton: variablelist.term.properties.xml
3799 Add new variablelist.term.properties to format terms, per
3802 • Robert Stayton: qanda.defaultlabel.xml
3804 Add two new qanda.defaultlabel values so that numbered sections
3805 and numbered questions can be distinguished. Satisfies
3806 Feature Request #1539045.
3808 • Robert Stayton: index.links.to.section.xml
3810 Change default to 1 to match past behavior.
3812 • Robert Stayton: exsl.node.set.available.xml
3814 Isolate this text for Xalan bug regarding exsl:node-set available.
3815 If it is ever fixed in Xalan, just fix it here.
3817 • Robert Stayton: index.links.to.section.xml
3819 Add param to control whether an index entry links to
3820 a section title or to the precise location of the
3823 • Robert Stayton: glossentry.list.item.properties.xml
3825 New attribute list for glossentry in glossary.
3827 • Robert Stayton: monospace.verbatim.font.width.xml
3829 New parameter to support @width on programlisting and screen.
3831 • Mauritz Jeanson: highlight.source.xml
3833 Updated and reorganized the description.
3835 • Robert Stayton: page.margin.outer.xml; page.margin.inner.xml
3837 Add caveat about XEP bug when writing-mode is right-to-left.
3839 • Robert Stayton: article.appendix.title.properties.xml; writing.mode.xml;
3842 Change 'left' to 'start' and 'right' to 'end' to support right-to-left
3845 • Robert Stayton: glossdef.block.properties.xml;
3846 glossdef.list.properties.xml; glossterm.blo⋯
3848 Add attribute-sets for formatting glossary terms and defs.
3850 • Robert Stayton: glossterm.separation.xml
3852 Clarify the description.
3854 • Robert Stayton: make.year.ranges.xml
3856 Now handles year element containing a comma or dash without error.
3860 The following changes have been made to the highlighting code since the 1.74.3
3863 • Jirka Kosek: README
3865 Inclusion of highlighting code was simplified. Only one import is now necessary.
3867 • Keith Fahlgren: README
3869 Adding XSLTHL readme
3871 • Keith Fahlgren: common.xsl
3873 Alternate attempt at sanely including/excluding XSLTHT code
3877 The following changes have been made to the xsl-saxon code since the 1.74.3
3880 • Mauritz Jeanson: src/com/nwalsh/saxon/Text.java
3882 Added a fix that prevents output of extra blank line.
3883 Hopefully this closes bug #894805.
3887 The following changes have been made to the xsl-xalan code since the 1.74.3
3890 • Mauritz Jeanson: src/com/nwalsh/xalan/Text.java
3892 Added a fix that prevents output of extra blank line.
3893 Hopefully this closes bug #894805.
3895 Release Notes: 1.74.3
3897 This release fixes some bugs in the 1.74.2 release.
3899 See highlighting/README for XSLTHL usage instructions.
3901 Release Notes: 1.74.2
3903 This release fixes some bugs in the 1.74.1 release.
3905 Release Notes: 1.74.1
3907 This release includes important bug fixes and adds the following significant
3912 Kirghiz locale added and Chinese translations have been simplified.
3914 Somme support for gentext and right-to-left languages has been added.
3918 Various bugs have been resolved.
3920 Support for a new processing instruction: dbfo funcsynopsis-style has been
3923 Added new param email.mailto.enabled for FO output. Patch from Paolo
3926 Support for documented metadata in fop1 mode has been added.
3930 Support for the latest version of XSLTHL 2.0 and some new language syntaxes
3931 have been added to a variety of outputs.
3935 Added man.output.better.ps.enabled param (zero default). It non-zero, no
3936 such markup is embedded in generated man pages, and no enhancements are
3937 included in the PostScript output generated from those man pages by the man
3942 Support for writing.mode to set text direction and alignment based on
3943 document locale has been added.
3945 Added a new top-level stylesheet module, chunk-changebars.xsl, to be used
3946 for generating chunked output with highlighting based on change
3947 (@revisionflag) markup. The module imports/includes the standard chunking
3948 and changebars templates and contains additional logic for chunked output.
3949 See FRs #1015180 and #1819915.
3953 Covers now look better in Adobe Digital Editions thanks to a patch from
3954 Paul Norton of Adobe
3956 Cover handling now more generic (including limited DocBook 5.0 cover
3957 support thanks to patch contributed by Liza Daly.
3959 Cover markup now carries more reliably into files destined for .mobi and
3962 dc:identifiers are now generated from more types of numbering schemes.
3964 Both SEO and semantic structure of chunked ePub output by ensuring that we
3965 always send out one and only one h1 in each XHTML chunk.
3967 Primitive support for embedding a single font added.
3969 Support for embedding a CSS customizations added.
3973 Support for imagedata-metadata and table as images added.
3975 Support for imagedata-metadata and legalnotice as images added.
3979 man.output.better.ps.enabled added for Manpages output
3981 writing.mode.xml added to set text direction.
3983 Added new param email.mailto.enabled for FO output. Patch from Paolo
3984 Borelli. Closes #2086321.
3986 highlight.source upgraded to support the latest version of XSLTHL 2.0.
3988 The following is a list of changes that have been made since the 1.74.0
3993 The following changes have been made to the gentext code since the 1.74.0
3996 • Michael(tm) Smith: locale/ky.xml; Makefile
3998 new Kirghiz locale from Ilyas Bakirov
4000 • Mauritz Jeanson: locale/en.xml
4002 Added "Acknowledgements".
4004 • Dongsheng Song: locale/zh_cn.xml
4006 Simplified Chinese translation.
4008 • Robert Stayton: locale/lv.xml; locale/ca.xml; locale/pt.xml; locale/tr.xml;
4011 Add writing-mode gentext string to support right-to-left languages.
4015 The following changes have been made to the fo code since the 1.74.0 release.
4017 • David Cramer: footnote.xsl
4019 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.
4021 • Mauritz Jeanson: spaces.xsl
4023 Convert spaces to fo:leader also in elements in the DB 5 namespace.
4025 • Mauritz Jeanson: pi.xsl; synop.xsl
4027 Added support for a new processing instruction: dbfo funcsynopsis-style.
4028 Closes bug #1838213.
4030 • Michael(tm) Smith: inline.xsl; param.xweb; param.ent
4032 Added new param email.mailto.enabled for FO output.
4033 Patch from Paolo Borelli. Closes #2086321.
4035 • Mauritz Jeanson: docbook.xsl
4037 Added support for document metadata for fop1 (patch #2067318).
4039 • Jirka Kosek: param.ent; param.xweb; highlight.xsl
4041 Upgraded to support the latest version of XSLTHL 2.0
4042 -- nested markup in highlited code is now processed
4043 -- it is no longer needed to specify path XSLTHL configuration file using Java property
4044 -- support for new languages, including Perl, Python and Ruby was added
4048 The following changes have been made to the html code since the 1.74.0 release.
4050 • Robert Stayton: param.xweb; docbook.xsl; param.ent; html.xsl
4052 Add support for writing.mode to set text direction and alignment based on document locale.
4054 • Mauritz Jeanson: chunk-changebars.xsl
4056 Added a new top-level stylesheet module, chunk-changebars.xsl, to be
4057 used for generating chunked output with highlighting based on change
4058 (@revisionflag) markup. The module imports/includes the standard chunking
4059 and changebars templates and contains additional logic for chunked output.
4060 See FRs #1015180 and #1819915.
4064 The following changes have been made to the manpages code since the 1.74.0
4067 • Michael(tm) Smith: docbook.xsl
4069 Put the following at the top of generated roff for each page:
4071 purpose is to explicitly tell AT&T troff that the page needs to be
4072 pre-processed through tbl(1); groff can figure it out
4073 automatically, but apparently AT&T troff needs to be explicitly told
4077 The following changes have been made to the epub code since the 1.74.0 release.
4079 • Keith Fahlgren: docbook.xsl
4081 Patch from Paul Norton of Adobe to get covers to look better in Adobe Digital Editions
4083 • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
4084 v5cover.xml; bin/spec/sp⋯
4086 Patch contributed by Liza Daly to make ePub cover handling more generic. Additionally
4087 DocBook 5.0's <cover> now has some limited support:
4089 - should reference a cover in the OPF guide for a DocBook 5.0 test document
4091 • Keith Fahlgren: bin/spec/files/isbn.xml; bin/spec/files/issn.xml; bin/spec/
4094 Liza Daly reported that the dc:identifer-generation code was garbage (she was right).
4097 - should include at least one dc:identifier
4098 - should include an ISBN as URN for dc:identifier if an ISBN was in the metadata
4099 - should include an ISSN as URN for dc:identifier if an ISSN was in the metadata
4100 - should include an biblioid as a dc:identifier if an biblioid was in the metadata
4101 - should include a URN for a biblioid with @class attribute as a dc:identifier if an biblioid was in the metadata
4103 • Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb
4105 Improve both SEO and semantic structure of chunked ePub output by ensuring that
4106 we always send out one and only one h1 in each XHTML chunk.
4109 - should include one and only one <h1> in each HTML file in rendered ePub files
4111 - should include one and only one <h1> in each HTML file in rendered ePub files
4112 for <book>s even if they do not have section markup
4114 • Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
4117 Adding better support for covers in epub files destined for .mobi and the Kindle
4119 • Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/
4120 DejaVuSerif.otf; docbook.⋯
4122 Adding primitive support for embedding a single font
4124 • Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/
4125 test_cust.xsl; bin/spec/e⋯
4127 Adding support for user-specified customization layers in dbtoepub
4129 • Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/
4132 Adding CSS support to .epub target & dbtoepub:
4133 -c, --css [FILE] Use FILE for CSS on generated XHTML.
4138 - should include a CSS link in HTML files when a CSS file has been provided
4139 - should include CSS file in .epub when a CSS file has been provided
4140 - should include a CSS link in OPF file when a CSS file has been provided
4144 The following changes have been made to the roundtrip code since the 1.74.0
4147 • Steve Ball: blocks2dbk.xsl; template.xml; template.dot
4149 added support for imagedata-metadata
4150 added support for table as images
4152 • Steve Ball: blocks2dbk.xsl; normalise2sections.xsl; sections2blocks.xsl
4154 Improved support for personname inlines.
4156 • Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml
4158 Added support for legalnotice.
4160 • Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl
4162 added support for orgname in author
4164 • Steve Ball: specifications.xml; supported.xml; blocks2dbk.xsl;
4165 wordml2normalise.xsl; dbk2w⋯
4167 Updated specification.
4168 to-DocBook: add cols attribute to tgroup
4169 from-DocBook: fix for blockquote title
4173 The following changes have been made to the params since the 1.74.0 release.
4175 • The change was to add man.output.better.ps.enabled parameter, with its
4176 default value set to zero. If the value of the man.output.better.ps.enabled
4177 parameter is non-zero, certain markup is embedded in each generated man
4178 page such that PostScript output from the man -Tps command for that page
4179 will include a number of enhancements designed to improve the quality of
4180 that output. If man.output.better.ps.enabled is zero (the default), no such
4181 markup is embedded in generated man pages, and no enhancements are included
4182 in the PostScript output generated from those man pages by the man -Tps
4183 command. WARNING: The enhancements provided by this parameter rely on
4184 features that are specific to groff (GNU troff) and that are not part of
4185 "classic" AT&T troff or any of its derivatives. Therefore, any man pages
4186 you generate with this parameter enabled will be readable only on systems
4187 on which the groff (GNU troff) program is installed, such as GNU/Linux
4188 systems. The pages will not not be readable on systems on with the classic
4189 troff (AT&T troff) command is installed. NOTE: The value of this parameter
4190 only affects PostScript output generated from the man command. It has no
4191 effect on output generated using the FO backend. TIP: You can generate
4192 PostScript output for any man page by running the following command: man
4193 FOO -Tps > FOO.ps You can then generate PDF output by running the following
4194 command: ps2pdf FOO.ps
4196 • Robert Stayton: writing.mode.xml
4198 writing mode param used to set text direction.
4200 • Michael(tm) Smith: email.mailto.enabled.xml
4202 Added new param email.mailto.enabled for FO output.
4203 Patch from Paolo Borelli. Closes #2086321.
4205 • Jirka Kosek: highlight.source.xml; highlight.xslthl.config.xml
4207 Upgraded to support the latest version of XSLTHL 2.0
4208 -- nested markup in highlited code is now processed
4209 -- it is no longer needed to specify path XSLTHL configuration file using Java property
4210 -- support for new languages, including Perl, Python and Ruby was added
4214 The following changes have been made to the highlighting code since the 1.74.0
4217 • Jirka Kosek: cpp-hl.xml; c-hl.xml; tcl-hl.xml; php-hl.xml; common.xsl;
4218 perl-hl.xml; delphi⋯
4220 Upgraded to support the latest version of XSLTHL 2.0
4221 -- nested markup in highlited code is now processed
4222 -- it is no longer needed to specify path XSLTHL configuration file using Java property
4223 -- support for new languages, including Perl, Python and Ruby was added
4225 Release Notes: 1.74.0
4227 This release includes important bug fixes and adds the following significant
4232 Paul Norton (Adobe) and Keith Fahlgren(O'Reilly Media) have donated code
4233 that generates .epub documents from DocBook input. An alpha-reference
4234 implementation in Ruby has also been provided.
4236 .epub is an open standard of the The International Digital Publishing Forum
4237 (IDPF), a the trade and standards association for the digital publishing
4240 Read more about this target in epub/README
4244 To support .epub output, a strict XHTML 1.1 target has been added. The
4245 stylesheets for this output are generated and are quite similar to the
4250 A number of locales have been updated.
4252 Roundtrip improvements
4254 Table, figure, template syncronization, and character style improvements
4255 have been made for WordML & Pages. Support added for OpenOffice.org.
4257 First implementation of a libxslt extension
4259 A stylesheet extension for libxslt, written in Python, has been added. The
4260 extension is a function for adjusting column widths in CALS tables. See
4261 extensions/README.LIBXSLT for more information.
4263 The following is a list of changes that have been made since the 1.73.2
4268 The following changes have been made to the gentext code since the 1.73.2
4271 • Michael(tm) Smith: locale/id.xml
4273 Checked in changes to Indonesion locale submitted by Euis Luhuanam a long time ago.
4275 • Michael(tm) Smith: locale/lt.xml
4277 Added changes to Lithuanian locate submitted a long time back by Nikolajus Krauklis.
4279 • Michael(tm) Smith: locale/hu.xml
4281 fixed error in lowercase.alpha definition in Hungarian locale
4283 • Michael(tm) Smith: locale/nb.xml
4285 Corrected language code for nb locale, and restored missing "startquote" key.
4287 • Michael(tm) Smith: locale/ja.xml
4289 Committed changes to ja locale file, from Akagi Kobayashi. Adds bracket quotes around many xref instances that did not have them
4292 • Michael(tm) Smith: Makefile
4294 "no" locale is now "nb"
4296 • Michael(tm) Smith: locale/nb.xml
4298 Update Norwegian Bokmål translation. Thanks to Hans F. Nordhaug.
4300 • Michael(tm) Smith: locale/no.xml; locale/nb.xml
4302 per message from Hans F. Nordhaug, correct identifier for
4303 Norwegian Bokmål is "nb" (not "no") and has been for quite some
4306 • Michael(tm) Smith: locale/ja.xml
4308 Converted ja.xml source file to use real unicode characters so
4309 that the actual glyphs so up when you edit it in a text editor
4310 (instead of the character references).
4312 • Michael(tm) Smith: locale/ja.xml
4314 Checked in changes to ja.xml locale file. Thanks to Akagi Kobayashi.
4316 • Michael(tm) Smith: locale/it.xml
4318 Changes from Federico Zenith
4320 • Dongsheng Song: locale/zh_cn.xml
4322 Added missing translations.
4326 The following changes have been made to the common code since the 1.73.2
4329 • Michael(tm) Smith: l10n.xsl
4331 Added new template "l10.language.name" for retrieving the
4332 English-language name of the lang setting of the current document.
4333 Closes #1916837. Thanks to Simon Kennedy.
4335 • Michael(tm) Smith: refentry.xsl
4339 • Michael(tm) Smith: refentry.xsl
4341 fixed a couple of typos
4343 • Michael(tm) Smith: refentry.xsl
4345 refined handling of cases where refentry "source" or "manual"
4346 metadata is missing or when we use fallback content instead. We
4347 now report a Warning if we use fallback content.
4349 • Michael(tm) Smith: refentry.xsl
4351 don't use refmiscinfo@class=date value as fallback for refentry
4352 "source" or "manual" metadata fields
4354 • Michael(tm) Smith: refentry.xsl
4356 Made reporting of missing refentry metadata more quiet:
4358 - we no longer report anything if usable-but-not-preferred
4359 metadata is found; we just quietly use whatever we manage to
4362 - we now only report missing "source" metadata if the refentry
4363 is missing BOTH "source name" and "version" metadata; if it
4364 has one but not the other, we use whichever one it has and
4365 don't report anything as missing
4367 The above changes were made because testing with some "real world"
4368 source reveals that some authors are intentionally choosing to use
4369 "non preferred" markup for some metadata, and also choosing to
4370 omit "source name" or "version" metadata in there DocBook XML. So
4371 it does no good to give them pedantic reminders about what they
4374 Also, changed code to cause "fixme" text to be inserted in output
4375 in particular cases:
4377 - if we can't manage to find any "source" metadata at all, we
4378 now put fixme text into the output
4380 - if we can't manage to find any "manual" metadata a all, we
4381 now put fixme text into the output
4383 The "source" and "manual" metadata is necessary information, so
4384 buy putting the fixme stuff in the output, we alert users to the
4385 need problem of it being missing.
4387 • Michael(tm) Smith: refentry.xsl
4389 When generating manpages output, we no longer report anything if
4390 the refentry source is missing date or pubdate content. In
4391 practice, many users intentionally omit the date from the source
4392 because they explicitly want it to be generated.
4394 • Michael(tm) Smith: l10n.xml
4396 further change needed for switch from no locale to nb.
4398 • Michael(tm) Smith: common.xsl
4400 Added support for orgname in authorgroup. Thanks to Camille
4403 • Michael(tm) Smith: Makefile
4405 "no" locale is now "nb"
4407 • Mauritz Jeanson: stripns.xsl
4409 Removed the template matching "ng:link|db:link" (in order to make @xlink:show
4410 work with <link> elements). As far as I can tell, this template is no longer needed.
4412 • Mauritz Jeanson: entities.ent
4414 Moved declaration of comment.block.parents entity to common/entities.ent.
4416 • Mauritz Jeanson: titles.xsl
4418 Added an update the fix made in revision 7528 (handling of xref/link in no.anchor.mode mode).
4419 Having xref in title is not a problem as long as the target is not an ancestor element.
4420 Closes bug #1838136.
4422 Note that an xref that is in a title and whose target is an ancestor element is still not
4423 rendered in the TOC. This could be considered a bug, but on the other hand I cannot really
4424 see the point in having such an xref in a document.
4426 • Mauritz Jeanson: titles.xsl
4428 Added a "not(ancestor::title)" test to work around "too many nested
4429 apply-templates" problems when processing xrefs or links in no.anchor.mode mode.
4430 Hopefully, this closes bug #1811721.
4432 • Mauritz Jeanson: titles.xsl
4434 Removed old template matching "link" in no.anchor.mode mode.
4436 • Mauritz Jeanson: titles.xsl
4438 Process <link> in no.anchor.mode mode with the same template as <xref>.
4439 Closes bug #1759205 (Empty link in no.anchor.mode mode).
4441 • Mauritz Jeanson: titles.xsl
4443 In no.anchor.mode mode, do not output anchors for elements that are descendants
4444 of <title>. Previously, having inline elements with @id/@xml:id in <title>s
4445 resulted in anchors both in the TOC and in the main flow. Closes bug #1797492.
4449 The following changes have been made to the fo code since the 1.73.2 release.
4451 • Mauritz Jeanson: pi.xsl
4453 Updated documentation for keep-together.
4455 • Mauritz Jeanson: task.xsl
4457 Enabled use of the keep-together PI on task elements.
4459 • Robert Stayton: index.xsl
4461 FOP1 requires fo:wrapper for inline index entries, not fo:inline.
4463 • Robert Stayton: index.xsl
4465 Fixed non-working inline.or.block template for indexterm wrappers.
4466 Add fop1 to list of processors using inline.or.block.
4468 • Mauritz Jeanson: table.xsl
4470 Fixed bug #1891965 (colsep in entytbl not working).
4472 • Mauritz Jeanson: titlepage.xsl
4474 Added support for title in revhistory. Closes bug #1842847.
4476 • Mauritz Jeanson: pi.xsl
4478 Small doc cleanup (dbfo float-type).
4480 • Mauritz Jeanson: titlepage.xsl
4482 Insert commas between multiple copyright holders.
4484 • Mauritz Jeanson: autotoc.xsl; division.xsl
4486 Added modifications to support nested set elements. See bug #1853172.
4488 • David Cramer: glossary.xsl
4490 Added normalize-space to xsl:sorts to avoid missorting of glossterms due to stray leading spaces.
4492 • David Cramer: glossary.xsl
4494 Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry
4496 • Mauritz Jeanson: inline.xsl
4498 Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,
4499 and the "hot text" is the biblioid itself enclosed in brackets.
4501 • Mauritz Jeanson: inline.xsl
4503 Moved declaration of comment.block.parents entity to common/entities.ent.
4505 • Mauritz Jeanson: docbook.xsl
4507 Updated message about unmatched element.
4509 • Mauritz Jeanson: param.xweb
4511 Added link to profiling chapter of TCG.
4513 • Mauritz Jeanson: refentry.xsl
4515 Fixed typo (refsynopsysdiv -> refsynopsisdiv).
4517 • David Cramer: fop.xsl; fop1.xsl; ptc.xsl; xep.xsl
4519 Added test to check generate.index param when generating pdf bookmarks
4521 • Mauritz Jeanson: graphics.xsl
4523 Added support for MathML in imagedata.
4525 • Michael(tm) Smith: math.xsl
4527 Removed unnecessary extra test condition in test express that
4528 checks for passivetex.
4530 • Michael(tm) Smith: math.xsl
4532 Don't use fo:instream-foreign-object if we are processing with
4533 passivetex. Closes #1806899. Thanks to Justus Piater.
4535 • Mauritz Jeanson: component.xsl
4537 Added code to output a TOC for an appendix in an article when
4538 generate.toc='article/appendix toc'. Closes bug #1669658.
4540 • Dongsheng Song: biblio-iso690.xsl
4542 Change encoding from "windows-1250" to "UTF-8".
4544 • Mauritz Jeanson: pi.xsl
4546 Updated documentation for dbfo_label-width.
4548 • Mauritz Jeanson: lists.xsl
4550 Added support for the dbfo_label-width PI in calloutlists.
4552 • Robert Stayton: biblio.xsl
4554 Support finding glossary database entries inside bibliodivs.
4556 • Robert Stayton: formal.xsl
4558 Complete support for <?dbfo pgwide="1"?> for informal
4561 • Mauritz Jeanson: table.xsl
4563 In the table.block template, added a check for the dbfo_keep-together PI, so that
4564 a table may break (depending on the PI value) at a page break. This was needed
4565 since the outer fo:block that surrounds fo:table has keep-together.within-column="always"
4566 by default, which prevents the table from breaking. Closes bug #1740964 (Titled
4567 table does not respect dbfo PI).
4569 • Mauritz Jeanson: pi.xsl
4571 Added a few missing @role="tcg".
4573 • Mauritz Jeanson: inline.xsl
4575 Use normalize-space() in glossterm comparisons (as in html/inline.xsl).
4577 • Mauritz Jeanson: autoidx.xsl
4579 Removed the [&scope;] predicate from the target variable in the template with name="reference".
4580 This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
4581 with index.on.type=1. Closes bug #1680836.
4583 • Michael(tm) Smith: inline.xsl; xref.xsl; footnote.xsl
4585 Added capability in FO output for displaying URLs for all
4586 hyperlinks (elements marked up with xlink:href attributes) in the
4587 same way as URLs for ulinks are already handled (which is to say,
4588 either inline or as numbered footnotes).
4590 Background on this change:
4591 DocBook 5 allows "ubiquitous" linking, which means you can make
4592 any element a hyperlink just by adding an xlink:href attribute to
4593 it, with the value set to an external URL. That's in contrast to
4594 DocBook 4, which only allows you to use specific elements (e.g.,
4595 the link and ulink elements) to mark up hyperlinks.
4597 The existing FO stylesheets have a mechanism for handling display
4598 of URLs for hyperlinks that are marked up with ulink, but they did
4599 not handle display of URLs for elements that were marked up with
4600 xlink:href attributes. This change adds handling for those other
4601 elements, enabling the URLs they link to be displayed either
4602 inline or as numbered footnotes (depending on what values the user
4603 has the ulink.show and ulink.footnotes params set to).
4605 Note that this change only adds URL display support for elements
4606 that call the simple.xlink template -- which currently is most
4607 (but not all) inline elements.
4609 This change also moves the URL display handling out of the ulink
4610 template and into a new "hyperlink.url.display" named template;
4611 the ulink template and the simple.xlink named template now both
4612 call the hyperlink.url.display template.
4614 Warning: In the stylesheet code that determines what footnote
4615 number to assign to each footnote or external hyperlink, there is
4616 an XPath expression for determining whether a particular
4617 xlink:href instance is an external hyperlink; that expression is
4618 necessarily a bit complicated and further testing may reveal that
4619 it doesn't handle all cases as expected -- so some refinements to
4620 it may need to be done later.
4622 Closes #1785519. Thanks to Ken Morse for reporting and
4623 troubleshooting the problem.
4627 The following changes have been made to the html code since the 1.73.2 release.
4629 • Keith Fahlgren: inline.xsl; synop.xsl
4631 Work to make HTML and XHTML targets more valid
4633 • Keith Fahlgren: table.xsl
4635 Add better handling for tables that have footnotes in the titles
4637 • Keith Fahlgren: biblio.xsl
4639 Add anchors to bibliodivs
4641 • Keith Fahlgren: formal.xsl; Makefile; htmltbl.xsl
4643 Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
4644 and Keith Fahlgren of O'Reilly.
4646 This change includes new code for generating the XHTML 1.1 target sanely.
4648 • Mauritz Jeanson: biblio.xsl
4650 Added code for creating URLs from biblioids with @class="doi" (representing Digital
4651 Object Identifiers). See FR #1934434 and http://doi.org.
4653 To do: 1) Add support for FO output. 2) Figure out how @class="doi" should be handled
4654 for bibliorelation, bibliosource and citebiblioid.
4656 • Norman Walsh: formal.xsl
4658 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.
4660 • Michael(tm) Smith: Makefile
4662 Added checks and hacks to various makefiles to enable building
4663 under Cygwin. This stuff is ugly and maybe not worth the mess and
4664 trouble, but does seem to work as expected and not break anything
4667 • Michael(tm) Smith: docbook.xsl
4669 added "exslt" namespace binding to html/docbook.xsl file (in
4670 addition to existing "exsl" binding. reason is because lack of it
4671 seems to cause processing problems when using the profiled
4672 version of the stylsheet
4674 • Norman Walsh: chunk-common.xsl
4678 • Mauritz Jeanson: table.xsl
4680 Added a fix to make rowsep apply to the last row of thead in entrytbl.
4682 • Michael(tm) Smith: synop.xsl
4684 Simplified and streamlined handling of output for ANSI-style
4685 funcprototype output, to correct a problem that was causing type
4686 data to be lost in the output parameter definitions. For example,
4687 for an instance like this:
4688 <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
4689 ... the brackets (indicating an array type) were being dropped.
4691 • Michael(tm) Smith: synop.xsl
4693 Changed HTML handling of K&R-style paramdef output. The parameter
4694 definitions are no longer output in a table (though the prototype
4695 still is). The reason for the change is that the
4696 kr-tabular-funcsynopsis-mode template was causing type data to be
4697 lost in the output parameter definitions. For example, for an
4699 <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
4700 ... the brackets (indicating an array type) were being dropped.
4701 The easiest way to deal with the problem is to not try to chop up
4702 the parameter definitions and display them in table format, but to
4703 instead just output them as-is. May not look quite as pretty, but
4704 at least we can be sure no information is being lost...
4706 • Michael(tm) Smith: pi.xsl
4708 updated wording of doc for funcsynopsis-style PI
4710 • Michael(tm) Smith: param.xweb; param.ent; synop.xsl
4712 Removed the funcsynopsis.tabular.threshold param. It's no longer
4713 being used in the code and hasn't been since mid 2006.
4715 • Mauritz Jeanson: graphics.xsl
4717 Added support for the img.src.path parameter for SVG graphics. Closes bug #1888169.
4719 • Mauritz Jeanson: chunk-common.xsl
4721 Added missing space.
4723 • Norman Walsh: component.xsl
4725 Fix bug where component titles inside info elements were not handled properly
4727 • Michael(tm) Smith: pi.xsl
4729 Moved dbhtml_stop-chunking embedded doc into alphabetical order,
4730 fixed text of TCG section it see-also'ed.
4732 • David Cramer: pi.xsl
4734 Added support for <?dbhtml stop-chunking?> processing instruction
4736 • David Cramer: chunk-common.xsl; pi.xsl
4738 Added support for <?dbhtml stop-chunking?> processing instruction
4740 • David Cramer: glossary.xsl
4742 Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry. Also added normalize-space to avoid missorting due to stray leading spaces.
4744 • Mauritz Jeanson: inline.xsl
4746 Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,
4747 and the "hot text" is the biblioid itself enclosed in brackets.
4749 • Mauritz Jeanson: inline.xsl
4751 Added support for @xlink:show in the simple.xlink template. The "new" and "replace"
4752 values are supported (corresponding to values of "_blank" and "_top" for the
4753 ulink.target parameter). I have assumed that @xlink:show should override ulink.target
4754 for external URI links. This closes bugs #1762023 and #1727498.
4756 • Mauritz Jeanson: inline.xsl
4758 Moved declaration of comment.block.parents entity to common/entities.ent.
4760 • Mauritz Jeanson: param.xweb
4762 Added link to profiling chapter of TCG.
4764 • Dongsheng Song: biblio-iso690.xsl
4766 Change encoding from "windows-1250" to "UTF-8".
4768 • Robert Stayton: biblio.xsl
4770 Add support in biblio collection to entries in bibliodivs.
4772 • Mauritz Jeanson: pi.xsl
4774 Added missing @role="tcg".
4776 • Mauritz Jeanson: chunk-common.xsl; titlepage.xsl
4778 Refactored legalnotice/revhistory chunking, so that the use.id.as.filename
4779 parameter as well as the dbhtml_filename PI are taken into account. A new named
4780 template in titlepage.xsl is used to compute the filename.
4782 • Mauritz Jeanson: chunk-common.xsl; titlepage.xsl
4784 An update to the fix for bug #1790495 (r7433):
4785 The "ln-" prefix is output only when the legalnotice doesn't have an
4786 @id/@xml:id, in which case the stylesheets generate an ID value,
4787 resulting in a filename like "ln-7e0fwgj.html". This is useful because
4788 without the prefix, you wouldn't know that the file contained a legalnotice.
4789 The same logic is also applied to revhistory, using an "rh-" prefix.
4791 • Mauritz Jeanson: autoidx.xsl
4793 Removed the [&scope;] predicate from the target variable in the template with name="reference".
4794 This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
4795 with index.on.type=1. Closes bug #1680836.
4797 • Mauritz Jeanson: titlepage.xsl
4799 Added 'ln-' prefix to the name of the legalnotice chunk, in order to match the
4800 <link href"..."> that is output by make.legalnotice.head.links (chunk-common.xsl).
4801 Modified the href attribute on the legalnotice link.
4802 Closes bug #1790495.
4806 The following changes have been made to the manpages code since the 1.73.2
4809 • Michael(tm) Smith: other.xsl
4811 slightly adjusted spacing around admonition markers
4813 • Michael(tm) Smith: refentry.xsl; utility.xsl
4815 make sure refsect3 titles are preceded by a line of space, and
4816 make the indenting of their child content less severe
4818 • Michael(tm) Smith: block.xsl
4820 only indent verbatim environments in TTY output, not in non-TTY/PS
4822 • Michael(tm) Smith: block.xsl
4824 made another adjustment to correct vertical alignment of admonition marker
4826 • Michael(tm) Smith: block.xsl; other.xsl
4828 Adjusted/corrected alignment of adominition marker in PS/non-TTY output.
4830 • Michael(tm) Smith: endnotes.xsl
4832 For PS/non-TTY output, display footnote/endnote numbers in
4835 • Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl
4837 Changed handling of hanging indents for cmdsynopsis, funcsynopsis,
4838 and synopfragment such that they now look correct in non-TTY/PS
4839 output. We now use the groff \w escape to hang by the actual width
4840 -- in the current font -- of the command, funcdef, or
4841 synopfragment references number (as opposed to hanging by the
4842 number of characters). This rendering in TTY output remains the
4843 same, since the width in monospaced TTY output is the same as the
4844 number of characters.
4846 Also, created new synopsis-block-start and synopsis-block-end
4847 templates to use for cmdsynopsis and funcsynopsis instead of the
4848 corresponding verbatim-* templates.
4850 Along with those changes, also corrected a problem that caused the
4851 content of synopfragment to be dropped, and made a
4852 vertical-spacing change to adjust spacing around table titles and
4853 among sibling synopfragment instances.
4855 • Michael(tm) Smith: other.xsl
4857 use common l10.language.name template to retrieve English-language name
4859 • Michael(tm) Smith: synop.xsl; inline.xsl
4861 added comment in code explaining why we don't put filename output
4862 in italic (despite the fact that man guidelines say we should)
4864 • Michael(tm) Smith: inline.xsl
4866 put filename output in monospace instead of italic
4868 • Michael(tm) Smith: synop.xsl
4870 put cmdsynopsis in monospace
4872 • Michael(tm) Smith: inline.xsl
4874 removed template match for literal. template matches for monospace
4875 inlines are all imported from the HTML stylesheet
4877 • Michael(tm) Smith: block.xsl
4879 don't indent verbatim environments that are descendants of
4880 refsynopsisdiv, not put backgrounds behind them
4882 • Michael(tm) Smith: inline.xsl
4884 set output of the literal element in monospace. this causes all
4885 inline monospace instances in the git man pages to be set in
4886 monospace (since DocBook XML source for git docs is generated with
4887 asciidoc and asciidoc consistently outputs only <literal> for
4888 inline monospace (not <command> or <code> or anything else).
4889 Of course this only affects non-TTY output...
4891 • Michael(tm) Smith: utility.xsl
4893 Added inline.monoseq named template.
4895 • Michael(tm) Smith: utility.xsl
4897 don't bother using a custom register to store the previous
4898 font-family value when setting blocks of text in code font; just
4899 use \F[] .fam with no arg to switch back
4901 • Michael(tm) Smith: endnotes.xsl
4903 put links in blue in PS output (note that this matches how groff
4904 renders content marked up with the .URL macro)
4906 • Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent
4908 removed man.links.are.underlined and added man.font.links. Also,
4909 changed the default font formatting for links to bold.
4911 • Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent
4913 Added new param man.base.url.for.relative.links .. specifies a
4914 base URL for relative links (for ulink, @xlink:href, imagedata,
4915 audiodata, videodata) shown in the generated NOTES section of
4916 man-page output. The value of man.base.url.for.relative.links is
4917 prepended to any relative URI that is a value of ulink url,
4918 xlink:href, or fileref attribute.
4920 If you use relative URIs in link sources in your DocBook refentry
4921 source, and you leave man.base.url.for.relative.links unset, the
4922 relative links will appear "as is" in the NOTES section of any
4923 man-page output generated from your source. That's probably not
4924 what you want, because such relative links are only usable in the
4925 context of HTML output. So, to make the links meaningful and
4926 usable in the context of man-page output, set a value for
4927 man.base.url.for.relative.links that points
4928 to the online version of HTML output generated from your DocBook
4929 refentry source. For example:
4931 <xsl:param name="man.base.url.for.relative.links"
4932 >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param>
4934 • Michael(tm) Smith: info.xsl
4936 If a source refentry contains a Documentation or DOCUMENTATION
4937 section, don't report it as having missing AUTHOR information.
4938 Also, if missing a contrib/personblurb for a person or org, report
4939 pointers to http://docbook.sf.net/el/personblurb and to
4940 http://docbook.sf.net/el/contrib
4942 • Michael(tm) Smith: info.xsl
4944 If we encounter an author|editor|othercredit instance that lacks a
4945 personblurb or contrib, report it to the user (because that means
4946 we have no information about that author|editor|othercredit to
4947 display in the generated AUTHOR|AUTHORS section...)
4949 • Michael(tm) Smith: info.xsl; docbook.xsl; other.xsl
4951 if we can't find any usable author data, emit a warning and insert
4952 a fixme in the output
4954 • Michael(tm) Smith: info.xsl
4956 fixed bug in indenting of output for contrib instances in AUTHORS
4957 section. Thanks to Daniel Leidert and the fglrx docs for exposing
4960 • Michael(tm) Smith: block.xsl
4962 for a para or simpara that is the first child of a callout,
4963 suppress the .sp or .PP that would normally be output (because in
4964 those cases, the output goes into a table cell, and the .sp or .PP
4965 markup causes a spurious linebreak before it when displayed
4967 • Michael(tm) Smith: lists.xsl
4969 Added support for rendering co callouts and calloutlist instances.
4970 So you can now use simple callouts -- marking up programlisting
4971 and such with co instances -- and have the callouts displayed in
4972 man-page output. ("simple callouts" means using co@id and
4973 callout@arearefs pointing to co@id instances; in man/roff output,
4974 we can't/don't support markup that uses areaset and area)
4976 • Michael(tm) Smith: block.xsl
4978 only put a line of space after a verbatim if it's followed by a
4979 text node or a paragraph
4981 • Michael(tm) Smith: utility.xsl
4983 put verbatim environments in slightly smaller font in non-TTY
4986 • Michael(tm) Smith: lists.xsl
4988 minor whitespace-only reformatting of lists.xsl source
4990 • Michael(tm) Smith: lists.xsl
4992 Made refinements/fixes to output of orderedlist and itemizedlist
4993 -- in part, to get mysql man pages to display correctly. This
4994 change causes a "\c" continuation marker to be added between
4995 listitem markers and contents (to ensure that the content remains
4996 on the same line as the marker when displayed)
4998 • Michael(tm) Smith: block.xsl
5000 put a line of vertical space after all verbatim output that has
5001 sibling content following it (not just if that sibling content is
5004 • Michael(tm) Smith: block.xsl
5006 refined spacing around titles for admonitions
5008 • Michael(tm) Smith: block.xsl; other.xsl
5010 Deal with case of verbatim environments that have a linebreak
5011 after the opening tag. Assumption is that users generally don't
5012 want that linebreak to appear in output, so we do some groff
5013 hackery to mess with vertical spacing and close the space.
5015 • Michael(tm) Smith: inline.xsl
5017 indexterm instances now produce groff comments like this:
5019 .\" primary: secondary: tertiary
5021 remark instances, if non-empty, now produce groff comments
5023 • Michael(tm) Smith: charmap.groff.xsl; other.xsl
5025 convert no-break space character to groff "\ \&" (instead of just
5026 "\ "). the reason is that if a space occurs at the end of a line,
5027 our processing causes it to be eaten. a real-world case of this is
5028 the mysql(1) man page. appending the "\&" prevents that
5030 • Michael(tm) Smith: block.xsl
5032 output "sp" before simpara output, not after it (outputting it
5033 after results in undesirable whitespace in particular cases; for
5034 example, in the hg/mercurial docs
5036 • Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl
5038 renamed from title-preamble to pinch.together and replaced "sp -1"
5039 between synopsis fragments with call to pinch.together instead
5041 • Michael(tm) Smith: table.xsl
5043 use title-preamble template for table titles (instead of "sp -1"
5044 hack), and "sp 1" after all tables (instead of just "sp"
5046 • Michael(tm) Smith: utility.xsl
5048 created title-preamble template for suppressing line spacing after
5051 • Michael(tm) Smith: info.xsl
5053 further refinement of indenting in AUTHORS section
5055 • Michael(tm) Smith: block.xsl; other.xsl
5057 refined handling of admonitions
5059 • Michael(tm) Smith: lists.xsl
5061 Use RS/RE in another place where we had IP ""
5063 • Michael(tm) Smith: info.xsl
5065 Replace (ab)use of IP with "sp -1" in AUTHORS section with RS/RE
5068 • Michael(tm) Smith: table.xsl; synop.xsl; info.xsl
5070 changed all instances of ".sp -1n" to ".sp -1"
5072 • Michael(tm) Smith: other.xsl
5074 add extra line before SH heads only in non-TTY output
5076 • Michael(tm) Smith: block.xsl
5078 Reworked output for admonitions (caution, important, note, tip,
5079 warning). In TTY output, admonitions now get indented. In non-TTY
5080 output, a colored marker (yellow) is displayed next to them.
5082 • Michael(tm) Smith: other.xsl
5084 Added BM/EM macros for putting a colored marker in margin next to
5087 • Michael(tm) Smith: utility.xsl
5089 created make.bold.title template by moving title-bolding part out
5090 from nested-section-title template. This allows the bolding to
5091 also be used by the template for formatting admonitions
5093 • Michael(tm) Smith: info.xsl
5095 put .br before copyright contents to prevent them from getting run in
5097 • Michael(tm) Smith: refentry.xsl; other.xsl; utility.xsl
5099 made point size of output for Refsect2 and Refsect3 heads bigger
5101 • Michael(tm) Smith: other.xsl
5103 put slightly more space between SH head and underline in non-TTY
5106 • Michael(tm) Smith: param.xweb; param.ent; other.xsl
5108 Added the man.charmap.subset.profile.english parameter and refined
5109 the handling of charmap subsets to differentiate between English
5110 and non-English source.
5112 This way charmap subsets are now handled is this:
5114 If the value of the man.charmap.use.subset parameter is non-zero,
5115 and your DocBook source is not written in English (that is, if its
5116 lang or xml:lang attribute has a value other than en), then the
5117 character-map subset specified by the man.charmap.subset.profile
5118 parameter is used instead of the full roff character map.
5120 Otherwise, if the lang or xml:lang attribute on the root element
5121 in your DocBook source or on the first refentry element in your
5122 source has the value en or if it has no lang or xml:lang
5123 attribute, then the character-map subset specified by the
5124 man.charmap.subset.profile.english parameter is used instead of
5125 man.charmap.subset.profile.
5127 The difference between the two subsets is that
5128 man.charmap.subset.profile provides mappings for characters in
5129 Western European languages that are not part of the Roman
5130 (English) alphabet (ASCII character set).
5132 • Michael(tm) Smith: other.xsl
5134 Various updates, mainly related to uppercasing SH titles:
5136 - added a "Language: " metadata line to the top comment area of
5137 output man pages, to indicate the language the page is in
5139 - added a "toupper" macro of doing locale-aware uppercasing of
5140 SH titles and cross-references to SH titles; the mechanism
5141 relies on the uppercase.alpha and lowercase.alpha DocBook
5142 gentext keys to do locale-aware uppercasing based on the
5143 language the page is written in
5145 - added a "string.shuffle" template, which provides a library
5146 function for "shuffling" two strings together into a single
5147 string; it takes the first character for the first string, the
5148 first character from second string, etc. The only current use
5149 for it is to generate the argument for the groff tr request
5150 that does string uppercasing.
5152 - added make.tr.uppercase.arg and make.tr.normalcase.arg named
5153 templates for use in generating groff code for uppercasing and
5154 "normal"-casing SH titles
5156 - made the BB/BE "background drawing" macros have effect only in
5159 - output a few comments in the top part of source
5161 • Michael(tm) Smith: utility.xsl
5163 removed some leftover kruft
5165 • Michael(tm) Smith: refentry.xsl
5167 To create the name(s) for each man page, we now replace any spaces
5168 in the refname(s) with underscores. This ensures that tools like
5169 lexgrog(1) will be able to parse the name (lexgrog won't parse
5170 names that contain spaces).
5172 • Michael(tm) Smith: docbook.xsl
5174 Put a comment into source of man page to indicate where the main
5175 content starts. (We now have a few of macro definitions at the
5176 start of the source, so putting this comment in helps those that
5177 might be viewing the source.)
5179 • Michael(tm) Smith: refentry.xsl
5181 refined mechanism for generating SH titles
5183 • Michael(tm) Smith: charmap.groff.xsl
5185 Added zcaron, Zcaron, scaron, and Scaron to the groff character map.
5186 This means that generated Finnish man pages will no longer contain
5187 any raw accented characters -- they'll instead by marked up with
5190 • Michael(tm) Smith: other.xsl; utility.xsl
5192 corrected a regression I introduced about a year ago that caused
5193 dots to be output just as "\." -- instead needs to be "\&." (which
5194 is what it will be now, after this change)
5196 • Michael(tm) Smith: refentry.xsl
5198 Changed backend handling for generating titles for SH sections and
5199 for cross-references to those sections. This should have no effect
5200 on TTY output (behavior should remain the same hopefully) but
5201 results in titles in normal case (instead of uppercase) in PS
5204 • Michael(tm) Smith: info.xsl
5206 use make.subheading template to make subheadings for AUTHORS and
5207 COPYRIGHT sections (instead of harcoding roff markup)
5209 • Michael(tm) Smith: block.xsl
5211 put code font around programlisting etc.
5213 • Michael(tm) Smith: synop.xsl; docbook.xsl
5215 embed custom macro definitions in man pages, plus wrap synopsis in
5218 • Michael(tm) Smith: endnotes.xsl
5220 use the make.subheading template to generated SH subheading for
5223 • Michael(tm) Smith: lists.xsl
5225 Added some templates for generating if-then-else conditional
5226 markup in groff, so let's use those instead of hard-coding it in
5229 • Michael(tm) Smith: other.xsl; utility.xsl
5231 Initial checkin of some changes related to making PS/PDF output
5232 from "man -l -Tps" look better. The current changes:
5234 - render synopsis and verbatim sections in a monospace/code font
5236 - put a light-grey background behind all programlisting, screen,
5237 and literallayout instances
5239 - prevent SH heads in PS output from being rendered in uppercase
5240 (as they are in console output)
5242 - also display xrefs to SH heads in PS output in normal case
5243 (instead of uppercase)
5245 - draw a line under SH heads in PS output
5247 The changes made to the code to support the above features were:
5249 - added some embedded/custom macros: one for conditionally
5250 upper-casing SH x-refs, one for redefining the SH macro
5251 itself, with some conditional handling for PS output, and
5252 finally a macro for putting a background/screen (filled box)
5253 around a block of text (e.g., a program listing) in PS output
5255 - added utility templates for wrapping blocks of text in code
5256 font; also templates for inline code font
5258 • Robert Stayton: refentry.xsl
5260 refpurpose nodes now get apply-templates instead of just normalize-space().
5262 • Michael(tm) Smith: lists.xsl
5264 Fixed alignment of first lined of text for each listitem in
5265 orderedlist output for TTY. Existing code seemed to have been
5266 causing an extra undesirable space to appear.
5268 • Michael(tm) Smith: lists.xsl
5270 Wrapped some roff conditionals around roff markup for orderedlist
5271 and itemizedlist output, so that the lists look acceptable in PS
5272 output as well as TTY.
5274 • Michael(tm) Smith: pi.xsl; synop.xsl; param.xweb; param.ent
5276 Added the man.funcsynopsis.style parameter. Has the same effect in
5277 manpages output as the funcsynopsis.style parameter has in HTML
5278 output -- except that its default value is 'ansi' instead of 'kr'.
5280 • Michael(tm) Smith: synop.xsl
5282 Reworked handling of K&R funcprototype output. It no longer relies
5283 on the HTML kr-tabular templates, but instead just does direct
5284 transformation to roff. For K&R output, it displays the paramdef
5285 output in an indented list following the prototype.
5287 • Michael(tm) Smith: synop.xsl
5289 Properly integrated handling for K&R output into manpages
5290 stylesheet. The choice between K&R output and ANSI output is
5291 currently controlled through use of the (HTML) funcsynopsis.style
5292 parameter. Note that because the mechanism does currently rely on
5293 funcsynopsis.style, the default in manpages output is now K&R
5294 (because that's the default of that param). But I suppose I ought
5295 to create a man.funcsynopsis.style and make the default for that
5296 ANSI (to preserve the existing default behavior).
5298 • Michael(tm) Smith: docbook.xsl
5300 added manpages/pi.xsl file
5302 • Michael(tm) Smith: .cvsignore; pi.xsl
5304 Added "dbman funcsynopsis-style" PI and incorporated it into the
5307 • Michael(tm) Smith: refentry.xsl
5309 Fixed regression that caused an unescaped dash to be output
5310 between refname and refpurpose content. Closes bug #1894244.
5311 Thanks to Daniel Leidert.
5313 • Michael(tm) Smith: other.xsl
5315 Fixed problem with dots being escaped in filenames of generated
5316 man files. Closes #1827195. Thanks to Daniel Leidert.
5318 • Michael(tm) Smith: inline.xsl
5320 Added support for processing structfield (was appearing in roff
5321 output surrounded by HTML <em> tags; fixed so that it gets roff
5322 ital markup). Closes bug #1858329. Thanks to Sam Varshavchik.
5326 The following changes have been made to the epub code since the 1.73.2 release.
5328 • Keith Fahlgren: bin/spec/README; bin/spec/epub_realbook_spec.rb
5330 'Realbook' spec now passes
5332 • Keith Fahlgren: bin/dbtoepub; README; bin/spec/README; bin/lib/docbook.rb;
5335 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)
5337 • Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/
5340 Changes to OPF spine to not duplicate idrefs for documents with parts not at the root; regression specs for same
5342 • Keith Fahlgren: docbook.xsl
5344 Fixing linking to cover @id, distinct from other needs of cover-image-id (again, thanks to Martin Goerner)
5346 • Keith Fahlgren: docbook.xsl
5348 Updating the title of the toc element in the guide to be more explicit (thanks to Martin Goerner)
5350 • Keith Fahlgren: bin/spec/examples/amasque_exploded/content.opf; bin/spec/
5353 Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
5354 and Keith Fahlgren of O'Reilly.
5356 • Keith Fahlgren: docbook.xsl
5358 == General epub test support
5360 $ spec -O ~/.spec.opts spec/epub_spec.rb
5363 - should be able to be created
5364 - should fail on a nonexistent file
5365 - should be able to render to a file
5366 - should create a file after rendering
5367 - should have the correct mimetype after rendering
5368 - should be valid .epub after rendering an article
5369 - should be valid .epub after rendering an article without sections
5370 - should be valid .epub after rendering a book
5371 - should be valid .epub after rendering a book even if it has one graphic
5372 - should be valid .epub after rendering a book even if it has many graphics
5373 - should be valid .epub after rendering a book even if it has many duplicated graphics
5374 - should report an empty file as invalid
5375 - should confirm that a valid .epub file is valid
5376 - should not include PDFs in rendered epub files as valid image inclusions
5377 - should include a TOC link in rendered epub files for <book>s
5379 Finished in 20.608395 seconds
5381 15 examples, 0 failures
5384 == Verbose epub test coverage against _all_ of the testdocs
5386 Fails on only (errors truncated):
5388 '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
5389 '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
5392 Finished in 629.89194 seconds
5394 224 examples, 15 failures
5396 224 examples, 15 failures yields 6% failure rate
5400 The following changes have been made to the htmlhelp code since the 1.73.2
5403 • Mauritz Jeanson: htmlhelp-common.xsl
5405 Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
5406 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
5407 This makes chunk.quietly=1 suppress chunk filename messages also for help
5408 support files (which seems to be what one would expect). See bug #1648360.
5412 The following changes have been made to the eclipse code since the 1.73.2
5415 • David Cramer: eclipse.xsl
5417 Use sortas attributes (if they exist) when sorting indexterms
5419 • David Cramer: eclipse.xsl
5421 Added support for indexterm/see in eclipse index.xml
5423 • Mauritz Jeanson: eclipse.xsl
5425 Added <xsl:with-param name="quiet" select="$chunk.quietly"/>
5426 to helpidx template.
5428 • David Cramer: eclipse.xsl
5430 Generate index.xml file and add related goo to plugin.xml file. Does not yet support see and seealso.
5432 • Mauritz Jeanson: eclipse.xsl
5434 Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
5435 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
5436 This makes chunk.quietly=1 suppress chunk filename messages also for help
5437 support files (which seems to be what one would expect). See bug #1648360.
5441 The following changes have been made to the javahelp code since the 1.73.2
5444 • Mauritz Jeanson: javahelp.xsl
5446 Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
5447 the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
5448 This makes chunk.quietly=1 suppress chunk filename messages also for help
5449 support files (which seems to be what one would expect). See bug #1648360.
5453 The following changes have been made to the roundtrip code since the 1.73.2
5456 • Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl
5458 fix table/cell borders for wordml, fix formal figure, add emphasis-strong
5460 • Mauritz Jeanson: supported.xml
5464 • Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml
5466 added pubdate, fixed metadata handling in biblioentry
5468 • Steve Ball: supported.xml
5470 Added support for edition.
5472 • Steve Ball: docbook-pages.xsl; wordml-blocks.xsl; docbook.xsl; wordml.xsl;
5475 Removed stylesheets for old, deprecated conversion method.
5477 • Steve Ball: specifications.xml; dbk2ooo.xsl; blocks2dbk.xsl; dbk2pages.xsl;
5480 Added support for Open Office, added edition element, improved list and table support in Word and Pages
5482 • Steve Ball: normalise-common.xsl; blocks2dbk.xsl; dbk2pages.xsl;
5483 template-pages.xml; templ⋯
5485 Fixed bug in WordML table handling, improved table handling for Pages 08, synchronised WordML and Pages templates.
5487 • Steve Ball: normalise-common.xsl; blocks2dbk.xsl; wordml2normalise.xsl;
5490 fix caption, attributes
5492 • Steve Ball: specifications.xml; blocks2dbk.xsl; wordml2normalise.xsl;
5493 blocks2dbk.dtd; temp⋯
5495 Fixes to table and list handling
5497 • Steve Ball: blocks2dbk.xsl
5499 added support for explicit emphasis character styles
5501 • Steve Ball: wordml2normalise.xsl
5503 added support for customisation in image handling
5505 • Steve Ball: blocks2dbk.xsl
5507 Added inlinemediaobject support for metadata.
5509 • Steve Ball: normalise-common.xsl; blocks2dbk.xsl; template.xml;
5510 dbk2wordml.xsl; dbk2wp.xsl
5512 Added support file. Added style locking. Conversion bug fixes.
5516 The following changes have been made to the slides code since the 1.73.2
5519 • Michael(tm) Smith: fo/Makefile; html/Makefile
5521 Added checks and hacks to various makefiles to enable building
5522 under Cygwin. This stuff is ugly and maybe not worth the mess and
5523 trouble, but does seem to work as expected and not break anything
5526 • Jirka Kosek: html/plain.xsl
5528 Added support for showing foil number
5532 The following changes have been made to the website code since the 1.73.2
5535 • Michael(tm) Smith: extensions/saxon64/.classes/.gitignore; extensions/
5536 xalan2/.classes/com/⋯
5538 renamed a bunch more .cvsignore files to .gitignore (to facilitate use of git-svn)
5542 The following changes have been made to the params code since the 1.73.2
5545 • Keith Fahlgren: epub.autolabel.xml
5547 New parameter for epub, epub.autolabel
5549 • Mauritz Jeanson: table.frame.border.color.xml; table.cell.padding.xml;
5550 table.cell.border.t⋯
5552 Added missing refpurposes and descriptions.
5554 • Keith Fahlgren: ade.extensions.xml
5556 Extensions to support Adobe Digital Editions extensions in .epub output.
5558 • Mauritz Jeanson: fop.extensions.xml; fop1.extensions.xml
5560 Clarified that fop1.extensions is for FOP 0.90 and later. Version 1 is not here yet...
5562 • Michael(tm) Smith: man.links.are.underlined.xml;
5563 man.endnotes.list.enabled.xml; man.font.l⋯
5565 removed man.links.are.underlined and added man.font.links. Also,
5566 changed the default font formatting for links to bold.
5568 • Michael(tm) Smith: man.base.url.for.relative.links.xml
5570 Added new param man.base.url.for.relative.links .. specifies a
5571 base URL for relative links (for ulink, @xlink:href, imagedata,
5572 audiodata, videodata) shown in the generated NOTES section of
5573 man-page output. The value of man.base.url.for.relative.links is
5574 prepended to any relative URI that is a value of ulink url,
5575 xlink:href, or fileref attribute.
5577 If you use relative URIs in link sources in your DocBook refentry
5578 source, and you leave man.base.url.for.relative.links unset, the
5579 relative links will appear "as is" in the NOTES section of any
5580 man-page output generated from your source. That's probably not
5581 what you want, because such relative links are only usable in the
5582 context of HTML output. So, to make the links meaningful and
5583 usable in the context of man-page output, set a value for
5584 man.base.url.for.relative.links that points
5585 to the online version of HTML output generated from your DocBook
5586 refentry source. For example:
5588 <xsl:param name="man.base.url.for.relative.links"
5589 >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param>
5591 • Michael(tm) Smith: man.string.subst.map.xml
5593 squeeze .sp\n.sp into a single .sp (to prevent a extra, spurious
5594 line of whitespace from being inserted after programlisting etc.
5597 • Michael(tm) Smith: refentry.manual.fallback.profile.xml;
5598 refentry.source.fallback.profile.⋯
5600 don't use refmiscinfo@class=date value as fallback for refentry
5601 "source" or "manual" metadata fields
5603 • Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml;
5606 made some further doc tweaks related to the
5607 man.charmap.subset.profile.english param
5609 • Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml;
5612 Added the man.charmap.subset.profile.english parameter and refined
5613 the handling of charmap subsets to differentiate between English
5614 and non-English source.
5616 This way charmap subsets are now handled is this:
5618 If the value of the man.charmap.use.subset parameter is non-zero,
5619 and your DocBook source is not written in English (that is, if its
5620 lang or xml:lang attribute has a value other than en), then the
5621 character-map subset specified by the man.charmap.subset.profile
5622 parameter is used instead of the full roff character map.
5624 Otherwise, if the lang or xml:lang attribute on the root element
5625 in your DocBook source or on the first refentry element in your
5626 source has the value en or if it has no lang or xml:lang
5627 attribute, then the character-map subset specified by the
5628 man.charmap.subset.profile.english parameter is used instead of
5629 man.charmap.subset.profile.
5631 The difference between the two subsets is that
5632 man.charmap.subset.profile provides mappings for characters in
5633 Western European languages that are not part of the Roman
5634 (English) alphabet (ASCII character set).
5636 • Michael(tm) Smith: man.charmap.subset.profile.xml
5638 Added to default charmap used by manpages:
5640 - the "letters" part of the 'C1 Controls And Latin-1 Supplement
5641 (Latin-1 Supplement)' Unicode block
5642 - Latin Extended-A block (but not all of the characters from
5643 that block have mappings in groff, so some of them are still
5644 passed through as-is)
5646 The effects of this change are that in man pages generated for
5647 most Western European languages and for Finnish, all characters
5648 not part of the Roman alphabet are (e.g., "accented" characters)
5649 are converted to groff escapes.
5651 Previously, by default we passed through those characters as is
5652 (and users needed to use the full charmap if they wanted to have
5653 those characters converted).
5655 As a result of this change, man pages generated for Western
5656 European languages will be viewable in some environments in which
5657 they are not viewable if the "raw" non-Roman characters are in them.
5659 • Mauritz Jeanson: generate.legalnotice.link.xml;
5660 generate.revhistory.link.xml
5662 Added information on how the filename is computed.
5664 • Mauritz Jeanson: default.table.width.xml
5668 • Michael(tm) Smith: man.funcsynopsis.style.xml
5670 Added the man.funcsynopsis.style parameter. Has the same effect in
5671 manpages output as the funcsynopsis.style parameter has in HTML
5672 output -- except that its default value is 'ansi' instead of 'kr'.
5674 • Michael(tm) Smith: funcsynopsis.tabular.threshold.xml
5676 Removed the funcsynopsis.tabular.threshold param. It's no longer
5677 being used in the code and hasn't been since mid 2006.
5679 • Mauritz Jeanson: table.properties.xml
5681 Set keep-together.within-column to "auto". This seems to be the most sensible
5682 default value for tables.
5684 • Mauritz Jeanson: informal.object.properties.xml;
5685 admon.graphics.extension.xml; informalequ⋯
5687 Several small documentation fixes.
5689 • Mauritz Jeanson: manifest.in.base.dir.xml
5693 • Mauritz Jeanson: header.content.properties.xml;
5694 footer.content.properties.xml
5698 • Mauritz Jeanson: ulink.footnotes.xml; ulink.show.xml
5700 Updated for DocBook 5.
5702 • Mauritz Jeanson: index.method.xml; glossterm.auto.link.xml
5704 Spelling and wording fixes.
5706 • Mauritz Jeanson: callout.graphics.extension.xml
5708 Clarifed available graphics formats and extensions.
5710 • Mauritz Jeanson: footnote.sep.leader.properties.xml
5712 Corrected refpurpose.
5714 • Jirka Kosek: footnote.properties.xml
5716 Added more properties which make it possible to render correctly footnotes placed inside verbatim elements.
5718 • Mauritz Jeanson: img.src.path.xml
5720 img.src.path works with inlinegraphic too.
5722 • Mauritz Jeanson: saxon.character.representation.xml
5726 • Mauritz Jeanson: img.src.path.xml
5728 Updated description of img.src.path. Bug #1785224 revealed that
5729 there was a risk of misunderstanding how it works.
5733 The following changes have been made to the profiling code since the 1.73.2
5736 • Jirka Kosek: xsl2profile.xsl
5738 Added new rules to profile all content generated by HTML Help (including alias files)
5740 • Robert Stayton: profile-mode.xsl
5742 use mode="profile" instead of xsl:copy-of for attributes so
5743 they can be more easily customized.
5747 The following changes have been made to the tools code since the 1.73.2
5750 • Michael(tm) Smith: make/Makefile.DocBook
5752 various changes and additions to support making with asciidoc as
5755 • Michael(tm) Smith: make/Makefile.DocBook
5757 make dblatex the default PDF maker for the example makefile
5759 • Michael(tm) Smith: xsl/build/html2roff.xsl
5761 Reworked handling of K&R funcprototype output. It no longer relies
5762 on the HTML kr-tabular templates, but instead just does direct
5763 transformation to roff. For K&R output, it displays the paramdef
5764 output in an indented list following the prototype.
5766 • Mauritz Jeanson: xsl/build/make-xsl-params.xsl
5768 Made attribute-sets members of the param list. This enables links to attribute-sets in the
5769 reference documentation.
5771 • Michael(tm) Smith: xsl/build/html2roff.xsl
5773 use .BI handling in K&R funsynopsis output for manpages, just as
5774 we do already of ANSI output
5776 • Michael(tm) Smith: xsl/build/html2roff.xsl
5778 Implemented initial support for handling tabular K&R output of
5779 funcprototype in manpages output. Accomplished by adding more
5780 templates to the intermediate HTML-to-roff stylesheet that the
5781 build uses to create the manpages/html-synop.xsl stylesheet.
5783 • Michael(tm) Smith: xsl/build/doc-link-docbook.xsl
5785 Made the xsl/tools/xsl/build/doc-link-docbook.xsl stylesheet
5786 import profile-docbook.xsl, so that we can do profiling of release
5787 notes. Corrected some problems in the target for the release-notes
5792 The following changes have been made to the extensions code since the 1.73.2
5795 • Keith Fahlgren: Makefile
5797 Use DOCBOOK_SVN variable everywhere, please; build with PDF_MAKER
5799 • Michael(tm) Smith: Makefile
5801 moved extensions build targets from master xsl/Makefile to
5802 xsl/extensions/Makefile
5804 • Michael(tm) Smith: .cvsignore
5806 re-adding empty extensions subdir
5810 The following changes have been made to the xsl-saxon code since the 1.73.2
5813 • Michael(tm) Smith: VERSION
5815 bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
5816 recent change to snapshot build infrastructure
5818 • Michael(tm) Smith: nbproject/build-impl.xml; nbproject/project.properties
5820 Changed hard-coded file references in "clean" target to variable
5821 references. Closes #1792043. Thanks to Daniel Leidert.
5823 • Michael(tm) Smith: VERSION; Makefile
5825 Did post-release wrap-up of xsl-saxon and xsl-xalan dirs
5827 • Michael(tm) Smith: nbproject/build-impl.xml; VERSION; Makefile; test
5829 More tweaks to get release-ready
5833 The following changes have been made to the xsl-xalan code since the 1.73.2
5836 • Michael(tm) Smith: VERSION
5838 bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
5839 recent change to snapshot build infrastructure
5841 • Michael(tm) Smith: nbproject/build-impl.xml
5843 Changed hard-coded file references in "clean" target to variable
5844 references. Closes #1792043. Thanks to Daniel Leidert.
5846 • Michael(tm) Smith: Makefile; VERSION
5848 Did post-release wrap-up of xsl-saxon and xsl-xalan dirs
5850 • Michael(tm) Smith: Makefile; nbproject/build-impl.xml; VERSION
5852 More tweaks to get release-ready
5856 The following changes have been made to the xsl-libxslt code since the 1.73.2
5859 • Mauritz Jeanson: python/xslt.py
5861 Print the result to stdout if no outfile has been given.
5862 Some unnecessary semicolons removed.
5864 • Mauritz Jeanson: python/xslt.py
5866 Added a function that quotes parameter values (to ensure that they are interpreted as strings).
5867 Replaced deprecated functions from the string module with string methods.
5869 • Michael(tm) Smith: python/README; python/README.LIBXSLT
5871 renamed xsl-libxslt/python/README to xsl-libxslt/python/README.LIBXSLT
5873 • Mauritz Jeanson: python/README
5875 Tweaked the text a little.
5877 Release Notes: 1.73.2
5879 This is solely a minor bug-fix update to the 1.73.1 release. It fixes a
5880 packaging error in the 1.73.1 package, as well as a bug in footnote handling in
5885 This is mostly a bug-fix update to the 1.73.0 release.
5889 The following changes have been made to the gentext code since the 1.73.0
5892 • Mauritz Jeanson: locale/de.xml
5894 Applied patch #1766009.
5896 • Michael(tm) Smith: locale/lv.xml
5898 Added localization for ProductionSet.
5902 The following changes have been made to the fo code since the 1.73.0 release.
5904 • Mauritz Jeanson: table.xsl
5906 Modified the tgroup template so that, for tables with multiple tgroups,
5907 a width attribute is output on all corresponding fo:tables. Previously,
5908 there was a test prohibiting this (and a comment saying that outputting more
5909 than one width attribute will cause an error). But this seems to be no longer
5910 relevant; it is not a problem with FOP 0.93 or XEP 4.10. Closes bug #1760559.
5912 • Mauritz Jeanson: graphics.xsl
5914 Replaced useless <a> elements with warning messages (textinsert extension).
5916 • Mauritz Jeanson: admon.xsl
5918 Enabled generation of ids (on fo:wrapper) for indexterms in admonition titles, so that page
5919 references in the index can be created. Closes bug #1775086.
5923 The following changes have been made to the html code since the 1.73.0 release.
5925 • Mauritz Jeanson: titlepage.xsl
5927 Added <xsl:call-template name="process.footnotes"/> to abstract template
5928 so that footnotes in info/abstract are processed. Closes bug #1760907.
5930 • Michael(tm) Smith: pi.xsl; synop.xsl
5932 Changed handling of HTML output for the cmdsynopsis and
5933 funcsynopsis elements, such that a@id instances are generated for
5934 them if they are descendants of any element containing a dbcmdlist
5935 or dbfunclist PI. Also, update the embedded reference docs for the
5936 dbcmdlist and dbfunclist PIs to make it clear that they can be
5937 used within any element for which cmdsynopsis or funcsynopsis are
5940 • Michael(tm) Smith: formal.xsl
5942 Reverted the part of revision 6952 that caused a@id anchors to be
5943 generated for output of informal objects. Thanks to Sam Steingold
5946 • Robert Stayton: glossary.xsl
5948 Account for a glossary with no glossdiv or glossentry children.
5950 • Mauritz Jeanson: titlepage.xsl
5952 Modified legalnotice template so that the base.name parameter is calculated
5953 in the same way as for revhistory chunks. Using <xsl:apply-templates
5954 mode="chunk-filename" select="."/> did not work for single-page output since
5955 the template with that mode is in chunk-code.xsl.
5957 • Mauritz Jeanson: graphics.xsl
5959 Updated support for SVG (must be a child of imagedata in DB 5).
5960 Added support for MathML in imagedata.
5962 • Mauritz Jeanson: pi.xsl
5964 Added documentation for the dbhh PI (used for context-sensitive HTML Help).
5965 (The two templates matching 'dbhh' are still in htmlhelp-common.xsl).
5969 The following changes have been made to the manpages code since the 1.73.0
5972 • Michael(tm) Smith: endnotes.xsl
5974 In manpages output, generate warnings about notesources with
5975 non-para children only if the notesource is a footnote or
5976 annotation. Thanks to Sam Steingold for reporting problems with
5977 the existing handling.
5981 The following changes have been made to the htmlhelp code since the 1.73.0
5984 • Michael(tm) Smith: htmlhelp-common.xsl
5986 Added single-pass namespace-stripping support to the htmlhelp,
5987 eclipse, and javahelp stylesheets.
5991 The following changes have been made to the eclipse code since the 1.73.0
5994 • Michael(tm) Smith: eclipse.xsl
5996 Added single-pass namespace-stripping support to the htmlhelp,
5997 eclipse, and javahelp stylesheets.
6001 The following changes have been made to the javahelp code since the 1.73.0
6004 • Michael(tm) Smith: javahelp.xsl
6006 Added single-pass namespace-stripping support to the htmlhelp,
6007 eclipse, and javahelp stylesheets.
6011 The following changes have been made to the roundtrip code since the 1.73.0
6014 • Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; pages2normalise.xsl
6016 Modularised blocks2dbk to allow customisation,
6017 Added support for tables to pages2normalise
6021 The following changes have been made to the params code since the 1.73.0
6024 • Robert Stayton: procedure.properties.xml
6026 procedure was inheriting keep-together from formal.object.properties, but
6027 a procedure does not need to be kept together by default.
6029 • Dave Pawson: title.font.family.xml;
6030 component.label.includes.part.label.xml; table.frame.b⋯
6032 Regular formatting re-org.
6036 This release includes important bug fixes and adds the following significant
6039 New localizations and localization updates
6041 We added two new localizations: Latvian and Esperanto, and made updates to
6042 the Czech, Chinese Simplified, Mongolian, Serbian, Italian, and Ukrainian
6045 ISO690 citation style for bibliography output.
6047 Set the bibliography.style parameter to iso690 to use ISO690 style.
6049 New documentation for processing instructions (PI)
6051 The reference documentation that ships with the release now includes
6052 documentation on all PIs that you can use to control output from the
6055 New profiling parameters for audience and wordsize
6057 You can now do profiling based on the values of the audience and wordsize
6060 Changes to man-page output
6062 The manpages stylesheet now supports single-pass profiling and single-pass
6063 DocBook 5 namespace stripping (just as the HTML and FO stylesheets also
6064 do). Also, added handling for mediaobject & inlinemediaobject. (Each
6065 imagedata, audiodata, or videodata element within a mediaobject or inline
6066 mediaobject is now treated as a "notesource" and so handled in much the
6067 same way as links and annotation/alt/footnote are in manpages output.) And
6068 added the man.authors.section.enabled and man.copyright.section.enabled
6069 parameters to enable control over whether output includes auto-generated
6070 AUTHORS and COPYRIGHT sections.
6072 Highlighting support for C
6074 The highlighting mechanism for generating syntax-highlighted code snippets
6075 in output now supports C code listings (along with Java, PHP, XSLT, and
6078 Experimental docbook-xsl-update script
6080 We added an experimental docbook-xsl-update script, the purpose of which is
6081 to facilitate easy sync-up to the latest docbook-xsl snapshot (by means of
6086 The following changes have been made to the gentext code since the 1.72.0
6089 • Michael(tm) Smith: locale/lv.xml; Makefile
6091 Added Latvian localization file, from Girts Ziemelis.
6093 • Dongsheng Song: locale/zh_cn.xml
6095 Brought up to date with en.xml in terms of items. A few strings marked for translation.
6097 • Jirka Kosek: locale/cs.xml
6099 Added missing translations
6101 • Robert Stayton: locale/eo.xml
6103 New locale for Esperanto.
6105 • Robert Stayton: locale/mn.xml
6107 Update from Ganbold Tsagaankhuu.
6109 • Jirka Kosek: locale/en.xml; locale/cs.xml
6111 Rules for normalizing glossary entries before they are sorted can be now different for each language.
6113 • Michael(tm) Smith: locale/sr_Latn.xml; locale/sr.xml
6115 Committed changes from Miloš Komarčević to Serbian files.
6117 • Robert Stayton: locale/ja.xml
6119 Fix chapter in context xref-number-and-title
6121 • Robert Stayton: locale/it.xml
6123 Improved version from contributor.
6125 • Mauritz Jeanson: locale/uk.xml
6127 Applied patch 1592083.
6131 The following changes have been made to the common code since the 1.72.0
6134 • Michael(tm) Smith: labels.xsl
6136 Changed handling of reference auto-labeling such that reference
6137 (when it appears at the component level) is now affected by the
6138 label.from.part param, just as preface, chapter, and appendix.
6140 • Michael(tm) Smith: common.xsl
6142 Added support to the HTML stylesheets for proper processing of
6143 orgname as a child of author.
6145 • Michael(tm) Smith: refentry.xsl
6147 Refined logging output of refentry metadata-gathering template;
6148 for some cases of "missing" elements (refmiscinfo stuff, etc.),
6149 the log messages now include URL to corresponding page in the
6150 Definitive Guide (TDG).
6152 • Robert Stayton: titles.xsl
6154 Add refsection/info/title support.
6156 • Michael(tm) Smith: titles.xsl
6158 Added support for correct handling of xref to elements that
6159 contain info/title descendants but no title children.
6161 This should be further refined so that it handles any *info
6162 elements. And there are probably some other places where similar
6163 handling for *info/title should be added.
6165 • Mauritz Jeanson: pi.xsl
6167 Modified <xsl:when> in datetime.format template to work
6172 The following changes have been made to the fo code since the 1.72.0 release.
6174 • Robert Stayton: component.xsl
6176 Add parameters to the page.sequence utility template.
6178 • Mauritz Jeanson: xref.xsl
6180 Added template for xref to area/areaset.
6181 Part of fix for bug #1675513 (xref to area broken).
6183 • Michael(tm) Smith: inline.xsl
6185 Added template match for person element to fo stylesheet.
6187 • Robert Stayton: lists.xsl
6189 Added support for spacing="compact" in variablelist, per bug report #1722540.
6191 • Robert Stayton: table.xsl
6193 table pgwide="1" should also use pgwide.properties attribute-set.
6195 • Mauritz Jeanson: inline.xsl
6197 Make citations numbered if bibliography.numbered != 0.
6199 • Robert Stayton: param.xweb; param.ent
6201 Add new profiling parameters for audience and wordsize.
6203 • Robert Stayton: param.xweb; param.ent
6205 Added callout.icon.size parameter.
6207 • Robert Stayton: inline.xsl; xref.xsl
6209 Add support for xlink as olink.
6211 • Robert Stayton: autotoc.xsl; param.xweb; param.ent
6213 Add support for qanda.in.toc to fo TOC.
6215 • Robert Stayton: component.xsl
6217 Improved the page.sequence utility template for use with book.
6219 • Robert Stayton: division.xsl
6221 Refactored the big book template into smaller pieces.
6222 Used the "page.sequence" utility template in
6223 component.xsl to shorten the toc piece.
6224 Added placeholder templates for front.cover and back.cover.
6226 • Robert Stayton: param.xweb; param.ent; sections.xsl
6228 Add section.container.element parameter to enable
6229 pgwide spans inside sections.
6231 • Robert Stayton: param.xweb; param.ent; component.xsl
6233 Add component.titlepage.properties attribute-set to
6234 support span="all" and other properties.
6236 • Robert Stayton: htmltbl.xsl; table.xsl
6238 Apply table.row.properties template to html tr rows too.
6239 Add keep-with-next to table.row.properties when row is in thead.
6241 • Robert Stayton: table.xsl
6243 Add support for default.table.frame parameter.
6244 Fix bug 1575446 rowsep last check for @morerows.
6246 • Robert Stayton: refentry.xsl
6248 Add support for info/title in refsections.
6250 • David Cramer: qandaset.xsl
6252 Make fo questions and answers behave the same way as html
6254 • Jirka Kosek: lists.xsl
6256 Added missing attribute set for procedure
6258 • Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent;
6261 Added support for formatting biblioentries according to ISO690 citation style.
6262 New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
6263 The code was provided by Jana Dvorakova
6265 • Robert Stayton: param.xweb; param.ent; pagesetup.xsl
6267 Add header.table.properties and footer.table.properties attribute-sets.
6269 • Robert Stayton: inline.xsl
6271 Add fop1.extensions for menuchoice arrow handling exception.
6275 The following changes have been made to the html code since the 1.72.0 release.
6277 • Mauritz Jeanson: param.xweb; param.ent
6279 Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the
6280 regular "parameter machinery".
6282 • Michael(tm) Smith: admon.xsl
6284 Changed handling of titles for note, warning, caution, important,
6285 tip admonitions: We now output and HTML h3 head only if
6286 admon.textlabel is non-zero or if the admonition actually contains
6287 a title; otherwise, we don't output an h3 head at all.
6288 (Previously, we were outputting an empty h3 if the admon.textlabel
6289 was zero and if the admonition had no title.)
6291 • Mauritz Jeanson: xref.xsl
6293 Added template for xref to area/areaset.
6294 Part of fix for bug #1675513 (xref to area broken).
6296 • Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; sections.xsl
6298 Added fixes to avoid duplicate ids when generate.id.attributes = 1.
6299 This (hopefully) closes bug #1671052.
6301 • Michael(tm) Smith: formal.xsl; pi.xsl
6303 Made the dbfunclist PI work as intended. Also added doc for
6304 dbfunclist and dbcmdlist PIs.
6306 • Michael(tm) Smith: pi.xsl; synop.xsl
6308 Made the dbcmdlist work the way it appears to have been intended
6309 to work. Restored dbhtml-dir template back to pi.xsl.
6311 • Michael(tm) Smith: titlepage.xsl; param.xweb; param.ent
6313 Added new param abstract.notitle.enabled.
6314 If non-zero, in output of the abstract element on titlepages,
6315 display of the abstract title is suppressed.
6316 Because sometimes you really don't want or need that title
6319 • Michael(tm) Smith: chunk-code.xsl; graphics.xsl
6321 When we are chunking long descriptions for mediaobject instances
6322 into separate HTML output files, and use.id.as.filename is
6323 non-zero, if a mediaobject has an ID, use that ID as the basename
6324 for the long-description file (otherwise, we generate an ID for it
6325 and use that ID as the basename for the file).
6326 The parallels the recent change made to cause IDs for legalnotice
6327 instances to be used as basenames for legalnotice chunks.
6328 Also, made some minor refinements to the recent changes for
6329 legalnotice chunk handling.
6331 • Michael(tm) Smith: titlepage.xsl
6333 Added support to the HTML stylesheets for proper processing of
6334 orgname as a child of author.
6336 • Michael(tm) Smith: chunk-code.xsl
6338 When $generate.legalnotice.link is non-zero and
6339 $use.id.as.filename is also non-zero, if a legalnotice has an ID,
6340 then instead of assigning the "ln-<generatedID>" basename to the
6341 output file for that legalnotice, just use its real ID as the
6342 basename for the file -- as we do when chunking other elements
6345 • David Cramer: xref.xsl
6347 Handle alt text on xrefs to steps when the step doesn't have a title.
6349 • David Cramer: lists.xsl
6351 Added <p> element around term in variablelist when formatted as table to avoid misalignment of term and listitem in xhtml (non-quirks mode) output
6353 • David Cramer: qandaset.xsl
6355 Added <p> element around question and answer labels to avoid misalignment of label and listitem in xhtml (non-quirks mode) output
6357 • David Cramer: lists.xsl
6359 Added <p> element around callouts to avoid misalignment of callout and listitem in xhtml (non-quirks mode) output
6361 • Mauritz Jeanson: inline.xsl
6363 Make citations numbered if bibliography.numbered != 0.
6365 • Robert Stayton: param.xweb; param.ent
6367 Add support for new profiling attributes audience and wordsize.
6369 • Robert Stayton: inline.xsl; xref.xsl
6371 Add support for xlink olinks.
6373 • Jirka Kosek: glossary.xsl
6375 Rules for normalizing glossary entries before they are sorted can be now different for each language.
6377 • Robert Stayton: chunk-common.xsl; chunk-code.xsl; manifest.xsl; chunk.xsl
6379 Refactored the chunking modules to move all named templates to
6380 chunk-common.xsl and all match templates to chunk-code.xsl, in
6381 order to enable better chunk customization.
6382 See the comments in chunk.xsl for more details.
6384 • Robert Stayton: lists.xsl
6386 Add anchor for xml:id for listitem in varlistentry.
6388 • Robert Stayton: refentry.xsl
6390 Add support for info/title in refsections for db5.
6392 • Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent;
6395 Added support for formatting biblioentries according to ISO690 citation style.
6396 New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
6397 The code was provided by Jana Dvorakova
6399 • Robert Stayton: inline.xsl; xref.xsl
6401 Add call to class.attribute to <a> output elements so they can
6402 have a class value too.
6404 • Mauritz Jeanson: glossary.xsl
6407 * Added curly braces around all $language attribute values.
6408 * Moved declaration of language variable to top level of stylesheet.
6409 Tested with Xalan, Saxon, and xsltproc.
6413 The following changes have been made to the manpages code since the 1.72.0
6416 • Michael(tm) Smith: param.xweb; docbook.xsl; param.ent
6418 Added the man.authors.section.enabled and
6419 man.copyright.section.enabled parameters. Set those to zero when
6420 you want to suppress display of the auto-generated AUTHORS and
6421 COPYRIGHT sections. Closes request #1467806. Thanks to Daniel
6424 • Michael(tm) Smith: docbook.xsl
6426 Took the test that the manpages stylesheet does to see if there
6427 are any Refentry chilren in current doc, and made it
6428 namespace-agnostic. Reason for that is because the test otherwise
6429 won't work when it is copied over into the generated
6430 profile-docbook.xsl stylesheet.
6432 • Michael(tm) Smith: Makefile
6434 Added a manpages/profile-docbook.xsl file to enable single-pass
6435 profiling for manpages output.
6437 • Michael(tm) Smith: info.xsl
6439 Output copyright and legalnotice in man-page output in whatever
6440 place they are in in document order. Closes #1690539. Thanks to
6441 Daniel Leidert for reporting.
6443 • Michael(tm) Smith: docbook.xsl
6445 Restored support for single-pass namespace stripping to manpages
6448 • Michael(tm) Smith: synop.xsl; block.xsl; info.xsl; inline.xsl; lists.xsl;
6451 Changed handling of bold and italic/underline output in manpages
6452 output. Should be transparent to users, but...
6454 This touches handling of all bold and italic/underline output. The
6455 exact change is that the mode="bold" and mode="italic" utility
6456 templates were changed to named templates. (I think maybe I've
6457 changed it back and forth from mode to named before, so this is
6458 maybe re-reverting it yet again).
6460 Anyway, the reason for the change is that the templates are
6461 sometimes call on dynamically node-sets, and using modes to format
6462 those doesn't allow passing info about the current/real context
6463 node from the source (not the node-set created by the stylesheet)
6464 to that formatting stage.
6466 The named templates allow the context to be passed in as a
6467 parameter, so that the bold/ital formatting template can use
6468 context-aware condition checking.
6470 This was basically necessary in order to suppress bold formatting
6471 in titles, which otherwise gets screwed up because of the numbnut
6472 way that roff handles nested bold/ital.
6474 Closes #1674534). Much thanks to Daniel Leidert, whose in his
6475 docbook-xsl bug-finding kung-fu has achieved Grand Master status.
6477 • Michael(tm) Smith: block.xsl
6479 Fixed handling of example instances by adding the example element
6480 to the same template we use for processing figure. Closes
6481 #1674538. Thanks to Daniel Leidert.
6483 • Michael(tm) Smith: utility.xsl
6485 Don't include lang in manpages filename/pathname if lang=en (that
6486 is, only generate lang-qualified file-/pathnames for non-English).
6488 • Michael(tm) Smith: endnotes.xsl
6490 In manpages output, emit warnings for notesources (footnote, etc.)
6491 that have something other than para as a child.
6493 The numbered-with-hanging-indent formatting that's used for
6494 rendering endnotes in the NOTES section of man pages places some
6495 limits/assumptions on how the DocBook source is marked up; namely,
6496 for notesources (footnote, annotation, etc.) that can contain
6497 block-level children, if the they have a block-level child such as
6498 a table or itemizedlist or orderedlist that is the first child of
6499 a footnote, we have no way of rendering/indenting its content
6500 properly in the endnotes list.
6502 Thus, the manpages stylesheet not emits a warning message for that
6503 case, and suggests the "fix" (which is to wrap the table or
6504 itemizedlist or whatever in a para that has some preferatory text.
6506 • Michael(tm) Smith: utility.xsl
6508 Added support to mixed-block template for handling tables in
6509 mixed-blocks (e.g., as child of para) correctly.
6511 • Michael(tm) Smith: table.xsl; synop.xsl; block.xsl; info.xsl; lists.xsl;
6514 Reverted necessary escaping of backslash, dot, and dash
6515 out of the well-intentioned (but it now appears,
6516 misguided) "marker" mechanism (introduced in the 1.72.0
6517 release) -- which made use of alternative "marker"
6518 characters as internal representations of those
6519 characters, and then replaced them just prior to
6520 serialization -- and back into what's basically the
6521 system that was used prior to the 1.69.0 release; that
6522 is, into a part of stylesheet code that gets executed
6523 at the beginning of processing -- before any other roff
6524 markup up is. This change obviates the need for the
6525 marker system. It also requires a lot less RAM during
6526 processing (for large files, the marker mechanism
6527 ending up requiring gigabytes of memory).
6529 Closes bug #1661177. Thanks to Scott Smedley for
6530 providing a test case (the fvwm man page) that exposed
6531 the problem with the marker mechanism.
6533 Also moved the mechanism for converting non-breaking
6534 spaces back into the same area of the stylesheet code.
6536 • Michael(tm) Smith: lists.xsl
6538 Fixed problem with incorrect formatting of nested variablelist.
6539 Closes bug #1650931. Thanks to Daniel "Eagle Eye" Leidert.
6541 • Michael(tm) Smith: lists.xsl
6543 Make sure that all listitems in itemizedlist and orderedlist are
6544 preceded by a blank line. This fixes a regression that occurred
6545 when instances of the TP macro that were use in a previous
6546 versions of the list-handling code were switched to RS/RE (because
6547 TP doesn't support nesting). TP automatically generates a blank
6548 line, but RS doesn't. So I added a .sp before each .RS
6550 • Michael(tm) Smith: block.xsl; inline.xsl; param.xweb; docbook.xsl;
6551 links.xsl; param.ent
6553 Made a number of changes related to elements with
6554 out-of-line content:
6556 - Added handling for mediaobject & inlinemediaobject.
6557 Each imagedata, audiodata, or videodata element
6558 within a mediaobject or inline mediaobject is now
6559 treated as a "notesource" and so handled in much the
6560 same way as links and annotation/alt/footnotes.
6562 That means a numbered marker is generated inline to
6563 mark the place in the main flow where the imagedata,
6564 audiodata, or videodata element occurs, and a
6565 corresponding numbered endnote for it is generated in
6566 the endnotes list at the end of the man page; the
6567 endnote contains the URL from the fileref attribute
6568 of the imagedata, audiodata, or videodata element.
6570 For mediobject and inlinemediaobject instances that
6571 have a textobject child, the textobject is displayed
6572 within the main text flow.
6574 - Renamed several man.link.* params to man.endnotes.*,
6575 to reflect that fact that the endnotes list now
6576 contains more than just links. Also did similar
6577 renaming for a number of stylesheet-internal vars.
6579 - Added support for xlink:href (along with existing
6580 support for the legacy ulink element).
6582 - Cleaned up and streamlined the endnotes-handling
6583 code. It's still messy and klunky and the basic
6584 mechanism it uses is very inefficent for documents
6585 that contain a lot of notesources, but at least it's
6586 a bit better than it was.
6590 The following changes have been made to the eclipse code since the 1.72.0
6593 • Mauritz Jeanson: Makefile
6595 Fixed bug #1715093: Makefile for creating profiled version of eclipse.xsl added.
6597 • David Cramer: eclipse.xsl
6599 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
6603 The following changes have been made to the javahelp code since the 1.72.0
6606 • Mauritz Jeanson: javahelp.xsl
6608 Implemented FR #1230233 (sorted index in javahelp).
6610 • Mauritz Jeanson: javahelp.xsl
6612 Added normalize-space() around titles and index entries to work around whitespace problems.
6613 Added support for glossary and bibliography in toc and map files.
6617 The following changes have been made to the roundtrip code since the 1.72.0
6620 • Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl; normalise2sections.xsl;
6623 new stylesheets for better word processor support and easier maintenance
6625 • Steve Ball: template-pages.xml; dbk2wp.xsl; sections-spec.xml
6631 The following changes have been made to the params code since the 1.72.0
6634 • Mauritz Jeanson: htmlhelp.button.back.xml; htmlhelp.button.forward.xml;
6637 Modified refpurpose text.
6639 • Mauritz Jeanson: htmlhelp.map.file.xml; htmlhelp.force.map.and.alias.xml;
6642 Fixed typos, made some small changes.
6644 • Mauritz Jeanson: javahelp.encoding.xml
6646 Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the
6647 regular "parameter machinery".
6649 • Mauritz Jeanson: generate.id.attributes.xml
6651 Added refpurpose text.
6653 • Mauritz Jeanson: annotation.js.xml; annotation.graphic.open.xml;
6654 annotation.graphic.close.⋯
6656 Added better refpurpose texts.
6658 • Michael(tm) Smith: chunker.output.cdata-section-elements.xml;
6659 chunker.output.standalone.xm⋯
6661 Fixed some broken formatting in source files for chunker.* params,
6662 as pointed out by Dave Pawson.
6664 • Michael(tm) Smith: label.from.part.xml
6666 Changed handling of reference auto-labeling such that reference
6667 (when it appears at the component level) is now affected by the
6668 label.from.part param, just as preface, chapter, and appendix.
6670 • Mauritz Jeanson: callout.graphics.extension.xml
6672 Clarified that 'extension' refers to file names.
6674 • Michael(tm) Smith: abstract.notitle.enabled.xml
6676 Added new param abstract.notitle.enabled.
6677 If non-zero, in output of the abstract element on titlepages,
6678 display of the abstract title is suppressed.
6679 Because sometimes you really don't want or need that title
6682 • Michael(tm) Smith: man.string.subst.map.xml
6684 Updated manpages string-substitute map to reflect fact that
6685 because of another recent change to suppress bold markup in .SH
6686 output, we no longer need to add a workaround for the accidental
6687 uppercasing of roff escapes that occurred previously.
6689 • Jirka Kosek: margin.note.float.type.xml; title.font.family.xml;
6690 table.frame.border.color.x⋯
6692 Improved parameter metadata
6694 • Robert Stayton: profile.wordsize.xml; profile.audience.xml
6696 Add support for profiling on new attributes audience and wordsize.
6698 • Robert Stayton: callout.graphics.number.limit.xml;
6699 callout.graphics.extension.xml
6701 Added SVG graphics for fo output.
6703 • Robert Stayton: callout.icon.size.xml
6705 Set size of callout graphics.
6707 • Jirka Kosek: default.units.xml; chunker.output.method.xml;
6708 toc.list.type.xml; output.inden⋯
6710 Updated parameter metadata to the new format.
6712 • Jirka Kosek: man.output.quietly.xml; title.font.family.xml;
6713 footnote.sep.leader.properties⋯
6715 Added type annotations into parameter definition files.
6717 • Robert Stayton: section.container.element.xml
6719 Support spans in sections for certain processors.
6721 • Robert Stayton: component.titlepage.properties.xml
6723 Empty attribute set for top level component titlepage block.
6724 Allows setting a span on title info.
6726 • Jirka Kosek: bibliography.style.xml
6728 Added link to WiKi page with description of special markup needed for ISO690 biblioentries
6730 • Robert Stayton: make.year.ranges.xml
6732 Clarify that multiple year elements are required.
6734 • Robert Stayton: id.warnings.xml
6736 Turn off id.warnings by default.
6738 • Jirka Kosek: bibliography.style.xml
6740 Added support for formatting biblioentries according to ISO690 citation style.
6741 New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
6742 The code was provided by Jana Dvorakova
6744 • Robert Stayton: header.table.properties.xml; footer.table.properties.xml
6746 Support adding table properties to header and footer tables.
6750 The following changes have been made to the highlighting code since the 1.72.0
6753 • Jirka Kosek: c-hl.xml; xslthl-config.xml
6755 Added support for C language. Provided by Bruno Guegan.
6759 The following changes have been made to the profiling code since the 1.72.0
6762 • Robert Stayton: profile-mode.xsl
6764 Add support for new profiling attributes audience and wordsize.
6768 The following changes have been made to the lib code since the 1.72.0 release.
6770 • Michael(tm) Smith: lib.xweb
6772 Changed name of prepend-pad template to pad-string and twheeked so
6773 it can do both right/left padding.
6777 The following changes have been made to the tools code since the 1.72.0
6780 • Michael(tm) Smith: bin; bin/docbook-xsl-update
6782 Did some cleanup to the install.sh source and added a
6783 docbook-xsl-update script to the docbook-xsl distro, the purpose
6784 of which is to facilitate easy sync-up to the latest docbook-xsl
6785 snapshot (by means of rsync).
6789 The following changes have been made to the xsl-saxon code since the 1.72.0
6792 • Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/
6795 Added modifications so that the new callout.icon.size parameter is taken into account. This
6796 parameter is used for FO output (where SVG now is the default graphics format for callouts).
6798 • Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/
6801 Added code for generating id attributes on callouts in HTML and FO output.
6802 These patches enable cross-references to callouts placed by area coordinates.
6803 It works for graphic, unicode and text callouts.
6804 Part of fix for bug #1675513 (xref to area broken).
6806 • Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/
6809 Copied over Website XSL Java extensions.
6813 The following changes have been made to the xsl-xalan code since the 1.72.0
6816 • Michael(tm) Smith: Makefile; xalan2
6818 Turned off xalan2.jar build. This removes DocBook XSL
6819 Java extensions support for versions of Xalan prior to
6820 Xalan 2.7. If you are currently using the extensions
6821 with an earlier version of Xalan, you need to upgrade
6824 • Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/
6827 Added modifications so that the new callout.icon.size parameter is taken into account. This
6828 parameter is used for FO output (where SVG now is the default graphics format for callouts).
6830 • Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/
6833 Added code for generating id attributes on callouts in HTML and FO output.
6834 These patches enable cross-references to callouts placed by area coordinates.
6835 It works for graphic, unicode and text callouts.
6836 Part of fix for bug #1675513 (xref to area broken).
6838 • Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/
6841 Copied over Website XSL Java extensions.
6845 This release includes important bug fixes and adds the following significant
6848 Automatic sorting of glossary entries
6850 The HTML and FO stylesheets now support automatic sorting of glossary
6851 entries. To enable glossary sorting, set the value of the glossary.sort
6852 parameter to 1 (by default, it’s value is 0). When you enable glossary
6853 sorting, glossentry elements within a glossary, glossdiv, or glosslist are
6854 sorted on the glossterm, using the current language setting. If you don’t
6855 enable glossary sorting, then the order of glossentry elements is left “as
6856 is” — that is, they are not sorted but are instead just displayed in
6859 WordML renamed to Roundtrip, OpenOffice support added
6861 Stylesheets for “roundtrip” conversion between documents in OpenOffice
6862 format (ODF) and DocBook XML have been added to the set of stylesheets that
6863 formerly had the collective title WordML, and that set of stylesheets has
6864 been renamed to Roundtrip to better reflect the actual scope and purpose of
6867 So the DocBook XSL Stylesheets now support roundtrip conversion (with
6868 certain limitations) of WordML, OpenOffice, and Apple Pages documents to
6869 and from DocBook XML.
6871 Including QandASet questions in TOCs
6873 The HTML stylesheet now provides support for including QandASet questions
6874 in the document TOC. To enable display of questions in the document TOC,
6875 set the value of the qanda.in.toc to 1 (by default, it’s 0). When you
6876 enable qanda.in.toc, then the generated table of contents for a document
6877 will include qandaset titles, qandadiv titles, and question elements. The
6878 default value of zero excludes them from the TOC.
6882 The qanda.in.toc parameter does not affect any tables of contents that may
6883 be generated within a qandaset or qandadiv (only in the document TOC).
6885 Language identifier in man-page filenames and pathnames
6887 Added new parameter man.output.lang.in.name.enabled, which controls whether
6888 a language identifier is included in man-page filenames and pathnames. It
6891 If the value of man.output.lang.in.name.enabled is non-zero, man-page files
6892 are output with a language identifier included in their filenames or
6893 pathnames as follows:
6895 □ if man.output.subdirs.enabled is non-zero, each file is output to,
6896 e.g., a /$lang/man8/foo.8 pathname
6898 □ if man.output.subdirs.enabled is zero, each file is output with a
6899 foo.$lang.8 filename
6901 index.page.number.properties property set
6903 For FO output, use the index.page.number.properties to control formatting
6904 of page numbers in index output — to (for example) to display page numbers
6905 in index output in a different color (to indicate that they are links).
6907 Crop marks in output from Antenna House XSL Formatter
6909 Support has been added for generating crop marks in print/PDF output
6910 generated using Antenna House XSL Formatter
6912 More string-substitution hooks in manpages output
6914 The man.string.subst.map.local.pre and man.string.subst.map.local.post
6915 parameters have been added to enable easier control over custom string
6918 Moved verbatim properties to attribute-set
6920 The hardcoded properties used in verbatim elements (literallayout,
6921 programlisting, screen) were moved to the verbatim.properties attribute-set
6922 so they can be more easily customized.
6924 enhanced simple.xlink template
6926 Now the simple.xlink template in inline.xsl works with cross reference
6927 elements xref and link as well. Also, more elements call simple.xlink,
6928 which enables DB5 xlink functionality.
6930 DocBook 5 compatibility
6932 Stylesheets now consistently support DocBook 5 attributes (such as xml:id).
6933 Also, DocBook 5 info elements are now checked along with other *info
6934 elements, and the use of name() function was replaced by local-name() so it
6935 also matches on DocBook 5 elements. These changes enable reusing the
6936 stylesheets with DocBook 5 documents with minimal fixup.
6938 HTML class attributes now handled in class.attribute mode
6940 The HTML class attributes were formerly hardcoded to the element name. Now
6941 the class attribute is generated by applying templates in class.attribute
6942 mode so class attribute names can be customized. The default is still the
6945 arabic-indic numbering enabled in autolabels
6947 Numbering of chapter, sections, and pages can now use arabic-indic
6948 numbering when number format is set to 'arabicindic' or to ١.
6950 The following is a detailed list of changes (not including bug fixes) that have
6951 been made since the 1.71.1 release.
6955 The following changes have been made to the common code since the 1.71.1
6958 • Add support for arabicindic numbering to autolabel.format template.
6960 • Finish support for @xml:id everywhere @id is used.
6962 • replace name() with local-name() in most cases.
6964 • Add support for info.
6966 • Add utility template tabstyle to return the tabstyle from
6971 The following changes have been made to the fo code since the 1.71.1 release.
6973 • Add support for sorting glossary entries
6975 • Add table.row.properties template to customize table rows.
6977 • Moved all properties to attribute-sets so can be customized more easily.
6979 • Add index.page.number.properties attribute-set to format page numbers.
6981 • xref now supports xlink:href, using simple.xlink template.
6983 • Rewrote simple.xlink, and call it with all charseq templates.
6985 • Add simple.xlink processing to term and member elements.
6987 • Add support for crop marks in Antenna House.
6991 The following changes have been made to the html code since the 1.71.1 release.
6993 • Add support for sorting glossary entries
6995 • Add support for qanda.in.toc to add qandaentry questions to document TOC.
6997 • add simple.xlink support to variablelist term and simplelist member.
6999 • *.propagates.style now handled in class.attribute mode.
7001 • add class parameter to class.attribute mode to set default class.
7003 • Convert all class attributes to use the class.attribute mode
7004 so class names can be customized more easily.
7006 • Add class.attribute mode to generate class attributes.
7008 • Added simple.xlink to most remaining inlines.
7009 Changed class attributes to applying class.attributes mode.
7011 • Changed xref template to use simple.xlink tempalte.
7013 • Improve generate.html.title to work with link targets too.
7015 • Improved simple.xlink to support link and xref.
7017 • Use new link.title.attribute now.
7019 • Rewrote simple.xlink to handle linkend also.
7020 Better computation of title attribute on link too.
7022 • Handle Xalan quirk as special case.
7024 • Add support for info.
7026 • Fixed imagemaps so they work properly going from calspair coords
7027 to HTML area coords.
7031 The following changes have been made to the manpages code since the 1.71.1
7034 • Added doc for man.output.lang.in.name.enabled parameter. This
7035 checkin completes support for writing file/pathnames for man-pages
7036 with $lang include in the names. Closes #1585967. knightly
7037 accolades to Daniel Leidert for providing the feature request.
7039 • Added new param man.output.lang.in.name.enabled, which
7040 controls whether $LANG value is included in manpages
7041 filenames and pathnames. It works like this:
7043 If the value of man.output.lang.in.name.enabled is non-zero,
7044 man-page files are output with the $lang value included in
7045 their filenames or pathnames as follows;
7047 - if man.output.subdirs.enabled is non-zero, each file is
7048 output to, e.g., a /$lang/man8/foo.8 pathname
7050 - if man.output.subdirs.enabled is zero, each file is output
7051 with a foo.$lang.8 filename
7053 • Use "\e" instead of "\\" for backslash output, because the
7054 groff docs say that's the correct thing to do; also because
7055 testing (thanks, Paul Dubois) shows that "\\" doesn't always
7056 work as expected; for example, "\\" within a table seems to
7059 • Added the man.string.subst.map.local.pre and
7060 man.string.subst.map.local.post parameters. Those parameters
7061 enable local additions and changes to string-substitution mappings
7062 without the need to change the value of man.string.subst.map
7063 parameter (which is for standard system mappings). Closes
7064 #1456738. Thanks to Sam Steingold for constructing a true
7065 stylesheet torture test (the clisp docs) that exposed the need for
7068 • Added the Markup element to the list of elements that get output
7069 in bold. Thanks to Eric S. Raymond.
7071 • Replaced all dots in roff requests with U+2302 ("house"
7072 character), and added escaping in output for all instances of dot
7073 that are not in roff requests. This fixes the problem case where a
7074 string beginning with a dot (for example, the string ".bashrc")
7075 might occur at the beginning of a line in output, in which case
7076 would mistakenly get interpreted as a roff request. Thanks to Eric
7077 S. Raymond for pushing to fix this.
7079 • Made change to ensure that list content nested in
7080 itemizedlist and orderedlist instances is properly indented. This
7081 is a switch from using .TP to format those lists to using .RS/.RE
7082 to format them instead (because .TP does not allow nesting). Closes bug #
7084 Thanks to Daniel Leidert.
7088 The following changes have been made to the params code since the 1.71.1
7091 • Added doc for man.output.lang.in.name.enabled parameter. This
7092 checkin completes support for writing file/pathnames for man-pages
7093 with $lang include in the names. Closes #1585967. knightly
7094 accolades to Daniel Leidert for providing the feature request.
7096 • Added new param man.output.lang.in.name.enabled, which
7097 controls whether $LANG value is included in manpages
7098 filenames and pathnames. It works like this:
7100 If the value of man.output.lang.in.name.enabled is non-zero,
7101 man-page files are output with the $lang value included in
7102 their filenames or pathnames as follows;
7104 - if man.output.subdirs.enabled is non-zero, each file is
7105 output to, e.g., a /$lang/man8/foo.8 pathname
7107 - if man.output.subdirs.enabled is zero, each file is output
7108 with a foo.$lang.8 filename
7110 • Added the man.string.subst.map.local.pre and
7111 man.string.subst.map.local.post parameters. Those parameters
7112 enable local additions and changes to string-substitution mappings
7113 without the need to change the value of man.string.subst.map
7114 parameter (which is for standard system mappings). Closes
7115 #1456738. Thanks to Sam Steingold for constructing a true
7116 stylesheet torture test (the clisp docs) that exposed the need for
7119 • Add index.page.number.properties by default.
7121 • Added index.page.number.properties
7122 to allow customizations of page numbers in indexes.
7124 • Move show-destination="replace" property from template to attribute-set
7125 so it can be customized.
7127 • Add support for sorting glossary entries
7129 • Add option to include qanda in tables of contents.
7131 • Moved all properties to attribute-sets so can be customized more easily.
7135 The following changes have been made to the template code since the 1.71.1
7138 • Added workaround for Xalan bug: use for-each and copy instead of copy-of (#
7143 The following changes have been made to the roundtrip code since the 1.71.1
7146 • rename to roundtrip, add OpenOffice support
7150 This is a minor update to the 1.71.0 release. Along with a number of bug fixes,
7151 it includes two feature changes:
7153 • Added support for profiling based on xml:lang and status attributes.
7155 • Added initial support in manpages output for footnote, annotation, and alt
7156 instances. Basically, they all now get handled the same way ulink instances
7157 are. They are treated as a class as "note sources": A numbered marker is
7158 generated at the place in the main text flow where they occur, then their
7159 contents are displayed in an endnotes section at the end of the man page.
7163 The following changes have been made to the common code since the 1.71.1
7166 • For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
7168 • Add support for Xalan generating a root xml:base like saxon.
7172 The following changes have been made to the fo code since the 1.71.1 release.
7174 • For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
7176 • Add support for Xalan to add root node xml:base for db5 docs.
7178 • Added support for profiling based on xml:lang and status attributes.
7182 The following changes have been made to the html code since the 1.71.1 release.
7184 • For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
7186 • Add support for Xalan to add root node xml:base for db5 docs.
7188 • Added support for profiling based on xml:lang and status attributes.
7190 • Made changes in namespace declarations to prevent xmllint's
7191 canonicalizer from treating them as relative namespace URIs.
7193 - Changed xmlns:k="java:com.isogen.saxoni18n.Saxoni18nService"
7194 to xmlns:k="http://www.isogen.com/functions/
7195 com.isogen.saxoni18n.Saxoni18nService";
7196 Saxon accepts either form
7197 (see http://www.saxonica.com/documentation/extensibility/
7199 to Saxon, "the part of the URI before the final '/' is immaterial".
7201 - Changed, e.g. xmlns:xverb="com.nwalsh.xalan.Verbatim" to
7202 xmlns:xverb="xalan://com.nwalsh.xalan.Verbatim"; Xalan accepts
7204 (see http://xml.apache.org/xalan-j/extensions.html#
7205 java-namespace-declare);
7206 just as Saxon does, it will "simply use the string to the
7207 right of the rightmost forward slash as the Java class name".
7209 - Changed xmlns:xalanredirect="org.apache.xalan.xslt.extensions.Redirect"
7210 to xmlns:redirect="http://xml.apache.org/xalan/redirect", and
7211 adjusted associated code to make the current Xalan redirect spec.
7212 (see http://xml.apache.org/xalan-j/apidocs/org/apache/xalan/lib/
7215 • Added the html.append and chunk.append parameters. By default, the
7216 value of both is empty; but the internal DocBook XSL stylesheets
7217 build sets their value to "<xsl:text>
</xsl:text>", in order
7218 to ensure that all files in the docbook-xsl-doc package end in a
7219 newline character. (Because diff and some other tools may emit
7220 error messages and/or not behave as expected when processing
7221 files that are not newline-terminated.)
7225 The following changes have been made to the highlighting code since the 1.71.1
7228 • Added license information
7232 The following changes have been made to the manpages code since the 1.71.1
7235 • Added initial support in manpages output for footnote, annotation,
7236 and alt instances. Basically, they all now get handled the same
7237 way ulink instances are. They are treated as a class as "note
7238 sources": A numbered marker is generated at the place in the main
7239 text flow where they occur, then their contents are displayed in
7240 an endnotes section at the end of the man page (currently titled
7241 REFERENCES, for English output, but will be changed to NOTES).
7243 This support is not yet complete. It works for most "normal"
7244 cases, but probably mishandles a good number of cases. More
7245 testing will be needed to expose the problems. It may well also
7246 introduce some bugs and regressions in other areas, including
7247 basic paragraph handling, handling of "mixed block" content,
7248 handling of other indented content, and handling of authorblurb
7249 and personblurb in the AUTHORS section.
7253 The following changes have been made to the params code since the 1.71.1
7256 • Added support for profiling based on xml:lang and status attributes.
7258 • Added the html.append and chunk.append parameters. By default, the
7259 value of both is empty; but the internal DocBook XSL stylesheets
7260 build sets their value to "<xsl:text>
</xsl:text>", in order
7261 to ensure that all files in the docbook-xsl-doc package end in a
7262 newline character. (Because diff and some other tools may emit
7263 error messages and/or not behave as expected when processing
7264 files that are not newline-terminated.)
7268 The following changes have been made to the profiling code since the 1.71.1
7271 • Added support for profiling based on xml:lang and status attributes.
7275 This is mainly a bug fix release, but it also includes two significant feature
7278 Highlighting support added
7280 The stylesheets now include support for source-code highlighting in output
7281 of programlisting instances (controlled through the highlight.source
7282 parameter). The Java-based implementation requires Saxon and makes use of
7283 Michal Molhanec’s XSLTHL. More details are available at Jirka Kosek’s
7286 http://xmlguru.cz/2006/07/docbook-syntax-highlighting
7288 The support is currently limited to highlighting of XML, Java, PHP, Delphi,
7289 Modula-2 sources, and INI files.
7291 Changes to autoindexing
7293 The templates that handle alternative indexing methods were reworked to
7294 avoid errors produced by certain processors not being able to tolerate the
7295 presence of unused functions. With this release, none of the code for the
7296 'kimber' or 'kosek' methods is included in the default stylesheets. In
7297 order to use one of those methods, your customization layer must import one
7298 of the optional stylesheet modules:
7300 □ html/autoidx-kosek.xsl
7301 □ html/autoidx-kimber.xsl
7302 □ fo/autoidx-kosek.xsl
7303 □ fo/autoidx-kimber.xsl
7305 See the index.method parameter reference page for more information.
7307 Two other changes to note:
7309 □ The default indexing method now can handle accented characters in
7310 latin-based alphabets, not just English. This means accented latin
7311 letters will group and sort with their unaccented counterpart.
7312 □ The default value for the index.method parameter was changed from
7313 'english' to 'basic' because now the default method can handle
7314 latin-based alphabets, not just English.
7316 The following is a list of changes that have been made since the 1.70.1
7321 The following changes have been made to the common code since the 1.70.1
7324 • Added reference.autolabel parameter for controlling labels on
7327 • Support rows that are *completely* overlapped by the preceding row
7329 • New modules for supporting indexing extensions.
7331 • Support startinglinenumber on orderedlist
7335 The following changes have been made to the extensions code since the 1.70.1
7338 • Completely reworked extensions build system; now uses NetBeans and ant
7342 The following changes have been made to the fo code since the 1.70.1 release.
7344 • xsl:sort lang attribute now uses two-char substring of lang attribute.
7346 • Support titlecase "Java", "Perl", and "IDL" as values for the
7347 language attribute on classsynopsis, etc. (instead of just
7348 lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
7349 (instead of just "cpp").
7351 Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
7352 to "Brian A. Vanderburg II".
7354 • Added support for the reference.autolabel param in (X)HTML and FO
7357 • Support rows that are *completely* overlapped by the preceding row
7359 • Rearranged templates for the 3 indexing methods
7360 and changed method named 'english' to 'basic'.
7362 • New modules for supporting indexing extensions.
7364 • Turn off blank-body for fop1.extensions too since fop 0.92
7365 does not support it either.
7367 • Add Xalan variant to test for exslt:node-set function.
7368 Xalan can use function named node-set(), but doesn't
7369 recognize it using function-available().
7371 • Added support to FO stylesheets for handling instances of Org
7372 where it occurs outside of *info content. In HTML stylesheets,
7373 moved handling of Org out of info.xsl and into inline.xsl. In both
7374 FO and HTML stylesheets, added support for correctly processing
7375 Affiliation and Jobtitle.
7377 • Don't output punctuation between Refname and Refpurpose if
7378 Refpurpose is empty. Also corrected handling of Refsect2/title
7379 instances, and removed some debugging stuff that was generated in
7380 manpages output to mark the ends of sections.
7382 • Added new email.delimiters.enabled param. If non-zero (the
7383 default), delimiters are generated around e-mail addresses (output
7384 of the email element). If zero, the delimiters are suppressed.
7386 • Initial support of syntax highlighting of programlistings.
7388 • Chapter after preface should restart numbering of pages.
7392 The following changes have been made to the html code since the 1.70.1 release.
7394 • xsl:sort lang attribute now uses two-char substring of lang attribute.
7396 • Support titlecase "Java", "Perl", and "IDL" as values for the
7397 language attribute on classsynopsis, etc. (instead of just
7398 lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
7399 (instead of just "cpp").
7401 Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
7402 to "Brian A. Vanderburg II".
7404 • Added support for the reference.autolabel param in (X)HTML and FO
7407 • Support rows that are *completely* overlapped by the preceding row
7409 • Rearranged templates for the 3 indexing methods
7410 and changed method named 'english' to 'basic'.
7412 • New modules for supporting indexing extensions.
7414 • Added several new HTML parameters for controlling appearance of
7415 content on HTML title pages:
7417 contrib.inline.enabled:
7418 If non-zero (the default), output of the contrib element is
7419 displayed as inline content rather than as block content.
7421 othercredit.like.author.enabled:
7422 If non-zero, output of the othercredit element on titlepages is
7423 displayed in the same style as author and editor output. If zero
7424 (the default), othercredit output is displayed using a style
7425 different than that of author and editor.
7427 blurb.on.titlepage.enabled:
7428 If non-zero, output from authorblurb and personblurb elements is
7429 displayed on title pages. If zero (the default), output from
7430 those elements is suppressed on title pages (unless you are
7431 using a titlepage customization that causes them to be included).
7434 If non-zero (the default), a localized Edited by heading is
7435 displayed above editor names in output of the editor element.
7437 • Add Xalan variant to test for exslt:node-set function.
7438 Xalan can use function named node-set(), but doesn't
7439 recognize it using function-available().
7441 • Added support to FO stylesheets for handling instances of Org
7442 where it occurs outside of *info content. In HTML stylesheets,
7443 moved handling of Org out of info.xsl and into inline.xsl. In both
7444 FO and HTML stylesheets, added support for correctly processing
7445 Affiliation and Jobtitle.
7447 • Don't output punctuation between Refname and Refpurpose if
7448 Refpurpose is empty. Also corrected handling of Refsect2/title
7449 instances, and removed some debugging stuff that was generated in
7450 manpages output to mark the ends of sections.
7452 • Added new email.delimiters.enabled param. If non-zero (the
7453 default), delimiters are generated around e-mail addresses (output
7454 of the email element). If zero, the delimiters are suppressed.
7456 • Added qanda.nested.in.toc param. Default value is zero. If
7457 non-zero, instances of "nested" Qandaentry (ones that are children
7458 of Answer elements) are displayed in the TOC. Closes patch 1509018
7459 (from Daniel Leidert). Currently on affects HTML output (no patch
7460 for FO output provided).
7462 • Improved handling of relative locations generated files
7464 • Initial support of syntax highlighting of programlistings.
7470 • Support $keep.relative.image.uris also when chunking
7474 The following changes have been made to the highlighting code since the 1.70.1
7477 • Initial support of syntax highlighting of programlistings.
7481 The following changes have been made to the manpages code since the 1.70.1
7484 • Suppress footnote markers and output warning that footnotes are
7487 • Handle instances of address/otheraddr/ulink in author et al in the
7488 same way as email instances; that is, display them on the same
7489 linke as the author, editor, etc., name.
7491 • Don't number or link-list any Ulink instance whose string value is
7492 identical to the value of its url attribute. Just display it inline.
7494 • Don't output punctuation between Refname and Refpurpose if
7495 Refpurpose is empty. Also corrected handling of Refsect2/title
7496 instances, and removed some debugging stuff that was generated in
7497 manpages output to mark the ends of sections.
7499 • Added new email.delimiters.enabled param. If non-zero (the
7500 default), delimiters are generated around e-mail addresses (output
7501 of the email element). If zero, the delimiters are suppressed.
7503 • In manpages output, if the last/nearest *info element for
7504 particular Refentry has multiple Copyright and/or Legalnotice
7505 children, process them all (not just the first ones). Closes bug
7506 1524576. Thanks to Sam Steingold for the report and to Daniel
7507 Leidert for providing a patch.
7511 The following changes have been made to the params code since the 1.70.1
7514 • Added reference.autolabel parameter for controlling labels on
7517 • Added namespace declarations to document elements for all param files.
7519 • Updated index.method doc to describe revised setup for importing index
7522 • Added several new HTML parameters for controlling appearance of
7523 content on HTML title pages:
7525 contrib.inline.enabled:
7526 If non-zero (the default), output of the contrib element is
7527 displayed as inline content rather than as block content.
7529 othercredit.like.author.enabled:
7530 If non-zero, output of the othercredit element on titlepages is
7531 displayed in the same style as author and editor output. If zero
7532 (the default), othercredit output is displayed using a style
7533 different than that of author and editor.
7535 blurb.on.titlepage.enabled:
7536 If non-zero, output from authorblurb and personblurb elements is
7537 displayed on title pages. If zero (the default), output from
7538 those elements is suppressed on title pages (unless you are
7539 using a titlepage customization that causes them to be included).
7542 If non-zero (the default), a localized Edited by heading is
7543 displayed above editor names in output of the editor element.
7545 • Added new email.delimiters.enabled param. If non-zero (the
7546 default), delimiters are generated around e-mail addresses (output
7547 of the email element). If zero, the delimiters are suppressed.
7549 • Added qanda.nested.in.toc param. Default value is zero. If
7550 non-zero, instances of "nested" Qandaentry (ones that are children
7551 of Answer elements) are displayed in the TOC. Closes patch 1509018
7552 (from Daniel Leidert). Currently on affects HTML output (no patch
7553 for FO output provided).
7555 • Initial support of syntax highlighting of programlistings.
7559 The following changes have been made to the tools code since the 1.70.1
7562 • Racheted down font sizes of headings in example makefile FO output.
7564 • Added param and attribute set to example makefile, for getting
7565 wrapping in verbatims in FO output.
7567 • Renamed Makefile.paramDoc to Makefile.docParam.
7569 • Added Makefile.paramDoc file, for creating versions of param.xsl
7570 files with doc embedded.
7572 • Added variable to example makefile for controlling whether HTML or
7577 This is a stable release of the 1.70 stylesheets. It includes only a few small
7578 changes from 1.70.0.
7580 The following is a list of changes that have been made since the 1.70.0
7585 The following changes have been made to the fo code since the 1.70.0 release.
7587 • Added three new attribute sets (revhistory.title.properties,
7588 revhistory.table.properties and revhistory.table.cell.properties) for
7589 controlling appearance of revhistory in FO output.
7591 Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/
7592 titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params
7593 /revhistory.table.properties.xml,1.1; params/
7594 revhistory.title.properties.xml,1.1 - Jirka Kosek
7596 • Support DBv5 revisions with full author name (not only authorinitials)
7598 Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek
7602 The following changes have been made to the html code since the 1.70.0 release.
7604 • Support DBv5 revisions with full author name (not only authorinitials)
7606 Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek
7610 The following changes have been made to the htmlhelp code since the 1.70.0
7613 • htmlhelp.generate.index is now param, not variable. This means that you can
7614 override its setting from outside. This is useful when you generate
7615 indexterms on the fly (see http://www.xml.com/pub/a/2004/07/14/dbndx.html?
7618 Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek
7620 • Support chunk.tocs.and.lots in HTML Help
7622 Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek
7626 The following changes have been made to the params code since the 1.70.0
7629 • Added three new attribute sets (revhistory.title.properties,
7630 revhistory.table.properties and revhistory.table.cell.properties) for
7631 controlling appearance of revhistory in FO output.
7633 Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/
7634 titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params
7635 /revhistory.table.properties.xml,1.1; params/
7636 revhistory.title.properties.xml,1.1 - Jirka Kosek
7640 As with all DocBook Project dot-zero releases, this is an experimental release.
7641 It will be followed shortly by a stable release.
7643 This release adds a number of new features, including:
7645 • support for selecting alternative index-collation methods (in particular,
7646 support for using a collation library developed by Eliot Kimber)
7648 • improved handling of DocBook 5 document instances (through a
7649 namespace-stripping mechanism)
7651 • full support for CALS and HTML tables in manpages output
7653 • a mechanism for preserving relative URIs in documents that make use of
7656 • support for the "new" .90 version of FOP
7658 • enhanced capabilities for controlling formatting of lists in HTML and FO
7661 • autogeneration of AUTHOR and COPYRIGHT sections in manpages output
7663 • support for generating crop marks in FO/PDF output
7665 • support for qandaset as a root element in FO output
7667 • support for floatstyle and orient on all table types
7669 • support for floatstyle in figure, and example
7671 • pgwide.properties attribute-set supports extending figure, example and
7672 table into the left indent area instead of spanning multiple columns.
7674 The following is a detailed list of enhancements and API changes that have been
7675 made since the 1.69.1 release.
7679 The following changes have been made to the common code since the 1.69.1
7682 • Add the xsl:key for the kimber indexing method.
7684 Modified: common/autoidx-ng.xsl,1.2 - Robert Stayton
7686 • Add support for qandaset.
7688 Modified: common/labels.xsl,1.37; common/subtitles.xsl,1.7; common/
7689 titles.xsl,1.35 - Robert Stayton
7691 • Support dbhtml/dbfo start PI for orderedlist numbering in both HTML and FO
7693 Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman Walsh
7697 Modified: common/stripns.xsl,1.12 - Robert Stayton
7699 • Changed content model of text element to ANY rather than #PCDATA because
7700 they could contain markup.
7702 Modified: common/targetdatabase.dtd,1.7 - Robert Stayton
7704 • Added refentry.meta.get.quietly param.
7706 If zero (the default), notes and warnings about "missing" markup are
7707 generated during gathering of refentry metadata. If non-zero, the metadata
7708 is gathered "quietly" -- that is, the notes and warnings are suppressed.
7710 NOTE: If you are processing a large amount of refentry content, you may be
7711 able to speed up processing significantly by setting a non-zero value for
7712 refentry.meta.get.quietly.
7714 Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/
7715 param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
7718 • After namespace stripping, the source document is the temporary tree
7719 created by the stripping process and it has the wrong base URI for relative
7720 references. Earlier versions of this code used to try to fix that by
7721 patching the elements with relative @fileref attributes. That was
7722 inadequate because it calculated an absolute base URI without considering
7723 that there might be xml:base attributes already in effect. It seems obvious
7724 now that the right thing to do is simply to put the xml:base on the root of
7725 the document. And that seems to work.
7727 Modified: common/stripns.xsl,1.7 - Norman Walsh
7729 • Added support for "software" and "sectdesc" class values on refmiscinfo;
7730 "software" is treated identically to "source", and "setdesc" is treated
7731 identically to "manual".
7733 Modified: common/refentry.xsl,1.10; params/
7734 man.th.extra2.max.length.xml,1.3; params/
7735 refentry.source.name.profile.xml,1.4 - Michael(tm) Smith
7737 • Added support for DocBook 5 namespace-stripping in manpages stylesheet.
7738 Closes request #1210692.
7740 Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm)
7743 • Added <xsl:template match="/"> to make stripns.xsl usable as a standalone
7744 stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that DocBook
7745 XSLT drivers that include this stylesheet all override the match="/"
7748 Modified: common/stripns.xsl,1.4 - Michael(tm) Smith
7750 • Number figures, examples, and tables from book if there is no prefix (i.e.
7751 if chapter.autolabel is set to 0). This avoids having the list of figures
7752 where the figures mysteriously restart their numeration periodically when
7753 chapter.autolabel is set to 0.
7755 Modified: common/labels.xsl,1.36 - David Cramer
7757 • Add task template in title.markup mode.
7759 Modified: common/titles.xsl,1.34 - Robert Stayton
7761 • Add children (with ids) of formal objects to target data.
7763 Modified: common/targets.xsl,1.10 - Robert Stayton
7765 • Added support for case when personname doesn't contain specific name markup
7766 (as allowed in DocBook 5.0)
7768 Modified: common/common.xsl,1.54 - Jirka Kosek
7772 The following changes have been made to the extensions code since the 1.69.1
7777 Modified: extensions/xalan27/.cvsignore,1.1; extensions/xalan27/
7778 build.xml,1.1; extensions/xalan27/nbproject/.cvsignore,1.1; extensions/
7779 xalan27/nbproject/build-impl.xml,1.1; extensions/xalan27/nbproject/
7780 genfiles.properties,1.1; extensions/xalan27/nbproject/
7781 project.properties,1.1; extensions/xalan27/nbproject/project.xml,1.1;
7782 extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1; extensions/xalan27/
7783 src/com/nwalsh/xalan/Callout.java,1.1; extensions/xalan27/src/com/nwalsh/
7784 xalan/FormatCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
7785 FormatDingbatCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
7786 FormatGraphicCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
7787 FormatTextCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
7788 FormatUnicodeCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
7789 Func.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
7790 ImageIntrinsics.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
7791 Params.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1;
7792 extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1; extensions/xalan27/
7793 src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman Walsh
7795 • Handle the case where the imageFn is actually a URI. This still needs work.
7797 Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4 -
7802 The following changes have been made to the fo code since the 1.69.1 release.
7804 • Adapted to the new indexing code. Now works just like a wrapper that calls
7805 kosek indexing method, originally implemented here.
7807 Modified: fo/autoidx-ng.xsl,1.5 - Jirka Kosek
7809 • Added parameters for header/footer table minimum height.
7811 Modified: fo/pagesetup.xsl,1.60; fo/param.ent,1.100; fo/param.xweb,1.113 -
7814 • Add the index.method parameter.
7816 Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert Stayton
7818 • Integrate support for three indexing methods: - the original English-only
7819 method. - Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's
7820 method using Saxon extensions. Use the 'index.method' parameter to select.
7822 Modified: fo/autoidx.xsl,1.38 - Robert Stayton
7824 • Add support for TOC for qandaset in fo output.
7826 Modified: fo/autotoc.xsl,1.30; fo/qandaset.xsl,1.20 - Robert Stayton
7828 • Added parameter ulink.hyphenate.chars. Added parameter insert.link
7831 Modified: fo/param.ent,1.98; fo/param.xweb,1.111 - Robert Stayton
7833 • Implemented feature request #942524 to add insert.link.page.number to allow
7834 link element cross references to have a page number.
7836 Modified: fo/xref.xsl,1.67 - Robert Stayton
7838 • Add support for ulink.hyphenate.chars so more characters can be break
7841 Modified: fo/xref.xsl,1.66 - Robert Stayton
7843 • Implemented patch #1075144 to make the url text in a ulink in FO output an
7844 active link as well.
7846 Modified: fo/xref.xsl,1.65 - Robert Stayton
7848 • table footnotes now have their own table.footnote.properties attribute set.
7850 Modified: fo/footnote.xsl,1.23 - Robert Stayton
7852 • Add qandaset to root.elements.
7854 Modified: fo/docbook.xsl,1.41 - Robert Stayton
7856 • Added mode="page.sequence" to make it easier to put content into a page
7857 sequence. First used for qandaset.
7859 Modified: fo/component.xsl,1.37 - Robert Stayton
7861 • Implemented feature request #1434408 to support formatting of biblioentry.
7863 Modified: fo/biblio.xsl,1.35 - Robert Stayton
7865 • Added biblioentry.properties.
7867 Modified: fo/param.ent,1.97; fo/param.xweb,1.110 - Robert Stayton
7869 • Support PTC/Arbortext bookmarks
7871 Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman Walsh
7873 • Added table.footnote.properties to permit table footnotes to format
7874 differently from regular footnotes.
7876 Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert Stayton
7878 • Refactored table templates to unify their processing and support all
7879 options in all types. Now table and informaltable, in both Cals and Html
7880 markup, use the same templates where possible, and all support pgwide,
7881 rotation, and floats. There is also a placeholder table.container template
7882 to support wrapping a table in a layout table, so the XEP table title
7883 "continued" extension can be more easily implemented.
7885 Modified: fo/formal.xsl,1.52; fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 -
7888 • Added new attribute set toc.line.properties for controlling appearance of
7891 Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95; fo/param.xweb,1.108 -
7894 • Added support for float to example and equation. Added support for pgwide
7895 to figure, example, and equation (the latter two via a dbfo pgwide="1"
7896 processing instruction).
7898 Modified: fo/formal.xsl,1.51 - Robert Stayton
7900 • Add pgwide.properties attribute-set.
7902 Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert Stayton
7904 • Added refclass.suppress param.
7906 If the value of refclass.suppress is non-zero, then display refclass
7907 contents is suppressed in output. Affects HTML and FO output only.
7909 Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html
7910 /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith
7912 • Improved support for task subelements
7914 Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - Jirka Kosek
7916 • Adjusted spacing around K&R-formatted Funcdef and Paramdef output such that
7917 it can more easily be discerned where one ends and the other begins. Closes
7920 Modified: fo/synop.xsl,1.18 - Michael(tm) Smith
7922 • Made handling of paramdef/parameter in FO output consistent with that in
7923 HTML and manpages output. Closes #1213259.
7925 Modified: fo/synop.xsl,1.17 - Michael(tm) Smith
7927 • Made handling of Refnamediv consistent with formatting in HTML and manpages
7928 output; specifically, changed so that Refname (comma-separated list of
7929 multiple instances found) is used (instead of Refentrytitle as previously),
7930 then em-dash, then the Refpurpose. Closes #1212562.
7932 Modified: fo/refentry.xsl,1.30 - Michael(tm) Smith
7934 • Added output of Releaseinfo to recto titlepage ("copyright" page) for Book
7935 in FO output. This makes it consistent with HTML output. Closes #1327034.
7936 Thanks to Paul DuBois for reporting.
7938 Modified: fo/titlepage.templates.xml,1.28 - Michael(tm) Smith
7940 • Added condition for setting block-progression-dimension.minimum on
7941 table-row, instead of height, when fop1.extensions is non-zero. For an
7942 explanation of the reason for the change, see: http://wiki.apache.org/
7943 xmlgraphics-fop/Troubleshooting/CommonLogMessages
7945 Modified: fo/pagesetup.xsl,1.59 - Michael(tm) Smith
7947 • Added new refclass.suppress param for suppressing display of Refclass in
7948 HTML and FO output. Did not add it to manpages because manpages stylesheet
7949 is currently just silently ignoring Refclass anyway. Closes request #
7950 1461065. Thanks to Davor Ocelic (docelic) for reporting.
7952 Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - Michael(tm) Smith
7954 • Add support for keep-together PI to informal objects.
7956 Modified: fo/formal.xsl,1.50 - Robert Stayton
7958 • Add support for fop1.extensions.
7960 Modified: fo/formal.xsl,1.49; fo/graphics.xsl,1.44; fo/table.xsl,1.47 -
7963 • Add support for fop1 bookmarks.
7965 Modified: fo/docbook.xsl,1.39 - Robert Stayton
7967 • Add fop1.extentions parameter to add support for fop development version.
7969 Modified: fo/param.ent,1.92; fo/param.xweb,1.105 - Robert Stayton
7971 • Start supporting fop development version, which will become fop version 1.
7973 Modified: fo/fop1.xsl,1.1 - Robert Stayton
7975 • Add template for task in mode="xref-to".
7977 Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert Stayton
7979 • table footnotes now also get footnote.properties attribute-set.
7981 Modified: fo/footnote.xsl,1.22 - Robert Stayton
7983 • Added index.separator named template to compute the separator punctuation
7986 Modified: fo/autoidx.xsl,1.36 - Robert Stayton
7988 • Added support for link, olink, and xref within OO Classsynopsis and
7989 children. (Because DocBook NG/5 allows it).
7991 Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith
7993 • Support date as an inline
7995 Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh
7997 • Added new parameter keep.relative.image.uris
7999 Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html
8000 /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh
8002 • Map Unicode space characters U+2000-U+200A to fo:leaders.
8004 Modified: fo/docbook.xsl,1.38; fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 -
8007 • Output a real em dash for em-dash dingbat (instead of two hypens).
8009 Modified: fo/fo.xsl,1.7 - Michael(tm) Smith
8011 • Support default label width parameters for itemized and ordered lists
8013 Modified: fo/lists.xsl,1.64; fo/param.ent,1.90; fo/param.xweb,1.103; params
8014 /itemizedlist.label.width.xml,1.1; params/orderedlist.label.width.xml,1.1 -
8017 • Generate localized title for Refsynopsisdiv if no appropriate Title
8018 descendant found in source. Closes #1212398. This change makes behavior for
8019 the Synopsis title consistent with the behavior of HTML and manpages
8022 Also, added xsl:use-attribute-sets="normal.para.spacing" to block generated
8023 for Cmdsynopsis output. Previously, that block had no spacing at all
8024 specified, which resulted it being crammed up to closely to the Synopsis
8027 Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm) Smith
8029 • Added parameters to support localization of index item punctuation.
8031 Modified: fo/autoidx.xsl,1.35 - Robert Stayton
8033 • Added index.number.separator, index.range.separator, and
8034 index.term.separator parameters to support localization of punctuation in
8037 Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert Stayton
8039 • Added "Cross References" section in HTML doc (for consistency with the FO
8040 doc). Also, moved the existing FO "Cross References" section to follow the
8043 Modified: fo/param.xweb,1.101; html/param.xweb,1.95 - Michael(tm) Smith
8045 • Added ID attribues to all Reference elements (e.g., id="tables" for the doc
8046 for section on Table params). So pages for all subsections of ref docs now
8047 have stable filenames instead of arbitrary generated filenames.
8049 Modified: fo/param.xweb,1.100; html/param.xweb,1.94 - Michael(tm) Smith
8051 • Added two new parameters for handling of multi-term varlistentry elements:
8053 variablelist.term.break.after: When the variablelist.term.break.after is
8054 non-zero, it will generate a line break after each term multi-term
8057 variablelist.term.separator: When a varlistentry contains multiple term
8058 elements, the string specified in the value of the
8059 variablelist.term.separator parameter is placed after each term except the
8060 last. The default is ", " (a comma followed by a space). To suppress
8061 rendering of the separator, set the value of variablelist.term.separator to
8062 the empty string ("").
8064 These parameters are primarily intended to be useful if you have multi-term
8065 varlistentries that have long terms.
8067 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
8068 long terms" doc that demonstrated the value of having these options.
8070 Also, added normalize-space() call to processing of each term.
8072 This change affects all output formats (HTML, PDF, manpages). The default
8073 behavior should pretty much remain the same as before, but it is possible
8074 (as always) that the change may introduce some new bugginess.
8076 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
8077 lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
8078 lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
8079 variablelist.term.break.after.xml,1.1; params/
8080 variablelist.term.separator.xml,1.1 - Michael(tm) Smith
8082 • Add sidebar titlepage placeholder attset for styles.
8084 Modified: fo/titlepage.xsl,1.37 - Robert Stayton
8086 • Add titlepage for sidebar.
8088 Modified: fo/titlepage.templates.xml,1.27 - Robert Stayton
8090 • Implemented RFE #1292615.
8092 Added bunch of new parameters (attribute sets) that affect list
8093 presentation: list.block.properties, itemizedlist.properties, orderedlist
8094 .properties, itemizedlist.label.properties and orderedlist.label
8095 .properties. Default behaviour of stylesheets has not been changed but
8096 further customizations will be much more easier.
8098 Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; params/
8099 itemizedlist.label.properties.xml,1.1; params/
8100 itemizedlist.properties.xml,1.1; params/list.block.properties.xml,1.1;
8101 params/orderedlist.label.properties.xml,1.1; params/
8102 orderedlist.properties.xml,1.1 - Jirka Kosek
8104 • Implemented RFE #1242092.
8106 You can enable crop marks in your document by setting crop.marks=1 and
8107 xep.extensions=1. Appearance of crop marks can be controlled by parameters
8108 crop.mark.bleed (6pt), crop.mark.offset (24pt) and crop.mark.width (0.5pt).
8110 Also there is new named template called user-xep-pis. You can overwrite it
8111 in order to produce some PIs that can control XEP as described in http://
8112 www.renderx.com/reference.html#Output_Formats
8114 Modified: fo/docbook.xsl,1.36; fo/param.ent,1.86; fo/param.xweb,1.97; fo/
8115 xep.xsl,1.23; params/crop.mark.bleed.xml,1.1; params/
8116 crop.mark.offset.xml,1.1; params/crop.mark.width.xml,1.1; params/
8117 crop.marks.xml,1.1 - Jirka Kosek
8121 The following changes have been made to the html code since the 1.69.1 release.
8123 • implemented index.method parameter and three methods.
8125 Modified: html/autoidx.xsl,1.28 - Robert Stayton
8127 • added index.method parameter to support 3 indexing methods.
8129 Modified: html/param.ent,1.94; html/param.xweb,1.103 - Robert Stayton
8131 • Implemented feature request #1072510 as a processing instruction to permit
8132 including external HTML content into HTML output.
8134 Modified: html/pi.xsl,1.9 - Robert Stayton
8136 • Added new parameter chunk.tocs.and.lots.has.title which controls presence
8137 of title in a separate chunk with ToC/LoT. Disabling title can be very
8138 useful if you are generating frameset output (well, yes those frames, but
8139 some customers really want them ;-).
8141 Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; html/
8142 param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
8145 • Support dbhtml/dbfo start PI for orderedlist numbering in both HTML and FO
8147 Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman Walsh
8149 • Allow ToC without title also for set and book.
8151 Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 - Jirka Kosek
8153 • Implemented floats uniformly for figure, example, equation and
8154 informalfigure, informalexample, and informalequation.
8156 Modified: html/formal.xsl,1.22 - Robert Stayton
8158 • Added the autotoc.label.in.hyperlink param.
8160 If the value of autotoc.label.in.hyperlink is non-zero, labels are included
8161 in hyperlinked titles in the TOC. If it is instead zero, labels are still
8162 displayed prior to the hyperlinked titles, but are not hyperlinked along
8165 Closes patch #1065868. Thanks to anatoly techtonik for the patch.
8167 Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; html/
8168 param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - Michael(tm)
8171 • Added two new params: html.head.legalnotice.link.types and html.head.
8172 legalnotice.link.multiple.
8174 If the value of the generate.legalnotice.link is non-zero, then the
8175 stylesheet generates (in the head section of the HTML source) either a
8176 single HTML link element or, if the value of the html.head.legalnotice.link
8177 .multiple is non-zero, one link element for each link type specified. Each
8178 link has the following attributes:
8180 - a rel attribute whose value is derived from the value of html.head.
8181 legalnotice.link.types
8183 - an href attribute whose value is set to the URL of the file containing
8186 - a title attribute whose value is set to the title of the corresponding
8187 legalnotice (or a title programatically determined by the stylesheet)
8191 <link rel="copyright" href="ln-id2524073.html" title="Legal Notice">
8193 Closes #1476450. Thanks to Sam Steingold.
8195 Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; html/
8196 param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; params/
8197 html.head.legalnotice.link.multiple.xml,1.1; params/
8198 html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith
8200 • Added refclass.suppress param.
8202 If the value of refclass.suppress is non-zero, then display refclass
8203 contents is suppressed in output. Affects HTML and FO output only.
8205 Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html
8206 /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith
8208 • Improved support for task subelements
8210 Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - Jirka Kosek
8212 • Added new refclass.suppress param for suppressing display of Refclass in
8213 HTML and FO output. Did not add it to manpages because manpages stylesheet
8214 is currently just silently ignoring Refclass anyway. Closes request #
8215 1461065. Thanks to Davor Ocelic (docelic) for reporting.
8217 Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - Michael(tm) Smith
8219 • Process alt text with normalize-space(). Replace tab indents with spaces.
8221 Modified: html/graphics.xsl,1.57 - Robert Stayton
8223 • Content of citation element is automatically linked to the bibliographic
8224 entry with the corresponding abbrev.
8226 Modified: html/biblio.xsl,1.26; html/inline.xsl,1.47; html/xref.xsl,1.58 -
8229 • Add template for task in mode="xref-to".
8231 Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert Stayton
8233 • Suppress ID warnings if the .warnings parameter is 0
8235 Modified: html/html.xsl,1.17 - Norman Walsh
8237 • Add support for floatstyle to figure.
8239 Modified: html/formal.xsl,1.21 - Robert Stayton
8241 • Handling of xref to area/areaset need support in extensions code also. I
8242 currently have no time to touch extensions code, so code is here to be
8243 enabled when extension is fixed also.
8245 Modified: html/xref.xsl,1.56 - Jirka Kosek
8247 • Added 3 parameters for overriding gentext for index punctuation.
8249 Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert Stayton
8251 • Added parameters to support localization of index item punctuation. Added
8252 index.separator named template to compute the separator punctuation based
8255 Modified: html/autoidx.xsl,1.27 - Robert Stayton
8257 • Added a <div class="{$class}-contents"> wrapper around output of contents
8258 of all formal objects. Also, added an optional <br class="{class}-break"/>
8259 linebreak after all formal objects.
8261 WARNING: Because this change places an additional DIV between the DIV
8262 wrapper for the equation and the equation contents, it may break some
8263 existing CSS stylesheets that have been created with the assumption that
8264 there would never be an intervening DIV there.
8266 The following is an example of what Equation output looks like as a result
8267 of the changes described above.
8269 <div class="equation"> <a name="three" id="three"></a>
8271 <p class="title"><b>(1.3)</b></p>
8273 <div class="equation-contents"> <span class="mathphrase">1+1=3</span> </
8274 div> </div><br class="equation-break">
8276 Rationale: These changes allow CSS control of the placement of the
8277 formal-object title relative to the formal-object contents. For example,
8278 using the CSS "float" property enables the title and contents to be
8279 rendered on the same line. Example stylesheet:
8281 .equation { margin-top: 20px; margin-bottom: 20px; } .equation-contents {
8284 .equation .title { margin-top: 0; float: right; margin-right: 200px; }
8286 .equation .title b { font-weight: normal; }
8288 .equation-break { clear: both; }
8290 Note that the purpose of the ".equation-break" class is to provide a way to
8291 clear off the floats.
8293 If you want to instead have the equation title rendered to the left of the
8294 equation contents, you can do something like this:
8296 .equation { margin-top: 20px; width: 300px; margin-bottom: 20px; }
8297 .equation-contents { float: right; }
8299 .equation .title { margin-top: 0; float: left; margin-right: 200px; }
8301 .equation .title b { font-weight: normal; }
8303 .equation-break { clear: both; }
8305 Modified: html/formal.xsl,1.20 - Michael(tm) Smith
8307 • Added a chunker.output.quiet top-level parameter so that the chunker can be
8308 made quiet by default
8310 Modified: html/chunker.xsl,1.26 - Norman Walsh
8312 • Added support for link, olink, and xref within OO Classsynopsis and
8313 children. (Because DocBook NG/5 allows it).
8315 Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith
8317 • New parameter: id.warnings. If non-zero, warnings are generated for titled
8318 objects that don't have titles. True by default; I wonder if this will be
8321 Modified: html/biblio.xsl,1.25; html/component.xsl,1.27; html/
8322 division.xsl,1.11; html/formal.xsl,1.19; html/glossary.xsl,1.20; html/
8323 html.xsl,1.13; html/index.xsl,1.16; html/param.ent,1.88; html/
8324 param.xweb,1.97; html/refentry.xsl,1.22; html/sections.xsl,1.30; params/
8325 id.warnings.xml,1.1 - Norman Walsh
8327 • If the keep.relative.image.uris parameter is true, don't use the absolute
8328 URI (as calculated from xml:base) in the img src attribute, us the value
8329 the author specified. Note that we still have to calculate the absolute
8330 filename for use in the image intrinsics extension.
8332 Modified: html/graphics.xsl,1.56 - Norman Walsh
8334 • Support date as an inline
8336 Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh
8338 • Added new parameter keep.relative.image.uris
8340 Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html
8341 /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh
8343 • Added two new parameters for handling of multi-term varlistentry elements:
8345 variablelist.term.break.after: When the variablelist.term.break.after is
8346 non-zero, it will generate a line break after each term multi-term
8349 variablelist.term.separator: When a varlistentry contains multiple term
8350 elements, the string specified in the value of the
8351 variablelist.term.separator parameter is placed after each term except the
8352 last. The default is ", " (a comma followed by a space). To suppress
8353 rendering of the separator, set the value of variablelist.term.separator to
8354 the empty string ("").
8356 These parameters are primarily intended to be useful if you have multi-term
8357 varlistentries that have long terms.
8359 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
8360 long terms" doc that demonstrated the value of having these options.
8362 Also, added normalize-space() call to processing of each term.
8364 This change affects all output formats (HTML, PDF, manpages). The default
8365 behavior should pretty much remain the same as before, but it is possible
8366 (as always) that the change may introduce some new bugginess.
8368 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
8369 lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
8370 lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
8371 variablelist.term.break.after.xml,1.1; params/
8372 variablelist.term.separator.xml,1.1 - Michael(tm) Smith
8374 • Added "wrapper-name" param to inline.charseq named template, enabling it to
8375 output inlines other than just "span". Acronym and Abbrev templates now use
8376 inline.charseq to output HTML "acronym" and "abbr" elements (instead of
8377 "span"). Closes #1305468. Thanks to Sam Steingold for suggesting the
8380 Modified: html/inline.xsl,1.45 - Michael(tm) Smith
8384 The following changes have been made to the manpages code since the 1.69.1
8387 • Added the following params:
8389 - man.indent.width (string-valued) - man.indent.refsect (boolean) -
8390 man.indent.blurbs (boolean) - man.indent.lists (boolean) -
8391 man.indent.verbatims (boolean)
8393 Note that in earlier snapshots, man.indent.width was named
8394 man.indentation.default.value and the boolean params had names like
8395 man.indentation.*.adjust. Also the man.indent.blurbs param was called
8396 man.indentation.authors.adjust (or something).
8398 The behavior now is: If the value of a particular man.indent.* boolean
8399 param is non-zero, the corresponding contents (refsect*, list items,
8400 authorblurb/personblurb, vervatims) are displayed with a left margin
8401 indented by a width equal to the value of man.indent.width.
8403 Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74;
8404 manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
8405 manpages/param.ent,1.22; manpages/param.xweb,1.24; manpages/
8406 refentry.xsl,1.14; params/man.indent.lists.xml,1.1; params/
8407 man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; params/
8408 man.indent.width.xml,1.1 - Michael(tm) Smith
8410 • Added man.table.footnotes.divider param.
8412 In each table that contains footenotes, the string specified by the man.
8413 table.footnotes.divider parameter is output before the list of footnotes
8416 Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; manpages/
8417 param.ent,1.21; manpages/param.xweb,1.23; params/
8418 man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith
8420 • Added the man.output.in.separate.dir, man.output.base.dir, and
8421 man.output.subdirs.enabled parameters.
8423 The man.output.base.dir parameter specifies the base directory into which
8424 man-page files are output. The man.output.subdirs.enabled parameter
8425 controls whether the files are output in subdirectories within the base
8428 The values of the man.output.base.dir and man.output.subdirs.enabled
8429 parameters are used only if the value of man.output.in.separate.dir
8430 parameter is non-zero. If the value of man.output.in.separate.dir is zero,
8431 man-page files are not output in a separate directory.
8433 Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; manpages/
8434 param.xweb,1.22; params/man.output.base.dir.xml,1.1; params/
8435 man.output.in.separate.dir.xml,1.1; params/
8436 man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith
8438 • Added man.font.table.headings and man.font.table.title params, for
8439 controlling font in table headings and titles.
8441 Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; manpages/
8442 param.xweb,1.21; params/man.font.table.headings.xml,1.1; params/
8443 man.font.table.title.xml,1.1 - Michael(tm) Smith
8445 • Added man.font.funcsynopsisinfo and man.font.funcprototype params, for
8446 specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and
8447 funcprototype output.
8449 Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; manpages/
8450 param.ent,1.18; manpages/param.xweb,1.20; manpages/synop.xsl,1.29; manpages
8451 /table.xsl,1.21; params/man.font.funcprototype.xml,1.1; params/
8452 man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith
8454 • Added man.segtitle.suppress param.
8456 If the value of man.segtitle.suppress is non-zero, then display of segtitle
8457 contents is suppressed in output.
8459 Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; manpages/
8460 param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - Michael(tm) Smith
8462 • Added man.output.manifest.enabled and man.output.manifest.filename params.
8464 If man.output.manifest.enabled is non-zero, a list of filenames for man
8465 pages generated by the stylesheet transformation is written to the file
8466 named by man.output.manifest.filename
8468 Modified: manpages/docbook.xsl,1.67; manpages/other.xsl,1.19; manpages/
8469 param.ent,1.16; manpages/param.xweb,1.18; params/
8470 man.output.manifest.enabled.xml,1.1; params/
8471 man.output.manifest.filename.xml,1.1; tools/make/Makefile.DocBook,1.4 -
8474 • Added refentry.meta.get.quietly param.
8476 If zero (the default), notes and warnings about "missing" markup are
8477 generated during gathering of refentry metadata. If non-zero, the metadata
8478 is gathered "quietly" -- that is, the notes and warnings are suppressed.
8480 NOTE: If you are processing a large amount of refentry content, you may be
8481 able to speed up processing significantly by setting a non-zero value for
8482 refentry.meta.get.quietly.
8484 Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/
8485 param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
8488 • Changed names of all boolean indentation params to man.indent.* Also
8489 discarded individual man.indent.*.value params and switched to just using a
8490 common man.indent.width param (3n by default).
8492 Modified: manpages/docbook.xsl,1.66; manpages/info.xsl,1.19; manpages/
8493 lists.xsl,1.29; manpages/other.xsl,1.18; manpages/refentry.xsl,1.13 -
8496 • Added boolean man.output.in.separate.dir param, to control whether or not
8497 man files are output in separate directory.
8499 Modified: manpages/docbook.xsl,1.65; manpages/utility.xsl,1.14 - Michael
8502 • Added options for controlling indentation of verbatim output. Controlled
8503 through the man.indentation.verbatims.adjust and
8504 man.indentation.verbatims.value params. Closes #1242997
8506 Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 - Michael(tm)
8509 • Added options for controlling indentation in lists and in *blurb output in
8510 the AUTHORS section. Controlled through the man.indentation.lists.adjust,
8511 man.indentation.lists.value, man.indentation.authors.adjust, and
8512 man.indentation.authors.value parameters. Default is 3 characters (instead
8513 of the roff default of 8 characters). Closes #1449369.
8515 Also, removed the indent that was being set on informalexample outuput. I
8516 will instead add an option for indenting verbatims, which I think is what
8517 the informalexample indent was intended for originally.
8519 Modified: manpages/block.xsl,1.14; manpages/docbook.xsl,1.63; manpages/
8520 info.xsl,1.18; manpages/lists.xsl,1.28 - Michael(tm) Smith
8522 • Changed line-spacing call before synopfragment to use ".sp -1n" ("n" units
8523 specified) instead of plain ".sp -1"
8525 Modified: manpages/synop.xsl,1.28 - Michael(tm) Smith
8527 • Added support for writing man files into a specific output directory and
8528 into appropriate subdirectories within that output directory. Controlled
8529 through the man.base.dir parameter (similar to the base.dir support in the
8530 HTML stylesheet) and the man.subdirs.enabled parameter, which automatically
8531 determines the name of an appropriate subdir (for example, man/man7, man/
8532 man1, etc.) based on the section number/manvolnum of the source Refentry.
8534 Closes #1255036 and #1170317. Thanks to Denis Bradford for the original
8535 feature request, and to Costin Stroie for submitting a patch that was very
8536 helpful in implementing the support.
8538 Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 - Michael
8541 • Refined XPath statements and notification messages for refentry metadata
8544 Modified: common/common.xsl,1.59; common/refentry.xsl,1.14; manpages/
8545 docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm) Smith
8547 • Added support for copyright and legalnotice. The manpages stylesheets now
8548 output a COPYRIGHT section, after the AUTHORS section, if a copyright or
8549 legalnotice is found in the source. The section contains the copyright
8550 contents followed by the legalnotice contents. Closes #1450209.
8552 Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 - Michael(tm)
8555 • Drastically reworked all of the XPath expressions used in refentry metadata
8556 gathering -- completely removed $parentinfo and turned $info into a set of
8557 nodes that includes the *info contents of the Refentry plus the *info
8558 contents all all of its ancestor elements. The basic XPath expression now
8559 used throughout is (using the example of checking for a date):
8561 (($info[//date])[last()]/date)[1].
8563 That selects the "last" *info/date date in document order -- that is, the
8564 one eitther on the Refentry itself or on the closest ancestor to the
8567 It's likely this change may break some things; may need to pick up some
8570 Also, changed the default value for the man.th.extra2.max.length from 40 to
8573 Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; params/
8574 man.th.extra2.max.length.xml,1.2; params/refentry.date.profile.xml,1.2;
8575 params/refentry.manual.profile.xml,1.2; params/
8576 refentry.source.name.profile.xml,1.2; params/
8577 refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; manpages/
8578 other.xsl,1.15 - Michael(tm) Smith
8580 • Added support for DocBook 5 namespace-stripping in manpages stylesheet.
8581 Closes request #1210692.
8583 Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm)
8586 • Fixed handling of table footnotes. With this checkin, the table support in
8587 the manpages stylesheet is now basically feature complete. So this change
8588 closes request #619532, "No support for tables" -- the oldest currently
8589 open manpages feature request, submitted by Ben Secrest (blsecres) on
8590 2002-10-07. Congratulations to me [patting myself on the back].
8592 Modified: manpages/block.xsl,1.11; manpages/docbook.xsl,1.55; manpages/
8593 table.xsl,1.15 - Michael(tm) Smith
8595 • Added handling for table titles. Also fixed handling of nested tables; nest
8596 tables are now "extracted" and displayed just after their parent tables.
8598 Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14 - Michael(tm)
8601 • Added option for turning off bold formatting in Funcsynopsis. Boldface
8602 formatting in function synopsis is mandated in the man(7) man page and is
8603 used almost universally in existing man pages. Despite that, it really does
8604 look like crap to have an entire Funcsynopsis output in bold, so I added
8605 params for turning off the bold formatting and/or replacing it with a
8606 different roff special font (e.g., "RI" for alternating roman/italic
8607 instead of the default "BI" for alternating bold/italic). The new params
8608 are "man.funcprototype.font" and "man.funcsynopsisinfo.font". To be
8611 Closes #1452247. Thanks to Joe Orton for the feature request.
8613 Modified: params/man.string.subst.map.xml,1.16; manpages/block.xsl,1.10;
8614 manpages/docbook.xsl,1.51; manpages/inline.xsl,1.16; manpages/
8615 synop.xsl,1.27 - Michael(tm) Smith
8617 • Use AUTHORS instead of AUTHOR if we have multiple people to attribute.
8618 Also, fixed checking such that we generate author section even if we don't
8619 have an author (as long as there is at least one other person/entity we can
8620 put in the section). Also adjusted assembly of content for Author metainfo
8621 field such that we now not only use author, but try to find a "best match"
8622 if we can't find an author name to put there.
8624 Closes #1233592. Thanks to Sam Steingold for the request.
8626 Modified: manpages/info.xsl,1.12 - Michael(tm) Smith
8628 • Changes for request #1243027, "Impove handling of AUTHOR section." This
8629 adds support for Collab, Corpauthor, Corpcredt, Orgname, Publishername, and
8630 Publisher. Also adds support for output of Affiliation and its children,
8631 and support for using gentext strings for auto-attributing roles (Author,
8632 Editor, Publisher, Translator, etc.). Also did a lot of code cleanup and
8633 modularization of all the AUTHOR handling code. And fixed a bug that was
8634 causing Author info to not be picked up correctly for metainfo comment we
8635 embed in man-page source.
8637 Modified: manpages/info.xsl,1.11 - Michael(tm) Smith
8639 • Support bold output for "emphasis remap='B'". (because Eric Raymond's
8640 doclifter(1) tool converts groff source marked up with ".B" request or "\
8641 fB" escapes to DocBook "emphasis remap='B'".)
8643 Modified: manpages/inline.xsl,1.14 - Michael(tm) Smith
8645 • Added support for Segmentedlist. Details: Output is tabular, with no option
8646 for "list" type output. Output for Segtitle elements can be supressed by
8647 setting man.segtitle.suppress. If Segtitle content is output, it is
8648 rendered in italic type (not bold because not all terminals support bold
8649 and so italic ensures the stand out on those terminals). Extra space (.sp
8650 line) at end of table code ensures that it gets handled correctly in the
8651 case where its source is the child of a Para. Closes feature-request #
8652 1400097. Thanks to Daniel Leidert for the patch and push, and to Alastair
8653 Rankine for filing the original feature request.
8655 Modified: manpages/lists.xsl,1.23; manpages/utility.xsl,1.10 - Michael(tm)
8658 • Improved handling or Author/Editor/Othercredit.
8660 Reworked content of (non-visible) comment added at top of each page
8663 Added support for generating a manifest file (useful for cleaning up after
8666 Modified: manpages/docbook.xsl,1.46; manpages/info.xsl,1.9; manpages/
8667 other.xsl,1.12; manpages/utility.xsl,1.6 - Michael(tm) Smith
8669 • Added two new parameters for handling of multi-term varlistentry elements:
8671 variablelist.term.break.after: When the variablelist.term.break.after is
8672 non-zero, it will generate a line break after each term multi-term
8675 variablelist.term.separator: When a varlistentry contains multiple term
8676 elements, the string specified in the value of the
8677 variablelist.term.separator parameter is placed after each term except the
8678 last. The default is ", " (a comma followed by a space). To suppress
8679 rendering of the separator, set the value of variablelist.term.separator to
8680 the empty string ("").
8682 These parameters are primarily intended to be useful if you have multi-term
8683 varlistentries that have long terms.
8685 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
8686 long terms" doc that demonstrated the value of having these options.
8688 Also, added normalize-space() call to processing of each term.
8690 This change affects all output formats (HTML, PDF, manpages). The default
8691 behavior should pretty much remain the same as before, but it is possible
8692 (as always) that the change may introduce some new bugginess.
8694 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
8695 lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
8696 lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
8697 variablelist.term.break.after.xml,1.1; params/
8698 variablelist.term.separator.xml,1.1 - Michael(tm) Smith
8702 The following changes have been made to the params code since the 1.69.1
8705 • New parameters to set header/footer table minimum height.
8707 Modified: params/footer.table.height.xml,1.1; params/
8708 header.table.height.xml,1.1 - Robert Stayton
8710 • Support multiple indexing methods for different languages.
8712 Modified: params/index.method.xml,1.1 - Robert Stayton
8714 • Remove qandaset and qandadiv from generate.toc for fo output because
8715 formerly it wasn't working, but now it is and the default behavior should
8718 Modified: params/generate.toc.xml,1.8 - Robert Stayton
8720 • add support for page number references to link element too.
8722 Modified: params/insert.link.page.number.xml,1.1 - Robert Stayton
8724 • Add support for more characters to hyphen on when ulink.hyphenate is turned
8727 Modified: params/ulink.hyphenate.chars.xml,1.1; params/
8728 ulink.hyphenate.xml,1.3 - Robert Stayton
8730 • New attribute-set to format biblioentry and bibliomixed.
8732 Modified: params/biblioentry.properties.xml,1.1 - Robert Stayton
8734 • Added new parameter chunk.tocs.and.lots.has.title which controls presence
8735 of title in a separate chunk with ToC/LoT. Disabling title can be very
8736 useful if you are generating frameset output (well, yes those frames, but
8737 some customers really want them ;-).
8739 Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; html/
8740 param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
8743 • Added new attribute set toc.line.properties for controlling appearance of
8746 Modified: params/toc.line.properties.xml,1.1 - Jirka Kosek
8748 • Allow table footnotes to have different properties from regular footnotes.
8750 Modified: params/table.footnote.properties.xml,1.1 - Robert Stayton
8752 • Set properties for pgwide="1" objects.
8754 Modified: params/pgwide.properties.xml,1.1 - Robert Stayton
8756 • Added the autotoc.label.in.hyperlink param.
8758 If the value of autotoc.label.in.hyperlink is non-zero, labels are included
8759 in hyperlinked titles in the TOC. If it is instead zero, labels are still
8760 displayed prior to the hyperlinked titles, but are not hyperlinked along
8763 Closes patch #1065868. Thanks to anatoly techtonik for the patch.
8765 Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; html/
8766 param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - Michael(tm)
8769 • Added two new params: html.head.legalnotice.link.types and html.head.
8770 legalnotice.link.multiple.
8772 If the value of the generate.legalnotice.link is non-zero, then the
8773 stylesheet generates (in the head section of the HTML source) either a
8774 single HTML link element or, if the value of the html.head.legalnotice.link
8775 .multiple is non-zero, one link element for each link type specified. Each
8776 link has the following attributes:
8778 - a rel attribute whose value is derived from the value of html.head.
8779 legalnotice.link.types
8781 - an href attribute whose value is set to the URL of the file containing
8784 - a title attribute whose value is set to the title of the corresponding
8785 legalnotice (or a title programatically determined by the stylesheet)
8789 <link rel="copyright" href="ln-id2524073.html" title="Legal Notice">
8791 Closes #1476450. Thanks to Sam Steingold.
8793 Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; html/
8794 param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; params/
8795 html.head.legalnotice.link.multiple.xml,1.1; params/
8796 html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith
8798 • Added the following params:
8800 - man.indent.width (string-valued) - man.indent.refsect (boolean) -
8801 man.indent.blurbs (boolean) - man.indent.lists (boolean) -
8802 man.indent.verbatims (boolean)
8804 Note that in earlier snapshots, man.indent.width was named
8805 man.indentation.default.value and the boolean params had names like
8806 man.indentation.*.adjust. Also the man.indent.blurbs param was called
8807 man.indentation.authors.adjust (or something).
8809 The behavior now is: If the value of a particular man.indent.* boolean
8810 param is non-zero, the corresponding contents (refsect*, list items,
8811 authorblurb/personblurb, vervatims) are displayed with a left margin
8812 indented by a width equal to the value of man.indent.width.
8814 Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74;
8815 manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
8816 manpages/param.ent,1.22; manpages/param.xweb,1.24; manpages/
8817 refentry.xsl,1.14; params/man.indent.lists.xml,1.1; params/
8818 man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; params/
8819 man.indent.width.xml,1.1 - Michael(tm) Smith
8821 • Added man.table.footnotes.divider param.
8823 In each table that contains footenotes, the string specified by the man.
8824 table.footnotes.divider parameter is output before the list of footnotes
8827 Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; manpages/
8828 param.ent,1.21; manpages/param.xweb,1.23; params/
8829 man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith
8831 • Added the man.output.in.separate.dir, man.output.base.dir, and
8832 man.output.subdirs.enabled parameters.
8834 The man.output.base.dir parameter specifies the base directory into which
8835 man-page files are output. The man.output.subdirs.enabled parameter
8836 controls whether the files are output in subdirectories within the base
8839 The values of the man.output.base.dir and man.output.subdirs.enabled
8840 parameters are used only if the value of man.output.in.separate.dir
8841 parameter is non-zero. If the value of man.output.in.separate.dir is zero,
8842 man-page files are not output in a separate directory.
8844 Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; manpages/
8845 param.xweb,1.22; params/man.output.base.dir.xml,1.1; params/
8846 man.output.in.separate.dir.xml,1.1; params/
8847 man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith
8849 • Added man.font.table.headings and man.font.table.title params, for
8850 controlling font in table headings and titles.
8852 Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; manpages/
8853 param.xweb,1.21; params/man.font.table.headings.xml,1.1; params/
8854 man.font.table.title.xml,1.1 - Michael(tm) Smith
8856 • Added man.font.funcsynopsisinfo and man.font.funcprototype params, for
8857 specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and
8858 funcprototype output.
8860 Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; manpages/
8861 param.ent,1.18; manpages/param.xweb,1.20; manpages/synop.xsl,1.29; manpages
8862 /table.xsl,1.21; params/man.font.funcprototype.xml,1.1; params/
8863 man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith
8865 • Changed to select="0" in refclass.suppress (instead of ..>0</..)
8867 Modified: params/refclass.suppress.xml,1.3 - Michael(tm) Smith
8869 • Added man.segtitle.suppress param.
8871 If the value of man.segtitle.suppress is non-zero, then display of segtitle
8872 contents is suppressed in output.
8874 Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; manpages/
8875 param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - Michael(tm) Smith
8877 • Added man.output.manifest.enabled and man.output.manifest.filename params.
8879 If man.output.manifest.enabled is non-zero, a list of filenames for man
8880 pages generated by the stylesheet transformation is written to the file
8881 named by man.output.manifest.filename
8883 Modified: manpages/docbook.xsl,1.67; manpages/other.xsl,1.19; manpages/
8884 param.ent,1.16; manpages/param.xweb,1.18; params/
8885 man.output.manifest.enabled.xml,1.1; params/
8886 man.output.manifest.filename.xml,1.1; tools/make/Makefile.DocBook,1.4 -
8889 • Added refclass.suppress param.
8891 If the value of refclass.suppress is non-zero, then display refclass
8892 contents is suppressed in output. Affects HTML and FO output only.
8894 Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html
8895 /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith
8897 • Added refentry.meta.get.quietly param.
8899 If zero (the default), notes and warnings about "missing" markup are
8900 generated during gathering of refentry metadata. If non-zero, the metadata
8901 is gathered "quietly" -- that is, the notes and warnings are suppressed.
8903 NOTE: If you are processing a large amount of refentry content, you may be
8904 able to speed up processing significantly by setting a non-zero value for
8905 refentry.meta.get.quietly.
8907 Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/
8908 param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
8911 • Added support for "software" and "sectdesc" class values on refmiscinfo;
8912 "software" is treated identically to "source", and "setdesc" is treated
8913 identically to "manual".
8915 Modified: common/refentry.xsl,1.10; params/
8916 man.th.extra2.max.length.xml,1.3; params/
8917 refentry.source.name.profile.xml,1.4 - Michael(tm) Smith
8919 • Drastically reworked all of the XPath expressions used in refentry metadata
8920 gathering -- completely removed $parentinfo and turned $info into a set of
8921 nodes that includes the *info contents of the Refentry plus the *info
8922 contents all all of its ancestor elements. The basic XPath expression now
8923 used throughout is (using the example of checking for a date):
8925 (($info[//date])[last()]/date)[1].
8927 That selects the "last" *info/date date in document order -- that is, the
8928 one eitther on the Refentry itself or on the closest ancestor to the
8931 It's likely this change may break some things; may need to pick up some
8934 Also, changed the default value for the man.th.extra2.max.length from 40 to
8937 Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; params/
8938 man.th.extra2.max.length.xml,1.2; params/refentry.date.profile.xml,1.2;
8939 params/refentry.manual.profile.xml,1.2; params/
8940 refentry.source.name.profile.xml,1.2; params/
8941 refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; manpages/
8942 other.xsl,1.15 - Michael(tm) Smith
8944 • Added option for turning off bold formatting in Funcsynopsis. Boldface
8945 formatting in function synopsis is mandated in the man(7) man page and is
8946 used almost universally in existing man pages. Despite that, it really does
8947 look like crap to have an entire Funcsynopsis output in bold, so I added
8948 params for turning off the bold formatting and/or replacing it with a
8949 different roff special font (e.g., "RI" for alternating roman/italic
8950 instead of the default "BI" for alternating bold/italic). The new params
8951 are "man.funcprototype.font" and "man.funcsynopsisinfo.font". To be
8954 Closes #1452247. Thanks to Joe Orton for the feature request.
8956 Modified: params/man.string.subst.map.xml,1.16; manpages/block.xsl,1.10;
8957 manpages/docbook.xsl,1.51; manpages/inline.xsl,1.16; manpages/
8958 synop.xsl,1.27 - Michael(tm) Smith
8960 • fop.extensions now only for FOP version 0.20.5 and earlier.
8962 Modified: params/fop.extensions.xml,1.4 - Robert Stayton
8964 • Support for fop1 different from fop 0.20.5 and earlier.
8966 Modified: params/fop1.extensions.xml,1.1 - Robert Stayton
8968 • Reset default value to empty string so template uses gentext first, then
8969 the parameter value if not empty.
8971 Modified: params/index.number.separator.xml,1.2; params/
8972 index.range.separator.xml,1.2; params/index.term.separator.xml,1.2 - Robert
8975 • New parameter: id.warnings. If non-zero, warnings are generated for titled
8976 objects that don't have titles. True by default; I wonder if this will be
8979 Modified: html/biblio.xsl,1.25; html/component.xsl,1.27; html/
8980 division.xsl,1.11; html/formal.xsl,1.19; html/glossary.xsl,1.20; html/
8981 html.xsl,1.13; html/index.xsl,1.16; html/param.ent,1.88; html/
8982 param.xweb,1.97; html/refentry.xsl,1.22; html/sections.xsl,1.30; params/
8983 id.warnings.xml,1.1 - Norman Walsh
8985 • Added new parameter keep.relative.image.uris
8987 Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html
8988 /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh
8990 • Support default label width parameters for itemized and ordered lists
8992 Modified: fo/lists.xsl,1.64; fo/param.ent,1.90; fo/param.xweb,1.103; params
8993 /itemizedlist.label.width.xml,1.1; params/orderedlist.label.width.xml,1.1 -
8996 • Added parameters to localize punctuation in indexes.
8998 Modified: params/index.number.separator.xml,1.1; params/
8999 index.range.separator.xml,1.1; params/index.term.separator.xml,1.1 - Robert
9002 • Added two new parameters for handling of multi-term varlistentry elements:
9004 variablelist.term.break.after: When the variablelist.term.break.after is
9005 non-zero, it will generate a line break after each term multi-term
9008 variablelist.term.separator: When a varlistentry contains multiple term
9009 elements, the string specified in the value of the
9010 variablelist.term.separator parameter is placed after each term except the
9011 last. The default is ", " (a comma followed by a space). To suppress
9012 rendering of the separator, set the value of variablelist.term.separator to
9013 the empty string ("").
9015 These parameters are primarily intended to be useful if you have multi-term
9016 varlistentries that have long terms.
9018 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
9019 long terms" doc that demonstrated the value of having these options.
9021 Also, added normalize-space() call to processing of each term.
9023 This change affects all output formats (HTML, PDF, manpages). The default
9024 behavior should pretty much remain the same as before, but it is possible
9025 (as always) that the change may introduce some new bugginess.
9027 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
9028 lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
9029 lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
9030 variablelist.term.break.after.xml,1.1; params/
9031 variablelist.term.separator.xml,1.1 - Michael(tm) Smith
9033 • Convert 'no' to string in default value.
9035 Modified: params/olink.doctitle.xml,1.4 - Robert Stayton
9037 • Implemented RFE #1292615.
9039 Added bunch of new parameters (attribute sets) that affect list
9040 presentation: list.block.properties, itemizedlist.properties, orderedlist
9041 .properties, itemizedlist.label.properties and orderedlist.label
9042 .properties. Default behaviour of stylesheets has not been changed but
9043 further customizations will be much more easier.
9045 Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; params/
9046 itemizedlist.label.properties.xml,1.1; params/
9047 itemizedlist.properties.xml,1.1; params/list.block.properties.xml,1.1;
9048 params/orderedlist.label.properties.xml,1.1; params/
9049 orderedlist.properties.xml,1.1 - Jirka Kosek
9051 • Implemented RFE #1242092.
9053 You can enable crop marks in your document by setting crop.marks=1 and
9054 xep.extensions=1. Appearance of crop marks can be controlled by parameters
9055 crop.mark.bleed (6pt), crop.mark.offset (24pt) and crop.mark.width (0.5pt).
9057 Also there is new named template called user-xep-pis. You can overwrite it
9058 in order to produce some PIs that can control XEP as described in http://
9059 www.renderx.com/reference.html#Output_Formats
9061 Modified: fo/docbook.xsl,1.36; fo/param.ent,1.86; fo/param.xweb,1.97; fo/
9062 xep.xsl,1.23; params/crop.mark.bleed.xml,1.1; params/
9063 crop.mark.offset.xml,1.1; params/crop.mark.width.xml,1.1; params/
9064 crop.marks.xml,1.1 - Jirka Kosek
9066 • Changed short descriptions in doc for *autolabel* params to match new
9069 Modified: params/appendix.autolabel.xml,1.5; params/
9070 chapter.autolabel.xml,1.4; params/part.autolabel.xml,1.5; params/
9071 preface.autolabel.xml,1.4 - Michael(tm) Smith
9075 The following changes have been made to the profiling code since the 1.69.1
9078 • Profiling now works together with namespace stripping (V5 documents).
9079 Namespace striping should work with all stylesheets named profile-, even if
9080 they are not supporting namespace stripping in a non-profiling variant.
9082 Modified: profiling/profile-mode.xsl,1.4; profiling/xsl2profile.xsl,1.7 -
9085 • Moved profiling stage out of templates. This make possible to reuse
9086 profiled content by several templates and still maintaing node indentity
9087 (needed for example for HTML Help where content is processed multiple
9090 I don't know why this was not on the top level before. Maybe some XSLT
9091 processors choked on it. I hope this will be OK now.
9093 Modified: profiling/xsl2profile.xsl,1.5 - Jirka Kosek
9097 The following changes have been made to the tools code since the 1.69.1
9100 • Moved Makefile.DocBook from contrib module to xsl module.
9102 Modified: tools/make/Makefile.DocBook,1.1 - Michael(tm) Smith
9106 The following changes have been made to the wordml code since the 1.69.1
9109 • added contrib element, better handling of default paragraph style
9111 Modified: wordml/pages-normalise.xsl,1.6; wordml/supported.xml,1.2; wordml/
9112 wordml-final.xsl,1.14 - Steve Ball
9116 Modified: wordml/docbook-pages.xsl,1.6; wordml/docbook.xsl,1.17; wordml/
9117 pages-normalise.xsl,1.5; wordml/template-pages.xml,1.7; wordml/
9118 template.dot,1.4; wordml/template.xml,1.14; wordml/wordml-final.xsl,1.13 -
9121 • added blocks stylesheet to support bibliographies, glossaries and qandasets
9123 Modified: wordml/Makefile,1.4; wordml/README,1.3; wordml/
9124 blocks-spec.xml,1.1; wordml/docbook-pages.xsl,1.5; wordml/docbook.xsl,1.16;
9125 wordml/pages-normalise.xsl,1.4; wordml/sections-spec.xml,1.3; wordml/
9126 specifications.xml,1.13; wordml/template-pages.xml,1.6; wordml/
9127 template.dot,1.3; wordml/template.xml,1.13; wordml/wordml-blocks.xsl,1.1;
9128 wordml/wordml-final.xsl,1.12; wordml/wordml-sections.xsl,1.3 - Steve Ball
9130 • added mediaobject caption
9132 Modified: wordml/docbook-pages.xsl,1.4; wordml/docbook.xsl,1.15; wordml/
9133 specifications.xml,1.12; wordml/template-pages.xml,1.5; wordml/
9134 template.dot,1.2; wordml/template.xml,1.12; wordml/wordml-final.xsl,1.11 -
9139 Modified: wordml/docbook-pages.xsl,1.3; wordml/docbook.xsl,1.14; wordml/
9140 pages-normalise.xsl,1.3; wordml/specifications.xml,1.11; wordml/
9141 template-pages.xml,1.4; wordml/wordml-final.xsl,1.10 - Steve Ball
9143 • added Word template file
9145 Modified: wordml/template.dot,1.1 - Steve Ball
9147 • added abstract, fixed itemizedlist, ulink
9149 Modified: wordml/specifications.xml,1.10; wordml/wordml-final.xsl,1.9 -
9152 • fixed Makefile added many features to Pages support added revhistory,
9153 inlines, highlights, abstract
9155 Modified: wordml/Makefile,1.2; wordml/docbook-pages.xsl,1.2; wordml/
9156 pages-normalise.xsl,1.2; wordml/sections-spec.xml,1.2; wordml/
9157 specifications.xml,1.9; wordml/template-pages.xml,1.3; wordml/
9158 template.xml,1.11; wordml/wordml-final.xsl,1.8; wordml/
9159 wordml-sections.xsl,1.2 - Steve Ball
9161 • fixed handling linebreaks when generating WordML added Apple Pages support
9163 Modified: wordml/docbook.xsl,1.13; wordml/template-pages.xml,1.2 - Steve
9168 This release is a minor bug-fix update to the 1.69.0 release. Along with bug
9169 fixes, it includes one configuration-parameter change: The default value of the
9170 annotation.support parameter is now 0 (off). The reason for that change is that
9171 there have been reports that annotation handling is causing a significant
9172 performance degradation in processing of large documents with xsltproc.
9176 The release includes major feature changes, particularly in the manpages
9177 stylesheets, as well as a large number of bug fixes.
9179 As with all DocBook Project “dot zero” releases, this is an experimental
9184 • This release adds localizations for the following languages: Albanian,
9185 Amharic, Azerbaijani, Hindi, Irish (Gaelic), Gujarati, Kannada, Mongolian,
9186 Oriya, Punjabi, Tagalog, Tamil, and Welsh.
9188 • Added support for specifying number format for auto labels for chapter,
9189 appendix, part, and preface. Contolled with the appendix.autolabel,
9190 chapter.autolabel, part.autolabel, and preface.autolabel parameters.
9192 • Added basic support for biblioref cross referencing.
9194 • Added support for align on caption in mediaobject.
9196 • Added support for processing documents that use the DocBook V5 namespace.
9198 • Added support for termdef and mathphrase.
9200 • EXPERIMENTAL: Incorporated the Slides and Website stylesheets into the
9201 DocBook XSL stylesheets package. So, for example, Website documents can now
9202 be processed using the following URI for the driver Website tabular.xsl
9205 http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl
9207 • A procedure without a title is now treated as an “informal” procedure
9208 (meaning that it is not added to any generated “list of procedures” and has
9209 no affect on numbering of generated labels for other procedures).
9211 • docname is no longer added to olink when pointing to a root element.
9213 • Added support for generation of choice separator in inline simplelist. This
9214 enables auto-generation of an appropriate localized “choice separator” (for
9215 example, “and” or “or”) before the final item in an inline simplelist.
9217 To indicate that you want a choice separator generated for a particular
9218 list, you need to put a processing instruction (PI) of the form <?
9219 dbchoice choice="foo"?> as a child of the list. For example:
9222 ONE and ONLY ONE of the following:
9223 <simplelist type="inline">
9224 <?dbchoice choice="or" ?>
9227 <member>C</member>.</simplelist></para>
9229 Output (for English):
9231 Choose from ONE and only ONE of the following choices: A, B, or C.
9233 As a temporary workaround for the fact that most of the DocBook non-English
9234 locale files don't have a localization for the word “or”, you can put in a
9235 literal string to be used; example for French: <?dbchoice choice="ou">.
9236 That is, use “ou” instead of “or”.
9240 • Added content-type property to external-graphic element, based on imagedata
9243 • Added support for generating <rx:meta-field creator="$VERSION"/> field for
9244 XEP output. This makes the DocBook XSL stylesheet version information
9245 available through the Document Properties menu in Acrobat Reader and other
9248 • Trademark symbol handling made consistent with handling of same in HTML
9249 stylesheets. Prior to this change, if you processed a document that
9250 contained no value for the class attribute on the trademark element, the
9251 HTML stylesheets would default to rendering a superscript TM symbol after
9252 the trademark contents, but the FO stylesheets would render nothing.
9254 • Added support for generating XEP bookmarks for refentry.
9256 • Added support for HTML markup table border attribute, applied to each table
9259 • The table.width template can now sum column specs if none use % or *.
9261 • Added fox:destination extension inside fox:outline to support linking to
9262 internal destinations.
9264 • Added support for customizing abstract with property sets. Controlled with
9265 the abstract.properties and abstract.title.properties parameters.
9267 • Add footnotes in table title to table footnote set, and add support for
9268 table footnotes to HTML table markup.
9270 • Added support for title in glosslist.
9272 • Added support for itemizedlist symbol none.
9274 • Implemented the new graphical.admonition.properties and
9275 nongraphical.admonition.properties attribute sets.
9277 • Added id to formalpara and some other blocks that were missing it.
9279 • Changed the anchor template to output fo:inline instead of fo:wrapper.
9281 • Added support for toc.max.depth parameter.
9285 • Eclipse Help: Added support for generating olink database.
9289 • Added a first cut at support in HTML output for DocBook 5 style annotation
9290 s. Controlled using the annotation.support parameter, and implemented using
9291 JavaScript and CSS styling. For more details, see the documentation for the
9292 annotation.js, annotation.css, annotation.graphic.open, and
9293 annotation.graphic.close parameters.
9295 • Generate client-side image map for imageobjectco with areas using calspair
9298 • Added support for <?img.src.path?> PI.
9300 • Added support for passing img.src.path to DocBook Java XSLT image
9301 extensions when appropriate. Controlled using the
9302 graphicsize.use.img.src.path parameter.
9304 • Added support for (not valid for DocBook 4) xlink:href on area and (not
9305 valid for DocBook 4) alt in area.
9307 • Added new parameter default.table.frame to control table framing if there
9308 is no frame attribute on a table.
9310 • Added initial, experimental support for generating content for the HTML
9311 title attribute from content of the alt element. This change adds support
9312 for the following inline elements only (none of them are block elements):
9313 abbrev, accel, acronym, action, application, authorinitials, beginpage,
9314 citation, citerefentry, citetitle, city, classname, code, command,
9315 computeroutput, constant, country, database, email, envar, errorcode,
9316 errorname, errortext, errortype, exceptionname, fax, filename, firstname,
9317 firstterm, foreignphrase, function, glossterm, guibutton, guiicon, guilabel
9318 , guimenu, guimenuitem, guisubmenu, hardware, honorific, interface,
9319 interfacename, keycap, keycode, keysym, lineage, lineannotation, literal,
9320 markup, medialabel, methodname, mousebutton, option, optional, otheraddr,
9321 othername, package, parameter, personname, phone, pob, postcode,
9322 productname, productnumber, prompt, property, quote, refentrytitle, remark,
9323 replaceable, returnvalue, tag, shortcut, state, street, structfield,
9324 structname, subscript, superscript, surname, symbol, systemitem, tag,
9325 termdef, token, trademark, type, uri, userinput, varname, and wordasword
9327 • Added support for chunking revhistory into separate file (similar to the
9328 support for doing same with legalnotice). Patch from Thomas Schraitle.
9329 Controlled through new generate.revhistory.link parameter.
9331 • l10n.xsl: Made language codes RFC compliant. Added a new boolean config
9332 parameter, l10n.lang.value.rfc.compliant. If it is non-zero (the default),
9333 any underscore in a language code will be converted to a hyphen in HTML
9334 output. If it is zero, the language code will be left as-is.
9338 This release closes out 44 manpages stylesheet bug reports and feature
9339 requests. It adds more than 35 new configuration parameters for controlling
9340 aspects of man-page output -- including hyphenation and justification, handling
9341 of links, conversion of Unicode characters, and contents of man-page headers
9344 • New options for globally disabling/enabling hyphenation and justification:
9345 man.justify and man.hyphenate.
9347 Note that the default for the both of those is zero (off), because
9348 justified text looks good only when it is also hyphenated; to quote the
9349 “Hyphenation” node from the groff info page:
9351 Since the odds are not great for finding a set of words, for every
9352 output line, which fit nicely on a line without inserting excessive
9353 amounts of space between words, `gtroff' hyphenates words so that it
9354 can justify lines without inserting too much space between words.
9356 The problem is that groff can end up hyphenating a lot of things that you
9357 don't want hyphenated (variable names and command names, for example).
9358 Keeping both justification and hyphenation disabled ensures that hyphens
9359 won't get inserted where you don't want to them, and you don't end up with
9360 lines containing excessive amounts of space between words. These default
9361 settings run counter to how most existing man pages are formatted. But
9362 there are some notable exceptions, such as the perl man pages.
9364 • Added parameters for controlling hyphenation of computer inlines,
9365 filenames, and URLs. By default, even when hyphenation is enabled
9366 (globally), hyphenation is now suppressed for "computer inlines"
9367 (currently, just classname, constant, envar, errorcode, option, replaceable
9368 , userinput, type, and varname, and for filenames, and for URLs from link.
9369 It can be (re)enabled using the man.hyphenate.computer.inlines,
9370 man.hyphenate.filenames, and man.hyphenate.urls parameters.
9372 • Implemented a new system for replacing Unicode characters. There are two
9373 parts to the new system: a “string substitution map” for doing “essential”
9374 replacements, and a “character map” that can optionally be disabled and
9377 The new system fixes all open bugs that had to do with literal Unicode
9378 numbered entities such as “ and ” showing up in output, and
9379 greatly expands the ability of the stylesheets to generate “good” roff
9380 equivalents for Unicode symbols and special characters.
9382 Here are some details...
9384 The previous manpages mechanism for replacing Unicode symbols and special
9385 characters with roff equivalents (the replace-entities template) was not
9386 scalable and not complete. The mechanism handled a somewhat arbitrary
9387 selection of less than 20 or so Unicode characters. But there are
9388 potentially more than 800 Unicode special characters that have some groff
9389 equivalent they can be mapped to. And there are about 34 symbols in the
9390 Latin-1 (ISO-8859-1) block alone. Users might reasonably expect that if
9391 they include any of those Latin-1 characters in their DocBook source
9392 documents, they will get correctly converted to known roff equivalents in
9395 In addition to those common symbols, certain users may have a need to use
9396 symbols from other Unicode blocks. Say, somebody who is documenting an
9397 application related to math might need to use a bunch of symbols from the
9398 “Mathematical Operators” Unicode block (there are about 65 characters in
9399 that block that have reasonable roff equivalents). Or somebody else might
9400 really like Dingbats -- such as the checkmark character -- and so might use
9401 a bunch of things from the “Dingbat” block (141 characters in that that
9402 have roff equivalents or that can at least be “degraded” somewhat
9403 gracefully into roff).
9405 So, the old replace-entities mechanism was replaced with a completely
9406 different mechanism that is based on use of two “maps”: a “substitution
9407 map” and a “character map” (the latter in a format compliant with the XSLT
9408 2.0 spec and therefore completely “forward compatible” with XSLT 2.0).
9410 The substitution map is controlled through the man.string.subst.map
9411 parameter, and is used to replace things like the backslash character
9412 (which needs special handling to prevent it from being interpreted as a
9413 roff escape). The substitution map cannot be disabled, because disabling it
9414 will cause the output to be broken. However, you can add to it and change
9417 The “character map” mechanism, on the other hand, can be completely
9418 disabled. It is enabled by default, and, by default, does replacement of
9419 all Latin-1 symbols, along with most special spaces, dashes, and quotes
9420 (about 75 characters by default). Also, you can optionally enable a “full”
9421 character map that provides support for converting all 800 or so of the
9422 characters that have some reasonable groff equivalent.
9424 The character-map mechanism is controlled through the following parameters:
9428 turns character-map support on/off
9430 man.charmap.use.subset
9432 specifies that a subset of the character map is used instead of the
9435 man.charmap.subset.profile
9437 specifies profile of character-map subset
9441 specifies an alternate character map to use instead of the “standard”
9442 character map provided in the distribution
9444 • Implemented out-of-line handling of display of URLs for links (currently,
9445 only for ulink). This gives you three choices for handling of links:
9447 1. Number and list links. Each link is numbered inline, with a number in
9448 square brackets preceding the link contents, and a numbered list of all
9449 links is added to the end of the document.
9451 2. Only list links. Links are not numbered, but an (unnumbered) list of
9452 links is added to the end of the document.
9454 3. Suppress links. Don't number links and don't add any list of links to
9455 the end of the document.
9457 You can also choose whether links should be underlined. The default is “the
9458 works” -- list, number, and underline links. You can use the
9459 man.links.list.enabled, man.links.are.numbered, and
9460 man.links.are.underlined parameters to change the defaults. The default
9461 heading for the link list is REFERENCES. You can be change that using the
9462 man.links.list.heading parameter.
9464 • Changed default output encoding to UTF-8. This does not mean that man pages
9465 are output in raw UTF-8, because the character map is applied before final
9466 output, causing all UTF-8 characters covered in the map to be converted to
9469 • Added support for processing refsect3 and formalpara and nested refsection
9470 elements, down to any arbitrary level of nesting.
9472 • Output of the NAME and SYNOPSIS and AUTHOR headings and the headings for
9473 admonitions (note, caution, etc.) are no longer hard-coded for English.
9474 Instead, headings are generated for those in the correct locale (just as
9475 the FO and HTML stylesheets do).
9477 • Re-worked mechanism for assembling page headers/footers (the contents of
9478 the .TH macro “title line”).
9480 Here are some details...
9482 All man pages contain a .TH roff macro whose contents are used for
9483 rendering the “title line” displayed in the header and footer of each page.
9484 Here are a couple of examples of real-world man pages that have useful page
9487 gtk-options(7) GTK+ User's Manual gtk-options(7) <-- header
9488 GTK+ 1.2 2003-10-20 gtk-options(7) <-- footer
9490 svgalib(7) Svgalib User Manual svgalib(7) <-- header
9491 Svgalib 1.4.1 16 December 1999 svgalib(7) <-- footer
9493 And here are the terms with which the groff_man(7) man page refers to the
9494 various parts of the header/footer:
9496 title(section) extra3 title(section) <- header
9497 extra2 extra1 title(section) <- footer
9499 Or, using the names with which the man(7) man page refers to those same
9502 title(section) manual title(section) <- page header
9503 source date title(section) <- page footer
9505 The easiest way to control the contents of those fields is to mark up your
9506 refentry content like the following (note that this is a “minimal”
9511 <date>2003-10-20</date> 1
9514 <refentrytitle>gtk-options</refentrytitle> 2
9515 <manvolnum>7</manvolnum> 3
9516 <refmiscinfo class="source-name">GTK+</refmiscinfo> 4
9517 <refmiscinfo class="version">1.2</refmiscinfo> 5
9518 <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> 6
9521 <refname>gtk-options</refname>
9522 <refpurpose>Standard Command Line Options for GTK+ Programs</refpurpose>
9525 <title>Description</title>
9526 <para>This manual page describes the command line options, which
9527 are common to all GTK+ based applications.</para>
9531 1 Sets the “date” part of the header/footer.
9533 2 Sets the “title” part.
9535 3 Sets the “section” part.
9537 4 Sets the “source name” part.
9539 5 Sets the “version” part.
9541 6 Sets the “manual” part.
9543 Below are explanations of the steps the stylesheets take to attempt to
9544 assemble and display “good” headers and footer. [In the descriptions, note
9545 that *info is the refentry “info” child (whatever its name), and parentinfo
9546 is the “info” child of its parent (again, whatever its name).]
9550 Content of the “extra1” field is what shows up in the center footer
9551 position of each page. The man(7) man page describes it as “the date of
9554 To provide this content, if the refentry.date.profile.enabled is
9555 non-zero, the stylesheets check the value of refentry.date.profile.
9557 Otherwise, by default, they check for a date or pubdate not only in the
9558 *info contents, but also in the parentinfo contents.
9560 If a date cannot be found, the stylesheets now automatically generate a
9561 localized “long format” date, ensuring that this field always has
9564 However, if for some reason you want to suppress this field, you can do
9565 so by setting a non-zero value for man.th.extra1.suppress.
9567 extra2 field (source)
9569 On Linux systems and on systems with a modern groff, the content of the
9570 “extra2” field are what shows up in the left footer position of each
9573 The man(7) man page describes this as “the source of the command”, and
9574 provides the following examples:
9576 ☆ For binaries, use somwething like: GNU, NET-2, SLS Distribution,
9579 ☆ For system calls, use the version of the kernel that you are
9580 currently looking at: Linux 0.99.11.
9582 ☆ For library calls, use the source of the function: GNU, BSD 4.3,
9585 In practice, there are many pages that simply have a version number in
9586 the “source” field. So, it looks like what we have is a two-part field,
9587 Name Version, where:
9591 product name (e.g., BSD) or org. name (e.g., GNU)
9597 Each part is optional. If the Name is a product name, then the Version
9598 is probably the version of the product. Or there may be no Name, in
9599 which case, if there is a Version, it is probably the version of the
9600 item itself, not the product it is part of. Or, if the Name is an
9601 organization name, then there probably will be no Version.
9603 To provide this content, if the refentry.source.name.profile.enabled
9604 and refentry.version.profile.enabled parameter are non-zero, the
9605 stylesheets check the value of refentry.source.name.profile
9606 refentry.version.profile.
9608 Otherwise, by default, they check the following places, in the
9611 1. *info/productnumber
9613 2. *info/productnumber
9615 3. refmeta/refmiscinfo[@class = 'version']
9617 4. parentinfo/productnumber
9619 5. *info/productname
9621 6. parentinfo/productname
9623 7. refmeta/refmiscinfo
9625 8. [nothing found, so leave it empty]
9629 On Linux systems and on systems with a modern groff, the content of the
9630 “extra3” field are what shows up in the center header position of each
9631 page. Some man pages have “extra2” content, some don't. If a particular
9632 man page has it, it is most often “context” data about some larger
9633 system the documented item belongs to (for example, the name or
9634 description of a group of related applications). The stylesheets now
9635 check the following places, in the following order, to look for content
9636 to add to the “extra3” field.
9642 3. refmeta/refmiscinfo
9644 4. [nothing found, so leave it empty]
9646 • Reworked *info gathering. For each refentry found, the stylesheets now
9647 cache its *info content, then check for any valid parent of it that might
9648 have metainfo content and cache that, if found; they then then do all
9649 further matches against those node-sets (rather than re-selecting the
9650 original *info nodes each time they are needed).
9652 • New option for breaking strings after forward slashes. This enables long
9653 URLs and pathnames to be broken across lines. Controlled through
9654 man.break.after.slash parameter.
9656 • Output for servicemark and trademark are now (SM) and (TM). There is a
9657 groff "\(tm" escape, but output from that is not acceptable.
9659 • New option for controlling the length of the title part of the .TH title
9660 line. Controlled through the man.th.title.max.length parameter.
9662 • New option for specifying output encoding of each man page; controlled with
9663 man.output.encoding (similar to the HTML chunker.output.encoding
9666 • New option for suppressing filename messages when generating output;
9667 controlled with man.output.quietly (similar to the HTML chunk.quietly
9670 • The text of cross-references to first-level refentry (refsect1, top-level
9671 refsection, refnamediv, and refsynopsisdiv) are now capitalized.
9673 • Cross-references to refnamediv now use the localized NAME title instead of
9674 using the first refname child. This makes the output inconsistent with HTML
9675 and FO output, but for man-page output, it seems to make better sense to
9676 have the NAME. (It may actually make better sense to do it that way in HTML
9677 and FO output as well...)
9679 • Added support for processing funcparams.
9681 • Removed the space that was being output between funcdef and paramdef;
9682 example: was: float rand (void); now: float rand(void)
9684 • Turned off bold formatting for the type element when it occurs within a
9687 • Corrected rendering of simplelist. Any <simplelist type="inline" instance
9688 is now rendered as a comma-separated list (also with an optional localized
9689 “and” or “or” before the last item -- see description elsewhere in these
9690 release notes). Any simplelist instance whose type is not inline is
9691 rendered as a one-column vertical list (ignoring the values of the type and
9692 columns attributes if present)
9694 • Comment added at top of roff source for each page now includes DocBook XSL
9695 stylesheets version number (as in the HTML stylesheets)
9697 • Made change to prevent “sticky” fonts changes. Now, when the manpages
9698 stylesheets encounter node sets that need to be boldfaced or italicized,
9699 they put the \fBfoo\fR and \fIbar\fR groff bold/italic instructions
9700 separately around each node in the set.
9702 • synop.xsl: Boldface everything in funcsynopsis output except parameters
9703 (which are in ital). The man(7) man page says:
9705 For functions, the arguments are always specified using italics, even
9706 in the SYNOPSIS section, where the rest of the function is specified in
9709 A look through the contents of the man/man2 directory shows that most (all)
9710 existing pages do follow this “everything in funcsynopsis bold” rule. That
9711 means the type content and any punctuation (parens, semicolons, varargs)
9712 also must be bolded.
9714 • Removed code for adding backslashes before periods/dots in roff source,
9715 because backslashes in front of periods/dots in roff source are needed only
9716 in the very rare case where a period is the very first character in a line,
9717 without any space in front of it. A better way to deal with that rare case
9718 is for you to add a zero-width space in front of the offending dot(s) in
9721 • Removed special handling of the quote element. That was hard-coded to cause
9722 anything marked up with the quote element to be output preceded by two
9723 backticks and followed by two apostrophes -- that is, that old-school
9724 kludge for generating “curly” quotes in Emacs and in X-Windows fonts. While
9725 Emacs still seems to support that, I don't think X-Windows has for a long
9726 time now. And, anyway, it looks (and has always looked) like crap when
9727 viewed on a normal tty/console. In addition, it breaks localiztion of quote
9728 . By default, quote content is output with localized quotation marks,
9729 which, depending on the locale, may or may not be left and right double
9732 • Changed mappings for left and right single quotation marks. Those had
9733 previously been incorrectly mapped to the backtick (`) and apostrophe
9734 (&39;) characters (for kludgy reasons -- see above). They are now correctly
9735 mapped to the \(oq and \(cq roff escapes. If you want the old (broken)
9736 behavior, you need to manually change the mappings for those in the value
9737 of the man.string.subst.map parameter.
9739 • Removed xref.xsl file. Now, of the various cross-reference elements, only
9740 the ulink element is handled differently; the rest are handled exactly as
9741 the HTML stylesheets handle them, except that no hypertext links are
9742 generated. (Because there is no equivalent hypertext mechanism is man
9745 • New option for making “subheading dividers” in generated roff source. The
9746 dividers are not visible in the rendered man page; they are just there to
9747 make the source readable. Controlled using man.subheading.divider.
9749 • Fixed many places where too much space was being added between lines.
9753 The release adds localization support for Farsi (thanks to Sina Heshmati) and
9754 improved support for the XLink-based DocBook NG db:link element. Other than
9755 that, it is a minor bug-fix update to the 1.68.0 release. The main thing it
9756 fixes is a build error that caused the XSLT Java extensions to be jarred up
9757 with the wrong package structure. Thanks to Jens Stavnstrup for quickly
9758 reporting the problem, and to Mauritz Jeanson for investigating and finding the
9763 This release includes some features changes, particularly for FO/PDF output,
9764 and a number of bug fixes.
9768 • Moved footnote properties to attribute-sets.
9770 • Added support for side floats, margin notes, and custom floats.
9772 • Added new parameters body.start.indent and body.end.indent to the
9773 set.flow.properties template.
9775 • Added support for xml:id
9777 • Added support for refdescriptor.
9779 • Added support for multiple refnamedivs.
9781 • Added index.entry.properties attribute-set to support customization of
9784 • Added set.flow.properties template call to each fo:flow to support
9785 customizations entry point.
9787 • Add support for @floatstyle in figure
9789 • Moved hardcoded properties for index division titles to the
9790 index.div.title.properties attribute-set.
9792 • Added support for table-layout="auto" for XEP.
9794 • Added index.div.title.properties attribute-set.
9796 • $verbose parameter is now passed to most elements.
9798 • Added refentry to toc in part, as it is permitted by the DocBook schema/
9801 • Added backmatter elements and article to toc in part, since they are
9802 permitted by the DocBook schema/DTD.
9804 • Added mode="toc" for simplesect, since it is now permitted in the toc if
9805 simplesect.in.toc is set.
9807 • Moved hard-coded properties to nongraphical.admonintion.properties and
9808 graphical.admonition.properties attribute sets.
9810 • Added support for sidebar-width and float-type processing instructions in
9813 • For tables with HTML markup elements, added support for dbfo bgcolor PI,
9814 the attribute-sets named table.properties, informaltable.properties,
9815 table.table.properties, and table.cell.padding. Also added support for the
9816 templates named table.cell.properties and table.cell.block.properties so
9817 that tabstyles can be implemented. Also added support for tables containing
9818 only tr instead of tbody with tr.
9820 • Added new paramater hyphenate.verbatim.characters which can specify
9821 characters after which a line break can occur in verbatim environments.
9822 This parameter can be used to extend the initial set of characters which
9823 contain only space and non-breakable space.
9825 • Added itemizedlist.label.markup to enable selection of different bullet
9826 symbol. Also added several potential bullet characters, commented out by
9829 • Enabled all id's in XEP output for external olinking.
9833 • Added support for refdescriptor.
9835 • Added support for multiple refnamedivs.
9837 • Added support for xml:id
9839 • refsynopsisdiv as a section for counting section levels
9843 • Added new SVG admonition graphics and navigation images.
9847 This release fixes a table bug introduced in the 1.67.1 release.
9851 This release includes a number of bug fixes.
9853 The following lists provide details about API and feature changes.
9857 • Tables: Inherited cell properties are now passed to the
9858 table.cell.properties template so they can be overridden by a
9861 • Tables: Added support for bgcolor PI on table row element.
9863 • TOCs: Added new parameter simplesect.in.toc; default value of 0 causes
9864 simplesect to be omitted from TOCs; to cause simplesect to be included in
9865 TOCs, you must set the value of simplesect.in.toc to 1.Comment from Norm:
9867 Simplesect elements aren't supposed to appear in the ToC at all... The
9868 use case for simplesect is when, for example, every chapter in a book
9869 ends with "Exercises" or "For More Information" sections and you don't
9870 want those to appear in the ToC.
9872 • Sections: Reverted change that caused a variable reference to be used in a
9873 template match and rewrote code to preserve intended semantics.
9875 • Lists: Added workaround to prevent "* 0.60 + 1em" garbage in list output
9878 • Moved the literal attributes from component.title to the
9879 component.title.properties attribute-set so they can be customized.
9881 • Lists: Added glossdef's first para to special handling in
9886 • TOCs: Added new parameter simplesect.in.toc; for details, see the list of
9887 FO changes for this release.
9889 • Indexing: Added new parameter index.prefer.titleabbrev; when set to 1,
9890 index references will use titleabbrev instead of title when available.
9894 • Added support for generating windows-1252-encoded output using Saxon; for
9895 more details, see the list of XSL Java extensions changes for this release.
9899 • Replaced named/numeric character-entity references for non-breaking space
9900 with groff equivalent (backslash-tilde).
9904 • Saxon extensions: Added the Windows1252 class. It extends Saxon 6.5.x with
9905 the windows-1252 character set, which is particularly useful when
9906 generating HTML Help for Western European Languages (code from Pontus
9907 Haglund and contributed to the DocBook community by Sectra AB, Sweden).
9911 1. Make sure that the Saxon 6.5.x jar file and the jar file for the
9912 DocBook XSL Java extensions are in your CLASSPATH
9914 2. Create a DocBook XSL customization layer -- a file named
9915 mystylesheet.xsl or whatever -- that, at a minimum, contains the
9919 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
9921 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/>
9922 <xsl:output method="html" encoding="WINDOWS-1252" indent="no"/>
9923 <xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"></xsl:param>
9924 <xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"></xsl:param>
9925 <xsl:param name="saxon.character.representation" select="'native'"></xsl:param>
9928 Invoke Saxon with the encoding.windows-1252 Java system property set to
9929 com.nwalsh.saxon.Windows1252; for example
9932 -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
9933 com.icl.saxon.StyleSheet \
9934 mydoc.xml mystylesheet.xsl
9936 Or, for a more complete "real world" case showing other options you'll
9937 typically want to use:
9940 -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
9941 -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \
9942 -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \
9943 -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \
9944 com.icl.saxon.StyleSheet \
9945 -x org.apache.xml.resolver.tools.ResolvingXMLReader \
9946 -y org.apache.xml.resolver.tools.ResolvingXMLReader \
9947 -r org.apache.xml.resolver.tools.CatalogResolver \
9948 mydoc.xml mystylesheet.xsl
9950 In both cases, the "mystylesheet.xsl" file should be a DocBook
9951 customization layer containing the parameters show in step 2.
9953 • Saxon extensions: Removed Saxon 8 extensions from release package
9957 • A number of important bug fixes.
9959 • Added Saxon8 extensions
9961 • Enabled dbfo table-width on entrytbl in FO output
9963 • Added support for role=strong on emphasis in FO output
9965 • Added new FO parameter hyphenate.verbatim that can be used to turn on
9966 "intelligent" wrapping of verbatim environments.
9968 • Replaced all <tt></tt> output with <code></code>
9970 • Changed admon.graphic.width template to a mode so that different
9971 admonitions can have different graphical widths.
9973 • Deprecated the HTML shade.verbatim parameter (use CSS instead)
9975 • Wrapped ToC refentrytitle/refname and refpurpose in span with class values.
9976 This makes it possible to style them using a CSS stylesheet.
9978 • Use strong/em instead of b/i in HTML output
9980 • Added support for converting Emphasis to groff italic and Emphasis role=
9981 'bold' to bold. Controlled by emphasis.propagates.style param, but not
9982 documented yet using litprog system. Will do that next (planning to add
9983 some other parameter-controllable options for hyphenation and handling of
9986 • callout.graphics.number.limit.xml param: Changed the default from 10 to 15.
9988 • verbatim.properties: Added hyphenate=false
9990 • Saxon and Xalan Text.java extensions: Added support for URIResolver() on
9993 • Added generated RELEASE-NOTES.txt file.
9995 • Added INSTALL file (executable file for generating catalog.xml)
9997 • Removed obsolete tools directory from package
10001 • A number of important bug fixes.
10003 • Now xml:base attributes that are generated by an XInclude processor are
10004 resolved for image files.
10006 • Rewrote olink templates to support several new features.
10008 □ Extended full olink support to FO output.
10010 □ Add support for xrefstyle attribute in olinks.
10012 □ New parameters to support new olink features: insert.olink.page.number,
10013 insert.olink.pdf.frag, olink.debug, olink.lang.fallback.sequence,
10014 olink.properties, prefer.internal.olink. See the reference page for
10015 each parameter for more information.
10017 • Added index.on.type parameter for new type attribute introduced in DocBook
10018 4.3 for indexterms and index. This allows you to create multiple indices
10019 containing different categories of entries. For users of 4.2 and earlier,
10020 you can use the new parameter index.on.role instead.
10022 • Added new section.autolabel.max.depth parameter to turn off section
10023 numbering below a certain depth. This permits you to number major section
10024 levels and leave minor section levels unnumbered.
10026 • Added footnote.sep.leader.properties attribute set to format the line
10027 separating footnotes in printed output.
10029 • Added parameter img.src.path as a prefix to HTML img src attributes. The
10030 prefix is added to whatever path is already generated by the stylesheet for
10033 • Added new attribute-sets informalequation.properties,
10034 informalexample.properties, informalfigure.properties, and
10035 informaltable.properties, so each such element type can be formatted
10036 individually if needed.
10038 • Add component.label.includes.part.label parameter to add any part number to
10039 chapter, appendix and other component labels when the label.from.part
10040 parameter is nonzero. This permits you to distinguish multiple chapters
10041 with the same chapter number in cross references and the TOC.
10043 • Added chunk.separate.lots parameter for HTML output. This parameter lets
10044 you generate separate chunk files for each LOT (list of tables, list of
10047 • Added several table features:
10049 □ Added table.table.properties attribute set to add properties to the
10052 □ Added placeholder templates named table.cell.properties and
10053 table.cell.block.properties to enable adding properties to any
10054 fo:table-cell or the cell's fo:block, respectively. These templates are
10055 a start for implementing table styles.
10057 • Added new attribute set component.title.properties for easy modifications
10058 of component's title formatting in FO output.
10060 • Added Saxon support for an encoding attribute on the textdata element.
10061 Added new parameter textdata.default.encoding which specifies encoding when
10062 encoding attribute on textdata is missing.
10064 • Template label.this.section now controls whole section label, not only
10065 sub-label which corresponds to particular label. Former behaviour was IMHO
10066 bug as it was not usable.
10068 • Formatting in titleabbrev for TOC and headers is preserved when there are
10069 no hotlink elements in the title. Formerly the title showed only the text
10070 of the title, no font changes or other markup.
10072 • Added intial.page.number template to set the initial-page-number property
10073 for page sequences in print output. Customizing this template lets you
10074 change when page numbering restarts. This is similar to the
10075 format.page.number template that lets you change how the page number
10076 formatting changes in the output.
10078 • Added force.page.count template to set the force-page-count property for
10079 page sequences in print output. This is similar to the format.page.number
10082 • Sort language for localized index sorting in autoidx-ng.xsl is now taken
10083 from document lang, not from system environment.
10085 • Numbering and formatting of normal and ulink footnotes (if turned on) has
10086 been unified. Now ulink footnotes are mixed in with any other footnotes.
10088 • Added support for renderas attribute in section and sect1 et al. This
10089 permits you to render a given section title as if it were a different
10092 • Added support for label attribute in footnote to manually supply the
10095 • Added support for DocBook 4.3 corpcredit element.
10097 • Added support for a dbfo keep-together PI for formal objects (table,
10098 figure, example, equation, programlisting). That permits a formal object to
10099 be kept together if it is not already, or to be broken if it is very long
10100 and the default keep-together is not appropriate.
10102 • For graphics files, made file extension matching case insensitive, and
10103 updated the list of graphics extensions.
10105 • Allow calloutlist to have block content before the first callout
10107 • Added dbfo-need processing instruction to provide soft page breaks.
10109 • Added implementation of existing but unused default.image.width parameter
10112 • Support DocBook NG tag inline element.
10114 • It appears that XEP now supports Unicode characters in bookmarks. There is
10115 no further need to strip accents from characters.
10117 • Make segmentedlist HTML markup more semantic and available to CSS styles.
10119 • Added user.preroot placeholder template to permit xsl-stylesheet and other
10120 PIs and comments to be output before the HTML root element.
10122 • Non-chunked legalnotice now gets an <a name="id"> element in HTML output so
10123 it can be referenced with xref or link.
10125 • In chunked HTML output, changed link rel="home" to rel="start", and link
10126 rel="previous" to rel="prev", per W3C HTML 4.01 spec.
10128 • Added several patches to htmlhelp from W. Borgert
10130 • Added Bosnian locale file as common/bs.xml.
10134 • A number of important bug fixes.
10136 • Added a workaround to allow these stylesheets to process DocBook NG
10137 documents. (It’s a hack that pre-processes the document to strip off the
10138 namespace and then uses exsl:node-set to process the result.)
10140 • Added alternative indexing mechanism which has better internationalization
10141 support. New indexing method allows grouping of accented letters like e, é,
10142 ë into the same group under letter "e". It can also treat special letters
10143 (e.g. "ch") as one character and place them in the correct position (e.g.
10144 between "h" and "i" in Czech language).
10146 In order to use this mechanism you must create customization layer which
10147 imports some base stylesheet (like fo/docbook.xsl, html/chunk.xsl) and then
10148 includes appropriate stylesheet with new indexing code (fo/autoidx-ng.xsl
10149 or html/autoidx-ng.xsl). For example:
10151 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
10154 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/>
10155 <xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/>
10159 New method is known to work with Saxon and it should also work with
10160 xsltproc 1.1.1 and later. Currently supported languages are English, Czech,
10161 German, French, Spanish and Danish.
10165 General bug fixes and improvements. Sorry about the failure to produce an
10166 updated release notes file for 1.62.0—1.63.2
10168 • In the course of fixing bug #849787, wrapping Unicode callouts with an
10169 appropriate font change in the Xalan extensions, I discovered that the
10170 Xalan APIs have changed a bit. So xalan2.jar will work with older Xalan 2
10171 implementations, xalan25.jar works with Xalan 2.5.
10175 Lots of bug fixes and improvements.
10177 • Initial support for timestamp PI. From now you can use <?dbtimestamp format
10178 ="Y-m-d H:M:S"?> to get current datetime in your document. Added
10179 localization support for datetime PI
10181 • Added level 6 to test for section depth in section.level template so that
10182 section.title.level6.properties will be used for sections that are 6 deep
10183 or deeper. This should also cause a h6 to be created in html output.
10185 • Don't use SVG graphics if use.svg=0
10187 • Now uses number-and-title-template for sections only if section.autolabel
10190 • Added missing 'english-language-name' attribute to the l10n element, and
10191 the missing 'style' attribute to the template element so the current
10192 gentext documents will validate.
10194 • Corrected several references to parameter qanda.defaultlabel that were
10197 • Now accepts admon.textlabel parameter to turn off Note, Warning, etc.
10200 • FeatReq #684561: support more XEP metadata
10202 • Added hyphenation support. Added support for coref. Added beginpage
10203 support. (does nothing; see TDG).
10205 • Added support for hyphenation-character, hyphenation-push-character-count,
10206 and hyphenation-remain-character-count
10208 • Added root.properties, ebnf.assignment, and ebnf.statement.terminator
10210 • Support bgcolor PI in table cells; make sure rowsep and colsep don't have
10211 any effect on the last row or column
10213 • Handle othercredit on titlepage a little better
10215 • Applied fix from Jeff Beal that fixed the bug that put secondary page
10216 numbers on primary entries. Same with tertiary page numbers on secondary
10219 • Added definition of missing variable collection.
10221 • Make footnote formatting 'normal' even when it occurs in a context that has
10224 • Added warning when glossary.collection is not blank, but it cannot open the
10227 • Pick up the frame attribute on table and informaltable.
10229 • indexdiv/title in non-autogenerated indexes are now picked up.
10231 • Removed (unused) component.title.properties
10233 • Move IDs from page-sequences down to titlepage blocks
10235 • Use proportional-column-width(1) on more tables.
10237 Use proportional-column-width() for header/footer tables; suppress
10238 relative-align when when using FOP
10240 • Check for glossterm.auto.link when linking firstterms; don't output gl.
10241 prefix on glossterm links
10243 • Generate Part ToCs
10245 • Support glossary, bibliography, and index in component ToCs.
10247 • Refactored chunking code so that customization of chunk algorithm and chunk
10248 elements is more practical
10250 • Support textobject/phrase on inlinemediaobject.
10252 • Support 'start' PI on ordered lists
10254 • Fixed test of $toc PI to turn on qandaset TOC.
10256 • Added process.chunk.footnotes to sect2 through 5 to fix bug of missing
10257 footnotes when chunk level greater than 1.
10259 • Added paramater toc.max.depth which controls maximal depth of ToC as
10260 requested by PHP-DOC group.
10262 • Exempted titleabbrev from preamble processing in lists, and fixed
10263 variablelist preamble code to use the same syntax as the other lists.
10265 • Added support for elements between variablelist and first varlistentry
10266 since DocBook 4.2 supports that now.
10272 • The format of the titlepage.templates.xml files and the stylesheet that
10273 transforms them have been significantly changed. All of the attributes used
10274 to control the templates are now namespace qualified. So what used to be:
10276 <t:titlepage element="article" wrapper="fo:block">
10280 <t:titlepage t:element="article" t:wrapper="fo:block">
10282 Attributes from other namespaces (including those that are unqualified) are
10283 now copied directly through. In practice, this means that the names that
10284 used to be “fo:” qualified:
10286 <title named-template="component.title"
10287 param:node="ancestor-or-self::article[1]"
10288 fo:text-align="center"
10289 fo:keep-with-next="always"
10290 fo:font-size="&hsize5;"
10291 fo:font-weight="bold"
10292 fo:font-family="{$title.font.family}"/>
10294 are now unqualified:
10296 <title t:named-template="component.title"
10297 param:node="ancestor-or-self::article[1]"
10298 text-align="center"
10299 keep-with-next="always"
10300 font-size="&hsize5;"
10302 font-family="{$title.font.family}"/>
10304 The t:titlepage and t:titlepage-content elements both generate wrappers
10305 now. And unqualified attributes on those elements are passed through. This
10306 means that you can now make the title font apply to ane entire titlepage
10307 and make the entire “recto” titlepage centered by specifying the font and
10308 alignment on the those elements:
10310 <t:titlepage t:element="article" t:wrapper="fo:block"
10311 font-family="{$title.font.family}">
10313 <t:titlepage-content t:side="recto"
10314 text-align="center">
10316 • Support use of titleabbrev in running headers and footers.
10318 • Added (experimental) xref.with.number.and.title parameter to enable number/
10319 title cross references even when the default would be just the number.
10321 • Generate part ToCs if they're requested.
10323 • Use proportional-column-width() in header/footer tables.
10325 • Handle alignment correctly when screenshot wraps a graphic in a figure.
10327 • Format chapter and appendix cross references consistently.
10329 • Attempt to support tables with multiple tgroups in FO.
10331 • Output fo:table-columns in simplelist tables.
10333 • Use titlepage.templates.xml for indexdiv and glossdiv formatting.
10335 • Improve support for new bibliography elements.
10337 • Added footnote.number.format, table.footnote.number.format,
10338 footnote.number.symbols, and table.footnote.number.symbols for better
10339 control of footnote markers.
10341 • Added glossentry.show.acronyms.
10343 • Suppress the draft-mode page masters when draft-mode is “no”.
10345 • Make blank pages verso not recto. D'Oh!
10347 • Improved formatting of ulink footnotes.
10349 • Fixed bugs in graphic width/height calculations.
10351 • Added class attributes to inline elements.
10353 • Don't add “.html” to the filenames identified with the “dbhtml” PI.
10355 • Don't force a ToC when sections contain refentrys.
10357 • Make section title sizes a function of the body.master.size.
10361 The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail.
10363 • Removed the region-name from the region-body of blank pages. There's no
10364 reason to give the body of blank pages a unique name and doing so causes a
10365 mismatch that FOP detects.
10367 • Output IDs for the first paragraphs in listitems.
10369 • Fixed some small bugs in the handling of page numbers in double-sided mode.
10371 • Attempt to prevent duplicated IDs from being produced when endterm on xref
10372 points to something with nested structure.
10374 • Fix aligment problems in equations.
10376 • Output the type attribute on unordered lists (UL) in HTML only if the
10377 css.decoration parameter is true.
10379 • Calculate the font size in formal.title.properties so that it's 1.2 times
10380 the base font size, not a fixed "12pt".
10384 The 1.59.1 fixes a few bugs.
10386 • Added Bulgarian localization.
10388 • Indexing improvements; localize book indexes to books but allow setindex to
10389 index an entire set.
10391 • The default value for rowsep and colsep is now "1" as per CALS.
10393 • Added support for titleabbrev (use them for cross references).
10395 • Improvements to mediaobject for selecting print vs. online images.
10397 • Added seperate property sets for figures, examples, equations, tabless, and
10400 • Make lineannotations italic.
10402 • Support xrefstyle attribute.
10404 • Make endterm on xref higher priority than xreflabel target.
10406 • Glossary formatting improvements.
10410 The 1.58.0 adds some initial support for extensions in xsltproc, adds a few
10411 features, and fixes bugs.
10413 • This release contains the first attempt at extension support for xsltproc.
10414 The only extension available to date is the one that adjusts table column
10415 widths. Run extensions/xsltproc/python/xslt.py.
10417 • Fixed bugs in calculation of adjusted column widths to correct for rounding
10420 • Support nested refsection elements correctly.
10422 • Reworked gentext.template to take context into consideration. The name of
10423 elements in localization files is now an xpath-like context list, not just
10426 • Made some improvements to bibliography formatting.
10428 • Improved graphical formatting of admonitions.
10430 • Added support for entrytbl.
10432 • Support spanning index terms.
10434 • Support bibliosource.
10438 • The 1.57.0 release wasn't documented here. Oops.
10442 The 1.56.0 release fixes bugs.
10444 • Reworked chunking. This will break all existing customizations layers that
10445 change the chunking algorithm. If you're customizing chunking, look at the
10446 new “content” parameter that's passed to process-chunk-element and friends.
10448 • Support continued and inherited numeration in orderedlist formatting for
10451 • Added Thai localization.
10453 • Tweaked stylesheet documentation stylesheets to link to TDG and the
10454 parameter references.
10456 • Allow title on tables of contents ("Table of Contents") to be optional.
10457 Added new keyword to generate.toc. Support tables of contents on sections.
10459 • Made separate parameters for table borders and table cell borders:
10460 table.frame.border.color, table.frame.border.style,
10461 table.frame.border.thickness, table.cell.border.color,
10462 table.cell.border.style, and table.cell.border.thickness.
10464 • Suppress formatting of “endofrange” indexterms. This is only half-right.
10465 They should generate a range, but I haven't figured out how to do that yet.
10467 • Support revdescription. (Bug #582192)
10469 • Added default.float.class and fixed figure floats. (Bug #497603)
10471 • Fixed formatting of sbr in FOs.
10473 • Added context to the “missing template” error message.
10475 • Process arg correctly in a group. (Bug #605150)
10477 • Removed 'keep-with-next' from formal.title.properties attribute set now
10478 that the stylesheets support the option of putting such titles below the
10479 object. Now the $placement value determines if 'keep-with-next' or
10480 'keep-with-previous' is used in the title block.
10482 • Wrap “url()” around external-destinations when appropriate.
10484 • Fixed typo in compact list spacing. (Bug #615464)
10486 • Removed spurious hash in anchor name. (Bug #617717)
10488 • Address is now displayed verbatim on title pages. (Bug #618600)
10490 • The bridgehead.in.toc parameter is now properly supported.
10492 • Improved effectiveness of HTML cleanup by increasing the number of places
10493 where it is used. Improve use of HTML cleanup in XHTML stylesheets.
10495 • Support table of contents for appendix in article. (Bug #596599)
10497 • Don't duplicate footnotes in bibliographys and glossarys. (Bug #583282)
10499 • Added default.image.width. (Bug #516859)
10501 • Totally reworked funcsynopsis code; it now supports a 'tabular'
10502 presentation style for 'wide' prototypes; see
10503 funcsynopsis.tabular.threshold. (HTML only right now, I think, FO support,
10504 uh, real soon now.)
10506 • Reworked support for difference marking; toned down the colors a bit and
10507 added a “system.head.content” template so that the diff CSS wasn't
10508 overriding “user.head.content”. (Bug #610660)
10510 • Added call to the “*.head.content” elements when writing out long
10511 description chunks.
10513 • Make sure legalnotice link is correct even when chunking to a different
10516 • Use CSS to set viewport characteristics if css.decoration is non-zero, use
10517 div instead of p for making graphic a block element; make figure titles the
10518 default alt text for images in a figure.
10520 • Added space-after to list.block.spacing.
10522 • Reworked section.level template to give “correct” answer instead of being
10525 • When processing tables, use the tabstyle attribute as the division class.
10527 • Fixed bug in html2xhtml.xsl that was causing the XHTML chunker to output
10528 HTML instead of XHTML.
10532 To view the release notes for older releases, see http://cvs.sourceforge.net/
10533 viewcvs.py/docbook/xsl/RELEASE-NOTES.xml. Be aware that there were no release
10534 notes for releases prior to the 1.50.0 release.
10536 About dot-zero releases
10538 DocBook Project “dot zero” releases should be considered experimental and are
10539 always followed by stable “dot one plus” releases, usually within two or three
10540 weeks. Please help to ensure the stability of “dot one plus” releases by
10541 carefully testing each “dot zero” release and reporting back about any problems
10544 It is not recommended that you use a “dot zero” release in a production system.
10545 Instead, you should wait for the “dot one” or greater versions.