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