1Release Notes 2 3DocBook Project XSL Stylesheets 4 5$Revision: 1.51 $ $Date: 2006/05/24 14:39:48 $ 6 72006-05-26 8 9------------------------------------------------------------------------------ 10 11Table of Contents 12 13Release: 1.70.1 14 15 FO 16 HTML 17 HTMLHelp 18 Params 19 20Release: 1.70.0 21 22 Common 23 Extensions 24 FO 25 HTML 26 Manpages 27 Params 28 Profiling 29 Tools 30 WordML 31 32Release 1.69.1 33Release 1.69.0 34 35 Common 36 FO 37 Help 38 HTML 39 man 40 41Release 1.68.1 42Release 1.68.0 43Release 1.67.2 44Release 1.67.1 45Release 1.67.0 46Release 1.66.1 47Release 1.65.0 48Release 1.64.1 49Release 1.61.0 50Release 1.60.1 51Release 1.59.2 52Release 1.59.1 53Release 1.58.0 54Release 1.57.0 55Release 1.56.0 56Older releases 57About dot-zero releases 58 59These are the release notes for the DocBook XSL Stylesheets distribution. This 60document lists enhancements and changes to the public APIs (user-configurable 61parameters) and generally excludes descriptions of bug fixes, which are 62instead documented in a separate NEWS file. 63 64Release: 1.70.1 65 66This is a stable release of the 1.70 stylesheets. It includes only a few small 67changes from 1.70.0. 68 69The following is a list of changes that have been made since the 1.70.0 70release. 71 72FO 73 74The following changes have been made to the fo code since the 1.70.0 release. 75 76 * Added three new attribute sets (revhistory.title.properties, 77 revhistory.table.properties and revhistory.table.cell.properties) for 78 controlling appearance of revhistory in FO output. 79 80 Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; 81 fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; 82 params/revhistory.table.properties.xml,1.1; 83 params/revhistory.title.properties.xml,1.1 - Jirka Kosek 84 85 * Support DBv5 revisions with full author name (not only authorinitials) 86 87 Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek 88 89HTML 90 91The following changes have been made to the html code since the 1.70.0 92release. 93 94 * Support DBv5 revisions with full author name (not only authorinitials) 95 96 Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek 97 98HTMLHelp 99 100The following changes have been made to the htmlhelp code since the 1.70.0 101release. 102 103 * htmlhelp.generate.index is now param, not variable. This means that you 104 can override its setting from outside. This is useful when you generate 105 indexterms on the fly (see 106 http://www.xml.com/pub/a/2004/07/14/dbndx.html?page=3). 107 108 Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek 109 110 * Support chunk.tocs.and.lots in HTML Help 111 112 Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek 113 114Params 115 116The following changes have been made to the params code since the 1.70.0 117release. 118 119 * Added three new attribute sets (revhistory.title.properties, 120 revhistory.table.properties and revhistory.table.cell.properties) for 121 controlling appearance of revhistory in FO output. 122 123 Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; 124 fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; 125 params/revhistory.table.properties.xml,1.1; 126 params/revhistory.title.properties.xml,1.1 - Jirka Kosek 127 128Release: 1.70.0 129 130As with all DocBook Project dot-zero releases, this is an experimental 131release. It will be followed shortly by a stable release. 132 133This release adds a number of new features, including: 134 135 * support for selecting alternative index-collation methods (in particular, 136 support for using a collation library developed by Eliot Kimber) 137 138 * improved handling of DocBook 5 document instances (through a 139 namespace-stripping mechanism) 140 141 * full support for CALS and HTML tables in manpages output 142 143 * a mechanism for preserving relative URIs in documents that make use of 144 XInclude 145 146 * support for the "new" .90 version of FOP 147 148 * enhanced capabilities for controlling formatting of lists in HTML and FO 149 output 150 151 * autogeneration of AUTHOR and COPYRIGHT sections in manpages output 152 153 * support for generating crop marks in FO/PDF output 154 155 * support for qandaset as a root element in FO output 156 157 * support for floatstyle and orient on all table types 158 159 * support for floatstyle in figure, and example 160 161 * pgwide.properties attribute-set supports extending figure, example and 162 table into the left indent area instead of spanning multiple columns. 163 164The following is a detailed list of enhancements and API changes that have 165been made since the 1.69.1 release. 166 167Common 168 169The following changes have been made to the common code since the 1.69.1 170release. 171 172 * Add the xsl:key for the kimber indexing method. 173 174 Modified: common/autoidx-ng.xsl,1.2 - Robert Stayton 175 176 * Add support for qandaset. 177 178 Modified: common/labels.xsl,1.37; common/subtitles.xsl,1.7; 179 common/titles.xsl,1.35 - Robert Stayton 180 181 * Support dbhtml/dbfo start PI for orderedlist numbering in both HTML and FO 182 183 Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman Walsh 184 185 * Added CVS header. 186 187 Modified: common/stripns.xsl,1.12 - Robert Stayton 188 189 * Changed content model of text element to ANY rather than #PCDATA because 190 they could contain markup. 191 192 Modified: common/targetdatabase.dtd,1.7 - Robert Stayton 193 194 * Added refentry.meta.get.quietly param. 195 196 If zero (the default), notes and warnings about "missing" markup are 197 generated during gathering of refentry metadata. If non-zero, the metadata 198 is gathered "quietly" -- that is, the notes and warnings are suppressed. 199 200 NOTE: If you are processing a large amount of refentry content, you may be 201 able to speed up processing significantly by setting a non-zero value for 202 refentry.meta.get.quietly. 203 204 Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; 205 manpages/param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - 206 Michael(tm) Smith 207 208 * After namespace stripping, the source document is the temporary tree 209 created by the stripping process and it has the wrong base URI for 210 relative references. Earlier versions of this code used to try to fix that 211 by patching the elements with relative @fileref attributes. That was 212 inadequate because it calculated an absolute base URI without considering 213 that there might be xml:base attributes already in effect. It seems 214 obvious now that the right thing to do is simply to put the xml:base on 215 the root of the document. And that seems to work. 216 217 Modified: common/stripns.xsl,1.7 - Norman Walsh 218 219 * Added support for "software" and "sectdesc" class values on refmiscinfo; 220 "software" is treated identically to "source", and "setdesc" is treated 221 identically to "manual". 222 223 Modified: common/refentry.xsl,1.10; 224 params/man.th.extra2.max.length.xml,1.3; 225 params/refentry.source.name.profile.xml,1.4 - Michael(tm) Smith 226 227 * Added support for DocBook 5 namespace-stripping in manpages stylesheet. 228 Closes request #1210692. 229 230 Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm) 231 Smith 232 233 * Added <xsl:template match="/"> to make stripns.xsl usable as a standalone 234 stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that DocBook 235 XSLT drivers that include this stylesheet all override the match="/" 236 template. 237 238 Modified: common/stripns.xsl,1.4 - Michael(tm) Smith 239 240 * Number figures, examples, and tables from book if there is no prefix (i.e. 241 if chapter.autolabel is set to 0). This avoids having the list of figures 242 where the figures mysteriously restart their numeration periodically when 243 chapter.autolabel is set to 0. 244 245 Modified: common/labels.xsl,1.36 - David Cramer 246 247 * Add task template in title.markup mode. 248 249 Modified: common/titles.xsl,1.34 - Robert Stayton 250 251 * Add children (with ids) of formal objects to target data. 252 253 Modified: common/targets.xsl,1.10 - Robert Stayton 254 255 * Added support for case when personname doesn't contain specific name 256 markup (as allowed in DocBook 5.0) 257 258 Modified: common/common.xsl,1.54 - Jirka Kosek 259 260Extensions 261 262The following changes have been made to the extensions code since the 1.69.1 263release. 264 265 * Support Xalan 2.7 266 267 Modified: extensions/xalan27/.cvsignore,1.1; 268 extensions/xalan27/build.xml,1.1; 269 extensions/xalan27/nbproject/.cvsignore,1.1; 270 extensions/xalan27/nbproject/build-impl.xml,1.1; 271 extensions/xalan27/nbproject/genfiles.properties,1.1; 272 extensions/xalan27/nbproject/project.properties,1.1; 273 extensions/xalan27/nbproject/project.xml,1.1; 274 extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1; 275 extensions/xalan27/src/com/nwalsh/xalan/Callout.java,1.1; 276 extensions/xalan27/src/com/nwalsh/xalan/FormatCallout.java,1.1; 277 extensions/xalan27/src/com/nwalsh/xalan/FormatDingbatCallout.java,1.1; 278 extensions/xalan27/src/com/nwalsh/xalan/FormatGraphicCallout.java,1.1; 279 extensions/xalan27/src/com/nwalsh/xalan/FormatTextCallout.java,1.1; 280 extensions/xalan27/src/com/nwalsh/xalan/FormatUnicodeCallout.java,1.1; 281 extensions/xalan27/src/com/nwalsh/xalan/Func.java,1.1; 282 extensions/xalan27/src/com/nwalsh/xalan/ImageIntrinsics.java,1.1; 283 extensions/xalan27/src/com/nwalsh/xalan/Params.java,1.1; 284 extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1; 285 extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1; 286 extensions/xalan27/src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman Walsh 287 288 * Handle the case where the imageFn is actually a URI. This still needs 289 work. 290 291 Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4 - 292 Norman Walsh 293 294FO 295 296The following changes have been made to the fo code since the 1.69.1 release. 297 298 * Adapted to the new indexing code. Now works just like a wrapper that calls 299 kosek indexing method, originally implemented here. 300 301 Modified: fo/autoidx-ng.xsl,1.5 - Jirka Kosek 302 303 * Added parameters for header/footer table minimum height. 304 305 Modified: fo/pagesetup.xsl,1.60; fo/param.ent,1.100; fo/param.xweb,1.113 - 306 Robert Stayton 307 308 * Add the index.method parameter. 309 310 Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert Stayton 311 312 * Integrate support for three indexing methods: - the original English-only 313 method. - Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's 314 method using Saxon extensions. Use the 'index.method' parameter to select. 315 316 Modified: fo/autoidx.xsl,1.38 - Robert Stayton 317 318 * Add support for TOC for qandaset in fo output. 319 320 Modified: fo/autotoc.xsl,1.30; fo/qandaset.xsl,1.20 - Robert Stayton 321 322 * Added parameter ulink.hyphenate.chars. Added parameter insert.link 323 .page.number. 324 325 Modified: fo/param.ent,1.98; fo/param.xweb,1.111 - Robert Stayton 326 327 * Implemented feature request #942524 to add insert.link.page.number to 328 allow link element cross references to have a page number. 329 330 Modified: fo/xref.xsl,1.67 - Robert Stayton 331 332 * Add support for ulink.hyphenate.chars so more characters can be break 333 points in urls. 334 335 Modified: fo/xref.xsl,1.66 - Robert Stayton 336 337 * Implemented patch #1075144 to make the url text in a ulink in FO output an 338 active link as well. 339 340 Modified: fo/xref.xsl,1.65 - Robert Stayton 341 342 * table footnotes now have their own table.footnote.properties attribute 343 set. 344 345 Modified: fo/footnote.xsl,1.23 - Robert Stayton 346 347 * Add qandaset to root.elements. 348 349 Modified: fo/docbook.xsl,1.41 - Robert Stayton 350 351 * Added mode="page.sequence" to make it easier to put content into a page 352 sequence. First used for qandaset. 353 354 Modified: fo/component.xsl,1.37 - Robert Stayton 355 356 * Implemented feature request #1434408 to support formatting of biblioentry. 357 358 Modified: fo/biblio.xsl,1.35 - Robert Stayton 359 360 * Added biblioentry.properties. 361 362 Modified: fo/param.ent,1.97; fo/param.xweb,1.110 - Robert Stayton 363 364 * Support PTC/Arbortext bookmarks 365 366 Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman Walsh 367 368 * Added table.footnote.properties to permit table footnotes to format 369 differently from regular footnotes. 370 371 Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert Stayton 372 373 * Refactored table templates to unify their processing and support all 374 options in all types. Now table and informaltable, in both Cals and Html 375 markup, use the same templates where possible, and all support pgwide, 376 rotation, and floats. There is also a placeholder table.container template 377 to support wrapping a table in a layout table, so the XEP table title 378 "continued" extension can be more easily implemented. 379 380 Modified: fo/formal.xsl,1.52; fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 - 381 Robert Stayton 382 383 * Added new attribute set toc.line.properties for controlling appearance of 384 lines in ToC/LoT 385 386 Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95; fo/param.xweb,1.108 - 387 Jirka Kosek 388 389 * Added support for float to example and equation. Added support for pgwide 390 to figure, example, and equation (the latter two via a dbfo pgwide="1" 391 processing instruction). 392 393 Modified: fo/formal.xsl,1.51 - Robert Stayton 394 395 * Add pgwide.properties attribute-set. 396 397 Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert Stayton 398 399 * Added refclass.suppress param. 400 401 If the value of refclass.suppress is non-zero, then display refclass 402 contents is suppressed in output. Affects HTML and FO output only. 403 404 Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; 405 html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith 406 407 * Improved support for task subelements 408 409 Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - Jirka Kosek 410 411 * Adjusted spacing around K&R-formatted Funcdef and Paramdef output such 412 that it can more easily be discerned where one ends and the other begins. 413 Closes #1213264. 414 415 Modified: fo/synop.xsl,1.18 - Michael(tm) Smith 416 417 * Made handling of paramdef/parameter in FO output consistent with that in 418 HTML and manpages output. Closes #1213259. 419 420 Modified: fo/synop.xsl,1.17 - Michael(tm) Smith 421 422 * Made handling of Refnamediv consistent with formatting in HTML and 423 manpages output; specifically, changed so that Refname (comma-separated 424 list of multiple instances found) is used (instead of Refentrytitle as 425 previously), then em-dash, then the Refpurpose. Closes #1212562. 426 427 Modified: fo/refentry.xsl,1.30 - Michael(tm) Smith 428 429 * Added output of Releaseinfo to recto titlepage ("copyright" page) for Book 430 in FO output. This makes it consistent with HTML output. Closes #1327034. 431 Thanks to Paul DuBois for reporting. 432 433 Modified: fo/titlepage.templates.xml,1.28 - Michael(tm) Smith 434 435 * Added condition for setting block-progression-dimension.minimum on 436 table-row, instead of height, when fop1.extensions is non-zero. For an 437 explanation of the reason for the change, see: 438 http://wiki.apache.org/xmlgraphics-fop/Troubleshooting/CommonLogMessages 439 440 Modified: fo/pagesetup.xsl,1.59 - Michael(tm) Smith 441 442 * Added new refclass.suppress param for suppressing display of Refclass in 443 HTML and FO output. Did not add it to manpages because manpages stylesheet 444 is currently just silently ignoring Refclass anyway. Closes request 445 #1461065. Thanks to Davor Ocelic (docelic) for reporting. 446 447 Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - Michael(tm) Smith 448 449 * Add support for keep-together PI to informal objects. 450 451 Modified: fo/formal.xsl,1.50 - Robert Stayton 452 453 * Add support for fop1.extensions. 454 455 Modified: fo/formal.xsl,1.49; fo/graphics.xsl,1.44; fo/table.xsl,1.47 - 456 Robert Stayton 457 458 * Add support for fop1 bookmarks. 459 460 Modified: fo/docbook.xsl,1.39 - Robert Stayton 461 462 * Add fop1.extentions parameter to add support for fop development version. 463 464 Modified: fo/param.ent,1.92; fo/param.xweb,1.105 - Robert Stayton 465 466 * Start supporting fop development version, which will become fop version 1. 467 468 Modified: fo/fop1.xsl,1.1 - Robert Stayton 469 470 * Add template for task in mode="xref-to". 471 472 Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert Stayton 473 474 * table footnotes now also get footnote.properties attribute-set. 475 476 Modified: fo/footnote.xsl,1.22 - Robert Stayton 477 478 * Added index.separator named template to compute the separator punctuation 479 based on locale. 480 481 Modified: fo/autoidx.xsl,1.36 - Robert Stayton 482 483 * Added support for link, olink, and xref within OO Classsynopsis and 484 children. (Because DocBook NG/5 allows it). 485 486 Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith 487 488 * Support date as an inline 489 490 Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh 491 492 * Added new parameter keep.relative.image.uris 493 494 Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; 495 html/param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman 496 Walsh 497 498 * Map Unicode space characters U+2000-U+200A to fo:leaders. 499 500 Modified: fo/docbook.xsl,1.38; fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 - 501 Jirka Kosek 502 503 * Output a real em dash for em-dash dingbat (instead of two hypens). 504 505 Modified: fo/fo.xsl,1.7 - Michael(tm) Smith 506 507 * Support default label width parameters for itemized and ordered lists 508 509 Modified: fo/lists.xsl,1.64; fo/param.ent,1.90; fo/param.xweb,1.103; 510 params/itemizedlist.label.width.xml,1.1; 511 params/orderedlist.label.width.xml,1.1 - Norman Walsh 512 513 * Generate localized title for Refsynopsisdiv if no appropriate Title 514 descendant found in source. Closes #1212398. This change makes behavior 515 for the Synopsis title consistent with the behavior of HTML and manpages 516 output. 517 518 Also, added xsl:use-attribute-sets="normal.para.spacing" to block 519 generated for Cmdsynopsis output. Previously, that block had no spacing at 520 all specified, which resulted it being crammed up to closely to the 521 Synopsis head. 522 523 Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm) Smith 524 525 * Added parameters to support localization of index item punctuation. 526 527 Modified: fo/autoidx.xsl,1.35 - Robert Stayton 528 529 * Added index.number.separator, index.range.separator, and 530 index.term.separator parameters to support localization of punctuation in 531 index entries. 532 533 Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert Stayton 534 535 * Added "Cross References" section in HTML doc (for consistency with the FO 536 doc). Also, moved the existing FO "Cross References" section to follow the 537 "Linking" section. 538 539 Modified: fo/param.xweb,1.101; html/param.xweb,1.95 - Michael(tm) Smith 540 541 * Added ID attribues to all Reference elements (e.g., id="tables" for the 542 doc for section on Table params). So pages for all subsections of ref docs 543 now have stable filenames instead of arbitrary generated filenames. 544 545 Modified: fo/param.xweb,1.100; html/param.xweb,1.94 - Michael(tm) Smith 546 547 * Added two new parameters for handling of multi-term varlistentry elements: 548 549 variablelist.term.break.after: When the variablelist.term.break.after is 550 non-zero, it will generate a line break after each term multi-term 551 varlistentry. 552 553 variablelist.term.separator: When a varlistentry contains multiple term 554 elements, the string specified in the value of the 555 variablelist.term.separator parameter is placed after each term except the 556 last. The default is ", " (a comma followed by a space). To suppress 557 rendering of the separator, set the value of variablelist.term.separator 558 to the empty string (""). 559 560 These parameters are primarily intended to be useful if you have 561 multi-term varlistentries that have long terms. 562 563 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of 564 long terms" doc that demonstrated the value of having these options. 565 566 Also, added normalize-space() call to processing of each term. 567 568 This change affects all output formats (HTML, PDF, manpages). The default 569 behavior should pretty much remain the same as before, but it is possible 570 (as always) that the change may introduce some new bugginess. 571 572 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; 573 html/lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; 574 manpages/lists.xsl,1.22; manpages/param.ent,1.14; 575 manpages/param.xweb,1.16; params/variablelist.term.break.after.xml,1.1; 576 params/variablelist.term.separator.xml,1.1 - Michael(tm) Smith 577 578 * Add sidebar titlepage placeholder attset for styles. 579 580 Modified: fo/titlepage.xsl,1.37 - Robert Stayton 581 582 * Add titlepage for sidebar. 583 584 Modified: fo/titlepage.templates.xml,1.27 - Robert Stayton 585 586 * Implemented RFE #1292615. 587 588 Added bunch of new parameters (attribute sets) that affect list 589 presentation: list.block.properties, itemizedlist.properties, orderedlist 590 .properties, itemizedlist.label.properties and orderedlist.label 591 .properties. Default behaviour of stylesheets has not been changed but 592 further customizations will be much more easier. 593 594 Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; 595 params/itemizedlist.label.properties.xml,1.1; 596 params/itemizedlist.properties.xml,1.1; 597 params/list.block.properties.xml,1.1; 598 params/orderedlist.label.properties.xml,1.1; 599 params/orderedlist.properties.xml,1.1 - Jirka Kosek 600 601 * Implemented RFE #1242092. 602 603 You can enable crop marks in your document by setting crop.marks=1 and 604 xep.extensions=1. Appearance of crop marks can be controlled by parameters 605 crop.mark.bleed (6pt), crop.mark.offset (24pt) and crop.mark.width 606 (0.5pt). 607 608 Also there is new named template called user-xep-pis. You can overwrite it 609 in order to produce some PIs that can control XEP as described in 610 http://www.renderx.com/reference.html#Output_Formats 611 612 Modified: fo/docbook.xsl,1.36; fo/param.ent,1.86; fo/param.xweb,1.97; 613 fo/xep.xsl,1.23; params/crop.mark.bleed.xml,1.1; 614 params/crop.mark.offset.xml,1.1; params/crop.mark.width.xml,1.1; 615 params/crop.marks.xml,1.1 - Jirka Kosek 616 617HTML 618 619The following changes have been made to the html code since the 1.69.1 620release. 621 622 * implemented index.method parameter and three methods. 623 624 Modified: html/autoidx.xsl,1.28 - Robert Stayton 625 626 * added index.method parameter to support 3 indexing methods. 627 628 Modified: html/param.ent,1.94; html/param.xweb,1.103 - Robert Stayton 629 630 * Implemented feature request #1072510 as a processing instruction to permit 631 including external HTML content into HTML output. 632 633 Modified: html/pi.xsl,1.9 - Robert Stayton 634 635 * Added new parameter chunk.tocs.and.lots.has.title which controls presence 636 of title in a separate chunk with ToC/LoT. Disabling title can be very 637 useful if you are generating frameset output (well, yes those frames, but 638 some customers really want them ;-). 639 640 Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; 641 html/param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - 642 Jirka Kosek 643 644 * Support dbhtml/dbfo start PI for orderedlist numbering in both HTML and FO 645 646 Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman Walsh 647 648 * Allow ToC without title also for set and book. 649 650 Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 - Jirka Kosek 651 652 * Implemented floats uniformly for figure, example, equation and 653 informalfigure, informalexample, and informalequation. 654 655 Modified: html/formal.xsl,1.22 - Robert Stayton 656 657 * Added the autotoc.label.in.hyperlink param. 658 659 If the value of autotoc.label.in.hyperlink is non-zero, labels are 660 included in hyperlinked titles in the TOC. If it is instead zero, labels 661 are still displayed prior to the hyperlinked titles, but are not 662 hyperlinked along with the titles. 663 664 Closes patch #1065868. Thanks to anatoly techtonik for the patch. 665 666 Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; 667 html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - 668 Michael(tm) Smith 669 670 * Added two new params: html.head.legalnotice.link.types and html.head. 671 legalnotice.link.multiple. 672 673 If the value of the generate.legalnotice.link is non-zero, then the 674 stylesheet generates (in the head section of the HTML source) either a 675 single HTML link element or, if the value of the html.head.legalnotice. 676 link.multiple is non-zero, one link element for each link type specified. 677 Each link has the following attributes: 678 679 - a rel attribute whose value is derived from the value of html.head. 680 legalnotice.link.types 681 682 - an href attribute whose value is set to the URL of the file containing 683 the legalnotice 684 685 - a title attribute whose value is set to the title of the corresponding 686 legalnotice (or a title programatically determined by the stylesheet) 687 688 For example: 689 690 <link rel="copyright" href="ln-id2524073.html" title="Legal Notice"> 691 692 Closes #1476450. Thanks to Sam Steingold. 693 694 Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; 695 html/param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; 696 params/html.head.legalnotice.link.multiple.xml,1.1; 697 params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith 698 699 * Added refclass.suppress param. 700 701 If the value of refclass.suppress is non-zero, then display refclass 702 contents is suppressed in output. Affects HTML and FO output only. 703 704 Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; 705 html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith 706 707 * Improved support for task subelements 708 709 Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - Jirka Kosek 710 711 * Added new refclass.suppress param for suppressing display of Refclass in 712 HTML and FO output. Did not add it to manpages because manpages stylesheet 713 is currently just silently ignoring Refclass anyway. Closes request 714 #1461065. Thanks to Davor Ocelic (docelic) for reporting. 715 716 Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - Michael(tm) Smith 717 718 * Process alt text with normalize-space(). Replace tab indents with spaces. 719 720 Modified: html/graphics.xsl,1.57 - Robert Stayton 721 722 * Content of citation element is automatically linked to the bibliographic 723 entry with the corresponding abbrev. 724 725 Modified: html/biblio.xsl,1.26; html/inline.xsl,1.47; html/xref.xsl,1.58 - 726 Jirka Kosek 727 728 * Add template for task in mode="xref-to". 729 730 Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert Stayton 731 732 * Suppress ID warnings if the .warnings parameter is 0 733 734 Modified: html/html.xsl,1.17 - Norman Walsh 735 736 * Add support for floatstyle to figure. 737 738 Modified: html/formal.xsl,1.21 - Robert Stayton 739 740 * Handling of xref to area/areaset need support in extensions code also. I 741 currently have no time to touch extensions code, so code is here to be 742 enabled when extension is fixed also. 743 744 Modified: html/xref.xsl,1.56 - Jirka Kosek 745 746 * Added 3 parameters for overriding gentext for index punctuation. 747 748 Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert Stayton 749 750 * Added parameters to support localization of index item punctuation. Added 751 index.separator named template to compute the separator punctuation based 752 on locale. 753 754 Modified: html/autoidx.xsl,1.27 - Robert Stayton 755 756 * Added a <div class="{$class}-contents"> wrapper around output of contents 757 of all formal objects. Also, added an optional <br class="{class}-break"/> 758 linebreak after all formal objects. 759 760 WARNING: Because this change places an additional DIV between the DIV 761 wrapper for the equation and the equation contents, it may break some 762 existing CSS stylesheets that have been created with the assumption that 763 there would never be an intervening DIV there. 764 765 The following is an example of what Equation output looks like as a result 766 of the changes described above. 767 768 <div class="equation"> <a name="three" id="three"></a> 769 770 <p class="title"><b>(1.3)</b></p> 771 772 <div class="equation-contents"> <span class="mathphrase">1+1=3</span> 773 </div> </div><br class="equation-break"> 774 775 Rationale: These changes allow CSS control of the placement of the 776 formal-object title relative to the formal-object contents. For example, 777 using the CSS "float" property enables the title and contents to be 778 rendered on the same line. Example stylesheet: 779 780 .equation { margin-top: 20px; margin-bottom: 20px; } .equation-contents { 781 float: left; } 782 783 .equation .title { margin-top: 0; float: right; margin-right: 200px; } 784 785 .equation .title b { font-weight: normal; } 786 787 .equation-break { clear: both; } 788 789 Note that the purpose of the ".equation-break" class is to provide a way 790 to clear off the floats. 791 792 If you want to instead have the equation title rendered to the left of the 793 equation contents, you can do something like this: 794 795 .equation { margin-top: 20px; width: 300px; margin-bottom: 20px; } 796 .equation-contents { float: right; } 797 798 .equation .title { margin-top: 0; float: left; margin-right: 200px; } 799 800 .equation .title b { font-weight: normal; } 801 802 .equation-break { clear: both; } 803 804 Modified: html/formal.xsl,1.20 - Michael(tm) Smith 805 806 * Added a chunker.output.quiet top-level parameter so that the chunker can 807 be made quiet by default 808 809 Modified: html/chunker.xsl,1.26 - Norman Walsh 810 811 * Added support for link, olink, and xref within OO Classsynopsis and 812 children. (Because DocBook NG/5 allows it). 813 814 Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith 815 816 * New parameter: id.warnings. If non-zero, warnings are generated for titled 817 objects that don't have titles. True by default; I wonder if this will be 818 too aggressive? 819 820 Modified: html/biblio.xsl,1.25; html/component.xsl,1.27; 821 html/division.xsl,1.11; html/formal.xsl,1.19; html/glossary.xsl,1.20; 822 html/html.xsl,1.13; html/index.xsl,1.16; html/param.ent,1.88; 823 html/param.xweb,1.97; html/refentry.xsl,1.22; html/sections.xsl,1.30; 824 params/id.warnings.xml,1.1 - Norman Walsh 825 826 * If the keep.relative.image.uris parameter is true, don't use the absolute 827 URI (as calculated from xml:base) in the img src attribute, us the value 828 the author specified. Note that we still have to calculate the absolute 829 filename for use in the image intrinsics extension. 830 831 Modified: html/graphics.xsl,1.56 - Norman Walsh 832 833 * Support date as an inline 834 835 Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh 836 837 * Added new parameter keep.relative.image.uris 838 839 Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; 840 html/param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman 841 Walsh 842 843 * Added two new parameters for handling of multi-term varlistentry elements: 844 845 variablelist.term.break.after: When the variablelist.term.break.after is 846 non-zero, it will generate a line break after each term multi-term 847 varlistentry. 848 849 variablelist.term.separator: When a varlistentry contains multiple term 850 elements, the string specified in the value of the 851 variablelist.term.separator parameter is placed after each term except the 852 last. The default is ", " (a comma followed by a space). To suppress 853 rendering of the separator, set the value of variablelist.term.separator 854 to the empty string (""). 855 856 These parameters are primarily intended to be useful if you have 857 multi-term varlistentries that have long terms. 858 859 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of 860 long terms" doc that demonstrated the value of having these options. 861 862 Also, added normalize-space() call to processing of each term. 863 864 This change affects all output formats (HTML, PDF, manpages). The default 865 behavior should pretty much remain the same as before, but it is possible 866 (as always) that the change may introduce some new bugginess. 867 868 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; 869 html/lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; 870 manpages/lists.xsl,1.22; manpages/param.ent,1.14; 871 manpages/param.xweb,1.16; params/variablelist.term.break.after.xml,1.1; 872 params/variablelist.term.separator.xml,1.1 - Michael(tm) Smith 873 874 * Added "wrapper-name" param to inline.charseq named template, enabling it 875 to output inlines other than just "span". Acronym and Abbrev templates now 876 use inline.charseq to output HTML "acronym" and "abbr" elements (instead 877 of "span"). Closes #1305468. Thanks to Sam Steingold for suggesting the 878 change. 879 880 Modified: html/inline.xsl,1.45 - Michael(tm) Smith 881 882Manpages 883 884The following changes have been made to the manpages code since the 1.69.1 885release. 886 887 * Added the following params: 888 889 - man.indent.width (string-valued) - man.indent.refsect (boolean) - 890 man.indent.blurbs (boolean) - man.indent.lists (boolean) - 891 man.indent.verbatims (boolean) 892 893 Note that in earlier snapshots, man.indent.width was named 894 man.indentation.default.value and the boolean params had names like 895 man.indentation.*.adjust. Also the man.indent.blurbs param was called 896 man.indentation.authors.adjust (or something). 897 898 The behavior now is: If the value of a particular man.indent.* boolean 899 param is non-zero, the corresponding contents (refsect*, list items, 900 authorblurb/personblurb, vervatims) are displayed with a left margin 901 indented by a width equal to the value of man.indent.width. 902 903 Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74; 904 manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20; 905 manpages/param.ent,1.22; manpages/param.xweb,1.24; 906 manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1; 907 params/man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; 908 params/man.indent.width.xml,1.1 - Michael(tm) Smith 909 910 * Added man.table.footnotes.divider param. 911 912 In each table that contains footenotes, the string specified by the man. 913 table.footnotes.divider parameter is output before the list of footnotes 914 for the table. 915 916 Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; 917 manpages/param.ent,1.21; manpages/param.xweb,1.23; 918 params/man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith 919 920 * Added the man.output.in.separate.dir, man.output.base.dir, and 921 man.output.subdirs.enabled parameters. 922 923 The man.output.base.dir parameter specifies the base directory into which 924 man-page files are output. The man.output.subdirs.enabled parameter 925 controls whether the files are output in subdirectories within the base 926 directory. 927 928 The values of the man.output.base.dir and man.output.subdirs.enabled 929 parameters are used only if the value of man.output.in.separate.dir 930 parameter is non-zero. If the value of man.output.in.separate.dir is zero, 931 man-page files are not output in a separate directory. 932 933 Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; 934 manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1; 935 params/man.output.in.separate.dir.xml,1.1; 936 params/man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith 937 938 * Added man.font.table.headings and man.font.table.title params, for 939 controlling font in table headings and titles. 940 941 Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; 942 manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1; 943 params/man.font.table.title.xml,1.1 - Michael(tm) Smith 944 945 * Added man.font.funcsynopsisinfo and man.font.funcprototype params, for 946 specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and 947 funcprototype output. 948 949 Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; 950 manpages/param.ent,1.18; manpages/param.xweb,1.20; 951 manpages/synop.xsl,1.29; manpages/table.xsl,1.21; 952 params/man.font.funcprototype.xml,1.1; 953 params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith 954 955 * Added man.segtitle.suppress param. 956 957 If the value of man.segtitle.suppress is non-zero, then display of 958 segtitle contents is suppressed in output. 959 960 Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; 961 manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - 962 Michael(tm) Smith 963 964 * Added man.output.manifest.enabled and man.output.manifest.filename params. 965 966 If man.output.manifest.enabled is non-zero, a list of filenames for man 967 pages generated by the stylesheet transformation is written to the file 968 named by man.output.manifest.filename 969 970 Modified: manpages/docbook.xsl,1.67; manpages/other.xsl,1.19; 971 manpages/param.ent,1.16; manpages/param.xweb,1.18; 972 params/man.output.manifest.enabled.xml,1.1; 973 params/man.output.manifest.filename.xml,1.1; 974 tools/make/Makefile.DocBook,1.4 - Michael(tm) Smith 975 976 * Added refentry.meta.get.quietly param. 977 978 If zero (the default), notes and warnings about "missing" markup are 979 generated during gathering of refentry metadata. If non-zero, the metadata 980 is gathered "quietly" -- that is, the notes and warnings are suppressed. 981 982 NOTE: If you are processing a large amount of refentry content, you may be 983 able to speed up processing significantly by setting a non-zero value for 984 refentry.meta.get.quietly. 985 986 Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; 987 manpages/param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - 988 Michael(tm) Smith 989 990 * Changed names of all boolean indentation params to man.indent.* Also 991 discarded individual man.indent.*.value params and switched to just using 992 a common man.indent.width param (3n by default). 993 994 Modified: manpages/docbook.xsl,1.66; manpages/info.xsl,1.19; 995 manpages/lists.xsl,1.29; manpages/other.xsl,1.18; 996 manpages/refentry.xsl,1.13 - Michael(tm) Smith 997 998 * Added boolean man.output.in.separate.dir param, to control whether or not 999 man files are output in separate directory. 1000 1001 Modified: manpages/docbook.xsl,1.65; manpages/utility.xsl,1.14 - 1002 Michael(tm) Smith 1003 1004 * Added options for controlling indentation of verbatim output. Controlled 1005 through the man.indentation.verbatims.adjust and 1006 man.indentation.verbatims.value params. Closes #1242997 1007 1008 Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 - Michael(tm) 1009 Smith 1010 1011 * Added options for controlling indentation in lists and in *blurb output in 1012 the AUTHORS section. Controlled through the man.indentation.lists.adjust, 1013 man.indentation.lists.value, man.indentation.authors.adjust, and 1014 man.indentation.authors.value parameters. Default is 3 characters (instead 1015 of the roff default of 8 characters). Closes #1449369. 1016 1017 Also, removed the indent that was being set on informalexample outuput. I 1018 will instead add an option for indenting verbatims, which I think is what 1019 the informalexample indent was intended for originally. 1020 1021 Modified: manpages/block.xsl,1.14; manpages/docbook.xsl,1.63; 1022 manpages/info.xsl,1.18; manpages/lists.xsl,1.28 - Michael(tm) Smith 1023 1024 * Changed line-spacing call before synopfragment to use ".sp -1n" ("n" units 1025 specified) instead of plain ".sp -1" 1026 1027 Modified: manpages/synop.xsl,1.28 - Michael(tm) Smith 1028 1029 * Added support for writing man files into a specific output directory and 1030 into appropriate subdirectories within that output directory. Controlled 1031 through the man.base.dir parameter (similar to the base.dir support in the 1032 HTML stylesheet) and the man.subdirs.enabled parameter, which 1033 automatically determines the name of an appropriate subdir (for example, 1034 man/man7, man/man1, etc.) based on the section number/manvolnum of the 1035 source Refentry. 1036 1037 Closes #1255036 and #1170317. Thanks to Denis Bradford for the original 1038 feature request, and to Costin Stroie for submitting a patch that was very 1039 helpful in implementing the support. 1040 1041 Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 - 1042 Michael(tm) Smith 1043 1044 * Refined XPath statements and notification messages for refentry metadata 1045 handling. 1046 1047 Modified: common/common.xsl,1.59; common/refentry.xsl,1.14; 1048 manpages/docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm) Smith 1049 1050 * Added support for copyright and legalnotice. The manpages stylesheets now 1051 output a COPYRIGHT section, after the AUTHORS section, if a copyright or 1052 legalnotice is found in the source. The section contains the copyright 1053 contents followed by the legalnotice contents. Closes #1450209. 1054 1055 Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 - Michael(tm) 1056 Smith 1057 1058 * Drastically reworked all of the XPath expressions used in refentry 1059 metadata gathering -- completely removed $parentinfo and turned $info into 1060 a set of nodes that includes the *info contents of the Refentry plus the 1061 *info contents all all of its ancestor elements. The basic XPath 1062 expression now used throughout is (using the example of checking for a 1063 date): 1064 1065 (($info[//date])[last()]/date)[1]. 1066 1067 That selects the "last" *info/date date in document order -- that is, the 1068 one eitther on the Refentry itself or on the closest ancestor to the 1069 Refentry. 1070 1071 It's likely this change may break some things; may need to pick up some 1072 pieces later. 1073 1074 Also, changed the default value for the man.th.extra2.max.length from 40 1075 to 30. 1076 1077 Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; 1078 params/man.th.extra2.max.length.xml,1.2; 1079 params/refentry.date.profile.xml,1.2; 1080 params/refentry.manual.profile.xml,1.2; 1081 params/refentry.source.name.profile.xml,1.2; 1082 params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; 1083 manpages/other.xsl,1.15 - Michael(tm) Smith 1084 1085 * Added support for DocBook 5 namespace-stripping in manpages stylesheet. 1086 Closes request #1210692. 1087 1088 Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm) 1089 Smith 1090 1091 * Fixed handling of table footnotes. With this checkin, the table support in 1092 the manpages stylesheet is now basically feature complete. So this change 1093 closes request #619532, "No support for tables" -- the oldest currently 1094 open manpages feature request, submitted by Ben Secrest (blsecres) on 1095 2002-10-07. Congratulations to me [patting myself on the back]. 1096 1097 Modified: manpages/block.xsl,1.11; manpages/docbook.xsl,1.55; 1098 manpages/table.xsl,1.15 - Michael(tm) Smith 1099 1100 * Added handling for table titles. Also fixed handling of nested tables; 1101 nest tables are now "extracted" and displayed just after their parent 1102 tables. 1103 1104 Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14 - Michael(tm) 1105 Smith 1106 1107 * Added option for turning off bold formatting in Funcsynopsis. Boldface 1108 formatting in function synopsis is mandated in the man(7) man page and is 1109 used almost universally in existing man pages. Despite that, it really 1110 does look like crap to have an entire Funcsynopsis output in bold, so I 1111 added params for turning off the bold formatting and/or replacing it with 1112 a different roff special font (e.g., "RI" for alternating roman/italic 1113 instead of the default "BI" for alternating bold/italic). The new params 1114 are "man.funcprototype.font" and "man.funcsynopsisinfo.font". To be 1115 documented later. 1116 1117 Closes #1452247. Thanks to Joe Orton for the feature request. 1118 1119 Modified: params/man.string.subst.map.xml,1.16; manpages/block.xsl,1.10; 1120 manpages/docbook.xsl,1.51; manpages/inline.xsl,1.16; 1121 manpages/synop.xsl,1.27 - Michael(tm) Smith 1122 1123 * Use AUTHORS instead of AUTHOR if we have multiple people to attribute. 1124 Also, fixed checking such that we generate author section even if we don't 1125 have an author (as long as there is at least one other person/entity we 1126 can put in the section). Also adjusted assembly of content for Author 1127 metainfo field such that we now not only use author, but try to find a 1128 "best match" if we can't find an author name to put there. 1129 1130 Closes #1233592. Thanks to Sam Steingold for the request. 1131 1132 Modified: manpages/info.xsl,1.12 - Michael(tm) Smith 1133 1134 * Changes for request #1243027, "Impove handling of AUTHOR section." This 1135 adds support for Collab, Corpauthor, Corpcredt, Orgname, Publishername, 1136 and Publisher. Also adds support for output of Affiliation and its 1137 children, and support for using gentext strings for auto-attributing roles 1138 (Author, Editor, Publisher, Translator, etc.). Also did a lot of code 1139 cleanup and modularization of all the AUTHOR handling code. And fixed a 1140 bug that was causing Author info to not be picked up correctly for 1141 metainfo comment we embed in man-page source. 1142 1143 Modified: manpages/info.xsl,1.11 - Michael(tm) Smith 1144 1145 * Support bold output for "emphasis remap='B'". (because Eric Raymond's 1146 doclifter(1) tool converts groff source marked up with ".B" request or 1147 "\fB" escapes to DocBook "emphasis remap='B'".) 1148 1149 Modified: manpages/inline.xsl,1.14 - Michael(tm) Smith 1150 1151 * Added support for Segmentedlist. Details: Output is tabular, with no 1152 option for "list" type output. Output for Segtitle elements can be 1153 supressed by setting man.segtitle.suppress. If Segtitle content is output, 1154 it is rendered in italic type (not bold because not all terminals support 1155 bold and so italic ensures the stand out on those terminals). Extra space 1156 (.sp line) at end of table code ensures that it gets handled correctly in 1157 the case where its source is the child of a Para. Closes feature-request 1158 #1400097. Thanks to Daniel Leidert for the patch and push, and to Alastair 1159 Rankine for filing the original feature request. 1160 1161 Modified: manpages/lists.xsl,1.23; manpages/utility.xsl,1.10 - Michael(tm) 1162 Smith 1163 1164 * Improved handling or Author/Editor/Othercredit. 1165 1166 Reworked content of (non-visible) comment added at top of each page 1167 (metadata stuff). 1168 1169 Added support for generating a manifest file (useful for cleaning up after 1170 builds, etc.) 1171 1172 Modified: manpages/docbook.xsl,1.46; manpages/info.xsl,1.9; 1173 manpages/other.xsl,1.12; manpages/utility.xsl,1.6 - Michael(tm) Smith 1174 1175 * Added two new parameters for handling of multi-term varlistentry elements: 1176 1177 variablelist.term.break.after: When the variablelist.term.break.after is 1178 non-zero, it will generate a line break after each term multi-term 1179 varlistentry. 1180 1181 variablelist.term.separator: When a varlistentry contains multiple term 1182 elements, the string specified in the value of the 1183 variablelist.term.separator parameter is placed after each term except the 1184 last. The default is ", " (a comma followed by a space). To suppress 1185 rendering of the separator, set the value of variablelist.term.separator 1186 to the empty string (""). 1187 1188 These parameters are primarily intended to be useful if you have 1189 multi-term varlistentries that have long terms. 1190 1191 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of 1192 long terms" doc that demonstrated the value of having these options. 1193 1194 Also, added normalize-space() call to processing of each term. 1195 1196 This change affects all output formats (HTML, PDF, manpages). The default 1197 behavior should pretty much remain the same as before, but it is possible 1198 (as always) that the change may introduce some new bugginess. 1199 1200 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; 1201 html/lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; 1202 manpages/lists.xsl,1.22; manpages/param.ent,1.14; 1203 manpages/param.xweb,1.16; params/variablelist.term.break.after.xml,1.1; 1204 params/variablelist.term.separator.xml,1.1 - Michael(tm) Smith 1205 1206Params 1207 1208The following changes have been made to the params code since the 1.69.1 1209release. 1210 1211 * New parameters to set header/footer table minimum height. 1212 1213 Modified: params/footer.table.height.xml,1.1; 1214 params/header.table.height.xml,1.1 - Robert Stayton 1215 1216 * Support multiple indexing methods for different languages. 1217 1218 Modified: params/index.method.xml,1.1 - Robert Stayton 1219 1220 * Remove qandaset and qandadiv from generate.toc for fo output because 1221 formerly it wasn't working, but now it is and the default behavior should 1222 stay the same. 1223 1224 Modified: params/generate.toc.xml,1.8 - Robert Stayton 1225 1226 * add support for page number references to link element too. 1227 1228 Modified: params/insert.link.page.number.xml,1.1 - Robert Stayton 1229 1230 * Add support for more characters to hyphen on when ulink.hyphenate is 1231 turned on. 1232 1233 Modified: params/ulink.hyphenate.chars.xml,1.1; 1234 params/ulink.hyphenate.xml,1.3 - Robert Stayton 1235 1236 * New attribute-set to format biblioentry and bibliomixed. 1237 1238 Modified: params/biblioentry.properties.xml,1.1 - Robert Stayton 1239 1240 * Added new parameter chunk.tocs.and.lots.has.title which controls presence 1241 of title in a separate chunk with ToC/LoT. Disabling title can be very 1242 useful if you are generating frameset output (well, yes those frames, but 1243 some customers really want them ;-). 1244 1245 Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; 1246 html/param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - 1247 Jirka Kosek 1248 1249 * Added new attribute set toc.line.properties for controlling appearance of 1250 lines in ToC/LoT 1251 1252 Modified: params/toc.line.properties.xml,1.1 - Jirka Kosek 1253 1254 * Allow table footnotes to have different properties from regular footnotes. 1255 1256 Modified: params/table.footnote.properties.xml,1.1 - Robert Stayton 1257 1258 * Set properties for pgwide="1" objects. 1259 1260 Modified: params/pgwide.properties.xml,1.1 - Robert Stayton 1261 1262 * Added the autotoc.label.in.hyperlink param. 1263 1264 If the value of autotoc.label.in.hyperlink is non-zero, labels are 1265 included in hyperlinked titles in the TOC. If it is instead zero, labels 1266 are still displayed prior to the hyperlinked titles, but are not 1267 hyperlinked along with the titles. 1268 1269 Closes patch #1065868. Thanks to anatoly techtonik for the patch. 1270 1271 Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; 1272 html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - 1273 Michael(tm) Smith 1274 1275 * Added two new params: html.head.legalnotice.link.types and html.head. 1276 legalnotice.link.multiple. 1277 1278 If the value of the generate.legalnotice.link is non-zero, then the 1279 stylesheet generates (in the head section of the HTML source) either a 1280 single HTML link element or, if the value of the html.head.legalnotice. 1281 link.multiple is non-zero, one link element for each link type specified. 1282 Each link has the following attributes: 1283 1284 - a rel attribute whose value is derived from the value of html.head. 1285 legalnotice.link.types 1286 1287 - an href attribute whose value is set to the URL of the file containing 1288 the legalnotice 1289 1290 - a title attribute whose value is set to the title of the corresponding 1291 legalnotice (or a title programatically determined by the stylesheet) 1292 1293 For example: 1294 1295 <link rel="copyright" href="ln-id2524073.html" title="Legal Notice"> 1296 1297 Closes #1476450. Thanks to Sam Steingold. 1298 1299 Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; 1300 html/param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; 1301 params/html.head.legalnotice.link.multiple.xml,1.1; 1302 params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith 1303 1304 * Added the following params: 1305 1306 - man.indent.width (string-valued) - man.indent.refsect (boolean) - 1307 man.indent.blurbs (boolean) - man.indent.lists (boolean) - 1308 man.indent.verbatims (boolean) 1309 1310 Note that in earlier snapshots, man.indent.width was named 1311 man.indentation.default.value and the boolean params had names like 1312 man.indentation.*.adjust. Also the man.indent.blurbs param was called 1313 man.indentation.authors.adjust (or something). 1314 1315 The behavior now is: If the value of a particular man.indent.* boolean 1316 param is non-zero, the corresponding contents (refsect*, list items, 1317 authorblurb/personblurb, vervatims) are displayed with a left margin 1318 indented by a width equal to the value of man.indent.width. 1319 1320 Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74; 1321 manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20; 1322 manpages/param.ent,1.22; manpages/param.xweb,1.24; 1323 manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1; 1324 params/man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; 1325 params/man.indent.width.xml,1.1 - Michael(tm) Smith 1326 1327 * Added man.table.footnotes.divider param. 1328 1329 In each table that contains footenotes, the string specified by the man. 1330 table.footnotes.divider parameter is output before the list of footnotes 1331 for the table. 1332 1333 Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; 1334 manpages/param.ent,1.21; manpages/param.xweb,1.23; 1335 params/man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith 1336 1337 * Added the man.output.in.separate.dir, man.output.base.dir, and 1338 man.output.subdirs.enabled parameters. 1339 1340 The man.output.base.dir parameter specifies the base directory into which 1341 man-page files are output. The man.output.subdirs.enabled parameter 1342 controls whether the files are output in subdirectories within the base 1343 directory. 1344 1345 The values of the man.output.base.dir and man.output.subdirs.enabled 1346 parameters are used only if the value of man.output.in.separate.dir 1347 parameter is non-zero. If the value of man.output.in.separate.dir is zero, 1348 man-page files are not output in a separate directory. 1349 1350 Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; 1351 manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1; 1352 params/man.output.in.separate.dir.xml,1.1; 1353 params/man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith 1354 1355 * Added man.font.table.headings and man.font.table.title params, for 1356 controlling font in table headings and titles. 1357 1358 Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; 1359 manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1; 1360 params/man.font.table.title.xml,1.1 - Michael(tm) Smith 1361 1362 * Added man.font.funcsynopsisinfo and man.font.funcprototype params, for 1363 specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and 1364 funcprototype output. 1365 1366 Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; 1367 manpages/param.ent,1.18; manpages/param.xweb,1.20; 1368 manpages/synop.xsl,1.29; manpages/table.xsl,1.21; 1369 params/man.font.funcprototype.xml,1.1; 1370 params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith 1371 1372 * Changed to select="0" in refclass.suppress (instead of ..>0</..) 1373 1374 Modified: params/refclass.suppress.xml,1.3 - Michael(tm) Smith 1375 1376 * Added man.segtitle.suppress param. 1377 1378 If the value of man.segtitle.suppress is non-zero, then display of 1379 segtitle contents is suppressed in output. 1380 1381 Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; 1382 manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - 1383 Michael(tm) Smith 1384 1385 * Added man.output.manifest.enabled and man.output.manifest.filename params. 1386 1387 If man.output.manifest.enabled is non-zero, a list of filenames for man 1388 pages generated by the stylesheet transformation is written to the file 1389 named by man.output.manifest.filename 1390 1391 Modified: manpages/docbook.xsl,1.67; manpages/other.xsl,1.19; 1392 manpages/param.ent,1.16; manpages/param.xweb,1.18; 1393 params/man.output.manifest.enabled.xml,1.1; 1394 params/man.output.manifest.filename.xml,1.1; 1395 tools/make/Makefile.DocBook,1.4 - Michael(tm) Smith 1396 1397 * Added refclass.suppress param. 1398 1399 If the value of refclass.suppress is non-zero, then display refclass 1400 contents is suppressed in output. Affects HTML and FO output only. 1401 1402 Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; 1403 html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith 1404 1405 * Added refentry.meta.get.quietly param. 1406 1407 If zero (the default), notes and warnings about "missing" markup are 1408 generated during gathering of refentry metadata. If non-zero, the metadata 1409 is gathered "quietly" -- that is, the notes and warnings are suppressed. 1410 1411 NOTE: If you are processing a large amount of refentry content, you may be 1412 able to speed up processing significantly by setting a non-zero value for 1413 refentry.meta.get.quietly. 1414 1415 Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; 1416 manpages/param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - 1417 Michael(tm) Smith 1418 1419 * Added support for "software" and "sectdesc" class values on refmiscinfo; 1420 "software" is treated identically to "source", and "setdesc" is treated 1421 identically to "manual". 1422 1423 Modified: common/refentry.xsl,1.10; 1424 params/man.th.extra2.max.length.xml,1.3; 1425 params/refentry.source.name.profile.xml,1.4 - Michael(tm) Smith 1426 1427 * Drastically reworked all of the XPath expressions used in refentry 1428 metadata gathering -- completely removed $parentinfo and turned $info into 1429 a set of nodes that includes the *info contents of the Refentry plus the 1430 *info contents all all of its ancestor elements. The basic XPath 1431 expression now used throughout is (using the example of checking for a 1432 date): 1433 1434 (($info[//date])[last()]/date)[1]. 1435 1436 That selects the "last" *info/date date in document order -- that is, the 1437 one eitther on the Refentry itself or on the closest ancestor to the 1438 Refentry. 1439 1440 It's likely this change may break some things; may need to pick up some 1441 pieces later. 1442 1443 Also, changed the default value for the man.th.extra2.max.length from 40 1444 to 30. 1445 1446 Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; 1447 params/man.th.extra2.max.length.xml,1.2; 1448 params/refentry.date.profile.xml,1.2; 1449 params/refentry.manual.profile.xml,1.2; 1450 params/refentry.source.name.profile.xml,1.2; 1451 params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; 1452 manpages/other.xsl,1.15 - Michael(tm) Smith 1453 1454 * Added option for turning off bold formatting in Funcsynopsis. Boldface 1455 formatting in function synopsis is mandated in the man(7) man page and is 1456 used almost universally in existing man pages. Despite that, it really 1457 does look like crap to have an entire Funcsynopsis output in bold, so I 1458 added params for turning off the bold formatting and/or replacing it with 1459 a different roff special font (e.g., "RI" for alternating roman/italic 1460 instead of the default "BI" for alternating bold/italic). The new params 1461 are "man.funcprototype.font" and "man.funcsynopsisinfo.font". To be 1462 documented later. 1463 1464 Closes #1452247. Thanks to Joe Orton for the feature request. 1465 1466 Modified: params/man.string.subst.map.xml,1.16; manpages/block.xsl,1.10; 1467 manpages/docbook.xsl,1.51; manpages/inline.xsl,1.16; 1468 manpages/synop.xsl,1.27 - Michael(tm) Smith 1469 1470 * fop.extensions now only for FOP version 0.20.5 and earlier. 1471 1472 Modified: params/fop.extensions.xml,1.4 - Robert Stayton 1473 1474 * Support for fop1 different from fop 0.20.5 and earlier. 1475 1476 Modified: params/fop1.extensions.xml,1.1 - Robert Stayton 1477 1478 * Reset default value to empty string so template uses gentext first, then 1479 the parameter value if not empty. 1480 1481 Modified: params/index.number.separator.xml,1.2; 1482 params/index.range.separator.xml,1.2; params/index.term.separator.xml,1.2 1483 - Robert Stayton 1484 1485 * New parameter: id.warnings. If non-zero, warnings are generated for titled 1486 objects that don't have titles. True by default; I wonder if this will be 1487 too aggressive? 1488 1489 Modified: html/biblio.xsl,1.25; html/component.xsl,1.27; 1490 html/division.xsl,1.11; html/formal.xsl,1.19; html/glossary.xsl,1.20; 1491 html/html.xsl,1.13; html/index.xsl,1.16; html/param.ent,1.88; 1492 html/param.xweb,1.97; html/refentry.xsl,1.22; html/sections.xsl,1.30; 1493 params/id.warnings.xml,1.1 - Norman Walsh 1494 1495 * Added new parameter keep.relative.image.uris 1496 1497 Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; 1498 html/param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman 1499 Walsh 1500 1501 * Support default label width parameters for itemized and ordered lists 1502 1503 Modified: fo/lists.xsl,1.64; fo/param.ent,1.90; fo/param.xweb,1.103; 1504 params/itemizedlist.label.width.xml,1.1; 1505 params/orderedlist.label.width.xml,1.1 - Norman Walsh 1506 1507 * Added parameters to localize punctuation in indexes. 1508 1509 Modified: params/index.number.separator.xml,1.1; 1510 params/index.range.separator.xml,1.1; params/index.term.separator.xml,1.1 1511 - Robert Stayton 1512 1513 * Added two new parameters for handling of multi-term varlistentry elements: 1514 1515 variablelist.term.break.after: When the variablelist.term.break.after is 1516 non-zero, it will generate a line break after each term multi-term 1517 varlistentry. 1518 1519 variablelist.term.separator: When a varlistentry contains multiple term 1520 elements, the string specified in the value of the 1521 variablelist.term.separator parameter is placed after each term except the 1522 last. The default is ", " (a comma followed by a space). To suppress 1523 rendering of the separator, set the value of variablelist.term.separator 1524 to the empty string (""). 1525 1526 These parameters are primarily intended to be useful if you have 1527 multi-term varlistentries that have long terms. 1528 1529 Closes #1306676. Thanks to Sam Steingold for providing an example "lots of 1530 long terms" doc that demonstrated the value of having these options. 1531 1532 Also, added normalize-space() call to processing of each term. 1533 1534 This change affects all output formats (HTML, PDF, manpages). The default 1535 behavior should pretty much remain the same as before, but it is possible 1536 (as always) that the change may introduce some new bugginess. 1537 1538 Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; 1539 html/lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; 1540 manpages/lists.xsl,1.22; manpages/param.ent,1.14; 1541 manpages/param.xweb,1.16; params/variablelist.term.break.after.xml,1.1; 1542 params/variablelist.term.separator.xml,1.1 - Michael(tm) Smith 1543 1544 * Convert 'no' to string in default value. 1545 1546 Modified: params/olink.doctitle.xml,1.4 - Robert Stayton 1547 1548 * Implemented RFE #1292615. 1549 1550 Added bunch of new parameters (attribute sets) that affect list 1551 presentation: list.block.properties, itemizedlist.properties, orderedlist 1552 .properties, itemizedlist.label.properties and orderedlist.label 1553 .properties. Default behaviour of stylesheets has not been changed but 1554 further customizations will be much more easier. 1555 1556 Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; 1557 params/itemizedlist.label.properties.xml,1.1; 1558 params/itemizedlist.properties.xml,1.1; 1559 params/list.block.properties.xml,1.1; 1560 params/orderedlist.label.properties.xml,1.1; 1561 params/orderedlist.properties.xml,1.1 - Jirka Kosek 1562 1563 * Implemented RFE #1242092. 1564 1565 You can enable crop marks in your document by setting crop.marks=1 and 1566 xep.extensions=1. Appearance of crop marks can be controlled by parameters 1567 crop.mark.bleed (6pt), crop.mark.offset (24pt) and crop.mark.width 1568 (0.5pt). 1569 1570 Also there is new named template called user-xep-pis. You can overwrite it 1571 in order to produce some PIs that can control XEP as described in 1572 http://www.renderx.com/reference.html#Output_Formats 1573 1574 Modified: fo/docbook.xsl,1.36; fo/param.ent,1.86; fo/param.xweb,1.97; 1575 fo/xep.xsl,1.23; params/crop.mark.bleed.xml,1.1; 1576 params/crop.mark.offset.xml,1.1; params/crop.mark.width.xml,1.1; 1577 params/crop.marks.xml,1.1 - Jirka Kosek 1578 1579 * Changed short descriptions in doc for *autolabel* params to match new 1580 autolabel behavior. 1581 1582 Modified: params/appendix.autolabel.xml,1.5; 1583 params/chapter.autolabel.xml,1.4; params/part.autolabel.xml,1.5; 1584 params/preface.autolabel.xml,1.4 - Michael(tm) Smith 1585 1586Profiling 1587 1588The following changes have been made to the profiling code since the 1.69.1 1589release. 1590 1591 * Profiling now works together with namespace stripping (V5 documents). 1592 Namespace striping should work with all stylesheets named profile-, even 1593 if they are not supporting namespace stripping in a non-profiling variant. 1594 1595 Modified: profiling/profile-mode.xsl,1.4; profiling/xsl2profile.xsl,1.7 - 1596 Jirka Kosek 1597 1598 * Moved profiling stage out of templates. This make possible to reuse 1599 profiled content by several templates and still maintaing node indentity 1600 (needed for example for HTML Help where content is processed multiple 1601 times). 1602 1603 I don't know why this was not on the top level before. Maybe some XSLT 1604 processors choked on it. I hope this will be OK now. 1605 1606 Modified: profiling/xsl2profile.xsl,1.5 - Jirka Kosek 1607 1608Tools 1609 1610The following changes have been made to the tools code since the 1.69.1 1611release. 1612 1613 * Moved Makefile.DocBook from contrib module to xsl module. 1614 1615 Modified: tools/make/Makefile.DocBook,1.1 - Michael(tm) Smith 1616 1617WordML 1618 1619The following changes have been made to the wordml code since the 1.69.1 1620release. 1621 1622 * added contrib element, better handling of default paragraph style 1623 1624 Modified: wordml/pages-normalise.xsl,1.6; wordml/supported.xml,1.2; 1625 wordml/wordml-final.xsl,1.14 - Steve Ball 1626 1627 * added bridgehead 1628 1629 Modified: wordml/docbook-pages.xsl,1.6; wordml/docbook.xsl,1.17; 1630 wordml/pages-normalise.xsl,1.5; wordml/template-pages.xml,1.7; 1631 wordml/template.dot,1.4; wordml/template.xml,1.14; 1632 wordml/wordml-final.xsl,1.13 - Steve Ball 1633 1634 * added blocks stylesheet to support bibliographies, glossaries and 1635 qandasets 1636 1637 Modified: wordml/Makefile,1.4; wordml/README,1.3; 1638 wordml/blocks-spec.xml,1.1; wordml/docbook-pages.xsl,1.5; 1639 wordml/docbook.xsl,1.16; wordml/pages-normalise.xsl,1.4; 1640 wordml/sections-spec.xml,1.3; wordml/specifications.xml,1.13; 1641 wordml/template-pages.xml,1.6; wordml/template.dot,1.3; 1642 wordml/template.xml,1.13; wordml/wordml-blocks.xsl,1.1; 1643 wordml/wordml-final.xsl,1.12; wordml/wordml-sections.xsl,1.3 - Steve Ball 1644 1645 * added mediaobject caption 1646 1647 Modified: wordml/docbook-pages.xsl,1.4; wordml/docbook.xsl,1.15; 1648 wordml/specifications.xml,1.12; wordml/template-pages.xml,1.5; 1649 wordml/template.dot,1.2; wordml/template.xml,1.12; 1650 wordml/wordml-final.xsl,1.11 - Steve Ball 1651 1652 * added callouts 1653 1654 Modified: wordml/docbook-pages.xsl,1.3; wordml/docbook.xsl,1.14; 1655 wordml/pages-normalise.xsl,1.3; wordml/specifications.xml,1.11; 1656 wordml/template-pages.xml,1.4; wordml/wordml-final.xsl,1.10 - Steve Ball 1657 1658 * added Word template file 1659 1660 Modified: wordml/template.dot,1.1 - Steve Ball 1661 1662 * added abstract, fixed itemizedlist, ulink 1663 1664 Modified: wordml/specifications.xml,1.10; wordml/wordml-final.xsl,1.9 - 1665 Steve Ball 1666 1667 * fixed Makefile added many features to Pages support added revhistory, 1668 inlines, highlights, abstract 1669 1670 Modified: wordml/Makefile,1.2; wordml/docbook-pages.xsl,1.2; 1671 wordml/pages-normalise.xsl,1.2; wordml/sections-spec.xml,1.2; 1672 wordml/specifications.xml,1.9; wordml/template-pages.xml,1.3; 1673 wordml/template.xml,1.11; wordml/wordml-final.xsl,1.8; 1674 wordml/wordml-sections.xsl,1.2 - Steve Ball 1675 1676 * fixed handling linebreaks when generating WordML added Apple Pages support 1677 1678 Modified: wordml/docbook.xsl,1.13; wordml/template-pages.xml,1.2 - Steve 1679 Ball 1680 1681Release 1.69.1 1682 1683This release is a minor bug-fix update to the 1.69.0 release. Along with bug 1684fixes, it includes one configuration-parameter change: The default value of 1685the annotation.support parameter is now 0 (off). The reason for that change is 1686that there have been reports that annotation handling is causing a significant 1687performance degradation in processing of large documents with xsltproc. 1688 1689Release 1.69.0 1690 1691The release includes major feature changes, particularly in the manpages 1692stylesheets, as well as a large number of bug fixes. 1693 1694As with all DocBook Project dot zero releases, this is an experimental 1695release . 1696 1697Common 1698 1699 * This release adds localizations for the following languages: Albanian, 1700 Amharic, Azerbaijani, Hindi, Irish (Gaelic), Gujarati, Kannada, Mongolian, 1701 Oriya, Punjabi, Tagalog, Tamil, and Welsh. 1702 1703 * Added support for specifying number format for auto labels for chapter, 1704 appendix, part, and preface. Contolled with the appendix.autolabel, 1705 chapter.autolabel, part.autolabel, and preface.autolabel parameters. 1706 1707 * Added basic support for biblioref cross referencing. 1708 1709 * Added support for align on caption in mediaobject. 1710 1711 * Added support for processing documents that use the DocBook V5 namespace. 1712 1713 * Added support for termdef and mathphrase. 1714 1715 * EXPERIMENTAL: Incorporated the Slides and Website stylesheets into the 1716 DocBook XSL stylesheets package. So, for example, Website documents can 1717 now be processed using the following URI for the driver Website 1718 tabular.xsl file: 1719 1720 http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl 1721 1722 * A procedure without a title is now treated as an informal procedure 1723 (meaning that it is not added to any generated list of procedures and 1724 has no affect on numbering of generated labels for other procedures). 1725 1726 * docname is no longer added to olink when pointing to a root element. 1727 1728 * Added support for generation of choice separator in inline simplelist. 1729 This enables auto-generation of an appropriate localized choice 1730 separator (for example, and or or) before the final item in an inline 1731 simplelist. 1732 1733 To indicate that you want a choice separator generated for a particular 1734 list, you need to put a processing instruction (PI) of the form 1735 <?dbchoice choice="foo"?> as a child of the list. For example: 1736 1737 <para>Choose from 1738 ONE and ONLY ONE of the following: 1739 <simplelist type="inline"> 1740 <?dbchoice choice="or" ?> 1741 <member>A</member> 1742 <member>B</member> 1743 <member>C</member>.</simplelist></para> 1744 1745 Output (for English): 1746 1747 Choose from ONE and only ONE of the following choices: A, B, or C. 1748 1749 As a temporary workaround for the fact that most of the DocBook 1750 non-English locale files don't have a localization for the word or, you 1751 can put in a literal string to be used; example for French: 1752 <?dbchoice choice="ou">. That is, use ou instead of or. 1753 1754FO 1755 1756 * Added content-type property to external-graphic element, based on 1757 imagedata format attribute. 1758 1759 * Added support for generating <rx:meta-field creator="$VERSION"/> field for 1760 XEP output. This makes the DocBook XSL stylesheet version information 1761 available through the Document Properties menu in Acrobat Reader and other 1762 PDF viewers. 1763 1764 * Trademark symbol handling made consistent with handling of same in HTML 1765 stylesheets. Prior to this change, if you processed a document that 1766 contained no value for the class attribute on the trademark element, the 1767 HTML stylesheets would default to rendering a superscript TM symbol after 1768 the trademark contents, but the FO stylesheets would render nothing. 1769 1770 * Added support for generating XEP bookmarks for refentry. 1771 1772 * Added support for HTML markup table border attribute, applied to each 1773 table cell. 1774 1775 * The table.width template can now sum column specs if none use % or *. 1776 1777 * Added fox:destination extension inside fox:outline to support linking to 1778 internal destinations. 1779 1780 * Added support for customizing abstract with property sets. Controlled with 1781 the abstract.properties and abstract.title.properties parameters. 1782 1783 * Add footnotes in table title to table footnote set, and add support for 1784 table footnotes to HTML table markup. 1785 1786 * Added support for title in glosslist. 1787 1788 * Added support for itemizedlist symbol none. 1789 1790 * Implemented the new graphical.admonition.properties and 1791 nongraphical.admonition.properties attribute sets. 1792 1793 * Added id to formalpara and some other blocks that were missing it. 1794 1795 * Changed the anchor template to output fo:inline instead of fo:wrapper. 1796 1797 * Added support for toc.max.depth parameter. 1798 1799Help 1800 1801 * Eclipse Help: Added support for generating olink database. 1802 1803HTML 1804 1805 * Added a first cut at support in HTML output for DocBook 5 style annotation 1806 s. Controlled using the annotation.support parameter, and implemented 1807 using JavaScript and CSS styling. For more details, see the documentation 1808 for the annotation.js, annotation.css, annotation.graphic.open, and 1809 annotation.graphic.close parameters. 1810 1811 * Generate client-side image map for imageobjectco with areas using calspair 1812 units 1813 1814 * Added support for <?img.src.path?> PI. 1815 1816 * Added support for passing img.src.path to DocBook Java XSLT image 1817 extensions when appropriate. Controlled using the 1818 graphicsize.use.img.src.path parameter. 1819 1820 * Added support for (not valid for DocBook 4) xlink:href on area and (not 1821 valid for DocBook 4) alt in area. 1822 1823 * Added new parameter default.table.frame to control table framing if there 1824 is no frame attribute on a table. 1825 1826 * Added initial, experimental support for generating content for the HTML 1827 title attribute from content of the alt element. This change adds support 1828 for the following inline elements only (none of them are block elements): 1829 abbrev, accel, acronym, action, application, authorinitials, beginpage, 1830 citation, citerefentry, citetitle, city, classname, code, command, 1831 computeroutput, constant, country, database, email, envar, errorcode, 1832 errorname, errortext, errortype, exceptionname, fax, filename, firstname, 1833 firstterm, foreignphrase, function, glossterm, guibutton, guiicon, 1834 guilabel, guimenu, guimenuitem, guisubmenu, hardware, honorific, 1835 interface, interfacename, keycap, keycode, keysym, lineage, lineannotation 1836 , literal, markup, medialabel, methodname, mousebutton, option, optional, 1837 otheraddr, othername, package, parameter, personname, phone, pob, postcode 1838 , productname, productnumber, prompt, property, quote, refentrytitle, 1839 remark, replaceable, returnvalue, tag, shortcut, state, street, 1840 structfield, structname, subscript, superscript, surname, symbol, 1841 systemitem, tag, termdef, token, trademark, type, uri, userinput, varname, 1842 and wordasword 1843 1844 * Added support for chunking revhistory into separate file (similar to the 1845 support for doing same with legalnotice). Patch from Thomas Schraitle. 1846 Controlled through new generate.revhistory.link parameter. 1847 1848 * l10n.xsl: Made language codes RFC compliant. Added a new boolean config 1849 parameter, l10n.lang.value.rfc.compliant. If it is non-zero (the default), 1850 any underscore in a language code will be converted to a hyphen in HTML 1851 output. If it is zero, the language code will be left as-is. 1852 1853man 1854 1855This release closes out 44 manpages stylesheet bug reports and feature 1856requests. It adds more than 35 new configuration parameters for controlling 1857aspects of man-page output -- including hyphenation and justification, 1858handling of links, conversion of Unicode characters, and contents of man-page 1859headers and footers. 1860 1861 * New options for globally disabling/enabling hyphenation and justification: 1862 man.justify and man.hyphenate. 1863 1864 Note that the default for the both of those is zero (off), because 1865 justified text looks good only when it is also hyphenated; to quote the 1866 Hyphenation node from the groff info page: 1867 1868 Since the odds are not great for finding a set of words, for every 1869 output line, which fit nicely on a line without inserting excessive 1870 amounts of space between words, `gtroff' hyphenates words so that it 1871 can justify lines without inserting too much space between words. 1872 1873 The problem is that groff can end up hyphenating a lot of things that you 1874 don't want hyphenated (variable names and command names, for example). 1875 Keeping both justification and hyphenation disabled ensures that hyphens 1876 won't get inserted where you don't want to them, and you don't end up with 1877 lines containing excessive amounts of space between words. These default 1878 settings run counter to how most existing man pages are formatted. But 1879 there are some notable exceptions, such as the perl man pages. 1880 1881 * Added parameters for controlling hyphenation of computer inlines, 1882 filenames, and URLs. By default, even when hyphenation is enabled 1883 (globally), hyphenation is now suppressed for "computer inlines" 1884 (currently, just classname, constant, envar, errorcode, option, 1885 replaceable, userinput, type, and varname, and for filenames, and for URLs 1886 from link. It can be (re)enabled using the man.hyphenate.computer.inlines, 1887 man.hyphenate.filenames, and man.hyphenate.urls parameters. 1888 1889 * Implemented a new system for replacing Unicode characters. There are two 1890 parts to the new system: a string substitution map for doing essential 1891 replacements, and a character map that can optionally be disabled and 1892 enabled. 1893 1894 The new system fixes all open bugs that had to do with literal Unicode 1895 numbered entities such as “ and ” showing up in output, and 1896 greatly expands the ability of the stylesheets to generate good roff 1897 equivalents for Unicode symbols and special characters. 1898 1899 Here are some details... 1900 1901 The previous manpages mechanism for replacing Unicode symbols and special 1902 characters with roff equivalents (the replace-entities template) was not 1903 scalable and not complete. The mechanism handled a somewhat arbitrary 1904 selection of less than 20 or so Unicode characters. But there are 1905 potentially more than 800 Unicode special characters that have some groff 1906 equivalent they can be mapped to. And there are about 34 symbols in the 1907 Latin-1 (ISO-8859-1) block alone. Users might reasonably expect that if 1908 they include any of those Latin-1 characters in their DocBook source 1909 documents, they will get correctly converted to known roff equivalents in 1910 output. 1911 1912 In addition to those common symbols, certain users may have a need to use 1913 symbols from other Unicode blocks. Say, somebody who is documenting an 1914 application related to math might need to use a bunch of symbols from the 1915 Mathematical Operators Unicode block (there are about 65 characters in 1916 that block that have reasonable roff equivalents). Or somebody else might 1917 really like Dingbats -- such as the checkmark character -- and so might 1918 use a bunch of things from the Dingbat block (141 characters in that 1919 that have roff equivalents or that can at least be degraded somewhat 1920 gracefully into roff). 1921 1922 So, the old replace-entities mechanism was replaced with a completely 1923 different mechanism that is based on use of two maps: a substitution 1924 map and a character map (the latter in a format compliant with the XSLT 1925 2.0 spec and therefore completely forward compatible with XSLT 2.0). 1926 1927 The substitution map is controlled through the man.string.subst.map 1928 parameter, and is used to replace things like the backslash character 1929 (which needs special handling to prevent it from being interpreted as a 1930 roff escape). The substitution map cannot be disabled, because disabling 1931 it will cause the output to be broken. However, you can add to it and 1932 change it if needed. 1933 1934 The character map mechanism, on the other hand, can be completely 1935 disabled. It is enabled by default, and, by default, does replacement of 1936 all Latin-1 symbols, along with most special spaces, dashes, and quotes 1937 (about 75 characters by default). Also, you can optionally enable a full 1938 character map that provides support for converting all 800 or so of the 1939 characters that have some reasonable groff equivalent. 1940 1941 The character-map mechanism is controlled through the following 1942 parameters: 1943 1944 man.charmap.enabled 1945 1946 turns character-map support on/off 1947 1948 man.charmap.use.subset 1949 1950 specifies that a subset of the character map is used instead of the 1951 full map 1952 1953 man.charmap.subset.profile 1954 1955 specifies profile of character-map subset 1956 1957 man.charmap.uri 1958 1959 specifies an alternate character map to use instead of the standard 1960 character map provided in the distribution 1961 1962 * Implemented out-of-line handling of display of URLs for links (currently, 1963 only for ulink). This gives you three choices for handling of links: 1964 1965 1. Number and list links. Each link is numbered inline, with a number in 1966 square brackets preceding the link contents, and a numbered list of 1967 all links is added to the end of the document. 1968 1969 2. Only list links. Links are not numbered, but an (unnumbered) list of 1970 links is added to the end of the document. 1971 1972 3. Suppress links. Don't number links and don't add any list of links to 1973 the end of the document. 1974 1975 You can also choose whether links should be underlined. The default is 1976 the works -- list, number, and underline links. You can use the 1977 man.links.list.enabled, man.links.are.numbered, and 1978 man.links.are.underlined parameters to change the defaults. The default 1979 heading for the link list is REFERENCES. You can be change that using the 1980 man.links.list.heading parameter. 1981 1982 * Changed default output encoding to UTF-8. This does not mean that man 1983 pages are output in raw UTF-8, because the character map is applied before 1984 final output, causing all UTF-8 characters covered in the map to be 1985 converted to roff equivalents. 1986 1987 * Added support for processing refsect3 and formalpara and nested refsection 1988 elements, down to any arbitrary level of nesting. 1989 1990 * Output of the NAME and SYNOPSIS and AUTHOR headings and the headings for 1991 admonitions (note, caution, etc.) are no longer hard-coded for English. 1992 Instead, headings are generated for those in the correct locale (just as 1993 the FO and HTML stylesheets do). 1994 1995 * Re-worked mechanism for assembling page headers/footers (the contents of 1996 the .TH macro title line). 1997 1998 Here are some details... 1999 2000 All man pages contain a .TH roff macro whose contents are used for 2001 rendering the title line displayed in the header and footer of each 2002 page. Here are a couple of examples of real-world man pages that have 2003 useful page headers/footers: 2004 2005 gtk-options(7) GTK+ User's Manual gtk-options(7) <-- header 2006 GTK+ 1.2 2003-10-20 gtk-options(7) <-- footer 2007 2008 svgalib(7) Svgalib User Manual svgalib(7) <-- header 2009 Svgalib 1.4.1 16 December 1999 svgalib(7) <-- footer 2010 2011 And here are the terms with which the groff_man(7) man page refers to the 2012 various parts of the header/footer: 2013 2014 title(section) extra3 title(section) <- header 2015 extra2 extra1 title(section) <- footer 2016 2017 Or, using the names with which the man(7) man page refers to those same 2018 fields: 2019 2020 title(section) manual title(section) <- page header 2021 source date title(section) <- page footer 2022 2023 The easiest way to control the contents of those fields is to mark up your 2024 refentry content like the following (note that this is a minimal 2025 example). 2026 2027 <refentry> 2028 <info> 2029 <date>2003-10-20</date> 1 2030 </info> 2031 <refmeta> 2032 <refentrytitle>gtk-options</refentrytitle> 2 2033 <manvolnum>7</manvolnum> 3 2034 <refmiscinfo class="source-name">GTK+</refmiscinfo> 4 2035 <refmiscinfo class="version">1.2</refmiscinfo> 5 2036 <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> 6 2037 </refmeta> 2038 <refnamediv> 2039 <refname>gtk-options</refname> 2040 <refpurpose>Standard Command Line Options for GTK+ Programs</refpurpose> 2041 </refnamediv> 2042 <refsect1> 2043 <title>Description</title> 2044 <para>This manual page describes the command line options, which 2045 are common to all GTK+ based applications.</para> 2046 </refsect1> 2047 </refentry> 2048 2049 1 Sets the date part of the header/footer. 2050 2051 2 Sets the title part. 2052 2053 3 Sets the section part. 2054 2055 4 Sets the source name part. 2056 2057 5 Sets the version part. 2058 2059 6 Sets the manual part. 2060 2061 Below are explanations of the steps the stylesheets take to attempt to 2062 assemble and display good headers and footer. [In the descriptions, note 2063 that *info is the refentry info child (whatever its name), and 2064 parentinfo is the info child of its parent (again, whatever its name).] 2065 2066 extra1 field (date) 2067 2068 Content of the extra1 field is what shows up in the center footer 2069 position of each page. The man(7) man page describes it as the date 2070 of the last revision. 2071 2072 To provide this content, if the refentry.date.profile.enabled is 2073 non-zero, the stylesheets check the value of refentry.date.profile. 2074 2075 Otherwise, by default, they check for a date or pubdate not only in 2076 the *info contents, but also in the parentinfo contents. 2077 2078 If a date cannot be found, the stylesheets now automatically generate 2079 a localized long format date, ensuring that this field always has 2080 content in output. 2081 2082 However, if for some reason you want to suppress this field, you can 2083 do so by setting a non-zero value for man.th.extra1.suppress. 2084 2085 extra2 field (source) 2086 2087 On Linux systems and on systems with a modern groff, the content of 2088 the extra2 field are what shows up in the left footer position of 2089 each page. 2090 2091 The man(7) man page describes this as the source of the command, and 2092 provides the following examples: 2093 2094 o For binaries, use somwething like: GNU, NET-2, SLS Distribution, 2095 MCC Distribution. 2096 2097 o For system calls, use the version of the kernel that you are 2098 currently looking at: Linux 0.99.11. 2099 2100 o For library calls, use the source of the function: GNU, BSD 4.3, 2101 Linux DLL 4.4.1. 2102 2103 In practice, there are many pages that simply have a version number in 2104 the source field. So, it looks like what we have is a two-part 2105 field, Name Version, where: 2106 2107 Name 2108 2109 product name (e.g., BSD) or org. name (e.g., GNU) 2110 2111 Version 2112 2113 version name 2114 2115 Each part is optional. If the Name is a product name, then the Version 2116 is probably the version of the product. Or there may be no Name, in 2117 which case, if there is a Version, it is probably the version of the 2118 item itself, not the product it is part of. Or, if the Name is an 2119 organization name, then there probably will be no Version. 2120 2121 To provide this content, if the refentry.source.name.profile.enabled 2122 and refentry.version.profile.enabled parameter are non-zero, the 2123 stylesheets check the value of refentry.source.name.profile 2124 refentry.version.profile. 2125 2126 Otherwise, by default, they check the following places, in the 2127 following order: 2128 2129 1. *info/productnumber 2130 2131 2. *info/productnumber 2132 2133 3. refmeta/refmiscinfo[@class = 'version'] 2134 2135 4. parentinfo/productnumber 2136 2137 5. *info/productname 2138 2139 6. parentinfo/productname 2140 2141 7. refmeta/refmiscinfo 2142 2143 8. [nothing found, so leave it empty] 2144 2145 extra3 field 2146 2147 On Linux systems and on systems with a modern groff, the content of 2148 the extra3 field are what shows up in the center header position of 2149 each page. Some man pages have extra2 content, some don't. If a 2150 particular man page has it, it is most often context data about some 2151 larger system the documented item belongs to (for example, the name or 2152 description of a group of related applications). The stylesheets now 2153 check the following places, in the following order, to look for 2154 content to add to the extra3 field. 2155 2156 1. parentinfo/title 2157 2158 2. parent's title 2159 2160 3. refmeta/refmiscinfo 2161 2162 4. [nothing found, so leave it empty] 2163 2164 * Reworked *info gathering. For each refentry found, the stylesheets now 2165 cache its *info content, then check for any valid parent of it that might 2166 have metainfo content and cache that, if found; they then then do all 2167 further matches against those node-sets (rather than re-selecting the 2168 original *info nodes each time they are needed). 2169 2170 * New option for breaking strings after forward slashes. This enables long 2171 URLs and pathnames to be broken across lines. Controlled through 2172 man.break.after.slash parameter. 2173 2174 * Output for servicemark and trademark are now (SM) and (TM). There is a 2175 groff "\(tm" escape, but output from that is not acceptable. 2176 2177 * New option for controlling the length of the title part of the .TH title 2178 line. Controlled through the man.th.title.max.length parameter. 2179 2180 * New option for specifying output encoding of each man page; controlled 2181 with man.output.encoding (similar to the HTML chunker.output.encoding 2182 parameter). 2183 2184 * New option for suppressing filename messages when generating output; 2185 controlled with man.output.quietly (similar to the HTML chunk.quietly 2186 parameter). 2187 2188 * The text of cross-references to first-level refentry (refsect1, top-level 2189 refsection, refnamediv, and refsynopsisdiv) are now capitalized. 2190 2191 * Cross-references to refnamediv now use the localized NAME title instead of 2192 using the first refname child. This makes the output inconsistent with 2193 HTML and FO output, but for man-page output, it seems to make better sense 2194 to have the NAME. (It may actually make better sense to do it that way in 2195 HTML and FO output as well...) 2196 2197 * Added support for processing funcparams. 2198 2199 * Removed the space that was being output between funcdef and paramdef; 2200 example: was: float rand (void); now: float rand(void) 2201 2202 * Turned off bold formatting for the type element when it occurs within a 2203 funcdef or paramdef 2204 2205 * Corrected rendering of simplelist. Any <simplelist type="inline" instance 2206 is now rendered as a comma-separated list (also with an optional localized 2207 and or or before the last item -- see description elsewhere in these 2208 release notes). Any simplelist instance whose type is not inline is 2209 rendered as a one-column vertical list (ignoring the values of the type 2210 and columns attributes if present) 2211 2212 * Comment added at top of roff source for each page now includes DocBook XSL 2213 stylesheets version number (as in the HTML stylesheets) 2214 2215 * Made change to prevent sticky fonts changes. Now, when the manpages 2216 stylesheets encounter node sets that need to be boldfaced or italicized, 2217 they put the \fBfoo\fR and \fIbar\fR groff bold/italic instructions 2218 separately around each node in the set. 2219 2220 * synop.xsl: Boldface everything in funcsynopsis output except parameters 2221 (which are in ital). The man(7) man page says: 2222 2223 For functions, the arguments are always specified using italics, even 2224 in the SYNOPSIS section, where the rest of the function is specified 2225 in bold. 2226 2227 A look through the contents of the man/man2 directory shows that most 2228 (all) existing pages do follow this everything in funcsynopsis bold 2229 rule. That means the type content and any punctuation (parens, semicolons, 2230 varargs) also must be bolded. 2231 2232 * Removed code for adding backslashes before periods/dots in roff source, 2233 because backslashes in front of periods/dots in roff source are needed 2234 only in the very rare case where a period is the very first character in a 2235 line, without any space in front of it. A better way to deal with that 2236 rare case is for you to add a zero-width space in front of the offending 2237 dot(s) in your source 2238 2239 * Removed special handling of the quote element. That was hard-coded to 2240 cause anything marked up with the quote element to be output preceded by 2241 two backticks and followed by two apostrophes -- that is, that old-school 2242 kludge for generating curly quotes in Emacs and in X-Windows fonts. 2243 While Emacs still seems to support that, I don't think X-Windows has for a 2244 long time now. And, anyway, it looks (and has always looked) like crap 2245 when viewed on a normal tty/console. In addition, it breaks localiztion of 2246 quote. By default, quote content is output with localized quotation marks, 2247 which, depending on the locale, may or may not be left and right double 2248 quotation marks. 2249 2250 * Changed mappings for left and right single quotation marks. Those had 2251 previously been incorrectly mapped to the backtick (`) and apostrophe 2252 (&39;) characters (for kludgy reasons -- see above). They are now 2253 correctly mapped to the \(oq and \(cq roff escapes. If you want the old 2254 (broken) behavior, you need to manually change the mappings for those in 2255 the value of the man.string.subst.map parameter. 2256 2257 * Removed xref.xsl file. Now, of the various cross-reference elements, only 2258 the ulink element is handled differently; the rest are handled exactly as 2259 the HTML stylesheets handle them, except that no hypertext links are 2260 generated. (Because there is no equivalent hypertext mechanism is man 2261 pages.) 2262 2263 * New option for making subheading dividers in generated roff source. The 2264 dividers are not visible in the rendered man page; they are just there to 2265 make the source readable. Controlled using man.subheading.divider. 2266 2267 * Fixed many places where too much space was being added between lines. 2268 2269Release 1.68.1 2270 2271The release adds localization support for Farsi (thanks to Sina Heshmati) and 2272improved support for the XLink-based DocBook NG db:link element. Other than 2273that, it is a minor bug-fix update to the 1.68.0 release. The main thing it 2274fixes is a build error that caused the XSLT Java extensions to be jarred up 2275with the wrong package structure. Thanks to Jens Stavnstrup for quickly 2276reporting the problem, and to Mauritz Jeanson for investigating and finding 2277the cause. 2278 2279Release 1.68.0 2280 2281This release includes some features changes, particularly for FO/PDF output, 2282and a number of bug fixes. 2283 2284FO 2285 2286 * Moved footnote properties to attribute-sets. 2287 2288 * Added support for side floats, margin notes, and custom floats. 2289 2290 * Added new parameters body.start.indent and body.end.indent to the 2291 set.flow.properties template. 2292 2293 * Added support for xml:id 2294 2295 * Added support for refdescriptor. 2296 2297 * Added support for multiple refnamedivs. 2298 2299 * Added index.entry.properties attribute-set to support customization of 2300 index entries. 2301 2302 * Added set.flow.properties template call to each fo:flow to support 2303 customizations entry point. 2304 2305 * Add support for @floatstyle in figure 2306 2307 * Moved hardcoded properties for index division titles to the 2308 index.div.title.properties attribute-set. 2309 2310 * Added support for table-layout="auto" for XEP. 2311 2312 * Added index.div.title.properties attribute-set. 2313 2314 * $verbose parameter is now passed to most elements. 2315 2316 * Added refentry to toc in part, as it is permitted by the DocBook 2317 schema/DTD. 2318 2319 * Added backmatter elements and article to toc in part, since they are 2320 permitted by the DocBook schema/DTD. 2321 2322 * Added mode="toc" for simplesect, since it is now permitted in the toc if 2323 simplesect.in.toc is set. 2324 2325 * Moved hard-coded properties to nongraphical.admonintion.properties and 2326 graphical.admonition.properties attribute sets. 2327 2328 * Added support for sidebar-width and float-type processing instructions in 2329 sidebar. 2330 2331 * For tables with HTML markup elements, added support for dbfo bgcolor PI, 2332 the attribute-sets named table.properties, informaltable.properties, 2333 table.table.properties, and table.cell.padding. Also added support for the 2334 templates named table.cell.properties and table.cell.block.properties so 2335 that tabstyles can be implemented. Also added support for tables 2336 containing only tr instead of tbody with tr. 2337 2338 * Added new paramater hyphenate.verbatim.characters which can specify 2339 characters after which a line break can occur in verbatim environments. 2340 This parameter can be used to extend the initial set of characters which 2341 contain only space and non-breakable space. 2342 2343 * Added itemizedlist.label.markup to enable selection of different bullet 2344 symbol. Also added several potential bullet characters, commented out by 2345 default. 2346 2347 * Enabled all id's in XEP output for external olinking. 2348 2349HTML 2350 2351 * Added support for refdescriptor. 2352 2353 * Added support for multiple refnamedivs. 2354 2355 * Added support for xml:id 2356 2357 * refsynopsisdiv as a section for counting section levels 2358 2359Images 2360 2361 * Added new SVG admonition graphics and navigation images. 2362 2363Release 1.67.2 2364 2365This release fixes a table bug introduced in the 1.67.1 release. 2366 2367Release 1.67.1 2368 2369This release includes a number of bug fixes. 2370 2371The following lists provide details about API and feature changes. 2372 2373FO 2374 2375 * Tables: Inherited cell properties are now passed to the 2376 table.cell.properties template so they can be overridden by a 2377 customization. 2378 2379 * Tables: Added support for bgcolor PI on table row element. 2380 2381 * TOCs: Added new parameter simplesect.in.toc; default value of 0 causes 2382 simplesect to be omitted from TOCs; to cause simplesect to be included in 2383 TOCs, you must set the value of simplesect.in.toc to 1.Comment from Norm: 2384 2385 Simplesect elements aren't supposed to appear in the ToC at all... The 2386 use case for simplesect is when, for example, every chapter in a book 2387 ends with "Exercises" or "For More Information" sections and you don't 2388 want those to appear in the ToC. 2389 2390 * Sections: Reverted change that caused a variable reference to be used in a 2391 template match and rewrote code to preserve intended semantics. 2392 2393 * Lists: Added workaround to prevent "* 0.60 + 1em" garbage in list output 2394 from PassiveTeX 2395 2396 * Moved the literal attributes from component.title to the 2397 component.title.properties attribute-set so they can be customized. 2398 2399 * Lists: Added glossdef's first para to special handling in 2400 fo:list-item-body. 2401 2402HTML 2403 2404 * TOCs: Added new parameter simplesect.in.toc; for details, see the list of 2405 FO changes for this release. 2406 2407 * Indexing: Added new parameter index.prefer.titleabbrev; when set to 1, 2408 index references will use titleabbrev instead of title when available. 2409 2410HTML Help 2411 2412 * Added support for generating windows-1252-encoded output using Saxon; for 2413 more details, see the list of XSL Java extensions changes for this 2414 release. 2415 2416man pages 2417 2418 * Replaced named/numeric character-entity references for non-breaking space 2419 with groff equivalent (backslash-tilde). 2420 2421XSL Java extensions 2422 2423 * Saxon extensions: Added the Windows1252 class. It extends Saxon 6.5.x with 2424 the windows-1252 character set, which is particularly useful when 2425 generating HTML Help for Western European Languages (code from Pontus 2426 Haglund and contributed to the DocBook community by Sectra AB, Sweden). 2427 2428 To use: 2429 2430 1. Make sure that the Saxon 6.5.x jar file and the jar file for the 2431 DocBook XSL Java extensions are in your CLASSPATH 2432 2433 2. Create a DocBook XSL customization layer -- a file named 2434 mystylesheet.xsl or whatever -- that, at a minimum, contains the 2435 following: 2436 2437 <xsl:stylesheet 2438 xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 2439 version='1.0'> 2440 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/> 2441 <xsl:output method="html" encoding="WINDOWS-1252" indent="no"/> 2442 <xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"></xsl:param> 2443 <xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"></xsl:param> 2444 <xsl:param name="saxon.character.representation" select="'native'"></xsl:param> 2445 </xsl:stylesheet> 2446 2447 Invoke Saxon with the encoding.windows-1252 Java system property set 2448 to com.nwalsh.saxon.Windows1252; for example 2449 2450 java \ 2451 -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \ 2452 com.icl.saxon.StyleSheet \ 2453 mydoc.xml mystylesheet.xsl 2454 2455 Or, for a more complete "real world" case showing other options you'll 2456 typically want to use: 2457 2458 java \ 2459 -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \ 2460 -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \ 2461 -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \ 2462 -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \ 2463 com.icl.saxon.StyleSheet \ 2464 -x org.apache.xml.resolver.tools.ResolvingXMLReader \ 2465 -y org.apache.xml.resolver.tools.ResolvingXMLReader \ 2466 -r org.apache.xml.resolver.tools.CatalogResolver \ 2467 mydoc.xml mystylesheet.xsl 2468 2469 In both cases, the "mystylesheet.xsl" file should be a DocBook 2470 customization layer containing the parameters show in step 2. 2471 2472 * Saxon extensions: Removed Saxon 8 extensions from release package 2473 2474Release 1.67.0 2475 2476 * A number of important bug fixes. 2477 2478 * Added Saxon8 extensions 2479 2480 * Enabled dbfo table-width on entrytbl in FO output 2481 2482 * Added support for role=strong on emphasis in FO output 2483 2484 * Added new FO parameter hyphenate.verbatim that can be used to turn on 2485 "intelligent" wrapping of verbatim environments. 2486 2487 * Replaced all <tt></tt> output with <code></code> 2488 2489 * Changed admon.graphic.width template to a mode so that different 2490 admonitions can have different graphical widths. 2491 2492 * Deprecated the HTML shade.verbatim parameter (use CSS instead) 2493 2494 * Wrapped ToC refentrytitle/refname and refpurpose in span with class 2495 values. This makes it possible to style them using a CSS stylesheet. 2496 2497 * Use strong/em instead of b/i in HTML output 2498 2499 * Added support for converting Emphasis to groff italic and Emphasis 2500 role='bold' to bold. Controlled by emphasis.propagates.style param, but 2501 not documented yet using litprog system. Will do that next (planning to 2502 add some other parameter-controllable options for hyphenation and handling 2503 of line spacing). 2504 2505 * callout.graphics.number.limit.xml param: Changed the default from 10 to 2506 15. 2507 2508 * verbatim.properties: Added hyphenate=false 2509 2510 * Saxon and Xalan Text.java extensions: Added support for URIResolver() on 2511 insertfile href's 2512 2513 * Added generated RELEASE-NOTES.txt file. 2514 2515 * Added INSTALL file (executable file for generating catalog.xml) 2516 2517 * Removed obsolete tools directory from package 2518 2519Release 1.66.1 2520 2521 * A number of important bug fixes. 2522 2523 * Now xml:base attributes that are generated by an XInclude processor are 2524 resolved for image files. 2525 2526 * Rewrote olink templates to support several new features. 2527 2528 o Extended full olink support to FO output. 2529 2530 o Add support for xrefstyle attribute in olinks. 2531 2532 o New parameters to support new olink features: insert.olink.page.number 2533 , insert.olink.pdf.frag, olink.debug, olink.lang.fallback.sequence, 2534 olink.properties, prefer.internal.olink. See the reference page for 2535 each parameter for more information. 2536 2537 * Added index.on.type parameter for new type attribute introduced in DocBook 2538 4.3 for indexterms and index. This allows you to create multiple indices 2539 containing different categories of entries. For users of 4.2 and earlier, 2540 you can use the new parameter index.on.role instead. 2541 2542 * Added new section.autolabel.max.depth parameter to turn off section 2543 numbering below a certain depth. This permits you to number major section 2544 levels and leave minor section levels unnumbered. 2545 2546 * Added footnote.sep.leader.properties attribute set to format the line 2547 separating footnotes in printed output. 2548 2549 * Added parameter img.src.path as a prefix to HTML img src attributes. The 2550 prefix is added to whatever path is already generated by the stylesheet 2551 for each image file. 2552 2553 * Added new attribute-sets informalequation.properties, 2554 informalexample.properties, informalfigure.properties, and 2555 informaltable.properties, so each such element type can be formatted 2556 individually if needed. 2557 2558 * Add component.label.includes.part.label parameter to add any part number 2559 to chapter, appendix and other component labels when the label.from.part 2560 parameter is nonzero. This permits you to distinguish multiple chapters 2561 with the same chapter number in cross references and the TOC. 2562 2563 * Added chunk.separate.lots parameter for HTML output. This parameter lets 2564 you generate separate chunk files for each LOT (list of tables, list of 2565 figures, etc.). 2566 2567 * Added several table features: 2568 2569 o Added table.table.properties attribute set to add properties to the 2570 fo:table element. 2571 2572 o Added placeholder templates named table.cell.properties and 2573 table.cell.block.properties to enable adding properties to any 2574 fo:table-cell or the cell's fo:block, respectively. These templates 2575 are a start for implementing table styles. 2576 2577 * Added new attribute set component.title.properties for easy modifications 2578 of component's title formatting in FO output. 2579 2580 * Added Saxon support for an encoding attribute on the textdata element. 2581 Added new parameter textdata.default.encoding which specifies encoding 2582 when encoding attribute on textdata is missing. 2583 2584 * Template label.this.section now controls whole section label, not only 2585 sub-label which corresponds to particular label. Former behaviour was IMHO 2586 bug as it was not usable. 2587 2588 * Formatting in titleabbrev for TOC and headers is preserved when there are 2589 no hotlink elements in the title. Formerly the title showed only the text 2590 of the title, no font changes or other markup. 2591 2592 * Added intial.page.number template to set the initial-page-number property 2593 for page sequences in print output. Customizing this template lets you 2594 change when page numbering restarts. This is similar to the 2595 format.page.number template that lets you change how the page number 2596 formatting changes in the output. 2597 2598 * Added force.page.count template to set the force-page-count property for 2599 page sequences in print output. This is similar to the format.page.number 2600 template. 2601 2602 * Sort language for localized index sorting in autoidx-ng.xsl is now taken 2603 from document lang, not from system environment. 2604 2605 * Numbering and formatting of normal and ulink footnotes (if turned on) has 2606 been unified. Now ulink footnotes are mixed in with any other footnotes. 2607 2608 * Added support for renderas attribute in section and sect1 et al. This 2609 permits you to render a given section title as if it were a different 2610 level. 2611 2612 * Added support for label attribute in footnote to manually supply the 2613 footnote mark. 2614 2615 * Added support for DocBook 4.3 corpcredit element. 2616 2617 * Added support for a dbfo keep-together PI for formal objects (table, 2618 figure, example, equation, programlisting). That permits a formal object 2619 to be kept together if it is not already, or to be broken if it is very 2620 long and the default keep-together is not appropriate. 2621 2622 * For graphics files, made file extension matching case insensitive, and 2623 updated the list of graphics extensions. 2624 2625 * Allow calloutlist to have block content before the first callout 2626 2627 * Added dbfo-need processing instruction to provide soft page breaks. 2628 2629 * Added implementation of existing but unused default.image.width parameter 2630 for graphics. 2631 2632 * Support DocBook NG tag inline element. 2633 2634 * It appears that XEP now supports Unicode characters in bookmarks. There is 2635 no further need to strip accents from characters. 2636 2637 * Make segmentedlist HTML markup more semantic and available to CSS styles. 2638 2639 * Added user.preroot placeholder template to permit xsl-stylesheet and other 2640 PIs and comments to be output before the HTML root element. 2641 2642 * Non-chunked legalnotice now gets an <a name="id"> element in HTML output 2643 so it can be referenced with xref or link. 2644 2645 * In chunked HTML output, changed link rel="home" to rel="start", and link 2646 rel="previous" to rel="prev", per W3C HTML 4.01 spec. 2647 2648 * Added several patches to htmlhelp from W. Borgert 2649 2650 * Added Bosnian locale file as common/bs.xml. 2651 2652Release 1.65.0 2653 2654 * A number of important bug fixes. 2655 2656 * Added a workaround to allow these stylesheets to process DocBook NG 2657 documents. (Its a hack that pre-processes the document to strip off the 2658 namespace and then uses exsl:node-set to process the result.) 2659 2660 * Added alternative indexing mechanism which has better internationalization 2661 support. New indexing method allows grouping of accented letters like e, 2662 , into the same group under letter "e". It can also treat special 2663 letters (e.g. "ch") as one character and place them in the correct 2664 position (e.g. between "h" and "i" in Czech language). 2665 2666 In order to use this mechanism you must create customization layer which 2667 imports some base stylesheet (like fo/docbook.xsl, html/chunk.xsl) and 2668 then includes appropriate stylesheet with new indexing code 2669 (fo/autoidx-ng.xsl or html/autoidx-ng.xsl). For example: 2670 2671 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 2672 version="1.0"> 2673 2674 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/> 2675 <xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/> 2676 2677 </xsl:stylesheet> 2678 2679 New method is known to work with Saxon and it should also work with 2680 xsltproc 1.1.1 and later. Currently supported languages are English, 2681 Czech, German, French, Spanish and Danish. 2682 2683Release 1.64.1 2684 2685General bug fixes and improvements. Sorry about the failure to produce an 2686updated release notes file for 1.62.01.63.2 2687 2688 * In the course of fixing bug #849787, wrapping Unicode callouts with an 2689 appropriate font change in the Xalan extensions, I discovered that the 2690 Xalan APIs have changed a bit. So xalan2.jar will work with older Xalan 2 2691 implementations, xalan25.jar works with Xalan 2.5. 2692 2693Release 1.61.0 2694 2695Lots of bug fixes and improvements. 2696 2697 * Initial support for timestamp PI. From now you can use <?dbtimestamp 2698 format="Y-m-d H:M:S"?> to get current datetime in your document. Added 2699 localization support for datetime PI 2700 2701 * Added level 6 to test for section depth in section.level template so that 2702 section.title.level6.properties will be used for sections that are 6 deep 2703 or deeper. This should also cause a h6 to be created in html output. 2704 2705 * Don't use SVG graphics if use.svg=0 2706 2707 * Now uses number-and-title-template for sections only if section.autolabel 2708 is not zero. 2709 2710 * Added missing 'english-language-name' attribute to the l10n element, and 2711 the missing 'style' attribute to the template element so the current 2712 gentext documents will validate. 2713 2714 * Corrected several references to parameter qanda.defaultlabel that were 2715 missing the "$". 2716 2717 * Now accepts admon.textlabel parameter to turn off Note, Warning, etc. 2718 label. 2719 2720 * FeatReq #684561: support more XEP metadata 2721 2722 * Added hyphenation support. Added support for coref. Added beginpage 2723 support. (does nothing; see TDG). 2724 2725 * Added support for hyphenation-character, hyphenation-push-character-count, 2726 and hyphenation-remain-character-count 2727 2728 * Added root.properties, ebnf.assignment, and ebnf.statement.terminator 2729 2730 * Support bgcolor PI in table cells; make sure rowsep and colsep don't have 2731 any effect on the last row or column 2732 2733 * Handle othercredit on titlepage a little better 2734 2735 * Applied fix from Jeff Beal that fixed the bug that put secondary page 2736 numbers on primary entries. Same with tertiary page numbers on secondary 2737 entries. 2738 2739 * Added definition of missing variable collection. 2740 2741 * Make footnote formatting 'normal' even when it occurs in a context that 2742 has special formatting 2743 2744 * Added warning when glossary.collection is not blank, but it cannot open 2745 the specified file. 2746 2747 * Pick up the frame attribute on table and informaltable. 2748 2749 * indexdiv/title in non-autogenerated indexes are now picked up. 2750 2751 * Removed (unused) component.title.properties 2752 2753 * Move IDs from page-sequences down to titlepage blocks 2754 2755 * Use proportional-column-width(1) on more tables. 2756 2757 Use proportional-column-width() for header/footer tables; suppress 2758 relative-align when when using FOP 2759 2760 * Check for glossterm.auto.link when linking firstterms; don't output gl. 2761 prefix on glossterm links 2762 2763 * Generate Part ToCs 2764 2765 * Support glossary, bibliography, and index in component ToCs. 2766 2767 * Refactored chunking code so that customization of chunk algorithm and 2768 chunk elements is more practical 2769 2770 * Support textobject/phrase on inlinemediaobject. 2771 2772 * Support 'start' PI on ordered lists 2773 2774 * Fixed test of $toc PI to turn on qandaset TOC. 2775 2776 * Added process.chunk.footnotes to sect2 through 5 to fix bug of missing 2777 footnotes when chunk level greater than 1. 2778 2779 * Added paramater toc.max.depth which controls maximal depth of ToC as 2780 requested by PHP-DOC group. 2781 2782 * Exempted titleabbrev from preamble processing in lists, and fixed 2783 variablelist preamble code to use the same syntax as the other lists. 2784 2785 * Added support for elements between variablelist and first varlistentry 2786 since DocBook 4.2 supports that now. 2787 2788Release 1.60.1 2789 2790Lots of bug fixes. 2791 2792 * The format of the titlepage.templates.xml files and the stylesheet that 2793 transforms them have been significantly changed. All of the attributes 2794 used to control the templates are now namespace qualified. So what used to 2795 be: 2796 2797 <t:titlepage element="article" wrapper="fo:block"> 2798 2799 is now: 2800 2801 <t:titlepage t:element="article" t:wrapper="fo:block"> 2802 2803 Attributes from other namespaces (including those that are unqualified) 2804 are now copied directly through. In practice, this means that the names 2805 that used to be fo: qualified: 2806 2807 <title named-template="component.title" 2808 param:node="ancestor-or-self::article[1]" 2809 fo:text-align="center" 2810 fo:keep-with-next="always" 2811 fo:font-size="&hsize5;" 2812 fo:font-weight="bold" 2813 fo:font-family="{$title.font.family}"/> 2814 2815 are now unqualified: 2816 2817 <title t:named-template="component.title" 2818 param:node="ancestor-or-self::article[1]" 2819 text-align="center" 2820 keep-with-next="always" 2821 font-size="&hsize5;" 2822 font-weight="bold" 2823 font-family="{$title.font.family}"/> 2824 2825 The t:titlepage and t:titlepage-content elements both generate wrappers 2826 now. And unqualified attributes on those elements are passed through. This 2827 means that you can now make the title font apply to ane entire titlepage 2828 and make the entire recto titlepage centered by specifying the font and 2829 alignment on the those elements: 2830 2831 <t:titlepage t:element="article" t:wrapper="fo:block" 2832 font-family="{$title.font.family}"> 2833 2834 <t:titlepage-content t:side="recto" 2835 text-align="center"> 2836 2837 * Support use of titleabbrev in running headers and footers. 2838 2839 * Added (experimental) xref.with.number.and.title parameter to enable 2840 number/title cross references even when the default would be just the 2841 number. 2842 2843 * Generate part ToCs if they're requested. 2844 2845 * Use proportional-column-width() in header/footer tables. 2846 2847 * Handle alignment correctly when screenshot wraps a graphic in a figure. 2848 2849 * Format chapter and appendix cross references consistently. 2850 2851 * Attempt to support tables with multiple tgroups in FO. 2852 2853 * Output fo:table-columns in simplelist tables. 2854 2855 * Use titlepage.templates.xml for indexdiv and glossdiv formatting. 2856 2857 * Improve support for new bibliography elements. 2858 2859 * Added footnote.number.format, table.footnote.number.format, 2860 footnote.number.symbols, and table.footnote.number.symbols for better 2861 control of footnote markers. 2862 2863 * Added glossentry.show.acronyms. 2864 2865 * Suppress the draft-mode page masters when draft-mode is no. 2866 2867 * Make blank pages verso not recto. D'Oh! 2868 2869 * Improved formatting of ulink footnotes. 2870 2871 * Fixed bugs in graphic width/height calculations. 2872 2873 * Added class attributes to inline elements. 2874 2875 * Don't add .html to the filenames identified with the dbhtml PI. 2876 2877 * Don't force a ToC when sections contain refentrys. 2878 2879 * Make section title sizes a function of the body.master.size. 2880 2881Release 1.59.2 2882 2883The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail. 2884 2885 * Removed the region-name from the region-body of blank pages. There's no 2886 reason to give the body of blank pages a unique name and doing so causes a 2887 mismatch that FOP detects. 2888 2889 * Output IDs for the first paragraphs in listitems. 2890 2891 * Fixed some small bugs in the handling of page numbers in double-sided 2892 mode. 2893 2894 * Attempt to prevent duplicated IDs from being produced when endterm on xref 2895 points to something with nested structure. 2896 2897 * Fix aligment problems in equations. 2898 2899 * Output the type attribute on unordered lists (UL) in HTML only if the 2900 css.decoration parameter is true. 2901 2902 * Calculate the font size in formal.title.properties so that it's 1.2 times 2903 the base font size, not a fixed "12pt". 2904 2905Release 1.59.1 2906 2907The 1.59.1 fixes a few bugs. 2908 2909 * Added Bulgarian localization. 2910 2911 * Indexing improvements; localize book indexes to books but allow setindex 2912 to index an entire set. 2913 2914 * The default value for rowsep and colsep is now "1" as per CALS. 2915 2916 * Added support for titleabbrev (use them for cross references). 2917 2918 * Improvements to mediaobject for selecting print vs. online images. 2919 2920 * Added seperate property sets for figures, examples, equations, tabless, 2921 and procedures. 2922 2923 * Make lineannotations italic. 2924 2925 * Support xrefstyle attribute. 2926 2927 * Make endterm on xref higher priority than xreflabel target. 2928 2929 * Glossary formatting improvements. 2930 2931Release 1.58.0 2932 2933The 1.58.0 adds some initial support for extensions in xsltproc, adds a few 2934features, and fixes bugs. 2935 2936 * This release contains the first attempt at extension support for xsltproc. 2937 The only extension available to date is the one that adjusts table column 2938 widths. Run extensions/xsltproc/python/xslt.py. 2939 2940 * Fixed bugs in calculation of adjusted column widths to correct for 2941 rounding errors. 2942 2943 * Support nested refsection elements correctly. 2944 2945 * Reworked gentext.template to take context into consideration. The name of 2946 elements in localization files is now an xpath-like context list, not just 2947 a simple name. 2948 2949 * Made some improvements to bibliography formatting. 2950 2951 * Improved graphical formatting of admonitions. 2952 2953 * Added support for entrytbl. 2954 2955 * Support spanning index terms. 2956 2957 * Support bibliosource. 2958 2959Release 1.57.0 2960 2961 * The 1.57.0 release wasn't documented here. Oops. 2962 2963Release 1.56.0 2964 2965The 1.56.0 release fixes bugs. 2966 2967 * Reworked chunking. This will break all existing customizations layers that 2968 change the chunking algorithm. If you're customizing chunking, look at the 2969 new content parameter that's passed to process-chunk-element and 2970 friends. 2971 2972 * Support continued and inherited numeration in orderedlist formatting for 2973 FOs. 2974 2975 * Added Thai localization. 2976 2977 * Tweaked stylesheet documentation stylesheets to link to TDG and the 2978 parameter references. 2979 2980 * Allow title on tables of contents ("Table of Contents") to be optional. 2981 Added new keyword to generate.toc. Support tables of contents on sections. 2982 2983 * Made separate parameters for table borders and table cell borders: 2984 table.frame.border.color, table.frame.border.style, 2985 table.frame.border.thickness, table.cell.border.color, 2986 table.cell.border.style, and table.cell.border.thickness. 2987 2988 * Suppress formatting of endofrange indexterms. This is only half-right. 2989 They should generate a range, but I haven't figured out how to do that 2990 yet. 2991 2992 * Support revdescription. (Bug #582192) 2993 2994 * Added default.float.class and fixed figure floats. (Bug #497603) 2995 2996 * Fixed formatting of sbr in FOs. 2997 2998 * Added context to the missing template error message. 2999 3000 * Process arg correctly in a group. (Bug #605150) 3001 3002 * Removed 'keep-with-next' from formal.title.properties attribute set now 3003 that the stylesheets support the option of putting such titles below the 3004 object. Now the $placement value determines if 'keep-with-next' or 3005 'keep-with-previous' is used in the title block. 3006 3007 * Wrap url() around external-destinations when appropriate. 3008 3009 * Fixed typo in compact list spacing. (Bug #615464) 3010 3011 * Removed spurious hash in anchor name. (Bug #617717) 3012 3013 * Address is now displayed verbatim on title pages. (Bug #618600) 3014 3015 * The bridgehead.in.toc parameter is now properly supported. 3016 3017 * Improved effectiveness of HTML cleanup by increasing the number of places 3018 where it is used. Improve use of HTML cleanup in XHTML stylesheets. 3019 3020 * Support table of contents for appendix in article. (Bug #596599) 3021 3022 * Don't duplicate footnotes in bibliographys and glossarys. (Bug #583282) 3023 3024 * Added default.image.width. (Bug #516859) 3025 3026 * Totally reworked funcsynopsis code; it now supports a 'tabular' 3027 presentation style for 'wide' prototypes; see 3028 funcsynopsis.tabular.threshold. (HTML only right now, I think, FO support, 3029 uh, real soon now.) 3030 3031 * Reworked support for difference marking; toned down the colors a bit and 3032 added a system.head.content template so that the diff CSS wasn't 3033 overriding user.head.content. (Bug #610660) 3034 3035 * Added call to the *.head.content elements when writing out long 3036 description chunks. 3037 3038 * Make sure legalnotice link is correct even when chunking to a different 3039 base.dir. 3040 3041 * Use CSS to set viewport characteristics if css.decoration is non-zero, use 3042 div instead of p for making graphic a block element; make figure titles 3043 the default alt text for images in a figure. 3044 3045 * Added space-after to list.block.spacing. 3046 3047 * Reworked section.level template to give correct answer instead of being 3048 off by one. 3049 3050 * When processing tables, use the tabstyle attribute as the division class. 3051 3052 * Fixed bug in html2xhtml.xsl that was causing the XHTML chunker to output 3053 HTML instead of XHTML. 3054 3055Older releases 3056 3057To view the release notes for older releases, see 3058http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml. Be aware 3059that there were no release notes for releases prior to the 1.50.0 release. 3060 3061About dot-zero releases 3062 3063DocBook Project dot zero releases should be considered experimental and are 3064always followed by stable dot one releases, usually within two or three 3065weeks. Please help to ensure the stability of dot one releases by carefully 3066testing each dot zero release and reporting back about any problems you 3067find. 3068 3069It is not recommended that you use a dot zero release in a production 3070system, or package it for an OS distro. Instead, you should wait for the dot 3071one version. 3072 3073 3074