b4f136015a97f37dba7c2beed5401c1485310cf6
[platform/upstream/docbook-xsl-stylesheets.git] / RELEASE-NOTES.txt
1 Release Notes for the DocBook XSL Stylesheets
2
3 $Revision: 10004 $ $Date: 2015-10-15 21:10:53 +0000 (Thu, 15 Oct 2015) $
4
5 2015-10-15
6
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
14 of the codebase.
15
16 As with all DocBook Project dot-zero releases, this is a candidate release for
17 testing by the DocBook community. It will be followed shortly by a stable
18 release.
19
20 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
21
22 Table of Contents
23
24 Release Notes: 1.79.0
25
26     Gentext
27     Common
28     FO
29     HTML
30     Manpages
31     Epub
32     HTMLHelp
33     Eclipse
34     JavaHelp
35     Slides
36     Website
37     Webhelp
38     Params
39     Profiling
40     Lib
41     Tools
42     Template
43     Extensions
44
45 Release Notes: 1.78.1
46
47     Common
48     FO
49     HTML
50     Manpages
51     Webhelp
52     Params
53     Highlighting
54
55 Release Notes: 1.78.0
56
57     Gentext
58     Common
59     FO
60     HTML
61     Manpages
62     Roundtrip
63     Slides
64     Webhelp
65     Params
66     Profiling
67     Tools
68     Template
69
70 Release Notes: 1.77.1
71
72     Gentext
73     Common
74     FO
75     HTML
76     Epub
77     HTMLHelp
78     Eclipse
79     JavaHelp
80     Webhelp
81     Params
82     Highlighting
83     Profiling
84     Lib
85     Template
86     Extensions
87     XSL-Saxon
88
89 Release Notes: 1.77.1
90
91     FO
92     HTML
93     Roundtrip
94     Slides
95     Website
96     Webhelp
97
98 Release Notes: 1.76.1
99
100     FO
101     HTML
102     Params
103
104 Release Notes: 1.76.0
105
106     Gentext
107     Common
108     FO
109     HTML
110     Manpages
111     Epub
112     Eclipse
113     Params
114     XSL-Xalan
115
116 Release Notes: 1.75.2
117
118     Gentext
119     Common
120     FO
121     HTML
122     Manpages
123     Epub
124     Profiling
125     XSL-Saxon
126     XSL-Xalan
127
128 Release Notes: 1.75.1
129
130     FO
131     HTML
132     Epub
133     Params
134
135 Release Notes: 1.75.0
136
137     Gentext
138     Common
139     FO
140     HTML
141     Manpages
142     ePub
143     HTMLHelp
144     Params
145     Highlighting
146     XSL-Saxon
147     XSL-Xalan
148
149 Release Notes: 1.74.3
150 Release Notes: 1.74.2
151 Release Notes: 1.74.1
152
153     Gentext
154     FO
155     HTML
156     Manpages
157     ePub
158     Roundtrip
159     Params
160     Highlighting
161
162 Release Notes: 1.74.0
163
164     Gentext
165     Common
166     FO
167     HTML
168     Manpages
169     Epub
170     HTMLHelp
171     Eclipse
172     JavaHelp
173     Roundtrip
174     Slides
175     Website
176     Params
177     Profiling
178     Tools
179     Extensions
180     XSL-Saxon
181     XSL-Xalan
182     XSL-libxslt
183
184 Release Notes: 1.73.2
185 Release: 1.73.1
186
187     Gentext
188     FO
189     HTML
190     Manpages
191     HTMLHelp
192     Eclipse
193     JavaHelp
194     Roundtrip
195     Params
196
197 Release: 1.73.0
198
199     Gentext
200     Common
201     FO
202     HTML
203     Manpages
204     Eclipse
205     JavaHelp
206     Roundtrip
207     Params
208     Highlighting
209     Profiling
210     Lib
211     Tools
212     XSL-Saxon
213     XSL-Xalan
214
215 Release: 1.72.0
216
217     Common
218     FO
219     HTML
220     Manpages
221     Params
222     Template
223     Roundtrip
224
225 Release: 1.71.1
226
227     Common
228     FO
229     HTML
230     Highlighting
231     Manpages
232     Params
233     Profiling
234
235 Release: 1.71.0
236
237     Common
238     Extensions
239     FO
240     HTML
241     Highlighting
242     Manpages
243     Params
244     Tools
245
246 Release: 1.70.1
247
248     FO
249     HTML
250     HTMLHelp
251     Params
252
253 Release: 1.70.0
254
255     Common
256     Extensions
257     FO
258     HTML
259     Manpages
260     Params
261     Profiling
262     Tools
263     WordML
264
265 Release 1.69.1
266 Release 1.69.0
267
268     Common
269     FO
270     Help
271     HTML
272     man
273
274 Release 1.68.1
275 Release 1.68.0
276 Release 1.67.2
277 Release 1.67.1
278 Release 1.67.0
279 Release 1.66.1
280 Release 1.65.0
281 Release 1.64.1
282 Release 1.61.0
283 Release 1.60.1
284 Release 1.59.2
285 Release 1.59.1
286 Release 1.58.0
287 Release 1.57.0
288 Release 1.56.0
289 Older releases
290 About dot-zero releases
291
292 Release Notes: 1.79.0
293
294 The following is a list of changes that have been made since the 1.78.1
295 release.
296
297 Gentext
298
299 The following changes have been made to the gentext code since the 1.78.1
300 release.
301
302   • Dongsheng Song: locale/zh.xml; locale/zh_cn.xml
303
304     Fix Auditlocale.pl warning.
305
306   • Robert Stayton: locale/en.xml
307
308     Add elements dialogue, drama, and poetry from DocBook Publishers.
309
310   • Robert Stayton: locale/pt.xml
311
312     updates from DocBook user.
313
314   • Robert Stayton: locale/en.xml
315
316     Fix wording.
317
318   • Robert Stayton: locale/en.xml
319
320     Fix line breaks.
321
322   • Robert Stayton: locale/en.xml
323
324     Add text message for unsupported video and audio.
325
326   • Jirka Kosek: xsl/xsl-primary-is-locale.xsl
327
328     Initial work on Ant build, common (L10N) directory handled so far
329
330   • Robert Stayton: locale/ur.xml
331
332     Add email address for contributor.
333
334   • Robert Stayton: locale/ur.xml
335
336     Check in contributed locale file from Wasif Hasan Baig,
337     contributed through SourceForge Patch # 187.
338
339   • kasunbg: locale/nl.xml
340
341     Committing Dutch translations of DocBook WebHelp. Patch provided by Marja van Waes.
342
343   • kasunbg: locale/ru.xml
344
345     Committing patch for Russian translations of webhelp. Patch provided by Alex Loginov and Yuri Chornoivan. Patch #1325
346
347   • kasunbg: locale/uk.xml
348
349     Committing Ukrainian translations for Webhelp. Patch by Yuri Chornoivan. Patch #1324
350
351   • tom_schr: locale/ca.xml; locale/da.xml; locale/cs.xml; locale/es.xml;
352     locale/fr.xml; local⋯
353
354     Added missing keycap context for ca, cs, da, es, et, eu, and fr
355
356   • tom_schr: locale/en.xml; locale/de.xml
357
358     Added option key for keycap context
359
360   • tom_schr: locale/de.xml
361
362     Added key="optional-step" as done in r9745
363
364   • Robert Stayton: locale/en.xml
365
366     Add key="optional-step".
367
368 Common
369
370 The following changes have been made to the common code since the 1.78.1
371 release.
372
373   • tom_schr: common.xsl
374
375     Added quotes around linkend to make spaces visible
376
377   • Jirka Kosek: build.xml
378
379     Added ant build for HTML stylesheets
380
381   • Jirka Kosek: build.xml
382
383     Initial work on Ant build, common (L10N) directory handled so far
384
385   • Robert Stayton: titles.xsl
386
387     Replace hardcoded English text for question and answer elements
388     in mode="title.markup" with localized templates.
389
390   • Robert Stayton: addns.xsl
391
392     Move addns.xsl module from releasetools to common in preparation
393     for switching to ns as the base stylesheets.
394
395   • Robert Stayton: l10n.xml; Makefile
396
397     Add new locale file ur.xml for Urdu.
398
399   • Robert Stayton: titles.xsl
400
401     Add missing template with match="toc" mode="title.markup".
402
403   • tom_schr: titles.xsl
404
405     Fixed problem when referencing empty ulinks; use @url instead
406
407   • stilor: olink.xsl
408
409     Make olink errors/warnings overridable in customizations.
410
411   • stilor: labels.xsl
412
413     Pass the object referenced as a parameter to mode="intralabel.punctuation"
414     template.
415
416   • stilor: olink.xsl
417
418     1. Make page citations on <xref/> to paragraphs conditional on a new parameter,
419     $insert.xref.page.number.para, default to 'yes' (before, page citations were
420     added unconditionally). Remove similar special-casing for <link/>.
421
422     2. Disable page citations for @xrefstyle="template:..." (if needed, they
423     can be added with %p in the template - but they can't be disabled).
424
425   • Robert Stayton: olink.xsl; titles.xsl; common.xsl
426
427     Pass referrer and target params to mode="xrefstyle" to allow customizations
428     to be more specific.
429
430   • Robert Stayton: olink.xsl; titles.xsl; common.xsl
431
432     Add mode="xrefstyle" to replace many instances of redundant
433     code determining the xrefstyle with xsl:apply-templates
434     select="." mode="xrefstyle".  Also allows stylesheet
435     customization to specify an xrefstyle per element type.
436
437   • Robert Stayton: gentext.xsl; labels.xsl
438
439     Add support for procedure title contained in info or blockinfo.
440
441   • Robert Stayton: common.xsl
442
443     In person.name template, change 'style' variable to a param
444     so the name style can be selected by passing a param.
445
446   • Robert Stayton: gentext.xsl
447
448     Fix bug in collect.xref.targets that failed when $referrer template
449     param not set by olink's xref-to. Fixed using submitted patch.
450
451 FO
452
453 The following changes have been made to the fo code since the 1.78.1 release.
454
455   • Robert Stayton: lists.xsl
456
457     Fix bug #1368 "link to term with id does not work"
458
459   • Robert Stayton: block.xsl
460
461     Fix bug #1367 double attribution in epigraph.
462
463   • Robert Stayton: param.xweb; param.ent
464
465     Add missing profile.outputformat param.
466
467   • Robert Stayton: publishers.xsl
468
469     Fix namespace declarations.
470
471   • Robert Stayton: titlepage.xsl
472
473     Add default attribute-sets for new Publishers elements.
474
475   • Robert Stayton: param.ent
476
477     Fix typo
478
479   • Robert Stayton: titlepage.templates.xml
480
481     Add new DocBook Publishers elements.
482
483   • Robert Stayton: docbook.xsl
484
485     Add inclusion of new publishers.xsl module.
486
487   • Robert Stayton: publishers.xsl
488
489     Stylesheet module added to support new elements in DocBook Publishers.
490
491   • Robert Stayton: param.xweb; param.ent
492
493     Add the 9 new attribute sets for DocBook Publishers.
494
495   • Robert Stayton: xref.xsl
496
497     Fix bug #1355 glossseealso generates duplicate id in certain cases.
498
499   • Robert Stayton: xref.xsl
500
501     fix bug #1360 indexterm in varlistentry/term generates an error when xref to that term.
502
503   • Robert Stayton: inline.xsl
504
505     Fix bug #13598 inline.monoseq and other inline.*seq handle links incorrectly.
506
507   • Robert Stayton: pi.xsl
508
509     Fix bug in dbfo-need for admonitions, and get dbfo-need
510     working properly in FOP1.1.
511
512   • Robert Stayton: pagesetup.xsl
513
514     Remove obsolete hardcoded margin-left="0pt" for the block
515     containing header or footer.
516
517   • Robert Stayton: graphics.xsl
518
519     Fix bug #1336 to add support for recognizing
520     file:/ image URLs as absolute paths.
521
522   • Robert Stayton: autotoc.xsl
523
524     Add support in TOC for article as child of set.
525
526   • Robert Stayton: xref.xsl
527
528     Fix bug #1337 Elements with olink role do not behave as olink
529     elements.
530
531   • Jirka Kosek: build.xml
532
533     Added ant build for FO
534
535   • stilor: inline.xsl
536
537     Only count regular <emphasis> elements (without @role="bold", etc) when determining
538     whether nested emphasis needs to be displayed in italics or in regular; otherwise,
539     the order of nesting in <emphasis role="bold"> and <emphasis> affects the font
540     used.
541
542   • Robert Stayton: fop1.xsl; ptc.xsl
543
544     Apply patch #190 to include refsections in bookmarks for fop1 and
545     ptc.xsl.
546
547   • Robert Stayton: block.xsl
548
549     Change the epigraph template to support schema extensions
550     by processing all of its children instead of specific elements.
551
552   • tom_schr: pagesetup.xsl
553
554     Added "user.declarations" hook to implemented [#1330]
555
556     Added empty "user.declarations" template to make it easier for adding
557     custom fo:declaration elements. The template is empty by default.
558
559   • Robert Stayton: inline.xsl
560
561     Fix test for nested links.
562
563   • Robert Stayton: biblio.xsl
564
565     Now biblioset outputs its id if it has one.
566
567   • Robert Stayton: xref.xsl
568
569     pass xrefstyle param from link element to gentext.template so
570     optional page number can be formatted to a style.
571
572   • Robert Stayton: docbook.xsl
573
574     Streamline handling of namespace fixup in preparation for making
575     the namespaced version the source base.
576
577   • Robert Stayton: fo.xsl
578
579     FOP 1.1 now supports writing-mode="rl-tb", so add that change to the
580     $direction.mode parameter.
581
582   • Robert Stayton: autoidx.xsl
583
584     Add missing xlink namespace declaration to the root element.
585
586   • Robert Stayton: param.xweb; param.ent; autoidx.xsl
587
588     Add support for $autolink.index.see to automatically form links
589     between see and seealso index elements and primary elements
590     in the index.
591
592   • Robert Stayton: inline.xsl
593
594     Add element name to warning message for nested links.
595
596   • Robert Stayton: inline.xsl
597
598     Fix bug #1306: warn of nested links.
599
600   • Robert Stayton: component.xsl
601
602     Fix bug #1320 so template page.sequence tests $content to make
603     sure it is not empty.
604
605   • Robert Stayton: autotoc.xsl; refentry.xsl; param.xweb; docbook.xsl;
606     param.ent; component.x⋯
607
608     Add support for $show.bookmarks param to turn bookmarks on or
609     off.
610
611   • Robert Stayton: docbook.xsl
612
613     Add missing variable bookmarks.state.
614
615   • Robert Stayton: docbook.xsl
616
617     Add missing $document.element variable to new generate.bookmarks
618     template.
619
620   • Robert Stayton: autotoc.xsl; refentry.xsl; param.xweb; docbook.xsl;
621     param.ent; component.x⋯
622
623     Add support for standard XSL 1.1 bookmarks and parameter
624     $xsl1.1.bookmarks to turn them on or off.
625
626   • stilor: xref.xsl
627
628     Fix invalid href generated if $insert.olink.pdf.frag=0 and $fop1.extensions=1.
629
630   • stilor: autotoc.xsl; param.xweb; param.ent; toc.xsl
631
632     Replace literal space inserted next to fo:leader in ToC with a padding. This
633     works around a bug in FOP (see FOP-1444).
634     Make ToC fo:leader properties configurable via attribute set.
635
636   • stilor: titlepage.templates.xml
637
638     Remove autoguessing of the namespace for wrapper elements; determine namespace by prefix, if any.
639
640   • Mauritz Jeanson: table.xsl
641
642     Bug #1246: added missing with-param.
643
644   • stilor: xref.xsl
645
646     Make olink errors/warnings overridable in customizations.
647
648   • stilor: param.xweb; param.ent; xref.xsl
649
650     1. Make page citations on <xref/> to paragraphs conditional on a new parameter,
651     $insert.xref.page.number.para, default to 'yes' (before, page citations were
652     added unconditionally). Remove similar special-casing for <link/>.
653
654     2. Disable page citations for @xrefstyle="template:..." (if needed, they
655     can be added with %p in the template - but they can't be disabled).
656
657   • stilor: fop1.xsl
658
659     Skip generating fox:destination on a footnote - id attribute on footnotes is not
660     passed to generated FO, so FOP complains about unresolved ID in destination.
661
662   • Mauritz Jeanson: lists.xsl
663
664     Fixed typo.
665
666   • tom_schr: lists.xsl
667
668     Fixed bug#1311 and added missing para.properties
669
670   • Robert Stayton: xref.xsl
671
672     Pass referrer and target params to mode="xrefstyle" to allow customizations
673     to be more specific.
674
675   • Robert Stayton: xref.xsl
676
677     Add mode="xrefstyle" to replace many instances of redundant
678     code determining the xrefstyle with xsl:apply-templates
679     select="." mode="xrefstyle".  Also allows stylesheet
680     customization to specify an xrefstyle per element type.
681
682   • tom_schr: xref.xsl
683
684     Pass referrer and xrefstyle to "xref-to-suffix" and "xref-to-prefix"
685     modes (to use the same signature than "xref-to" mode) as discussed with
686     Bob on the mailinglist (2013-09-12)
687
688   • tom_schr: pi.xsl; verbatim.xsl
689
690     Fix for enhancement/bug#1312: Support font size in verbatim elements
691
692   • Robert Stayton: fop1.xsl
693
694     Unchanged, testing snapshot builds.
695
696   • Robert Stayton: docbook.xsl
697
698     No change, testing snapshot builds.
699
700   • Robert Stayton: block.xsl
701
702     No change, testing snapshot builds.
703
704   • Robert Stayton: block.xsl
705
706     No change, just checking snapshot build process.
707
708   • Robert Stayton: toc.xsl
709
710     Add missing template for tocdiv/title elements to fix bug #1310.
711
712   • Robert Stayton: docbook.xsl
713
714     Fix process.root template so document title can come from info as well.
715
716   • Robert Stayton: lists.xsl
717
718     Add support for procedure title when contained in blockinfo or info.
719
720   • Robert Stayton: fop1.xsl
721
722     Fix mode="fop1.foxdest" so only elements with id attribute get
723     a fox:destination in the output.
724
725   • Robert Stayton: fop1.xsl
726
727     Remove extraneous call from fop1.foxdest mode per patch submission.
728
729   • Robert Stayton: autotoc.xsl
730
731     Add toc.margin.properties attribute-set to list.of.titles so
732     it matches the TOC list.
733
734   • Robert Stayton: inline.xsl
735
736     Adjust exception for fop for menuchoice separator to
737     use the $symbol.font.family if it is set.
738
739   • Robert Stayton: division.xsl
740
741     Fix comment.
742
743   • Robert Stayton: param.ent
744
745     Fix typo that prevents param.xsl update.
746
747   • Robert Stayton: lists.xsl; param.xweb; param.ent
748
749     Add mark.optional.procedure.steps param.
750
751   • Robert Stayton: qandaset.xsl
752
753     Fix bug in question template that output empty list-item-label when
754     defaultlabel = 'none'.
755
756 HTML
757
758 The following changes have been made to the html code since the 1.78.1 release.
759
760   • Robert Stayton: block.xsl
761
762     Fix Bug #1367 epigraph attribution appears twice in html output.
763
764   • Robert Stayton: param.xweb; param.ent
765
766     Add missing profile.outputformat param.
767
768   • Robert Stayton: titlepage.xsl; docbook.xsl; titlepage.templates.xml
769
770     Add support for DocBook Publishers elements.
771
772   • Robert Stayton: publishers.xsl
773
774     New module to support new elements in DocBook Publishers schema.
775
776   • Robert Stayton: table.xsl
777
778     Fix bug #1348 where class of output table not being set correctly.
779
780   • Robert Stayton: table.xsl
781
782     A table emitted by tgroup template now calls "common.html.attributes"
783     to get the class attribute handled correctly.
784
785   • Robert Stayton: inline.xsl
786
787     Fix bug #13598 inline.monoseq and other inline.*seq handle links incorrectly.
788
789   • Robert Stayton: refentry.xsl
790
791     Add template for refpurpose in no.anchor.mode to generate
792     the dash separator in TOC line for the refentry when
793     the refpurpose contains a link or indexterm.
794
795   • Robert Stayton: inline.xsl
796
797     Add missing call to id.attribute template for orgdiv.
798
799   • Robert Stayton: xref.xsl
800
801     If a link or xref has an @id or @xml:id, then add a span to
802     include the id because simple.xlink no longer generates the
803     id attribute.
804
805   • Robert Stayton: inline.xsl
806
807     Remove call to id.attribute template in simple.xlink
808     because it produces duplicate ids in the output because
809     the element template calling simple.xlink generates the
810     id attribute.
811
812   • Robert Stayton: graphics.xsl
813
814     Check in fix for bug #1336 to support absolute file URLs
815     that start with file:/.  Also consolidate code that determines
816     whether an image file path is relative into a new template
817     variable $is.relative.
818
819   • Robert Stayton: chunk-code.xsl
820
821     Add support for set nested inside set to recursive-chunk-filename.
822
823   • Robert Stayton: autotoc.xsl
824
825     Add support for set TOC to contain nested set or article
826     elements.
827
828   • Jirka Kosek: build.xml
829
830     Added clean targets
831
832   • Jirka Kosek: build.xml
833
834     Added ant build for HTML stylesheets
835
836   • Robert Stayton: glossary.xsl
837
838     Move any indexterms in glossentry to be inside dt, instead of
839     after dt which is invalid.
840
841   • Robert Stayton: htmltbl.xsl
842
843     Fix bug #1334 to copy through HTML table attributes @scope and @id.
844
845   • Robert Stayton: block.xsl
846
847     Change the epigraph template to support schema extensions
848     by processing all of its children instead of specific elements.
849
850   • Robert Stayton: titlepage.xsl
851
852     Fix bug in handling of multiple editors and "edited by" label.
853
854   • Robert Stayton: titlepage.templates.xml
855
856     Fix misnamed attribute in sidebar template.
857
858   • Robert Stayton: inline.xsl
859
860     Fix check for nested links.
861
862   • Robert Stayton: chunk-common.xsl; chunktoc.xsl; chunk-code.xsl
863
864     Adjust handling of namespace fixup to streamline distro builds.
865
866   • Robert Stayton: docbook.xsl
867
868     Adjust handling of namespace conversion to streamline distro
869     build.
870
871   • Robert Stayton: table.xsl
872
873     Fix bug #1298 where @rowheader = 'firstcol' incorrectly assigns
874     <th> to cell that is first in a row but not the first column due
875     to row span above.
876
877   • Robert Stayton: param.xweb; param.ent; autoidx.xsl
878
879     Add support for autolink.index.see param to link from see and
880     seealso element to primary element in index.
881
882   • Robert Stayton: inline.xsl
883
884     Fix bug #1306 warn of nested links, since not supported in the output.
885
886   • Robert Stayton: pi.xsl
887
888     Fixes bug #1323 where <?dbhtml-include?> paths were not being
889     interpreted relative to the XML.
890
891   • Robert Stayton: param.xweb
892
893     Add missing frag for new linke.to.self.for.mediaobject param.
894
895   • Robert Stayton: table.xsl
896
897     Fix bug in entry template where rowsep was incorrectly set to zero
898     for cell with @morerows in thead.
899
900   • Robert Stayton: synop.xsl
901
902     Restore conditional named anchor in output if dbcmdlist PI is not used.
903
904   • tom_schr: graphics.xsl
905
906     Fixed [#1317]: process alt in inlinemediaobject
907
908   • tom_schr: param.xweb; graphics.xsl; param.ent
909
910     Fixed ticket [#1315]: Add possibility to add a link to mediaobjects
911
912   • stilor: titlepage.templates.xml
913
914     Remove autoguessing of the namespace for wrapper elements; determine namespace by prefix, if any.
915
916   • stilor: chunk-common.xsl; xref.xsl
917
918     Make olink errors/warnings overridable in customizations.
919
920   • stilor: param.xweb; param.ent
921
922     1. Make page citations on <xref/> to paragraphs conditional on a new parameter,
923     $insert.xref.page.number.para, default to 'yes' (before, page citations were
924     added unconditionally). Remove similar special-casing for <link/>.
925
926     2. Disable page citations for @xrefstyle="template:..." (if needed, they
927     can be added with %p in the template - but they can't be disabled).
928
929   • Mauritz Jeanson: index.xsl
930
931     Bug #1309: Added missing template for indexdiv/subtitle.
932
933   • Robert Stayton: xref.xsl
934
935     Pass referrer and target params to mode="xrefstyle" to allow customizations
936     to be more specific.
937
938   • Robert Stayton: xref.xsl
939
940     Add mode="xrefstyle" to replace many instances of redundant
941     code determining the xrefstyle with xsl:apply-templates
942     select="." mode="xrefstyle".  Also allows stylesheet
943     customization to specify an xrefstyle per element type.
944
945   • tom_schr: xref.xsl
946
947     Pass referrer and xrefstyle to "xref-to-suffix" and "xref-to-prefix"
948     modes (to use the same signature than "xref-to" mode) as discussed with
949     Bob on the mailinglist (2013-09-12)
950
951   • Robert Stayton: chunk.xsl
952
953     No change, testing snapshot builds.
954
955   • Robert Stayton: toc.xsl
956
957     Add missing template for tocdiv/title elements to fix bug #1310.
958
959   • Robert Stayton: docbook.xsl
960
961     Remove a comment to test checkins and snapshot builds.
962
963   • Robert Stayton: lists.xsl
964
965     Add support for procedure title when contained in info or blockinfo.
966
967   • Jirka Kosek: chunk-code.xsl
968
969     Enumarete separate file for revhistory if generate.revhistory.link=1
970
971   • Robert Stayton: inline.xsl
972
973     Update the inline.charseq template to also call 'common.html.attributes'
974     instead of using local-name for class value.
975
976   • Jirka Kosek: docbook.xsl; html.xsl
977
978     Enabling ITS processing again
979
980   • Robert Stayton: its.xsl
981
982     Change syntax for selecting @its:* attributes so it works
983     in xsltproc (which should work with the original, but doesn't).
984
985   • Robert Stayton: docbook.xsl; html.xsl
986
987     Turn off its.xsl update which is generating attribute insertion errors.
988
989   • Jirka Kosek: its.xsl; docbook.xsl; html.xsl
990
991     Added basic support for ITS 2.0 markup. It gets propagated into HTML
992     For more info about ITS see http://www.w3.org/TR/its20/
993
994   • Robert Stayton: docbook.xsl
995
996     Added a comment line to test checkin process.
997
998   • Robert Stayton: xref.xsl
999
1000     Fix bug in mode=remove-ids that put link content outside the <a> element.
1001
1002   • tom_schr: chunktoc.xsl
1003
1004     Fixed SF ticket#3611689: added missing DocBook namespace declarations
1005
1006   • Robert Stayton: chunker.xsl
1007
1008     Change the internal chunk.base.dir from a param to a variable.
1009
1010   • Robert Stayton: inline.xsl
1011
1012     Turn off id attribute on glossterm anchor, because it is on the element itself.
1013
1014 Manpages
1015
1016 The following changes have been made to the manpages code since the 1.78.1
1017 release.
1018
1019   • Robert Stayton: block.xsl; lists.xsl
1020
1021     Fix bug #1363 synopsis in variablelist term mangles line breaks.
1022
1023   • Robert Stayton: other.xsl
1024
1025     Remove redundant and out-of-date xsl:strip-space element.
1026     This is imported from common/common.xsl for all stylesheets.
1027
1028   • Jirka Kosek: build.xml
1029
1030     Added clean targets
1031
1032   • Jirka Kosek: build.xml
1033
1034     Added ant build for manpages
1035
1036   • Robert Stayton: inline.xsl
1037
1038     Fix bug #1340 by omitting indexterm and remark elements from the
1039     output.  Trying to include them as nroff comments resulted in extra
1040     whitespace in certain instances, so they are omitted.
1041
1042   • Robert Stayton: table.xsl; docbook.xsl; tbl.xsl
1043
1044     Adjust man stylesheet to better handle namespace fixup during
1045     distro builds.
1046
1047   • Robert Stayton: lists.xsl
1048
1049     Resolve ambiguous template match for remark.
1050
1051   • Robert Stayton: endnotes.xsl
1052
1053     Put internally generated earmark elements into own namespace to
1054     avoid complications with namespace stylesheet builds.  No change
1055     of function.
1056
1057   • Robert Stayton: other.xsl
1058
1059     Fixed bug #1313 where write.stubs template mistakenly includes
1060     $man.output.base.dir in the .so address.
1061
1062   • Robert Stayton: other.xsl
1063
1064     Escape text() nodes while also in no.anchor.mode for links.
1065     Fixes bug #1322.
1066
1067   • Robert Stayton: utility.xsl
1068
1069     Fixed bug #1321, also taking into account fixing bug #1281.
1070
1071   • dleidert: info.xsl
1072
1073     Fix a typo (http://bugs.debian.org/698962).
1074
1075 Epub
1076
1077 The following changes have been made to the epub code since the 1.78.1 release.
1078
1079   • Robert Stayton: docbook.xsl
1080
1081     Fix bug #1341 Incorrect generation of content.opf for multiple
1082     names in $html.stylesheet param.  Backported the template
1083     named css.item from the epub3 stylesheet.
1084
1085   • Robert Stayton: docbook.xsl
1086
1087     Fix handling of base.dir, chunk.base.dir, and epub.oebps.dir
1088     combinations.
1089
1090   • Robert Stayton: docbook.xsl
1091
1092     Improve the handling of $chunk.base.dir when $base.dir contains
1093     the OEBPS directory in its value.
1094
1095   • Robert Stayton: docbook.xsl
1096
1097     Fix the namespace fixup step to match the other stylesheets.
1098
1099   • tom_schr: docbook.xsl
1100
1101     Extended date template in mode opf.metadata
1102     If a PI dbtimestamp is available, call datetime.format(date, 'Y-m-d'),
1103     otherwise use the normalized string content
1104
1105   • dleidert: bin/spec/files
1106
1107     Fix svn:externals defintion.
1108
1109   • tom_schr: docbook.xsl
1110
1111     Introduced  variable in opf.guide
1112
1113   • tom_schr: docbook.xsl
1114
1115     Improved modularization in opf.spine and created new spine.cover template
1116
1117   • tom_schr: docbook.xsl
1118
1119     Improved opf.spine with info variable
1120
1121   • tom_schr: docbook.xsl
1122
1123     Bugfix in opf.spine: removed double refentry entries
1124
1125   • tom_schr: docbook.xsl
1126
1127     * Template package-identifier: introduced $info variable to simplify
1128       code (similar to the EPUB3 stylesheets)
1129     * Template opf.calloutlist: only call opf.reference.callout if
1130       callout.graphics is set
1131
1132   • tom_schr: docbook.xsl
1133
1134     Backported Bob's EPUB3 changes to EPUB2 from r9740 -> r9742 -> r9743:
1135
1136     * Implement base.dir/OEBPS using internal chunk.base.dir instead of
1137       new param epub.base.dir.
1138
1139     * Additional changes, specific to this stylesheet:
1140       - Construct parameter epub.metainf.dir from base.dir + 'META-INF/'
1141       - Changed parameter epub.cover.filename epub.oebps.dir to
1142         chunk.base.dir
1143       - Template opf: concat base.dir with epub.opf.filename
1144       - Replaced two subsequent xsl:value-of's with concat()
1145
1146   • Robert Stayton: docbook.xsl
1147
1148     Fix bug in author template generating a span element inside an attribute value.
1149
1150 HTMLHelp
1151
1152 The following changes have been made to the htmlhelp code since the 1.78.1
1153 release.
1154
1155   • Jirka Kosek: build.xml
1156
1157     Added clean targets
1158
1159   • Jirka Kosek: build.xml
1160
1161     Extensions and other builds ported to Ant
1162
1163   • Robert Stayton: htmlhelp-common.xsl
1164
1165     Adjust namespace fixup to conform to the namespace source
1166     conversion.
1167
1168 Eclipse
1169
1170 The following changes have been made to the eclipse code since the 1.78.1
1171 release.
1172
1173   • Jirka Kosek: build.xml
1174
1175     Added clean targets
1176
1177   • Jirka Kosek: build.xml
1178
1179     Extensions and other builds ported to Ant
1180
1181   • Robert Stayton: eclipse.xsl
1182
1183     Adjust namespace fixup to conform to other conversions to
1184     namespaced source.
1185
1186 JavaHelp
1187
1188 The following changes have been made to the javahelp code since the 1.78.1
1189 release.
1190
1191   • Jirka Kosek: build.xml
1192
1193     Added clean targets
1194
1195   • Jirka Kosek: build.xml
1196
1197     Extensions and other builds ported to Ant
1198
1199   • Robert Stayton: javahelp.xsl
1200
1201     Adjust the namespace fixup to conform to the other namespaced source
1202     conversions.
1203
1204 Slides
1205
1206 The following changes have been made to the slides code since the 1.78.1
1207 release.
1208
1209   • Jirka Kosek: schema/relaxng/slides.rnc
1210
1211     Make speakernotes/handoutnotes optional as many presentations do not use them
1212
1213   • Robert Stayton: xhtml/plain.xsl; common/common.xsl; xhtml/slidy.xsl; xhtml/
1214     s5.xsl; fo/plai⋯
1215
1216     Rename the docbook prefix in the declaration too.
1217
1218   • Robert Stayton: xhtml/plain.xsl; common/common.xsl; xhtml/slidy.xsl; xhtml/
1219     s5.xsl; fo/plai⋯
1220
1221     Change the docbook db: prefix to d: prefix in preparation of svn update to namespaced
1222     stylesheets.
1223
1224   • stilor: xhtml/plain-titlepage.xml; fo/plain-titlepage.xml
1225
1226     Remove autoguessing of the namespace for wrapper elements; determine namespace by prefix, if any.
1227
1228   • dleidert: images/callouts/gen.sh
1229
1230     Leave executable permissions for script.
1231
1232   • dleidert: s5/ui/default/pretty.css; slidy/graphics/w3c-logo-blue.gif; s5/ui
1233     /default/notes.⋯
1234
1235     Drop executable permissions from files.
1236
1237   • Jirka Kosek: doc/Makefile
1238
1239     Corrected path
1240
1241 Website
1242
1243 The following changes have been made to the website code since the 1.78.1
1244 release.
1245
1246   • Jirka Kosek: build.xml
1247
1248     Added clean targets
1249
1250   • Jirka Kosek: build.xml
1251
1252     Extensions and other builds ported to Ant
1253
1254   • stilor: olink.xsl
1255
1256     Make olink errors/warnings overridable in customizations.
1257
1258 Webhelp
1259
1260 The following changes have been made to the webhelp code since the 1.78.1
1261 release.
1262
1263   • Robert Stayton: xsl/webhelp-common.xsl
1264
1265     Fix bug 1357 to avoid creating l10n.js file if only collecting olink data.
1266
1267   • Robert Stayton: docsrc/xinclude-test.xml; docsrc/readme.xml
1268
1269     Convert XML doc to DB5.
1270
1271   • Robert Stayton: xsl/webhelp-common.xsl
1272
1273     Fix error message for namespace fixup.
1274
1275   • Robert Stayton: xsl/webhelp-common.xsl
1276
1277     fix bug in namespace fixup syntax.
1278
1279   • Robert Stayton: xsl/webhelp-common.xsl
1280
1281     Adjust namespace fixup for namespace build process.
1282
1283   • stilor: xsl/titlepage.templates.xml
1284
1285     Remove autoguessing of the namespace for wrapper elements; determine namespace by prefix, if any.
1286
1287   • Jirka Kosek: template/common/main.js
1288
1289     Fix for bug #1301
1290
1291 Params
1292
1293 The following changes have been made to the params code since the 1.78.1
1294 release.
1295
1296   • Robert Stayton: dialogue.properties.xml
1297
1298     Fix typo.
1299
1300   • Robert Stayton: publishers.properties.xml
1301
1302     Fix typo.
1303
1304   • Robert Stayton: speaker.properties.xml; publishers.properties.xml;
1305     inlinestagedir.properti⋯
1306
1307     New property sets for DocBook Publishers elements.
1308
1309   • Robert Stayton: table.frame.border.thickness.xml;
1310     table.cell.border.thickness.xml
1311
1312     Fix bug #1291, make default values different for HTML and FO.
1313
1314   • tom_schr: profile.outputformat.xml
1315
1316     Added missing support for outputformat attribute
1317
1318     * Added missing parameter profile.outputformat in
1319       params/profile.outputformat.xml
1320     * Added missing lines to check for outputformat attribute in
1321       profiling/profile-mode.xsl
1322
1323   • Jirka Kosek: table.frame.border.thickness.xml;
1324     table.cell.border.thickness.xml
1325
1326     Changed default border thickness from 0.5pt to 1px. The reason is that Chrome rounds 0.5pt to 0px making borders invisible.
1327
1328   • Robert Stayton: list.block.spacing.xml
1329
1330     Fix typo in element name.
1331
1332   • Robert Stayton: autolink.index.see.xml
1333
1334     New param to control automatic links in index from see and
1335     seealso to indexterm primary.
1336
1337   • Robert Stayton: show.bookmarks.xml
1338
1339     New param to turn off PDF bookmarks.
1340
1341   • Robert Stayton: xsl1.1.bookmarks.xml
1342
1343     Param to use standard XSL 1.1 bookmark elements.
1344
1345   • tom_schr: link.to.self.for.mediaobject.xml
1346
1347     Fixed ticket [#1315]: Add possibility to add a link to mediaobjects
1348
1349   • stilor: toc.leader.properties.xml
1350
1351     Replace literal space inserted next to fo:leader in ToC with a padding. This
1352     works around a bug in FOP (see FOP-1444).
1353     Make ToC fo:leader properties configurable via attribute set.
1354
1355   • Robert Stayton: list.block.spacing.xml; list.item.spacing.xml
1356
1357     Clarify that list.block.spacing is not used in nested lists.
1358
1359   • stilor: insert.xref.page.number.para.xml
1360
1361     Missed new file in previous checkin.
1362
1363   • Robert Stayton: mark.optional.procedure.steps.xml
1364
1365     New param to turn off Optional text for optional steps.
1366
1367 Profiling
1368
1369 The following changes have been made to the profiling code since the 1.78.1
1370 release.
1371
1372   • tom_schr: profile-mode.xsl
1373
1374     Added missing support for outputformat attribute
1375
1376     * Added missing parameter profile.outputformat in
1377       params/profile.outputformat.xml
1378     * Added missing lines to check for outputformat attribute in
1379       profiling/profile-mode.xsl
1380
1381   • Robert Stayton: xsl2profile.xsl
1382
1383     Fix bug #1335 where profile-chunk.xsl was xsl:including
1384     chunk-code.xsl instead of profile-chunk-code.xsl.
1385
1386   • Robert Stayton: xsl2profile.xsl
1387
1388     Fixed bug in handling of namespace fixup.
1389
1390   • Robert Stayton: xsl2profile.xsl
1391
1392     Adjust namespace fixup to match other templates.
1393
1394 Lib
1395
1396 The following changes have been made to the lib code since the 1.78.1 release.
1397
1398   • Jirka Kosek: build.xml
1399
1400     Added lib ant build support
1401
1402 Tools
1403
1404 The following changes have been made to the tools code since the 1.78.1
1405 release.
1406
1407   • Jirka Kosek: build-shared.xml
1408
1409     Added lib ant build support
1410
1411   • Jirka Kosek: build-shared.xml
1412
1413     Added clean targets
1414
1415   • Jirka Kosek: lib/xml-apis.jar; lib/xercesImpl.jar; build-shared.xml; lib/
1416     xalan.jar
1417
1418     Extensions and other builds ported to Ant
1419
1420   • Jirka Kosek: build-shared.xml
1421
1422     Added ant build for HTML stylesheets
1423
1424   • Jirka Kosek: licenses/saxon/JAMESCLARK.txt; lib/jython.jar; lib/
1425     xercesImpl.jar; licenses/j⋯
1426
1427     Initial work on Ant build, common (L10N) directory handled so far
1428
1429 Template
1430
1431 The following changes have been made to the template code since the 1.78.1
1432 release.
1433
1434   • Robert Stayton: titlepage.xsl
1435
1436     Remove the d: namespace declaration because it is
1437     automatically added by the ns build process.
1438
1439   • Jirka Kosek: titlepage.xsl
1440
1441     Added missing namespace declaration
1442
1443   • Robert Stayton: titlepage.xsl
1444
1445     Remove d: namespace declaration from non namespaced version since
1446     it is automatically added to build the namespaced version.
1447
1448   • Robert Stayton: titlepage.xsl
1449
1450     Set the db.prefix to blank until convert to ns build.
1451
1452   • Robert Stayton: titlepage.xsl
1453
1454     Fix handling of namespace declaration for conversion to NS sourcebase.
1455
1456   • Robert Stayton: titlepage.xsl
1457
1458     Modified to support roundtrip conversion between namespaced
1459     version and non-namespaced version.
1460
1461   • stilor: titlepage.xsl
1462
1463     Remove autoguessing of the namespace for wrapper elements; determine namespace by prefix, if any.
1464
1465 Extensions
1466
1467 The following changes have been made to the extensions code since the 1.78.1
1468 release.
1469
1470   • Jirka Kosek: build.xml
1471
1472     Added clean targets
1473
1474   • Jirka Kosek: build.xml
1475
1476     Extensions and other builds ported to Ant
1477
1478 Release Notes: 1.78.1
1479
1480 The following is a list of changes that have been made since the 1.78.0
1481 release.
1482
1483 Common
1484
1485 The following changes have been made to the common code since the 1.78.0
1486 release.
1487
1488   • Robert Stayton: titles.xsl
1489
1490     Make sure part and set titleabbrev are used in mode="titleabbrev.markup"
1491
1492   • Robert Stayton: titles.xsl
1493
1494     Add empty default template for titleabbrev since it is always processed in a mode.
1495
1496   • Robert Stayton: gentext.xsl
1497
1498     Make consistent handling of titleabbrev in xrefs.
1499
1500   • Robert Stayton: titles.xsl
1501
1502     for missing title in xref, provide parent information of target to help locate problem element.
1503     Process bridgehead in mode="title.markup", not normal mode.
1504
1505   • Jirka Kosek: l10n.xsl
1506
1507     Fixed bug #3598963
1508
1509   • Robert Stayton: gentext.xsl; labels.xsl
1510
1511     Make sure bridgeheads are not numbered in all contexts, including html title attributes.
1512
1513 FO
1514
1515 The following changes have been made to the fo code since the 1.78.0 release.
1516
1517   • Robert Stayton: division.xsl
1518
1519     Fix bug where part TOC not generated when partintro is present.
1520
1521   • Jirka Kosek: xref.xsl
1522
1523     Footnotes can't be placed into fo:float
1524
1525   • Robert Stayton: titlepage.templates.xml
1526
1527     Remove margin-left when start-indent is used because they interfere
1528     with each other.
1529
1530   • Robert Stayton: fo.xsl; pagesetup.xsl
1531
1532     Use dingbat.fontset rather than dingbat.font.family so it falls
1533     back to symbol font if glyph not found, like other font properties.
1534
1535   • Robert Stayton: inline.xsl
1536
1537     Change last instance of inline.charseq in inline glossterm to
1538     inline.italicseq so it is consistent with the others.
1539
1540   • Robert Stayton: xref.xsl
1541
1542     Make consistent handling of titleabbrev in xrefs.
1543
1544 HTML
1545
1546 The following changes have been made to the html code since the 1.78.0 release.
1547
1548   • Robert Stayton: admon.xsl
1549
1550     Turn off $admon.style if $make.clean.html is set to non-zero.
1551
1552   • Jirka Kosek: highlight.xsl
1553
1554     Added new definitions for syntax highlighting
1555
1556   • Robert Stayton: chunk-common.xsl
1557
1558     Make active.olink.hrefs param work for chunked output too.
1559
1560   • Robert Stayton: xref.xsl
1561
1562     Make consistent handling of titleabbrev in xrefs.
1563
1564   • Robert Stayton: graphics.xsl
1565
1566     Add round() function when pixel counts are used for image width and height.
1567
1568   • Robert Stayton: glossary.xsl
1569
1570     fix missing class and id attributes on glossterm and glossdef.
1571
1572   • Robert Stayton: autoidx.xsl
1573
1574     Fix bug where prefer.index.titleabbrev ignored info/titleabbrev.
1575
1576 Manpages
1577
1578 The following changes have been made to the manpages code since the 1.78.0
1579 release.
1580
1581   • Robert Stayton: utility.xsl
1582
1583     Fix bug 3599520: spurious newline in para when starts with
1584     whitespace and inline element.
1585
1586 Webhelp
1587
1588 The following changes have been made to the webhelp code since the 1.78.0
1589 release.
1590
1591   • David Cramer: xsl/webhelp-common.xsl
1592
1593     Webhelp: Fix test for webhelp.include.search.tab param
1594
1595   • David Cramer: Makefile.sample
1596
1597     Webhelp: Fix order of args to xsltproc
1598
1599   • David Cramer: docsrc/readme.xml
1600
1601     Webhelp: Turn on xinclude-test.xml in readme to demo xinclude functionality
1602
1603   • David Cramer: Makefile; Makefile.sample
1604
1605     Webhelp: In Makefiles, do xinclude in first pass at document
1606
1607 Params
1608
1609 The following changes have been made to the params code since the 1.78.0
1610 release.
1611
1612   • David Cramer: webhelp.include.search.tab.xml
1613
1614     Webhelp: Fix test for webhelp.include.search.tab param
1615
1616   • Robert Stayton: article.appendix.title.properties.xml
1617
1618     Remove unneeded margin-left property from article appendix title.
1619     It interferes with the start-indent property.
1620
1621 Highlighting
1622
1623 The following changes have been made to the highlighting code since the 1.78.0
1624 release.
1625
1626   • Jirka Kosek: c-hl.xml; cpp-hl.xml; sql2003-hl.xml; php-hl.xml; upc-hl.xml;
1627     bourne-hl.xml; ⋯
1628
1629     Added new definitions for syntax highlighting
1630
1631 Release Notes: 1.78.0
1632
1633 The following is a list of changes that have been made since the 1.77.1
1634 release.
1635
1636 Gentext
1637
1638 The following changes have been made to the gentext code since the 1.77.1
1639 release.
1640
1641   • Mauritz Jeanson: locale/nn.xml; locale/nb.xml
1642
1643     Bug #3556630: Updated nb and nn locale files.
1644
1645   • Mauritz Jeanson: locale/README
1646
1647     Bug #3556628: Updated information in README.
1648
1649   • tom_schr: locale/de.xml
1650
1651     Added keycap context from RFE#3540451 to support @function attribute
1652
1653   • tom_schr: locale/en.xml
1654
1655     Added keycap context from RFE#3540451 to support @function attribute
1656
1657   • Robert Stayton: locale/en.xml
1658
1659     Add support for title element in screenshot, now allowed in DocBook 5.
1660
1661 Common
1662
1663 The following changes have been made to the common code since the 1.77.1
1664 release.
1665
1666   • Robert Stayton: titles.xsl
1667
1668     Corrected template for bridgehead in mode="title.markup" to
1669     process its children in normal mode.
1670
1671   • Robert Stayton: labels.xsl
1672
1673     Convert hard wired xsl:number for production into a template
1674     with mode="label.markup" to be consistent with other element numbering.
1675
1676   • Robert Stayton: olink.xsl
1677
1678     Remove all references and code for obsolete olink attributes
1679     @linkmode @targetdocent and @localinfo.
1680
1681   • Robert Stayton: olink.xsl
1682
1683     Add parameter 'activate.external.olinks' to allow making
1684     external olinks inactive, as for epub output.
1685
1686 FO
1687
1688 The following changes have been made to the fo code since the 1.77.1 release.
1689
1690   • Robert Stayton: pagesetup.xsl
1691
1692     Change initial page number for book from 1 to auto so front
1693     cover and title pages are sequential, and so that book inside
1694     set will continue numbering.
1695
1696   • Robert Stayton: inline.xsl
1697
1698     Add missing closing tag for xsl:choose in new template.
1699
1700   • Robert Stayton: param.xweb; param.ent; pagesetup.xsl
1701
1702     Add force.blank.pages parameter to allow turning off blank
1703     pages in double.sided output.
1704
1705   • Robert Stayton: lists.xsl; callout.xsl
1706
1707     Implement active links between co and callout elements for
1708     PDF output, linking in both directions.
1709
1710   • Robert Stayton: table.xsl
1711
1712     Fix typo to replace "ro" with "row" in three places.
1713
1714   • Robert Stayton: ebnf.xsl
1715
1716     Convert hard wired xsl:number for production into a template
1717     with mode="label.markup" to be consistent with other element numbering.
1718
1719   • Robert Stayton: inline.xsl
1720
1721     Make comma inserted after function/parameter or function/replaceable
1722     conditional on $function.parens to be consistent with the function template.
1723
1724   • tom_schr: inline.xsl
1725
1726     Added new inline.sansseq template for consistency reasons.
1727     Makes it easier for customization layers: Just use
1728       <xsl:call-template name="inline.sansseq"/>
1729     to change to sans serif font, but also takes into account
1730     XLinks and direction of text.
1731
1732   • Robert Stayton: xref.xsl
1733
1734     Remove all references and code for obsolete olink attributes
1735     @linkmode @targetdocent and @localinfo.
1736
1737   • Robert Stayton: table.xsl
1738
1739     Remove passivetex.extensions code.
1740
1741   • Robert Stayton: spaces.xsl; autotoc.xsl; docbook.xsl; division.xsl;
1742     table.xsl; sections.xs⋯
1743
1744     Remove all passivetex code because it is obsolete.
1745
1746   • Robert Stayton: param.xweb; param.ent
1747
1748     Add parameter 'activate.external.olinks' to allow making
1749     external olinks inactive, as for epub output.
1750
1751   • Mauritz Jeanson: table.xsl
1752
1753     Added support for keep-together PI on informaltable. Closes bug #3555609.
1754
1755   • tom_schr: verbatim.xsl
1756
1757     Fixed subtle typo when calling lastLineNumber template: must be $listing instead of listing
1758
1759   • tom_schr: autoidx.xsl
1760
1761     Fixed typo: fole -> role attribute for phrase
1762
1763   • tom_schr: inline.xsl
1764
1765     Added support for @function attribute in keycap (uses keycap context
1766     from language files) => fixes RFE#3540451
1767     If @function is set and keycap is empty, then template will use the
1768     content from the keycap context, otherwise it will use just the given
1769     text
1770
1771   • Robert Stayton: graphics.xsl; xref.xsl
1772
1773     Add support for title element in screenshot, now allowed in DocBook 5.
1774
1775   • Robert Stayton: graphics.xsl
1776
1777     Restore formatting of figure/caption that was broken in 1.77.1.
1778
1779 HTML
1780
1781 The following changes have been made to the html code since the 1.77.1 release.
1782
1783   • David Cramer: autotoc.xsl
1784
1785     Fixing bug where toc.title.p and nodes params had not been declared inside manual-toc template
1786
1787   • Robert Stayton: autotoc.xsl
1788
1789     Add 'toc.list.attributes' template to insert class and other
1790     attributes on the top level list element in a table of contents.
1791
1792   • Robert Stayton: block.xsl
1793
1794     Fix bug 3590039 abstract/title not rendered.
1795
1796   • Jirka Kosek: chunk-common.xsl; footnote.xsl
1797
1798     Fixed positioning of footnote separate when CSS decoration is used.
1799
1800   • Robert Stayton: ebnf.xsl
1801
1802     Convert hard wired xsl:number for production into a template
1803     with mode="label.markup" to be consistent with other element numbering.
1804
1805   • Robert Stayton: inline.xsl
1806
1807     Make comma inserted after function/parameter or function/replaceable
1808     conditional on $function.parens to be consistent with the function template.
1809
1810   • Robert Stayton: graphics.xsl
1811
1812     Add support for mediaobject/alt, with precedence over
1813     mediaobject/textobject/phrase.
1814
1815   • Robert Stayton: param.xweb
1816
1817     Remove src:fragref elements for deleted obsolete olink params.
1818
1819   • Robert Stayton: chunker.xsl
1820
1821     Fix bug #3563697 where template make-relative-filename was using a
1822     global param chunk.base.dir instead of its local param base.dir.  Now it uses base.dir.
1823
1824   • Robert Stayton: param.xweb; param.ent; xref.xsl
1825
1826     Remove all references and code for obsolete olink attributes
1827     @linkmode @targetdocent and @localinfo.
1828
1829   • Robert Stayton: param.xweb; param.ent
1830
1831     Add parameter 'activate.external.olinks' to allow making
1832     external olinks inactive, as for epub output.
1833
1834   • stefan: graphics.xsl
1835
1836     Add hook for customization.
1837
1838   • tom_schr: docbook.xsl
1839
1840     Splitting head.content into smaller chunks of templates.
1841     See https://lists.oasis-open.org/archives/docbook-apps/201209/msg00037.html
1842
1843   • tom_schr: verbatim.xsl
1844
1845     Fixed subtle typo when calling lastLineNumber template: must be $listing instead of listing
1846
1847   • Robert Stayton: footnote.xsl
1848
1849     Fix bug in footnote link introduced in 1.77.1.
1850
1851   • Robert Stayton: formal.xsl; htmltbl.xsl
1852
1853     Resolve conflict of duplicate ids on html table with caption.
1854     Wrap a div with class and id attribute around html table without caption.
1855
1856   • Robert Stayton: component.xsl
1857
1858     Remove call to 'generate.id' template in <h1> in component.title because the
1859     id is already generated for the parent div element.
1860
1861   • Robert Stayton: chunker.xsl
1862
1863     Set omit-xml-declaration to 'yes' for write.text.chunk template, since a text
1864     file should never have an xml declaration.
1865
1866   • tom_schr: inline.xsl
1867
1868     Added support for @function attribute in keycap (uses keycap context
1869     from language files) => fixes RFE#3540451
1870     If @function is set and keycap is empty, then template will use the
1871     content from the keycap context, otherwise it will use just the given
1872     text
1873
1874   • David Cramer: docbook.xsl
1875
1876     Also set the title param in head.content since it's sometimes
1877     called without that param being passed in. Use the passed-in
1878     value in user.head.title.
1879
1880   • Robert Stayton: docbook.xsl
1881
1882     Restore missing title param on 'head.content' template, and passed
1883     it along to user.head.title. That param
1884     is used for certain special chunkings such as Long Descriptions.
1885
1886   • Robert Stayton: graphics.xsl; xref.xsl
1887
1888     Add support for title in screenshot, available since DocBook 5.
1889
1890   • David Cramer: docbook.xsl
1891
1892     HTML: Add hook for easily customizing html/head/title
1893
1894 Manpages
1895
1896 The following changes have been made to the manpages code since the 1.77.1
1897 release.
1898
1899   • Robert Stayton: lists.xsl
1900
1901     Add a line break at start of variablelist to fix bug #3595156.
1902
1903   • Robert Stayton: lists.xsl
1904
1905     Better fix for bug #3545150 by putting the title with the step number
1906     rather than before it.
1907
1908   • Robert Stayton: utility.xsl
1909
1910     Add 'content' param to template name inline.monoseq to support
1911     email format, fixing bug #3524417.
1912
1913   • Robert Stayton: utility.xsl
1914
1915     Fix bug #3512473 where an inline synopsis element produced
1916     an extra line break in nroff output.
1917
1918   • Robert Stayton: lists.xsl
1919
1920     Fix bug 3545150 where procedure/step/title not rendered in man pages.
1921
1922 Roundtrip
1923
1924 The following changes have been made to the roundtrip code since the 1.77.1
1925 release.
1926
1927   • Robert Stayton: dbk2wordml.xsl
1928
1929     Fix bug #3297553 error in Word metadata elements from including
1930     WordML markup instead of just text.
1931
1932 Slides
1933
1934 The following changes have been made to the slides code since the 1.77.1
1935 release.
1936
1937   • gaborkovesdan: xhtml/plain.xsl
1938
1939     - Use real push-style processing in the foil/foilgroup page content, which
1940       allows better customization in general (e.g. you can add PI templates)
1941       and also let us render scattered speakernotes/handoutnotes if that is
1942       desired
1943
1944   • gaborkovesdan: xhtml/Makefile
1945
1946     - Titlepage markup belongs to the XHTML namespace
1947
1948   • gaborkovesdan: xhtml/plain.xsl
1949
1950     - Remove now unnecessary template redefinition
1951
1952   • gaborkovesdan: xhtml/plain.xsl
1953
1954     - Generate valid links from cross-references
1955
1956   • gaborkovesdan: xhtml/plain.xsl
1957
1958     - Do not add fallbacks for EXSLT extensions, the main DocBook XSL stylesheets
1959       do not do that either
1960
1961   • Robert Stayton: schema/relaxng/slides.rnc
1962
1963     Update the import path for docbook.rnc after the slides directory was moved.
1964
1965   • stefan: xhtml/plain.xsl
1966
1967     Add missing stylesheet.
1968
1969   • stefan: schema/xsd/Makefile; schema/Makefile; schema/relaxng/Makefile
1970
1971     Adjust Makefiles.
1972
1973   • stefan: locatingrules.xml; RELEASE-NOTES.xml; doc; images;
1974     locatingrules.xml; Makefile; im⋯
1975
1976     Moved many files from slides/ to xsl/slides/
1977
1978   • stefan: fo/param.xweb; xhtml/Makefile; xhtml/param.xweb; fo/Makefile
1979
1980     Separate slides package.
1981
1982   • stefan: Makefile
1983
1984     A bit of cleanup...
1985
1986   • stefan: xhtml/Makefile; fo/Makefile
1987
1988     Add to 'clean' target.
1989
1990   • David Cramer: Makefile
1991
1992     Slides: Change html to xhtml passim.
1993
1994   • David Cramer: xhtml
1995
1996     Adding items to svn ignore for slides
1997
1998   • stefan: slidy
1999
2000     Import slidy from vendor branch.
2001
2002   • stefan: s5
2003
2004     Import s5 from vendor branch.
2005
2006   • stefan: Makefile; common/common.xsl; common; fo/param.ent; graphics; xhtml/
2007     Makefile.param;⋯
2008
2009     Merge Slides GSoC project to trunk.
2010
2011 Webhelp
2012
2013 The following changes have been made to the webhelp code since the 1.77.1
2014 release.
2015
2016   • David Cramer: docsrc/readme.xml
2017
2018     Webhelp: More doc updates
2019
2020   • David Cramer: docsrc/readme.xml
2021
2022     Webhelp: Documentation updates.
2023
2024   • David Cramer: template/content; Makefile; Makefile.sample; build.xml;
2025     template/search
2026
2027     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
2028
2029   • David Cramer: Makefile.sample
2030
2031     Attempting to include sample Makefile in webhelp output dir
2032
2033   • David Cramer: template/common/css/positioning.css
2034
2035     Webhelp: Do not display sidebar if js is disabled in browser since it will not be functional
2036
2037   • Jirka Kosek: build.xml
2038
2039     Xerces must be on the classpath in order to XInclude work
2040
2041   • David Cramer: Makefile
2042
2043     Adding generated files to various clean targets.
2044
2045   • David Cramer: build.properties
2046
2047     Webhelp: By default don't validate against dtd when using ant build
2048
2049   • David Cramer: Makefile
2050
2051     Webhelp: By default only exclude ix01.html from search in Makefile
2052
2053   • David Cramer: template/common/jquery/jquery-ui-1.8.2.custom.min.js;
2054     template/common/jquery⋯
2055
2056     Webhelp: Reverting last commit
2057
2058   • David Cramer: template/common/jquery/jquery-ui-1.8.2.custom.min.js;
2059     template/common/jquery⋯
2060
2061     Webhelp: Removing two more unused jquery files
2062
2063   • David Cramer: template/common/jquery/jquery-1.4.2.min.js
2064
2065     Webhelp: Removing old, unused jquery file
2066
2067   • David Cramer: xsl/webhelp-common.xsl
2068
2069     Webhelp: Fix header logo link
2070
2071   • David Cramer: xsl/webhelp-common.xsl
2072
2073     Webhelp: Fix bad link to favicon.ico
2074
2075   • David Cramer: template/common/jquery/jquery-1.7.2.min.js; template/common/
2076     main.js; templat⋯
2077
2078     First part of the GSoC 2012 work by Arun and Visitha:
2079
2080     Visitha Baddegama
2081     Remove content folder from Webhelp output
2082     Build Webhelp using GNU Make/without ant
2083     Support a parameterized list of files to exclude while indexing
2084     Improve information message for browser with JavaScript disabled
2085     Support searching for terms with punctuation like build.xml
2086
2087     Arun Bharadwaj
2088     Make it possible to include the doc title in head/title and
2089      not in the search results
2090     Improve performance in IE 8/9
2091     Expandable TOC pane
2092     Information message for browser with JavaScript disabled
2093
2094   • David Cramer: xsl/webhelp-common.xsl
2095
2096     Use user.head.title to add title to webhelp pages,
2097     but do not yet add the book title to the page title.
2098
2099   • David Cramer: xsl/webhelp-common.xsl
2100
2101     Webhelp: Revert 9433. We need to fix the indexer before we can include the document title in the html/head/title
2102
2103   • David Cramer: xsl/webhelp-common.xsl
2104
2105     Webhelp: Append document title to html/head/title
2106
2107   • David Cramer: xsl/webhelp-common.xsl
2108
2109     Webhelp: fix missing reference to ie.css
2110
2111 Params
2112
2113 The following changes have been made to the params code since the 1.77.1
2114 release.
2115
2116   • Robert Stayton: page.height.portrait.xml; page.width.portrait.xml
2117
2118     Add USlegal and USlegallandscape.
2119
2120   • Robert Stayton: force.blank.pages.xml
2121
2122     Improve the description.
2123
2124   • Robert Stayton: page.margin.outer.xml; writing.mode.xml; double.sided.xml;
2125     page.margin.inn⋯
2126
2127     Improve the description.
2128
2129   • Robert Stayton: force.blank.pages.xml
2130
2131     New param to control generating blank even-numbered pages.
2132
2133   • Robert Stayton: passivetex.extensions.xml
2134
2135     Indicate that passivetex is no longer supported.
2136
2137   • Robert Stayton: footnote.properties.xml
2138
2139     Fix bug #3555628 where a footnote inside a blockquote inherits the end-indent from the blockquote.
2140
2141   • stefan: foil.page-sequence.properties.xml; handoutnotes.properties.xml;
2142     slidy.duration.xml⋯
2143
2144     Merge Slides GSoC project to trunk.
2145
2146   • Robert Stayton: activate.external.olinks.xml
2147
2148     Add parameter 'activate.external.olinks' to allow making
2149     external olinks inactive, as for epub output.
2150
2151 Profiling
2152
2153 The following changes have been made to the profiling code since the 1.77.1
2154 release.
2155
2156   • Robert Stayton: xsl2profile.xsl
2157
2158     Test for @xml:id as well as @id for $rootid.
2159
2160 Tools
2161
2162 The following changes have been made to the tools code since the 1.77.1
2163 release.
2164
2165   • David Cramer: bin/docbook-xsl-update
2166
2167     s/VERSION/VERSION.xsl/ again.
2168
2169   • David Cramer: xsl/build/xsl-param-link.xsl; xsl/build/make-xsl-params.xsl
2170
2171     Slides: Change html to xhtml passim.
2172
2173 Template
2174
2175 The following changes have been made to the template code since the 1.77.1
2176 release.
2177
2178   • Jirka Kosek: titlepage.xsl
2179
2180     Autoguess of proper parameter settings
2181
2182 Release Notes: 1.77.1
2183
2184 The following list summarizes the major changes that have been made since the
2185 1.76.1 release. It is followed by sections detailing changes to individual
2186 files from the SVN checkin logs, edited to remove housekeeping changes and bug
2187 fixes. See the NEWS.xml file for a complete unedited list of SVN changes.
2188
2189   • Gentext
2190
2191     webhelp
2192
2193         Many improvements to the generated text for webhelp output.
2194
2195   • Common
2196
2197     Support more media types
2198
2199         Expanded list of supported filename extensions for media to include
2200         video and audio, mostly for HTML5 and EPUB3 outputs.
2201
2202     Topic element
2203
2204         Add basic support for new topic element, which is available in DocBook
2205         5.1. Generally a topic element will be used with assembly and may be
2206         transformed to some other hierarchical element during processing, but
2207         it can also be formatted as a plain topic.
2208
2209   • FO
2210
2211     Add para.properties attribute-set
2212
2213         Add a para.properties attribute-set that applies only to para elements.
2214         That allows still using normal.para.spacing attribute-set for many
2215         block elements for uniform spacing, but allows separate formatting of
2216         para elements.
2217
2218     List of titles in article
2219
2220         Add support for List of Tables, List of Figures, etc. for articles and
2221         other component-level elements. Includes a new template for each in
2222         autotoc.xsl, new attribute-sets in titlepage.xsl, and new entries in
2223         the titlepage.templates.xml file tu support customization.
2224
2225     Customizing links in FO
2226
2227         Add template mode simple.xlink.properties to allow easy customization
2228         of formatting of links generated from elements that use the xlink
2229         attributes. This extends link formatting beyond that of xref, link, and
2230         olink which use xref.properties attribute-set.
2231
2232     Table caption
2233
2234         The caption element in an HTML table is now handled like a title in a
2235         CALS table, using the formal.object.title template with all its
2236         features, including placement. Now caption template in mode="htmlTable"
2237         does nothing, because caption handled by formal.object.title template.
2238         Also adds support for table caption element in a CALS table, placing it
2239         after the table.
2240
2241     Graphics attribute handling
2242
2243         Refactored the big process.image template to use individual templates
2244         such as image.width for most attributes to allow easier customization
2245         of individual properties.
2246
2247     Side regions
2248
2249         Add support for side page regions in addition to header and footer
2250         regions. This feature lets you add running content to the side margins,
2251         and by default the content is rotated 90 degrees. Adds new templates
2252         named running.side.content, region.inner and region.outer; new template
2253         modes region.inner.mode and region.outer.mode; new parameters named
2254         region.inner.extent, region.outer.extent, body.margin.inner,
2255         body.margin.outer, and side.region.precedence; and new attribute-sets
2256         named inner.region.content.properties, outer.region.content.properties,
2257         region.inner.properties, and region.outer.properties.
2258
2259     Callout formatting
2260
2261         Add new attribute-sets for calloutlist.
2262
2263     Topic element
2264
2265         Add basic support for formatting a topic element, which is available in
2266         DocBook 5.1.
2267
2268   • HTML
2269
2270     HTML5
2271
2272         Add variables to the base HTML stylesheets that can be adjusted for the
2273         HTML5 stylesheets.
2274
2275     Insert Javascript reference
2276
2277         Add support for html.script param to insert reference to a Javascript
2278         file.
2279
2280     Namespace for titlepage mechanism.
2281
2282         Titlepage mechanism is now namespace aware to support XHTML.
2283
2284     Chunked filename prefix
2285
2286         New param named chunked.filename.prefix lets you add a filename prefix
2287         to each chunked file. This replaces the buggy practice of adding such a
2288         prefix to the base.dir param. Now the base.dir param will always have a
2289         trailing slash added if it is not present, so you no longer have to
2290         remember to add it to the param value.
2291
2292     Generate id attributes
2293
2294         The stylesheet param generate.id.attributes already existed but was
2295         incompletely implemented. Now when it is set to 1, only id attributes
2296         should be output, not <a name> named anchors.
2297
2298     Generate consistent id attributes
2299
2300         New generate.consistent.ids parameter which allows generating a more
2301         stable id values based on XPath rather than the generate-id() function,
2302         which may not produce consistent values between runs. Stable output ids
2303         allow you to make stable links to generated content from the outside.
2304
2305     Topic element
2306
2307         Add basic support for formatting a topic element, which is available in
2308         DocBook 5.1. Generally a topic element will be used with assembly and
2309         may be transformed to some other hierarchical element during
2310         processing, but it can also be formatted as a plain topic.
2311
2312   • Webhelp
2313
2314     Webhelp refactored
2315
2316         Webhelp templates refactored to better support customization.
2317
2318     Added documentation.
2319
2320         More and better documentation added.
2321
2322     Webhelp generated text
2323
2324         Many improvements to the generated text for webhelp output.
2325
2326   • XHTML5
2327
2328     New stylesheets to generate HTML5 output, in an XML serialization. These
2329     templates are a customization layer on top of the XHTML stylesheet files.
2330
2331   • EPUB3
2332
2333     New stylesheets to generate EPUB3 output. These templates are a
2334     customization layer on top of the xhtml5 stylesheet files.
2335
2336   • Assembly
2337
2338     New assembly.xsl stylesheet to convert a DocBook 5.1 assembly into a
2339     standard DocBook 5 document. Also includes a topic-maker-chunk.xsl
2340     stylesheet that can convert a DocBook 5 book or article document into an
2341     assembly with a collection of modular files, including converting some
2342     elements to topic files.
2343
2344 Gentext
2345
2346 The following changes have been made to the gentext code since the 1.76.1
2347 release.
2348
2349   • stefanhinz: locale/de.xml
2350
2351     Translated German WebHelp strings
2352
2353   • David Cramer: locale/zh.xml; locale/en.xml; locale/fr.xml; locale/de.xml;
2354     locale/ja.xml
2355
2356     Webhelp: Update non-en gentext strings
2357
2358   • Robert Stayton: locale/en.xml
2359
2360     Add topic to title-numbered context.
2361
2362   • Robert Stayton: locale/en.xml
2363
2364     Add basic topic element templates.
2365
2366   • Mauritz Jeanson: locale/el.xml
2367
2368     Updated gentext for quotation marks. Fixes bug #3512440.
2369
2370   • Jirka Kosek: locale/cs.xml
2371
2372     Adding missing context for webhelp
2373
2374   • David Cramer: locale/en.xml
2375
2376     Fixing syntax of webhelp gentext entries
2377
2378   • David Cramer: locale/en.xml
2379
2380     Moving webhelp gentext strings into a context
2381
2382   • tom_schr: locale/zh.xml; locale/en.xml; locale/cs.xml; locale/fr.xml;
2383     locale/de.xml; local⋯
2384
2385     Moved language specific of WebHelp to gentext/locale/ as discussed with
2386     Stefan following the "minimal intrusive approach". :)
2387     In the long run, maybe moving the text into a context, not sure.
2388
2389   • Jirka Kosek: locale/ru.xml
2390
2391     Aligned capitalization of first letters with English original
2392
2393 Common
2394
2395 The following changes have been made to the common code since the 1.76.1
2396 release.
2397
2398   • Robert Stayton: common.xsl
2399
2400     In "select.mediaobject.index" template, add selection of videoobject
2401     and audioobject since now supported in HTML5.
2402
2403   • Robert Stayton: labels.xsl; titles.xsl; entities.ent; targets.xsl;
2404     subtitles.xsl; gentext.⋯
2405
2406     Add basic support for new <topic> element.
2407
2408   • Robert Stayton: common.xsl
2409
2410     Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.
2411
2412   • Robert Stayton: olink.xsl
2413
2414     Generate error message if olink data in targetset is in a namespace.
2415
2416   • Robert Stayton: common.xsl
2417
2418     Add support for generate.consistent.ids parameter.
2419
2420   • Robert Stayton: subtitles.xsl
2421
2422     Add verbose param to subtitle.markup templates to allow its
2423     error message to be ignored.
2424     Add that param to fop1.xsl application of subtitle.markup
2425     to avoid unnecessary error message in document information.
2426
2427   • Robert Stayton: labels.xsl
2428
2429     Add empty templates for glossdiv, glosslist, and glossentry in
2430     mode="label.markup".
2431
2432 FO
2433
2434 The following changes have been made to the fo code since the 1.76.1 release.
2435
2436   • Robert Stayton: graphics.xsl
2437
2438     qualify caption template to mediaobject/caption so not confused with table/caption.
2439
2440   • Robert Stayton: table.xsl
2441
2442     Add template to process table/caption element.
2443
2444   • Robert Stayton: titlepage.xsl; autotoc.xsl; component.xsl; xref.xsl;
2445     titlepage.templates.x⋯
2446
2447     Add basic support for new <topic> element.
2448
2449   • Robert Stayton: graphics.xsl
2450
2451     Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.
2452
2453   • Robert Stayton: titlepage.xsl
2454
2455     Add default style att-sets for component.list.of.titles, etc.
2456
2457   • Robert Stayton: autotoc.xsl; component.xsl; titlepage.templates.xml
2458
2459     Add make.component.tocs to support lists of tables, etc. for
2460     article and other components.  Added component.list.of.tables to
2461     titlepage.templates.xml to format the title.
2462
2463   • Robert Stayton: param.xweb; param.ent
2464
2465     Add new para.properties attribute-set for paragraphs.
2466
2467   • Robert Stayton: inline.xsl
2468
2469     Add template mode 'simple.xlink.properties' to allow
2470     easy customization of formatting of links generated
2471     from elements other than xref, link, and olink using
2472     the xlink attributes.
2473
2474   • Robert Stayton: param.xweb; param.ent
2475
2476     Add table.caption.properties to format table captions.
2477
2478   • Robert Stayton: table.xsl
2479
2480     Add support for caption in a CALS table.
2481
2482   • Robert Stayton: graphics.xsl; math.xsl
2483
2484     Refactored the 'process.image' template to create modular
2485     templates for each attribute so they can be individually
2486     customized.  Also merged in support for embedded svg and
2487     mml content so they can have image attributes too.
2488
2489   • Robert Stayton: param.xweb; param.ent
2490
2491     Check in new params for FO side regions in page masters.
2492
2493   • Robert Stayton: titlepage.xsl; titlepage.templates.xml
2494
2495     Add support for itermset in info elements, using titlepage mechanism
2496     to ensure entries are placed inside page-sequence.
2497
2498   • Robert Stayton: pagesetup.xsl
2499
2500     Add support for side body margins and side static content regions.
2501     Fixes bug 3389931.
2502
2503   • Robert Stayton: param.xweb; param.ent; task.xsl
2504
2505     Add attribute-set task.properties to task element to
2506     support customization.
2507
2508   • Robert Stayton: lists.xsl; param.xweb; param.ent
2509
2510     Add new attribute-sets calloutlist.properties and callout.properties
2511     to  better support customization of calloutlists, fixing bug 3160341.
2512
2513   • Jirka Kosek: Makefile
2514
2515     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.
2516
2517   • Robert Stayton: graphics.xsl
2518
2519     Allow selection by role for multiple imageobject elements
2520     within an imageobjectco, which since Docbook 5 allows multiple imageobjects.
2521
2522   • Mauritz Jeanson: titlepage.xsl
2523
2524     Added template for collabname. Fixes bug #3414436.
2525
2526   • David Cramer: verbatim.xsl
2527
2528     Support the keep-together processing-instruction on programlisting, screen, synopsis, and literallayout. Tracker id #3396906.
2529
2530   • Robert Stayton: pagesetup.xsl
2531
2532     Pass the pageclass, sequence, and gentext-key to the template
2533     named header.footer.widths to enable further customization
2534     based on page master.
2535
2536   • Jirka Kosek: xref.xsl
2537
2538     hyphenation of URL content must be disabled for link, not only for ulink because od DB5
2539
2540   • Jirka Kosek: xref.xsl
2541
2542     URLs shouldn't be hyphenated as normal text
2543
2544   • Jirka Kosek: callout.xsl
2545
2546     Added support for alternative circled numbers
2547
2548   • Mauritz Jeanson: axf.xsl; fop1.xsl; xep.xsl
2549
2550     Added support for author/orgname in document metadata. Closes bug #3132862.
2551
2552   • Robert Stayton: component.xsl
2553
2554     Add template for article/colophon to avoid nested page-sequence.
2555
2556 HTML
2557
2558 The following changes have been made to the html code since the 1.76.1 release.
2559
2560   • Robert Stayton: xref.xsl
2561
2562     Add support for using info/title as well as title in target element.
2563
2564   • Robert Stayton: component.xsl
2565
2566     Enable support for html5 features, including using <section> instead of
2567     <div> for certain elements, and setting heading level to <h1> for chapters.
2568     These features are not changed in the base html stylesheet for backwards
2569     compatibility.
2570
2571   • Robert Stayton: docbook.css.xml
2572
2573     Add style for footnote rule.
2574
2575   • Robert Stayton: biblio-iso690.xsl
2576
2577     Add support for subtitle inside info.
2578
2579   • Robert Stayton: docbook.xsl
2580
2581     Add call to new 'root.attributes' placeholder template to allow
2582     adding attributes to the <html> output element.
2583
2584   • Robert Stayton: inline.xsl; titlepage.xsl; formal.xsl; division.xsl;
2585     toc.xsl; sections.xsl⋯
2586
2587     Finish implementation of generate.id.attributes for all elements
2588     using the template named id.attribute.
2589
2590   • Robert Stayton: autotoc.xsl; chunktoc.xsl; titlepage.xsl; chunk-code.xsl;
2591     changebars.xsl; ⋯
2592
2593     Add basic support for new <topic> element.
2594
2595   • Robert Stayton: graphics.xsl
2596
2597     Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.
2598
2599   • Robert Stayton: callout.xsl; verbatim.xsl
2600
2601     Restore programlisting to use <pre> instead of <div> and instead
2602     wrap callout img elements in <span> to make valid HTML.
2603
2604   • Robert Stayton: graphics.xsl
2605
2606     Turn off img longdesc attribute because not supported by browsers.
2607
2608   • Robert Stayton: footnote.xsl
2609
2610     Move square brackets and <sup> inside <a> element for footnote
2611     marks to fix display problems in some browsers.
2612
2613   • Robert Stayton: param.xweb; param.ent
2614
2615     Add new params html.script and html.script.type to support
2616     Javascript references.
2617
2618   • Robert Stayton: chunk-common.xsl; chunktoc.xsl; titlepage.xsl; chunker.xsl;
2619     chunk-code.xsl⋯
2620
2621     Add support for chunked.filename.prefix param.
2622     Make sure base.dir value has a trailing slash in
2623     the chunk.base.dir internal param used by the templates.
2624
2625   • Robert Stayton: formal.xsl; htmltbl.xsl
2626
2627     Now handles caption in html markup table like title,
2628     so formal.object.title is used with all its features, including
2629     formatting and placement.
2630     Added htmlTable.with.caption template to handle the wrapper, and
2631     left htmlTable template unchanged.
2632     Now caption template in mode="htmlTable" does nothing, because
2633     caption handled by formal.object.title template.
2634
2635   • Robert Stayton: html.xsl
2636
2637     Turn off generating the title attribute for block and hierarchical elements.
2638     Should only be used for inline elements, usually using the alt element.
2639     Also used for links to show the target title.
2640
2641   • Robert Stayton: lists.xsl
2642
2643     The spacing="compact" attribute on lists in HTML no longer outputs compact="compact"
2644     (or just "compact" in the case of Saxon 6), since that attribute is
2645     deprecated and improperly supported.  Instead, the output uses a
2646     multiple class attribute such as class="orderedlist compact".
2647     Use CSS to style such lists without margin above.
2648
2649   • Robert Stayton: graphics.xsl
2650
2651     Allow selection by role for multiple imageobject elements
2652     within an imageobjectco, which since Docbook 5 allows multiple imageobjects.
2653
2654   • Robert Stayton: pi.xsl
2655
2656     Improve doc descriptions of dbhtml filename and dir.
2657
2658   • Robert Stayton: autoidx.xsl
2659
2660     Add setindex to context param in mode="reference" to better
2661     support setindex.
2662
2663   • Robert Stayton: autotoc.xsl
2664
2665     Support set as child of set in set.toc template.
2666
2667   • Robert Stayton: qandaset.xsl
2668
2669     Change question and title templates to replace hard-coded
2670     class="local-name()" with mode="class.attribute" to support customization
2671     of class values.
2672
2673   • Norman Walsh: chunktoc.xsl
2674
2675     Separate book appendixes from article appendixes (so that they can be customized independently)
2676
2677   • Mauritz Jeanson: graphics.xsl
2678
2679     Added condition to prevent "Failed to interpret image" messages (SVG is not supported
2680     by the graphic size extension).
2681
2682 Epub
2683
2684 The following changes have been made to the epub code since the 1.76.1 release.
2685
2686   • Robert Stayton: docbook.xsl
2687
2688     Replace $base.dir with $chunk.base.dir to ensure trailing slash in place.
2689
2690 HTMLHelp
2691
2692 The following changes have been made to the htmlhelp code since the 1.76.1
2693 release.
2694
2695   • Robert Stayton: htmlhelp-common.xsl
2696
2697     Change $base.dir to $chunk.base.dir to ensure trailing slash in place.
2698
2699 Eclipse
2700
2701 The following changes have been made to the eclipse code since the 1.76.1
2702 release.
2703
2704   • Robert Stayton: eclipse.xsl; eclipse3.xsl
2705
2706     Use $chunk.base.dir instead of $base.dir to ensure trailing slash is in place.
2707
2708 JavaHelp
2709
2710 The following changes have been made to the javahelp code since the 1.76.1
2711 release.
2712
2713   • Robert Stayton: javahelp.xsl
2714
2715     Change $base.dir to $chunk.base.dir to ensure trailing slash is present.
2716
2717   • Mauritz Jeanson: javahelp.xsl
2718
2719     Replaced empty header.navigation and footer.navigation templates with parameter suppress.navigation=1,
2720     which simplifies customization. See bug #3310904.
2721
2722 Webhelp
2723
2724 The following changes have been made to the webhelp code since the 1.76.1
2725 release.
2726
2727   • David Cramer: template/common/css/positioning.css
2728
2729     Webhelp: Adding print-only css rules
2730
2731   • David Cramer: template/common/main.js
2732
2733     Webhelp: Arun's fix for bug where heading was partially hidden by header in some situations.
2734
2735   • David Cramer: xsl/webhelp-common.xsl
2736
2737     Webhelp: turn off autolabeling by default
2738
2739   • David Cramer: xsl/webhelp.xsl
2740
2741     Webhelp: Import xhtml base stylesheets
2742
2743   • David Cramer: docsrc/readme.xml
2744
2745     Webhelp: Link to the DocBook reference docs from the webhelp readme
2746
2747   • David Cramer: xsl/webhelp-common.xsl
2748
2749     Webhelp: Use gentext value for noscript warning
2750
2751   • David Cramer: Makefile
2752
2753     Webhelp: Delete tempfile after DocBook xsl build
2754
2755   • David Cramer: xsl/webhelp.xsl
2756
2757     Webhelp: moving parameters into the standard location so they will be part of the parameter reference
2758
2759   • David Cramer: xsl/webhelp.xsl; xsl/webhelp-common.xsl
2760
2761     Webhelp: moving parameters into the standard location so they will be part of the parameter reference
2762
2763   • David Cramer: template/common/main.js
2764
2765     Webhelp: tweaking scrolldown offset for anchors
2766
2767   • David Cramer: docsrc/images; docsrc/images/sample.jpg; docsrc/readme.xml;
2768     template/content⋯
2769
2770     Webhelp: updating docs. Ant version, install instructions, handling of images.
2771
2772   • David Cramer: xsl/webhelp.xsl
2773
2774     Patch from Arun Bharadwaj to display message if JavaScript is disabled
2775
2776   • David Cramer: template/content/search/nwSearchFnt.js
2777
2778     Patch from Arun Bharadwaj to strip quotes from search query strings
2779
2780   • Robert Stayton: xsl/webhelp.xsl
2781
2782     Add basic support for new <topic> element.
2783
2784   • Jirka Kosek: xsl/webhelp.xsl
2785
2786     Put back old extensibility point.
2787
2788     Guys, please don't remove existing extensibility points like named templates, it will break existing customizations.
2789
2790   • David Cramer: xsl/webhelp.xsl
2791
2792     Moving webhelp gentext strings into a context
2793
2794   • tom_schr: param.ent
2795
2796     Disabled branding and brandname entities for the time being
2797
2798   • tom_schr: param.xweb; param.ent
2799
2800     Prepared WebHelp reference documentation :)
2801     Not clear about parameters brandname and branding: Should they renamed
2802     to "webhelp.branding" and "webhelp.brandname"?
2803     Currently, docsrc/reference.xml contains only a comment for the WebHelp
2804     ref doc to be non-intrusive.
2805     Idea is to enable it when it is ready
2806
2807   • tom_schr: xsl/webhelp.xsl
2808
2809     Moved language specific of WebHelp to gentext/locale/ as discussed with
2810     Stefan following the "minimal intrusive approach". :)
2811     In the long run, maybe moving the text into a context, not sure.
2812
2813   • David Cramer: template/common/css/positioning.css
2814
2815     Webhelp: Lower the minimum width of content pane
2816
2817   • kasunbg: xsl/webhelp.xsl; template/common/main.js
2818
2819     If an user moved to another page by clicking on a toc link, and then clicked on #searchDiv,
2820     search should be performed if the cookie textToSearch is not empty.
2821
2822   • David Cramer: xsl/webhelp.xsl
2823
2824     Webhelp: Left align titles in nav header. Display  for all but the topmost page
2825
2826   • David Cramer: template/content/search/stemmers/en_stemmer.js; docsrc/
2827     xinclude-test.xml
2828
2829     Webhelp: Cleanup related to en_stemmer.js changes
2830
2831   • David Cramer: template/common/css/positioning.css
2832
2833     Webhelp: Don't put borders around qandaset list
2834
2835   • David Cramer: template/common/main.js
2836
2837     Webhelp: Avoid unnecessary scroll ups when anchor is clicked on
2838
2839   • David Cramer: build.properties
2840
2841     Webhelp: Show footer nav by default
2842
2843   • David Cramer: build.properties; build.xml
2844
2845     Webhelp: Support setting suppress.footer.navigation from build.properties
2846
2847   • David Cramer: build.properties; build.xml
2848
2849     Webhelp: Support admon.graphics param in build.properties
2850
2851   • David Cramer: docsrc/xinclude-test.xml; docsrc/readme.xml
2852
2853     Webhelp: Adding xinclude example to the demo/readme doc
2854
2855   • David Cramer: template/common/css/positioning.css
2856
2857     Webhelp: Remove border around table used to format callout list
2858
2859   • David Cramer: xsl/webhelp.xsl; template/common/images/admon/tip.png;
2860     template/common/image⋯
2861
2862     Webhelp: Support admon graphics (still off by default)
2863
2864   • David Cramer: xsl/webhelp.xsl; template/common/css/positioning.css
2865
2866     Webhelp: Turn on navfooter and fix related css
2867
2868   • David Cramer: xsl/webhelp.xsl
2869
2870     Webhelp: Fix error about undeclared doc.title param
2871
2872   • David Cramer: docsrc/readme.xml
2873
2874     Webhelp: Adding some test search terms to the readme
2875
2876   • David Cramer: template/content/search/stemmers/en_stemmer.js
2877
2878     Handle exceptional cases listed in the Porter 2 stemming algo
2879
2880   • David Cramer: template/content/search/stemmers/en_stemmer.js
2881
2882     Webhelp: adding special case word 'say' to en js stemmer
2883
2884   • David Cramer: template/content/search/stemmers/en_stemmer.js
2885
2886     Webhelp: Refine stemming of terms that end in (only stem if there's a consonant before the -y)
2887
2888   • David Cramer: template/content/search/stemmers/en_stemmer.js; template/
2889     content/search/nwSe⋯
2890
2891     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
2892
2893   • David Cramer: build.xml
2894
2895     Webhelp: Support xinclude and two-pass profiling in build.xml
2896
2897   • David Cramer: xsl/webhelp.xsl
2898
2899     Fix bad link to default topic.
2900
2901   • kasunbg: docsrc/readme.xml
2902
2903     Automatically limit the size of the search description to something 140 characters
2904
2905   • kasunbg: xsl/webhelp.xsl
2906
2907     removing outline in 'contents' and 'search' buttons that is visible when clicked. tabindex for SIDEBAR button.
2908
2909   • kasunbg: xsl/webhelp.xsl; build.xml
2910
2911     Webhelp ant script changes - HTML transformation support for WebHelp - Uses Tagsoup for parsing the bad html.
2912     tagsoup-1.2.1.jar is added to trunk/xsl-webhelpindexer/lib/
2913
2914   • kasunbg: xsl/webhelp.xsl
2915
2916     proper support for saxon xhtml transformation.
2917
2918   • kasunbg: template/common/images/callouts/10.png; template/common/images/
2919     callouts/11.png; t⋯
2920
2921     webhelp - adding callouts
2922
2923   • kasunbg: xsl/webhelp.xsl; template/common/main.js; template/common/css/
2924     positioning.css
2925
2926     webhelp - animations for show/hide Sidebar
2927
2928   • kasunbg: build.properties
2929
2930     commenting about brand and brandname
2931
2932   • kasunbg: Makefile
2933
2934     parameterized MAKE for webhelp
2935
2936   • kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css;
2937     build.properties; build.xml
2938
2939     webhelp xsl customization - logo
2940
2941   • kasunbg: template/content/search/nwSearchFnt.js
2942
2943     remove some JS warninings
2944
2945   • kasunbg: template/content/search/nwSearchFnt.js
2946
2947     Fix for missing "No results found for..." bug
2948
2949   • kasunbg: xsl/webhelp.xsl
2950
2951     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.
2952
2953   • Jirka Kosek: xsl/webhelp.xsl; template/common/css/positioning.css
2954
2955     Minor cleanup, added extensibility hook, some styling moved into CSS for easier customization
2956
2957   • David Cramer: template/content/search/nwSearchFnt.js
2958
2959     Removing onclick that came from Oxygen's dita stuff
2960
2961   • kasunbg: docsrc/readme.xml
2962
2963     webhelp - documenting about features
2964
2965   • kasunbg: template/common/css/positioning.css
2966
2967     webhelp search text box
2968
2969   • kasunbg: template/common/css/positioning.css
2970
2971     adding header background image
2972
2973   • kasunbg: xsl/webhelp.xsl; template/common/images/header-bg.png
2974
2975     new header background image
2976
2977   • kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css
2978
2979     fix left navigation
2980
2981   • kasunbg: template/common/css/positioning.css
2982
2983     some css
2984
2985   • kasunbg: build.xml
2986
2987     Adding html.extension property
2988
2989   • kasunbg: template/common/css/positioning.css; build.properties; build.xml
2990
2991     webhelp - Adding enable.stemming, toc.file build properties
2992
2993   • David Cramer: template/common/css/positioning.css
2994
2995     Make the webhelp banner slightly larger.
2996
2997   • David Cramer: template/common/main.js; template/common/css/positioning.css
2998
2999     Adjust colors and positioning of header and search/toc tabs
3000
3001   • David Cramer: xsl/webhelp.xsl
3002
3003     Only put doc title in header
3004
3005   • David Cramer: template/common/css/positioning.css; template/common/images/
3006     main_bg_fade.png
3007
3008     Adjusting default color of the header
3009
3010   • kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css
3011
3012     adjustments to header title. Now output in Opera looks good.
3013
3014   • kasunbg: template/common/images/sidebar.png; template/content/search/
3015     punctuation.props; te⋯
3016
3017     deleting svn:executable flag from webhelp files
3018
3019   • kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css; template/
3020     common/images/sear⋯
3021
3022     Customized the left navagation headers; Contents and Search.
3023     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.
3024
3025   • kasunbg: docsrc/readme.xml
3026
3027     typo fix
3028
3029   • kasunbg: template/common/images/next-arrow.png; xsl/webhelp.xsl; template/
3030     common/main.js; ⋯
3031
3032     UI improvements.
3033             Moved search highligher to search tab.
3034             Added nice icons for navigation buttons etc.
3035             Removed footer navigation
3036             Corrected tree colorings
3037             Overall, some css magic
3038
3039   • David Cramer: docsrc/readme.xml
3040
3041     Added listitem thinking SyncRO Soft for their contributions.
3042
3043   • kasunbg: build.xml
3044
3045     support for default classpath for Gentoo Linux
3046
3047   • kasunbg: docsrc/readme.xml
3048
3049     webhelp - some updates to the documentation about search
3050
3051   • kasunbg: template/common/css/positioning.css
3052
3053     Fix for issue 'Keep "search" & "contents" titles always visible in webhelp - ID: 3403438'
3054
3055   • David Cramer: template/common/images/starsSmall.png
3056
3057     Changed icons used to show search weightings from stars to boxes so they won't look like user ratings
3058
3059   • David Cramer: xsl/webhelp.xsl; template/common/main.js; template/common/
3060     images/starsSmall.⋯
3061
3062     Merged Oxygen webhelp improvements (search weightings etc) into trunk: -r9031:9039
3063
3064   • kasunbg: docsrc/readme.xml
3065
3066     webhelp documentation - search indexing, faq
3067
3068   • kasunbg: docsrc/readme.xml
3069
3070     update webhelp documentation
3071
3072   • David Cramer: xsl/webhelp.xsl
3073
3074     Fixed bug where webhelp.default.topic was not being used if it was set
3075
3076   • David Cramer: xsl/webhelp.xsl; template/content/search/nwSearchFnt.js
3077
3078     Localize string in nwSearchFnt.js file
3079
3080   • David Cramer: xsl/webhelp.xsl
3081
3082     Added tabindex attributes to make tab order in UI more logical in webhelp.
3083
3084   • David Cramer: template/common/main.js
3085
3086     Fixed bug where anchors in pages landed beneath the banner.
3087
3088   • kasunbg: xsl/webhelp.xsl
3089
3090     Added more comments to the xsl/webhelp/xsl/webhelp.xsl file. Removed some clutter.
3091
3092   • David Cramer: template/common/main.js
3093
3094     Fixed problem reported in IE 8. See tracker id # 373747.
3095
3096   • David Cramer: xsl/webhelp.xsl
3097
3098     Addressed tracker #3247166 by removing hard-coded reference to ch01.html.
3099
3100   • kasunbg: build.xml
3101
3102     Changed the webhelp build.xml to reflect the changes to xsl-webhelpindexer.
3103     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
3104
3105   • kasunbg: template/common/images/loading.gif; template/common/jquery/
3106     treeview/jquery.treevi⋯
3107
3108     webhelp: Removing some unnecessary JQuery JS files
3109
3110   • kasunbg: template/common/main.js
3111
3112     webhelp: Usability improvement - when click on a node in the TOC tree, the child nodes will auto populate now.
3113
3114   • kasunbg: xsl/webhelp.xsl
3115
3116     Added google translated localizations for Japanese, German, French, and Chinese. The translations might not be pretty accurate.
3117     Better translations are appreciated.
3118
3119   • kasunbg: docsrc/readme.xml; template/content/images; template/content/
3120     images/sample.jpg
3121
3122     Added documentation for how to add images to WebHelp
3123
3124   • Jirka Kosek: xsl/webhelp.xsl
3125
3126     Added more customization hooks
3127     Search code output only when search tab is active
3128     Added cs localization
3129
3130   • Jirka Kosek: xsl/webhelp.xsl
3131
3132     Added parameter webhelp.common.dir for specifying location of common files (JS+CSS)
3133     Added hooks for adding additional user defined tabs
3134
3135 Params
3136
3137 The following changes have been made to the params code since the 1.76.1
3138 release.
3139
3140   • David Cramer: webhelp.indexer.language.xml
3141
3142     Webhelp: Fixing list of supported languages
3143
3144   • David Cramer: webhelp.indexer.language.xml
3145
3146     Webhelp: Correct language code in docs for Chinese
3147
3148   • Mauritz Jeanson: admon.graphics.extension.xml
3149
3150     Added list of graphics formats.
3151
3152   • Mauritz Jeanson: passivetex.extensions.xml
3153
3154     Updated link.
3155
3156   • tom_schr: webhelp.indexer.language.xml; webhelp.default.topic.xml;
3157     webhelp.tree.cookie.id.⋯
3158
3159     Prepared WebHelp reference documentation :)
3160     Not clear about parameters brandname and branding: Should they renamed
3161     to "webhelp.branding" and "webhelp.brandname"?
3162     Currently, docsrc/reference.xml contains only a comment for the WebHelp
3163     ref doc to be non-intrusive.
3164     Idea is to enable it when it is ready
3165
3166   • Robert Stayton: glossary.collection.xml
3167
3168     Add info about relative paths.
3169
3170   • Robert Stayton: para.properties.xml
3171
3172     Special attribute-set for para only.
3173
3174   • Robert Stayton: table.caption.properties.xml
3175
3176     To format table captions.
3177
3178   • Robert Stayton: html.script.type.xml; html.script.xml
3179
3180     Add support for specifying javascript references like css references.
3181
3182   • Robert Stayton: body.margin.outer.xml; region.outer.extent.xml;
3183     body.margin.inner.xml; reg⋯
3184
3185     Add support for side regions in FO output.
3186
3187   • Robert Stayton: chunked.filename.prefix.xml
3188
3189     New param chunked.filename.prefix to separate any such prefix from
3190     the base.dir param, which helps fix bug 3087359.
3191
3192   • Robert Stayton: generate.consistent.ids.xml
3193
3194     New param to support replacing generate-id() with xsl:number
3195     for more consistent id values.
3196
3197   • Robert Stayton: task.properties.xml
3198
3199     Allow task to be customized more easily.
3200
3201   • Robert Stayton: calloutlist.properties.xml; callout.properties.xml
3202
3203     Support better customization of callout lists.
3204
3205   • Jirka Kosek: callout.unicode.start.character.xml
3206
3207     Added support for alternative circled numbers
3208
3209   • David Cramer: example.properties.xml
3210
3211     Made example.properties use keep-together='auto' like table.properies to avoid problems where example/programlisting takes more than one page
3212
3213   • Mauritz Jeanson: graphicsize.extension.xml
3214
3215     Added info about supported image formats.
3216
3217 Highlighting
3218
3219 The following changes have been made to the highlighting code since the 1.76.1
3220 release.
3221
3222   • Jirka Kosek: csharp-hl.xml
3223
3224     Added LINQ keywords
3225
3226   • Jirka Kosek: delphi-hl.xml
3227
3228     Additional keywords from Yuri Zhilin
3229
3230 Profiling
3231
3232 The following changes have been made to the profiling code since the 1.76.1
3233 release.
3234
3235   • David Cramer: profile-mode.xsl
3236
3237     When profile.* params only consist of space characters, then ignore them.
3238
3239 Lib
3240
3241 The following changes have been made to the lib code since the 1.76.1 release.
3242
3243   • Robert Stayton: lib.xweb
3244
3245     Added two utility templates to make lib.xsl work
3246     without reference to other modules since it is used
3247     that way with profiling/xsl2profile.xsl.
3248
3249   • Robert Stayton: lib.xweb
3250
3251     Fix trim.common.uri.paths to first resolve any ../ in
3252     the paths.
3253
3254 Template
3255
3256 The following changes have been made to the template code since the 1.76.1
3257 release.
3258
3259   • Jirka Kosek: titlepage.xsl
3260
3261     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.
3262
3263 Extensions
3264
3265 The following changes have been made to the extensions code since the 1.76.1
3266 release.
3267
3268   • kasunbg: Makefile
3269
3270     webhelp - Adding enable.stemming, toc.file build properties
3271
3272   • David Cramer: Makefile
3273
3274     Attempt to convince Makefile that webhelpindexer is dirty
3275
3276 XSL-Saxon
3277
3278 The following changes have been made to the xsl-saxon code since the 1.76.1
3279 release.
3280
3281   • Mauritz Jeanson: src/com/nwalsh/saxon/Verbatim.java; src/com/nwalsh/saxon/
3282     FormatGraphicCal⋯
3283
3284     Added fixes to ensure that generated XHTML markup for callouts is in the proper namespace.
3285
3286 Release Notes: 1.77.1
3287
3288 The following is a list of changes that have been made since the 1.77.0
3289 release.
3290
3291 FO
3292
3293 The following changes have been made to the fo code since the 1.77.0 release.
3294
3295   • Robert Stayton: docbook.xsl
3296
3297     Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
3298     from the filename.
3299
3300   • Robert Stayton: block.xsl
3301
3302     In sidebar, turn off space before first para if there is no title.
3303
3304   • Robert Stayton: math.xsl
3305
3306     Restored templates for mml:* elements that were accidentally deleted.
3307
3308 HTML
3309
3310 The following changes have been made to the html code since the 1.77.0 release.
3311
3312   • Robert Stayton: docbook.xsl
3313
3314     Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
3315     from the filename.
3316
3317   • Robert Stayton: sections.xsl
3318
3319     Use $div.element variable in place of div to support html5 section element.
3320     output
3321
3322   • Robert Stayton: autoidx.xsl
3323
3324     Fix bug 3528673, missing "separator" param on template with
3325     match="indexterm" mode="reference".  That param is passed
3326     for endofrange processing to output the range separator.
3327
3328 Roundtrip
3329
3330 The following changes have been made to the roundtrip code since the 1.77.0
3331 release.
3332
3333   • Robert Stayton: dbk2ooo.xsl; dbk2pages.xsl; dbk2wordml.xsl; dbk2wp.xsl
3334
3335     Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
3336     from the filename.
3337
3338 Slides
3339
3340 The following changes have been made to the slides code since the 1.77.0
3341 release.
3342
3343   • Robert Stayton: html/slides-common.xsl
3344
3345     Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
3346     from the filename.
3347
3348 Website
3349
3350 The following changes have been made to the website code since the 1.77.0
3351 release.
3352
3353   • Robert Stayton: website-common.xsl
3354
3355     Import the VERSION.xsl file instead of VERSION so mimetype is interpreted correctly
3356     from the filename.
3357
3358 Webhelp
3359
3360 The following changes have been made to the webhelp code since the 1.77.0
3361 release.
3362
3363   • kasunbg: docsrc/readme.xml
3364
3365     updated webhelp documentation
3366
3367   • kasunbg: template/content/search/nwSearchFnt.js; xsl/webhelp-common.xsl
3368
3369     Removed the script htmlFileList.js since it's content is in htmlFileInfoList.js
3370
3371   • Robert Stayton: xsl/webhelp-common.xsl
3372
3373     In the <h1> output, replace call to 'get.doc.title' with
3374     mode="title.markup" because get.doc.title returns only
3375     the string value of the title, losing any markup such
3376     as <trademark> or <superscript>.
3377
3378   • kasunbg: template/common/css/positioning.css; template/content/search/
3379     nwSearchFnt.js
3380
3381     Remove unnecessary bits of code from webhelp
3382
3383   • David Cramer: docsrc/readme.xml
3384
3385     Webhelp: Minor edits to the readme
3386
3387   • David Cramer: xsl/webhelp.xsl; xsl/titlepage.templates.xsl; xsl/
3388     titlepage.templates.xml
3389
3390     Webhelp: Suppress abstracts from titlepages. These are used to create the search result summary sentence and should not be shown
3391
3392   • David Cramer: build.xml
3393
3394     Webhelp: calculate path to profile.xsl from main build.xml file
3395
3396 Release Notes: 1.76.1
3397
3398 The following is a list of changes that have been made since the 1.76.0
3399 release.
3400
3401 FO
3402
3403 The following changes have been made to the fo code since the 1.76.0 release.
3404
3405   • Robert Stayton: docbook.xsl; xref.xsl; fop1.xsl
3406
3407     Apply patch to support named destination in fop1.xsl, per Sourceforge
3408     bug report #3029845.
3409
3410 HTML
3411
3412 The following changes have been made to the html code since the 1.76.0 release.
3413
3414   • Keith Fahlgren: highlight.xsl
3415
3416     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)
3417
3418 Params
3419
3420 The following changes have been made to the params code since the 1.76.0
3421 release.
3422
3423   • Robert Stayton: draft.mode.xml
3424
3425     Change default for draft.mode to 'no'.
3426
3427 Release Notes: 1.76.0
3428
3429 This release includes important bug fixes and adds the following significant
3430 feature changes:
3431
3432 Webhelp
3433
3434     A new browser-based, cross-platform help format with full-text search and
3435     other features typically found in help systems. See webhelp/docs/content/
3436     ch01.html for more information and a demo.
3437
3438 Gentext
3439
3440     Many updates and additions to translation/locales thanks to Red Hat, the
3441     Fedora Project, and other contributors.
3442
3443 Common
3444
3445     Faster localization support, as language files are loaded on demand.
3446
3447 FO
3448
3449     Support for SVG content in imagedata added.
3450
3451 HTML
3452
3453     Output improved when using 'make.clean.html' and a stock CSS file is now
3454     provided.
3455
3456 EPUB
3457
3458     A number of improvements to NCX, cover and image selection, and XHTML 1.1
3459     element choices
3460
3461 The following is a list of changes that have been made since the 1.75.2
3462 release.
3463
3464 Gentext
3465
3466 The following changes have been made to the gentext code since the 1.75.2
3467 release.
3468
3469   • rlandmann: locale/fa.xml
3470
3471                 Update to Persian translation from the Fedora Project
3472
3473
3474   • rlandmann: locale/nds.xml
3475
3476                 Locale for Low German
3477
3478
3479   • Mauritz Jeanson: locale/ka.xml; Makefile
3480
3481                 Added support for Georgian based on patch #2917147.
3482
3483
3484   • rlandmann: locale/nl.xml; locale/ja.xml
3485
3486                 Updated translations from Red Hat and the Fedora Project
3487
3488
3489   • rlandmann: locale/bs.xml; locale/ru.xml; locale/hr.xml
3490
3491                 Updated locales from Red Hat and the Fedora Project
3492
3493
3494   • rlandmann: locale/pt.xml; locale/cs.xml; locale/es.xml; locale/bg.xml;
3495     locale/nl.xml; loca⋯
3496
3497                 Updated translations from Red Hat and the Fedora Project
3498
3499
3500   • rlandmann: locale/as.xml; locale/bn_IN.xml; locale/ast.xml; locale/ml.xml;
3501     locale/te.xml; ⋯
3502
3503                 New translations from Red Hat and the Fedora Project
3504
3505
3506   • rlandmann: locale/pt.xml; locale/ca.xml; locale/da.xml; locale/sr.xml;
3507     locale/ru.xml; loca⋯
3508
3509                 Updated translations from Red Hat and the Fedora Project
3510
3511
3512 Common
3513
3514 The following changes have been made to the common code since the 1.75.2
3515 release.
3516
3517   • Mauritz Jeanson: common.xsl
3518
3519                 Fixed bug in output-orderedlist-starting-number template (@startingnumber did not work for FO).
3520
3521
3522   • Mauritz Jeanson: gentext.xsl
3523
3524                 Added fix to catch ID also of descendants of listitem. Closes bug #2955077.
3525
3526
3527   • Jirka Kosek: l10n.xsl
3528
3529                 Stripped down, faster version of gentext.template is used when there is no localization customization.
3530
3531
3532   • Mauritz Jeanson: stripns.xsl
3533
3534                 Added fix that preserves link/@role (makes links in the reference documentation
3535     with @role="tcg" work).
3536
3537
3538   • Mauritz Jeanson: l10n.xsl
3539
3540                 Fixed bugs related to manpages and L10n.
3541
3542
3543   • Jirka Kosek: entities.ent; autoidx-kosek.xsl
3544
3545                 Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.
3546
3547
3548   • Jirka Kosek: l10n.xsl; l10n.dtd; l10n.xml; autoidx-kosek.xsl
3549
3550                 Refactored localization support. Language files are loaded on demand. Speedup is about 30%.
3551
3552
3553   • Jirka Kosek: l10n.xsl
3554
3555                 Added xsl:keys for improved performance of localization texts look up. Performance gain around 15%.
3556
3557
3558   • Mauritz Jeanson: titles.xsl
3559
3560                 Fixed bug #2912677 (error with xref in title).
3561
3562
3563   • Robert Stayton: olink.xsl
3564
3565                 Fix bug in xrefstyle "title" handling introduced with
3566     the 'insert.targetdb.data' template.
3567
3568
3569   • Robert Stayton: gentext.xsl
3570
3571                 Fix bug in xref to equation without title to use context="xref-number" instead
3572     of "xref-number-and-title".
3573
3574
3575   • Robert Stayton: labels.xsl
3576
3577                 Number all equations in one sequence, with or without title.
3578
3579
3580   • Robert Stayton: entities.ent
3581
3582                 Fix bug #2896909 where duplicate @sortas on indexterms caused
3583     some indexterms to drop out of index.
3584
3585
3586   • Robert Stayton: stripns.xsl
3587
3588                 Expand the "Stripping namespace ..." message to advise users to
3589     use the namespaced stylesheets.
3590
3591
3592   • Robert Stayton: stripns.xsl
3593
3594                 need a local version of $exsl.node.set.available variable because
3595     this module imported many places.
3596
3597
3598   • Mauritz Jeanson: olink.xsl
3599
3600                 Added /node() to the select expression that is used to compute the title text
3601     so that no <ttl> elements end up in the output. Closes bug #2830119.
3602
3603
3604 FO
3605
3606 The following changes have been made to the fo code since the 1.75.2 release.
3607
3608   • Robert Stayton: table.xsl
3609
3610                 Fix bug 2979166 able - Attribute @rowheader not working
3611
3612
3613   • Mauritz Jeanson: inline.xsl
3614
3615                 Improved glossterm auto-linking by using keys. The old code was inefficient when processing documents
3616     with many inline glossterms.
3617
3618
3619   • Robert Stayton: titlepage.xsl
3620
3621                 Fix bug 2805530 author/orgname not appearing on title page.
3622
3623
3624   • Mauritz Jeanson: graphics.xsl
3625
3626                 Added support for SVG content in imagedata (inspired by patch #2909154).
3627
3628
3629   • Mauritz Jeanson: table.xsl
3630
3631                 Removed superfluous test used when computing column-width. Closes bug #3000898.
3632
3633
3634   • Mauritz Jeanson: inline.xsl
3635
3636                 Added missing <xsl:call-template name="anchor"/>. Closes bug #2998567.
3637
3638
3639   • Mauritz Jeanson: lists.xsl
3640
3641                 Added table-layout="fixed" on segmentedlist table (required by XSL spec when  proportional-column-width() is used).
3642
3643
3644   • Jirka Kosek: autoidx-kosek.xsl
3645
3646                 Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.
3647
3648
3649   • Jirka Kosek: index.xsl
3650
3651                 Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.
3652
3653
3654   • Robert Stayton: xref.xsl
3655
3656                 Fix bug in olink template when an olink has an id.
3657     Add warning message with id value when trying to link
3658     to an element that has no generated text.
3659
3660
3661   • Mauritz Jeanson: refentry.xsl
3662
3663                 Fixed bug #2930968 (indexterm in refmeta not handled correctly).
3664
3665
3666   • Robert Stayton: block.xsl
3667
3668                 fix bug 2949567 title in revhistory breaks FO transform.
3669
3670
3671   • Robert Stayton: glossary.xsl
3672
3673                 Output id attributes on glossdiv blocks so they can be added to
3674     xrefs or TOC.
3675
3676
3677   • Jirka Kosek: xref.xsl
3678
3679                 Enabled hyphenation of URLs when ulink content is the same as link target
3680
3681
3682   • Robert Stayton: table.xsl
3683
3684                 Apply patch to turn off row recursion if no @morerows attributes present.
3685     This will enable very large tables without row spanning to
3686     process without running into recursion limits.
3687
3688
3689   • Robert Stayton: formal.xsl
3690
3691                 Format equation without title using table layout with equation number
3692     next to the equation.
3693
3694
3695   • Robert Stayton: param.xweb; param.ent
3696
3697                 Add equation.number.properties.
3698
3699
3700 HTML
3701
3702 The following changes have been made to the html code since the 1.75.2 release.
3703
3704   • Mauritz Jeanson: block.xsl
3705
3706                 Modified acknowledgements template to avoid invalid output (<p> in <p>).
3707
3708
3709   • Mauritz Jeanson: titlepage.xsl
3710
3711                 Added default sidebar attribute-sets.
3712
3713
3714   • Robert Stayton: table.xsl
3715
3716                 Fix bug 2979166 able - Attribute @rowheader not working
3717
3718
3719   • Robert Stayton: footnote.xsl
3720
3721                 Fix bug 3033191 footnotes in html tables.
3722
3723
3724   • Mauritz Jeanson: inline.xsl
3725
3726                 Improved glossterm auto-linking by using keys. The old code was inefficient when processing documents
3727     with many inline glossterms.
3728
3729
3730   • Robert Stayton: docbook.css.xml; verbatim.xsl
3731
3732                 Fix bug 2844927 Validity error for callout bugs.
3733
3734
3735   • Robert Stayton: formal.xsl
3736
3737                 Convert formal.object.heading to respect make.clean.html param.
3738
3739
3740   • Robert Stayton: titlepage.templates.xml; block.xsl
3741
3742                 Fix bug 2840768 sidebar without title inserts empty b tag.
3743
3744
3745   • Mauritz Jeanson: docbook.xsl
3746
3747                 Moved the template that outputs <base> so that the base URI also applies to relative CSS paths that come later.
3748     See patch #2896121.
3749
3750
3751   • Jirka Kosek: autoidx-kosek.xsl
3752
3753                 Upgraded to use common entities. Fixed bug when some code used @sortas and some not for grouping/sorting of indexterms.
3754
3755
3756   • Robert Stayton: chunk-code.xsl
3757
3758                 fix bug 2948363 generated filename for refentry not unique, when
3759     used in a set.
3760
3761
3762   • Robert Stayton: component.xsl
3763
3764                 Fix missing "Chapter n" label when use chapter/info/title.
3765
3766
3767   • Robert Stayton: table.xsl
3768
3769                 Row recursion turned off if no @morerows attributes in the table.
3770     This will prevent failure on long table (with no @morerows) due
3771     to excessive depth of recursion.
3772
3773
3774   • Robert Stayton: autotoc.xsl; docbook.css.xml
3775
3776                 Support make.clean.html in autotoc.xsl.
3777
3778
3779   • Robert Stayton: docbook.css.xml; block.xsl
3780
3781                 Add support for make.clean.html setting in block elements.
3782
3783
3784   • Robert Stayton: docbook.css.xml
3785
3786                 Stock CSS styles for DocBook HTML output when 'make.clean.html' is non-zero.
3787
3788
3789   • Robert Stayton: html.xsl
3790
3791                 Add templates for generating CSS files and links to them.
3792
3793
3794   • Robert Stayton: param.xweb
3795
3796                 Fix bugs in new entity references.
3797
3798
3799   • Robert Stayton: chunk-common.xsl
3800
3801                 List of Equations now includes on equations with titles.
3802
3803
3804   • Robert Stayton: table.xsl
3805
3806                 If a colspec has a colname attribute, add it to the HTML col
3807     element as a class attribute so it can be styled.
3808
3809
3810   • Robert Stayton: formal.xsl
3811
3812                 Fix bug 2825842 where table footnotes not appearing in HTML-coded table.
3813
3814
3815   • Robert Stayton: chunktoc.xsl
3816
3817                 Fix bug #2834826 where appendix inside part was not chunked as it should be.
3818
3819
3820   • Mauritz Jeanson: chunktoc.xsl
3821
3822                 Added missing namespace declarations. Closes bug #2890069.
3823
3824
3825   • Mauritz Jeanson: footnote.xsl
3826
3827                 Updated the template for footnote paras to use the 'paragraph' template. Closes bug #2803739.
3828
3829
3830   • Keith Fahlgren: inline.xsl; lists.xsl
3831
3832                 Remove <b> and <i> elements "discouraged in favor of style sheets" from
3833     XHTML, XHTML 1.1 (and therefore EPUB) outputs by changing html2xhtml.xsl.
3834
3835     Fixes bug #2873153: No <b> and <i> tags in XHTML/EPUB
3836
3837     Added regression to EPUB specs:
3838
3839
3840   • Mauritz Jeanson: inline.xsl
3841
3842                 Fixed bug #2844916 (don't output @target if ulink.target is empty).
3843
3844
3845   • Keith Fahlgren: autoidx.xsl
3846
3847                 Fix a bug when using index.on.type: an 'index symbols' section was created
3848     even if that typed index didn't include any symbols (they were in the other types).
3849
3850
3851 Manpages
3852
3853 The following changes have been made to the manpages code since the 1.75.2
3854 release.
3855
3856   • Mauritz Jeanson: other.xsl
3857
3858                 Modified the write.stubs template so that the section directory name is not output twice. Should fix bug #2831602.
3859     Also ensured that $lang is added to the .so path (when man.output.lang.in.name.enabled=1).
3860
3861
3862   • Mauritz Jeanson: docbook.xsl; other.xsl
3863
3864                 Fixed bug #2412738 (apostrophe escaping) by applying the submitted patch.
3865
3866
3867   • Norman Walsh: block.xsl; endnotes.xsl
3868
3869                 Fix bug where simpara in footnote didn't work. Patch by Jonathan Nieder, jrnieder@gmail.com
3870
3871
3872   • dleidert: lists.xsl
3873
3874                 Fix two indentation issues: In the first case there is no corresponding .RS
3875     macro (Debian #519438, sf.net 2793873). In the second case an .RS instead of
3876     the probably intended .sp leads to an indentation bug (Debian #527309,
3877     sf.net #2642139).
3878
3879
3880 Epub
3881
3882 The following changes have been made to the epub code since the 1.75.2 release.
3883
3884   • Keith Fahlgren: bin/spec/examples/AMasqueOfDays.epub; docbook.xsl; bin/spec
3885     /epub_spec.rb
3886
3887                 Resolve some actual regressions in date output spotted by more recent versions of epubcheck
3888
3889
3890   • Keith Fahlgren: docbook.xsl
3891
3892                 Updated mediaobject selection code that better uses roles (when available); based on contributons by  Glenn McDonald
3893
3894
3895   • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
3896
3897                 Ensure that NCX documents are always outputted with a default namespace
3898     to prevent problems with the kindlegen machinery
3899
3900
3901   • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
3902     partintro.xml; docbook.x⋯
3903
3904                 Adding support for partintros with sect2s, 3s, etc
3905
3906
3907   • Keith Fahlgren: docbook.xsl
3908
3909                 Adding param to workaround horrific ADE bug with the inability to process <br>
3910
3911
3912   • Keith Fahlgren: docbook.xsl
3913
3914                 Add support for authorgroup/author in OPF metadata (via Michael Wiedmann)
3915
3916
3917   • Keith Fahlgren: bin/spec/epub_regressions_spec.rb
3918
3919                 Remove <b> and <i> elements "discouraged in favor of style sheets" from
3920     XHTML, XHTML 1.1 (and therefore EPUB) outputs by changing html2xhtml.xsl.
3921
3922     Fixes bug #2873153: No <b> and <i> tags in XHTML/EPUB
3923
3924     Added regression to EPUB specs:
3925
3926
3927   • Keith Fahlgren: bin/lib/docbook.rb; bin/spec/files/DejaVuSerif-Italic.otf;
3928     docbook.xsl; bi⋯
3929
3930                 This resolves bug #2873142, Please add support for multiple embedded fonts
3931
3932
3933     If you navigate to a checkout of DocBook-XSL and go to:
3934     xsl/epub/bin/spec/files
3935     You can now run the following command:
3936
3937     ../../dbtoepub -f DejaVuSerif.otf -f DejaVuSerif-Italic.otf -c test.css
3938     -s test_cust.xsl orm.book.001.xml
3939
3940     In dbtoepub, the following option can be used more than once:
3941     -f, --font [OTF FILE] Embed OTF FILE in .epub.
3942
3943     The underlying stylesheet now accepts a comma-separated list of font file
3944     names rather than just one as the RENAMED epub.embedded.fonts ('s' added).
3945
3946     The runnable EPUB spec now includes:
3947     - should be valid .epub after including more than one embedded font
3948
3949
3950   • Keith Fahlgren: docbook.xsl
3951
3952                 Improve the selection of cover images when working in DocBook 4.x land (work in progress)
3953
3954
3955   • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
3956
3957                 Improve the quality of the OPF spine regression by ensuring that the spine
3958     elements for deeply nested refentries are in order and adjacent to their
3959     opening wrapper XHTML chunk.
3960
3961
3962   • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/
3963     files/orm.book.00⋯
3964
3965                 Add more careful handling of refentries to ensure that they always appear in the opf:spine.
3966     This was only a problem when refentries were pushed deep into the hierarchy (like inside
3967     a sect2), but presented navigational problems for many reading systems (despite the
3968     correct NCX references). This may *not* be the best solution, but attacking a better
3969     chunking strategy for refentries was too big a nut to crack at this time.
3970
3971
3972 Eclipse
3973
3974 The following changes have been made to the eclipse code since the 1.75.2
3975 release.
3976
3977   • Mauritz Jeanson: eclipse3.xsl
3978
3979                 Added a stylesheet module that generates plug-ins conforming to the standard (OSGi-based) Eclipse 3.x
3980     architecture. The main difference to the older format is that metadata is stored in a separate
3981     manifest file. The module imports and extends the existing eclipse.xsl module. Based on code
3982     contributed in patch #2624668.
3983
3984
3985 Params
3986
3987 The following changes have been made to the params code since the 1.75.2
3988 release.
3989
3990   • Robert Stayton: draft.watermark.image.xml
3991
3992                 Fix bug 2922488 draft.watermark.image pointing to web resource.
3993     Now the value is images/draft.png, and may require customization
3994     for local resolution.
3995
3996
3997   • Mauritz Jeanson: equation.number.properties.xml
3998
3999                 Corrected refpurpose.
4000
4001
4002   • Norman Walsh: paper.type.xml
4003
4004                 Added USlegal and USlegallandscape paper types.
4005
4006
4007   • Jirka Kosek: highlight.xslthl.config.xml
4008
4009                 Added note about specifying location as URL
4010
4011
4012   • Robert Stayton: docbook.css.source.xml; generate.css.header.xml;
4013     custom.css.source.xml; ma⋯
4014
4015                 Params to support generated CSS files.
4016
4017
4018   • Robert Stayton: equation.number.properties.xml
4019
4020                 New attribute set for numbers appearing next to equations.
4021
4022
4023 XSL-Xalan
4024
4025 The following changes have been made to the xsl-xalan code since the 1.75.2
4026 release.
4027
4028   • dleidert: nbproject/genfiles.properties; nbproject/build-impl.xml
4029
4030                 Rebuild netbeans build files after adding missing Netbeans configuration to allow easier packaging for Debian.
4031
4032
4033 Release Notes: 1.75.2
4034
4035 The following is a list of changes that have been made since the 1.75.1
4036 release.
4037
4038 Gentext
4039
4040 The following changes have been made to the gentext code since the 1.75.1
4041 release.
4042
4043   • dleidert: locale/ja.xml
4044
4045     Improved Japanese translation for Note(s). Closes bug #2823965.
4046
4047   • dleidert: locale/pl.xml
4048
4049     Polish alphabet contains O with acute accent, not with grave accent. Closes bug #2823964.
4050
4051   • Robert Stayton: locale/ja.xml
4052
4053     Fix translation of "index", per bug report 2796064.
4054
4055   • Robert Stayton: locale/is.xml
4056
4057     New Icelandic locale file.
4058
4059 Common
4060
4061 The following changes have been made to the common code since the 1.75.1
4062 release.
4063
4064   • Norman Walsh: stripns.xsl
4065
4066     Support more downconvert cases
4067
4068   • Robert Stayton: titles.xsl
4069
4070     Make sure title inside info is used if no other title.
4071
4072 FO
4073
4074 The following changes have been made to the fo code since the 1.75.1 release.
4075
4076   • Robert Stayton: pi.xsl
4077
4078     Turn off dbfo-need for fop1.extensions also, per bug #2816141.
4079
4080 HTML
4081
4082 The following changes have been made to the html code since the 1.75.1 release.
4083
4084   • Mauritz Jeanson: titlepage.xsl
4085
4086     Output "Copyright" heading in XHTML too.
4087
4088   • Mauritz Jeanson: titlepage.xsl
4089
4090     Added stylesheet.result.type test for copyright. Closes bug #2813289.
4091
4092   • Norman Walsh: htmltbl.xsl
4093
4094     Remove ambiguity wrt @span, @rowspan, and @colspan
4095
4096 Manpages
4097
4098 The following changes have been made to the manpages code since the 1.75.1
4099 release.
4100
4101   • Mauritz Jeanson: endnotes.xsl
4102
4103     Added normalize-space() for ulink content. Closes bug #2793877.
4104
4105   • Mauritz Jeanson: docbook.xsl
4106
4107     Added stylesheet.result.type test for copyright. Closes bug #2813289.
4108
4109 Epub
4110
4111 The following changes have been made to the epub code since the 1.75.1 release.
4112
4113   • Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb
4114
4115     Corrected bugs caused by path and file assumptions were not met
4116
4117   • Keith Fahlgren: bin/lib/docbook.rb; docbook.xsl
4118
4119     Cleaning up hardcoded values into parameters and fixing Ruby library to pass them properly; all thanks to patch from Liza Daly
4120
4121 Profiling
4122
4123 The following changes have been made to the profiling code since the 1.75.1
4124 release.
4125
4126   • Robert Stayton: profile.xsl
4127
4128     Fix bug 2815493 missing exsl.node.set.available parameter.
4129
4130 XSL-Saxon
4131
4132 The following changes have been made to the xsl-saxon code since the 1.75.1
4133 release.
4134
4135   • Mauritz Jeanson: src/com/nwalsh/saxon/ColumnUpdateEmitter.java; src/com/
4136     nwalsh/saxon/Colum⋯
4137
4138     Added fixes so that colgroups in the XHTML namespace are processed properly.
4139
4140 XSL-Xalan
4141
4142 The following changes have been made to the xsl-xalan code since the 1.75.1
4143 release.
4144
4145   • Mauritz Jeanson: nbproject/project.xml
4146
4147     Added missing NetBeans configuration.
4148
4149 Release Notes: 1.75.1
4150
4151 This release includes bug fixes.
4152
4153 The following is a list of changes that have been made since the 1.75.0
4154 release.
4155
4156 FO
4157
4158 The following changes have been made to the fo code since the 1.75.0 release.
4159
4160   • Keith Fahlgren: block.xsl
4161
4162     Switching to em dash for character before attribution in epigraph; resolves Bug #2793878
4163
4164   • Robert Stayton: lists.xsl
4165
4166     Fixed bug 2789947, id attribute missing on simplelist fo output.
4167
4168 HTML
4169
4170 The following changes have been made to the html code since the 1.75.0 release.
4171
4172   • Keith Fahlgren: block.xsl
4173
4174     Switching to em dash for character before attribution in epigraph; resolves Bug #2793878
4175
4176   • Robert Stayton: lists.xsl
4177
4178     Fixed bug 2789678: apply-templates line accidentally deleted.
4179
4180 Epub
4181
4182 The following changes have been made to the epub code since the 1.75.0 release.
4183
4184   • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
4185
4186     Added regression and fix to correct "bug" with namespace-prefixed container elements in META-INF/container.xml ; resolves Issue #2790017
4187
4188   • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
4189     onegraphic.xinclude.xml;⋯
4190
4191     Another attempt at flexible named entity and XInclude processing
4192
4193   • Keith Fahlgren: bin/lib/docbook.rb
4194
4195     Tweaking solution to Bug #2750442 following regression reported by Michael Wiedmann.
4196
4197 Params
4198
4199 The following changes have been made to the params code since the 1.75.0
4200 release.
4201
4202   • Mauritz Jeanson: highlight.source.xml
4203
4204     Updated documentation to reflect changes made in r8419.
4205
4206 Release Notes: 1.75.0
4207
4208 This release includes important bug fixes and adds the following significant
4209 feature changes:
4210
4211 Gentext
4212
4213     Modifications to translations have been made.
4214
4215 Common
4216
4217     Added support for some format properties on tables using HTML table markup.
4218
4219     Added two new qanda.defaultlabel values so that numbered sections and
4220     numbered questions can be distinguished. Satisfies Feature Request #
4221     1539045.
4222
4223     Added code to handle acknowledgements in book and part. The element is
4224     processed similarly to dedication. All acknowledgements will appear as
4225     front matter, after any dedications.
4226
4227 FO
4228
4229     The inclusion of highlighting code has been simplified.
4230
4231     Add support for pgwide on informal objects.
4232
4233     Added a new parameter, bookmarks.collapse, that controls the initial state
4234     of the bookmark tree. Closes FR #1792326.
4235
4236     Add support for more dbfo processing instructions.
4237
4238     Add new variablelist.term.properties to format terms, per request #
4239     1968513.
4240
4241     Add support for @width on screen and programlisting, fixes bug #2012736.
4242
4243     Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.
4244
4245     Add writing.mode param for FO output.
4246
4247 HTML
4248
4249     Convert all calls to class.attribute to calls to common.html.attributes to
4250     support dir, lang, and title attributes in html output for all elements.
4251     Fulfills feature request #1993833.
4252
4253     Inclusion of highlighting code was simplified. Only one import is now
4254     necessary.
4255
4256     Add new param index.links.to.section.
4257
4258     Add support for the new index.links.to.section param which permits precise
4259     links to indexterms in HTML output rather than to the section title.
4260
4261 ePub
4262
4263     Slightly more nuanced handling of imageobject alternatives and better
4264     support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442
4265     reported by Raphael Hertzog.
4266
4267     Added a colon after an abstract/title when mapping into the dc:description
4268     for OPF metadata in ePub output to help the flat text have more
4269     pseudo-semantics (sugestions from Michael Wiedmann)
4270
4271     Added DocBook subjectset -> OPF dc:subject mapping and tests
4272
4273     Added DocBook date -> OPF dc:date mapping and tests
4274
4275     Added DocBook abstract -> OPF dc:description mapping and tests
4276
4277     Added --output option to dbtoepub based on user request
4278
4279 HTMLHelp
4280
4281     Add support for generating olink target database for htmlhelp files.
4282
4283 Params
4284
4285     Add default setting for @rules attribute on HTML markup tables.
4286
4287     Added a new parameter, bookmarks.collapse, that controls the initial state
4288     of the bookmark tree. When the parameter has a non-zero value (the
4289     default), only the top-level bookmarks are displayed initially. Otherwise,
4290     the whole tree of bookmarks is displayed. This is implemented for FOP 0.9X.
4291     Closes FR #1792326.
4292
4293     Add new variablelist.term.properties to format terms, per request #
4294     1968513.
4295
4296     Add two new qanda.defaultlabel values so that numbered sections and
4297     numbered questions can be distinguished. Satisfies Feature Request #
4298     1539045.
4299
4300     Add param to control whether an index entry links to a section title or to
4301     the precise location of the indexterm.
4302
4303     New attribute list for glossentry in glossary.
4304
4305     New parameter to support @width on programlisting and screen.
4306
4307     Add attribute-sets for formatting glossary terms and defs.
4308
4309 Highlighting
4310
4311     Inclusion of highlighting code was simplified. Only one import is now
4312     necessary.
4313
4314 The following is a list of changes that have been made since the 1.74.3
4315 release.
4316
4317 Gentext
4318
4319 The following changes have been made to the gentext code since the 1.74.3
4320 release.
4321
4322   • Robert Stayton: locale/sv.xml; locale/ja.xml; locale/pl.xml
4323
4324     Check in translations of Legalnotice submitted on mailing list.
4325
4326   • Robert Stayton: locale/es.xml
4327
4328     Fix spelling errors in Acknowledgements entries.
4329
4330   • Robert Stayton: locale/es.xml
4331
4332     Check in translations for 4 elements submitted through docbook-apps
4333     message of 14 April 2009.
4334
4335   • David Cramer: locale/zh.xml; locale/ca.xml; locale/ru.xml; locale/ga.xml;
4336     locale/gl.xml; l⋯
4337
4338     Internationalized punctuation in glosssee and glossseealso
4339
4340   • Robert Stayton: Makefile
4341
4342     Check in fixes for DSSSL gentext targets from submitted patch #1689633.
4343
4344   • Robert Stayton: locale/uk.xml
4345
4346     Check in major update submitted with bug report #2008524.
4347
4348   • Robert Stayton: locale/zh_tw.xml
4349
4350     Check in fix to Note string submitted in bug #2441051.
4351
4352   • Robert Stayton: locale/ru.xml
4353
4354     Checkin typo fix submitted in bug #2453406.
4355
4356 Common
4357
4358 The following changes have been made to the common code since the 1.74.3
4359 release.
4360
4361   • Robert Stayton: gentext.xsl
4362
4363     Fix extra generated space when xrefstyle includes 'nopage'.
4364
4365   • Robert Stayton: table.xsl
4366
4367     Add support for some format properties on tables using
4368     HTML table markup.  These include:
4369       - frame attribute on table (or uses $default.table.frame parameter).
4370       - rules attribute on table (or uses $default.table.rules parameter).
4371       - align attribute on td and th
4372       - valign attribute on td and th
4373       - colspan on td and th
4374       - rowspan on td and th
4375       - bgcolor on td and th
4376
4377   • Robert Stayton: olink.xsl
4378
4379     Add placeholder template to massage olink hot text to make
4380     customization easier, per Feature Request 1828608.
4381
4382   • Robert Stayton: targets.xsl
4383
4384     Add support for collecting olink targets from a glossary
4385     generated from a glossary.collection.
4386
4387   • Robert Stayton: titles.xsl
4388
4389     Handle firstterm like glossterm in mode="title.markup".
4390
4391   • Robert Stayton: titles.xsl
4392
4393     Add match on info/title in title.markup templates where missing.
4394
4395   • Mauritz Jeanson: titles.xsl
4396
4397     Changed "ancestor::title" to "(ancestor::title and (@id or @xml:id))".
4398     This enables proper formatting of inline elements in titles in TOCs,
4399     as long as these inlines don't have id or xml:id attributes.
4400
4401   • Robert Stayton: labels.xsl
4402
4403     Add two new qanda.defaultlabel values so that numbered sections
4404     and numbered questions can be distinguished.  Satisfies
4405     Feature Request #1539045.
4406
4407   • Robert Stayton: stripns.xsl; pi.xsl
4408
4409     Convert function-available(exsl:node-set) to use the new param
4410     so Xalan bug is isolated.
4411
4412   • Mauritz Jeanson: titles.xsl
4413
4414     Added fixes for bugs #2112656 and #1759205:
4415     1. Reverted mistaken commits r7485 and r7523.
4416     2. Updated the template with match="link" and mode="no.anchor.mode" so that
4417     @endterm is used if it exists and if the link has no content.
4418
4419   • Mauritz Jeanson: titles.xsl
4420
4421     Added code to handle acknowledgements in book and part. The element is processed
4422     similarly to dedication. All acknowledgements will appear as front matter, after
4423     any dedications.
4424
4425   • Robert Stayton: olink.xsl
4426
4427     Fix bug #2018717 use.local.olink.style uses wrong gentext context.
4428
4429   • Robert Stayton: olink.xsl
4430
4431     Fix bug #1787167 incorrect hot text for some olinks.
4432
4433   • Robert Stayton: common.xsl
4434
4435     Fix bug #1669654 Broken output if copyright <year> contains a range.
4436
4437   • Robert Stayton: labels.xsl
4438
4439     Fix bug in labelling figure inside appendix inside article inside book.
4440
4441 FO
4442
4443 The following changes have been made to the fo code since the 1.74.3 release.
4444
4445   • Jirka Kosek: highlight.xsl
4446
4447     Inclusion of highlighting code was simplified. Only one import is now necessary.
4448
4449   • Robert Stayton: fop1.xsl
4450
4451     Add the new fop extensions namespace declaration, in case FOP
4452     extension functions are used.
4453
4454   • Robert Stayton: formal.xsl
4455
4456     Add support for pgwide on informal objects.
4457
4458   • Robert Stayton: docbook.xsl
4459
4460     Fixed spurious closing quote on line 134.
4461
4462   • Robert Stayton: docbook.xsl; autoidx-kosek.xsl; autoidx.xsl
4463
4464     Convert function-available for node-set() to use
4465     new $exsl.node.set.available param in test.
4466
4467   • David Cramer: xref.xsl
4468
4469     Suppress extra space after xref when xrefstyle='select: label nopage' (#2740472)
4470
4471   • Mauritz Jeanson: pi.xsl
4472
4473     Fixed doc bug for row-height.
4474
4475   • David Cramer: glossary.xsl
4476
4477     Internationalized punctuation in glosssee and glossseealso
4478
4479   • Robert Stayton: param.xweb; param.ent; htmltbl.xsl; table.xsl
4480
4481     Add support for some format properties on tables using
4482     HTML table markup.  These include:
4483       - frame attribute on table (or uses $default.table.frame parameter).
4484       - rules attribute on table (or uses $default.table.rules parameter).
4485       - align attribute on td and th
4486       - valign attribute on td and th
4487       - colspan on td and th
4488       - rowspan on td and th
4489       - bgcolor on td and th
4490
4491   • Robert Stayton: table.xsl
4492
4493     Add support bgcolor in td and th
4494     elements in HTML table markup.
4495
4496   • Robert Stayton: htmltbl.xsl
4497
4498     Add support for colspan and rowspan and bgcolor in td and th
4499     elements in HTML table markup.
4500
4501   • Robert Stayton: param.xweb
4502
4503     Fix working of page-master left and right margins.
4504
4505   • Mauritz Jeanson: param.xweb; param.ent; fop1.xsl
4506
4507     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.
4508
4509   • Robert Stayton: table.xsl; pi.xsl
4510
4511     Add support for dbfo row-height processing instruction, like that in dbhtml.
4512
4513   • Robert Stayton: lists.xsl
4514
4515     Add support for dbfo keep-together processing instruction for
4516     entire list instances.
4517
4518   • Robert Stayton: lists.xsl; block.xsl
4519
4520     Add support fo dbfo keep-together processing instruction to
4521     more blocks like list items and paras.
4522
4523   • Robert Stayton: lists.xsl; param.xweb; param.ent
4524
4525     Add new variablelist.term.properties to format terms, per request # 1968513.
4526
4527   • Robert Stayton: inline.xsl
4528
4529     In simple.xlink, rearrange order of processing.
4530
4531   • Robert Stayton: xref.xsl
4532
4533     Handle firstterm like glossterm in mode="xref-to".
4534
4535   • Robert Stayton: glossary.xsl; xref.xsl; pi.xsl; footnote.xsl
4536
4537     Implement simple.xlink for glosssee and glossseealso so they can use
4538     other types of linking besides otherterm.
4539
4540   • Robert Stayton: qandaset.xsl
4541
4542     Add two new qanda.defaultlabel values so that numbered sections and numbered questions can be distinguished.  Satisfies Feature Request #1539045.
4543
4544   • Robert Stayton: titlepage.xsl
4545
4546     For the book title templates, I changed info/title to book/info/title
4547     so other element's titles will not be affected.
4548
4549   • Robert Stayton: xref.xsl; verbatim.xsl
4550
4551     Use param exsl.node.set.available to test for function.
4552
4553   • Robert Stayton: param.xweb; param.ent; footnote.xsl
4554
4555     Start using new param exsl.node.set.available to work around Xalan bug.
4556
4557   • Robert Stayton: titlepage.templates.xml
4558
4559     Add comment on use of t:predicate for editor to prevent
4560     extra processing of multiple editors. Fixes bug 2687842.
4561
4562   • Robert Stayton: xref.xsl; autoidx.xsl
4563
4564     An indexterm primary, secondary, or tertiary element with an id or xml:id
4565     now outputs that ID, so that index entries can be cross referenced to.
4566
4567   • Mauritz Jeanson: synop.xsl
4568
4569     Added modeless template for ooclass|oointerface|ooexception.
4570     Closes bug #1623468.
4571
4572   • Robert Stayton: xref.xsl
4573
4574     Add template with match on indexterm in mode="xref-to" to fix bug 2102592.
4575
4576   • Robert Stayton: xref.xsl
4577
4578     Now xref to qandaentry will use the label element in a question for
4579     the link text if it has one.
4580
4581   • Robert Stayton: inline.xsl
4582
4583     Add id if specified from @id to output for quote and phrase so
4584     they can be xref'ed to.
4585
4586   • Robert Stayton: xref.xsl
4587
4588     Add support for xref to phrase, simpara, anchor, and quote.
4589     This assumes the author specifies something using xrefstyle since
4590     the elements don't have ordinary link text.
4591
4592   • Robert Stayton: toc.xsl
4593
4594     Fix bug in new toc templates.
4595
4596   • Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl;
4597     titlepage.templates⋯
4598
4599     Added code to handle acknowledgements in book and part. The element is processed
4600     similarly to dedication. All acknowledgements will appear as front matter, after
4601     any dedications.
4602
4603   • Robert Stayton: toc.xsl
4604
4605     Rewrite toc templates to support an empty toc or populated toc
4606     in all permitted contexts.  Same for lot elements.
4607     This fixes bug #1595969 for FO outputs.
4608
4609   • Robert Stayton: index.xsl
4610
4611     Fix indents for seealsoie so they are consistent.
4612
4613   • Mauritz Jeanson: param.xweb
4614
4615     Removed duplicate (monospace.font.family).
4616
4617   • Robert Stayton: param.xweb; param.ent
4618
4619     Add glossentry.list.item.properties.
4620
4621   • Robert Stayton: param.xweb; param.ent
4622
4623     Add monospace.verbatim.font.width param to support @width on programlisting.
4624
4625   • Robert Stayton: verbatim.xsl
4626
4627     Put programlisting in fo:block-container with writing-mode="lr-tb"
4628     when text direction is right to left because all program languages
4629     are left-to-right.
4630
4631   • Robert Stayton: verbatim.xsl
4632
4633     Add support for @width on screen and programlisting, fixes bug #2012736.
4634
4635   • Robert Stayton: xref.xsl
4636
4637     Fix bug #1973585 xref to para with xrefstyle not handled correctly.
4638
4639   • Mauritz Jeanson: block.xsl
4640
4641     Added support for acknowledgements in article.
4642     Support in book/part remains to be added.
4643
4644   • Robert Stayton: xref.xsl
4645
4646     Fix bug #1787167 incorrect hot text for some olinks.
4647
4648   • Robert Stayton: fo.xsl
4649
4650     Add writing-mode="tb-rl" as well since some XSL-FO processors support it.
4651
4652   • Robert Stayton: autotoc.xsl; lists.xsl; glossary.xsl; fo.xsl; table.xsl;
4653     pagesetup.xsl
4654
4655     Add support for writing-mode="rl-tb" (right-to-left) in FO outputs.
4656     Changed instances of margin-left to margin-{$direction.align.start}
4657     and margin-right to margin-{$direction.align.end}. Those direction.align
4658     params are computed from the writing mode value in each locale's
4659     gentext key named 'writing-mode', introduced in 1.74.3 to add
4660     right-to-left support to HTML outputs.
4661
4662   • Robert Stayton: param.xweb; param.ent
4663
4664     Add attribute-sets for formatting glossary terms and defs.
4665
4666   • Robert Stayton: param.xweb; param.ent
4667
4668     Add writing.mode param for FO output.
4669
4670   • Robert Stayton: autotoc.xsl
4671
4672     Fix bug 1546008: in qandaentry in a TOC, use its blockinfo/titleabbrev or blockinfo/title
4673     instead of question, if available. For DocBook 5, use the info versions.
4674
4675   • Keith Fahlgren: verbatim.xsl
4676
4677     Add better pointer to README for XSLTHL
4678
4679   • Keith Fahlgren: verbatim.xsl
4680
4681     More tweaking the way that XSLTHL does or does not get called
4682
4683   • Keith Fahlgren: verbatim.xsl
4684
4685     Alternate attempt at sanely including/excluding XSLTHT code
4686
4687 HTML
4688
4689 The following changes have been made to the html code since the 1.74.3 release.
4690
4691   • Robert Stayton: lists.xsl
4692
4693     Removed redundant lang and title attributes on list element inside
4694     div element for lists.
4695
4696   • Robert Stayton: inline.xsl; titlepage.xsl; division.xsl; toc.xsl;
4697     sections.xsl; table.xsl;⋯
4698
4699     Convert all calls to class.attribute to calls to common.html.attributes
4700     to support dir, lang, and title attributes in html output for all elements.
4701     Fulfills feature request #1993833.
4702
4703   • Robert Stayton: chunk-common.xsl
4704
4705     Fix bug #2750253 wrong links in list of figures in chunk.html
4706     when target html is in a subdirectory and dbhtml filename used.
4707
4708   • Jirka Kosek: highlight.xsl
4709
4710     Inclusion of highlighting code was simplified. Only one import is now necessary.
4711
4712   • Robert Stayton: chunk-common.xsl; chunktoc.xsl; docbook.xsl;
4713     chunk-changebars.xsl; autoidx⋯
4714
4715     Convert function-available for node-set() to use
4716     new $exsl.node.set.available param in test.
4717
4718   • Mauritz Jeanson: pi.xsl
4719
4720     Fixed doc bug for row-height.
4721
4722   • David Cramer: glossary.xsl
4723
4724     Internationalized punctuation in glosssee and glossseealso
4725
4726   • Robert Stayton: lists.xsl; html.xsl; block.xsl
4727
4728     More elements get common.html.attributes.
4729     Added locale.html.attributes template which does the lang,
4730     dir, and title attributes, but not the class attribute
4731     (used on para, for example).
4732
4733   • Robert Stayton: lists.xsl
4734
4735     Replace more literal class atts with mode="class.attribute" to support
4736     easier customization.
4737
4738   • Robert Stayton: glossary.xsl
4739
4740     Support olinking in glosssee and glossseealso.
4741
4742   • Robert Stayton: inline.xsl
4743
4744     In simple.xlink, rearrange order of processing.
4745
4746   • Robert Stayton: xref.xsl
4747
4748     Handle firstterm like glossterm in mode="xref-to".
4749
4750   • Robert Stayton: lists.xsl; html.xsl; block.xsl
4751
4752     Added template named common.html.attributes to output
4753     class, title, lang, and dir for most elements.
4754     Started adding it to some list and block elements.
4755
4756   • Robert Stayton: qandaset.xsl
4757
4758     Add two new qanda.defaultlabel values so that numbered sections
4759     and numbered questions can be distinguished.  Satisfies
4760     Feature Request #1539045.
4761
4762   • Robert Stayton: param.xweb; chunk-code.xsl; param.ent; xref.xsl;
4763     chunkfast.xsl; verbatim.x⋯
4764
4765     Use new param exsl.node.set.available to test, handles Xalan bug.
4766
4767   • Robert Stayton: autoidx.xsl
4768
4769     Use named anchors for primary, secondary, and tertiary ids so
4770     duplicate entries with different ids can still have an id output.
4771
4772   • Robert Stayton: param.xweb; param.ent
4773
4774     Add new param index.links.to.section.
4775
4776   • Robert Stayton: xref.xsl; autoidx.xsl
4777
4778     Pass through an id on primary, secondary, or tertiary to
4779     the index entry, so that one could link to an index entry.
4780     You can't link to the id on an indexterm because that is
4781     used to place the main anchor in the text flow.
4782
4783   • Robert Stayton: autoidx.xsl
4784
4785     Add support for the new index.links.to.section param which permits
4786     precise links to indexterms in HTML output rather than to
4787     the section title.
4788
4789   • Mauritz Jeanson: synop.xsl
4790
4791     Added modeless template for ooclass|oointerface|ooexception.
4792     Closes bug #1623468.
4793
4794   • Robert Stayton: qandaset.xsl
4795
4796     Make sure a qandaset has an anchor, even when it has no title,
4797     because it may be referenced in a TOC or xref.
4798     Before, the anchor was output by the title, but there was no
4799     anchor if there was no title.
4800
4801   • Robert Stayton: xref.xsl
4802
4803     Add a template for indexterm with mode="xref-to" to fix bug 2102592.
4804
4805   • Robert Stayton: xref.xsl
4806
4807     Now xref to qandaentry will use the label element in a question for
4808     the link text if it has one.
4809
4810   • Robert Stayton: qandaset.xsl; html.xsl
4811
4812     Create separate templates for computing label of question and answer
4813     in a qandaentry, so such can be used for the alt text of an xref
4814     to a qandaentry.
4815
4816   • Robert Stayton: inline.xsl; xref.xsl
4817
4818     Now support xref to phrase, simpara, anchor, and quote,
4819     most useful when an xrefstyle is used.
4820
4821   • Robert Stayton: toc.xsl
4822
4823     Rewrite toc templates to support an empty toc or populated toc
4824     in all permitted contexts.  Same for lot elements.
4825     This fixes bug #1595969 for HTML outputs.
4826
4827   • Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; xref.xsl;
4828     titlepage.templates⋯
4829
4830     Added code to handle acknowledgements in book and part. The element is processed
4831     similarly to dedication. All acknowledgements will appear as front matter, after
4832     any dedications.
4833
4834   • Robert Stayton: index.xsl
4835
4836     Rewrote primaryie, secondaryie and tertiaryie templates to handle
4837     nesting of elements and seeie and seealsoie, as reported in
4838     bug # 1168912.
4839
4840   • Robert Stayton: autotoc.xsl
4841
4842     Fix simplesect in toc problem.
4843
4844   • Robert Stayton: verbatim.xsl
4845
4846     Add support for @width per bug report #2012736.
4847
4848   • Robert Stayton: formal.xsl; htmltbl.xsl
4849
4850     Fix bug #1787140 HTML tables not handling attributes correctly.
4851
4852   • Robert Stayton: param.xweb
4853
4854     Move writing-mode param.
4855
4856   • Keith Fahlgren: refentry.xsl
4857
4858     Remove a nesting of <p> inside <p> for refclass (made XHTML* invalid, made HTML silly)
4859
4860   • Robert Stayton: table.xsl
4861
4862     Fix bug #1945872 to allow passthrough of colwidth values to
4863     HTML table when no tablecolumns.extension is available and
4864     when no instance of * appears in the table's colspecs.
4865
4866   • Mauritz Jeanson: block.xsl
4867
4868     Added support for acknowledgements in article.
4869     Support in book/part remains to be added.
4870
4871   • Robert Stayton: chunk-common.xsl
4872
4873     Fix bug #1787167 incorrect hot text for some olinks.
4874
4875   • Robert Stayton: qandaset.xsl
4876
4877     Fix bug 1546008: in qandaentry in a TOC, use its blockinfo/titleabbrev or blockinfo/title
4878     instead of question, if available. For DocBook 5, use the info versions.
4879
4880   • Robert Stayton: chunktoc.xsl
4881
4882     Add support for generating olink database when using chunktoc.xsl.
4883
4884   • Keith Fahlgren: verbatim.xsl
4885
4886     Add better pointer to README for XSLTHL
4887
4888   • Keith Fahlgren: verbatim.xsl
4889
4890     Another stab at fixing the stupid XSLTHT includes across processors (Saxon regression reported by Sorin Ristache)
4891
4892   • Keith Fahlgren: verbatim.xsl
4893
4894     More tweaking the way that XSLTHL does or does not get called
4895
4896   • Keith Fahlgren: verbatim.xsl
4897
4898     Alternate attempt at sanely including/excluding XSLTHT code
4899
4900 Manpages
4901
4902 The following changes have been made to the manpages code since the 1.74.3
4903 release.
4904
4905   • Robert Stayton: table.xsl
4906
4907     Convert function-available test for node-set() function to
4908     test of $exsl.node.set.available param.
4909
4910   • Mauritz Jeanson: lists.xsl
4911
4912     Added a template for bibliolist. Closes bug #1815916.
4913
4914 ePub
4915
4916 The following changes have been made to the epub code since the 1.74.3 release.
4917
4918   • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
4919     onegraphic.xinclude.xml;⋯
4920
4921     Slightly more nuanced handling of imageobject alternatives and better support in dbtoepub for XIncludes and ENTITYs to resolve Issue #2750442 reported by Raphael Hertzog.
4922
4923   • Keith Fahlgren: docbook.xsl
4924
4925     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)
4926
4927   • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/
4928     files/de.xml
4929
4930     Correctly set dc:language in OPF metadata when i18nizing. Closes Bug #2755150
4931
4932   • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
4933
4934     Corrected namespace declarations for literal XHTML elements to make them serialize "normally"
4935
4936   • Keith Fahlgren: docbook.xsl
4937
4938     Be a little bit more nuanced about dates
4939
4940   • Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
4941     /orm.book.001.x⋯
4942
4943     Add DocBook subjectset -> OPF dc:subject mapping and tests
4944
4945   • Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
4946     /orm.book.001.x⋯
4947
4948     Add DocBook date -> OPF dc:date mapping and tests
4949
4950   • Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
4951     /orm.book.001.x⋯
4952
4953     Add DocBook abstract -> OPF dc:description mapping and tests
4954
4955   • Robert Stayton: docbook.xsl
4956
4957     Check in patch submitted by user to add opf:file-as attribute
4958     to dc:creator element.
4959
4960   • Keith Fahlgren: bin/dbtoepub
4961
4962     Adding --output option to dbtoepub based on user request
4963
4964   • Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb
4965
4966     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)
4967
4968   • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
4969     refclass.xml
4970
4971     Remove a nesting of <p> inside <p> for refclass (made XHTML* invalid, made HTML silly)
4972
4973   • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
4974     blockquotepre.xml
4975
4976     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.
4977
4978 HTMLHelp
4979
4980 The following changes have been made to the htmlhelp code since the 1.74.3
4981 release.
4982
4983   • Robert Stayton: htmlhelp-common.xsl
4984
4985     Add support for generating olink target database for htmlhelp files.
4986
4987 Params
4988
4989 The following changes have been made to the params code since the 1.74.3
4990 release.
4991
4992   • Robert Stayton: default.table.rules.xml
4993
4994     Add default setting for @rules attribute on HTML markup tables.
4995
4996   • Mauritz Jeanson: bookmarks.collapse.xml
4997
4998     Added a new parameter, bookmarks.collapse, that controls the initial state
4999     of the bookmark tree. When the parameter has a non-zero value (the default),
5000     only the top-level bookmarks are displayed initially. Otherwise, the whole
5001     tree of bookmarks is displayed.
5002
5003     This is implemented for FOP 0.9X. Closes FR #1792326.
5004
5005   • Robert Stayton: variablelist.term.properties.xml
5006
5007     Add new variablelist.term.properties to format terms, per
5008     request # 1968513.
5009
5010   • Robert Stayton: qanda.defaultlabel.xml
5011
5012     Add two new qanda.defaultlabel values so that numbered sections
5013     and numbered questions can be distinguished.  Satisfies
5014     Feature Request #1539045.
5015
5016   • Robert Stayton: index.links.to.section.xml
5017
5018     Change default to 1 to match past behavior.
5019
5020   • Robert Stayton: exsl.node.set.available.xml
5021
5022     Isolate this text for Xalan bug regarding exsl:node-set available.
5023     If it is ever fixed in Xalan, just fix it here.
5024
5025   • Robert Stayton: index.links.to.section.xml
5026
5027     Add param to control whether an index entry links to
5028     a section title or to the precise location of the
5029     indexterm.
5030
5031   • Robert Stayton: glossentry.list.item.properties.xml
5032
5033     New attribute list for glossentry in glossary.
5034
5035   • Robert Stayton: monospace.verbatim.font.width.xml
5036
5037     New parameter to support @width on programlisting and screen.
5038
5039   • Mauritz Jeanson: highlight.source.xml
5040
5041     Updated and reorganized the description.
5042
5043   • Robert Stayton: page.margin.outer.xml; page.margin.inner.xml
5044
5045     Add caveat about XEP bug when writing-mode is right-to-left.
5046
5047   • Robert Stayton: article.appendix.title.properties.xml; writing.mode.xml;
5048     body.start.indent⋯
5049
5050     Change 'left' to 'start' and 'right' to 'end' to support right-to-left
5051     writing mode.
5052
5053   • Robert Stayton: glossdef.block.properties.xml;
5054     glossdef.list.properties.xml; glossterm.blo⋯
5055
5056     Add attribute-sets for formatting glossary terms and defs.
5057
5058   • Robert Stayton: glossterm.separation.xml
5059
5060     Clarify the description.
5061
5062   • Robert Stayton: make.year.ranges.xml
5063
5064     Now handles year element containing a comma or dash without error.
5065
5066 Highlighting
5067
5068 The following changes have been made to the highlighting code since the 1.74.3
5069 release.
5070
5071   • Jirka Kosek: README
5072
5073     Inclusion of highlighting code was simplified. Only one import is now necessary.
5074
5075   • Keith Fahlgren: README
5076
5077     Adding XSLTHL readme
5078
5079   • Keith Fahlgren: common.xsl
5080
5081     Alternate attempt at sanely including/excluding XSLTHT code
5082
5083 XSL-Saxon
5084
5085 The following changes have been made to the xsl-saxon code since the 1.74.3
5086 release.
5087
5088   • Mauritz Jeanson: src/com/nwalsh/saxon/Text.java
5089
5090     Added a fix that prevents output of extra blank line.
5091     Hopefully this closes bug #894805.
5092
5093 XSL-Xalan
5094
5095 The following changes have been made to the xsl-xalan code since the 1.74.3
5096 release.
5097
5098   • Mauritz Jeanson: src/com/nwalsh/xalan/Text.java
5099
5100     Added a fix that prevents output of extra blank line.
5101     Hopefully this closes bug #894805.
5102
5103 Release Notes: 1.74.3
5104
5105 This release fixes some bugs in the 1.74.2 release.
5106
5107 See highlighting/README for XSLTHL usage instructions.
5108
5109 Release Notes: 1.74.2
5110
5111 This release fixes some bugs in the 1.74.1 release.
5112
5113 Release Notes: 1.74.1
5114
5115 This release includes important bug fixes and adds the following significant
5116 feature changes:
5117
5118 Gentext
5119
5120     Kirghiz locale added and Chinese translations have been simplified.
5121
5122     Somme support for gentext and right-to-left languages has been added.
5123
5124 FO
5125
5126     Various bugs have been resolved.
5127
5128     Support for a new processing instruction: dbfo funcsynopsis-style has been
5129     added.
5130
5131     Added new param email.mailto.enabled for FO output. Patch from Paolo
5132     Borelli.
5133
5134     Support for documented metadata in fop1 mode has been added.
5135
5136 Highlighting
5137
5138     Support for the latest version of XSLTHL 2.0 and some new language syntaxes
5139     have been added to a variety of outputs.
5140
5141 Manpages
5142
5143     Added man.output.better.ps.enabled param (zero default). It non-zero, no
5144     such markup is embedded in generated man pages, and no enhancements are
5145     included in the PostScript output generated from those man pages by the man
5146     -Tps command.
5147
5148 HTML
5149
5150     Support for writing.mode to set text direction and alignment based on
5151     document locale has been added.
5152
5153     Added a new top-level stylesheet module, chunk-changebars.xsl, to be used
5154     for generating chunked output with highlighting based on change
5155     (@revisionflag) markup. The module imports/includes the standard chunking
5156     and changebars templates and contains additional logic for chunked output.
5157     See FRs #1015180 and #1819915.
5158
5159 ePub
5160
5161     Covers now look better in Adobe Digital Editions thanks to a patch from
5162     Paul Norton of Adobe
5163
5164     Cover handling now more generic (including limited DocBook 5.0 cover
5165     support thanks to patch contributed by Liza Daly.
5166
5167     Cover markup now carries more reliably into files destined for .mobi and
5168     the Kindle.
5169
5170     dc:identifiers are now generated from more types of numbering schemes.
5171
5172     Both SEO and semantic structure of chunked ePub output by ensuring that we
5173     always send out one and only one h1 in each XHTML chunk.
5174
5175     Primitive support for embedding a single font added.
5176
5177     Support for embedding a CSS customizations added.
5178
5179 Roundtrip
5180
5181     Support for imagedata-metadata and table as images added.
5182
5183     Support for imagedata-metadata and legalnotice as images added.
5184
5185 Params
5186
5187     man.output.better.ps.enabled added for Manpages output
5188
5189     writing.mode.xml added to set text direction.
5190
5191     Added new param email.mailto.enabled for FO output. Patch from Paolo
5192     Borelli. Closes #2086321.
5193
5194     highlight.source upgraded to support the latest version of XSLTHL 2.0.
5195
5196 The following is a list of changes that have been made since the 1.74.0
5197 release.
5198
5199 Gentext
5200
5201 The following changes have been made to the gentext code since the 1.74.0
5202 release.
5203
5204   • Michael(tm) Smith: locale/ky.xml; Makefile
5205
5206     new Kirghiz locale from Ilyas Bakirov
5207
5208   • Mauritz Jeanson: locale/en.xml
5209
5210     Added "Acknowledgements".
5211
5212   • Dongsheng Song: locale/zh_cn.xml
5213
5214     Simplified Chinese translation.
5215
5216   • Robert Stayton: locale/lv.xml; locale/ca.xml; locale/pt.xml; locale/tr.xml;
5217     locale/af.xml;⋯
5218
5219     Add writing-mode gentext string to support right-to-left languages.
5220
5221 FO
5222
5223 The following changes have been made to the fo code since the 1.74.0 release.
5224
5225   • David Cramer: footnote.xsl
5226
5227     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.
5228
5229   • Mauritz Jeanson: spaces.xsl
5230
5231     Convert spaces to fo:leader also in elements in the DB 5 namespace.
5232
5233   • Mauritz Jeanson: pi.xsl; synop.xsl
5234
5235     Added support for a new processing instruction: dbfo funcsynopsis-style.
5236     Closes bug #1838213.
5237
5238   • Michael(tm) Smith: inline.xsl; param.xweb; param.ent
5239
5240     Added new param email.mailto.enabled for FO output.
5241     Patch from Paolo Borelli. Closes #2086321.
5242
5243   • Mauritz Jeanson: docbook.xsl
5244
5245     Added support for document metadata for fop1 (patch #2067318).
5246
5247   • Jirka Kosek: param.ent; param.xweb; highlight.xsl
5248
5249     Upgraded to support the latest version of XSLTHL 2.0
5250      -- nested markup in highlited code is now processed
5251      -- it is no longer needed to specify path XSLTHL configuration file using Java property
5252      -- support for new languages, including Perl, Python and Ruby was added
5253
5254 HTML
5255
5256 The following changes have been made to the html code since the 1.74.0 release.
5257
5258   • Robert Stayton: param.xweb; docbook.xsl; param.ent; html.xsl
5259
5260     Add support for writing.mode to set text direction and alignment based on document locale.
5261
5262   • Mauritz Jeanson: chunk-changebars.xsl
5263
5264     Added a new top-level stylesheet module, chunk-changebars.xsl, to be
5265     used for generating chunked output with highlighting based on change
5266     (@revisionflag) markup. The module imports/includes the standard chunking
5267     and changebars templates and contains additional logic for chunked output.
5268     See FRs #1015180 and #1819915.
5269
5270 Manpages
5271
5272 The following changes have been made to the manpages code since the 1.74.0
5273 release.
5274
5275   • Michael(tm) Smith: docbook.xsl
5276
5277     Put the following at the top of generated roff for each page:
5278       \" t
5279     purpose is to explicitly tell AT&T troff that the page needs to be
5280     pre-processed through tbl(1); groff can figure it out
5281     automatically, but apparently AT&T troff needs to be explicitly told
5282
5283 ePub
5284
5285 The following changes have been made to the epub code since the 1.74.0 release.
5286
5287   • Keith Fahlgren: docbook.xsl
5288
5289     Patch from Paul Norton of Adobe to get covers to look better in Adobe Digital Editions
5290
5291   • Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
5292     v5cover.xml; bin/spec/sp⋯
5293
5294     Patch contributed by Liza Daly to make ePub cover handling more generic. Additionally
5295     DocBook 5.0's <cover> now has some limited support:
5296
5297     - should reference a cover in the OPF guide for a DocBook 5.0 test document
5298
5299   • Keith Fahlgren: bin/spec/files/isbn.xml; bin/spec/files/issn.xml; bin/spec/
5300     files/biblioid.⋯
5301
5302     Liza Daly reported that the dc:identifer-generation code was garbage (she was right).
5303
5304     Added new tests:
5305     - should include at least one dc:identifier
5306     - should include an ISBN as URN for dc:identifier if an ISBN was in the metadata
5307     - should include an ISSN as URN for dc:identifier if an ISSN was in the metadata
5308     - should include an biblioid as a dc:identifier if an biblioid was in the metadata
5309     - should include a URN for a biblioid with @class attribute as a dc:identifier if an biblioid was in the metadata
5310
5311   • Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb
5312
5313     Improve both SEO and  semantic structure of chunked ePub output by ensuring that
5314     we always send out one and only one h1 in each XHTML chunk.
5315
5316     DocBook::Epub
5317     - should include one and only one <h1> in each HTML file in rendered ePub files
5318     for <book>s
5319     - should include one and only one <h1> in each HTML file in rendered ePub files
5320     for <book>s even if they do not have section markup
5321
5322   • Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
5323     /orm.book.001.x⋯
5324
5325     Adding better support for covers in epub files destined for .mobi and the Kindle
5326
5327   • Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/
5328     DejaVuSerif.otf; docbook.⋯
5329
5330     Adding primitive support for embedding a single font
5331
5332   • Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/
5333     test_cust.xsl; bin/spec/e⋯
5334
5335     Adding support for user-specified customization layers in dbtoepub
5336
5337   • Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/
5338     docbook.rb; bin/s⋯
5339
5340     Adding CSS support to .epub target & dbtoepub:
5341         -c, --css [FILE]                 Use FILE for CSS on generated XHTML.
5342
5343
5344     DocBook::Epub
5345     ...
5346     - should include a CSS link in HTML files when a CSS file has been provided
5347     - should include CSS file in .epub when a CSS file has been provided
5348     - should include a CSS link in OPF file when a CSS file has been provided
5349
5350 Roundtrip
5351
5352 The following changes have been made to the roundtrip code since the 1.74.0
5353 release.
5354
5355   • Steve Ball: blocks2dbk.xsl; template.xml; template.dot
5356
5357     added support for imagedata-metadata
5358     added support for table as images
5359
5360   • Steve Ball: blocks2dbk.xsl; normalise2sections.xsl; sections2blocks.xsl
5361
5362     Improved support for personname inlines.
5363
5364   • Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml
5365
5366     Added support for legalnotice.
5367
5368   • Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl
5369
5370     added support for orgname in author
5371
5372   • Steve Ball: specifications.xml; supported.xml; blocks2dbk.xsl;
5373     wordml2normalise.xsl; dbk2w⋯
5374
5375     Updated specification.
5376     to-DocBook: add cols attribute to tgroup
5377     from-DocBook: fix for blockquote title
5378
5379 Params
5380
5381 The following changes have been made to the params since the 1.74.0 release.
5382
5383   • The change was to add man.output.better.ps.enabled parameter, with its
5384     default value set to zero. If the value of the man.output.better.ps.enabled
5385     parameter is non-zero, certain markup is embedded in each generated man
5386     page such that PostScript output from the man -Tps command for that page
5387     will include a number of enhancements designed to improve the quality of
5388     that output. If man.output.better.ps.enabled is zero (the default), no such
5389     markup is embedded in generated man pages, and no enhancements are included
5390     in the PostScript output generated from those man pages by the man -Tps
5391     command. WARNING: The enhancements provided by this parameter rely on
5392     features that are specific to groff (GNU troff) and that are not part of
5393     "classic" AT&T troff or any of its derivatives. Therefore, any man pages
5394     you generate with this parameter enabled will be readable only on systems
5395     on which the groff (GNU troff) program is installed, such as GNU/Linux
5396     systems. The pages will not not be readable on systems on with the classic
5397     troff (AT&T troff) command is installed. NOTE: The value of this parameter
5398     only affects PostScript output generated from the man command. It has no
5399     effect on output generated using the FO backend. TIP: You can generate
5400     PostScript output for any man page by running the following command: man
5401     FOO -Tps > FOO.ps You can then generate PDF output by running the following
5402     command: ps2pdf FOO.ps
5403
5404   • Robert Stayton: writing.mode.xml
5405
5406     writing mode param used to set text direction.
5407
5408   • Michael(tm) Smith: email.mailto.enabled.xml
5409
5410     Added new param email.mailto.enabled for FO output.
5411     Patch from Paolo Borelli. Closes #2086321.
5412
5413   • Jirka Kosek: highlight.source.xml; highlight.xslthl.config.xml
5414
5415     Upgraded to support the latest version of XSLTHL 2.0
5416      -- nested markup in highlited code is now processed
5417      -- it is no longer needed to specify path XSLTHL configuration file using Java property
5418      -- support for new languages, including Perl, Python and Ruby was added
5419
5420 Highlighting
5421
5422 The following changes have been made to the highlighting code since the 1.74.0
5423 release.
5424
5425   • Jirka Kosek: cpp-hl.xml; c-hl.xml; tcl-hl.xml; php-hl.xml; common.xsl;
5426     perl-hl.xml; delphi⋯
5427
5428     Upgraded to support the latest version of XSLTHL 2.0
5429      -- nested markup in highlited code is now processed
5430      -- it is no longer needed to specify path XSLTHL configuration file using Java property
5431      -- support for new languages, including Perl, Python and Ruby was added
5432
5433 Release Notes: 1.74.0
5434
5435 This release includes important bug fixes and adds the following significant
5436 feature changes:
5437
5438 .epub target
5439
5440     Paul Norton (Adobe) and Keith Fahlgren(O'Reilly Media) have donated code
5441     that generates .epub documents from DocBook input. An alpha-reference
5442     implementation in Ruby has also been provided.
5443
5444     .epub is an open standard of the The International Digital Publishing Forum
5445     (IDPF), a the trade and standards association for the digital publishing
5446     industry.
5447
5448     Read more about this target in epub/README
5449
5450 XHTML 1.1 target
5451
5452     To support .epub output, a strict XHTML 1.1 target has been added. The
5453     stylesheets for this output are generated and are quite similar to the
5454     XHTML target.
5455
5456 Gentext updates
5457
5458     A number of locales have been updated.
5459
5460 Roundtrip improvements
5461
5462     Table, figure, template syncronization, and character style improvements
5463     have been made for WordML & Pages. Support added for OpenOffice.org.
5464
5465 First implementation of a libxslt extension
5466
5467     A stylesheet extension for libxslt, written in Python, has been added. The
5468     extension is a function for adjusting column widths in CALS tables. See
5469     extensions/README.LIBXSLT for more information.
5470
5471 The following is a list of changes that have been made since the 1.73.2
5472 release.
5473
5474 Gentext
5475
5476 The following changes have been made to the gentext code since the 1.73.2
5477 release.
5478
5479   • Michael(tm) Smith: locale/id.xml
5480
5481     Checked in changes to Indonesion locale submitted by Euis Luhuanam a long time ago.
5482
5483   • Michael(tm) Smith: locale/lt.xml
5484
5485     Added changes to Lithuanian locate submitted a long time back by Nikolajus Krauklis.
5486
5487   • Michael(tm) Smith: locale/hu.xml
5488
5489     fixed error in lowercase.alpha definition in Hungarian locale
5490
5491   • Michael(tm) Smith: locale/nb.xml
5492
5493     Corrected language code for nb locale, and restored missing "startquote" key.
5494
5495   • Michael(tm) Smith: locale/ja.xml
5496
5497     Committed changes to ja locale file, from Akagi Kobayashi. Adds bracket quotes around many xref instances that did not have them
5498     before.
5499
5500   • Michael(tm) Smith: Makefile
5501
5502     "no" locale is now "nb"
5503
5504   • Michael(tm) Smith: locale/nb.xml
5505
5506     Update Norwegian Bokmål translation. Thanks to Hans F. Nordhaug.
5507
5508   • Michael(tm) Smith: locale/no.xml; locale/nb.xml
5509
5510     per message from Hans F. Nordhaug, correct identifier for
5511     Norwegian Bokmål is "nb" (not "no") and has been for quite some
5512     time now...
5513
5514   • Michael(tm) Smith: locale/ja.xml
5515
5516     Converted ja.xml source file to use real unicode characters so
5517     that the actual glyphs so up when you edit it in a text editor
5518     (instead of the character references).
5519
5520   • Michael(tm) Smith: locale/ja.xml
5521
5522     Checked in changes to ja.xml locale file. Thanks to Akagi Kobayashi.
5523
5524   • Michael(tm) Smith: locale/it.xml
5525
5526     Changes from Federico Zenith
5527
5528   • Dongsheng Song: locale/zh_cn.xml
5529
5530     Added missing translations.
5531
5532 Common
5533
5534 The following changes have been made to the common code since the 1.73.2
5535 release.
5536
5537   • Michael(tm) Smith: l10n.xsl
5538
5539     Added new template "l10.language.name" for retrieving the
5540     English-language name of the lang setting of the current document.
5541     Closes #1916837. Thanks to Simon Kennedy.
5542
5543   • Michael(tm) Smith: refentry.xsl
5544
5545     fixed syntax error
5546
5547   • Michael(tm) Smith: refentry.xsl
5548
5549     fixed a couple of typos
5550
5551   • Michael(tm) Smith: refentry.xsl
5552
5553     refined handling of cases where refentry "source" or "manual"
5554     metadata is missing or when we use fallback content instead. We
5555     now report a Warning if we use fallback content.
5556
5557   • Michael(tm) Smith: refentry.xsl
5558
5559     don't use refmiscinfo@class=date value as fallback for refentry
5560     "source" or "manual" metadata fields
5561
5562   • Michael(tm) Smith: refentry.xsl
5563
5564     Made reporting of missing refentry metadata more quiet:
5565
5566       - we no longer report anything if usable-but-not-preferred
5567         metadata is found; we just quietly use whatever we manage to
5568         find
5569
5570       - we now only report missing "source" metadata if the refentry
5571         is missing BOTH "source name" and "version" metadata; if it
5572         has one but not the other, we use whichever one it has and
5573         don't report anything as missing
5574
5575     The above changes were made because testing with some "real world"
5576     source reveals that some authors are intentionally choosing to use
5577     "non preferred" markup for some metadata, and also choosing to
5578     omit "source name" or "version" metadata in there DocBook XML. So
5579     it does no good to give them pedantic reminders about what they
5580     already know...
5581
5582     Also, changed code to cause "fixme" text to be inserted in output
5583     in particular cases:
5584
5585       - if we can't manage to find any "source" metadata at all, we
5586         now put fixme text into the output
5587
5588       - if we can't manage to find any "manual" metadata a all, we
5589         now put fixme text into the output
5590
5591     The "source" and "manual" metadata is necessary information, so
5592     buy putting the fixme stuff in the output, we alert users to the
5593     need problem of it being missing.
5594
5595   • Michael(tm) Smith: refentry.xsl
5596
5597     When generating manpages output, we no longer report anything if
5598     the refentry source is missing date or pubdate content. In
5599     practice, many users intentionally omit the date from the source
5600     because they explicitly want it to be generated.
5601
5602   • Michael(tm) Smith: l10n.xml
5603
5604     further change needed for switch from no locale to nb.
5605
5606   • Michael(tm) Smith: common.xsl
5607
5608     Added support for orgname in authorgroup. Thanks to Camille
5609     Bégnis.
5610
5611   • Michael(tm) Smith: Makefile
5612
5613     "no" locale is now "nb"
5614
5615   • Mauritz Jeanson: stripns.xsl
5616
5617     Removed the template matching "ng:link|db:link" (in order to make @xlink:show
5618     work with <link> elements). As far as I can tell, this template is no longer needed.
5619
5620   • Mauritz Jeanson: entities.ent
5621
5622     Moved declaration of comment.block.parents entity to common/entities.ent.
5623
5624   • Mauritz Jeanson: titles.xsl
5625
5626     Added an update the fix made in revision 7528 (handling of xref/link in no.anchor.mode mode).
5627     Having xref in title is not a problem as long as the target is not an ancestor element.
5628     Closes bug #1838136.
5629
5630     Note that an xref that is in a title and whose target is an ancestor element is still not
5631     rendered in the TOC. This could be considered a bug, but on the other hand I cannot really
5632     see the point in having such an xref in a document.
5633
5634   • Mauritz Jeanson: titles.xsl
5635
5636     Added a "not(ancestor::title)" test to work around "too many nested
5637     apply-templates" problems when processing xrefs or links in no.anchor.mode mode.
5638     Hopefully, this closes bug #1811721.
5639
5640   • Mauritz Jeanson: titles.xsl
5641
5642     Removed old template matching "link" in no.anchor.mode mode.
5643
5644   • Mauritz Jeanson: titles.xsl
5645
5646     Process <link> in no.anchor.mode mode with the same template as <xref>.
5647     Closes bug #1759205 (Empty link in no.anchor.mode mode).
5648
5649   • Mauritz Jeanson: titles.xsl
5650
5651     In no.anchor.mode mode, do not output anchors for elements that are descendants
5652     of <title>. Previously, having inline elements with @id/@xml:id in <title>s
5653     resulted in anchors both in the TOC and in the main flow. Closes bug #1797492.
5654
5655 FO
5656
5657 The following changes have been made to the fo code since the 1.73.2 release.
5658
5659   • Mauritz Jeanson: pi.xsl
5660
5661     Updated documentation for keep-together.
5662
5663   • Mauritz Jeanson: task.xsl
5664
5665     Enabled use of the keep-together PI on task elements.
5666
5667   • Robert Stayton: index.xsl
5668
5669     FOP1 requires fo:wrapper for inline index entries, not fo:inline.
5670
5671   • Robert Stayton: index.xsl
5672
5673     Fixed non-working inline.or.block template for indexterm wrappers.
5674     Add fop1 to list of processors using inline.or.block.
5675
5676   • Mauritz Jeanson: table.xsl
5677
5678     Fixed bug #1891965 (colsep in entytbl not working).
5679
5680   • Mauritz Jeanson: titlepage.xsl
5681
5682     Added support for title in revhistory. Closes bug #1842847.
5683
5684   • Mauritz Jeanson: pi.xsl
5685
5686     Small doc cleanup (dbfo float-type).
5687
5688   • Mauritz Jeanson: titlepage.xsl
5689
5690     Insert commas between multiple copyright holders.
5691
5692   • Mauritz Jeanson: autotoc.xsl; division.xsl
5693
5694     Added modifications to support nested set elements. See bug #1853172.
5695
5696   • David Cramer: glossary.xsl
5697
5698     Added normalize-space to xsl:sorts to avoid missorting of glossterms due to stray leading spaces.
5699
5700   • David Cramer: glossary.xsl
5701
5702     Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry
5703
5704   • Mauritz Jeanson: inline.xsl
5705
5706     Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,
5707     and the "hot text" is the biblioid itself enclosed in brackets.
5708
5709   • Mauritz Jeanson: inline.xsl
5710
5711     Moved declaration of comment.block.parents entity to common/entities.ent.
5712
5713   • Mauritz Jeanson: docbook.xsl
5714
5715     Updated message about unmatched element.
5716
5717   • Mauritz Jeanson: param.xweb
5718
5719     Added link to profiling chapter of TCG.
5720
5721   • Mauritz Jeanson: refentry.xsl
5722
5723     Fixed typo (refsynopsysdiv -> refsynopsisdiv).
5724
5725   • David Cramer: fop.xsl; fop1.xsl; ptc.xsl; xep.xsl
5726
5727     Added test to check generate.index param when generating pdf bookmarks
5728
5729   • Mauritz Jeanson: graphics.xsl
5730
5731     Added support for MathML in imagedata.
5732
5733   • Michael(tm) Smith: math.xsl
5734
5735     Removed unnecessary extra test condition in test express that
5736     checks for passivetex.
5737
5738   • Michael(tm) Smith: math.xsl
5739
5740     Don't use fo:instream-foreign-object if we are processing with
5741     passivetex. Closes #1806899. Thanks to Justus Piater.
5742
5743   • Mauritz Jeanson: component.xsl
5744
5745     Added code to output a TOC for an appendix in an article when
5746     generate.toc='article/appendix toc'. Closes bug #1669658.
5747
5748   • Dongsheng Song: biblio-iso690.xsl
5749
5750     Change encoding from "windows-1250" to "UTF-8".
5751
5752   • Mauritz Jeanson: pi.xsl
5753
5754     Updated documentation for dbfo_label-width.
5755
5756   • Mauritz Jeanson: lists.xsl
5757
5758     Added support for the dbfo_label-width PI in calloutlists.
5759
5760   • Robert Stayton: biblio.xsl
5761
5762     Support finding glossary database entries inside bibliodivs.
5763
5764   • Robert Stayton: formal.xsl
5765
5766     Complete support for <?dbfo pgwide="1"?> for informal
5767     elements too.
5768
5769   • Mauritz Jeanson: table.xsl
5770
5771     In the table.block template, added a check for the dbfo_keep-together PI, so that
5772     a table may break (depending on the PI value) at a page break. This was needed
5773     since the outer fo:block that surrounds fo:table has keep-together.within-column="always"
5774     by default, which prevents the table from breaking. Closes bug #1740964 (Titled
5775     table does not respect dbfo PI).
5776
5777   • Mauritz Jeanson: pi.xsl
5778
5779     Added a few missing @role="tcg".
5780
5781   • Mauritz Jeanson: inline.xsl
5782
5783     Use normalize-space() in glossterm comparisons (as in html/inline.xsl).
5784
5785   • Mauritz Jeanson: autoidx.xsl
5786
5787     Removed the [&scope;] predicate from the target variable in the template with name="reference".
5788     This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
5789     with index.on.type=1. Closes bug #1680836.
5790
5791   • Michael(tm) Smith: inline.xsl; xref.xsl; footnote.xsl
5792
5793     Added capability in FO output for displaying URLs for all
5794     hyperlinks (elements marked up with xlink:href attributes) in the
5795     same way as URLs for ulinks are already handled (which is to say,
5796     either inline or as numbered footnotes).
5797
5798     Background on this change:
5799     DocBook 5 allows "ubiquitous" linking, which means you can make
5800     any element a hyperlink just by adding an xlink:href attribute to
5801     it, with the value set to an external URL. That's in contrast to
5802     DocBook 4, which only allows you to use specific elements (e.g.,
5803     the link and ulink elements) to mark up hyperlinks.
5804
5805     The existing FO stylesheets have a mechanism for handling display
5806     of URLs for hyperlinks that are marked up with ulink, but they did
5807     not handle display of URLs for elements that were marked up with
5808     xlink:href attributes. This change adds handling for those other
5809     elements, enabling the URLs they link to be displayed either
5810     inline or as numbered footnotes (depending on what values the user
5811     has the ulink.show and ulink.footnotes params set to).
5812
5813     Note that this change only adds URL display support for elements
5814     that call the simple.xlink template -- which currently is most
5815     (but not all) inline elements.
5816
5817     This change also moves the URL display handling out of the ulink
5818     template and into a new "hyperlink.url.display" named template;
5819     the ulink template and the simple.xlink named template now both
5820     call the hyperlink.url.display template.
5821
5822     Warning: In the stylesheet code that determines what footnote
5823     number to assign to each footnote or external hyperlink, there is
5824     an XPath expression for determining whether a particular
5825     xlink:href instance is an external hyperlink; that expression is
5826     necessarily a bit complicated and further testing may reveal that
5827     it doesn't handle all cases as expected -- so some refinements to
5828     it may need to be done later.
5829
5830     Closes #1785519. Thanks to Ken Morse for reporting and
5831     troubleshooting the problem.
5832
5833 HTML
5834
5835 The following changes have been made to the html code since the 1.73.2 release.
5836
5837   • Keith Fahlgren: inline.xsl; synop.xsl
5838
5839     Work to make HTML and XHTML targets more valid
5840
5841   • Keith Fahlgren: table.xsl
5842
5843     Add better handling for tables that have footnotes in the titles
5844
5845   • Keith Fahlgren: biblio.xsl
5846
5847     Add anchors to bibliodivs
5848
5849   • Keith Fahlgren: formal.xsl; Makefile; htmltbl.xsl
5850
5851     Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
5852     and Keith Fahlgren of O'Reilly.
5853
5854     This change includes new code for generating the XHTML 1.1 target sanely.
5855
5856   • Mauritz Jeanson: biblio.xsl
5857
5858     Added code for creating URLs from biblioids with @class="doi" (representing Digital
5859     Object Identifiers). See FR #1934434 and http://doi.org.
5860
5861     To do: 1) Add support for FO output. 2) Figure out how @class="doi" should be handled
5862     for bibliorelation, bibliosource and citebiblioid.
5863
5864   • Norman Walsh: formal.xsl
5865
5866     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.
5867
5868   • Michael(tm) Smith: Makefile
5869
5870     Added checks and hacks to various makefiles to enable building
5871     under Cygwin. This stuff is ugly and maybe not worth the mess and
5872     trouble, but does seem to work as expected and not break anything
5873     else.
5874
5875   • Michael(tm) Smith: docbook.xsl
5876
5877     added "exslt" namespace binding to html/docbook.xsl file (in
5878     addition to existing "exsl" binding. reason is because lack of it
5879     seems to cause processing problems when using the profiled
5880     version of the stylsheet
5881
5882   • Norman Walsh: chunk-common.xsl
5883
5884     Rename link
5885
5886   • Mauritz Jeanson: table.xsl
5887
5888     Added a fix to make rowsep apply to the last row of thead in entrytbl.
5889
5890   • Michael(tm) Smith: synop.xsl
5891
5892     Simplified and streamlined handling of output for ANSI-style
5893     funcprototype output, to correct a problem that was causing type
5894     data to be lost in the output parameter definitions. For example,
5895     for an instance like this:
5896       <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
5897     ... the brackets (indicating an array type) were being dropped.
5898
5899   • Michael(tm) Smith: synop.xsl
5900
5901     Changed HTML handling of K&R-style paramdef output. The parameter
5902     definitions are no longer output in a table (though the prototype
5903     still is). The reason for the change is that the
5904     kr-tabular-funcsynopsis-mode template was causing type data to be
5905     lost in the output parameter definitions. For example, for an
5906     instance like this:
5907       <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
5908     ... the brackets (indicating an array type) were being dropped.
5909     The easiest way to deal with the problem is to not try to chop up
5910     the parameter definitions and display them in table format, but to
5911     instead just output them as-is. May not look quite as pretty, but
5912     at least we can be sure no information is being lost...
5913
5914   • Michael(tm) Smith: pi.xsl
5915
5916     updated wording of doc for funcsynopsis-style PI
5917
5918   • Michael(tm) Smith: param.xweb; param.ent; synop.xsl
5919
5920     Removed the funcsynopsis.tabular.threshold param. It's no longer
5921     being used in the code and hasn't been since mid 2006.
5922
5923   • Mauritz Jeanson: graphics.xsl
5924
5925     Added support for the img.src.path parameter for SVG graphics. Closes bug #1888169.
5926
5927   • Mauritz Jeanson: chunk-common.xsl
5928
5929     Added missing space.
5930
5931   • Norman Walsh: component.xsl
5932
5933     Fix bug where component titles inside info elements were not handled properly
5934
5935   • Michael(tm) Smith: pi.xsl
5936
5937     Moved dbhtml_stop-chunking embedded doc into alphabetical order,
5938     fixed text of TCG section it see-also'ed.
5939
5940   • David Cramer: pi.xsl
5941
5942     Added support for <?dbhtml stop-chunking?> processing instruction
5943
5944   • David Cramer: chunk-common.xsl; pi.xsl
5945
5946     Added support for <?dbhtml stop-chunking?> processing instruction
5947
5948   • David Cramer: glossary.xsl
5949
5950     Fixed bug #1854199: glossary.xsl should use the sortas attribute on glossentry. Also added normalize-space to avoid missorting due to stray leading spaces.
5951
5952   • Mauritz Jeanson: inline.xsl
5953
5954     Added a template for citebiblioid. The hyperlink target is the parent of the referenced biblioid,
5955     and the "hot text" is the biblioid itself enclosed in brackets.
5956
5957   • Mauritz Jeanson: inline.xsl
5958
5959     Added support for @xlink:show in the simple.xlink template. The "new" and "replace"
5960     values are supported (corresponding to values of "_blank" and "_top" for the
5961     ulink.target parameter). I have assumed that @xlink:show should override ulink.target
5962     for external URI links. This closes bugs #1762023 and #1727498.
5963
5964   • Mauritz Jeanson: inline.xsl
5965
5966     Moved declaration of comment.block.parents entity to common/entities.ent.
5967
5968   • Mauritz Jeanson: param.xweb
5969
5970     Added link to profiling chapter of TCG.
5971
5972   • Dongsheng Song: biblio-iso690.xsl
5973
5974     Change encoding from "windows-1250" to "UTF-8".
5975
5976   • Robert Stayton: biblio.xsl
5977
5978     Add support in biblio collection to entries in bibliodivs.
5979
5980   • Mauritz Jeanson: pi.xsl
5981
5982     Added missing @role="tcg".
5983
5984   • Mauritz Jeanson: chunk-common.xsl; titlepage.xsl
5985
5986     Refactored legalnotice/revhistory chunking, so that the use.id.as.filename
5987     parameter as well as the dbhtml_filename PI are taken into account. A new named
5988     template in titlepage.xsl is used to compute the filename.
5989
5990   • Mauritz Jeanson: chunk-common.xsl; titlepage.xsl
5991
5992     An update to the fix for bug #1790495 (r7433):
5993     The "ln-" prefix is output only when the legalnotice doesn't have an
5994     @id/@xml:id, in which case the stylesheets generate an ID value,
5995     resulting in a filename like "ln-7e0fwgj.html". This is useful because
5996     without the prefix, you wouldn't know that the file contained a legalnotice.
5997     The same logic is also applied to revhistory, using an "rh-" prefix.
5998
5999   • Mauritz Jeanson: autoidx.xsl
6000
6001     Removed the [&scope;] predicate from the target variable in the template with name="reference".
6002     This filter was the cause of missing index backlinks when @zone and @type were used on indexterms,
6003     with index.on.type=1. Closes bug #1680836.
6004
6005   • Mauritz Jeanson: titlepage.xsl
6006
6007     Added 'ln-' prefix to the name of the legalnotice chunk, in order to match the
6008     <link href"..."> that is output by make.legalnotice.head.links (chunk-common.xsl).
6009     Modified the href attribute on the legalnotice link.
6010     Closes bug #1790495.
6011
6012 Manpages
6013
6014 The following changes have been made to the manpages code since the 1.73.2
6015 release.
6016
6017   • Michael(tm) Smith: other.xsl
6018
6019     slightly adjusted spacing around admonition markers
6020
6021   • Michael(tm) Smith: refentry.xsl; utility.xsl
6022
6023     make sure refsect3 titles are preceded by a line of space, and
6024     make the indenting of their child content less severe
6025
6026   • Michael(tm) Smith: block.xsl
6027
6028     only indent verbatim environments in TTY output, not in non-TTY/PS
6029
6030   • Michael(tm) Smith: block.xsl
6031
6032     made another adjustment to correct vertical alignment of admonition marker
6033
6034   • Michael(tm) Smith: block.xsl; other.xsl
6035
6036     Adjusted/corrected alignment of adominition marker in PS/non-TTY output.
6037
6038   • Michael(tm) Smith: endnotes.xsl
6039
6040     For PS/non-TTY output, display footnote/endnote numbers in
6041     superscript.
6042
6043   • Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl
6044
6045     Changed handling of hanging indents for cmdsynopsis, funcsynopsis,
6046     and synopfragment such that they now look correct in non-TTY/PS
6047     output. We now use the groff \w escape to hang by the actual width
6048     -- in the current font -- of the command, funcdef, or
6049     synopfragment references number (as opposed to hanging by the
6050     number of characters). This rendering in TTY output remains the
6051     same, since the width in monospaced TTY output is the same as the
6052     number of characters.
6053
6054     Also, created new synopsis-block-start and synopsis-block-end
6055     templates to use for cmdsynopsis and funcsynopsis instead of the
6056     corresponding verbatim-* templates.
6057
6058     Along with those changes, also corrected a problem that caused the
6059     content of synopfragment to be dropped, and made a
6060     vertical-spacing change to adjust spacing around table titles and
6061     among sibling synopfragment instances.
6062
6063   • Michael(tm) Smith: other.xsl
6064
6065     use common l10.language.name template to retrieve English-language name
6066
6067   • Michael(tm) Smith: synop.xsl; inline.xsl
6068
6069     added comment in code explaining why we don't put filename output
6070     in italic (despite the fact that man guidelines say we should)
6071
6072   • Michael(tm) Smith: inline.xsl
6073
6074     put filename output in monospace instead of italic
6075
6076   • Michael(tm) Smith: synop.xsl
6077
6078     put cmdsynopsis in monospace
6079
6080   • Michael(tm) Smith: inline.xsl
6081
6082     removed template match for literal. template matches for monospace
6083     inlines are all imported from the HTML stylesheet
6084
6085   • Michael(tm) Smith: block.xsl
6086
6087     don't indent verbatim environments that are descendants of
6088     refsynopsisdiv, not put backgrounds behind them
6089
6090   • Michael(tm) Smith: inline.xsl
6091
6092     set output of the literal element in monospace. this causes all
6093     inline monospace instances in the git man pages to be set in
6094     monospace (since DocBook XML source for git docs is generated with
6095     asciidoc and asciidoc consistently outputs only <literal> for
6096     inline monospace (not <command> or <code> or anything else).
6097     Of course this only affects non-TTY output...
6098
6099   • Michael(tm) Smith: utility.xsl
6100
6101     Added inline.monoseq named template.
6102
6103   • Michael(tm) Smith: utility.xsl
6104
6105     don't bother using a custom register to store the previous
6106     font-family value when setting blocks of text in code font; just
6107     use \F[] .fam with no arg to switch back
6108
6109   • Michael(tm) Smith: endnotes.xsl
6110
6111     put links in blue in PS output (note that this matches how groff
6112     renders content marked up with the .URL macro)
6113
6114   • Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent
6115
6116     removed man.links.are.underlined and added man.font.links. Also,
6117     changed the default font formatting for links to bold.
6118
6119   • Michael(tm) Smith: endnotes.xsl; param.xweb; param.ent
6120
6121     Added new param man.base.url.for.relative.links .. specifies a
6122     base URL for relative links (for ulink, @xlink:href, imagedata,
6123     audiodata, videodata) shown in the generated NOTES section of
6124     man-page output. The value of man.base.url.for.relative.links is
6125     prepended to any relative URI that is a value of ulink url,
6126     xlink:href, or fileref attribute.
6127
6128     If you use relative URIs in link sources in your DocBook refentry
6129     source, and you leave man.base.url.for.relative.links unset, the
6130     relative links will appear "as is" in the NOTES section of any
6131     man-page output generated from your source. That's probably not
6132     what you want, because such relative links are only usable in the
6133     context of HTML output. So, to make the links meaningful and
6134     usable in the context of man-page output, set a value for
6135     man.base.url.for.relative.links that points
6136     to the online version of HTML output generated from your DocBook
6137     refentry source. For example:
6138
6139       <xsl:param name="man.base.url.for.relative.links"
6140       >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param>
6141
6142   • Michael(tm) Smith: info.xsl
6143
6144     If a source refentry contains a Documentation or DOCUMENTATION
6145     section, don't report it as having missing AUTHOR information.
6146     Also, if missing a contrib/personblurb for a person or org, report
6147     pointers to http://docbook.sf.net/el/personblurb and to
6148     http://docbook.sf.net/el/contrib
6149
6150   • Michael(tm) Smith: info.xsl
6151
6152     If we encounter an author|editor|othercredit instance that lacks a
6153     personblurb or contrib, report it to the user (because that means
6154     we have no information about that author|editor|othercredit to
6155     display in the generated AUTHOR|AUTHORS section...)
6156
6157   • Michael(tm) Smith: info.xsl; docbook.xsl; other.xsl
6158
6159     if we can't find any usable author data, emit a warning and insert
6160     a fixme in the output
6161
6162   • Michael(tm) Smith: info.xsl
6163
6164     fixed bug in indenting of output for contrib instances in AUTHORS
6165     section. Thanks to Daniel Leidert and the fglrx docs for exposing
6166     the bug.
6167
6168   • Michael(tm) Smith: block.xsl
6169
6170     for a para or simpara that is the first child of a callout,
6171     suppress the .sp or .PP that would normally be output (because in
6172     those cases, the output goes into a table cell, and the .sp or .PP
6173     markup causes a spurious linebreak before it when displayed
6174
6175   • Michael(tm) Smith: lists.xsl
6176
6177     Added support for rendering co callouts and calloutlist instances.
6178     So you can now use simple callouts -- marking up programlisting
6179     and such with co instances -- and have the callouts displayed in
6180     man-page output. ("simple callouts" means using co@id and
6181     callout@arearefs pointing to co@id instances; in man/roff output,
6182     we can't/don't support markup that uses areaset and area)
6183
6184   • Michael(tm) Smith: block.xsl
6185
6186     only put a line of space after a verbatim if it's followed by a
6187     text node or a paragraph
6188
6189   • Michael(tm) Smith: utility.xsl
6190
6191     put verbatim environments in slightly smaller font in non-TTY
6192     output
6193
6194   • Michael(tm) Smith: lists.xsl
6195
6196     minor whitespace-only reformatting of lists.xsl source
6197
6198   • Michael(tm) Smith: lists.xsl
6199
6200     Made refinements/fixes to output of orderedlist and itemizedlist
6201     -- in part, to get mysql man pages to display correctly. This
6202     change causes a "\c" continuation marker to be added between
6203     listitem markers and contents (to ensure that the content remains
6204     on the same line as the marker when displayed)
6205
6206   • Michael(tm) Smith: block.xsl
6207
6208     put a line of vertical space after all verbatim output that has
6209     sibling content following it (not just if that sibling content is
6210     a text node)
6211
6212   • Michael(tm) Smith: block.xsl
6213
6214     refined spacing around titles for admonitions
6215
6216   • Michael(tm) Smith: block.xsl; other.xsl
6217
6218     Deal with case of verbatim environments that have a linebreak
6219     after the opening tag. Assumption is that users generally don't
6220     want that linebreak to appear in output, so we do some groff
6221     hackery to mess with vertical spacing and close the space.
6222
6223   • Michael(tm) Smith: inline.xsl
6224
6225     indexterm instances now produce groff comments like this:
6226
6227       .\" primary: secondary: tertiary
6228
6229     remark instances, if non-empty, now produce groff comments
6230
6231   • Michael(tm) Smith: charmap.groff.xsl; other.xsl
6232
6233     convert no-break space character to groff "\ \&" (instead of just
6234     "\ "). the reason is that if a space occurs at the end of a line,
6235     our processing causes it to be eaten. a real-world case of this is
6236     the mysql(1) man page. appending the "\&" prevents that
6237
6238   • Michael(tm) Smith: block.xsl
6239
6240     output "sp" before simpara output, not after it (outputting it
6241     after results in undesirable whitespace in particular cases; for
6242     example, in the hg/mercurial docs
6243
6244   • Michael(tm) Smith: table.xsl; synop.xsl; utility.xsl
6245
6246     renamed from title-preamble to pinch.together and replaced "sp -1"
6247     between synopsis fragments with call to pinch.together instead
6248
6249   • Michael(tm) Smith: table.xsl
6250
6251     use title-preamble template for table titles (instead of "sp -1"
6252     hack), and "sp 1" after all tables (instead of just "sp"
6253
6254   • Michael(tm) Smith: utility.xsl
6255
6256     created title-preamble template for suppressing line spacing after
6257     headings
6258
6259   • Michael(tm) Smith: info.xsl
6260
6261     further refinement of indenting in AUTHORS section
6262
6263   • Michael(tm) Smith: block.xsl; other.xsl
6264
6265     refined handling of admonitions
6266
6267   • Michael(tm) Smith: lists.xsl
6268
6269     Use RS/RE in another place where we had IP ""
6270
6271   • Michael(tm) Smith: info.xsl
6272
6273     Replace (ab)use of IP with "sp -1" in AUTHORS section with RS/RE
6274     instead.
6275
6276   • Michael(tm) Smith: table.xsl; synop.xsl; info.xsl
6277
6278     changed all instances of ".sp -1n" to ".sp -1"
6279
6280   • Michael(tm) Smith: other.xsl
6281
6282     add extra line before SH heads only in non-TTY output
6283
6284   • Michael(tm) Smith: block.xsl
6285
6286     Reworked output for admonitions (caution, important, note, tip,
6287     warning). In TTY output, admonitions now get indented. In non-TTY
6288     output, a colored marker (yellow) is displayed next to them.
6289
6290   • Michael(tm) Smith: other.xsl
6291
6292     Added BM/EM macros for putting a colored marker in margin next to
6293     a block of text.
6294
6295   • Michael(tm) Smith: utility.xsl
6296
6297     created make.bold.title template by moving title-bolding part out
6298     from nested-section-title template. This allows the bolding to
6299     also be used by the template for formatting admonitions
6300
6301   • Michael(tm) Smith: info.xsl
6302
6303     put .br before copyright contents to prevent them from getting run in
6304
6305   • Michael(tm) Smith: refentry.xsl; other.xsl; utility.xsl
6306
6307     made point size of output for Refsect2 and Refsect3 heads bigger
6308
6309   • Michael(tm) Smith: other.xsl
6310
6311     put slightly more space between SH head and underline in non-TTY
6312     output
6313
6314   • Michael(tm) Smith: param.xweb; param.ent; other.xsl
6315
6316     Added the man.charmap.subset.profile.english parameter and refined
6317     the handling of charmap subsets to differentiate between English
6318     and non-English source.
6319
6320     This way charmap subsets are now handled is this:
6321
6322     If the value of the man.charmap.use.subset parameter is non-zero,
6323     and your DocBook source is not written in English (that is, if its
6324     lang or xml:lang attribute has a value other than en), then the
6325     character-map subset specified by the man.charmap.subset.profile
6326     parameter is used instead of the full roff character map.
6327
6328     Otherwise, if the lang or xml:lang attribute on the root element
6329     in your DocBook source or on the first refentry element in your
6330     source has the value en or if it has no lang or xml:lang
6331     attribute, then the character-map subset specified by the
6332     man.charmap.subset.profile.english parameter is used instead of
6333     man.charmap.subset.profile.
6334
6335     The difference between the two subsets is that
6336     man.charmap.subset.profile provides mappings for characters in
6337     Western European languages that are not part of the Roman
6338     (English) alphabet (ASCII character set).
6339
6340   • Michael(tm) Smith: other.xsl
6341
6342     Various updates, mainly related to uppercasing SH titles:
6343
6344       - added a "Language: " metadata line to the top comment area of
6345         output man pages, to indicate the language the page is in
6346
6347       - added a "toupper" macro of doing locale-aware uppercasing of
6348         SH titles and cross-references to SH titles; the mechanism
6349         relies on the uppercase.alpha and lowercase.alpha DocBook
6350         gentext keys to do locale-aware uppercasing based on the
6351         language the page is written in
6352
6353       - added a "string.shuffle" template, which provides a library
6354         function for "shuffling" two strings together into a single
6355         string; it takes the first character for the first string, the
6356         first character from second string, etc. The only current use
6357         for it is to generate the argument for the groff tr request
6358         that does string uppercasing.
6359
6360       - added make.tr.uppercase.arg and make.tr.normalcase.arg named
6361         templates for use in generating groff code for uppercasing and
6362         "normal"-casing SH titles
6363
6364       - made the BB/BE "background drawing" macros have effect only in
6365         non-TTY output
6366
6367       - output a few comments in the top part of source
6368
6369   • Michael(tm) Smith: utility.xsl
6370
6371     removed some leftover kruft
6372
6373   • Michael(tm) Smith: refentry.xsl
6374
6375     To create the name(s) for each man page, we now replace any spaces
6376     in the refname(s) with underscores. This ensures that tools like
6377     lexgrog(1) will be able to parse the name (lexgrog won't parse
6378     names that contain spaces).
6379
6380   • Michael(tm) Smith: docbook.xsl
6381
6382     Put a comment into source of man page to indicate where the main
6383     content starts. (We now have a few of macro definitions at the
6384     start of the source, so putting this comment in helps those that
6385     might be viewing the source.)
6386
6387   • Michael(tm) Smith: refentry.xsl
6388
6389     refined mechanism for generating SH titles
6390
6391   • Michael(tm) Smith: charmap.groff.xsl
6392
6393     Added zcaron, Zcaron, scaron, and Scaron to the groff character map.
6394     This means that generated Finnish man pages will no longer contain
6395     any raw accented characters -- they'll instead by marked up with
6396     groff escapes.
6397
6398   • Michael(tm) Smith: other.xsl; utility.xsl
6399
6400     corrected a regression I introduced about a year ago that caused
6401     dots to be output just as "\." -- instead needs to be "\&." (which
6402     is what it will be now, after this change)
6403
6404   • Michael(tm) Smith: refentry.xsl
6405
6406     Changed backend handling for generating titles for SH sections and
6407     for cross-references to those sections. This should have no effect
6408     on TTY output (behavior should remain the same hopefully) but
6409     results in titles in normal case (instead of uppercase) in PS
6410     output.
6411
6412   • Michael(tm) Smith: info.xsl
6413
6414     use make.subheading template to make subheadings for AUTHORS and
6415     COPYRIGHT sections (instead of harcoding roff markup)
6416
6417   • Michael(tm) Smith: block.xsl
6418
6419     put code font around programlisting etc.
6420
6421   • Michael(tm) Smith: synop.xsl; docbook.xsl
6422
6423     embed custom macro definitions in man pages, plus wrap synopsis in
6424     code font
6425
6426   • Michael(tm) Smith: endnotes.xsl
6427
6428     use the make.subheading template to generated SH subheading for
6429     endnotes section.
6430
6431   • Michael(tm) Smith: lists.xsl
6432
6433     Added some templates for generating if-then-else conditional
6434     markup in groff, so let's use those instead of hard-coding it in
6435     multiple places...
6436
6437   • Michael(tm) Smith: other.xsl; utility.xsl
6438
6439     Initial checkin of some changes related to making PS/PDF output
6440     from "man -l -Tps" look better. The current changes:
6441
6442       - render synopsis and verbatim sections in a monospace/code font
6443
6444       - put a light-grey background behind all programlisting, screen,
6445         and literallayout instances
6446
6447       - prevent SH heads in PS output from being rendered in uppercase
6448         (as they are in console output)
6449
6450       - also display xrefs to SH heads in PS output in normal case
6451         (instead of uppercase)
6452
6453       - draw a line under SH heads in PS output
6454
6455     The changes made to the code to support the above features were:
6456
6457       - added some embedded/custom macros: one for conditionally
6458         upper-casing SH x-refs, one for redefining the SH macro
6459         itself, with some conditional handling for PS output, and
6460         finally a macro for putting a background/screen (filled box)
6461         around a block of text (e.g., a program listing) in PS output
6462
6463       - added utility templates for wrapping blocks of text in code
6464         font; also templates for inline code font
6465
6466   • Robert Stayton: refentry.xsl
6467
6468     refpurpose nodes now get apply-templates instead of just normalize-space().
6469
6470   • Michael(tm) Smith: lists.xsl
6471
6472     Fixed alignment of first lined of text for each listitem in
6473     orderedlist output for TTY. Existing code seemed to have been
6474     causing an extra undesirable space to appear.
6475
6476   • Michael(tm) Smith: lists.xsl
6477
6478     Wrapped some roff conditionals around roff markup for orderedlist
6479     and itemizedlist output, so that the lists look acceptable in PS
6480     output as well as TTY.
6481
6482   • Michael(tm) Smith: pi.xsl; synop.xsl; param.xweb; param.ent
6483
6484     Added the man.funcsynopsis.style parameter. Has the same effect in
6485     manpages output as the funcsynopsis.style parameter has in HTML
6486     output -- except that its default value is 'ansi' instead of 'kr'.
6487
6488   • Michael(tm) Smith: synop.xsl
6489
6490     Reworked handling of K&R funcprototype output. It no longer relies
6491     on the HTML kr-tabular templates, but instead just does direct
6492     transformation to roff. For K&R output, it displays the paramdef
6493     output in an indented list following the prototype.
6494
6495   • Michael(tm) Smith: synop.xsl
6496
6497     Properly integrated handling for K&R output into manpages
6498     stylesheet. The choice between K&R output and ANSI output is
6499     currently controlled through use of the (HTML) funcsynopsis.style
6500     parameter. Note that because the mechanism does currently rely on
6501     funcsynopsis.style, the default in manpages output is now K&R
6502     (because that's the default of that param). But I suppose I ought
6503     to create a man.funcsynopsis.style and make the default for that
6504     ANSI (to preserve the existing default behavior).
6505
6506   • Michael(tm) Smith: docbook.xsl
6507
6508     added manpages/pi.xsl file
6509
6510   • Michael(tm) Smith: .cvsignore; pi.xsl
6511
6512     Added "dbman funcsynopsis-style" PI and incorporated it into the
6513     doc build.
6514
6515   • Michael(tm) Smith: refentry.xsl
6516
6517     Fixed regression that caused an unescaped dash to be output
6518     between refname and refpurpose content. Closes bug #1894244.
6519     Thanks to Daniel Leidert.
6520
6521   • Michael(tm) Smith: other.xsl
6522
6523     Fixed problem with dots being escaped in filenames of generated
6524     man files. Closes #1827195. Thanks to Daniel Leidert.
6525
6526   • Michael(tm) Smith: inline.xsl
6527
6528     Added support for processing structfield (was appearing in roff
6529     output surrounded by HTML <em> tags; fixed so that it gets roff
6530     ital markup). Closes bug #1858329.  Thanks to Sam Varshavchik.
6531
6532 Epub
6533
6534 The following changes have been made to the epub code since the 1.73.2 release.
6535
6536   • Keith Fahlgren: bin/spec/README; bin/spec/epub_realbook_spec.rb
6537
6538     'Realbook' spec now passes
6539
6540   • Keith Fahlgren: bin/dbtoepub; README; bin/spec/README; bin/lib/docbook.rb;
6541     bin/spec/epub_r⋯
6542
6543     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)
6544
6545   • Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/
6546     docbook.rb; bin/s⋯
6547
6548     Changes to OPF spine to not duplicate idrefs for documents with parts not at the root; regression specs for same
6549
6550   • Keith Fahlgren: docbook.xsl
6551
6552     Fixing linking to cover @id, distinct from other needs of cover-image-id (again, thanks to Martin Goerner)
6553
6554   • Keith Fahlgren: docbook.xsl
6555
6556     Updating the title of the toc element in the guide to be more explicit (thanks to Martin Goerner)
6557
6558   • Keith Fahlgren: bin/spec/examples/amasque_exploded/content.opf; bin/spec/
6559     examples/amasque_⋯
6560
6561     Initial checkin/merge of epub target from work provided by Paul Norton of Adobe
6562     and Keith Fahlgren of O'Reilly.
6563
6564   • Keith Fahlgren: docbook.xsl
6565
6566     == General epub test support
6567
6568     $ spec -O ~/.spec.opts spec/epub_spec.rb
6569
6570     DocBook::Epub
6571     - should be able to be created
6572     - should fail on a nonexistent file
6573     - should be able to render to a file
6574     - should create a file after rendering
6575     - should have the correct mimetype after rendering
6576     - should be valid .epub after rendering an article
6577     - should be valid .epub after rendering an article without sections
6578     - should be valid .epub after rendering a book
6579     - should be valid .epub after rendering a book even if it has one graphic
6580     - should be valid .epub after rendering a book even if it has many graphics
6581     - should be valid .epub after rendering a book even if it has many duplicated graphics
6582     - should report an empty file as invalid
6583     - should confirm that a valid .epub file is valid
6584     - should not include PDFs in rendered epub files as valid image inclusions
6585     - should include a TOC link in rendered epub files for <book>s
6586
6587     Finished in 20.608395 seconds
6588
6589     15 examples, 0 failures
6590
6591
6592     == Verbose epub test coverage against _all_ of the testdocs
6593
6594     Fails on only (errors truncated):
6595     1)
6596     '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
6597     '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
6598     ....
6599
6600     Finished in 629.89194 seconds
6601
6602     224 examples, 15 failures
6603
6604     224 examples, 15 failures yields 6% failure rate
6605
6606 HTMLHelp
6607
6608 The following changes have been made to the htmlhelp code since the 1.73.2
6609 release.
6610
6611   • Mauritz Jeanson: htmlhelp-common.xsl
6612
6613     Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
6614     the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
6615     This makes chunk.quietly=1 suppress chunk filename messages also for help
6616     support files (which seems to be what one would expect). See bug #1648360.
6617
6618 Eclipse
6619
6620 The following changes have been made to the eclipse code since the 1.73.2
6621 release.
6622
6623   • David Cramer: eclipse.xsl
6624
6625     Use sortas attributes (if they exist) when sorting indexterms
6626
6627   • David Cramer: eclipse.xsl
6628
6629     Added support for indexterm/see in eclipse index.xml
6630
6631   • Mauritz Jeanson: eclipse.xsl
6632
6633     Added <xsl:with-param name="quiet" select="$chunk.quietly"/>
6634     to helpidx template.
6635
6636   • David Cramer: eclipse.xsl
6637
6638     Generate index.xml file and add related goo to plugin.xml file. Does not yet support see and seealso.
6639
6640   • Mauritz Jeanson: eclipse.xsl
6641
6642     Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
6643     the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
6644     This makes chunk.quietly=1 suppress chunk filename messages also for help
6645     support files (which seems to be what one would expect). See bug #1648360.
6646
6647 JavaHelp
6648
6649 The following changes have been made to the javahelp code since the 1.73.2
6650 release.
6651
6652   • Mauritz Jeanson: javahelp.xsl
6653
6654     Added <xsl:with-param name="quiet" select="$chunk.quietly"/> to calls to
6655     the write.chunk, write.chunk.with.doctype, and write.text.chunk templates.
6656     This makes chunk.quietly=1 suppress chunk filename messages also for help
6657     support files (which seems to be what one would expect). See bug #1648360.
6658
6659 Roundtrip
6660
6661 The following changes have been made to the roundtrip code since the 1.73.2
6662 release.
6663
6664   • Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl
6665
6666     fix table/cell borders for wordml, fix formal figure, add emphasis-strong
6667
6668   • Mauritz Jeanson: supported.xml
6669
6670     Changed @cols to 5.
6671
6672   • Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml
6673
6674     added pubdate, fixed metadata handling in biblioentry
6675
6676   • Steve Ball: supported.xml
6677
6678     Added support for edition.
6679
6680   • Steve Ball: docbook-pages.xsl; wordml-blocks.xsl; docbook.xsl; wordml.xsl;
6681     pages-normalise⋯
6682
6683     Removed stylesheets for old, deprecated conversion method.
6684
6685   • Steve Ball: specifications.xml; dbk2ooo.xsl; blocks2dbk.xsl; dbk2pages.xsl;
6686     blocks2dbk.dtd⋯
6687
6688     Added support for Open Office, added edition element, improved list and table support in Word and Pages
6689
6690   • Steve Ball: normalise-common.xsl; blocks2dbk.xsl; dbk2pages.xsl;
6691     template-pages.xml; templ⋯
6692
6693     Fixed bug in WordML table handling, improved table handling for Pages 08, synchronised WordML and Pages templates.
6694
6695   • Steve Ball: normalise-common.xsl; blocks2dbk.xsl; wordml2normalise.xsl;
6696     dbk2wp.xsl
6697
6698     fix caption, attributes
6699
6700   • Steve Ball: specifications.xml; blocks2dbk.xsl; wordml2normalise.xsl;
6701     blocks2dbk.dtd; temp⋯
6702
6703     Fixes to table and list handling
6704
6705   • Steve Ball: blocks2dbk.xsl
6706
6707     added support for explicit emphasis character styles
6708
6709   • Steve Ball: wordml2normalise.xsl
6710
6711     added support for customisation in image handling
6712
6713   • Steve Ball: blocks2dbk.xsl
6714
6715     Added inlinemediaobject support for metadata.
6716
6717   • Steve Ball: normalise-common.xsl; blocks2dbk.xsl; template.xml;
6718     dbk2wordml.xsl; dbk2wp.xsl
6719
6720     Added support file. Added style locking. Conversion bug fixes.
6721
6722 Slides
6723
6724 The following changes have been made to the slides code since the 1.73.2
6725 release.
6726
6727   • Michael(tm) Smith: fo/Makefile; html/Makefile
6728
6729     Added checks and hacks to various makefiles to enable building
6730     under Cygwin. This stuff is ugly and maybe not worth the mess and
6731     trouble, but does seem to work as expected and not break anything
6732     else.
6733
6734   • Jirka Kosek: html/plain.xsl
6735
6736     Added support for showing foil number
6737
6738 Website
6739
6740 The following changes have been made to the website code since the 1.73.2
6741 release.
6742
6743   • Michael(tm) Smith: extensions/saxon64/.classes/.gitignore; extensions/
6744     xalan2/.classes/com/⋯
6745
6746     renamed a bunch more .cvsignore files to .gitignore (to facilitate use of git-svn)
6747
6748 Params
6749
6750 The following changes have been made to the params code since the 1.73.2
6751 release.
6752
6753   • Keith Fahlgren: epub.autolabel.xml
6754
6755     New parameter for epub, epub.autolabel
6756
6757   • Mauritz Jeanson: table.frame.border.color.xml; table.cell.padding.xml;
6758     table.cell.border.t⋯
6759
6760     Added missing refpurposes and descriptions.
6761
6762   • Keith Fahlgren: ade.extensions.xml
6763
6764     Extensions to support Adobe Digital Editions extensions in .epub output.
6765
6766   • Mauritz Jeanson: fop.extensions.xml; fop1.extensions.xml
6767
6768     Clarified that fop1.extensions is for FOP 0.90 and later. Version 1 is not here yet...
6769
6770   • Michael(tm) Smith: man.links.are.underlined.xml;
6771     man.endnotes.list.enabled.xml; man.font.l⋯
6772
6773     removed man.links.are.underlined and added man.font.links. Also,
6774     changed the default font formatting for links to bold.
6775
6776   • Michael(tm) Smith: man.base.url.for.relative.links.xml
6777
6778     Added new param man.base.url.for.relative.links .. specifies a
6779     base URL for relative links (for ulink, @xlink:href, imagedata,
6780     audiodata, videodata) shown in the generated NOTES section of
6781     man-page output. The value of man.base.url.for.relative.links is
6782     prepended to any relative URI that is a value of ulink url,
6783     xlink:href, or fileref attribute.
6784
6785     If you use relative URIs in link sources in your DocBook refentry
6786     source, and you leave man.base.url.for.relative.links unset, the
6787     relative links will appear "as is" in the NOTES section of any
6788     man-page output generated from your source. That's probably not
6789     what you want, because such relative links are only usable in the
6790     context of HTML output. So, to make the links meaningful and
6791     usable in the context of man-page output, set a value for
6792     man.base.url.for.relative.links that points
6793     to the online version of HTML output generated from your DocBook
6794     refentry source. For example:
6795
6796       <xsl:param name="man.base.url.for.relative.links"
6797       >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param>
6798
6799   • Michael(tm) Smith: man.string.subst.map.xml
6800
6801     squeeze .sp\n.sp into a single .sp (to prevent a extra, spurious
6802     line of whitespace from being inserted after programlisting etc.
6803     in certain cases)
6804
6805   • Michael(tm) Smith: refentry.manual.fallback.profile.xml;
6806     refentry.source.fallback.profile.⋯
6807
6808     don't use refmiscinfo@class=date value as fallback for refentry
6809     "source" or "manual" metadata fields
6810
6811   • Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml;
6812     man.charmap.su⋯
6813
6814     made some further doc tweaks related to the
6815     man.charmap.subset.profile.english param
6816
6817   • Michael(tm) Smith: man.charmap.subset.profile.xml; man.charmap.enabled.xml;
6818     man.charmap.su⋯
6819
6820     Added the man.charmap.subset.profile.english parameter and refined
6821     the handling of charmap subsets to differentiate between English
6822     and non-English source.
6823
6824     This way charmap subsets are now handled is this:
6825
6826     If the value of the man.charmap.use.subset parameter is non-zero,
6827     and your DocBook source is not written in English (that is, if its
6828     lang or xml:lang attribute has a value other than en), then the
6829     character-map subset specified by the man.charmap.subset.profile
6830     parameter is used instead of the full roff character map.
6831
6832     Otherwise, if the lang or xml:lang attribute on the root element
6833     in your DocBook source or on the first refentry element in your
6834     source has the value en or if it has no lang or xml:lang
6835     attribute, then the character-map subset specified by the
6836     man.charmap.subset.profile.english parameter is used instead of
6837     man.charmap.subset.profile.
6838
6839     The difference between the two subsets is that
6840     man.charmap.subset.profile provides mappings for characters in
6841     Western European languages that are not part of the Roman
6842     (English) alphabet (ASCII character set).
6843
6844   • Michael(tm) Smith: man.charmap.subset.profile.xml
6845
6846     Added to default charmap used by manpages:
6847
6848       - the "letters" part of the 'C1 Controls And Latin-1 Supplement
6849         (Latin-1 Supplement)' Unicode block
6850       - Latin Extended-A block (but not all of the characters from
6851         that block have mappings in groff, so some of them are still
6852         passed through as-is)
6853
6854     The effects of this change are that in man pages generated for
6855     most Western European languages and for Finnish, all characters
6856     not part of the Roman alphabet are (e.g., "accented" characters)
6857     are converted to groff escapes.
6858
6859     Previously, by default we passed through those characters as is
6860     (and users needed to use the full charmap if they wanted to have
6861     those characters converted).
6862
6863     As a result of this change, man pages generated for Western
6864     European languages will be viewable in some environments in which
6865     they are not viewable if the "raw" non-Roman characters are in them.
6866
6867   • Mauritz Jeanson: generate.legalnotice.link.xml;
6868     generate.revhistory.link.xml
6869
6870     Added information on how the filename is computed.
6871
6872   • Mauritz Jeanson: default.table.width.xml
6873
6874     Clarified PI usage.
6875
6876   • Michael(tm) Smith: man.funcsynopsis.style.xml
6877
6878     Added the man.funcsynopsis.style parameter. Has the same effect in
6879     manpages output as the funcsynopsis.style parameter has in HTML
6880     output -- except that its default value is 'ansi' instead of 'kr'.
6881
6882   • Michael(tm) Smith: funcsynopsis.tabular.threshold.xml
6883
6884     Removed the funcsynopsis.tabular.threshold param. It's no longer
6885     being used in the code and hasn't been since mid 2006.
6886
6887   • Mauritz Jeanson: table.properties.xml
6888
6889     Set keep-together.within-column to "auto". This seems to be the most sensible
6890     default value for tables.
6891
6892   • Mauritz Jeanson: informal.object.properties.xml;
6893     admon.graphics.extension.xml; informalequ⋯
6894
6895     Several small documentation fixes.
6896
6897   • Mauritz Jeanson: manifest.in.base.dir.xml
6898
6899     Wording fixes.
6900
6901   • Mauritz Jeanson: header.content.properties.xml;
6902     footer.content.properties.xml
6903
6904     Added refpurpose.
6905
6906   • Mauritz Jeanson: ulink.footnotes.xml; ulink.show.xml
6907
6908     Updated for DocBook 5.
6909
6910   • Mauritz Jeanson: index.method.xml; glossterm.auto.link.xml
6911
6912     Spelling and wording fixes.
6913
6914   • Mauritz Jeanson: callout.graphics.extension.xml
6915
6916     Clarifed available graphics formats and extensions.
6917
6918   • Mauritz Jeanson: footnote.sep.leader.properties.xml
6919
6920     Corrected refpurpose.
6921
6922   • Jirka Kosek: footnote.properties.xml
6923
6924     Added more properties which make it possible to render correctly footnotes placed inside verbatim elements.
6925
6926   • Mauritz Jeanson: img.src.path.xml
6927
6928     img.src.path works with inlinegraphic too.
6929
6930   • Mauritz Jeanson: saxon.character.representation.xml
6931
6932     Added TCG link.
6933
6934   • Mauritz Jeanson: img.src.path.xml
6935
6936     Updated description of img.src.path. Bug #1785224 revealed that
6937     there was a risk of misunderstanding how it works.
6938
6939 Profiling
6940
6941 The following changes have been made to the profiling code since the 1.73.2
6942 release.
6943
6944   • Jirka Kosek: xsl2profile.xsl
6945
6946     Added new rules to profile all content generated by HTML Help (including alias files)
6947
6948   • Robert Stayton: profile-mode.xsl
6949
6950     use mode="profile" instead of xsl:copy-of for attributes so
6951     they can be more easily customized.
6952
6953 Tools
6954
6955 The following changes have been made to the tools code since the 1.73.2
6956 release.
6957
6958   • Michael(tm) Smith: make/Makefile.DocBook
6959
6960     various changes and additions to support making with asciidoc as
6961     an input format
6962
6963   • Michael(tm) Smith: make/Makefile.DocBook
6964
6965     make dblatex the default PDF maker for the example makefile
6966
6967   • Michael(tm) Smith: xsl/build/html2roff.xsl
6968
6969     Reworked handling of K&R funcprototype output. It no longer relies
6970     on the HTML kr-tabular templates, but instead just does direct
6971     transformation to roff. For K&R output, it displays the paramdef
6972     output in an indented list following the prototype.
6973
6974   • Mauritz Jeanson: xsl/build/make-xsl-params.xsl
6975
6976     Made attribute-sets members of the param list. This enables links to attribute-sets in the
6977     reference documentation.
6978
6979   • Michael(tm) Smith: xsl/build/html2roff.xsl
6980
6981     use .BI handling in K&R funsynopsis output for manpages, just as
6982     we do already of ANSI output
6983
6984   • Michael(tm) Smith: xsl/build/html2roff.xsl
6985
6986     Implemented initial support for handling tabular K&R output of
6987     funcprototype in manpages output. Accomplished by adding more
6988     templates to the intermediate HTML-to-roff stylesheet that the
6989     build uses to create the manpages/html-synop.xsl stylesheet.
6990
6991   • Michael(tm) Smith: xsl/build/doc-link-docbook.xsl
6992
6993     Made the xsl/tools/xsl/build/doc-link-docbook.xsl stylesheet
6994     import profile-docbook.xsl, so that we can do profiling of release
6995     notes. Corrected some problems in the target for the release-notes
6996     HTML build.
6997
6998 Extensions
6999
7000 The following changes have been made to the extensions code since the 1.73.2
7001 release.
7002
7003   • Keith Fahlgren: Makefile
7004
7005     Use DOCBOOK_SVN variable everywhere, please; build with PDF_MAKER
7006
7007   • Michael(tm) Smith: Makefile
7008
7009     moved extensions build targets from master xsl/Makefile to
7010     xsl/extensions/Makefile
7011
7012   • Michael(tm) Smith: .cvsignore
7013
7014     re-adding empty extensions subdir
7015
7016 XSL-Saxon
7017
7018 The following changes have been made to the xsl-saxon code since the 1.73.2
7019 release.
7020
7021   • Michael(tm) Smith: VERSION
7022
7023     bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
7024     recent change to snapshot build infrastructure
7025
7026   • Michael(tm) Smith: nbproject/build-impl.xml; nbproject/project.properties
7027
7028     Changed hard-coded file references in "clean" target to variable
7029     references. Closes #1792043. Thanks to Daniel Leidert.
7030
7031   • Michael(tm) Smith: VERSION; Makefile
7032
7033     Did post-release wrap-up of xsl-saxon and xsl-xalan dirs
7034
7035   • Michael(tm) Smith: nbproject/build-impl.xml; VERSION; Makefile; test
7036
7037     More tweaks to get release-ready
7038
7039 XSL-Xalan
7040
7041 The following changes have been made to the xsl-xalan code since the 1.73.2
7042 release.
7043
7044   • Michael(tm) Smith: VERSION
7045
7046     bring xsl2, xsl-saxon, and xsl-xalan VERSION files up-to-date with
7047     recent change to snapshot build infrastructure
7048
7049   • Michael(tm) Smith: nbproject/build-impl.xml
7050
7051     Changed hard-coded file references in "clean" target to variable
7052     references. Closes #1792043. Thanks to Daniel Leidert.
7053
7054   • Michael(tm) Smith: Makefile; VERSION
7055
7056     Did post-release wrap-up of xsl-saxon and xsl-xalan dirs
7057
7058   • Michael(tm) Smith: Makefile; nbproject/build-impl.xml; VERSION
7059
7060     More tweaks to get release-ready
7061
7062 XSL-libxslt
7063
7064 The following changes have been made to the xsl-libxslt code since the 1.73.2
7065 release.
7066
7067   • Mauritz Jeanson: python/xslt.py
7068
7069     Print the result to stdout if no outfile has been given.
7070     Some unnecessary semicolons removed.
7071
7072   • Mauritz Jeanson: python/xslt.py
7073
7074     Added a function that quotes parameter values (to ensure that they are interpreted as strings).
7075     Replaced deprecated functions from the string module with string methods.
7076
7077   • Michael(tm) Smith: python/README; python/README.LIBXSLT
7078
7079     renamed xsl-libxslt/python/README to xsl-libxslt/python/README.LIBXSLT
7080
7081   • Mauritz Jeanson: python/README
7082
7083     Tweaked the text a little.
7084
7085 Release Notes: 1.73.2
7086
7087 This is solely a minor bug-fix update to the 1.73.1 release. It fixes a
7088 packaging error in the 1.73.1 package, as well as a bug in footnote handling in
7089 FO output.
7090
7091 Release: 1.73.1
7092
7093 This is mostly a bug-fix update to the 1.73.0 release.
7094
7095 Gentext
7096
7097 The following changes have been made to the gentext code since the 1.73.0
7098 release.
7099
7100   • Mauritz Jeanson: locale/de.xml
7101
7102     Applied patch #1766009.
7103
7104   • Michael(tm) Smith: locale/lv.xml
7105
7106     Added localization for ProductionSet.
7107
7108 FO
7109
7110 The following changes have been made to the fo code since the 1.73.0 release.
7111
7112   • Mauritz Jeanson: table.xsl
7113
7114     Modified the tgroup template so that, for tables with multiple tgroups,
7115     a width attribute is output on all corresponding fo:tables. Previously,
7116     there was a test prohibiting this (and a comment saying that outputting more
7117     than one width attribute will cause an error). But this seems to be no longer
7118     relevant; it is not a problem with FOP 0.93 or XEP 4.10. Closes bug #1760559.
7119
7120   • Mauritz Jeanson: graphics.xsl
7121
7122     Replaced useless <a> elements with warning messages (textinsert extension).
7123
7124   • Mauritz Jeanson: admon.xsl
7125
7126     Enabled generation of ids (on fo:wrapper) for indexterms in admonition titles, so that page
7127     references in the index can be created. Closes bug #1775086.
7128
7129 HTML
7130
7131 The following changes have been made to the html code since the 1.73.0 release.
7132
7133   • Mauritz Jeanson: titlepage.xsl
7134
7135     Added <xsl:call-template name="process.footnotes"/> to abstract template
7136     so that footnotes in info/abstract are processed. Closes bug #1760907.
7137
7138   • Michael(tm) Smith: pi.xsl; synop.xsl
7139
7140     Changed handling of HTML output for the cmdsynopsis and
7141     funcsynopsis elements, such that a@id instances are generated for
7142     them if they are descendants of any element containing a dbcmdlist
7143     or dbfunclist PI. Also, update the embedded reference docs for the
7144     dbcmdlist and dbfunclist PIs to make it clear that they can be
7145     used within any element for which cmdsynopsis or funcsynopsis are
7146     valid children.
7147
7148   • Michael(tm) Smith: formal.xsl
7149
7150     Reverted the part of revision 6952 that caused a@id anchors to be
7151     generated for output of informal objects. Thanks to Sam Steingold
7152     for reporting.
7153
7154   • Robert Stayton: glossary.xsl
7155
7156     Account for a glossary with no glossdiv or glossentry children.
7157
7158   • Mauritz Jeanson: titlepage.xsl
7159
7160     Modified legalnotice template so that the base.name parameter is calculated
7161     in the same way as for revhistory chunks. Using <xsl:apply-templates
7162     mode="chunk-filename" select="."/> did not work for single-page output since
7163     the template with that mode is in chunk-code.xsl.
7164
7165   • Mauritz Jeanson: graphics.xsl
7166
7167     Updated support for SVG (must be a child of imagedata in DB 5).
7168     Added support for MathML in imagedata.
7169
7170   • Mauritz Jeanson: pi.xsl
7171
7172     Added documentation for the dbhh PI (used for context-sensitive HTML Help).
7173     (The two templates matching 'dbhh' are still in htmlhelp-common.xsl).
7174
7175 Manpages
7176
7177 The following changes have been made to the manpages code since the 1.73.0
7178 release.
7179
7180   • Michael(tm) Smith: endnotes.xsl
7181
7182     In manpages output, generate warnings about notesources with
7183     non-para children only if the notesource is a footnote or
7184     annotation. Thanks to Sam Steingold for reporting problems with
7185     the existing handling.
7186
7187 HTMLHelp
7188
7189 The following changes have been made to the htmlhelp code since the 1.73.0
7190 release.
7191
7192   • Michael(tm) Smith: htmlhelp-common.xsl
7193
7194     Added single-pass namespace-stripping support to the htmlhelp,
7195     eclipse, and javahelp stylesheets.
7196
7197 Eclipse
7198
7199 The following changes have been made to the eclipse code since the 1.73.0
7200 release.
7201
7202   • Michael(tm) Smith: eclipse.xsl
7203
7204     Added single-pass namespace-stripping support to the htmlhelp,
7205     eclipse, and javahelp stylesheets.
7206
7207 JavaHelp
7208
7209 The following changes have been made to the javahelp code since the 1.73.0
7210 release.
7211
7212   • Michael(tm) Smith: javahelp.xsl
7213
7214     Added single-pass namespace-stripping support to the htmlhelp,
7215     eclipse, and javahelp stylesheets.
7216
7217 Roundtrip
7218
7219 The following changes have been made to the roundtrip code since the 1.73.0
7220 release.
7221
7222   • Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; pages2normalise.xsl
7223
7224     Modularised blocks2dbk to allow customisation,
7225     Added support for tables to pages2normalise
7226
7227 Params
7228
7229 The following changes have been made to the params code since the 1.73.0
7230 release.
7231
7232   • Robert Stayton: procedure.properties.xml
7233
7234     procedure was inheriting keep-together from formal.object.properties, but
7235     a procedure does not need to be kept together by default.
7236
7237   • Dave Pawson: title.font.family.xml;
7238     component.label.includes.part.label.xml; table.frame.b⋯
7239
7240     Regular formatting re-org.
7241
7242 Release: 1.73.0
7243
7244 This release includes important bug fixes and adds the following significant
7245 feature changes:
7246
7247 New localizations and localization updates
7248
7249     We added two new localizations: Latvian and Esperanto, and made updates to
7250     the Czech, Chinese Simplified, Mongolian, Serbian, Italian, and Ukrainian
7251     localizations.
7252
7253 ISO690 citation style for bibliography output.
7254
7255     Set the bibliography.style parameter to iso690 to use ISO690 style.
7256
7257 New documentation for processing instructions (PI)
7258
7259     The reference documentation that ships with the release now includes
7260     documentation on all PIs that you can use to control output from the
7261     stylesheets.
7262
7263 New profiling parameters for audience and wordsize
7264
7265     You can now do profiling based on the values of the audience and wordsize
7266     attributes.
7267
7268 Changes to man-page output
7269
7270     The manpages stylesheet now supports single-pass profiling and single-pass
7271     DocBook 5 namespace stripping (just as the HTML and FO stylesheets also
7272     do). Also, added handling for mediaobject & inlinemediaobject. (Each
7273     imagedata, audiodata, or videodata element within a mediaobject or inline
7274     mediaobject is now treated as a "notesource" and so handled in much the
7275     same way as links and annotation/alt/footnote are in manpages output.) And
7276     added the man.authors.section.enabled and man.copyright.section.enabled
7277     parameters to enable control over whether output includes auto-generated
7278     AUTHORS and COPYRIGHT sections.
7279
7280 Highlighting support for C
7281
7282     The highlighting mechanism for generating syntax-highlighted code snippets
7283     in output now supports C code listings (along with Java, PHP, XSLT, and
7284     others).
7285
7286 Experimental docbook-xsl-update script
7287
7288     We added an experimental docbook-xsl-update script, the purpose of which is
7289     to facilitate easy sync-up to the latest docbook-xsl snapshot (by means of
7290     rsync).
7291
7292 Gentext
7293
7294 The following changes have been made to the gentext code since the 1.72.0
7295 release.
7296
7297   • Michael(tm) Smith: locale/lv.xml; Makefile
7298
7299     Added Latvian localization file, from Girts Ziemelis.
7300
7301   • Dongsheng Song: locale/zh_cn.xml
7302
7303     Brought up to date with en.xml in terms of items. A few strings marked for translation.
7304
7305   • Jirka Kosek: locale/cs.xml
7306
7307     Added missing translations
7308
7309   • Robert Stayton: locale/eo.xml
7310
7311     New locale for Esperanto.
7312
7313   • Robert Stayton: locale/mn.xml
7314
7315     Update from Ganbold Tsagaankhuu.
7316
7317   • Jirka Kosek: locale/en.xml; locale/cs.xml
7318
7319     Rules for normalizing glossary entries before they are sorted can be now different for each language.
7320
7321   • Michael(tm) Smith: locale/sr_Latn.xml; locale/sr.xml
7322
7323     Committed changes from Miloš Komarčević to Serbian files.
7324
7325   • Robert Stayton: locale/ja.xml
7326
7327     Fix chapter in context xref-number-and-title
7328
7329   • Robert Stayton: locale/it.xml
7330
7331     Improved version from contributor.
7332
7333   • Mauritz Jeanson: locale/uk.xml
7334
7335     Applied patch 1592083.
7336
7337 Common
7338
7339 The following changes have been made to the common code since the 1.72.0
7340 release.
7341
7342   • Michael(tm) Smith: labels.xsl
7343
7344     Changed handling of reference auto-labeling such that reference
7345     (when it appears at the component level) is now affected by the
7346     label.from.part param, just as preface, chapter, and appendix.
7347
7348   • Michael(tm) Smith: common.xsl
7349
7350     Added support to the HTML stylesheets for proper processing of
7351     orgname as a child of author.
7352
7353   • Michael(tm) Smith: refentry.xsl
7354
7355     Refined logging output of refentry metadata-gathering template;
7356     for some cases of "missing" elements (refmiscinfo stuff, etc.),
7357     the log messages now include URL to corresponding page in the
7358     Definitive Guide (TDG).
7359
7360   • Robert Stayton: titles.xsl
7361
7362     Add refsection/info/title support.
7363
7364   • Michael(tm) Smith: titles.xsl
7365
7366     Added support for correct handling of xref to elements that
7367     contain info/title descendants but no title children.
7368
7369     This should be further refined so that it handles any *info
7370     elements. And there are probably some other places where similar
7371     handling for *info/title should be added.
7372
7373   • Mauritz Jeanson: pi.xsl
7374
7375     Modified <xsl:when> in datetime.format template to work
7376     around Xalan bug.
7377
7378 FO
7379
7380 The following changes have been made to the fo code since the 1.72.0 release.
7381
7382   • Robert Stayton: component.xsl
7383
7384     Add parameters to the page.sequence utility template.
7385
7386   • Mauritz Jeanson: xref.xsl
7387
7388     Added template for xref to area/areaset.
7389     Part of fix for bug #1675513 (xref to area broken).
7390
7391   • Michael(tm) Smith: inline.xsl
7392
7393     Added template match for person element to fo stylesheet.
7394
7395   • Robert Stayton: lists.xsl
7396
7397     Added support for spacing="compact" in variablelist, per bug report #1722540.
7398
7399   • Robert Stayton: table.xsl
7400
7401     table pgwide="1" should also use pgwide.properties attribute-set.
7402
7403   • Mauritz Jeanson: inline.xsl
7404
7405     Make citations numbered if bibliography.numbered != 0.
7406
7407   • Robert Stayton: param.xweb; param.ent
7408
7409     Add new profiling parameters for audience and wordsize.
7410
7411   • Robert Stayton: param.xweb; param.ent
7412
7413     Added callout.icon.size parameter.
7414
7415   • Robert Stayton: inline.xsl; xref.xsl
7416
7417     Add support for xlink as olink.
7418
7419   • Robert Stayton: autotoc.xsl; param.xweb; param.ent
7420
7421     Add support for qanda.in.toc to fo TOC.
7422
7423   • Robert Stayton: component.xsl
7424
7425     Improved the page.sequence utility template for use with book.
7426
7427   • Robert Stayton: division.xsl
7428
7429     Refactored the big book template into smaller pieces.
7430     Used the "page.sequence" utility template in
7431     component.xsl to shorten the toc piece.
7432     Added placeholder templates for front.cover and back.cover.
7433
7434   • Robert Stayton: param.xweb; param.ent; sections.xsl
7435
7436     Add section.container.element parameter to enable
7437     pgwide spans inside sections.
7438
7439   • Robert Stayton: param.xweb; param.ent; component.xsl
7440
7441     Add component.titlepage.properties attribute-set to
7442     support span="all" and other properties.
7443
7444   • Robert Stayton: htmltbl.xsl; table.xsl
7445
7446     Apply table.row.properties template to html tr rows too.
7447     Add keep-with-next to table.row.properties when row is in thead.
7448
7449   • Robert Stayton: table.xsl
7450
7451     Add support for default.table.frame parameter.
7452     Fix bug 1575446 rowsep last check for @morerows.
7453
7454   • Robert Stayton: refentry.xsl
7455
7456     Add support for info/title in refsections.
7457
7458   • David Cramer: qandaset.xsl
7459
7460     Make fo questions and answers behave the same way as html
7461
7462   • Jirka Kosek: lists.xsl
7463
7464     Added missing attribute set for procedure
7465
7466   • Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent;
7467     biblio-iso690.xsl
7468
7469     Added support for formatting biblioentries according to ISO690 citation style.
7470     New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
7471     The code was provided by Jana Dvorakova
7472
7473   • Robert Stayton: param.xweb; param.ent; pagesetup.xsl
7474
7475     Add header.table.properties and footer.table.properties attribute-sets.
7476
7477   • Robert Stayton: inline.xsl
7478
7479     Add fop1.extensions for menuchoice arrow handling exception.
7480
7481 HTML
7482
7483 The following changes have been made to the html code since the 1.72.0 release.
7484
7485   • Mauritz Jeanson: param.xweb; param.ent
7486
7487     Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the
7488     regular "parameter machinery".
7489
7490   • Michael(tm) Smith: admon.xsl
7491
7492     Changed handling of titles for note, warning, caution, important,
7493     tip admonitions: We now output and HTML h3 head only if
7494     admon.textlabel is non-zero or if the admonition actually contains
7495     a title; otherwise, we don't output an h3 head at all.
7496     (Previously, we were outputting an empty h3 if the admon.textlabel
7497     was zero and if the admonition had no title.)
7498
7499   • Mauritz Jeanson: xref.xsl
7500
7501     Added template for xref to area/areaset.
7502     Part of fix for bug #1675513 (xref to area broken).
7503
7504   • Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; sections.xsl
7505
7506     Added fixes to avoid duplicate ids when generate.id.attributes = 1.
7507     This (hopefully) closes bug #1671052.
7508
7509   • Michael(tm) Smith: formal.xsl; pi.xsl
7510
7511     Made the dbfunclist PI work as intended. Also added doc for
7512     dbfunclist and dbcmdlist PIs.
7513
7514   • Michael(tm) Smith: pi.xsl; synop.xsl
7515
7516     Made the dbcmdlist work the way it appears to have been intended
7517     to work. Restored dbhtml-dir template back to pi.xsl.
7518
7519   • Michael(tm) Smith: titlepage.xsl; param.xweb; param.ent
7520
7521     Added new param abstract.notitle.enabled.
7522     If non-zero, in output of the abstract element on titlepages,
7523     display of the abstract title is suppressed.
7524     Because sometimes you really don't want or need that title
7525     there...
7526
7527   • Michael(tm) Smith: chunk-code.xsl; graphics.xsl
7528
7529     When we are chunking long descriptions for mediaobject instances
7530     into separate HTML output files, and use.id.as.filename is
7531     non-zero, if a mediaobject has an ID, use that ID as the basename
7532     for the long-description file (otherwise, we generate an ID for it
7533     and use that ID as the basename for the file).
7534     The parallels the recent change made to cause IDs for legalnotice
7535     instances to be used as basenames for legalnotice chunks.
7536     Also, made some minor refinements to the recent changes for
7537     legalnotice chunk handling.
7538
7539   • Michael(tm) Smith: titlepage.xsl
7540
7541     Added support to the HTML stylesheets for proper processing of
7542     orgname as a child of author.
7543
7544   • Michael(tm) Smith: chunk-code.xsl
7545
7546     When $generate.legalnotice.link is non-zero and
7547     $use.id.as.filename is also non-zero, if a legalnotice has an ID,
7548     then instead of assigning the "ln-<generatedID>" basename to the
7549     output file for that legalnotice, just use its real ID as the
7550     basename for the file -- as we do when chunking other elements
7551     that have IDs.
7552
7553   • David Cramer: xref.xsl
7554
7555     Handle alt text on xrefs to steps when the step doesn't have a title.
7556
7557   • David Cramer: lists.xsl
7558
7559     Added <p> element around term in variablelist when formatted as table to avoid misalignment of term and listitem in xhtml (non-quirks mode) output
7560
7561   • David Cramer: qandaset.xsl
7562
7563     Added <p> element around question and answer labels to avoid misalignment of label and listitem in xhtml (non-quirks mode) output
7564
7565   • David Cramer: lists.xsl
7566
7567     Added <p> element around callouts to avoid misalignment of callout and listitem in xhtml (non-quirks mode) output
7568
7569   • Mauritz Jeanson: inline.xsl
7570
7571     Make citations numbered if bibliography.numbered != 0.
7572
7573   • Robert Stayton: param.xweb; param.ent
7574
7575     Add support for new profiling attributes audience and wordsize.
7576
7577   • Robert Stayton: inline.xsl; xref.xsl
7578
7579     Add support for xlink olinks.
7580
7581   • Jirka Kosek: glossary.xsl
7582
7583     Rules for normalizing glossary entries before they are sorted can be now different for each language.
7584
7585   • Robert Stayton: chunk-common.xsl; chunk-code.xsl; manifest.xsl; chunk.xsl
7586
7587     Refactored the chunking modules to move all named templates to
7588     chunk-common.xsl and all match templates to chunk-code.xsl, in
7589     order to enable better chunk customization.
7590     See the comments in chunk.xsl for more details.
7591
7592   • Robert Stayton: lists.xsl
7593
7594     Add anchor for xml:id for listitem in varlistentry.
7595
7596   • Robert Stayton: refentry.xsl
7597
7598     Add support for info/title in refsections for db5.
7599
7600   • Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent;
7601     biblio-iso690.xsl
7602
7603     Added support for formatting biblioentries according to ISO690 citation style.
7604     New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
7605     The code was provided by Jana Dvorakova
7606
7607   • Robert Stayton: inline.xsl; xref.xsl
7608
7609     Add call to class.attribute to <a> output elements so they can
7610     have a class value too.
7611
7612   • Mauritz Jeanson: glossary.xsl
7613
7614     Fixed bug #1644881:
7615     * Added curly braces around all $language attribute values.
7616     * Moved declaration of language variable to top level of stylesheet.
7617     Tested with Xalan, Saxon, and xsltproc.
7618
7619 Manpages
7620
7621 The following changes have been made to the manpages code since the 1.72.0
7622 release.
7623
7624   • Michael(tm) Smith: param.xweb; docbook.xsl; param.ent
7625
7626     Added the man.authors.section.enabled and
7627     man.copyright.section.enabled parameters. Set those to zero when
7628     you want to suppress display of the auto-generated AUTHORS and
7629     COPYRIGHT sections. Closes request #1467806. Thanks to Daniel
7630     Leidert.
7631
7632   • Michael(tm) Smith: docbook.xsl
7633
7634     Took the test that the manpages stylesheet does to see if there
7635     are any Refentry chilren in current doc, and made it
7636     namespace-agnostic. Reason for that is because the test otherwise
7637     won't work when it is copied over into the generated
7638     profile-docbook.xsl stylesheet.
7639
7640   • Michael(tm) Smith: Makefile
7641
7642     Added a manpages/profile-docbook.xsl file to enable single-pass
7643     profiling for manpages output.
7644
7645   • Michael(tm) Smith: info.xsl
7646
7647     Output copyright and legalnotice in man-page output in whatever
7648     place they are in in document order. Closes #1690539. Thanks to
7649     Daniel Leidert for reporting.
7650
7651   • Michael(tm) Smith: docbook.xsl
7652
7653     Restored support for single-pass namespace stripping to manpages
7654     stylesheet.
7655
7656   • Michael(tm) Smith: synop.xsl; block.xsl; info.xsl; inline.xsl; lists.xsl;
7657     endnotes.xsl; ut⋯
7658
7659     Changed handling of bold and italic/underline output in manpages
7660     output. Should be transparent to users, but...
7661
7662     This touches handling of all bold and italic/underline output. The
7663     exact change is that the mode="bold" and mode="italic" utility
7664     templates were changed to named templates. (I think maybe I've
7665     changed it back and forth from mode to named before, so this is
7666     maybe re-reverting it yet again).
7667
7668     Anyway, the reason for the change is that the templates are
7669     sometimes call on dynamically node-sets, and using modes to format
7670     those doesn't allow passing info about the current/real context
7671     node from the source (not the node-set created by the stylesheet)
7672     to that formatting stage.
7673
7674     The named templates allow the context to be passed in as a
7675     parameter, so that the bold/ital formatting template can use
7676     context-aware condition checking.
7677
7678     This was basically necessary in order to suppress bold formatting
7679     in titles, which otherwise gets screwed up because of the numbnut
7680     way that roff handles nested bold/ital.
7681
7682     Closes #1674534). Much thanks to Daniel Leidert, whose in his
7683     docbook-xsl bug-finding kung-fu has achieved Grand Master status.
7684
7685   • Michael(tm) Smith: block.xsl
7686
7687     Fixed handling of example instances by adding the example element
7688     to the same template we use for processing figure. Closes
7689     #1674538. Thanks to Daniel Leidert.
7690
7691   • Michael(tm) Smith: utility.xsl
7692
7693     Don't include lang in manpages filename/pathname if lang=en (that
7694     is, only generate lang-qualified file-/pathnames for non-English).
7695
7696   • Michael(tm) Smith: endnotes.xsl
7697
7698     In manpages output, emit warnings for notesources (footnote, etc.)
7699     that have something other than para as a child.
7700
7701     The numbered-with-hanging-indent formatting that's used for
7702     rendering endnotes in the NOTES section of man pages places some
7703     limits/assumptions on how the DocBook source is marked up; namely,
7704     for notesources (footnote, annotation, etc.) that can contain
7705     block-level children, if the they have a block-level child such as
7706     a table or itemizedlist or orderedlist that is the first child of
7707     a footnote, we have no way of rendering/indenting its content
7708     properly in the endnotes list.
7709
7710     Thus, the manpages stylesheet not emits a warning message for that
7711     case, and suggests the "fix" (which is to wrap the table or
7712     itemizedlist or whatever in a para that has some preferatory text.
7713
7714   • Michael(tm) Smith: utility.xsl
7715
7716     Added support to mixed-block template for handling tables in
7717     mixed-blocks (e.g., as child of para) correctly.
7718
7719   • Michael(tm) Smith: table.xsl; synop.xsl; block.xsl; info.xsl; lists.xsl;
7720     refentry.xsl; end⋯
7721
7722     Reverted necessary escaping of backslash, dot, and dash
7723     out of the well-intentioned (but it now appears,
7724     misguided) "marker" mechanism (introduced in the 1.72.0
7725     release) -- which made use of alternative "marker"
7726     characters as internal representations of those
7727     characters, and then replaced them just prior to
7728     serialization -- and back into what's basically the
7729     system that was used prior to the 1.69.0 release; that
7730     is, into a part of stylesheet code that gets executed
7731     at the beginning of processing -- before any other roff
7732     markup up is. This change obviates the need for the
7733     marker system. It also requires a lot less RAM during
7734     processing (for large files, the marker mechanism
7735     ending up requiring gigabytes of memory).
7736
7737     Closes bug #1661177. Thanks to Scott Smedley for
7738     providing a test case (the fvwm man page) that exposed
7739     the problem with the marker mechanism.
7740
7741     Also moved the mechanism for converting non-breaking
7742     spaces back into the same area of the stylesheet code.
7743
7744   • Michael(tm) Smith: lists.xsl
7745
7746     Fixed problem with incorrect formatting of nested variablelist.
7747     Closes bug #1650931. Thanks to Daniel "Eagle Eye" Leidert.
7748
7749   • Michael(tm) Smith: lists.xsl
7750
7751     Make sure that all listitems in itemizedlist and orderedlist are
7752     preceded by a blank line. This fixes a regression that occurred
7753     when instances of the TP macro that were use in a previous
7754     versions of the list-handling code were switched to RS/RE (because
7755     TP doesn't support nesting). TP automatically generates a blank
7756     line, but RS doesn't. So I added a .sp before each .RS
7757
7758   • Michael(tm) Smith: block.xsl; inline.xsl; param.xweb; docbook.xsl;
7759     links.xsl; param.ent
7760
7761     Made a number of changes related to elements with
7762     out-of-line content:
7763
7764     - Added handling for mediaobject & inlinemediaobject.
7765       Each imagedata, audiodata, or videodata element
7766       within a mediaobject or inline mediaobject is now
7767       treated as a "notesource" and so handled in much the
7768       same way as links and annotation/alt/footnotes.
7769
7770       That means a numbered marker is generated inline to
7771       mark the place in the main flow where the imagedata,
7772       audiodata, or videodata element occurs, and a
7773       corresponding numbered endnote for it is generated in
7774       the endnotes list at the end of the man page; the
7775       endnote contains the URL from the fileref attribute
7776       of the imagedata, audiodata, or videodata element.
7777
7778       For mediobject and inlinemediaobject instances that
7779       have a textobject child, the textobject is displayed
7780       within the main text flow.
7781
7782     - Renamed several man.link.* params to man.endnotes.*,
7783       to reflect that fact that the endnotes list now
7784       contains more than just links. Also did similar
7785       renaming for a number of stylesheet-internal vars.
7786
7787     - Added support for xlink:href (along with existing
7788       support for the legacy ulink element).
7789
7790     - Cleaned up and streamlined the endnotes-handling
7791       code. It's still messy and klunky and the basic
7792       mechanism it uses is very inefficent for documents
7793       that contain a lot of notesources, but at least it's
7794       a bit better than it was.
7795
7796 Eclipse
7797
7798 The following changes have been made to the eclipse code since the 1.72.0
7799 release.
7800
7801   • Mauritz Jeanson: Makefile
7802
7803     Fixed bug #1715093: Makefile for creating profiled version of eclipse.xsl added.
7804
7805   • David Cramer: eclipse.xsl
7806
7807     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
7808
7809 JavaHelp
7810
7811 The following changes have been made to the javahelp code since the 1.72.0
7812 release.
7813
7814   • Mauritz Jeanson: javahelp.xsl
7815
7816     Implemented FR #1230233 (sorted index in javahelp).
7817
7818   • Mauritz Jeanson: javahelp.xsl
7819
7820     Added normalize-space() around titles and index entries to work around whitespace problems.
7821     Added support for glossary and bibliography in toc and map files.
7822
7823 Roundtrip
7824
7825 The following changes have been made to the roundtrip code since the 1.72.0
7826 release.
7827
7828   • Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl; normalise2sections.xsl;
7829     sections2blocks.⋯
7830
7831     new stylesheets for better word processor support and easier maintenance
7832
7833   • Steve Ball: template-pages.xml; dbk2wp.xsl; sections-spec.xml
7834
7835     fixed bugs
7836
7837 Params
7838
7839 The following changes have been made to the params code since the 1.72.0
7840 release.
7841
7842   • Mauritz Jeanson: htmlhelp.button.back.xml; htmlhelp.button.forward.xml;
7843     htmlhelp.button.zo⋯
7844
7845     Modified refpurpose text.
7846
7847   • Mauritz Jeanson: htmlhelp.map.file.xml; htmlhelp.force.map.and.alias.xml;
7848     htmlhelp.alias.f⋯
7849
7850     Fixed typos, made some small changes.
7851
7852   • Mauritz Jeanson: javahelp.encoding.xml
7853
7854     Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the
7855     regular "parameter machinery".
7856
7857   • Mauritz Jeanson: generate.id.attributes.xml
7858
7859     Added refpurpose text.
7860
7861   • Mauritz Jeanson: annotation.js.xml; annotation.graphic.open.xml;
7862     annotation.graphic.close.⋯
7863
7864     Added better refpurpose texts.
7865
7866   • Michael(tm) Smith: chunker.output.cdata-section-elements.xml;
7867     chunker.output.standalone.xm⋯
7868
7869     Fixed some broken formatting in source files for chunker.* params,
7870     as pointed out by Dave Pawson.
7871
7872   • Michael(tm) Smith: label.from.part.xml
7873
7874     Changed handling of reference auto-labeling such that reference
7875     (when it appears at the component level) is now affected by the
7876     label.from.part param, just as preface, chapter, and appendix.
7877
7878   • Mauritz Jeanson: callout.graphics.extension.xml
7879
7880     Clarified that 'extension' refers to file names.
7881
7882   • Michael(tm) Smith: abstract.notitle.enabled.xml
7883
7884     Added new param abstract.notitle.enabled.
7885     If non-zero, in output of the abstract element on titlepages,
7886     display of the abstract title is suppressed.
7887     Because sometimes you really don't want or need that title
7888     there...
7889
7890   • Michael(tm) Smith: man.string.subst.map.xml
7891
7892     Updated manpages string-substitute map to reflect fact that
7893     because of another recent change to suppress bold markup in .SH
7894     output, we no longer need to add a workaround for the accidental
7895     uppercasing of roff escapes that occurred previously.
7896
7897   • Jirka Kosek: margin.note.float.type.xml; title.font.family.xml;
7898     table.frame.border.color.x⋯
7899
7900     Improved parameter metadata
7901
7902   • Robert Stayton: profile.wordsize.xml; profile.audience.xml
7903
7904     Add support for profiling on new attributes audience and wordsize.
7905
7906   • Robert Stayton: callout.graphics.number.limit.xml;
7907     callout.graphics.extension.xml
7908
7909     Added SVG graphics for fo output.
7910
7911   • Robert Stayton: callout.icon.size.xml
7912
7913     Set size of callout graphics.
7914
7915   • Jirka Kosek: default.units.xml; chunker.output.method.xml;
7916     toc.list.type.xml; output.inden⋯
7917
7918     Updated parameter metadata to the new format.
7919
7920   • Jirka Kosek: man.output.quietly.xml; title.font.family.xml;
7921     footnote.sep.leader.properties⋯
7922
7923     Added type annotations into parameter definition files.
7924
7925   • Robert Stayton: section.container.element.xml
7926
7927     Support spans in sections for certain processors.
7928
7929   • Robert Stayton: component.titlepage.properties.xml
7930
7931     Empty attribute set for top level component titlepage block.
7932     Allows setting a span on title info.
7933
7934   • Jirka Kosek: bibliography.style.xml
7935
7936     Added link to WiKi page with description of special markup needed for ISO690 biblioentries
7937
7938   • Robert Stayton: make.year.ranges.xml
7939
7940     Clarify that multiple year elements are required.
7941
7942   • Robert Stayton: id.warnings.xml
7943
7944     Turn off id.warnings by default.
7945
7946   • Jirka Kosek: bibliography.style.xml
7947
7948     Added support for formatting biblioentries according to ISO690 citation style.
7949     New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
7950     The code was provided by Jana Dvorakova
7951
7952   • Robert Stayton: header.table.properties.xml; footer.table.properties.xml
7953
7954     Support adding table properties to header and footer tables.
7955
7956 Highlighting
7957
7958 The following changes have been made to the highlighting code since the 1.72.0
7959 release.
7960
7961   • Jirka Kosek: c-hl.xml; xslthl-config.xml
7962
7963     Added support for C language. Provided by Bruno Guegan.
7964
7965 Profiling
7966
7967 The following changes have been made to the profiling code since the 1.72.0
7968 release.
7969
7970   • Robert Stayton: profile-mode.xsl
7971
7972     Add support for new profiling attributes audience and wordsize.
7973
7974 Lib
7975
7976 The following changes have been made to the lib code since the 1.72.0 release.
7977
7978   • Michael(tm) Smith: lib.xweb
7979
7980     Changed name of prepend-pad template to pad-string and twheeked so
7981     it can do both right/left padding.
7982
7983 Tools
7984
7985 The following changes have been made to the tools code since the 1.72.0
7986 release.
7987
7988   • Michael(tm) Smith: bin; bin/docbook-xsl-update
7989
7990     Did some cleanup to the install.sh source and added a
7991     docbook-xsl-update script to the docbook-xsl distro, the purpose
7992     of which is to facilitate easy sync-up to the latest docbook-xsl
7993     snapshot (by means of rsync).
7994
7995 XSL-Saxon
7996
7997 The following changes have been made to the xsl-saxon code since the 1.72.0
7998 release.
7999
8000   • Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/
8001     com/nwalsh/xalan/⋯
8002
8003     Added modifications so that the new callout.icon.size parameter is taken into account. This
8004     parameter is used for FO output (where SVG now is the default graphics format for callouts).
8005
8006   • Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/
8007     src/com/nwalsh/x⋯
8008
8009     Added code for generating id attributes on callouts in HTML and FO output.
8010     These patches enable cross-references to callouts placed by area coordinates.
8011     It works for graphic, unicode and text callouts.
8012     Part of fix for bug #1675513 (xref to area broken).
8013
8014   • Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/
8015     com/nwalsh/xalan⋯
8016
8017     Copied over Website XSL Java extensions.
8018
8019 XSL-Xalan
8020
8021 The following changes have been made to the xsl-xalan code since the 1.72.0
8022 release.
8023
8024   • Michael(tm) Smith: Makefile; xalan2
8025
8026     Turned off xalan2.jar build. This removes DocBook XSL
8027     Java extensions support for versions of Xalan prior to
8028     Xalan 2.7. If you are currently using the extensions
8029     with an earlier version of Xalan, you need to upgrade
8030     to Xalan 2.7.
8031
8032   • Mauritz Jeanson: xalan27/src/com/nwalsh/xalan/Verbatim.java; xalan27/src/
8033     com/nwalsh/xalan/⋯
8034
8035     Added modifications so that the new callout.icon.size parameter is taken into account. This
8036     parameter is used for FO output (where SVG now is the default graphics format for callouts).
8037
8038   • Mauritz Jeanson: saxon65/src/com/nwalsh/saxon/FormatCallout.java; xalan27/
8039     src/com/nwalsh/x⋯
8040
8041     Added code for generating id attributes on callouts in HTML and FO output.
8042     These patches enable cross-references to callouts placed by area coordinates.
8043     It works for graphic, unicode and text callouts.
8044     Part of fix for bug #1675513 (xref to area broken).
8045
8046   • Michael(tm) Smith: saxon65/src/com/nwalsh/saxon/Website.java; xalan27/src/
8047     com/nwalsh/xalan⋯
8048
8049     Copied over Website XSL Java extensions.
8050
8051 Release: 1.72.0
8052
8053 This release includes important bug fixes and adds the following significant
8054 feature changes:
8055
8056 Automatic sorting of glossary entries
8057
8058     The HTML and FO stylesheets now support automatic sorting of glossary
8059     entries. To enable glossary sorting, set the value of the glossary.sort 
8060     parameter to 1 (by default, it’s value is 0). When you enable glossary
8061     sorting, glossentry elements within a glossary, glossdiv, or glosslist are
8062     sorted on the glossterm, using the current language setting. If you don’t
8063     enable glossary sorting, then the order of glossentry elements is left “as
8064     is” — that is, they are not sorted but are instead just displayed in
8065     document order.
8066
8067 WordML renamed to Roundtrip, OpenOffice support added
8068
8069     Stylesheets for “roundtrip” conversion between documents in OpenOffice
8070     format (ODF) and DocBook XML have been added to the set of stylesheets that
8071     formerly had the collective title WordML, and that set of stylesheets has
8072     been renamed to Roundtrip to better reflect the actual scope and purpose of
8073     its contents.
8074
8075     So the DocBook XSL Stylesheets now support roundtrip conversion (with
8076     certain limitations) of WordML, OpenOffice, and Apple Pages documents to
8077     and from DocBook XML.
8078
8079 Including QandASet questions in TOCs
8080
8081     The HTML stylesheet now provides support for including QandASet questions
8082     in the document TOC. To enable display of questions in the document TOC,
8083     set the value of the qanda.in.toc to 1 (by default, it’s 0). When you
8084     enable qanda.in.toc, then the generated table of contents for a document
8085     will include qandaset titles, qandadiv titles, and question elements. The
8086     default value of zero excludes them from the TOC.
8087
8088     Note
8089
8090     The qanda.in.toc parameter does not affect any tables of contents that may
8091     be generated within a qandaset or qandadiv (only in the document TOC).
8092
8093 Language identifier in man-page filenames and pathnames
8094
8095     Added new parameter man.output.lang.in.name.enabled, which controls whether
8096     a language identifier is included in man-page filenames and pathnames. It
8097     works like this:
8098
8099     If the value of man.output.lang.in.name.enabled is non-zero, man-page files
8100     are output with a language identifier included in their filenames or
8101     pathnames as follows:
8102
8103       □ if man.output.subdirs.enabled is non-zero, each file is output to,
8104         e.g., a /$lang/man8/foo.8 pathname
8105
8106       □ if man.output.subdirs.enabled is zero, each file is output with a
8107         foo.$lang.8 filename
8108
8109 index.page.number.properties property set
8110
8111     For FO output, use the index.page.number.properties to control formatting
8112     of page numbers in index output — to (for example) to display page numbers
8113     in index output in a different color (to indicate that they are links).
8114
8115 Crop marks in output from Antenna House XSL Formatter
8116
8117     Support has been added for generating crop marks in print/PDF output
8118     generated using Antenna House XSL Formatter
8119
8120 More string-substitution hooks in manpages output
8121
8122     The man.string.subst.map.local.pre and man.string.subst.map.local.post
8123     parameters have been added to enable easier control over custom string
8124     substitutions.
8125
8126 Moved verbatim properties to attribute-set
8127
8128     The hardcoded properties used in verbatim elements (literallayout,
8129     programlisting, screen) were moved to the verbatim.properties attribute-set
8130     so they can be more easily customized.
8131
8132 enhanced simple.xlink template
8133
8134     Now the simple.xlink template in inline.xsl works with cross reference
8135     elements xref and link as well. Also, more elements call simple.xlink,
8136     which enables DB5 xlink functionality.
8137
8138 DocBook 5 compatibility
8139
8140     Stylesheets now consistently support DocBook 5 attributes (such as xml:id).
8141     Also, DocBook 5 info elements are now checked along with other *info
8142     elements, and the use of name() function was replaced by local-name() so it
8143     also matches on DocBook 5 elements. These changes enable reusing the
8144     stylesheets with DocBook 5 documents with minimal fixup.
8145
8146 HTML class attributes now handled in class.attribute mode
8147
8148     The HTML class attributes were formerly hardcoded to the element name. Now
8149     the class attribute is generated by applying templates in class.attribute
8150     mode so class attribute names can be customized. The default is still the
8151     element name.
8152
8153 arabic-indic numbering enabled in autolabels
8154
8155     Numbering of chapter, sections, and pages can now use arabic-indic
8156     numbering when number format is set to 'arabicindic' or to ١.
8157
8158 The following is a detailed list of changes (not including bug fixes) that have
8159 been made since the 1.71.1 release.
8160
8161 Common
8162
8163 The following changes have been made to the common code since the 1.71.1
8164 release.
8165
8166   • Add support for arabicindic numbering to autolabel.format template.
8167
8168   • Finish support for @xml:id everywhere @id is used.
8169
8170   • replace name() with local-name() in most cases.
8171
8172   • Add support for info.
8173
8174   • Add utility template tabstyle to return the tabstyle from
8175     any table element.
8176
8177 FO
8178
8179 The following changes have been made to the fo code since the 1.71.1 release.
8180
8181   • Add support for sorting glossary entries
8182
8183   • Add table.row.properties template to customize table rows.
8184
8185   • Moved all properties to attribute-sets so can be customized more easily.
8186
8187   • Add index.page.number.properties attribute-set to format page numbers.
8188
8189   • xref now supports xlink:href, using simple.xlink template.
8190
8191   • Rewrote simple.xlink, and call it with all charseq templates.
8192
8193   • Add simple.xlink processing to term and member elements.
8194
8195   • Add support for crop marks in Antenna House.
8196
8197 HTML
8198
8199 The following changes have been made to the html code since the 1.71.1 release.
8200
8201   • Add support for sorting glossary entries
8202
8203   • Add support for qanda.in.toc to add qandaentry questions to document TOC.
8204
8205   • add simple.xlink support to variablelist term and simplelist member.
8206
8207   • *.propagates.style now handled in class.attribute mode.
8208
8209   • add class parameter to class.attribute mode to set default class.
8210
8211   • Convert all class attributes to use the class.attribute mode
8212     so class names can be customized more easily.
8213
8214   • Add class.attribute mode to generate class attributes.
8215
8216   • Added simple.xlink to most remaining inlines.
8217     Changed class attributes to applying class.attributes mode.
8218
8219   • Changed xref template to use simple.xlink tempalte.
8220
8221   • Improve generate.html.title to work with link targets too.
8222
8223   • Improved simple.xlink to support link and xref.
8224
8225   • Use new link.title.attribute now.
8226
8227   • Rewrote simple.xlink to handle linkend also.
8228     Better computation of title attribute on link too.
8229
8230   • Handle Xalan quirk as special case.
8231
8232   • Add support for info.
8233
8234   • Fixed imagemaps so they work properly going from calspair coords
8235     to HTML area coords.
8236
8237 Manpages
8238
8239 The following changes have been made to the manpages code since the 1.71.1
8240 release.
8241
8242   • Added doc for man.output.lang.in.name.enabled parameter. This
8243     checkin completes support for writing file/pathnames for man-pages
8244     with $lang include in the names. Closes #1585967. knightly
8245     accolades to Daniel Leidert for providing the feature request.
8246
8247   • Added new param man.output.lang.in.name.enabled, which
8248     controls whether $LANG value is included in manpages
8249     filenames and pathnames. It works like this:
8250
8251     If the value of man.output.lang.in.name.enabled is non-zero,
8252     man-page files are output with the $lang value included in
8253     their filenames or pathnames as follows;
8254
8255     - if man.output.subdirs.enabled is non-zero, each file is
8256       output to, e.g., a /$lang/man8/foo.8 pathname
8257
8258     - if man.output.subdirs.enabled is zero, each file is output
8259       with a foo.$lang.8 filename
8260
8261   • Use "\e" instead of "\\" for backslash output, because the
8262     groff docs say that's the correct thing to do; also because
8263     testing (thanks, Paul Dubois) shows that "\\" doesn't always
8264     work as expected; for example, "\\" within a table seems to
8265     mess things up.
8266
8267   • Added the man.string.subst.map.local.pre and
8268     man.string.subst.map.local.post parameters. Those parameters
8269     enable local additions and changes to string-substitution mappings
8270     without the need to change the value of man.string.subst.map
8271     parameter (which is for standard system mappings). Closes
8272     #1456738. Thanks to Sam Steingold for constructing a true
8273     stylesheet torture test (the clisp docs) that exposed the need for
8274     these params.
8275
8276   • Added the Markup element to the list of elements that get output
8277     in bold. Thanks to Eric S. Raymond.
8278
8279   • Replaced all dots in roff requests with U+2302 ("house"
8280     character), and added escaping in output for all instances of dot
8281     that are not in roff requests. This fixes the problem case where a
8282     string beginning with a dot (for example, the string ".bashrc")
8283     might occur at the beginning of a line in output, in which case 
8284     would mistakenly get interpreted as a roff request. Thanks to Eric
8285     S. Raymond for pushing to fix this.
8286
8287   • Made change to ensure that list content nested in
8288     itemizedlist and orderedlist instances is properly indented. This
8289     is a switch from using .TP to format those lists to using .RS/.RE
8290     to format them instead (because .TP does not allow nesting). Closes bug #
8291     1602616.
8292     Thanks to Daniel Leidert.
8293
8294 Params
8295
8296 The following changes have been made to the params code since the 1.71.1
8297 release.
8298
8299   • Added doc for man.output.lang.in.name.enabled parameter. This
8300     checkin completes support for writing file/pathnames for man-pages
8301     with $lang include in the names. Closes #1585967. knightly
8302     accolades to Daniel Leidert for providing the feature request.
8303
8304   • Added new param man.output.lang.in.name.enabled, which
8305     controls whether $LANG value is included in manpages
8306     filenames and pathnames. It works like this:
8307
8308     If the value of man.output.lang.in.name.enabled is non-zero,
8309     man-page files are output with the $lang value included in
8310     their filenames or pathnames as follows;
8311
8312     - if man.output.subdirs.enabled is non-zero, each file is
8313       output to, e.g., a /$lang/man8/foo.8 pathname
8314
8315     - if man.output.subdirs.enabled is zero, each file is output
8316       with a foo.$lang.8 filename
8317
8318   • Added the man.string.subst.map.local.pre and
8319     man.string.subst.map.local.post parameters. Those parameters
8320     enable local additions and changes to string-substitution mappings
8321     without the need to change the value of man.string.subst.map
8322     parameter (which is for standard system mappings). Closes
8323     #1456738. Thanks to Sam Steingold for constructing a true
8324     stylesheet torture test (the clisp docs) that exposed the need for
8325     these params.
8326
8327   • Add index.page.number.properties by default.
8328
8329   • Added index.page.number.properties
8330      to allow customizations of page numbers in indexes.
8331
8332   • Move show-destination="replace" property from template to attribute-set
8333     so it can be customized.
8334
8335   • Add support for sorting glossary entries
8336
8337   • Add option to include qanda in tables of contents.
8338
8339   • Moved all properties to attribute-sets so can be customized more easily.
8340
8341 Template
8342
8343 The following changes have been made to the template code since the 1.71.1
8344 release.
8345
8346   • Added workaround for Xalan bug: use for-each and copy instead of copy-of (#
8347     1604770).
8348
8349 Roundtrip
8350
8351 The following changes have been made to the roundtrip code since the 1.71.1
8352 release.
8353
8354   • rename to roundtrip, add OpenOffice support
8355
8356 Release: 1.71.1
8357
8358 This is a minor update to the 1.71.0 release. Along with a number of bug fixes,
8359 it includes two feature changes:
8360
8361   • Added support for profiling based on xml:lang and status attributes.
8362
8363   • Added initial support in manpages output for footnote, annotation, and alt
8364     instances. Basically, they all now get handled the same way ulink instances
8365     are. They are treated as a class as "note sources": A numbered marker is
8366     generated at the place in the main text flow where they occur, then their
8367     contents are displayed in an endnotes section at the end of the man page.
8368
8369 Common
8370
8371 The following changes have been made to the common code since the 1.71.1
8372 release.
8373
8374   • For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
8375
8376   • Add support for Xalan generating a root xml:base like saxon.
8377
8378 FO
8379
8380 The following changes have been made to the fo code since the 1.71.1 release.
8381
8382   • For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
8383
8384   • Add support for Xalan to add root node xml:base for db5 docs.
8385
8386   • Added support for profiling based on xml:lang and status attributes.
8387
8388 HTML
8389
8390 The following changes have been made to the html code since the 1.71.1 release.
8391
8392   • For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.
8393
8394   • Add support for Xalan to add root node xml:base for db5 docs.
8395
8396   • Added support for profiling based on xml:lang and status attributes.
8397
8398   • Made changes in namespace declarations to prevent xmllint's
8399     canonicalizer from treating them as relative namespace URIs.
8400
8401       - Changed xmlns:k="java:com.isogen.saxoni18n.Saxoni18nService"
8402         to xmlns:k="http://www.isogen.com/functions/
8403     com.isogen.saxoni18n.Saxoni18nService";
8404         Saxon accepts either form
8405         (see http://www.saxonica.com/documentation/extensibility/
8406     functions.html);
8407         to Saxon, "the part of the URI before the final '/' is immaterial".
8408
8409       - Changed, e.g. xmlns:xverb="com.nwalsh.xalan.Verbatim" to
8410         xmlns:xverb="xalan://com.nwalsh.xalan.Verbatim"; Xalan accepts
8411         either form
8412         (see http://xml.apache.org/xalan-j/extensions.html#
8413     java-namespace-declare);
8414         just as Saxon does, it will "simply use the string to the
8415         right of the rightmost forward slash as the Java class name".
8416
8417       - Changed xmlns:xalanredirect="org.apache.xalan.xslt.extensions.Redirect"
8418         to xmlns:redirect="http://xml.apache.org/xalan/redirect", and
8419         adjusted associated code to make the current Xalan redirect spec.
8420         (see http://xml.apache.org/xalan-j/apidocs/org/apache/xalan/lib/
8421     Redirect.html)
8422
8423   • Added the html.append and chunk.append parameters. By default, the
8424     value of both is empty; but the internal DocBook XSL stylesheets
8425     build sets their value to "<xsl:text>&#x0a;</xsl:text>", in order
8426     to ensure that all files in the docbook-xsl-doc package end in a
8427     newline character. (Because diff and some other tools may emit
8428     error messages and/or not behave as expected when processing
8429     files that are not newline-terminated.)
8430
8431 Highlighting
8432
8433 The following changes have been made to the highlighting code since the 1.71.1
8434 release.
8435
8436   • Added license information
8437
8438 Manpages
8439
8440 The following changes have been made to the manpages code since the 1.71.1
8441 release.
8442
8443   • Added initial support in manpages output for footnote, annotation,
8444     and alt instances. Basically, they all now get handled the same
8445     way ulink instances are. They are treated as a class as "note
8446     sources": A numbered marker is generated at the place in the main
8447     text flow where they occur, then their contents are displayed in
8448     an endnotes section at the end of the man page (currently titled
8449     REFERENCES, for English output, but will be changed to NOTES).
8450
8451     This support is not yet complete. It works for most "normal"
8452     cases, but probably mishandles a good number of cases. More
8453     testing will be needed to expose the problems. It may well also
8454     introduce some bugs and regressions in other areas, including
8455     basic paragraph handling, handling of "mixed block" content,
8456     handling of other indented content, and handling of authorblurb
8457     and personblurb in the AUTHORS section.
8458
8459 Params
8460
8461 The following changes have been made to the params code since the 1.71.1
8462 release.
8463
8464   • Added support for profiling based on xml:lang and status attributes.
8465
8466   • Added the html.append and chunk.append parameters. By default, the
8467     value of both is empty; but the internal DocBook XSL stylesheets
8468     build sets their value to "<xsl:text>&#x0a;</xsl:text>", in order
8469     to ensure that all files in the docbook-xsl-doc package end in a
8470     newline character. (Because diff and some other tools may emit
8471     error messages and/or not behave as expected when processing
8472     files that are not newline-terminated.)
8473
8474 Profiling
8475
8476 The following changes have been made to the profiling code since the 1.71.1
8477 release.
8478
8479   • Added support for profiling based on xml:lang and status attributes.
8480
8481 Release: 1.71.0
8482
8483 This is mainly a bug fix release, but it also includes two significant feature
8484 changes:
8485
8486 Highlighting support added
8487
8488     The stylesheets now include support for source-code highlighting in output
8489     of programlisting instances (controlled through the highlight.source
8490     parameter). The Java-based implementation requires Saxon and makes use of
8491     Michal Molhanec’s XSLTHL. More details are available at Jirka Kosek’s
8492     website:
8493
8494         http://xmlguru.cz/2006/07/docbook-syntax-highlighting
8495
8496     The support is currently limited to highlighting of XML, Java, PHP, Delphi,
8497     Modula-2 sources, and INI files.
8498
8499 Changes to autoindexing
8500
8501     The templates that handle alternative indexing methods were reworked to
8502     avoid errors produced by certain processors not being able to tolerate the
8503     presence of unused functions. With this release, none of the code for the
8504     'kimber' or 'kosek' methods is included in the default stylesheets. In
8505     order to use one of those methods, your customization layer must import one
8506     of the optional stylesheet modules:
8507
8508       □ html/autoidx-kosek.xsl
8509       □ html/autoidx-kimber.xsl
8510       □ fo/autoidx-kosek.xsl
8511       □ fo/autoidx-kimber.xsl
8512
8513     See the index.method parameter reference page for more information.
8514
8515     Two other changes to note:
8516
8517       □ The default indexing method now can handle accented characters in
8518         latin-based alphabets, not just English. This means accented latin
8519         letters will group and sort with their unaccented counterpart.
8520       □ The default value for the index.method parameter was changed from
8521         'english' to 'basic' because now the default method can handle
8522         latin-based alphabets, not just English.
8523
8524 The following is a list of changes that have been made since the 1.70.1
8525 release.
8526
8527 Common
8528
8529 The following changes have been made to the common code since the 1.70.1
8530 release.
8531
8532   • Added reference.autolabel parameter for controlling labels on
8533     reference output.
8534
8535   • Support rows that are *completely* overlapped by the preceding row
8536
8537   • New modules for supporting indexing extensions.
8538
8539   • Support startinglinenumber on orderedlist
8540
8541 Extensions
8542
8543 The following changes have been made to the extensions code since the 1.70.1
8544 release.
8545
8546   • Completely reworked extensions build system; now uses NetBeans and ant
8547
8548 FO
8549
8550 The following changes have been made to the fo code since the 1.70.1 release.
8551
8552   • xsl:sort lang attribute now uses two-char substring of lang attribute.
8553
8554   • Support titlecase "Java", "Perl", and "IDL" as values for the
8555     language attribute on classsynopsis, etc. (instead of just
8556     lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
8557     (instead of just "cpp").
8558
8559     Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
8560     to "Brian A. Vanderburg II".
8561
8562   • Added support for the reference.autolabel param in (X)HTML and FO
8563     output.
8564
8565   • Support rows that are *completely* overlapped by the preceding row
8566
8567   • Rearranged templates for the 3 indexing methods
8568     and changed method named 'english' to 'basic'.
8569
8570   • New modules for supporting indexing extensions.
8571
8572   • Turn off blank-body for fop1.extensions too since fop 0.92
8573     does not support it either.
8574
8575   • Add Xalan variant to test for exslt:node-set function.
8576     Xalan can use function named node-set(), but doesn't
8577     recognize it using function-available().
8578
8579   • Added support to FO stylesheets for handling instances of Org
8580     where it occurs outside of *info content. In HTML stylesheets,
8581     moved handling of Org out of info.xsl and into inline.xsl. In both
8582     FO and HTML stylesheets, added support for correctly processing
8583     Affiliation and Jobtitle.
8584
8585   • Don't output punctuation between Refname and Refpurpose if
8586     Refpurpose is empty. Also corrected handling of Refsect2/title
8587     instances, and removed some debugging stuff that was generated in
8588     manpages output to mark the ends of sections.
8589
8590   • Added new email.delimiters.enabled param. If non-zero (the
8591     default), delimiters are generated around e-mail addresses (output
8592     of the email element). If zero, the delimiters are suppressed.
8593
8594   • Initial support of syntax highlighting of programlistings.
8595
8596   • Chapter after preface should restart numbering of pages.
8597
8598 HTML
8599
8600 The following changes have been made to the html code since the 1.70.1 release.
8601
8602   • xsl:sort lang attribute now uses two-char substring of lang attribute.
8603
8604   • Support titlecase "Java", "Perl", and "IDL" as values for the
8605     language attribute on classsynopsis, etc. (instead of just
8606     lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
8607     (instead of just "cpp").
8608
8609     Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
8610     to "Brian A. Vanderburg II".
8611
8612   • Added support for the reference.autolabel param in (X)HTML and FO
8613     output.
8614
8615   • Support rows that are *completely* overlapped by the preceding row
8616
8617   • Rearranged templates for the 3 indexing methods
8618     and changed method named 'english' to 'basic'.
8619
8620   • New modules for supporting indexing extensions.
8621
8622   • Added several new HTML parameters for controlling appearance of
8623     content on HTML title pages:
8624
8625     contrib.inline.enabled:
8626       If non-zero (the default), output of the contrib element is
8627       displayed as inline content rather than as block content.
8628
8629     othercredit.like.author.enabled:
8630       If non-zero, output of the othercredit element on titlepages is
8631       displayed in the same style as author and editor output. If zero
8632       (the default), othercredit output is displayed using a style
8633       different than that of author and editor.
8634
8635     blurb.on.titlepage.enabled:
8636       If non-zero, output from authorblurb and personblurb elements is
8637       displayed on title pages. If zero (the default), output from
8638       those elements is suppressed on title pages (unless you are
8639       using a titlepage customization that causes them to be included).
8640
8641     editedby.enabled
8642       If non-zero (the default), a localized Edited by heading is
8643       displayed above editor names in output of the editor element.
8644
8645   • Add Xalan variant to test for exslt:node-set function.
8646     Xalan can use function named node-set(), but doesn't
8647     recognize it using function-available().
8648
8649   • Added support to FO stylesheets for handling instances of Org
8650     where it occurs outside of *info content. In HTML stylesheets,
8651     moved handling of Org out of info.xsl and into inline.xsl. In both
8652     FO and HTML stylesheets, added support for correctly processing
8653     Affiliation and Jobtitle.
8654
8655   • Don't output punctuation between Refname and Refpurpose if
8656     Refpurpose is empty. Also corrected handling of Refsect2/title
8657     instances, and removed some debugging stuff that was generated in
8658     manpages output to mark the ends of sections.
8659
8660   • Added new email.delimiters.enabled param. If non-zero (the
8661     default), delimiters are generated around e-mail addresses (output
8662     of the email element). If zero, the delimiters are suppressed.
8663
8664   • Added qanda.nested.in.toc param. Default value is zero. If
8665     non-zero, instances of "nested" Qandaentry (ones that are children
8666     of Answer elements) are displayed in the TOC. Closes patch 1509018
8667     (from Daniel Leidert). Currently on affects HTML output (no patch
8668     for FO output provided).
8669
8670   • Improved handling of relative locations generated files
8671
8672   • Initial support of syntax highlighting of programlistings.
8673
8674   • Support org
8675
8676   • Support person
8677
8678   • Support $keep.relative.image.uris also when chunking
8679
8680 Highlighting
8681
8682 The following changes have been made to the highlighting code since the 1.70.1
8683 release.
8684
8685   • Initial support of syntax highlighting of programlistings.
8686
8687 Manpages
8688
8689 The following changes have been made to the manpages code since the 1.70.1
8690 release.
8691
8692   • Suppress footnote markers and output warning that footnotes are
8693     not yet supported.
8694
8695   • Handle instances of address/otheraddr/ulink in author et al in the
8696     same way as email instances; that is, display them on the same
8697     linke as the author, editor, etc., name.
8698
8699   • Don't number or link-list any Ulink instance whose string value is
8700     identical to the value of its url attribute. Just display it inline.
8701
8702   • Don't output punctuation between Refname and Refpurpose if
8703     Refpurpose is empty. Also corrected handling of Refsect2/title
8704     instances, and removed some debugging stuff that was generated in
8705     manpages output to mark the ends of sections.
8706
8707   • Added new email.delimiters.enabled param. If non-zero (the
8708     default), delimiters are generated around e-mail addresses (output
8709     of the email element). If zero, the delimiters are suppressed.
8710
8711   • In manpages output, if the last/nearest *info element for
8712     particular Refentry has multiple Copyright and/or Legalnotice
8713     children, process them all (not just the first ones). Closes bug
8714     1524576. Thanks to Sam Steingold for the report and to Daniel
8715     Leidert for providing a patch.
8716
8717 Params
8718
8719 The following changes have been made to the params code since the 1.70.1
8720 release.
8721
8722   • Added reference.autolabel parameter for controlling labels on
8723     reference output.
8724
8725   • Added namespace declarations to document elements for all param files.
8726
8727   • Updated index.method doc to describe revised setup for importing index
8728      extensions.
8729
8730   • Added several new HTML parameters for controlling appearance of
8731     content on HTML title pages:
8732
8733     contrib.inline.enabled:
8734       If non-zero (the default), output of the contrib element is
8735       displayed as inline content rather than as block content.
8736
8737     othercredit.like.author.enabled:
8738       If non-zero, output of the othercredit element on titlepages is
8739       displayed in the same style as author and editor output. If zero
8740       (the default), othercredit output is displayed using a style
8741       different than that of author and editor.
8742
8743     blurb.on.titlepage.enabled:
8744       If non-zero, output from authorblurb and personblurb elements is
8745       displayed on title pages. If zero (the default), output from
8746       those elements is suppressed on title pages (unless you are
8747       using a titlepage customization that causes them to be included).
8748
8749     editedby.enabled
8750       If non-zero (the default), a localized Edited by heading is
8751       displayed above editor names in output of the editor element.
8752
8753   • Added new email.delimiters.enabled param. If non-zero (the
8754     default), delimiters are generated around e-mail addresses (output
8755     of the email element). If zero, the delimiters are suppressed.
8756
8757   • Added qanda.nested.in.toc param. Default value is zero. If
8758     non-zero, instances of "nested" Qandaentry (ones that are children
8759     of Answer elements) are displayed in the TOC. Closes patch 1509018
8760     (from Daniel Leidert). Currently on affects HTML output (no patch
8761     for FO output provided).
8762
8763   • Initial support of syntax highlighting of programlistings.
8764
8765 Tools
8766
8767 The following changes have been made to the tools code since the 1.70.1
8768 release.
8769
8770   • Racheted down font sizes of headings in example makefile FO output.
8771
8772   • Added param and attribute set to example makefile, for getting
8773     wrapping in verbatims in FO output.
8774
8775   • Renamed Makefile.paramDoc to Makefile.docParam.
8776
8777   • Added Makefile.paramDoc file, for creating versions of param.xsl
8778     files with doc embedded.
8779
8780   • Added variable to example makefile for controlling whether HTML or
8781     XHTML is generated.
8782
8783 Release: 1.70.1
8784
8785 This is a stable release of the 1.70 stylesheets. It includes only a few small
8786 changes from 1.70.0.
8787
8788 The following is a list of changes that have been made since the 1.70.0
8789 release.
8790
8791 FO
8792
8793 The following changes have been made to the fo code since the 1.70.0 release.
8794
8795   • Added three new attribute sets (revhistory.title.properties,
8796     revhistory.table.properties and revhistory.table.cell.properties) for
8797     controlling appearance of revhistory in FO output.
8798
8799     Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/
8800     titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params
8801     /revhistory.table.properties.xml,1.1; params/
8802     revhistory.title.properties.xml,1.1 - Jirka Kosek
8803
8804   • Support DBv5 revisions with full author name (not only authorinitials)
8805
8806     Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek
8807
8808 HTML
8809
8810 The following changes have been made to the html code since the 1.70.0 release.
8811
8812   • Support DBv5 revisions with full author name (not only authorinitials)
8813
8814     Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek
8815
8816 HTMLHelp
8817
8818 The following changes have been made to the htmlhelp code since the 1.70.0
8819 release.
8820
8821   • htmlhelp.generate.index is now param, not variable. This means that you can
8822     override its setting from outside. This is useful when you generate
8823     indexterms on the fly (see http://www.xml.com/pub/a/2004/07/14/dbndx.html?
8824     page=3).
8825
8826     Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek
8827
8828   • Support chunk.tocs.and.lots in HTML Help
8829
8830     Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek
8831
8832 Params
8833
8834 The following changes have been made to the params code since the 1.70.0
8835 release.
8836
8837   • Added three new attribute sets (revhistory.title.properties,
8838     revhistory.table.properties and revhistory.table.cell.properties) for
8839     controlling appearance of revhistory in FO output.
8840
8841     Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/
8842     titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params
8843     /revhistory.table.properties.xml,1.1; params/
8844     revhistory.title.properties.xml,1.1 - Jirka Kosek
8845
8846 Release: 1.70.0
8847
8848 As with all DocBook Project dot-zero releases, this is an experimental release.
8849 It will be followed shortly by a stable release.
8850
8851 This release adds a number of new features, including:
8852
8853   • support for selecting alternative index-collation methods (in particular,
8854     support for using a collation library developed by Eliot Kimber)
8855
8856   • improved handling of DocBook 5 document instances (through a
8857     namespace-stripping mechanism)
8858
8859   • full support for CALS and HTML tables in manpages output
8860
8861   • a mechanism for preserving relative URIs in documents that make use of
8862     XInclude
8863
8864   • support for the "new" .90 version of FOP
8865
8866   • enhanced capabilities for controlling formatting of lists in HTML and FO
8867     output
8868
8869   • autogeneration of AUTHOR and COPYRIGHT sections in manpages output
8870
8871   • support for generating crop marks in FO/PDF output
8872
8873   • support for qandaset as a root element in FO output
8874
8875   • support for floatstyle and orient on all table types
8876
8877   • support for floatstyle in figure, and example
8878
8879   • pgwide.properties attribute-set supports extending figure, example and
8880     table into the left indent area instead of spanning multiple columns.
8881
8882 The following is a detailed list of enhancements and API changes that have been
8883 made since the 1.69.1 release.
8884
8885 Common
8886
8887 The following changes have been made to the common code since the 1.69.1
8888 release.
8889
8890   • Add the xsl:key for the kimber indexing method.
8891
8892     Modified: common/autoidx-ng.xsl,1.2 - Robert Stayton
8893
8894   • Add support for qandaset.
8895
8896     Modified: common/labels.xsl,1.37; common/subtitles.xsl,1.7; common/
8897     titles.xsl,1.35 - Robert Stayton
8898
8899   • Support dbhtml/dbfo start PI for orderedlist numbering in both HTML and FO
8900
8901     Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman Walsh
8902
8903   • Added CVS header.
8904
8905     Modified: common/stripns.xsl,1.12 - Robert Stayton
8906
8907   • Changed content model of text element to ANY rather than #PCDATA because
8908     they could contain markup.
8909
8910     Modified: common/targetdatabase.dtd,1.7 - Robert Stayton
8911
8912   • Added refentry.meta.get.quietly param.
8913
8914     If zero (the default), notes and warnings about "missing" markup are
8915     generated during gathering of refentry metadata. If non-zero, the metadata
8916     is gathered "quietly" -- that is, the notes and warnings are suppressed.
8917
8918     NOTE: If you are processing a large amount of refentry content, you may be
8919     able to speed up processing significantly by setting a non-zero value for
8920     refentry.meta.get.quietly.
8921
8922     Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/
8923     param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
8924     Smith
8925
8926   • After namespace stripping, the source document is the temporary tree
8927     created by the stripping process and it has the wrong base URI for relative
8928     references. Earlier versions of this code used to try to fix that by
8929     patching the elements with relative @fileref attributes. That was
8930     inadequate because it calculated an absolute base URI without considering
8931     that there might be xml:base attributes already in effect. It seems obvious
8932     now that the right thing to do is simply to put the xml:base on the root of
8933     the document. And that seems to work.
8934
8935     Modified: common/stripns.xsl,1.7 - Norman Walsh
8936
8937   • Added support for "software" and "sectdesc" class values on refmiscinfo;
8938     "software" is treated identically to "source", and "setdesc" is treated
8939     identically to "manual".
8940
8941     Modified: common/refentry.xsl,1.10; params/
8942     man.th.extra2.max.length.xml,1.3; params/
8943     refentry.source.name.profile.xml,1.4 - Michael(tm) Smith
8944
8945   • Added support for DocBook 5 namespace-stripping in manpages stylesheet.
8946     Closes request #1210692.
8947
8948     Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm)
8949     Smith
8950
8951   • Added <xsl:template match="/"> to make stripns.xsl usable as a standalone
8952     stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that DocBook
8953     XSLT drivers that include this stylesheet all override the match="/"
8954     template.
8955
8956     Modified: common/stripns.xsl,1.4 - Michael(tm) Smith
8957
8958   • Number figures, examples, and tables from book if there is no prefix (i.e.
8959     if chapter.autolabel is set to 0). This avoids having the list of figures
8960     where the figures mysteriously restart their numeration periodically when
8961     chapter.autolabel is set to 0.
8962
8963     Modified: common/labels.xsl,1.36 - David Cramer
8964
8965   • Add task template in title.markup mode.
8966
8967     Modified: common/titles.xsl,1.34 - Robert Stayton
8968
8969   • Add children (with ids) of formal objects to target data.
8970
8971     Modified: common/targets.xsl,1.10 - Robert Stayton
8972
8973   • Added support for case when personname doesn't contain specific name markup
8974     (as allowed in DocBook 5.0)
8975
8976     Modified: common/common.xsl,1.54 - Jirka Kosek
8977
8978 Extensions
8979
8980 The following changes have been made to the extensions code since the 1.69.1
8981 release.
8982
8983   • Support Xalan 2.7
8984
8985     Modified: extensions/xalan27/.cvsignore,1.1; extensions/xalan27/
8986     build.xml,1.1; extensions/xalan27/nbproject/.cvsignore,1.1; extensions/
8987     xalan27/nbproject/build-impl.xml,1.1; extensions/xalan27/nbproject/
8988     genfiles.properties,1.1; extensions/xalan27/nbproject/
8989     project.properties,1.1; extensions/xalan27/nbproject/project.xml,1.1;
8990     extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1; extensions/xalan27/
8991     src/com/nwalsh/xalan/Callout.java,1.1; extensions/xalan27/src/com/nwalsh/
8992     xalan/FormatCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
8993     FormatDingbatCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
8994     FormatGraphicCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
8995     FormatTextCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
8996     FormatUnicodeCallout.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
8997     Func.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
8998     ImageIntrinsics.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/
8999     Params.java,1.1; extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1;
9000     extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1; extensions/xalan27/
9001     src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman Walsh
9002
9003   • Handle the case where the imageFn is actually a URI. This still needs work.
9004
9005     Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4 -
9006     Norman Walsh
9007
9008 FO
9009
9010 The following changes have been made to the fo code since the 1.69.1 release.
9011
9012   • Adapted to the new indexing code. Now works just like a wrapper that calls
9013     kosek indexing method, originally implemented here.
9014
9015     Modified: fo/autoidx-ng.xsl,1.5 - Jirka Kosek
9016
9017   • Added parameters for header/footer table minimum height.
9018
9019     Modified: fo/pagesetup.xsl,1.60; fo/param.ent,1.100; fo/param.xweb,1.113 -
9020     Robert Stayton
9021
9022   • Add the index.method parameter.
9023
9024     Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert Stayton
9025
9026   • Integrate support for three indexing methods: - the original English-only
9027     method. - Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's
9028     method using Saxon extensions. Use the 'index.method' parameter to select.
9029
9030     Modified: fo/autoidx.xsl,1.38 - Robert Stayton
9031
9032   • Add support for TOC for qandaset in fo output.
9033
9034     Modified: fo/autotoc.xsl,1.30; fo/qandaset.xsl,1.20 - Robert Stayton
9035
9036   • Added parameter ulink.hyphenate.chars. Added parameter insert.link
9037     .page.number.
9038
9039     Modified: fo/param.ent,1.98; fo/param.xweb,1.111 - Robert Stayton
9040
9041   • Implemented feature request #942524 to add insert.link.page.number to allow
9042     link element cross references to have a page number.
9043
9044     Modified: fo/xref.xsl,1.67 - Robert Stayton
9045
9046   • Add support for ulink.hyphenate.chars so more characters can be break
9047     points in urls.
9048
9049     Modified: fo/xref.xsl,1.66 - Robert Stayton
9050
9051   • Implemented patch #1075144 to make the url text in a ulink in FO output an
9052     active link as well.
9053
9054     Modified: fo/xref.xsl,1.65 - Robert Stayton
9055
9056   • table footnotes now have their own table.footnote.properties attribute set.
9057
9058     Modified: fo/footnote.xsl,1.23 - Robert Stayton
9059
9060   • Add qandaset to root.elements.
9061
9062     Modified: fo/docbook.xsl,1.41 - Robert Stayton
9063
9064   • Added mode="page.sequence" to make it easier to put content into a page
9065     sequence. First used for qandaset.
9066
9067     Modified: fo/component.xsl,1.37 - Robert Stayton
9068
9069   • Implemented feature request #1434408 to support formatting of biblioentry.
9070
9071     Modified: fo/biblio.xsl,1.35 - Robert Stayton
9072
9073   • Added biblioentry.properties.
9074
9075     Modified: fo/param.ent,1.97; fo/param.xweb,1.110 - Robert Stayton
9076
9077   • Support PTC/Arbortext bookmarks
9078
9079     Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman Walsh
9080
9081   • Added table.footnote.properties to permit table footnotes to format
9082     differently from regular footnotes.
9083
9084     Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert Stayton
9085
9086   • Refactored table templates to unify their processing and support all
9087     options in all types. Now table and informaltable, in both Cals and Html
9088     markup, use the same templates where possible, and all support pgwide,
9089     rotation, and floats. There is also a placeholder table.container template
9090     to support wrapping a table in a layout table, so the XEP table title
9091     "continued" extension can be more easily implemented.
9092
9093     Modified: fo/formal.xsl,1.52; fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 -
9094     Robert Stayton
9095
9096   • Added new attribute set toc.line.properties for controlling appearance of
9097     lines in ToC/LoT
9098
9099     Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95; fo/param.xweb,1.108 -
9100     Jirka Kosek
9101
9102   • Added support for float to example and equation. Added support for pgwide
9103     to figure, example, and equation (the latter two via a dbfo pgwide="1"
9104     processing instruction).
9105
9106     Modified: fo/formal.xsl,1.51 - Robert Stayton
9107
9108   • Add pgwide.properties attribute-set.
9109
9110     Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert Stayton
9111
9112   • Added refclass.suppress param.
9113
9114     If the value of refclass.suppress is non-zero, then display refclass
9115     contents is suppressed in output. Affects HTML and FO output only.
9116
9117     Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html
9118     /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith
9119
9120   • Improved support for task subelements
9121
9122     Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - Jirka Kosek
9123
9124   • Adjusted spacing around K&R-formatted Funcdef and Paramdef output such that
9125     it can more easily be discerned where one ends and the other begins. Closes
9126     #1213264.
9127
9128     Modified: fo/synop.xsl,1.18 - Michael(tm) Smith
9129
9130   • Made handling of paramdef/parameter in FO output consistent with that in
9131     HTML and manpages output. Closes #1213259.
9132
9133     Modified: fo/synop.xsl,1.17 - Michael(tm) Smith
9134
9135   • Made handling of Refnamediv consistent with formatting in HTML and manpages
9136     output; specifically, changed so that Refname (comma-separated list of
9137     multiple instances found) is used (instead of Refentrytitle as previously),
9138     then em-dash, then the Refpurpose. Closes #1212562.
9139
9140     Modified: fo/refentry.xsl,1.30 - Michael(tm) Smith
9141
9142   • Added output of Releaseinfo to recto titlepage ("copyright" page) for Book
9143     in FO output. This makes it consistent with HTML output. Closes #1327034.
9144     Thanks to Paul DuBois for reporting.
9145
9146     Modified: fo/titlepage.templates.xml,1.28 - Michael(tm) Smith
9147
9148   • Added condition for setting block-progression-dimension.minimum on
9149     table-row, instead of height, when fop1.extensions is non-zero. For an
9150     explanation of the reason for the change, see: http://wiki.apache.org/
9151     xmlgraphics-fop/Troubleshooting/CommonLogMessages
9152
9153     Modified: fo/pagesetup.xsl,1.59 - Michael(tm) Smith
9154
9155   • Added new refclass.suppress param for suppressing display of Refclass in
9156     HTML and FO output. Did not add it to manpages because manpages stylesheet
9157     is currently just silently ignoring Refclass anyway. Closes request #
9158     1461065. Thanks to Davor Ocelic (docelic) for reporting.
9159
9160     Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - Michael(tm) Smith
9161
9162   • Add support for keep-together PI to informal objects.
9163
9164     Modified: fo/formal.xsl,1.50 - Robert Stayton
9165
9166   • Add support for fop1.extensions.
9167
9168     Modified: fo/formal.xsl,1.49; fo/graphics.xsl,1.44; fo/table.xsl,1.47 -
9169     Robert Stayton
9170
9171   • Add support for fop1 bookmarks.
9172
9173     Modified: fo/docbook.xsl,1.39 - Robert Stayton
9174
9175   • Add fop1.extentions parameter to add support for fop development version.
9176
9177     Modified: fo/param.ent,1.92; fo/param.xweb,1.105 - Robert Stayton
9178
9179   • Start supporting fop development version, which will become fop version 1.
9180
9181     Modified: fo/fop1.xsl,1.1 - Robert Stayton
9182
9183   • Add template for task in mode="xref-to".
9184
9185     Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert Stayton
9186
9187   • table footnotes now also get footnote.properties attribute-set.
9188
9189     Modified: fo/footnote.xsl,1.22 - Robert Stayton
9190
9191   • Added index.separator named template to compute the separator punctuation
9192     based on locale.
9193
9194     Modified: fo/autoidx.xsl,1.36 - Robert Stayton
9195
9196   • Added support for link, olink, and xref within OO Classsynopsis and
9197     children. (Because DocBook NG/5 allows it).
9198
9199     Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith
9200
9201   • Support date as an inline
9202
9203     Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh
9204
9205   • Added new parameter keep.relative.image.uris
9206
9207     Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html
9208     /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh
9209
9210   • Map Unicode space characters U+2000-U+200A to fo:leaders.
9211
9212     Modified: fo/docbook.xsl,1.38; fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 -
9213     Jirka Kosek
9214
9215   • Output a real em dash for em-dash dingbat (instead of two hypens).
9216
9217     Modified: fo/fo.xsl,1.7 - Michael(tm) Smith
9218
9219   • Support default label width parameters for itemized and ordered lists
9220
9221     Modified: fo/lists.xsl,1.64; fo/param.ent,1.90; fo/param.xweb,1.103; params
9222     /itemizedlist.label.width.xml,1.1; params/orderedlist.label.width.xml,1.1 -
9223     Norman Walsh
9224
9225   • Generate localized title for Refsynopsisdiv if no appropriate Title
9226     descendant found in source. Closes #1212398. This change makes behavior for
9227     the Synopsis title consistent with the behavior of HTML and manpages
9228     output.
9229
9230     Also, added xsl:use-attribute-sets="normal.para.spacing" to block generated
9231     for Cmdsynopsis output. Previously, that block had no spacing at all
9232     specified, which resulted it being crammed up to closely to the Synopsis
9233     head.
9234
9235     Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm) Smith
9236
9237   • Added parameters to support localization of index item punctuation.
9238
9239     Modified: fo/autoidx.xsl,1.35 - Robert Stayton
9240
9241   • Added index.number.separator, index.range.separator, and
9242     index.term.separator parameters to support localization of punctuation in
9243     index entries.
9244
9245     Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert Stayton
9246
9247   • Added "Cross References" section in HTML doc (for consistency with the FO
9248     doc). Also, moved the existing FO "Cross References" section to follow the
9249     "Linking" section.
9250
9251     Modified: fo/param.xweb,1.101; html/param.xweb,1.95 - Michael(tm) Smith
9252
9253   • Added ID attribues to all Reference elements (e.g., id="tables" for the doc
9254     for section on Table params). So pages for all subsections of ref docs now
9255     have stable filenames instead of arbitrary generated filenames.
9256
9257     Modified: fo/param.xweb,1.100; html/param.xweb,1.94 - Michael(tm) Smith
9258
9259   • Added two new parameters for handling of multi-term varlistentry elements:
9260
9261     variablelist.term.break.after: When the variablelist.term.break.after is
9262     non-zero, it will generate a line break after each term multi-term
9263     varlistentry.
9264
9265     variablelist.term.separator: When a varlistentry contains multiple term
9266     elements, the string specified in the value of the
9267     variablelist.term.separator parameter is placed after each term except the
9268     last. The default is ", " (a comma followed by a space). To suppress
9269     rendering of the separator, set the value of variablelist.term.separator to
9270     the empty string ("").
9271
9272     These parameters are primarily intended to be useful if you have multi-term
9273     varlistentries that have long terms.
9274
9275     Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
9276     long terms" doc that demonstrated the value of having these options.
9277
9278     Also, added normalize-space() call to processing of each term.
9279
9280     This change affects all output formats (HTML, PDF, manpages). The default
9281     behavior should pretty much remain the same as before, but it is possible
9282     (as always) that the change may introduce some new bugginess.
9283
9284     Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
9285     lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
9286     lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
9287     variablelist.term.break.after.xml,1.1; params/
9288     variablelist.term.separator.xml,1.1 - Michael(tm) Smith
9289
9290   • Add sidebar titlepage placeholder attset for styles.
9291
9292     Modified: fo/titlepage.xsl,1.37 - Robert Stayton
9293
9294   • Add titlepage for sidebar.
9295
9296     Modified: fo/titlepage.templates.xml,1.27 - Robert Stayton
9297
9298   • Implemented RFE #1292615.
9299
9300     Added bunch of new parameters (attribute sets) that affect list
9301     presentation: list.block.properties, itemizedlist.properties, orderedlist
9302     .properties, itemizedlist.label.properties and orderedlist.label
9303     .properties. Default behaviour of stylesheets has not been changed but
9304     further customizations will be much more easier.
9305
9306     Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; params/
9307     itemizedlist.label.properties.xml,1.1; params/
9308     itemizedlist.properties.xml,1.1; params/list.block.properties.xml,1.1;
9309     params/orderedlist.label.properties.xml,1.1; params/
9310     orderedlist.properties.xml,1.1 - Jirka Kosek
9311
9312   • Implemented RFE #1242092.
9313
9314     You can enable crop marks in your document by setting crop.marks=1 and
9315     xep.extensions=1. Appearance of crop marks can be controlled by parameters
9316     crop.mark.bleed (6pt), crop.mark.offset (24pt) and crop.mark.width (0.5pt).
9317
9318     Also there is new named template called user-xep-pis. You can overwrite it
9319     in order to produce some PIs that can control XEP as described in http://
9320     www.renderx.com/reference.html#Output_Formats
9321
9322     Modified: fo/docbook.xsl,1.36; fo/param.ent,1.86; fo/param.xweb,1.97; fo/
9323     xep.xsl,1.23; params/crop.mark.bleed.xml,1.1; params/
9324     crop.mark.offset.xml,1.1; params/crop.mark.width.xml,1.1; params/
9325     crop.marks.xml,1.1 - Jirka Kosek
9326
9327 HTML
9328
9329 The following changes have been made to the html code since the 1.69.1 release.
9330
9331   • implemented index.method parameter and three methods.
9332
9333     Modified: html/autoidx.xsl,1.28 - Robert Stayton
9334
9335   • added index.method parameter to support 3 indexing methods.
9336
9337     Modified: html/param.ent,1.94; html/param.xweb,1.103 - Robert Stayton
9338
9339   • Implemented feature request #1072510 as a processing instruction to permit
9340     including external HTML content into HTML output.
9341
9342     Modified: html/pi.xsl,1.9 - Robert Stayton
9343
9344   • Added new parameter chunk.tocs.and.lots.has.title which controls presence
9345     of title in a separate chunk with ToC/LoT. Disabling title can be very
9346     useful if you are generating frameset output (well, yes those frames, but
9347     some customers really want them ;-).
9348
9349     Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; html/
9350     param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
9351     Kosek
9352
9353   • Support dbhtml/dbfo start PI for orderedlist numbering in both HTML and FO
9354
9355     Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman Walsh
9356
9357   • Allow ToC without title also for set and book.
9358
9359     Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 - Jirka Kosek
9360
9361   • Implemented floats uniformly for figure, example, equation and
9362     informalfigure, informalexample, and informalequation.
9363
9364     Modified: html/formal.xsl,1.22 - Robert Stayton
9365
9366   • Added the autotoc.label.in.hyperlink param.
9367
9368     If the value of autotoc.label.in.hyperlink is non-zero, labels are included
9369     in hyperlinked titles in the TOC. If it is instead zero, labels are still
9370     displayed prior to the hyperlinked titles, but are not hyperlinked along
9371     with the titles.
9372
9373     Closes patch #1065868. Thanks to anatoly techtonik for the patch.
9374
9375     Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; html/
9376     param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - Michael(tm)
9377     Smith
9378
9379   • Added two new params: html.head.legalnotice.link.types and html.head.
9380     legalnotice.link.multiple.
9381
9382     If the value of the generate.legalnotice.link is non-zero, then the
9383     stylesheet generates (in the head section of the HTML source) either a
9384     single HTML link element or, if the value of the html.head.legalnotice.link
9385     .multiple is non-zero, one link element for each link type specified. Each
9386     link has the following attributes:
9387
9388     - a rel attribute whose value is derived from the value of html.head.
9389     legalnotice.link.types
9390
9391     - an href attribute whose value is set to the URL of the file containing
9392     the legalnotice
9393
9394     - a title attribute whose value is set to the title of the corresponding
9395     legalnotice (or a title programatically determined by the stylesheet)
9396
9397     For example:
9398
9399     <link rel="copyright" href="ln-id2524073.html" title="Legal Notice">
9400
9401     Closes #1476450. Thanks to Sam Steingold.
9402
9403     Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; html/
9404     param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; params/
9405     html.head.legalnotice.link.multiple.xml,1.1; params/
9406     html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith
9407
9408   • Added refclass.suppress param.
9409
9410     If the value of refclass.suppress is non-zero, then display refclass
9411     contents is suppressed in output. Affects HTML and FO output only.
9412
9413     Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html
9414     /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith
9415
9416   • Improved support for task subelements
9417
9418     Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - Jirka Kosek
9419
9420   • Added new refclass.suppress param for suppressing display of Refclass in
9421     HTML and FO output. Did not add it to manpages because manpages stylesheet
9422     is currently just silently ignoring Refclass anyway. Closes request #
9423     1461065. Thanks to Davor Ocelic (docelic) for reporting.
9424
9425     Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - Michael(tm) Smith
9426
9427   • Process alt text with normalize-space(). Replace tab indents with spaces.
9428
9429     Modified: html/graphics.xsl,1.57 - Robert Stayton
9430
9431   • Content of citation element is automatically linked to the bibliographic
9432     entry with the corresponding abbrev.
9433
9434     Modified: html/biblio.xsl,1.26; html/inline.xsl,1.47; html/xref.xsl,1.58 -
9435     Jirka Kosek
9436
9437   • Add template for task in mode="xref-to".
9438
9439     Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert Stayton
9440
9441   • Suppress ID warnings if the .warnings parameter is 0
9442
9443     Modified: html/html.xsl,1.17 - Norman Walsh
9444
9445   • Add support for floatstyle to figure.
9446
9447     Modified: html/formal.xsl,1.21 - Robert Stayton
9448
9449   • Handling of xref to area/areaset need support in extensions code also. I
9450     currently have no time to touch extensions code, so code is here to be
9451     enabled when extension is fixed also.
9452
9453     Modified: html/xref.xsl,1.56 - Jirka Kosek
9454
9455   • Added 3 parameters for overriding gentext for index punctuation.
9456
9457     Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert Stayton
9458
9459   • Added parameters to support localization of index item punctuation. Added
9460     index.separator named template to compute the separator punctuation based
9461     on locale.
9462
9463     Modified: html/autoidx.xsl,1.27 - Robert Stayton
9464
9465   • Added a <div class="{$class}-contents"> wrapper around output of contents
9466     of all formal objects. Also, added an optional <br class="{class}-break"/>
9467     linebreak after all formal objects.
9468
9469     WARNING: Because this change places an additional DIV between the DIV
9470     wrapper for the equation and the equation contents, it may break some
9471     existing CSS stylesheets that have been created with the assumption that
9472     there would never be an intervening DIV there.
9473
9474     The following is an example of what Equation output looks like as a result
9475     of the changes described above.
9476
9477     <div class="equation"> <a name="three" id="three"></a>
9478
9479     <p class="title"><b>(1.3)</b></p>
9480
9481     <div class="equation-contents"> <span class="mathphrase">1+1=3</span> </
9482     div> </div><br class="equation-break">
9483
9484     Rationale: These changes allow CSS control of the placement of the
9485     formal-object title relative to the formal-object contents. For example,
9486     using the CSS "float" property enables the title and contents to be
9487     rendered on the same line. Example stylesheet:
9488
9489     .equation { margin-top: 20px; margin-bottom: 20px; } .equation-contents {
9490     float: left; }
9491
9492     .equation .title { margin-top: 0; float: right; margin-right: 200px; }
9493
9494     .equation .title b { font-weight: normal; }
9495
9496     .equation-break { clear: both; }
9497
9498     Note that the purpose of the ".equation-break" class is to provide a way to
9499     clear off the floats.
9500
9501     If you want to instead have the equation title rendered to the left of the
9502     equation contents, you can do something like this:
9503
9504     .equation { margin-top: 20px; width: 300px; margin-bottom: 20px; }
9505     .equation-contents { float: right; }
9506
9507     .equation .title { margin-top: 0; float: left; margin-right: 200px; }
9508
9509     .equation .title b { font-weight: normal; }
9510
9511     .equation-break { clear: both; }
9512
9513     Modified: html/formal.xsl,1.20 - Michael(tm) Smith
9514
9515   • Added a chunker.output.quiet top-level parameter so that the chunker can be
9516     made quiet by default
9517
9518     Modified: html/chunker.xsl,1.26 - Norman Walsh
9519
9520   • Added support for link, olink, and xref within OO Classsynopsis and
9521     children. (Because DocBook NG/5 allows it).
9522
9523     Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith
9524
9525   • New parameter: id.warnings. If non-zero, warnings are generated for titled
9526     objects that don't have titles. True by default; I wonder if this will be
9527     too aggressive?
9528
9529     Modified: html/biblio.xsl,1.25; html/component.xsl,1.27; html/
9530     division.xsl,1.11; html/formal.xsl,1.19; html/glossary.xsl,1.20; html/
9531     html.xsl,1.13; html/index.xsl,1.16; html/param.ent,1.88; html/
9532     param.xweb,1.97; html/refentry.xsl,1.22; html/sections.xsl,1.30; params/
9533     id.warnings.xml,1.1 - Norman Walsh
9534
9535   • If the keep.relative.image.uris parameter is true, don't use the absolute
9536     URI (as calculated from xml:base) in the img src attribute, us the value
9537     the author specified. Note that we still have to calculate the absolute
9538     filename for use in the image intrinsics extension.
9539
9540     Modified: html/graphics.xsl,1.56 - Norman Walsh
9541
9542   • Support date as an inline
9543
9544     Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh
9545
9546   • Added new parameter keep.relative.image.uris
9547
9548     Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html
9549     /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh
9550
9551   • Added two new parameters for handling of multi-term varlistentry elements:
9552
9553     variablelist.term.break.after: When the variablelist.term.break.after is
9554     non-zero, it will generate a line break after each term multi-term
9555     varlistentry.
9556
9557     variablelist.term.separator: When a varlistentry contains multiple term
9558     elements, the string specified in the value of the
9559     variablelist.term.separator parameter is placed after each term except the
9560     last. The default is ", " (a comma followed by a space). To suppress
9561     rendering of the separator, set the value of variablelist.term.separator to
9562     the empty string ("").
9563
9564     These parameters are primarily intended to be useful if you have multi-term
9565     varlistentries that have long terms.
9566
9567     Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
9568     long terms" doc that demonstrated the value of having these options.
9569
9570     Also, added normalize-space() call to processing of each term.
9571
9572     This change affects all output formats (HTML, PDF, manpages). The default
9573     behavior should pretty much remain the same as before, but it is possible
9574     (as always) that the change may introduce some new bugginess.
9575
9576     Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
9577     lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
9578     lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
9579     variablelist.term.break.after.xml,1.1; params/
9580     variablelist.term.separator.xml,1.1 - Michael(tm) Smith
9581
9582   • Added "wrapper-name" param to inline.charseq named template, enabling it to
9583     output inlines other than just "span". Acronym and Abbrev templates now use
9584     inline.charseq to output HTML "acronym" and "abbr" elements (instead of
9585     "span"). Closes #1305468. Thanks to Sam Steingold for suggesting the
9586     change.
9587
9588     Modified: html/inline.xsl,1.45 - Michael(tm) Smith
9589
9590 Manpages
9591
9592 The following changes have been made to the manpages code since the 1.69.1
9593 release.
9594
9595   • Added the following params:
9596
9597     - man.indent.width (string-valued) - man.indent.refsect (boolean) -
9598     man.indent.blurbs (boolean) - man.indent.lists (boolean) -
9599     man.indent.verbatims (boolean)
9600
9601     Note that in earlier snapshots, man.indent.width was named
9602     man.indentation.default.value and the boolean params had names like
9603     man.indentation.*.adjust. Also the man.indent.blurbs param was called
9604     man.indentation.authors.adjust (or something).
9605
9606     The behavior now is: If the value of a particular man.indent.* boolean
9607     param is non-zero, the corresponding contents (refsect*, list items,
9608     authorblurb/personblurb, vervatims) are displayed with a left margin
9609     indented by a width equal to the value of man.indent.width.
9610
9611     Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74;
9612     manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
9613     manpages/param.ent,1.22; manpages/param.xweb,1.24; manpages/
9614     refentry.xsl,1.14; params/man.indent.lists.xml,1.1; params/
9615     man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; params/
9616     man.indent.width.xml,1.1 - Michael(tm) Smith
9617
9618   • Added man.table.footnotes.divider param.
9619
9620     In each table that contains footenotes, the string specified by the man.
9621     table.footnotes.divider parameter is output before the list of footnotes
9622     for the table.
9623
9624     Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; manpages/
9625     param.ent,1.21; manpages/param.xweb,1.23; params/
9626     man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith
9627
9628   • Added the man.output.in.separate.dir, man.output.base.dir, and
9629     man.output.subdirs.enabled parameters.
9630
9631     The man.output.base.dir parameter specifies the base directory into which
9632     man-page files are output. The man.output.subdirs.enabled parameter
9633     controls whether the files are output in subdirectories within the base
9634     directory.
9635
9636     The values of the man.output.base.dir and man.output.subdirs.enabled
9637     parameters are used only if the value of man.output.in.separate.dir
9638     parameter is non-zero. If the value of man.output.in.separate.dir is zero,
9639     man-page files are not output in a separate directory.
9640
9641     Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; manpages/
9642     param.xweb,1.22; params/man.output.base.dir.xml,1.1; params/
9643     man.output.in.separate.dir.xml,1.1; params/
9644     man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith
9645
9646   • Added man.font.table.headings and man.font.table.title params, for
9647     controlling font in table headings and titles.
9648
9649     Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; manpages/
9650     param.xweb,1.21; params/man.font.table.headings.xml,1.1; params/
9651     man.font.table.title.xml,1.1 - Michael(tm) Smith
9652
9653   • Added man.font.funcsynopsisinfo and man.font.funcprototype params, for
9654     specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and
9655     funcprototype output.
9656
9657     Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; manpages/
9658     param.ent,1.18; manpages/param.xweb,1.20; manpages/synop.xsl,1.29; manpages
9659     /table.xsl,1.21; params/man.font.funcprototype.xml,1.1; params/
9660     man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith
9661
9662   • Added man.segtitle.suppress param.
9663
9664     If the value of man.segtitle.suppress is non-zero, then display of segtitle
9665     contents is suppressed in output.
9666
9667     Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; manpages/
9668     param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - Michael(tm) Smith
9669
9670   • Added man.output.manifest.enabled and man.output.manifest.filename params.
9671
9672     If man.output.manifest.enabled is non-zero, a list of filenames for man
9673     pages generated by the stylesheet transformation is written to the file
9674     named by man.output.manifest.filename
9675
9676     Modified: manpages/docbook.xsl,1.67; manpages/other.xsl,1.19; manpages/
9677     param.ent,1.16; manpages/param.xweb,1.18; params/
9678     man.output.manifest.enabled.xml,1.1; params/
9679     man.output.manifest.filename.xml,1.1; tools/make/Makefile.DocBook,1.4 -
9680     Michael(tm) Smith
9681
9682   • Added refentry.meta.get.quietly param.
9683
9684     If zero (the default), notes and warnings about "missing" markup are
9685     generated during gathering of refentry metadata. If non-zero, the metadata
9686     is gathered "quietly" -- that is, the notes and warnings are suppressed.
9687
9688     NOTE: If you are processing a large amount of refentry content, you may be
9689     able to speed up processing significantly by setting a non-zero value for
9690     refentry.meta.get.quietly.
9691
9692     Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/
9693     param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
9694     Smith
9695
9696   • Changed names of all boolean indentation params to man.indent.* Also
9697     discarded individual man.indent.*.value params and switched to just using a
9698     common man.indent.width param (3n by default).
9699
9700     Modified: manpages/docbook.xsl,1.66; manpages/info.xsl,1.19; manpages/
9701     lists.xsl,1.29; manpages/other.xsl,1.18; manpages/refentry.xsl,1.13 -
9702     Michael(tm) Smith
9703
9704   • Added boolean man.output.in.separate.dir param, to control whether or not
9705     man files are output in separate directory.
9706
9707     Modified: manpages/docbook.xsl,1.65; manpages/utility.xsl,1.14 - Michael
9708     (tm) Smith
9709
9710   • Added options for controlling indentation of verbatim output. Controlled
9711     through the man.indentation.verbatims.adjust and
9712     man.indentation.verbatims.value params. Closes #1242997
9713
9714     Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 - Michael(tm)
9715     Smith
9716
9717   • Added options for controlling indentation in lists and in *blurb output in
9718     the AUTHORS section. Controlled through the man.indentation.lists.adjust,
9719     man.indentation.lists.value, man.indentation.authors.adjust, and
9720     man.indentation.authors.value parameters. Default is 3 characters (instead
9721     of the roff default of 8 characters). Closes #1449369.
9722
9723     Also, removed the indent that was being set on informalexample outuput. I
9724     will instead add an option for indenting verbatims, which I think is what
9725     the informalexample indent was intended for originally.
9726
9727     Modified: manpages/block.xsl,1.14; manpages/docbook.xsl,1.63; manpages/
9728     info.xsl,1.18; manpages/lists.xsl,1.28 - Michael(tm) Smith
9729
9730   • Changed line-spacing call before synopfragment to use ".sp -1n" ("n" units
9731     specified) instead of plain ".sp -1"
9732
9733     Modified: manpages/synop.xsl,1.28 - Michael(tm) Smith
9734
9735   • Added support for writing man files into a specific output directory and
9736     into appropriate subdirectories within that output directory. Controlled
9737     through the man.base.dir parameter (similar to the base.dir support in the
9738     HTML stylesheet) and the man.subdirs.enabled parameter, which automatically
9739     determines the name of an appropriate subdir (for example, man/man7, man/
9740     man1, etc.) based on the section number/manvolnum of the source Refentry.
9741
9742     Closes #1255036 and #1170317. Thanks to Denis Bradford for the original
9743     feature request, and to Costin Stroie for submitting a patch that was very
9744     helpful in implementing the support.
9745
9746     Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 - Michael
9747     (tm) Smith
9748
9749   • Refined XPath statements and notification messages for refentry metadata
9750     handling.
9751
9752     Modified: common/common.xsl,1.59; common/refentry.xsl,1.14; manpages/
9753     docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm) Smith
9754
9755   • Added support for copyright and legalnotice. The manpages stylesheets now
9756     output a COPYRIGHT section, after the AUTHORS section, if a copyright or
9757     legalnotice is found in the source. The section contains the copyright
9758     contents followed by the legalnotice contents. Closes #1450209.
9759
9760     Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 - Michael(tm)
9761     Smith
9762
9763   • Drastically reworked all of the XPath expressions used in refentry metadata
9764     gathering -- completely removed $parentinfo and turned $info into a set of
9765     nodes that includes the *info contents of the Refentry plus the *info
9766     contents all all of its ancestor elements. The basic XPath expression now
9767     used throughout is (using the example of checking for a date):
9768
9769     (($info[//date])[last()]/date)[1].
9770
9771     That selects the "last" *info/date date in document order -- that is, the
9772     one eitther on the Refentry itself or on the closest ancestor to the
9773     Refentry.
9774
9775     It's likely this change may break some things; may need to pick up some
9776     pieces later.
9777
9778     Also, changed the default value for the man.th.extra2.max.length from 40 to
9779     30.
9780
9781     Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; params/
9782     man.th.extra2.max.length.xml,1.2; params/refentry.date.profile.xml,1.2;
9783     params/refentry.manual.profile.xml,1.2; params/
9784     refentry.source.name.profile.xml,1.2; params/
9785     refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; manpages/
9786     other.xsl,1.15 - Michael(tm) Smith
9787
9788   • Added support for DocBook 5 namespace-stripping in manpages stylesheet.
9789     Closes request #1210692.
9790
9791     Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm)
9792     Smith
9793
9794   • Fixed handling of table footnotes. With this checkin, the table support in
9795     the manpages stylesheet is now basically feature complete. So this change
9796     closes request #619532, "No support for tables" -- the oldest currently
9797     open manpages feature request, submitted by Ben Secrest (blsecres) on
9798     2002-10-07. Congratulations to me [patting myself on the back].
9799
9800     Modified: manpages/block.xsl,1.11; manpages/docbook.xsl,1.55; manpages/
9801     table.xsl,1.15 - Michael(tm) Smith
9802
9803   • Added handling for table titles. Also fixed handling of nested tables; nest
9804     tables are now "extracted" and displayed just after their parent tables.
9805
9806     Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14 - Michael(tm)
9807     Smith
9808
9809   • Added option for turning off bold formatting in Funcsynopsis. Boldface
9810     formatting in function synopsis is mandated in the man(7) man page and is
9811     used almost universally in existing man pages. Despite that, it really does
9812     look like crap to have an entire Funcsynopsis output in bold, so I added
9813     params for turning off the bold formatting and/or replacing it with a
9814     different roff special font (e.g., "RI" for alternating roman/italic
9815     instead of the default "BI" for alternating bold/italic). The new params
9816     are "man.funcprototype.font" and "man.funcsynopsisinfo.font". To be
9817     documented later.
9818
9819     Closes #1452247. Thanks to Joe Orton for the feature request.
9820
9821     Modified: params/man.string.subst.map.xml,1.16; manpages/block.xsl,1.10;
9822     manpages/docbook.xsl,1.51; manpages/inline.xsl,1.16; manpages/
9823     synop.xsl,1.27 - Michael(tm) Smith
9824
9825   • Use AUTHORS instead of AUTHOR if we have multiple people to attribute.
9826     Also, fixed checking such that we generate author section even if we don't
9827     have an author (as long as there is at least one other person/entity we can
9828     put in the section). Also adjusted assembly of content for Author metainfo
9829     field such that we now not only use author, but try to find a "best match"
9830     if we can't find an author name to put there.
9831
9832     Closes #1233592. Thanks to Sam Steingold for the request.
9833
9834     Modified: manpages/info.xsl,1.12 - Michael(tm) Smith
9835
9836   • Changes for request #1243027, "Impove handling of AUTHOR section." This
9837     adds support for Collab, Corpauthor, Corpcredt, Orgname, Publishername, and
9838     Publisher. Also adds support for output of Affiliation and its children,
9839     and support for using gentext strings for auto-attributing roles (Author,
9840     Editor, Publisher, Translator, etc.). Also did a lot of code cleanup and
9841     modularization of all the AUTHOR handling code. And fixed a bug that was
9842     causing Author info to not be picked up correctly for metainfo comment we
9843     embed in man-page source.
9844
9845     Modified: manpages/info.xsl,1.11 - Michael(tm) Smith
9846
9847   • Support bold output for "emphasis remap='B'". (because Eric Raymond's
9848     doclifter(1) tool converts groff source marked up with ".B" request or "\
9849     fB" escapes to DocBook "emphasis remap='B'".)
9850
9851     Modified: manpages/inline.xsl,1.14 - Michael(tm) Smith
9852
9853   • Added support for Segmentedlist. Details: Output is tabular, with no option
9854     for "list" type output. Output for Segtitle elements can be supressed by
9855     setting man.segtitle.suppress. If Segtitle content is output, it is
9856     rendered in italic type (not bold because not all terminals support bold
9857     and so italic ensures the stand out on those terminals). Extra space (.sp
9858     line) at end of table code ensures that it gets handled correctly in the
9859     case where its source is the child of a Para. Closes feature-request #
9860     1400097. Thanks to Daniel Leidert for the patch and push, and to Alastair
9861     Rankine for filing the original feature request.
9862
9863     Modified: manpages/lists.xsl,1.23; manpages/utility.xsl,1.10 - Michael(tm)
9864     Smith
9865
9866   • Improved handling or Author/Editor/Othercredit.
9867
9868     Reworked content of (non-visible) comment added at top of each page
9869     (metadata stuff).
9870
9871     Added support for generating a manifest file (useful for cleaning up after
9872     builds, etc.)
9873
9874     Modified: manpages/docbook.xsl,1.46; manpages/info.xsl,1.9; manpages/
9875     other.xsl,1.12; manpages/utility.xsl,1.6 - Michael(tm) Smith
9876
9877   • Added two new parameters for handling of multi-term varlistentry elements:
9878
9879     variablelist.term.break.after: When the variablelist.term.break.after is
9880     non-zero, it will generate a line break after each term multi-term
9881     varlistentry.
9882
9883     variablelist.term.separator: When a varlistentry contains multiple term
9884     elements, the string specified in the value of the
9885     variablelist.term.separator parameter is placed after each term except the
9886     last. The default is ", " (a comma followed by a space). To suppress
9887     rendering of the separator, set the value of variablelist.term.separator to
9888     the empty string ("").
9889
9890     These parameters are primarily intended to be useful if you have multi-term
9891     varlistentries that have long terms.
9892
9893     Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
9894     long terms" doc that demonstrated the value of having these options.
9895
9896     Also, added normalize-space() call to processing of each term.
9897
9898     This change affects all output formats (HTML, PDF, manpages). The default
9899     behavior should pretty much remain the same as before, but it is possible
9900     (as always) that the change may introduce some new bugginess.
9901
9902     Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
9903     lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
9904     lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
9905     variablelist.term.break.after.xml,1.1; params/
9906     variablelist.term.separator.xml,1.1 - Michael(tm) Smith
9907
9908 Params
9909
9910 The following changes have been made to the params code since the 1.69.1
9911 release.
9912
9913   • New parameters to set header/footer table minimum height.
9914
9915     Modified: params/footer.table.height.xml,1.1; params/
9916     header.table.height.xml,1.1 - Robert Stayton
9917
9918   • Support multiple indexing methods for different languages.
9919
9920     Modified: params/index.method.xml,1.1 - Robert Stayton
9921
9922   • Remove qandaset and qandadiv from generate.toc for fo output because
9923     formerly it wasn't working, but now it is and the default behavior should
9924     stay the same.
9925
9926     Modified: params/generate.toc.xml,1.8 - Robert Stayton
9927
9928   • add support for page number references to link element too.
9929
9930     Modified: params/insert.link.page.number.xml,1.1 - Robert Stayton
9931
9932   • Add support for more characters to hyphen on when ulink.hyphenate is turned
9933     on.
9934
9935     Modified: params/ulink.hyphenate.chars.xml,1.1; params/
9936     ulink.hyphenate.xml,1.3 - Robert Stayton
9937
9938   • New attribute-set to format biblioentry and bibliomixed.
9939
9940     Modified: params/biblioentry.properties.xml,1.1 - Robert Stayton
9941
9942   • Added new parameter chunk.tocs.and.lots.has.title which controls presence
9943     of title in a separate chunk with ToC/LoT. Disabling title can be very
9944     useful if you are generating frameset output (well, yes those frames, but
9945     some customers really want them ;-).
9946
9947     Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; html/
9948     param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka
9949     Kosek
9950
9951   • Added new attribute set toc.line.properties for controlling appearance of
9952     lines in ToC/LoT
9953
9954     Modified: params/toc.line.properties.xml,1.1 - Jirka Kosek
9955
9956   • Allow table footnotes to have different properties from regular footnotes.
9957
9958     Modified: params/table.footnote.properties.xml,1.1 - Robert Stayton
9959
9960   • Set properties for pgwide="1" objects.
9961
9962     Modified: params/pgwide.properties.xml,1.1 - Robert Stayton
9963
9964   • Added the autotoc.label.in.hyperlink param.
9965
9966     If the value of autotoc.label.in.hyperlink is non-zero, labels are included
9967     in hyperlinked titles in the TOC. If it is instead zero, labels are still
9968     displayed prior to the hyperlinked titles, but are not hyperlinked along
9969     with the titles.
9970
9971     Closes patch #1065868. Thanks to anatoly techtonik for the patch.
9972
9973     Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; html/
9974     param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - Michael(tm)
9975     Smith
9976
9977   • Added two new params: html.head.legalnotice.link.types and html.head.
9978     legalnotice.link.multiple.
9979
9980     If the value of the generate.legalnotice.link is non-zero, then the
9981     stylesheet generates (in the head section of the HTML source) either a
9982     single HTML link element or, if the value of the html.head.legalnotice.link
9983     .multiple is non-zero, one link element for each link type specified. Each
9984     link has the following attributes:
9985
9986     - a rel attribute whose value is derived from the value of html.head.
9987     legalnotice.link.types
9988
9989     - an href attribute whose value is set to the URL of the file containing
9990     the legalnotice
9991
9992     - a title attribute whose value is set to the title of the corresponding
9993     legalnotice (or a title programatically determined by the stylesheet)
9994
9995     For example:
9996
9997     <link rel="copyright" href="ln-id2524073.html" title="Legal Notice">
9998
9999     Closes #1476450. Thanks to Sam Steingold.
10000
10001     Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; html/
10002     param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; params/
10003     html.head.legalnotice.link.multiple.xml,1.1; params/
10004     html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith
10005
10006   • Added the following params:
10007
10008     - man.indent.width (string-valued) - man.indent.refsect (boolean) -
10009     man.indent.blurbs (boolean) - man.indent.lists (boolean) -
10010     man.indent.verbatims (boolean)
10011
10012     Note that in earlier snapshots, man.indent.width was named
10013     man.indentation.default.value and the boolean params had names like
10014     man.indentation.*.adjust. Also the man.indent.blurbs param was called
10015     man.indentation.authors.adjust (or something).
10016
10017     The behavior now is: If the value of a particular man.indent.* boolean
10018     param is non-zero, the corresponding contents (refsect*, list items,
10019     authorblurb/personblurb, vervatims) are displayed with a left margin
10020     indented by a width equal to the value of man.indent.width.
10021
10022     Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74;
10023     manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20;
10024     manpages/param.ent,1.22; manpages/param.xweb,1.24; manpages/
10025     refentry.xsl,1.14; params/man.indent.lists.xml,1.1; params/
10026     man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; params/
10027     man.indent.width.xml,1.1 - Michael(tm) Smith
10028
10029   • Added man.table.footnotes.divider param.
10030
10031     In each table that contains footenotes, the string specified by the man.
10032     table.footnotes.divider parameter is output before the list of footnotes
10033     for the table.
10034
10035     Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; manpages/
10036     param.ent,1.21; manpages/param.xweb,1.23; params/
10037     man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith
10038
10039   • Added the man.output.in.separate.dir, man.output.base.dir, and
10040     man.output.subdirs.enabled parameters.
10041
10042     The man.output.base.dir parameter specifies the base directory into which
10043     man-page files are output. The man.output.subdirs.enabled parameter
10044     controls whether the files are output in subdirectories within the base
10045     directory.
10046
10047     The values of the man.output.base.dir and man.output.subdirs.enabled
10048     parameters are used only if the value of man.output.in.separate.dir
10049     parameter is non-zero. If the value of man.output.in.separate.dir is zero,
10050     man-page files are not output in a separate directory.
10051
10052     Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; manpages/
10053     param.xweb,1.22; params/man.output.base.dir.xml,1.1; params/
10054     man.output.in.separate.dir.xml,1.1; params/
10055     man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith
10056
10057   • Added man.font.table.headings and man.font.table.title params, for
10058     controlling font in table headings and titles.
10059
10060     Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; manpages/
10061     param.xweb,1.21; params/man.font.table.headings.xml,1.1; params/
10062     man.font.table.title.xml,1.1 - Michael(tm) Smith
10063
10064   • Added man.font.funcsynopsisinfo and man.font.funcprototype params, for
10065     specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and
10066     funcprototype output.
10067
10068     Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; manpages/
10069     param.ent,1.18; manpages/param.xweb,1.20; manpages/synop.xsl,1.29; manpages
10070     /table.xsl,1.21; params/man.font.funcprototype.xml,1.1; params/
10071     man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith
10072
10073   • Changed to select="0" in refclass.suppress (instead of ..>0</..)
10074
10075     Modified: params/refclass.suppress.xml,1.3 - Michael(tm) Smith
10076
10077   • Added man.segtitle.suppress param.
10078
10079     If the value of man.segtitle.suppress is non-zero, then display of segtitle
10080     contents is suppressed in output.
10081
10082     Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; manpages/
10083     param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - Michael(tm) Smith
10084
10085   • Added man.output.manifest.enabled and man.output.manifest.filename params.
10086
10087     If man.output.manifest.enabled is non-zero, a list of filenames for man
10088     pages generated by the stylesheet transformation is written to the file
10089     named by man.output.manifest.filename
10090
10091     Modified: manpages/docbook.xsl,1.67; manpages/other.xsl,1.19; manpages/
10092     param.ent,1.16; manpages/param.xweb,1.18; params/
10093     man.output.manifest.enabled.xml,1.1; params/
10094     man.output.manifest.filename.xml,1.1; tools/make/Makefile.DocBook,1.4 -
10095     Michael(tm) Smith
10096
10097   • Added refclass.suppress param.
10098
10099     If the value of refclass.suppress is non-zero, then display refclass
10100     contents is suppressed in output. Affects HTML and FO output only.
10101
10102     Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; html
10103     /param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith
10104
10105   • Added refentry.meta.get.quietly param.
10106
10107     If zero (the default), notes and warnings about "missing" markup are
10108     generated during gathering of refentry metadata. If non-zero, the metadata
10109     is gathered "quietly" -- that is, the notes and warnings are suppressed.
10110
10111     NOTE: If you are processing a large amount of refentry content, you may be
10112     able to speed up processing significantly by setting a non-zero value for
10113     refentry.meta.get.quietly.
10114
10115     Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; manpages/
10116     param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - Michael(tm)
10117     Smith
10118
10119   • Added support for "software" and "sectdesc" class values on refmiscinfo;
10120     "software" is treated identically to "source", and "setdesc" is treated
10121     identically to "manual".
10122
10123     Modified: common/refentry.xsl,1.10; params/
10124     man.th.extra2.max.length.xml,1.3; params/
10125     refentry.source.name.profile.xml,1.4 - Michael(tm) Smith
10126
10127   • Drastically reworked all of the XPath expressions used in refentry metadata
10128     gathering -- completely removed $parentinfo and turned $info into a set of
10129     nodes that includes the *info contents of the Refentry plus the *info
10130     contents all all of its ancestor elements. The basic XPath expression now
10131     used throughout is (using the example of checking for a date):
10132
10133     (($info[//date])[last()]/date)[1].
10134
10135     That selects the "last" *info/date date in document order -- that is, the
10136     one eitther on the Refentry itself or on the closest ancestor to the
10137     Refentry.
10138
10139     It's likely this change may break some things; may need to pick up some
10140     pieces later.
10141
10142     Also, changed the default value for the man.th.extra2.max.length from 40 to
10143     30.
10144
10145     Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; params/
10146     man.th.extra2.max.length.xml,1.2; params/refentry.date.profile.xml,1.2;
10147     params/refentry.manual.profile.xml,1.2; params/
10148     refentry.source.name.profile.xml,1.2; params/
10149     refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; manpages/
10150     other.xsl,1.15 - Michael(tm) Smith
10151
10152   • Added option for turning off bold formatting in Funcsynopsis. Boldface
10153     formatting in function synopsis is mandated in the man(7) man page and is
10154     used almost universally in existing man pages. Despite that, it really does
10155     look like crap to have an entire Funcsynopsis output in bold, so I added
10156     params for turning off the bold formatting and/or replacing it with a
10157     different roff special font (e.g., "RI" for alternating roman/italic
10158     instead of the default "BI" for alternating bold/italic). The new params
10159     are "man.funcprototype.font" and "man.funcsynopsisinfo.font". To be
10160     documented later.
10161
10162     Closes #1452247. Thanks to Joe Orton for the feature request.
10163
10164     Modified: params/man.string.subst.map.xml,1.16; manpages/block.xsl,1.10;
10165     manpages/docbook.xsl,1.51; manpages/inline.xsl,1.16; manpages/
10166     synop.xsl,1.27 - Michael(tm) Smith
10167
10168   • fop.extensions now only for FOP version 0.20.5 and earlier.
10169
10170     Modified: params/fop.extensions.xml,1.4 - Robert Stayton
10171
10172   • Support for fop1 different from fop 0.20.5 and earlier.
10173
10174     Modified: params/fop1.extensions.xml,1.1 - Robert Stayton
10175
10176   • Reset default value to empty string so template uses gentext first, then
10177     the parameter value if not empty.
10178
10179     Modified: params/index.number.separator.xml,1.2; params/
10180     index.range.separator.xml,1.2; params/index.term.separator.xml,1.2 - Robert
10181     Stayton
10182
10183   • New parameter: id.warnings. If non-zero, warnings are generated for titled
10184     objects that don't have titles. True by default; I wonder if this will be
10185     too aggressive?
10186
10187     Modified: html/biblio.xsl,1.25; html/component.xsl,1.27; html/
10188     division.xsl,1.11; html/formal.xsl,1.19; html/glossary.xsl,1.20; html/
10189     html.xsl,1.13; html/index.xsl,1.16; html/param.ent,1.88; html/
10190     param.xweb,1.97; html/refentry.xsl,1.22; html/sections.xsl,1.30; params/
10191     id.warnings.xml,1.1 - Norman Walsh
10192
10193   • Added new parameter keep.relative.image.uris
10194
10195     Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; html
10196     /param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman Walsh
10197
10198   • Support default label width parameters for itemized and ordered lists
10199
10200     Modified: fo/lists.xsl,1.64; fo/param.ent,1.90; fo/param.xweb,1.103; params
10201     /itemizedlist.label.width.xml,1.1; params/orderedlist.label.width.xml,1.1 -
10202     Norman Walsh
10203
10204   • Added parameters to localize punctuation in indexes.
10205
10206     Modified: params/index.number.separator.xml,1.1; params/
10207     index.range.separator.xml,1.1; params/index.term.separator.xml,1.1 - Robert
10208     Stayton
10209
10210   • Added two new parameters for handling of multi-term varlistentry elements:
10211
10212     variablelist.term.break.after: When the variablelist.term.break.after is
10213     non-zero, it will generate a line break after each term multi-term
10214     varlistentry.
10215
10216     variablelist.term.separator: When a varlistentry contains multiple term
10217     elements, the string specified in the value of the
10218     variablelist.term.separator parameter is placed after each term except the
10219     last. The default is ", " (a comma followed by a space). To suppress
10220     rendering of the separator, set the value of variablelist.term.separator to
10221     the empty string ("").
10222
10223     These parameters are primarily intended to be useful if you have multi-term
10224     varlistentries that have long terms.
10225
10226     Closes #1306676. Thanks to Sam Steingold for providing an example "lots of
10227     long terms" doc that demonstrated the value of having these options.
10228
10229     Also, added normalize-space() call to processing of each term.
10230
10231     This change affects all output formats (HTML, PDF, manpages). The default
10232     behavior should pretty much remain the same as before, but it is possible
10233     (as always) that the change may introduce some new bugginess.
10234
10235     Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; html/
10236     lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; manpages/
10237     lists.xsl,1.22; manpages/param.ent,1.14; manpages/param.xweb,1.16; params/
10238     variablelist.term.break.after.xml,1.1; params/
10239     variablelist.term.separator.xml,1.1 - Michael(tm) Smith
10240
10241   • Convert 'no' to string in default value.
10242
10243     Modified: params/olink.doctitle.xml,1.4 - Robert Stayton
10244
10245   • Implemented RFE #1292615.
10246
10247     Added bunch of new parameters (attribute sets) that affect list
10248     presentation: list.block.properties, itemizedlist.properties, orderedlist
10249     .properties, itemizedlist.label.properties and orderedlist.label
10250     .properties. Default behaviour of stylesheets has not been changed but
10251     further customizations will be much more easier.
10252
10253     Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; params/
10254     itemizedlist.label.properties.xml,1.1; params/
10255     itemizedlist.properties.xml,1.1; params/list.block.properties.xml,1.1;
10256     params/orderedlist.label.properties.xml,1.1; params/
10257     orderedlist.properties.xml,1.1 - Jirka Kosek
10258
10259   • Implemented RFE #1242092.
10260
10261     You can enable crop marks in your document by setting crop.marks=1 and
10262     xep.extensions=1. Appearance of crop marks can be controlled by parameters
10263     crop.mark.bleed (6pt), crop.mark.offset (24pt) and crop.mark.width (0.5pt).
10264
10265     Also there is new named template called user-xep-pis. You can overwrite it
10266     in order to produce some PIs that can control XEP as described in http://
10267     www.renderx.com/reference.html#Output_Formats
10268
10269     Modified: fo/docbook.xsl,1.36; fo/param.ent,1.86; fo/param.xweb,1.97; fo/
10270     xep.xsl,1.23; params/crop.mark.bleed.xml,1.1; params/
10271     crop.mark.offset.xml,1.1; params/crop.mark.width.xml,1.1; params/
10272     crop.marks.xml,1.1 - Jirka Kosek
10273
10274   • Changed short descriptions in doc for *autolabel* params to match new
10275     autolabel behavior.
10276
10277     Modified: params/appendix.autolabel.xml,1.5; params/
10278     chapter.autolabel.xml,1.4; params/part.autolabel.xml,1.5; params/
10279     preface.autolabel.xml,1.4 - Michael(tm) Smith
10280
10281 Profiling
10282
10283 The following changes have been made to the profiling code since the 1.69.1
10284 release.
10285
10286   • Profiling now works together with namespace stripping (V5 documents).
10287     Namespace striping should work with all stylesheets named profile-, even if
10288     they are not supporting namespace stripping in a non-profiling variant.
10289
10290     Modified: profiling/profile-mode.xsl,1.4; profiling/xsl2profile.xsl,1.7 -
10291     Jirka Kosek
10292
10293   • Moved profiling stage out of templates. This make possible to reuse
10294     profiled content by several templates and still maintaing node indentity
10295     (needed for example for HTML Help where content is processed multiple
10296     times).
10297
10298     I don't know why this was not on the top level before. Maybe some XSLT
10299     processors choked on it. I hope this will be OK now.
10300
10301     Modified: profiling/xsl2profile.xsl,1.5 - Jirka Kosek
10302
10303 Tools
10304
10305 The following changes have been made to the tools code since the 1.69.1
10306 release.
10307
10308   • Moved Makefile.DocBook from contrib module to xsl module.
10309
10310     Modified: tools/make/Makefile.DocBook,1.1 - Michael(tm) Smith
10311
10312 WordML
10313
10314 The following changes have been made to the wordml code since the 1.69.1
10315 release.
10316
10317   • added contrib element, better handling of default paragraph style
10318
10319     Modified: wordml/pages-normalise.xsl,1.6; wordml/supported.xml,1.2; wordml/
10320     wordml-final.xsl,1.14 - Steve Ball
10321
10322   • added bridgehead
10323
10324     Modified: wordml/docbook-pages.xsl,1.6; wordml/docbook.xsl,1.17; wordml/
10325     pages-normalise.xsl,1.5; wordml/template-pages.xml,1.7; wordml/
10326     template.dot,1.4; wordml/template.xml,1.14; wordml/wordml-final.xsl,1.13 -
10327     Steve Ball
10328
10329   • added blocks stylesheet to support bibliographies, glossaries and qandasets
10330
10331     Modified: wordml/Makefile,1.4; wordml/README,1.3; wordml/
10332     blocks-spec.xml,1.1; wordml/docbook-pages.xsl,1.5; wordml/docbook.xsl,1.16;
10333     wordml/pages-normalise.xsl,1.4; wordml/sections-spec.xml,1.3; wordml/
10334     specifications.xml,1.13; wordml/template-pages.xml,1.6; wordml/
10335     template.dot,1.3; wordml/template.xml,1.13; wordml/wordml-blocks.xsl,1.1;
10336     wordml/wordml-final.xsl,1.12; wordml/wordml-sections.xsl,1.3 - Steve Ball
10337
10338   • added mediaobject caption
10339
10340     Modified: wordml/docbook-pages.xsl,1.4; wordml/docbook.xsl,1.15; wordml/
10341     specifications.xml,1.12; wordml/template-pages.xml,1.5; wordml/
10342     template.dot,1.2; wordml/template.xml,1.12; wordml/wordml-final.xsl,1.11 -
10343     Steve Ball
10344
10345   • added callouts
10346
10347     Modified: wordml/docbook-pages.xsl,1.3; wordml/docbook.xsl,1.14; wordml/
10348     pages-normalise.xsl,1.3; wordml/specifications.xml,1.11; wordml/
10349     template-pages.xml,1.4; wordml/wordml-final.xsl,1.10 - Steve Ball
10350
10351   • added Word template file
10352
10353     Modified: wordml/template.dot,1.1 - Steve Ball
10354
10355   • added abstract, fixed itemizedlist, ulink
10356
10357     Modified: wordml/specifications.xml,1.10; wordml/wordml-final.xsl,1.9 -
10358     Steve Ball
10359
10360   • fixed Makefile added many features to Pages support added revhistory,
10361     inlines, highlights, abstract
10362
10363     Modified: wordml/Makefile,1.2; wordml/docbook-pages.xsl,1.2; wordml/
10364     pages-normalise.xsl,1.2; wordml/sections-spec.xml,1.2; wordml/
10365     specifications.xml,1.9; wordml/template-pages.xml,1.3; wordml/
10366     template.xml,1.11; wordml/wordml-final.xsl,1.8; wordml/
10367     wordml-sections.xsl,1.2 - Steve Ball
10368
10369   • fixed handling linebreaks when generating WordML added Apple Pages support
10370
10371     Modified: wordml/docbook.xsl,1.13; wordml/template-pages.xml,1.2 - Steve
10372     Ball
10373
10374 Release 1.69.1
10375
10376 This release is a minor bug-fix update to the 1.69.0 release. Along with bug
10377 fixes, it includes one configuration-parameter change: The default value of the
10378 annotation.support parameter is now 0 (off). The reason for that change is that
10379 there have been reports that annotation handling is causing a significant
10380 performance degradation in processing of large documents with xsltproc.
10381
10382 Release 1.69.0
10383
10384 The release includes major feature changes, particularly in the manpages
10385 stylesheets, as well as a large number of bug fixes.
10386
10387 As with all DocBook Project “dot zero” releases, this is an experimental
10388 release .
10389
10390 Common
10391
10392   • This release adds localizations for the following languages: Albanian,
10393     Amharic, Azerbaijani, Hindi, Irish (Gaelic), Gujarati, Kannada, Mongolian,
10394     Oriya, Punjabi, Tagalog, Tamil, and Welsh.
10395
10396   • Added support for specifying number format for auto labels for chapter,
10397     appendix, part, and preface. Contolled with the appendix.autolabel,
10398     chapter.autolabel, part.autolabel, and preface.autolabel parameters.
10399
10400   • Added basic support for biblioref cross referencing.
10401
10402   • Added support for align on caption in mediaobject.
10403
10404   • Added support for processing documents that use the DocBook V5 namespace.
10405
10406   • Added support for termdef and mathphrase.
10407
10408   • EXPERIMENTAL: Incorporated the Slides and Website stylesheets into the
10409     DocBook XSL stylesheets package. So, for example, Website documents can now
10410     be processed using the following URI for the driver Website tabular.xsl
10411     file:
10412
10413     http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl
10414
10415   • A procedure without a title is now treated as an “informal” procedure
10416     (meaning that it is not added to any generated “list of procedures” and has
10417     no affect on numbering of generated labels for other procedures).
10418
10419   • docname is no longer added to olink when pointing to a root element.
10420
10421   • Added support for generation of choice separator in inline simplelist. This
10422     enables auto-generation of an appropriate localized “choice separator” (for
10423     example, “and” or “or”) before the final item in an inline simplelist.
10424
10425     To indicate that you want a choice separator generated for a particular
10426     list, you need to put a processing instruction (PI) of the form <?
10427     dbchoice choice="foo"?> as a child of the list. For example:
10428
10429       <para>Choose from
10430       ONE and ONLY ONE of the following:
10431       <simplelist type="inline">
10432       <?dbchoice choice="or" ?>
10433       <member>A</member>
10434       <member>B</member>
10435       <member>C</member>.</simplelist></para>
10436
10437     Output (for English):
10438
10439         Choose from ONE and only ONE of the following choices: A, B, or C.
10440
10441     As a temporary workaround for the fact that most of the DocBook non-English
10442     locale files don't have a localization for the word “or”, you can put in a
10443     literal string to be used; example for French: <?dbchoice choice="ou">.
10444     That is, use “ou” instead of “or”.
10445
10446 FO
10447
10448   • Added content-type property to external-graphic element, based on imagedata
10449     format attribute.
10450
10451   • Added support for generating <rx:meta-field creator="$VERSION"/> field for
10452     XEP output. This makes the DocBook XSL stylesheet version information
10453     available through the Document Properties menu in Acrobat Reader and other
10454     PDF viewers.
10455
10456   • Trademark symbol handling made consistent with handling of same in HTML
10457     stylesheets. Prior to this change, if you processed a document that
10458     contained no value for the class attribute on the trademark element, the
10459     HTML stylesheets would default to rendering a superscript TM symbol after
10460     the trademark contents, but the FO stylesheets would render nothing.
10461
10462   • Added support for generating XEP bookmarks for refentry.
10463
10464   • Added support for HTML markup table border attribute, applied to each table
10465     cell.
10466
10467   • The table.width template can now sum column specs if none use % or *.
10468
10469   • Added fox:destination extension inside fox:outline to support linking to
10470     internal destinations.
10471
10472   • Added support for customizing abstract with property sets. Controlled with
10473     the abstract.properties and abstract.title.properties parameters.
10474
10475   • Add footnotes in table title to table footnote set, and add support for
10476     table footnotes to HTML table markup.
10477
10478   • Added support for title in glosslist.
10479
10480   • Added support for itemizedlist symbol none.
10481
10482   • Implemented the new graphical.admonition.properties and
10483     nongraphical.admonition.properties attribute sets.
10484
10485   • Added id to formalpara and some other blocks that were missing it.
10486
10487   • Changed the anchor template to output fo:inline instead of fo:wrapper.
10488
10489   • Added support for toc.max.depth parameter.
10490
10491 Help
10492
10493   • Eclipse Help: Added support for generating olink database.
10494
10495 HTML
10496
10497   • Added a first cut at support in HTML output for DocBook 5 style annotation
10498     s. Controlled using the annotation.support parameter, and implemented using
10499     JavaScript and CSS styling. For more details, see the documentation for the
10500     annotation.js, annotation.css, annotation.graphic.open, and
10501     annotation.graphic.close parameters.
10502
10503   • Generate client-side image map for imageobjectco with areas using calspair
10504     units
10505
10506   • Added support for <?img.src.path?> PI.
10507
10508   • Added support for passing img.src.path to DocBook Java XSLT image
10509     extensions when appropriate. Controlled using the
10510     graphicsize.use.img.src.path parameter.
10511
10512   • Added support for (not valid for DocBook 4) xlink:href on area and (not
10513     valid for DocBook 4) alt in area.
10514
10515   • Added new parameter default.table.frame to control table framing if there
10516     is no frame attribute on a table.
10517
10518   • Added initial, experimental support for generating content for the HTML
10519     title attribute from content of the alt element. This change adds support
10520     for the following inline elements only (none of them are block elements):
10521     abbrev, accel, acronym, action, application, authorinitials, beginpage,
10522     citation, citerefentry, citetitle, city, classname, code, command,
10523     computeroutput, constant, country, database, email, envar, errorcode,
10524     errorname, errortext, errortype, exceptionname, fax, filename, firstname,
10525     firstterm, foreignphrase, function, glossterm, guibutton, guiicon, guilabel
10526     , guimenu, guimenuitem, guisubmenu, hardware, honorific, interface,
10527     interfacename, keycap, keycode, keysym, lineage, lineannotation, literal,
10528     markup, medialabel, methodname, mousebutton, option, optional, otheraddr,
10529     othername, package, parameter, personname, phone, pob, postcode,
10530     productname, productnumber, prompt, property, quote, refentrytitle, remark,
10531     replaceable, returnvalue, tag, shortcut, state, street, structfield,
10532     structname, subscript, superscript, surname, symbol, systemitem, tag,
10533     termdef, token, trademark, type, uri, userinput, varname, and wordasword
10534
10535   • Added support for chunking revhistory into separate file (similar to the
10536     support for doing same with legalnotice). Patch from Thomas Schraitle.
10537     Controlled through new generate.revhistory.link parameter.
10538
10539   • l10n.xsl: Made language codes RFC compliant. Added a new boolean config
10540     parameter, l10n.lang.value.rfc.compliant. If it is non-zero (the default),
10541     any underscore in a language code will be converted to a hyphen in HTML
10542     output. If it is zero, the language code will be left as-is.
10543
10544 man
10545
10546 This release closes out 44 manpages stylesheet bug reports and feature
10547 requests. It adds more than 35 new configuration parameters for controlling
10548 aspects of man-page output -- including hyphenation and justification, handling
10549 of links, conversion of Unicode characters, and contents of man-page headers
10550 and footers.
10551
10552   • New options for globally disabling/enabling hyphenation and justification:
10553     man.justify and man.hyphenate.
10554
10555     Note that the default for the both of those is zero (off), because
10556     justified text looks good only when it is also hyphenated; to quote the
10557     “Hyphenation” node from the groff info page:
10558
10559         Since the odds are not great for finding a set of words, for every
10560         output line, which fit nicely on a line without inserting excessive
10561         amounts of space between words, `gtroff' hyphenates words so that it
10562         can justify lines without inserting too much space between words.
10563
10564     The problem is that groff can end up hyphenating a lot of things that you
10565     don't want hyphenated (variable names and command names, for example).
10566     Keeping both justification and hyphenation disabled ensures that hyphens
10567     won't get inserted where you don't want to them, and you don't end up with
10568     lines containing excessive amounts of space between words. These default
10569     settings run counter to how most existing man pages are formatted. But
10570     there are some notable exceptions, such as the perl man pages.
10571
10572   • Added parameters for controlling hyphenation of computer inlines,
10573     filenames, and URLs. By default, even when hyphenation is enabled
10574     (globally), hyphenation is now suppressed for "computer inlines"
10575     (currently, just classname, constant, envar, errorcode, option, replaceable
10576     , userinput, type, and varname, and for filenames, and for URLs from link.
10577     It can be (re)enabled using the man.hyphenate.computer.inlines,
10578     man.hyphenate.filenames, and man.hyphenate.urls parameters.
10579
10580   • Implemented a new system for replacing Unicode characters. There are two
10581     parts to the new system: a “string substitution map” for doing “essential”
10582     replacements, and a “character map” that can optionally be disabled and
10583     enabled.
10584
10585     The new system fixes all open bugs that had to do with literal Unicode
10586     numbered entities such as &#8220; and &#8221; showing up in output, and
10587     greatly expands the ability of the stylesheets to generate “good” roff
10588     equivalents for Unicode symbols and special characters.
10589
10590     Here are some details...
10591
10592     The previous manpages mechanism for replacing Unicode symbols and special
10593     characters with roff equivalents (the replace-entities template) was not
10594     scalable and not complete. The mechanism handled a somewhat arbitrary
10595     selection of less than 20 or so Unicode characters. But there are
10596     potentially more than 800 Unicode special characters that have some groff
10597     equivalent they can be mapped to. And there are about 34 symbols in the
10598     Latin-1 (ISO-8859-1) block alone. Users might reasonably expect that if
10599     they include any of those Latin-1 characters in their DocBook source
10600     documents, they will get correctly converted to known roff equivalents in
10601     output.
10602
10603     In addition to those common symbols, certain users may have a need to use
10604     symbols from other Unicode blocks. Say, somebody who is documenting an
10605     application related to math might need to use a bunch of symbols from the
10606     “Mathematical Operators” Unicode block (there are about 65 characters in
10607     that block that have reasonable roff equivalents). Or somebody else might
10608     really like Dingbats -- such as the checkmark character -- and so might use
10609     a bunch of things from the “Dingbat” block (141 characters in that that
10610     have roff equivalents or that can at least be “degraded” somewhat
10611     gracefully into roff).
10612
10613     So, the old replace-entities mechanism was replaced with a completely
10614     different mechanism that is based on use of two “maps”: a “substitution
10615     map” and a “character map” (the latter in a format compliant with the XSLT
10616     2.0 spec and therefore completely “forward compatible” with XSLT 2.0).
10617
10618     The substitution map is controlled through the man.string.subst.map
10619     parameter, and is used to replace things like the backslash character
10620     (which needs special handling to prevent it from being interpreted as a
10621     roff escape). The substitution map cannot be disabled, because disabling it
10622     will cause the output to be broken. However, you can add to it and change
10623     it if needed.
10624
10625     The “character map” mechanism, on the other hand, can be completely
10626     disabled. It is enabled by default, and, by default, does replacement of
10627     all Latin-1 symbols, along with most special spaces, dashes, and quotes
10628     (about 75 characters by default). Also, you can optionally enable a “full”
10629     character map that provides support for converting all 800 or so of the
10630     characters that have some reasonable groff equivalent.
10631
10632     The character-map mechanism is controlled through the following parameters:
10633
10634     man.charmap.enabled
10635
10636         turns character-map support on/off
10637
10638     man.charmap.use.subset
10639
10640         specifies that a subset of the character map is used instead of the
10641         full map
10642
10643     man.charmap.subset.profile
10644
10645         specifies profile of character-map subset
10646
10647     man.charmap.uri
10648
10649         specifies an alternate character map to use instead of the “standard”
10650         character map provided in the distribution
10651
10652   • Implemented out-of-line handling of display of URLs for links (currently,
10653     only for ulink). This gives you three choices for handling of links:
10654
10655      1. Number and list links. Each link is numbered inline, with a number in
10656         square brackets preceding the link contents, and a numbered list of all
10657         links is added to the end of the document.
10658
10659      2. Only list links. Links are not numbered, but an (unnumbered) list of
10660         links is added to the end of the document.
10661
10662      3. Suppress links. Don't number links and don't add any list of links to
10663         the end of the document.
10664
10665     You can also choose whether links should be underlined. The default is “the
10666     works” -- list, number, and underline links. You can use the
10667     man.links.list.enabled, man.links.are.numbered, and
10668     man.links.are.underlined parameters to change the defaults. The default
10669     heading for the link list is REFERENCES. You can be change that using the
10670     man.links.list.heading parameter.
10671
10672   • Changed default output encoding to UTF-8. This does not mean that man pages
10673     are output in raw UTF-8, because the character map is applied before final
10674     output, causing all UTF-8 characters covered in the map to be converted to
10675     roff equivalents.
10676
10677   • Added support for processing refsect3 and formalpara and nested refsection
10678     elements, down to any arbitrary level of nesting.
10679
10680   • Output of the NAME and SYNOPSIS and AUTHOR headings and the headings for
10681     admonitions (note, caution, etc.) are no longer hard-coded for English.
10682     Instead, headings are generated for those in the correct locale (just as
10683     the FO and HTML stylesheets do).
10684
10685   • Re-worked mechanism for assembling page headers/footers (the contents of
10686     the .TH macro “title line”).
10687
10688     Here are some details...
10689
10690     All man pages contain a .TH roff macro whose contents are used for
10691     rendering the “title line” displayed in the header and footer of each page.
10692     Here are a couple of examples of real-world man pages that have useful page
10693     headers/footers:
10694
10695       gtk-options(7)    GTK+ User's Manual   gtk-options(7) <-- header
10696       GTK+ 1.2              2003-10-20       gtk-options(7) <-- footer
10697
10698       svgalib(7)       Svgalib User Manual       svgalib(7) <-- header
10699       Svgalib 1.4.1      16 December 1999        svgalib(7) <-- footer
10700
10701     And here are the terms with which the groff_man(7) man page refers to the
10702     various parts of the header/footer:
10703
10704       title(section)  extra3  title(section)  <- header
10705       extra2          extra1  title(section)  <- footer
10706
10707     Or, using the names with which the man(7) man page refers to those same
10708     fields:
10709
10710       title(section)  manual  title(section)  <- page header
10711       source          date    title(section)  <- page footer
10712
10713     The easiest way to control the contents of those fields is to mark up your
10714     refentry content like the following (note that this is a “minimal”
10715     example).
10716
10717       <refentry>
10718         <info>
10719           <date>2003-10-20</date> 1
10720         </info>
10721         <refmeta>
10722           <refentrytitle>gtk-options</refentrytitle> 2
10723           <manvolnum>7</manvolnum> 3
10724           <refmiscinfo class="source-name">GTK+</refmiscinfo> 4
10725           <refmiscinfo class="version">1.2</refmiscinfo> 5
10726           <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> 6
10727         </refmeta>
10728         <refnamediv>
10729           <refname>gtk-options</refname>
10730           <refpurpose>Standard Command Line Options for GTK+ Programs</refpurpose>
10731         </refnamediv>
10732         <refsect1>
10733           <title>Description</title>
10734           <para>This manual page describes the command line options, which
10735           are common to all GTK+ based applications.</para>
10736         </refsect1>
10737       </refentry>
10738
10739     1  Sets the “date” part of the header/footer.
10740
10741     2  Sets the “title” part.
10742
10743     3  Sets the “section” part.
10744
10745     4  Sets the “source name” part.
10746
10747     5  Sets the “version” part.
10748
10749     6  Sets the “manual” part.
10750
10751     Below are explanations of the steps the stylesheets take to attempt to
10752     assemble and display “good” headers and footer. [In the descriptions, note
10753     that *info is the refentry “info” child (whatever its name), and parentinfo
10754     is the “info” child of its parent (again, whatever its name).]
10755
10756     extra1 field (date)
10757
10758         Content of the “extra1” field is what shows up in the center footer
10759         position of each page. The man(7) man page describes it as “the date of
10760         the last revision”.
10761
10762         To provide this content, if the refentry.date.profile.enabled is
10763         non-zero, the stylesheets check the value of refentry.date.profile.
10764
10765         Otherwise, by default, they check for a date or pubdate not only in the
10766         *info contents, but also in the parentinfo contents.
10767
10768         If a date cannot be found, the stylesheets now automatically generate a
10769         localized “long format” date, ensuring that this field always has
10770         content in output.
10771
10772         However, if for some reason you want to suppress this field, you can do
10773         so by setting a non-zero value for man.th.extra1.suppress.
10774
10775     extra2 field (source)
10776
10777         On Linux systems and on systems with a modern groff, the content of the
10778         “extra2” field are what shows up in the left footer position of each
10779         page.
10780
10781         The man(7) man page describes this as “the source of the command”, and
10782         provides the following examples:
10783
10784           ☆ For binaries, use somwething like: GNU, NET-2, SLS Distribution,
10785             MCC Distribution.
10786
10787           ☆ For system calls, use the version of the kernel that you are
10788             currently looking at: Linux 0.99.11.
10789
10790           ☆ For library calls, use the source of the function: GNU, BSD 4.3,
10791             Linux DLL 4.4.1.
10792
10793         In practice, there are many pages that simply have a version number in
10794         the “source” field. So, it looks like what we have is a two-part field,
10795         Name Version, where:
10796
10797         Name
10798
10799             product name (e.g., BSD) or org. name (e.g., GNU)
10800
10801         Version
10802
10803             version name
10804
10805         Each part is optional. If the Name is a product name, then the Version
10806         is probably the version of the product. Or there may be no Name, in
10807         which case, if there is a Version, it is probably the version of the
10808         item itself, not the product it is part of. Or, if the Name is an
10809         organization name, then there probably will be no Version.
10810
10811         To provide this content, if the refentry.source.name.profile.enabled
10812         and refentry.version.profile.enabled parameter are non-zero, the
10813         stylesheets check the value of refentry.source.name.profile
10814         refentry.version.profile.
10815
10816         Otherwise, by default, they check the following places, in the
10817         following order:
10818
10819          1. *info/productnumber
10820
10821          2. *info/productnumber
10822
10823          3. refmeta/refmiscinfo[@class = 'version']
10824
10825          4. parentinfo/productnumber
10826
10827          5. *info/productname
10828
10829          6. parentinfo/productname
10830
10831          7. refmeta/refmiscinfo
10832
10833          8. [nothing found, so leave it empty]
10834
10835     extra3 field
10836
10837         On Linux systems and on systems with a modern groff, the content of the
10838         “extra3” field are what shows up in the center header position of each
10839         page. Some man pages have “extra2” content, some don't. If a particular
10840         man page has it, it is most often “context” data about some larger
10841         system the documented item belongs to (for example, the name or
10842         description of a group of related applications). The stylesheets now
10843         check the following places, in the following order, to look for content
10844         to add to the “extra3” field.
10845
10846          1. parentinfo/title
10847
10848          2. parent's title
10849
10850          3. refmeta/refmiscinfo
10851
10852          4. [nothing found, so leave it empty]
10853
10854   • Reworked *info gathering. For each refentry found, the stylesheets now
10855     cache its *info content, then check for any valid parent of it that might
10856     have metainfo content and cache that, if found; they then then do all
10857     further matches against those node-sets (rather than re-selecting the
10858     original *info nodes each time they are needed).
10859
10860   • New option for breaking strings after forward slashes. This enables long
10861     URLs and pathnames to be broken across lines. Controlled through
10862     man.break.after.slash parameter.
10863
10864   • Output for servicemark and trademark are now (SM) and (TM). There is a
10865     groff "\(tm" escape, but output from that is not acceptable.
10866
10867   • New option for controlling the length of the title part of the .TH title
10868     line. Controlled through the man.th.title.max.length parameter.
10869
10870   • New option for specifying output encoding of each man page; controlled with
10871     man.output.encoding (similar to the HTML chunker.output.encoding 
10872     parameter).
10873
10874   • New option for suppressing filename messages when generating output;
10875     controlled with man.output.quietly (similar to the HTML chunk.quietly
10876     parameter).
10877
10878   • The text of cross-references to first-level refentry (refsect1, top-level
10879     refsection, refnamediv, and refsynopsisdiv) are now capitalized.
10880
10881   • Cross-references to refnamediv now use the localized NAME title instead of
10882     using the first refname child. This makes the output inconsistent with HTML
10883     and FO output, but for man-page output, it seems to make better sense to
10884     have the NAME. (It may actually make better sense to do it that way in HTML
10885     and FO output as well...)
10886
10887   • Added support for processing funcparams.
10888
10889   • Removed the space that was being output between funcdef and paramdef;
10890     example: was: float rand (void); now: float rand(void)
10891
10892   • Turned off bold formatting for the type element when it occurs within a
10893     funcdef or paramdef
10894
10895   • Corrected rendering of simplelist. Any <simplelist type="inline" instance
10896     is now rendered as a comma-separated list (also with an optional localized
10897     “and” or “or” before the last item -- see description elsewhere in these
10898     release notes). Any simplelist instance whose type is not inline is
10899     rendered as a one-column vertical list (ignoring the values of the type and
10900     columns attributes if present)
10901
10902   • Comment added at top of roff source for each page now includes DocBook XSL
10903     stylesheets version number (as in the HTML stylesheets)
10904
10905   • Made change to prevent “sticky” fonts changes. Now, when the manpages
10906     stylesheets encounter node sets that need to be boldfaced or italicized,
10907     they put the \fBfoo\fR and \fIbar\fR groff bold/italic instructions
10908     separately around each node in the set.
10909
10910   • synop.xsl: Boldface everything in funcsynopsis output except parameters
10911     (which are in ital). The man(7) man page says:
10912
10913         For functions, the arguments are always specified using italics, even
10914         in the SYNOPSIS section, where the rest of the function is specified in
10915         bold.
10916
10917     A look through the contents of the man/man2 directory shows that most (all)
10918     existing pages do follow this “everything in funcsynopsis bold” rule. That
10919     means the type content and any punctuation (parens, semicolons, varargs)
10920     also must be bolded.
10921
10922   • Removed code for adding backslashes before periods/dots in roff source,
10923     because backslashes in front of periods/dots in roff source are needed only
10924     in the very rare case where a period is the very first character in a line,
10925     without any space in front of it. A better way to deal with that rare case
10926     is for you to add a zero-width space in front of the offending dot(s) in
10927     your source
10928
10929   • Removed special handling of the quote element. That was hard-coded to cause
10930     anything marked up with the quote element to be output preceded by two
10931     backticks and followed by two apostrophes -- that is, that old-school
10932     kludge for generating “curly” quotes in Emacs and in X-Windows fonts. While
10933     Emacs still seems to support that, I don't think X-Windows has for a long
10934     time now. And, anyway, it looks (and has always looked) like crap when
10935     viewed on a normal tty/console. In addition, it breaks localiztion of quote
10936     . By default, quote content is output with localized quotation marks,
10937     which, depending on the locale, may or may not be left and right double
10938     quotation marks.
10939
10940   • Changed mappings for left and right single quotation marks. Those had
10941     previously been incorrectly mapped to the backtick (&#96;) and apostrophe
10942     (&39;) characters (for kludgy reasons -- see above). They are now correctly
10943     mapped to the \(oq and \(cq roff escapes. If you want the old (broken)
10944     behavior, you need to manually change the mappings for those in the value
10945     of the man.string.subst.map parameter.
10946
10947   • Removed xref.xsl file. Now, of the various cross-reference elements, only
10948     the ulink element is handled differently; the rest are handled exactly as
10949     the HTML stylesheets handle them, except that no hypertext links are
10950     generated. (Because there is no equivalent hypertext mechanism is man
10951     pages.)
10952
10953   • New option for making “subheading dividers” in generated roff source. The
10954     dividers are not visible in the rendered man page; they are just there to
10955     make the source readable. Controlled using man.subheading.divider.
10956
10957   • Fixed many places where too much space was being added between lines.
10958
10959 Release 1.68.1
10960
10961 The release adds localization support for Farsi (thanks to Sina Heshmati) and
10962 improved support for the XLink-based DocBook NG db:link element. Other than
10963 that, it is a minor bug-fix update to the 1.68.0 release. The main thing it
10964 fixes is a build error that caused the XSLT Java extensions to be jarred up
10965 with the wrong package structure. Thanks to Jens Stavnstrup for quickly
10966 reporting the problem, and to Mauritz Jeanson for investigating and finding the
10967 cause.
10968
10969 Release 1.68.0
10970
10971 This release includes some features changes, particularly for FO/PDF output,
10972 and a number of bug fixes.
10973
10974 FO
10975
10976   • Moved footnote properties to attribute-sets.
10977
10978   • Added support for side floats, margin notes, and custom floats.
10979
10980   • Added new parameters body.start.indent and body.end.indent to the
10981     set.flow.properties template.
10982
10983   • Added support for xml:id
10984
10985   • Added support for refdescriptor.
10986
10987   • Added support for multiple refnamedivs.
10988
10989   • Added index.entry.properties attribute-set to support customization of
10990     index entries.
10991
10992   • Added set.flow.properties template call to each fo:flow to support
10993     customizations entry point.
10994
10995   • Add support for @floatstyle in figure
10996
10997   • Moved hardcoded properties for index division titles to the
10998     index.div.title.properties attribute-set.
10999
11000   • Added support for table-layout="auto" for XEP.
11001
11002   • Added index.div.title.properties attribute-set.
11003
11004   • $verbose parameter is now passed to most elements.
11005
11006   • Added refentry to toc in part, as it is permitted by the DocBook schema/
11007     DTD.
11008
11009   • Added backmatter elements and article to toc in part, since they are
11010     permitted by the DocBook schema/DTD.
11011
11012   • Added mode="toc" for simplesect, since it is now permitted in the toc if
11013     simplesect.in.toc is set.
11014
11015   • Moved hard-coded properties to nongraphical.admonintion.properties and
11016     graphical.admonition.properties attribute sets.
11017
11018   • Added support for sidebar-width and float-type processing instructions in
11019     sidebar.
11020
11021   • For tables with HTML markup elements, added support for dbfo bgcolor PI,
11022     the attribute-sets named table.properties, informaltable.properties,
11023     table.table.properties, and table.cell.padding. Also added support for the
11024     templates named table.cell.properties and table.cell.block.properties so
11025     that tabstyles can be implemented. Also added support for tables containing
11026     only tr instead of tbody with tr.
11027
11028   • Added new paramater hyphenate.verbatim.characters which can specify
11029     characters after which a line break can occur in verbatim environments.
11030     This parameter can be used to extend the initial set of characters which
11031     contain only space and non-breakable space.
11032
11033   • Added itemizedlist.label.markup to enable selection of different bullet
11034     symbol. Also added several potential bullet characters, commented out by
11035     default.
11036
11037   • Enabled all id's in XEP output for external olinking.
11038
11039 HTML
11040
11041   • Added support for refdescriptor.
11042
11043   • Added support for multiple refnamedivs.
11044
11045   • Added support for xml:id
11046
11047   • refsynopsisdiv as a section for counting section levels
11048
11049 Images
11050
11051   • Added new SVG admonition graphics and navigation images.
11052
11053 Release 1.67.2
11054
11055 This release fixes a table bug introduced in the 1.67.1 release.
11056
11057 Release 1.67.1
11058
11059 This release includes a number of bug fixes.
11060
11061 The following lists provide details about API and feature changes.
11062
11063 FO
11064
11065   • Tables: Inherited cell properties are now passed to the
11066     table.cell.properties template so they can be overridden by a
11067     customization.
11068
11069   • Tables: Added support for bgcolor PI on table row element.
11070
11071   • TOCs: Added new parameter simplesect.in.toc; default value of 0 causes
11072     simplesect to be omitted from TOCs; to cause simplesect to be included in
11073     TOCs, you must set the value of simplesect.in.toc to 1.Comment from Norm:
11074
11075         Simplesect elements aren't supposed to appear in the ToC at all... The
11076         use case for simplesect is when, for example, every chapter in a book
11077         ends with "Exercises" or "For More Information" sections and you don't
11078         want those to appear in the ToC.
11079
11080   • Sections: Reverted change that caused a variable reference to be used in a
11081     template match and rewrote code to preserve intended semantics.
11082
11083   • Lists: Added workaround to prevent "* 0.60 + 1em" garbage in list output
11084     from PassiveTeX
11085
11086   • Moved the literal attributes from component.title to the
11087     component.title.properties attribute-set so they can be customized.
11088
11089   • Lists: Added glossdef's first para to special handling in
11090     fo:list-item-body.
11091
11092 HTML
11093
11094   • TOCs: Added new parameter simplesect.in.toc; for details, see the list of
11095     FO changes for this release.
11096
11097   • Indexing: Added new parameter index.prefer.titleabbrev; when set to 1,
11098     index references will use titleabbrev instead of title when available.
11099
11100 HTML Help
11101
11102   • Added support for generating windows-1252-encoded output using Saxon; for
11103     more details, see the list of XSL Java extensions changes for this release.
11104
11105 man pages
11106
11107   • Replaced named/numeric character-entity references for non-breaking space
11108     with groff equivalent (backslash-tilde).
11109
11110 XSL Java extensions
11111
11112   • Saxon extensions: Added the Windows1252 class. It extends Saxon 6.5.x with
11113     the windows-1252 character set, which is particularly useful when
11114     generating HTML Help for Western European Languages (code from Pontus
11115     Haglund and contributed to the DocBook community by Sectra AB, Sweden).
11116
11117     To use:
11118
11119      1. Make sure that the Saxon 6.5.x jar file and the jar file for the
11120         DocBook XSL Java extensions are in your CLASSPATH
11121
11122      2. Create a DocBook XSL customization layer -- a file named
11123         mystylesheet.xsl or whatever -- that, at a minimum, contains the
11124         following:
11125
11126           <xsl:stylesheet
11127             xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
11128             version='1.0'>
11129             <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/>
11130             <xsl:output method="html" encoding="WINDOWS-1252" indent="no"/>
11131             <xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"></xsl:param>
11132             <xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"></xsl:param>
11133             <xsl:param name="saxon.character.representation" select="'native'"></xsl:param>
11134           </xsl:stylesheet>
11135
11136         Invoke Saxon with the encoding.windows-1252 Java system property set to
11137         com.nwalsh.saxon.Windows1252; for example
11138
11139           java \
11140             -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
11141           com.icl.saxon.StyleSheet \
11142           mydoc.xml mystylesheet.xsl
11143
11144         Or, for a more complete "real world" case showing other options you'll
11145         typically want to use:
11146
11147           java \
11148             -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
11149             -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \
11150             -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \
11151             -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \
11152           com.icl.saxon.StyleSheet \
11153             -x org.apache.xml.resolver.tools.ResolvingXMLReader \
11154             -y org.apache.xml.resolver.tools.ResolvingXMLReader \
11155             -r org.apache.xml.resolver.tools.CatalogResolver \
11156           mydoc.xml mystylesheet.xsl
11157
11158         In both cases, the "mystylesheet.xsl" file should be a DocBook
11159         customization layer containing the parameters show in step 2.
11160
11161   • Saxon extensions: Removed Saxon 8 extensions from release package
11162
11163 Release 1.67.0
11164
11165   • A number of important bug fixes.
11166
11167   • Added Saxon8 extensions
11168
11169   • Enabled dbfo table-width on entrytbl in FO output
11170
11171   • Added support for role=strong on emphasis in FO output
11172
11173   • Added new FO parameter hyphenate.verbatim that can be used to turn on
11174     "intelligent" wrapping of verbatim environments.
11175
11176   • Replaced all <tt></tt> output with <code></code>
11177
11178   • Changed admon.graphic.width template to a mode so that different
11179     admonitions can have different graphical widths.
11180
11181   • Deprecated the HTML shade.verbatim parameter (use CSS instead)
11182
11183   • Wrapped ToC refentrytitle/refname and refpurpose in span with class values.
11184     This makes it possible to style them using a CSS stylesheet.
11185
11186   • Use strong/em instead of b/i in HTML output
11187
11188   • Added support for converting Emphasis to groff italic and Emphasis role=
11189     'bold' to bold. Controlled by emphasis.propagates.style param, but not
11190     documented yet using litprog system. Will do that next (planning to add
11191     some other parameter-controllable options for hyphenation and handling of
11192     line spacing).
11193
11194   • callout.graphics.number.limit.xml param: Changed the default from 10 to 15.
11195
11196   • verbatim.properties: Added hyphenate=false
11197
11198   • Saxon and Xalan Text.java extensions: Added support for URIResolver() on
11199     insertfile href's
11200
11201   • Added generated RELEASE-NOTES.txt file.
11202
11203   • Added INSTALL file (executable file for generating catalog.xml)
11204
11205   • Removed obsolete tools directory from package
11206
11207 Release 1.66.1
11208
11209   • A number of important bug fixes.
11210
11211   • Now xml:base attributes that are generated by an XInclude processor are
11212     resolved for image files.
11213
11214   • Rewrote olink templates to support several new features.
11215
11216       □ Extended full olink support to FO output.
11217
11218       □ Add support for xrefstyle attribute in olinks.
11219
11220       □ New parameters to support new olink features: insert.olink.page.number,
11221         insert.olink.pdf.frag, olink.debug, olink.lang.fallback.sequence,
11222         olink.properties, prefer.internal.olink. See the reference page for
11223         each parameter for more information.
11224
11225   • Added index.on.type parameter for new type attribute introduced in DocBook
11226     4.3 for indexterms and index. This allows you to create multiple indices
11227     containing different categories of entries. For users of 4.2 and earlier,
11228     you can use the new parameter index.on.role instead.
11229
11230   • Added new section.autolabel.max.depth parameter to turn off section
11231     numbering below a certain depth. This permits you to number major section
11232     levels and leave minor section levels unnumbered.
11233
11234   • Added footnote.sep.leader.properties attribute set to format the line
11235     separating footnotes in printed output.
11236
11237   • Added parameter img.src.path as a prefix to HTML img src attributes. The
11238     prefix is added to whatever path is already generated by the stylesheet for
11239     each image file.
11240
11241   • Added new attribute-sets informalequation.properties,
11242     informalexample.properties, informalfigure.properties, and
11243     informaltable.properties, so each such element type can be formatted
11244     individually if needed.
11245
11246   • Add component.label.includes.part.label parameter to add any part number to
11247     chapter, appendix and other component labels when the label.from.part
11248     parameter is nonzero. This permits you to distinguish multiple chapters
11249     with the same chapter number in cross references and the TOC.
11250
11251   • Added chunk.separate.lots parameter for HTML output. This parameter lets
11252     you generate separate chunk files for each LOT (list of tables, list of
11253     figures, etc.).
11254
11255   • Added several table features:
11256
11257       □ Added table.table.properties attribute set to add properties to the
11258         fo:table element.
11259
11260       □ Added placeholder templates named table.cell.properties and
11261         table.cell.block.properties to enable adding properties to any
11262         fo:table-cell or the cell's fo:block, respectively. These templates are
11263         a start for implementing table styles.
11264
11265   • Added new attribute set component.title.properties for easy modifications
11266     of component's title formatting in FO output.
11267
11268   • Added Saxon support for an encoding attribute on the textdata element.
11269     Added new parameter textdata.default.encoding which specifies encoding when
11270     encoding attribute on textdata is missing.
11271
11272   • Template label.this.section now controls whole section label, not only
11273     sub-label which corresponds to particular label. Former behaviour was IMHO
11274     bug as it was not usable.
11275
11276   • Formatting in titleabbrev for TOC and headers is preserved when there are
11277     no hotlink elements in the title. Formerly the title showed only the text
11278     of the title, no font changes or other markup.
11279
11280   • Added intial.page.number template to set the initial-page-number property
11281     for page sequences in print output. Customizing this template lets you
11282     change when page numbering restarts. This is similar to the
11283     format.page.number template that lets you change how the page number
11284     formatting changes in the output.
11285
11286   • Added force.page.count template to set the force-page-count property for
11287     page sequences in print output. This is similar to the format.page.number
11288     template.
11289
11290   • Sort language for localized index sorting in autoidx-ng.xsl is now taken
11291     from document lang, not from system environment.
11292
11293   • Numbering and formatting of normal and ulink footnotes (if turned on) has
11294     been unified. Now ulink footnotes are mixed in with any other footnotes.
11295
11296   • Added support for renderas attribute in section and sect1 et al. This
11297     permits you to render a given section title as if it were a different
11298     level.
11299
11300   • Added support for label attribute in footnote to manually supply the
11301     footnote mark.
11302
11303   • Added support for DocBook 4.3 corpcredit element.
11304
11305   • Added support for a dbfo keep-together PI for formal objects (table,
11306     figure, example, equation, programlisting). That permits a formal object to
11307     be kept together if it is not already, or to be broken if it is very long
11308     and the default keep-together is not appropriate.
11309
11310   • For graphics files, made file extension matching case insensitive, and
11311     updated the list of graphics extensions.
11312
11313   • Allow calloutlist to have block content before the first callout
11314
11315   • Added dbfo-need processing instruction to provide soft page breaks.
11316
11317   • Added implementation of existing but unused default.image.width parameter
11318     for graphics.
11319
11320   • Support DocBook NG tag inline element.
11321
11322   • It appears that XEP now supports Unicode characters in bookmarks. There is
11323     no further need to strip accents from characters.
11324
11325   • Make segmentedlist HTML markup more semantic and available to CSS styles.
11326
11327   • Added user.preroot placeholder template to permit xsl-stylesheet and other
11328     PIs and comments to be output before the HTML root element.
11329
11330   • Non-chunked legalnotice now gets an <a name="id"> element in HTML output so
11331     it can be referenced with xref or link.
11332
11333   • In chunked HTML output, changed link rel="home" to rel="start", and link
11334     rel="previous" to rel="prev", per W3C HTML 4.01 spec.
11335
11336   • Added several patches to htmlhelp from W. Borgert
11337
11338   • Added Bosnian locale file as common/bs.xml.
11339
11340 Release 1.65.0
11341
11342   • A number of important bug fixes.
11343
11344   • Added a workaround to allow these stylesheets to process DocBook NG
11345     documents. (It’s a hack that pre-processes the document to strip off the
11346     namespace and then uses exsl:node-set to process the result.)
11347
11348   • Added alternative indexing mechanism which has better internationalization
11349     support. New indexing method allows grouping of accented letters like e, é,
11350     ë into the same group under letter "e". It can also treat special letters
11351     (e.g. "ch") as one character and place them in the correct position (e.g.
11352     between "h" and "i" in Czech language).
11353
11354     In order to use this mechanism you must create customization layer which
11355     imports some base stylesheet (like fo/docbook.xsl, html/chunk.xsl) and then
11356     includes appropriate stylesheet with new indexing code (fo/autoidx-ng.xsl
11357     or html/autoidx-ng.xsl). For example:
11358
11359     <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
11360                     version="1.0">
11361
11362     <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/>
11363     <xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/>
11364
11365     </xsl:stylesheet>
11366
11367     New method is known to work with Saxon and it should also work with
11368     xsltproc 1.1.1 and later. Currently supported languages are English, Czech,
11369     German, French, Spanish and Danish.
11370
11371 Release 1.64.1
11372
11373 General bug fixes and improvements. Sorry about the failure to produce an
11374 updated release notes file for 1.62.0—1.63.2
11375
11376   • In the course of fixing bug #849787, wrapping Unicode callouts with an
11377     appropriate font change in the Xalan extensions, I discovered that the
11378     Xalan APIs have changed a bit. So xalan2.jar will work with older Xalan 2
11379     implementations, xalan25.jar works with Xalan 2.5.
11380
11381 Release 1.61.0
11382
11383 Lots of bug fixes and improvements.
11384
11385   • Initial support for timestamp PI. From now you can use <?dbtimestamp format
11386     ="Y-m-d H:M:S"?> to get current datetime in your document. Added
11387     localization support for datetime PI
11388
11389   • Added level 6 to test for section depth in section.level template so that
11390     section.title.level6.properties will be used for sections that are 6 deep
11391     or deeper. This should also cause a h6 to be created in html output.
11392
11393   • Don't use SVG graphics if use.svg=0
11394
11395   • Now uses number-and-title-template for sections only if section.autolabel
11396     is not zero.
11397
11398   • Added missing 'english-language-name' attribute to the l10n element, and
11399     the missing 'style' attribute to the template element so the current
11400     gentext documents will validate.
11401
11402   • Corrected several references to parameter qanda.defaultlabel that were
11403     missing the "$".
11404
11405   • Now accepts admon.textlabel parameter to turn off Note, Warning, etc.
11406     label.
11407
11408   • FeatReq #684561: support more XEP metadata
11409
11410   • Added hyphenation support. Added support for coref. Added beginpage
11411     support. (does nothing; see TDG).
11412
11413   • Added support for hyphenation-character, hyphenation-push-character-count,
11414     and hyphenation-remain-character-count
11415
11416   • Added root.properties, ebnf.assignment, and ebnf.statement.terminator
11417
11418   • Support bgcolor PI in table cells; make sure rowsep and colsep don't have
11419     any effect on the last row or column
11420
11421   • Handle othercredit on titlepage a little better
11422
11423   • Applied fix from Jeff Beal that fixed the bug that put secondary page
11424     numbers on primary entries. Same with tertiary page numbers on secondary
11425     entries.
11426
11427   • Added definition of missing variable collection.
11428
11429   • Make footnote formatting 'normal' even when it occurs in a context that has
11430     special formatting
11431
11432   • Added warning when glossary.collection is not blank, but it cannot open the
11433     specified file.
11434
11435   • Pick up the frame attribute on table and informaltable.
11436
11437   • indexdiv/title in non-autogenerated indexes are now picked up.
11438
11439   • Removed (unused) component.title.properties
11440
11441   • Move IDs from page-sequences down to titlepage blocks
11442
11443   • Use proportional-column-width(1) on more tables.
11444
11445     Use proportional-column-width() for header/footer tables; suppress
11446     relative-align when when using FOP
11447
11448   • Check for glossterm.auto.link when linking firstterms; don't output gl.
11449     prefix on glossterm links
11450
11451   • Generate Part ToCs
11452
11453   • Support glossary, bibliography, and index in component ToCs.
11454
11455   • Refactored chunking code so that customization of chunk algorithm and chunk
11456     elements is more practical
11457
11458   • Support textobject/phrase on inlinemediaobject.
11459
11460   • Support 'start' PI on ordered lists
11461
11462   • Fixed test of $toc PI to turn on qandaset TOC.
11463
11464   • Added process.chunk.footnotes to sect2 through 5 to fix bug of missing
11465     footnotes when chunk level greater than 1.
11466
11467   • Added paramater toc.max.depth which controls maximal depth of ToC as
11468     requested by PHP-DOC group.
11469
11470   • Exempted titleabbrev from preamble processing in lists, and fixed
11471     variablelist preamble code to use the same syntax as the other lists.
11472
11473   • Added support for elements between variablelist and first varlistentry
11474     since DocBook 4.2 supports that now.
11475
11476 Release 1.60.1
11477
11478 Lots of bug fixes.
11479
11480   • The format of the titlepage.templates.xml files and the stylesheet that
11481     transforms them have been significantly changed. All of the attributes used
11482     to control the templates are now namespace qualified. So what used to be:
11483
11484     <t:titlepage element="article" wrapper="fo:block">
11485
11486     is now:
11487
11488     <t:titlepage t:element="article" t:wrapper="fo:block">
11489
11490     Attributes from other namespaces (including those that are unqualified) are
11491     now copied directly through. In practice, this means that the names that
11492     used to be “fo:” qualified:
11493
11494     <title named-template="component.title"
11495            param:node="ancestor-or-self::article[1]"
11496            fo:text-align="center"
11497            fo:keep-with-next="always"
11498            fo:font-size="&hsize5;"
11499            fo:font-weight="bold"
11500            fo:font-family="{$title.font.family}"/>
11501
11502     are now unqualified:
11503
11504     <title t:named-template="component.title"
11505            param:node="ancestor-or-self::article[1]"
11506            text-align="center"
11507            keep-with-next="always"
11508            font-size="&hsize5;"
11509            font-weight="bold"
11510            font-family="{$title.font.family}"/>
11511
11512     The t:titlepage and t:titlepage-content elements both generate wrappers
11513     now. And unqualified attributes on those elements are passed through. This
11514     means that you can now make the title font apply to ane entire titlepage
11515     and make the entire “recto” titlepage centered by specifying the font and
11516     alignment on the those elements:
11517
11518     <t:titlepage t:element="article" t:wrapper="fo:block"
11519                  font-family="{$title.font.family}">
11520
11521       <t:titlepage-content t:side="recto"
11522                  text-align="center">
11523
11524   • Support use of titleabbrev in running headers and footers.
11525
11526   • Added (experimental) xref.with.number.and.title parameter to enable number/
11527     title cross references even when the default would be just the number.
11528
11529   • Generate part ToCs if they're requested.
11530
11531   • Use proportional-column-width() in header/footer tables.
11532
11533   • Handle alignment correctly when screenshot wraps a graphic in a figure.
11534
11535   • Format chapter and appendix cross references consistently.
11536
11537   • Attempt to support tables with multiple tgroups in FO.
11538
11539   • Output fo:table-columns in simplelist tables.
11540
11541   • Use titlepage.templates.xml for indexdiv and glossdiv formatting.
11542
11543   • Improve support for new bibliography elements.
11544
11545   • Added footnote.number.format, table.footnote.number.format,
11546     footnote.number.symbols, and table.footnote.number.symbols for better
11547     control of footnote markers.
11548
11549   • Added glossentry.show.acronyms.
11550
11551   • Suppress the draft-mode page masters when draft-mode is “no”.
11552
11553   • Make blank pages verso not recto. D'Oh!
11554
11555   • Improved formatting of ulink footnotes.
11556
11557   • Fixed bugs in graphic width/height calculations.
11558
11559   • Added class attributes to inline elements.
11560
11561   • Don't add “.html” to the filenames identified with the “dbhtml” PI.
11562
11563   • Don't force a ToC when sections contain refentrys.
11564
11565   • Make section title sizes a function of the body.master.size.
11566
11567 Release 1.59.2
11568
11569 The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail.
11570
11571   • Removed the region-name from the region-body of blank pages. There's no
11572     reason to give the body of blank pages a unique name and doing so causes a
11573     mismatch that FOP detects.
11574
11575   • Output IDs for the first paragraphs in listitems.
11576
11577   • Fixed some small bugs in the handling of page numbers in double-sided mode.
11578
11579   • Attempt to prevent duplicated IDs from being produced when endterm on xref
11580     points to something with nested structure.
11581
11582   • Fix aligment problems in equations.
11583
11584   • Output the type attribute on unordered lists (UL) in HTML only if the
11585     css.decoration parameter is true.
11586
11587   • Calculate the font size in formal.title.properties so that it's 1.2 times
11588     the base font size, not a fixed "12pt".
11589
11590 Release 1.59.1
11591
11592 The 1.59.1 fixes a few bugs.
11593
11594   • Added Bulgarian localization.
11595
11596   • Indexing improvements; localize book indexes to books but allow setindex to
11597     index an entire set.
11598
11599   • The default value for rowsep and colsep is now "1" as per CALS.
11600
11601   • Added support for titleabbrev (use them for cross references).
11602
11603   • Improvements to mediaobject for selecting print vs. online images.
11604
11605   • Added seperate property sets for figures, examples, equations, tabless, and
11606     procedures.
11607
11608   • Make lineannotations italic.
11609
11610   • Support xrefstyle attribute.
11611
11612   • Make endterm on xref higher priority than xreflabel target.
11613
11614   • Glossary formatting improvements.
11615
11616 Release 1.58.0
11617
11618 The 1.58.0 adds some initial support for extensions in xsltproc, adds a few
11619 features, and fixes bugs.
11620
11621   • This release contains the first attempt at extension support for xsltproc.
11622     The only extension available to date is the one that adjusts table column
11623     widths. Run extensions/xsltproc/python/xslt.py.
11624
11625   • Fixed bugs in calculation of adjusted column widths to correct for rounding
11626     errors.
11627
11628   • Support nested refsection elements correctly.
11629
11630   • Reworked gentext.template to take context into consideration. The name of
11631     elements in localization files is now an xpath-like context list, not just
11632     a simple name.
11633
11634   • Made some improvements to bibliography formatting.
11635
11636   • Improved graphical formatting of admonitions.
11637
11638   • Added support for entrytbl.
11639
11640   • Support spanning index terms.
11641
11642   • Support bibliosource.
11643
11644 Release 1.57.0
11645
11646   • The 1.57.0 release wasn't documented here. Oops.
11647
11648 Release 1.56.0
11649
11650 The 1.56.0 release fixes bugs.
11651
11652   • Reworked chunking. This will break all existing customizations layers that
11653     change the chunking algorithm. If you're customizing chunking, look at the
11654     new “content” parameter that's passed to process-chunk-element and friends.
11655
11656   • Support continued and inherited numeration in orderedlist formatting for
11657     FOs.
11658
11659   • Added Thai localization.
11660
11661   • Tweaked stylesheet documentation stylesheets to link to TDG and the
11662     parameter references.
11663
11664   • Allow title on tables of contents ("Table of Contents") to be optional.
11665     Added new keyword to generate.toc. Support tables of contents on sections.
11666
11667   • Made separate parameters for table borders and table cell borders:
11668     table.frame.border.color, table.frame.border.style,
11669     table.frame.border.thickness, table.cell.border.color,
11670     table.cell.border.style, and table.cell.border.thickness.
11671
11672   • Suppress formatting of “endofrange” indexterms. This is only half-right.
11673     They should generate a range, but I haven't figured out how to do that yet.
11674
11675   • Support revdescription. (Bug #582192)
11676
11677   • Added default.float.class and fixed figure floats. (Bug #497603)
11678
11679   • Fixed formatting of sbr in FOs.
11680
11681   • Added context to the “missing template” error message.
11682
11683   • Process arg correctly in a group. (Bug #605150)
11684
11685   • Removed 'keep-with-next' from formal.title.properties attribute set now
11686     that the stylesheets support the option of putting such titles below the
11687     object. Now the $placement value determines if 'keep-with-next' or
11688     'keep-with-previous' is used in the title block.
11689
11690   • Wrap “url()” around external-destinations when appropriate.
11691
11692   • Fixed typo in compact list spacing. (Bug #615464)
11693
11694   • Removed spurious hash in anchor name. (Bug #617717)
11695
11696   • Address is now displayed verbatim on title pages. (Bug #618600)
11697
11698   • The bridgehead.in.toc parameter is now properly supported.
11699
11700   • Improved effectiveness of HTML cleanup by increasing the number of places
11701     where it is used. Improve use of HTML cleanup in XHTML stylesheets.
11702
11703   • Support table of contents for appendix in article. (Bug #596599)
11704
11705   • Don't duplicate footnotes in bibliographys and glossarys. (Bug #583282)
11706
11707   • Added default.image.width. (Bug #516859)
11708
11709   • Totally reworked funcsynopsis code; it now supports a 'tabular'
11710     presentation style for 'wide' prototypes; see
11711     funcsynopsis.tabular.threshold. (HTML only right now, I think, FO support,
11712     uh, real soon now.)
11713
11714   • Reworked support for difference marking; toned down the colors a bit and
11715     added a “system.head.content” template so that the diff CSS wasn't
11716     overriding “user.head.content”. (Bug #610660)
11717
11718   • Added call to the “*.head.content” elements when writing out long
11719     description chunks.
11720
11721   • Make sure legalnotice link is correct even when chunking to a different
11722     base.dir.
11723
11724   • Use CSS to set viewport characteristics if css.decoration is non-zero, use
11725     div instead of p for making graphic a block element; make figure titles the
11726     default alt text for images in a figure.
11727
11728   • Added space-after to list.block.spacing.
11729
11730   • Reworked section.level template to give “correct” answer instead of being
11731     off by one.
11732
11733   • When processing tables, use the tabstyle attribute as the division class.
11734
11735   • Fixed bug in html2xhtml.xsl that was causing the XHTML chunker to output
11736     HTML instead of XHTML.
11737
11738 Older releases
11739
11740 To view the release notes for older releases, see http://cvs.sourceforge.net/
11741 viewcvs.py/docbook/xsl/RELEASE-NOTES.xml. Be aware that there were no release
11742 notes for releases prior to the 1.50.0 release.
11743
11744 About dot-zero releases
11745
11746 DocBook Project “dot zero” releases should be considered experimental and are
11747 always followed by stable “dot one plus” releases, usually within two or three
11748 weeks. Please help to ensure the stability of “dot one plus” releases by
11749 carefully testing each “dot zero” release and reporting back about any problems
11750 you find.
11751
11752 It is not recommended that you use a “dot zero” release in a production system.
11753 Instead, you should wait for the “dot one” or greater versions.
11754