RELEASE-NOTES.txt

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