From 2923b4cc34ffd74965bd13f9ccb9196673714da2 Mon Sep 17 00:00:00 2001 From: pdmef Date: Sat, 10 Sep 2005 02:57:13 +0000 Subject: [PATCH] Rocco Rutte: - remove some bloating docs of the XSLT distribution git-svn-id: svn://svn.berlios.de/mutt-ng/trunk@503 e385b8ad-14ed-0310-8656-cc95a2468c6d --- VERSION.svn | 2 +- doc/xslt/ChangeLog | 621 ------- doc/xslt/INSTALL | 78 - doc/xslt/NEWS | 3326 ----------------------------------- doc/xslt/RELEASE-NOTES.html | 1093 ------------ doc/xslt/RELEASE-NOTES.pdf | Bin 214352 -> 0 bytes doc/xslt/RELEASE-NOTES.txt | 1442 --------------- doc/xslt/RELEASE-NOTES.xml | 2469 -------------------------- doc/xslt/TODO | 5 - 9 files changed, 1 insertion(+), 9035 deletions(-) delete mode 100644 doc/xslt/ChangeLog delete mode 100644 doc/xslt/INSTALL delete mode 100644 doc/xslt/NEWS delete mode 100644 doc/xslt/RELEASE-NOTES.html delete mode 100644 doc/xslt/RELEASE-NOTES.pdf delete mode 100644 doc/xslt/RELEASE-NOTES.txt delete mode 100644 doc/xslt/RELEASE-NOTES.xml delete mode 100644 doc/xslt/TODO diff --git a/VERSION.svn b/VERSION.svn index cc5027e..a712e76 100644 --- a/VERSION.svn +++ b/VERSION.svn @@ -1 +1 @@ -502 +503 diff --git a/doc/xslt/ChangeLog b/doc/xslt/ChangeLog deleted file mode 100644 index 9b47f70..0000000 --- a/doc/xslt/ChangeLog +++ /dev/null @@ -1,621 +0,0 @@ -2005-08-11 Michael Smith - - * RELEASE-NOTES.xml: Updated for 1.69.1 release. - - * VERSION: Version 1.69.1 released. - -2005-07-19 Michael Smith - - * Makefile: New file. - -2005-07-18 Michael Smith - - * RELEASE-NOTES.xml: Final changes for 1.69.0 release. - - * VERSION: Version 1.69.0 released. - -2005-07-14 Michael Smith - - * RELEASE-NOTES.xml: Checkpointing. Still need to add FO section. - -2005-06-30 Michael Smith - - * RELEASE-NOTES.xml: Added "General" stuff. - - * RELEASE-NOTES.xml: First updates for 1.69.0 release. - - So far, only includes descriptions of the manpages changes. Sorry, - that is all I could managed to get done so far. If anybody else - has time to add descriptions for the HTML and FO stylesheets, - please do. Otherwise, I will get back to work on them later - tonight my time. - -2005-06-28 Michael Smith - - * .cvsignore: ignore RELEASE-NOTES.pdf and RELEASE-NOTES.fo - - * README: Update to include Slides and Website info, and also some other - clarifications. - -2005-06-27 Michael Smith - - * .cvsignore: Ignore slides and website subdirs - - * Makefile: Always make NEWS and install.sh - -2005-06-17 Michael Smith - - * Makefile: Incorporated slides and website stylesheets into the build. - - Note: This currently only affects the "distrib" (doc) build. So if - you don't need to build distrib/doc, you won't be affected by this - change. If you DO need to build distrib/doc, it will break unless - you use the xsl/Makefile from the "build" branch instead of from - the head. - - This build alters the distrib build such that: - - - an xsl/slides directory is created by copying over the - contents of the slides/xsl - - - an xsl/website directory is created by copying over the - contents of the website/xsl directory - - - the reference.html part of the doc build now adds the slides - and website param reference doc - - This is an experiment. If we decide to go ahead with it in the - release build, and everything is found to be OK when it gets out - to users and they test it, then the next step would be to ask SF - admin to move the website/xsl and slides/xsl CVS directory into - xsl/ to create xsl/slides and xsl/website, and they would be - maintained in the xsl/ CVS going forward. - -2005-05-28 Jirka Kosek - - * Makefile: branches: 1.23.2; - Added lib directory to the list of directories for which separate Makefile is called - -2005-05-26 Michael Smith - - * INSTALL: Replaced leftover instances of "Website" - - * README: minor formatting change - -2005-05-13 Michael Smith - - * MANIFEST.build: no longer needed - - * Makefile: Minor changes to packaging/release-related stuff - -2005-05-12 Michael Smith - - * MANIFEST.build: removed common/Makefile - - * Makefile: fixed realclean target (build branch) - -2005-05-09 Michael Smith - - * Makefile: changed to match latest releasetools/Targets.mk updates - -2005-04-22 Michael Smith - - * .cvsignore, .urilist, Makefile: .urilist is made by "make install.sh" (duh) - - * Makefile: remove leading tab from pathname in URILIST value - -2005-04-21 Michael Smith - - * .cvsignore: don't ignore catalog.xml (now under version control) - - * .urilist: corrected path - - * catalog.xml: New file. - -2005-04-20 Michael Smith - - * .cvsignore, AUTHORS, COPYING, INSTALL, LICENSE, README: - normalize release meta-info/readme files - - * .urilist: New file. - -2005-04-15 Michael Smith - - * Makefile: added EXECUTABLES variable, and added scripts to its value - -2005-04-11 Michael Smith - - * Makefile: revert change; put MANIFEST.build exclude in global excludes - - * Makefile: don't package - -2005-04-06 Michael Smith - - * Makefile: (build branch): updated to rely on new modular makefile structure - -2005-03-31 Michael Smith - - * Makefile: zip target, don't write dummy stamp - -2005-03-28 Michael Smith - - * Makefile: debian package build tweaks - -2005-03-27 Michael Smith - - * LICENSE: branches: 1.1.2; - file LICENSE was initially added on branch build. - - * LICENSE: New file. - -2005-03-25 Michael Smith - - * Makefile: .deb build and upload automation added - -2005-03-19 Michael Smith - - * INSTALL: typo fixed. (Thanks for Mike Castle) - -2005-02-24 Michael Smith - - * Makefile: changes needed for generating manpages ref doc, ported from build branch - - * Makefile: Added litprog reference documentation infrastructure for manpages. - Note that changes to the existing Makefile doc/Makefile docsrc/Makefile files - are on the build branch only, so will need to be back-ported to head - in order for head builds of the docs to include doc for manpage params - -2005-02-21 Michael Smith - - * RELEASE-NOTES.xml: dbtimestamp PI, use instead of RCS Date keyword - - * RELEASE-NOTES.xml: RCS Date keyword, use instead of hard-coded date - -2005-02-14 Michael Smith - - * RELEASE-NOTES.xml: late updates for the 1.68.1; checked in after the release was already - tagged. sorry. not the first time, and probably not the last - - * RELEASE-NOTES.xml: Update for 1.68.1 release. - - * VERSION: Version 1.68.1 released. - -2005-02-09 Michael Smith - - * Makefile: classpath check added (in "build" branch only) - - * RELEASE-NOTES.xml: Added HTML and image/ changes for 1.68.0 release. - - * RELEASE-NOTES.xml: Added doc for FO changes. - - * VERSION: Version 1.68.0 released - -2004-12-06 Michael Smith - - * Makefile: docbook.sf.net/release/xsl -- automated upload to - - * RELEASE-NOTES.xml: parameter values in WINDOWS-1252 example, properly (doubly) quoted - -2004-12-03 Michael Smith - - * Makefile: "upload" target added (uploads to SF FTP incoming directory) - -2004-12-02 Michael Smith - - * .cvsignore: ignore RELEASENOTES.txt - - * INSTALL: New file. - - * MANIFEST.build: branches: 1.1.2; - list of files to go into build branch - - * MANIFEST.build: New file. - - * MANIFEST.build: removing from HEAD - - * Makefile: Don't package prj.el files - - * Makefile: Modified Makefiles -> build branch - - * Makefile: MANIFEST.build file, don't package - - * Makefile: Saxon 8 extensions, don't package in snapshot (build branch) - - * RELEASE-NOTES.xml: Updated for the 1.67.2 release. - - * VERSION: Version 1.67.2 released. - - * VERSION: Version 1.67.1 released. - -2004-12-01 Michael Smith - - * RELEASE-NOTES.xml: Final cleanup for 1.67.1 release - -2004-11-30 Michael Smith - - * RELEASE-NOTES.xml: Update for 1.67.1 release - -2004-11-09 Michael Smith - - * BUGS, README, TODO: update various readme's to direct users to SF for bugs * todo's, - and update mantifest to include info about all current subdirs and files - - * README: typo fixed - - * RELEASE-NOTES.xml: Added markup and fixed typos. - - * RELEASE-NOTES.xml: Updated for 1.67.0 - - * VERSION: Version 1.67.0 released. - -2004-10-17 Norman Walsh - - * VERSION: Capitalization tweaks necessary for the latest freshmeat script - -2004-09-20 Michael Smith - - * VERSION: Version 1.66.1 released. - -2004-09-19 Robert Stayton - - * RELEASE-NOTES.xml: Updated for 1.66.1. - - * VERSION: Move to 1.66.1. - -2004-09-11 Robert Stayton - - * RELEASE-NOTES.xml: Fixed broken CVS keyword. - - * RELEASE-NOTES.xml: Updated release notes for version 1.66.0 - - * VERSION: Updated version to 1.66.0 - -2004-09-02 Robert Stayton - - * RELEASE-NOTES.xml: Updated for release 1.66. - -2004-03-09 Norman Walsh - - * VERSION: Version 1.65.1 released - -2004-02-27 Norman Walsh - - * RELEASE-NOTES.xml: Updated - - * VERSION: Version 1.65.0 released. - - * VERSION: No really, version 1.65.0 released. - -2004-02-24 Norman Walsh - - * .cvsignore: Don't ignore debian anymore, it's gone - -2004-01-08 Norman Walsh - - * Makefile: branches: 1.21.2; - Tweaks for freshmeat-submit - - * VERSION: Tweaks for freshmeat-submit - -2003-12-31 Jirka Kosek - - * RELEASE-NOTES.xml: Info about new indexing method - -2003-12-19 Norman Walsh - - * Makefile: Check for DIFFVER and make sure tags happen - - * RELEASE-NOTES.xml: Not terribly interesting RELEASE NOTES file for 1.64.1 - -2003-12-17 Norman Walsh - - * Makefile, VERSION: Prepare to support freshmeat-submit for next release - -2003-12-15 Norman Walsh - - * VERSION: Version 1.64.0 released. - - * VERSION: Version 1.63.0 released. - -2003-09-29 Norman Walsh - - * VERSION: Version 1.62.4 released. - -2003-09-28 Norman Walsh - - * VERSION: Version 1.62.2 released. - - * VERSION: Version 1.62.3 released. - -2003-09-27 Norman Walsh - - * VERSION: Version 1.62.1 released. - -2003-08-31 Norman Walsh - - * VERSION: Version 1.62.0 released. - -2003-06-22 Norman Walsh - - * VERSION: Version 1.61.3 released. - -2003-05-22 Norman Walsh - - * VERSION: Version 1.61.2 released. - -2003-05-19 Norman Walsh - - * VERSION: Post 1.61.1 updates - -2003-05-18 Norman Walsh - - * VERSION: Version 1.61.1 released. - - * VERSION: Version 1.60.1 released. - -2003-05-08 Norman Walsh - - * RELEASE-NOTES.xml: Updated - - * VERSION: Post 1.61.0 hacking - - * VERSION: Version 1.61.0 released. - -2003-01-24 Norman Walsh - - * RELEASE-NOTES.xml: Updated - - * VERSION: Version 1.60.1 released. - -2003-01-23 Adam Di Carlo - - * Makefile: make use of stuff set in Makefile.incl - -2003-01-21 Norman Walsh - - * Makefile: Test RELEASE-NOTES.xml for validity before formatting it - - * VERSION: Version 1.60.0 released. - -2003-01-20 Norman Walsh - - * RELEASE-NOTES.xml: Explain changes to titlepage template code - -2003-01-17 Norman Walsh - - * RELEASE-NOTES.xml: Updated for 1.59.2 release - - * VERSION: Version 1.59.2 released. - -2003-01-12 Norman Walsh - - * RELEASE-NOTES.xml: Updated release notes for 1.59.1 - - * VERSION: Version 1.59.1 released. - -2003-01-01 Norman Walsh - - * VERSION: Version 1.59.0 released. - -2002-11-29 Norman Walsh - - * Makefile: Exclude the debian directory from the distribution archive - - * VERSION: Version 1.58.1 released. - -2002-11-17 Norman Walsh - - * .cvsignore: Ignore the debian directory - - * Makefile: Don't include pyc files in distribution - - * README: Copyright this year too, huh? - - * RELEASE-NOTES.xml: Release notes - - * VERSION: Version 1.58.0 released. - -2002-10-22 Norman Walsh - - * VERSION: Version 1.57.0 released. - -2002-10-09 Norman Walsh - - * RELEASE-NOTES.xml: Added release note about the change to html2xhtml to fix XHTML chunking - - * VERSION: Version 1.56.0 released. - - * VERSION: Version 1.56.1 released. - -2002-10-08 Norman Walsh - - * RELEASE-NOTES.xml: Fixed pubdate - - * RELEASE-NOTES.xml: Updated for 1.56.0 release - -2002-09-19 Norman Walsh - - * Makefile: Use the new doc-link-docbook stylesheet for the Release Notes - -2002-09-17 Norman Walsh - - * RELEASE-NOTES.xml: Updated for 1.55.0 - - * VERSION: Version 1.55.0 released. - -2002-09-03 Norman Walsh - - * RELEASE-NOTES.xml: Updated for 1.54.0 release - - * RELEASE-NOTES.xml: Updated for 1.54.1 - - * VERSION: Version 1.54.1 released. - - * VERSION: Version 1.54.0 released. - -2002-07-28 Norman Walsh - - * RELEASE-NOTES.xml: Updated for 1.53.0 release - - * VERSION: Version 1.53.0 released. - -2002-07-10 Norman Walsh - - * VERSION: Version 1.52.2 released. - -2002-07-08 Norman Walsh - - * Makefile: Exclude .#* from zip as well - - * VERSION: Keep CVS and real releases distinct - - * VERSION: Version 1.52.1 released. - -2002-07-07 Norman Walsh - - * Makefile: Added RELEASE-NOTES.pdf target - - * RELEASE-NOTES.xml: Updated for 1.52.0 - - * VERSION: Version 1.52.0 released. - -2002-06-03 Norman Walsh - - * VERSION: Version 1.51.1 released. - -2002-06-02 Norman Walsh - - * RELEASE-NOTES.xml: Added release notes for 1.51.0 - - * VERSION: Version 1.51.0 released. - -2002-05-16 Norman Walsh - - * VERSION: Version 1.50.1-EXP2 released. - - * VERSION: Oops again. - - * VERSION: Oops. - -2002-03-25 Norman Walsh - - * Makefile: Updated xhtml generation - - * VERSION: Version 1.50.1-EXP released. - -2002-03-21 Norman Walsh - - * Makefile: Allow next version to be specified on call to make - - * RELEASE-NOTES.xml: Added note about three-part versions - - * RELEASE-NOTES.xml: Tweaked intro; changed date - - * VERSION: Version 1.50.0 released. - -2002-03-18 Norman Walsh - - * .cvsignore, Makefile: Added RELEASE-NOTES.html - - * RELEASE-NOTES.xml: New file. - -2002-03-14 Norman Walsh - - * VERSION: Keep CVS versions distinct from real releases - -2002-03-01 Jirka Kosek - - * Makefile: First portion of new profiling code. New stylesheet parameters will come later. - -2002-02-21 Norman Walsh - - * Makefile: Make sure xhtml directory gets built properly - -2002-02-20 Norman Walsh - - * VERSION: Version 1.49 released. - -2002-01-06 Norman Walsh - - * Makefile: Clean docsrc - - * Makefile: Remove .*~ from the ZIP file - - * VERSION: Version 1.48 released. - -2001-11-28 Norman Walsh - - * README: Updated Use section - - * VERSION: Keep CVS versions distinct from real releases - - * VERSION: Version 1.47 released. - -2001-10-13 Norman Walsh - - * VERSION: Version 1.46 released. - -2001-09-29 Norman Walsh - - * VERSION: Version 1.45 released. - - * VERSION: Keep CVS versions distinct from real releases - -2001-08-14 Norman Walsh - - * VERSION: Version 1.44 released. - -2001-08-13 Norman Walsh - - * VERSION: Keep CVS versions distinct from real releases - - * VERSION: Version 1.43 released. - -2001-08-06 Norman Walsh - - * VERSION: Keep CVS versions distinct from real releases - - * VERSION: Version 1.42 released. - -2001-08-04 Norman Walsh - - * VERSION: Make VERSION a parameter so that it isn't an error some stylesheets override it - -2001-07-09 Norman Walsh - - * VERSION: Version 1.41 released. - -2001-06-14 Norman Walsh - - * VERSION: Version 1.40 released. - -2001-05-24 Norman Walsh - - * VERSION: Version 1.39 released. - -2001-05-21 Norman Walsh - - * VERSION: Version 1.38 released. - -2001-04-20 Norman Walsh - - * VERSION: Version 1.37 released. - -2001-04-15 Norman Walsh - - * Makefile, README: Make distribution hacks - -2001-04-04 Norman Walsh - - * VERSION: Version 1.36 released. - -2001-04-03 Norman Walsh - - * .cvsignore, Makefile: Misc. cleanup in preparation for making a distrib - -2001-04-02 Norman Walsh - - * BUGS, Makefile, README.CVS, TODO, VERSION: Initial checkin - - * Makefile: Make common files - diff --git a/doc/xslt/INSTALL b/doc/xslt/INSTALL deleted file mode 100644 index 7160c97..0000000 --- a/doc/xslt/INSTALL +++ /dev/null @@ -1,78 +0,0 @@ -$Id$ - -INSTALL file for the DocBook XSL stylesheets distribution - ----------------------------------------------------------------------- -Case #1: Installation using a package management system ----------------------------------------------------------------------- -If you have installed the DocBook XSL distribution using "apt-get", -"yum", "urpmi", or some similar package-management front-end, -then, as part of the package installation, the stylesheets have -already been automatically installed in the appropriate location -for your system, and your XML catalog environment has probably -been updated to use that location. - ----------------------------------------------------------------------- -Case #2: Installing manually ----------------------------------------------------------------------- -If you have downloaded a docbook-xsl zip, tar.gz, or tar.bz2 -file, use the following steps to install it. - - 1. Move the zip, tar.gz, or tar.bz2 file to the directory where - you'd like to install it (not to a temporary directory). - - 2. unzip or untar/uncompress the file - - That will create a docbook-xsl-$VERSION directory (where - $VERSION is the version number for the release). - -The remaining steps are all OPTIONAL. They are intended to -automatically update your user environment with XML Catalog -information about the DocBook XSL distribution. You are NOT -REQUIRED to complete these remaining steps. However, if you do -not, and you want to use XML catalogs with the DocBook XSL -stylesheets, you will need to manually update your XML catalog -environment - - 3. Change to the docbook-xsl-$VERSION directory and execute the - install.sh script: - - ./install.sh - - That will launch an interactive installer, which will emit a - series of prompts for you to respond to. After the process is - complete, the installer will emit a message with a command - you need to run in order to source your environment for use - with the stylesheets. - - 4. To test that he installation has updated your environment - correctly, execute the test.sh script: - - ./test.sh - - That will test your XML catalog environment, using both the - xmlcatalog application and the Apache XML Commons Resolver. - - NOTE: The test.sh file is not created until the install.sh - file is run for the first time. So you need to run the - install.sh script before running the test.sh script. - - 5. (UNINSTALLING) If/when you want to uninstall the release, - execute the uninstall.sh script. - - ./uninstall.sh - - That will revert all changes made by the install.sh script. - - NOTE: The uninstall.sh file is not created until the install.sh - file is run for the first time. So you need to run the - - ----------------------------------------------------------------------- -Note to packagers ----------------------------------------------------------------------- -The install.sh, .CatalogManager.properties.example, and .urilist -files should not be packaged. They are useful only to users who -are installing the stylesheets manually. - -The catalog.xml file should be packaged. diff --git a/doc/xslt/NEWS b/doc/xslt/NEWS deleted file mode 100644 index 40807cd..0000000 --- a/doc/xslt/NEWS +++ /dev/null @@ -1,3326 +0,0 @@ -Changes since version 1.69.0 (2005-07-18) - -Changes to xsl/* - - | 2005-08-11 Michael Smith - | - | * RELEASE-NOTES.xml: Updated for 1.69.1 release. - | - | * VERSION: Version 1.69.1 released. - | - | 2005-07-19 Michael Smith - | - | * Makefile: New file. - | - -Changes to xsl/fo/* - - | 2005-08-09 Robert Stayton - | - | * autoidx.xsl: Fix bug 1247565: missing attribute set on - | symbol entries. - | - | * block.xsl, ebnf.xsl, table.xsl, titlepage.xsl: fo:table-body - | and fo:table-header now set start-indent and end-indent to - | zero to reset the table reference areas. - | - | 2005-08-05 Jirka Kosek - | - | * autoidx.xsl: Fixed bug #1244478. Indexterms in informal - | objects are now getting correct page reference. - | - | 2005-07-27 Robert Stayton - | - | * pagesetup.xsl: Fixed starting page number for first part - | element in single-sided output. - | - -Changes to xsl/html/* - - | 2005-08-11 Michael Smith - | - | * annotations.xsl: Set default value of annotation.support - | param to 0 (off). Also, wrapped contents of the - | apply-annotations template in a "if" statement, so that - | those contents get evaluated only if annotation.support is - | non-zero. The reason for these changes was a report from - | Doug du Boulay (on the docbook-apps list) that processing of - | the apply-annotations template was consuming 75% of the - | total processing time for a 2.5Mb file. Anatoly Techtonik - | followed with a comment that with 1.69.0, "Compiling took - | about full working day on 12Mb file while earlier it was - | about 2-4 hours". - | - | 2005-08-04 Robert Stayton - | - | * chunk-code.xsl, chunkfast.xsl: Add cf to - | exclude-result-prefixes because it is for internal use only. - | - -Changes to xsl/manpages/* - - | 2005-08-11 Michael Smith - | - | * lists.xsl: Fixed check for first following siblings in - | lists. - | - | 2005-08-09 Michael Smith - | - | * block.xsl, lists.xsl, utility.xsl: Output .sp macro in mixed - | blocks where we were outputting completely blank line - | before. Thanks (again) to Costin Stroie for pointing out the - | problems and providing a test case. Also, corrected the test - | for checking first preceding siblings of text nodes in mixed - | blocks (the test is used for determining whether or not we - | need to insert a line break before those nodes.) - | - | 2005-08-05 Michael Smith - | - | * utility.xsl: Fixed bug that caused literal .sp to show up in - | output. (Thanks to Costin Stroie for reporting). WARNING: - | One of the consequences of this change is that the - | stylesheet no longer generates spaces at the end of certain - | lines. I had it doing that as a sort of hack to prevent - | certain kinds of problems in output. It seems like the hack - | my no longer be necessary. But if I am wrong, this change - | may cause spaces to show up at the beginning of some lines - | in "mixed content". If you see those, then this change has - | introduced a regression, and I will need to go back and - | figure out the right way to fix it (instead of the kludgy - | way I was doing it before. Also, instances like the - | following were showing up in some cases. .PP .sp That is, a - | .PP macro immediately followed by a .sp macro. I can think - | of no good read to ever generate that, and I am not sure why - | it is getting generated. So I have taked the lazy way out - | and caused the stylesheet to now strip out the .sp from all - | such instances, leaving just the .PP - | - | 2005-07-24 Michael Smith - | - | * block.xsl, lists.xsl, utility.xsl: New file. - | - | * block.xsl, lists.xsl, utility.xsl: Fixed handling of lists - | with titles. Also reworked handling of space around lists. - | (Closes #1243003 and 1241371). Among other things, this - | change "normalizes" line space before and after verbatims. - | For most cases, the stylesheet now attempts to ensure each - | verbatim is preceded and followed by exactly one line of - | space. - | - -Changes to xsl/params/* - - | 2005-08-11 Michael Smith - | - | * annotation.support.xml: Set default value of - | annotation.support param to 0 (off). Also, wrapped contents - | of the apply-annotations template in a "if" statement, so - | that those contents get evaluated only if annotation.support - | is non-zero. The reason for these changes was a report from - | Doug du Boulay (on the docbook-apps list) that processing of - | the apply-annotations template was consuming 75% of the - | total processing time for a 2.5Mb file. Anatoly Techtonik - | followed with a comment that with 1.69.0, "Compiling took - | about full working day on 12Mb file while earlier it was - | about 2-4 hours". - | - | 2005-08-06 - | - | * pages.template.xml: New file. - | - | 2005-08-05 Michael Smith - | - | * man.string.subst.map.xml: Kruft removal. - | - | * man.string.subst.map.xml: Fixed bug that caused literal .sp - | to show up in output. (Thanks to Costin Stroie for - | reporting). WARNING: One of the consequences of this change - | is that the stylesheet no longer generates spaces at the end - | of certain lines. I had it doing that as a sort of hack to - | prevent certain kinds of problems in output. It seems like - | the hack my no longer be necessary. But if I am wrong, this - | change may cause spaces to show up at the beginning of some - | lines in "mixed content". If you see those, then this change - | has introduced a regression, and I will need to go back and - | figure out the right way to fix it (instead of the kludgy - | way I was doing it before. Also, instances like the - | following were showing up in some cases. .PP .sp That is, a - | .PP macro immediately followed by a .sp macro. I can think - | of no good read to ever generate that, and I am not sure why - | it is getting generated. So I have taked the lazy way out - | and caused the stylesheet to now strip out the .sp from all - | such instances, leaving just the .PP - | - | 2005-07-28 Robert Stayton - | - | * part.autolabel.xml: Changed default part numbering format - | back to 'I'. - | - | 2005-07-24 Michael Smith - | - | * man.string.subst.map.xml: New file. - | - | * man.string.subst.map.xml: Fixed handling of lists with - | titles. Also reworked handling of space around lists. - | (Closes #1243003 and 1241371). Among other things, this - | change "normalizes" line space before and after verbatims. - | For most cases, the stylesheet now attempts to ensure each - | verbatim is preceded and followed by exactly one line of - | space. - | - | 2005-07-20 Michael Smith - | - | * appendix.autolabel.xml: New file. - | - | 2005-07-20 Norman Walsh - | - | * appendix.autolabel.xml: Make appendixes use upperalpha - | numeration - | - -Changes to xsl/wordml/* - - | 2005-08-06 - | - | * docbook-pages.xsl, pages-normalise.xsl, param.ent, - | param.xweb, template-pages.xml: Added support for Apple - | Pages application - | - -Changes since version 1.68.1 (2005-02-14) - -Changes to xsl/* - - | 2005-07-18 Michael Smith - | - | * RELEASE-NOTES.xml: Final changes for 1.69.0 release. - | - | * VERSION: Version 1.69.0 released. - | - | 2005-07-14 Michael Smith - | - | * RELEASE-NOTES.xml: Checkpointing. Still need to add FO - | section. - | - | 2005-06-30 Michael Smith - | - | * RELEASE-NOTES.xml: Added "General" stuff. - | - | * RELEASE-NOTES.xml: First updates for 1.69.0 release. So far, - | only includes descriptions of the manpages changes. Sorry, - | that is all I could managed to get done so far. If anybody - | else has time to add descriptions for the HTML and FO - | stylesheets, please do. Otherwise, I will get back to work - | on them later tonight my time. - | - | 2005-06-28 Michael Smith - | - | * .cvsignore: ignore RELEASE-NOTES.pdf and RELEASE-NOTES.fo - | - | * README: Update to include Slides and Website info, and also - | some other clarifications. - | - | 2005-06-27 Michael Smith - | - | * .cvsignore: Ignore slides and website subdirs - | - | * Makefile: Always make NEWS and install.sh - | - | 2005-06-17 Michael Smith - | - | * Makefile: Incorporated slides and website stylesheets into - | the build. Note: This currently only affects the "distrib" - | (doc) build. So if you don't need to build distrib/doc, you - | won't be affected by this change. If you DO need to build - | distrib/doc, it will break unless you use the xsl/Makefile - | from the "build" branch instead of from the head. This build - | alters the distrib build such that: - an xsl/slides - | directory is created by copying over the contents of the - | slides/xsl - an xsl/website directory is created by copying - | over the contents of the website/xsl directory - the - | reference.html part of the doc build now adds the slides and - | website param reference doc This is an experiment. If we - | decide to go ahead with it in the release build, and - | everything is found to be OK when it gets out to users and - | they test it, then the next step would be to ask SF admin to - | move the website/xsl and slides/xsl CVS directory into xsl/ - | to create xsl/slides and xsl/website, and they would be - | maintained in the xsl/ CVS going forward. - | - | 2005-05-28 Jirka Kosek - | - | * Makefile: Added lib directory to the list of directories for - | which separate Makefile is called - | - | 2005-05-26 Michael Smith - | - | * INSTALL: Replaced leftover instances of "Website" - | - | * README: minor formatting change - | - | 2005-05-13 Michael Smith - | - | * MANIFEST.build: no longer needed - | - | * Makefile: Minor changes to packaging/release-related stuff - | - | 2005-05-12 Michael Smith - | - | * MANIFEST.build: removed common/Makefile - | - | * Makefile: fixed realclean target (build branch) - | - | 2005-05-09 Michael Smith - | - | * Makefile: changed to match latest releasetools/Targets.mk - | updates - | - | 2005-04-22 Michael Smith - | - | * .cvsignore, .urilist, Makefile: .urilist is made by "make - | install.sh" (duh) - | - | * Makefile: remove leading tab from pathname in URILIST value - | - | 2005-04-21 Michael Smith - | - | * .cvsignore: don't ignore catalog.xml (now under version - | control) - | - | * .urilist: corrected path - | - | * catalog.xml: New file. - | - | 2005-04-20 Michael Smith - | - | * .cvsignore, AUTHORS, COPYING, INSTALL, LICENSE, README: - | normalize release meta-info/readme files - | - | * .urilist: New file. - | - | 2005-04-15 Michael Smith - | - | * Makefile: added EXECUTABLES variable, and added scripts to - | its value - | - | 2005-04-11 Michael Smith - | - | * Makefile: revert change; put MANIFEST.build exclude in - | global excludes - | - | * Makefile: don't package - | - | 2005-04-06 Michael Smith - | - | * Makefile: (build branch): updated to rely on new modular - | makefile structure - | - | 2005-03-31 Michael Smith - | - | * Makefile: zip target, don't write dummy stamp - | - | 2005-03-28 Michael Smith - | - | * Makefile: debian package build tweaks - | - | 2005-03-27 Michael Smith - | - | * LICENSE: branches: 1.1.2; file LICENSE was initially added - | on branch build. - | - | * LICENSE: New file. - | - | 2005-03-25 Michael Smith - | - | * Makefile: .deb build and upload automation added - | - | 2005-03-19 Michael Smith - | - | * INSTALL: typo fixed. (Thanks for Mike Castle) - | - | 2005-02-24 Michael Smith - | - | * Makefile: changes needed for generating manpages ref doc, - | ported from build branch - | - | * Makefile: Added litprog reference documentation - | infrastructure for manpages. Note that changes to the - | existing Makefile doc/Makefile docsrc/Makefile files are on - | the build branch only, so will need to be back-ported to - | head in order for head builds of the docs to include doc for - | manpage params - | - | 2005-02-21 Michael Smith - | - | * RELEASE-NOTES.xml: dbtimestamp PI, use instead of RCS Date - | keyword - | - | * RELEASE-NOTES.xml: RCS Date keyword, use instead of - | hard-coded date - | - -Changes to xsl/common/* - - | 2005-07-10 Robert Stayton - | - | * gentext.xsl: Added template to process part element in mode - | object.title.template so it can properly choose gentext - | template for numbered or unnumbered parts. - | - | * gentext.xsl, labels.xsl: Added support for specifying number - | format for auto labels for chapter, appendix, part, preface - | from patch #1234737 to satsify feature request #1178038. - | - | 2005-07-08 Michael Smith - | - | * refentry.xsl: Add "date" namespace. - | - | 2005-07-05 Michael Smith - | - | * common.xsl: Added evaluate.info.profile template. - | - | * refentry.xsl: Update header comment. - | - | 2005-07-04 Michael Smith - | - | * refentry.xsl: New file. - | - | * refentry.xsl: Changed title. - | - | 2005-06-30 Robert Stayton - | - | * labels.xsl: Gave procedure its own label.markup template - | because it should not count procedures without title. - | - | 2005-06-28 Michael Smith - | - | * Makefile: "clean" target now deletes $(SOURCES) xml files - | instead of doing a blanket "rm -f *.xml", which was causing - | hte l10n.xml file to be deleted. That file is under version - | control, so deleting it was forcing you to do a "cvs update" - | after you run "make clean". if you forget, it screws up the - | build. - | - | 2005-06-28 Robert Stayton - | - | * olink.xsl: Don't add docname to olink when pointing to root - | element. - | - | 2005-06-06 Michael Smith - | - | * .cvsignore, Makefile, l10n.xml: Added Amharic locale file - | contributed by the The Ge'ez Frontier Foundation. - | - | * l10n.xml: Added tl.xml - | - | 2005-05-28 Jirka Kosek - | - | * pi.xsl: Context node must be stored/restored in order to get - | correct language code. (Note that for-each changes current - | node.) - | - | 2005-05-26 Michael Smith - | - | * l10n.xsl: Make language codes RFC compliant (closes - | #1208931; thanks to Bernd Groh for reporting). ::PROBLEM: - | Stylesheets output two-part language codes in the form - | "zh_CN". But underscores in language codes are actually - | neither RFC compliant nor compliant with the HTML 4.0 rec. - | The separator should be a hyphen. To quote the specs: - | Section 8.1.1, "Language Codes"[1], in the HTML 4.0 Rec. - | states that: [RFC1766] defines and explains the language - | codes that MUST be used in HTML documents. Briefly, language - | codes consist of a primary code and a possibly empty series - | of subcodes: language-code = primary-code ( "-" subcode )* - | And in RFC 1766, "Tags for the Identification of - | Languages"[2], the EBNF for "language tag" is given as: - | Language-Tag = Primary-tag *( "-" Subtag ) Primary-tag = - | 1*8ALPHA Subtag = 1*8ALPHA [1] - | http://www.w3.org/TR/REC-html40/struct/dirlang.html#h-8.1.1 - | [2] http://www.ietf.org/rfc/rfc1766.txt ::CAUSE: Stylesheets - | simply pass through language codes unaltered. So if users - | put "zh_CN" in their source, they will get "zh_CN" in their - | HTML output. ::FIX: Added a new boolean config parameter, - | "l10n.lang.value.rfc.compliant", set to 1 by default. If it - | is non-zero, any underscore in a language code will be - | converted to a hyphen in HTML output. If it is zero, the - | language code will be left as-is. ::AFFECTS: This change - | affects any HTML output that contains two-part language - | codes. - | - | 2005-05-24 Michael Smith - | - | * common.xsl: Support generation of choice separator in inline - | simplelist (closes #1207532) This ehancement enables - | auto-generation of an appropriate localized "choice - | separator" (for example, "and" or "or") before the final - | item in an inline simplelist. To indicate that you want a - | choice separator generated for a particular list, you need - | to put a processing instruction (PI) of the form as a child a of the list. For example: - | This release adds localiation support for the - | following Indic languages: - | Hindi - | Punjabi Tamil - | Oriya Gujarati - | . Output (for English): This release - | adds localiation support for the following Indic languages: - | Hindi, Punjabi, Tamil, Oriya, and Gujarati. Or if the - | logical relationship between the items in the list is an - | "or" relationship, then use choice="or": Choose from - | ONE and ONLY ONE of the following: A - | B C. - | Output (for English): Choose from ONE and only ONE of the - | following choices: A, B, or C. As a temporary workaround for - | the fact that most of the DocBook non-English locale files - | don't have a localization for the word "or", you can put in - | a literal string to be used; example for French: - | Choose from ONE and ONLY ONE of the following: - | - | A B C. - | That is, use "ou" instead of "or". - | - | 2005-05-23 Michael Smith - | - | * pi.xsl: Minor update to date/time handling. - | - | * pi.xsl: Make handling of date format strings more robust - | (closes #1206837). ::Problem: If the "dbtimestamp" PI has - | words in it that contain any of the single-letter characters - | used as date/time formatting instructions, the output is not - | what would be expected. For example, Spanish "long" dates - | look like this: 23 de mayo de 2005 So you would expect that - | you could generate a date of that form using the dbtimestamp - | PI with a format string like the following: But if you try that, you get the - | following output: 23 23e mayo 23e 2005 That is, the "d" in - | "de" is replaced with the day of the month. ::Cause:: The - | format-string parsing logic works by walking through the - | format string character-by-character. So when it gets to the - | "d" in "de", it has no way of discerning that it is not the - | "d" formatting instruction but is instead part of a word - | intended to be included in the output as a literal string. - | ::Fix:: The format-string parsing logic now splits format - | strings into tokens and delimiters and evaluates them - | token-by-token instead of character-by-character. For - | example, it splits the Spanish "long" date format like this: - | d de B ... - | Thus, in looking for the "d" formatting instruction, the "d" - | token matches but the "de" token does not. As delimiters, it - | recognizes the following characters: - | , . / - ( ) [ ] ::Affects: This change affects output of the - | "dbtimestamp" PI as well as output from any customization - | layers that call the "datetime.format" template. It affect - | all formats (HTML, FO, etc.). - | - | 2005-05-21 Michael Smith - | - | * .cvsignore, Makefile, l10n.xml: Added Kannada localization - | (from Siddharudh P T) - | - | * l10n.xml: Fixed typo. - | - | 2005-05-16 Michael Smith - | - | * .cvsignore, Makefile: Added Welsh localization (from Kevin - | Donnelly) - | - | * .cvsignore, Makefile, l10n.xml: Added Mongolian localization - | from Sanlig Badral. - | - | * l10n.xml: Added missing entity ref for hi.xml - | - | * l10n.xml: Added all recently added locales. - | - | 2005-05-14 Michael Smith - | - | * .cvsignore, Makefile: Added Azerbaijani translation (from - | Metin Amiroff) - | - | * .cvsignore, Makefile: Added Irish (Gaelic) localization - | (from Kevin Patrick Scannell) - | - | * .cvsignore, Makefile: Added Oriya localization (from Gora - | Mohanty) - | - | 2005-05-13 Michael Smith - | - | * .cvsignore, Makefile: Incorporated Albanian locale file - | contributed by Laurent Dhima. - | - | * .cvsignore, Makefile: Added hi.xml file contributed by Bernd - | Groh. Removed "letters" element from locale files that don't - | need it. - | - | 2005-05-12 Michael Smith - | - | * .cvsignore, Makefile: Added Tamil, Punjabi, and Gujarati - | locale files contributed by Bernd Groh - | - | * Makefile: removed build-branch version of Makefile - | - | * Makefile: Added support for Punjabi, Gujarati, and Tamil - | (via locale files contributed by Bernd Groh) (ported from - | build branch) - | - | 2005-05-11 Michael Smith - | - | * common.xsl: Code -> Literal (because jrefentry DTD imports - | on DocBook 4.1.2, which lacks Code) - | - | * common.xsl: Fixed typo. - | - | 2005-05-10 Michael Smith - | - | * common.xsl: Strip whitespace in Manvolnum; closes bug - | #959805 (thanks to Jens Elkner for reporting the problem) - | ::PROBLEM: Whitespace is preserved in output for Manvolnum. - | Among other things, this results in garbled filenames for - | man pages generated from the manpages stylesheets. ::CAUSE - | Manvolnum was not included in the master list of "strip - | space" elements. ::FIX Added Manvolnum to master list of - | "strip space" elements. ::AFFECTS This change affects all - | output formats. - | - | * common.xsl: Strip whitespace in Refsection; closes bug - | #1198766 and #1170315 (thanks to Denis Bradford for - | reporting the problem) ::PROBLEM: Whitespace is preserved in - | output for Refsection. Among other things, this results in - | malformed groff output from the manpages stylesheets. - | ::CAUSE Refsection was not included in the master list of - | "strip space" elements. ::FIX Added Refsection to master - | list of "strip space" elements. ::AFFECTS This change - | affects all output formats. - | - | * common.xsl: Added template to uppercase strings (closes - | #1199123) Given a string, this template does a - | language-aware conversion of that string to all uppercase - | letters, based on the values of the lowercase.alpha and - | uppercase.alpha gentext keys for the current locale. It - | affects only those characters found in the values of - | lowercase.alpha and uppercase.alpha. All other characters - | are left unchanged. - | - | 2005-05-06 Robert Stayton - | - | * olink.xsl: Fix bug in use.local.olink.style. - | - | 2005-04-08 Robert Stayton - | - | * table.xsl: Applied patches submitted for bug # 1175423. - | - | 2005-04-04 Norman Walsh - | - | * common.xsl: Support xml:id in object.id - | - | 2005-03-29 Robert Stayton - | - | * targetdatabase.dtd: Added @dir to document, to support - | Website. - | - | 2005-02-21 Jirka Kosek - | - | * l10n.xsl: Quick hack improving support for dir attribute. - | However problem is much more complex, support must be added - | into indexes and headers/footers also. - | - -Changes to xsl/website/* - - | 2005-06-20 Michael Smith - | - | * .cvsignore: New file. - | - | 2005-06-17 Michael Smith - | - | * Makefile, param.xsl, param.xweb: Switch to "real" params - | build (i.e., same as docbook-xsl params). - | - | * param.xweb: New file. - | - | 2005-04-15 Norman Walsh - | - | * website-common.xsl: Explicitly cast summary to a string - | - | * website-common.xsl: Support @href on tocentry - | - | 2005-04-08 Michael Smith - | - | * makefile-dep.xsl: added depends-file param, to help make - | distclean behave as expected when building non-tabular - | version of website - | - | 2005-04-06 Michael Smith - | - | * VERSION, website-common.xsl: VERSION scheme switched to same - | as that used by "xsl" module; this enables auto-submitting - | info to Freshmeat as part of the build - | - | * makefile-dep.xsl: clean also now removes depends.nontabular - | & website.database.xml - | - | 2005-03-30 Robert Stayton - | - | * toc-tabular.xsl: Fixed logic for @tocskip attribute. - | - | 2005-03-29 Robert Stayton - | - | * autolayout.xsl: Updated public and system identifiers in - | xsl:output element. - | - | * toc-tabular.xsl: Fixed bug 1163939: toc-tabular depends on - | DTD validation. - | - | * website-common.xsl: Added sample gentext strings for de and - | fr. - | - | * website.xsl: Fixed bug 1019573 body tag, accessibility - | issue. - | - | 2005-03-28 Robert Stayton - | - | * olink.xsl: Fixed olink-entity to work with new olink setup. - | - | * olink.xsl: Updated to work with revisions to olink in main - | DocBook stylesheet starting with version 1.66. - | - | * website-common.xsl: Fixed bug 1120883 Irrelevant mode - | attribute. - | - | * website-common.xsl: Fixed bug 1120877 regarding duplicate - | match on website in title.markup mode. - | - -Changes to xsl/slides/* - - | 2005-04-27 Michael Smith - | - | * .cvsignore: ignore ChangeLog so that I can do "cvstrim" - | without it getting deleted - | - | 2005-04-26 Michael Smith - | - | * Makefile: switch to DIRS var / base target setup - | - -Changes to xsl/doc/* - - | 2005-07-05 Michael Smith - | - | * Makefile: Added refentry metadata-gathering documentation. - | - | 2005-06-17 Michael Smith - | - | * Makefile: Refined doc build. - Changed makefiles in - | docsrc/fo, docsrc/html, and docsrc/manpages dirs to depend - | on corresponding params.xsl instead of on param.xweb. - | Rationale is that param.xsl gets rebuilt any time param.xweb - | changes. In addition, param.xsl gets rebuild any time any - | included params/*.xml file is changed. So making docsrc/* - | builds depend on param.xsl effectively makes them depend on - | both the param.xweb changes on on the actual param changes. - | - Changed doc/Makefile so that reference.html is rebuilt - | only when docsrc/reference.xml changes, not when any of its - | included files change. Rationale is that, because we chunk - | output for the doc build, reference.html is simply a sort of - | TOC page that doesn't need to get remade if the included - | files change. Because output of those included files goes to - | separate fo, html, and manpages subdirs, and that output - | gets generated by seperate make targets. - | - | * Makefile: Incorporated slides and website stylesheets into - | the build. Note: This currently only affects the "distrib" - | (doc) build. So if you don't need to build distrib/doc, you - | won't be affected by this change. If you DO need to build - | distrib/doc, it will break unless you use the xsl/Makefile - | from the "build" branch instead of from the head. This build - | alters the distrib build such that: - an xsl/slides - | directory is created by copying over the contents of the - | slides/xsl - an xsl/website directory is created by copying - | over the contents of the website/xsl directory - the - | reference.html part of the doc build now adds the slides and - | website param reference doc This is an experiment. If we - | decide to go ahead with it in the release build, and - | everything is found to be OK when it gets out to users and - | they test it, then the next step would be to ask SF admin to - | move the website/xsl and slides/xsl CVS directory into xsl/ - | to create xsl/slides and xsl/website, and they would be - | maintained in the xsl/ CVS going forward. - | - | 2005-05-13 Michael Smith - | - | * Makefile: Revert to Makefile from MAIN - | - | 2005-02-24 Michael Smith - | - | * Makefile: changes needed for generating manpages ref doc, - | ported from build branch - | - | * Makefile: Added litprog reference documentation - | infrastructure for manpages. Note that changes to the - | existing Makefile doc/Makefile docsrc/Makefile files are on - | the build branch only, so will need to be back-ported to - | head in order for head builds of the docs to include doc for - | manpage params - | - -Changes to xsl/docsrc/* - - | 2005-07-06 Michael Smith - | - | * clrefentry.xsl, tdg-link.xsl: (internal) Added support for - | TDG hyperlinking with (instead of just . Also - | added support for ignoring s and s that have a - | "namespace" attribute whose value contains - | "http://docbook.sf.net/" or - | "http://docbook.sourceforge.net/" (that is, those don't get - | turned into TDG hyperlinks). (Note: This change has no - | effect on the behavior of the DocBook XSL stylesheets; it - | only affects the build used to create the actual) DocBook - | XSL releases.) - | - | 2005-07-05 Michael Smith - | - | * Makefile, reference.xml: Added refentry metadata-gathering - | documentation. - | - | 2005-06-27 Michael Smith - | - | * reference.xml: Made doc source compliant with expectations - | of doc build. - | - | 2005-06-17 Michael Smith - | - | * Makefile: Refined doc build. - Changed makefiles in - | docsrc/fo, docsrc/html, and docsrc/manpages dirs to depend - | on corresponding params.xsl instead of on param.xweb. - | Rationale is that param.xsl gets rebuilt any time param.xweb - | changes. In addition, param.xsl gets rebuild any time any - | included params/*.xml file is changed. So making docsrc/* - | builds depend on param.xsl effectively makes them depend on - | both the param.xweb changes on on the actual param changes. - | - Changed doc/Makefile so that reference.html is rebuilt - | only when docsrc/reference.xml changes, not when any of its - | included files change. Rationale is that, because we chunk - | output for the doc build, reference.html is simply a sort of - | TOC page that doesn't need to get remade if the included - | files change. Because output of those included files goes to - | separate fo, html, and manpages subdirs, and that output - | gets generated by seperate make targets. - | - | * Makefile, documentation.xml, reference.xml: Incorporated - | slides and website stylesheets into the build. Note: This - | currently only affects the "distrib" (doc) build. So if you - | don't need to build distrib/doc, you won't be affected by - | this change. If you DO need to build distrib/doc, it will - | break unless you use the xsl/Makefile from the "build" - | branch instead of from the head. This build alters the - | distrib build such that: - an xsl/slides directory is - | created by copying over the contents of the slides/xsl - an - | xsl/website directory is created by copying over the - | contents of the website/xsl directory - the reference.html - | part of the doc build now adds the slides and website param - | reference doc This is an experiment. If we decide to go - | ahead with it in the release build, and everything is found - | to be OK when it gets out to users and they test it, then - | the next step would be to ask SF admin to move the - | website/xsl and slides/xsl CVS directory into xsl/ to create - | xsl/slides and xsl/website, and they would be maintained in - | the xsl/ CVS going forward. - | - | 2005-05-09 Michael Smith - | - | * Makefile: make docsrc build depend on params/*.xml files - | - | 2005-04-22 Michael Smith - | - | * Makefile: re-make docsrc if any params files change - | - | 2005-03-24 Michael Smith - | - | * make-xsl-params.pl: xsl-manages-param name corrected - | - | 2005-03-07 Robert Stayton - | - | * templates.xml: Removed the xsl:import from the example since - | it doesn't work that way. - | - | 2005-02-24 Michael Smith - | - | * Makefile: changes needed for generating manpages ref doc, - | ported from build branch - | - | * Makefile, make-xsl-params.pl, reference.xml, - | xsl-param-link.xsl: Added litprog reference documentation - | infrastructure for manpages. Note that changes to the - | existing Makefile doc/Makefile docsrc/Makefile files are on - | the build branch only, so will need to be back-ported to - | head in order for head builds of the docs to include doc for - | manpage params - | - -Changes to xsl/eclipse/* - - | 2005-04-10 Robert Stayton - | - | * eclipse.xsl: Added support for generating olink database. - | - -Changes to xsl/extensions/* - - | 2005-05-13 Michael Smith - | - | * .cvsignore: ignore build dir - | - | * Makefile: switched to ant-based build - | - | * Makefile: revert to MAIN - | - -Changes to xsl/fo/* - - | 2005-07-09 Robert Stayton - | - | * graphics.xsl: Applied patch #850001 to add content-type - | property to external-graphic element based on imagedata - | format attribute. - | - | 2005-06-28 Michael Smith - | - | * xep.xsl: Added support for generating field for XEP. Also, added support for - | picking up and using contents of for XEP - | field. - | - | 2005-06-28 Robert Stayton - | - | * xref.xsl: Moved the fo:basic-link for page refs to the - | page.citation template so it can be more easily customized. - | Fixed bug in using page keyword in role used as xrefstyle. - | - | 2005-06-27 Michael Smith - | - | * param.xweb: Doc tweak to match user/developer distinction. - | - | 2005-06-27 Robert Stayton - | - | * qandaset.xsl: Removed the start-indent on qandadiv because - | it conflicts with other indents, and that style should be - | implemented with a property set. - | - | 2005-06-13 Michael Smith - | - | * inline.xsl: Trademark symbol handling made consistent with - | handling of same in HTML stylesheets. (closes #1218286; - | thanks to Mauritz Jeanson for reporting the problem) Prior - | to this change, if you processed a doc that contained no - | value for the Class attribute on the Trademark element, the - | HTML stylesheets would default to rendering a superscript TM - | symbol after the Trademark contents, but the FO stylesheets - | would render nothing. This change alters the FO handing of - | Trademark such that it is now identical to the HTML - | handling. - | - | 2005-06-01 Michael Smith - | - | * refentry.xsl, titlepage.xsl: Corrected formatting of - | generated "Name" title in refentry output (closes #1212396; - | thanks to Andreas Lalloo for reporting the problem). - | :Problem:: The "Name" title generated for FO output of - | Refnamediv in Refentry is not aligned flush left, as all the - | other subheadings of Refentry are, and as the generated Name - | subheading for Refentry is in HTML output. Also, the Name - | title is in a larger font size than the titles of the other - | first-level children of Refentry. :Fix:: The "Name" title - | generated for FO output of Refnamediv in Refentry is now - | handled using the same formatting as that used for all other - | first-level children of Refentry. ::Affects: Along with - | affecting processing for generated titles for Refnamediv in - | FO output, it is possible that this change may have - | unanticipated side effects on processing of titles for - | Refsynopsisdiv, Refsection, and Refsect1 to Refsect3. The - | reason is that part of this change takes the template - | contents formerly used only for processing Refsynopsisdiv, - | Refsection, and Refsect1 to Refsect3, and "repurposes" those - | template contents for use in processing the generated title - | for Refnamediv. - | - | * xep.xsl: Generate XEP bookmarks for Refentry children. - | (closes #1212491) Titled child sections of Refentry - | (Refsynosisdiv, Refsection, and Refsect1 to Refsect3) were - | not included in the match statement used for generating XEP - | bookmarks. Don't know whether that was intentional for some - | reason or whether it was just an oversight. But given that - | both AXF and Passivetex bookmarks are generated for those - | same Refentry children, it seems like XEP ones ought to also - | be generated, for the sake of consistency if for no other - | reason. - | - | 2005-05-31 Robert Stayton - | - | * table.xsl: Add support for HTML markup table border - | attribute, applied to each table cell. - | - | * table.xsl: The table.width template can now sum column specs - | if none use % or *. - | - | 2005-05-27 Jirka Kosek - | - | * param.ent, param.xweb: Added references to newly added - | parameter l10n.gentext.use.xref.language - | - | 2005-05-25 Robert Stayton - | - | * lists.xsl: Set start-indent and end-indent for fo:table-body - | used to format lists to zero so that they do not inherit any - | start-indent from their container, which would indent - | relative to the cell boundary. - | - | 2005-05-24 Michael Smith - | - | * lists.xsl: Support generation of choice separator in inline - | simplelist (closes #1207532) This ehancement enables - | auto-generation of an appropriate localized "choice - | separator" (for example, "and" or "or") before the final - | item in an inline simplelist. To indicate that you want a - | choice separator generated for a particular list, you need - | to put a processing instruction (PI) of the form as a child a of the list. For example: - | This release adds localiation support for the - | following Indic languages: - | Hindi - | Punjabi Tamil - | Oriya Gujarati - | . Output (for English): This release - | adds localiation support for the following Indic languages: - | Hindi, Punjabi, Tamil, Oriya, and Gujarati. Or if the - | logical relationship between the items in the list is an - | "or" relationship, then use choice="or": Choose from - | ONE and ONLY ONE of the following: A - | B C. - | Output (for English): Choose from ONE and only ONE of the - | following choices: A, B, or C. As a temporary workaround for - | the fact that most of the DocBook non-English locale files - | don't have a localization for the word "or", you can put in - | a literal string to be used; example for French: - | Choose from ONE and ONLY ONE of the following: - | - | A B C. - | That is, use "ou" instead of "or". - | - | 2005-05-16 Robert Stayton - | - | * formal.xsl, graphics.xsl, lists.xsl: fixed bug 1201333 - | mediaobjectco images not aligned. - | - | 2005-05-13 Michael Smith - | - | * Makefile: revert to MAIN - | - | 2005-05-13 Robert Stayton - | - | * glossary.xsl: Make glosssee and glossseealso into full - | gentext templates with substitution. - | - | * lists.xsl: Changed longest.term template to measure width - | after apply-templates to term. - | - | 2005-05-07 Robert Stayton - | - | * xref.xsl: Add basic support for biblioref cross referencing - | element. - | - | 2005-05-06 Robert Stayton - | - | * graphics.xsl: Added support for @align on caption in - | mediaobject. - | - | 2005-05-05 Robert Stayton - | - | * graphics.xsl: Fixed scalefit to work when - | contentdepth="100%". - | - | 2005-04-29 Norman Walsh - | - | * docbook.xsl: 'Support' DocBook V5 namespace - | - | 2005-04-24 Jirka Kosek - | - | * autoidx.xsl: Partial fix for bug #1180510 - | - | 2005-04-22 Robert Stayton - | - | * inline.xsl: Fix menuchoice.menu.separator for FOP. - | - | 2005-04-20 Robert Stayton - | - | * fop.xsl: Added fox:destination extension inside fox:outline - | to support linking to internal destinations. - | - | 2005-04-16 Robert Stayton - | - | * inline.xsl: The application of the menuchoice separator - | parameters now uses xsl:copy-of instead of xsl:value-of so - | something more complex than a string can be used. - | - | 2005-04-15 Robert Stayton - | - | * block.xsl, param.ent, param.xweb: Add support for - | customizing abstract with property sets. - | - | * titlepage.templates.xml: Set start indent for article title - | page to zero. - | - | 2005-04-12 Robert Stayton - | - | * division.xsl: Don't start a part toc page sequence unless it - | has entries. - | - | 2005-04-10 Robert Stayton - | - | * refentry.xsl: Fixed bug 1180078 where $refentry.pagebreak - | did not work when refentries were in a reference. - | - | 2005-04-08 Robert Stayton - | - | * component.xsl, division.xsl, refentry.xsl, sections.xsl: - | Fixed bug in PDF bookmarks for axf output by adding - | normalize-space. - | - | * index.xsl: Fixed indexterm id target for axf.extensions to - | use fo:block or fo:inline. Remove it if AH decides to - | support fo:wrapper as the link target. - | - | 2005-04-07 Robert Stayton - | - | * admon.xsl, formal.xsl, htmltbl.xsl, titlepage.templates.xml, - | titlepage.xsl: Make sure all keep-together and keep-with-* - | have either .within-column or .within-line so no - | unintentional keeps. - | - | 2005-04-04 Norman Walsh - | - | * footnote.xsl: Fixed typo in XPath expression - | - | * inline.xsl: Support termdef - | - | * math.xsl: Support mathphrase - | - | 2005-04-03 Robert Stayton - | - | * footnote.xsl, formal.xsl, htmltbl.xsl: Add footnotes in - | table title to table footnote set, and add support for table - | footnotes to HTML table markup. - | - | 2005-03-31 Robert Stayton - | - | * refentry.xsl: Fixed bug where id not output if partintro - | present in reference element. - | - | 2005-03-08 Robert Stayton - | - | * autotoc.xsl, pagesetup.xsl, titlepage.templates.xml: Fix - | problems introduced with $body.start.indent. FOP reverts - | back to using $title.margin.left. - | - | * block.xsl, titlepage.xsl: Add support for mulitple - | authorinitial elements in a revhistory/revision. - | - | * pi.xsl: Fix bug in dbfo-need: can't use space-before in - | list. - | - | 2005-03-06 Robert Stayton - | - | * glossary.xsl: Added support for title in glosslist. - | - | 2005-02-28 Robert Stayton - | - | * xref.xsl: Fixed missing xref-to-prefix and xref-to-suffix - | modes that were added to html xref.xsl and used in - | common/titles.xsl. - | - | 2005-02-27 Robert Stayton - | - | * lists.xsl: Added support for itemizedlist symbol 'none'. - | - | 2005-02-23 Robert Stayton - | - | * admon.xsl: Implemented the new - | graphical.admonition.properties and - | nongraphical.admonition.properties attribute sets. - | - | 2005-02-22 - | - | * verbatim.xsl: hyphenate.verbatim code no longer inserts zero - | width space after hyphenate.verbatim.characters if it is the - | last character in the line. This extra zero width space was - | causing problems in an old version of XEP. - | - | 2005-02-21 Robert Stayton - | - | * block.xsl: Added @id to formalpara and some other blocks - | that were missing it. - | - | 2005-02-21 - | - | * verbatim.xsl: Fixed bug in hyphenate.verbatim.characters - | that kept the param from being honored if you specified more - | than one character - | - | 2005-02-16 Jirka Kosek - | - | * formal.xsl: Align attribute from imagedata is not propagated - | to surrounding figure because it wrongly affected title - | alignment. - | - | 2005-02-16 Robert Stayton - | - | * glossary.xsl: Fixed bug where glossary in part not getting a - | page-sequence. - | - | * graphics.xsl: Fixed bug where depth now gets scale-to-fit - | when scalefit used. - | - | 2005-02-15 Jirka Kosek - | - | * graphics.xsl, param.ent, param.xweb: Added support for - | img.src.path parameter into FO stylesheet. - | - | 2005-02-15 Robert Stayton - | - | * xref.xsl: Change the anchor template to output fo:inline - | instead of fo:wrapper. - | - -Changes to xsl/html/* - - | 2005-07-14 Norman Walsh - | - | * annotations.xsl, chunk-code.xsl, docbook.xsl, footnote.xsl, - | inline.xsl, param.ent, param.xweb: Added a first cut at - | support for DocBook 5 style annotations - | - | * docbook.xsl, param.ent, param.xweb: Added parameter for the - | annotation CSS - | - | 2005-07-11 Robert Stayton - | - | * component.xsl: Removed obsolete templates using - | mode="component.number". - | - | 2005-07-10 Robert Stayton - | - | * division.xsl, titlepage.templates.xml: Fixed missing "Part - | n." label for part titles. - | - | 2005-06-28 Michael Smith - | - | * Makefile: "clean" target no longer deletes - | html/profile-chunk.xsl or html/profile-onechunk.xsl Those - | files are under version control, not made. So they should - | not be deleted by the build. - | - | 2005-06-24 Michael Smith - | - | * html.xsl, inline.xsl: Added initial, EXPERIMENTAL support - | for generating content for HTML "title" attributes from - | content of the Alt element. This change adds support for - | generating HTML "title" attributes for the following inline - | elements only (all inlines -- support for block elements - | will need to wait for later). abbrev accel acronym action - | application authorinitials beginpage citation citerefentry - | citetitle city classname code command comment computeroutput - | constant country database email envar errorcode errorname - | errortext errortype exceptionname fax filename firstname - | firstterm foreignphrase function glossterm guibutton guiicon - | guilabel guimenu guimenuitem guisubmenu hardware honorific - | interface interfacedefinition interfacename keycap keycode - | keysym lineage lineannotation literal markup medialabel - | methodname mousebutton option optional otheraddr othername - | package parameter personname phone pob postcode productname - | productnumber prompt property quote refentrytitle remark - | replaceable returnvalue sgmltag shortcut state street - | structfield structname subscript superscript surname symbol - | systemitem tag termdef token trademark type uri userinput - | varname wordasword Implemented by creating a new named - | template, generate.html.title. That is is currently called - | in eleven places only, in the inline.xsl file. But it's - | called by all the inline.* templates (e.g., inline.boldseq), - | which in turn are called by other (element) templates, so it - | results, currently, in supporting generation of the HTML - | "title" attribute for a total of about 93 elements (the list - | above). - | - | * param.ent, param.xweb, titlepage.xsl: Added support for - | chunking revhistory into separate file (similar to the - | support for doing same with legalnotice). Patch from Thomas - | Schraitle (closes #1096574). Controlled through new - | generate.revhistory.link parameter. - | - | * refentry.xsl: Applied patch from Anatoly Techtonik to - | correct problem of multiple name attributes generated for - | output of Reference element (closes #1226390) - | - | 2005-06-03 Robert Stayton - | - | * chunk-code.xsl, chunkfast.xsl: Fixed bug [ 1212159 ] Missing - | navigational links with XHTML chunking which was caused by - | the following: 1. When chunk.hierarchy is created, it is a - | collection of div elements in a variable, and then that is - | converted to a node-set by exlt. 2. In HTML, there is no - | namespace, so the div elements are in no namespace and they - | work. 3. In XHTML, the div elements are in the xhtml - | namespace because it is the default namespace. So they - | cannot be addressed as just "div", they must have a - | namespace prefix. 4. I added an explicit chunkfast namespace - | to avoid conflict with the default namespace. - | - | 2005-06-02 Michael Smith - | - | * table.xsl: Backed out patch for #1211477 because it breaks - | table processing in Saxon. - | - | 2005-06-01 Michael Smith - | - | * table.xsl: Applied patch from David Green for #1211477, to - | prevent StackOverflowError encountered when processing - | tables with ~700 rows with Xalan. Smoke-tested and didn't - | see any obvious problems with the fix, so going ahead and - | committing it so others can test with snapshot. - | - | 2005-05-31 Robert Stayton - | - | * chunktoc.xsl: Fixed bug #1202971, chunktoc doesn't handle - | the chunk.tocs.and.lots=1 parameter. - | - | 2005-05-26 Robert Stayton - | - | * chunk-common.xsl, manifest.xsl: Fixed bug #851598 links to - | legalnotice in html are broken. - | - | 2005-05-26 Michael Smith - | - | * param.ent, param.xweb: Make language codes RFC compliant - | (closes #1208931; thanks to Bernd Groh for reporting). - | ::PROBLEM: Stylesheets output two-part language codes in the - | form "zh_CN". But underscores in language codes are actually - | neither RFC compliant nor compliant with the HTML 4.0 rec. - | The separator should be a hyphen. To quote the specs: - | Section 8.1.1, "Language Codes"[1], in the HTML 4.0 Rec. - | states that: [RFC1766] defines and explains the language - | codes that MUST be used in HTML documents. Briefly, language - | codes consist of a primary code and a possibly empty series - | of subcodes: language-code = primary-code ( "-" subcode )* - | And in RFC 1766, "Tags for the Identification of - | Languages"[2], the EBNF for "language tag" is given as: - | Language-Tag = Primary-tag *( "-" Subtag ) Primary-tag = - | 1*8ALPHA Subtag = 1*8ALPHA [1] - | http://www.w3.org/TR/REC-html40/struct/dirlang.html#h-8.1.1 - | [2] http://www.ietf.org/rfc/rfc1766.txt ::CAUSE: Stylesheets - | simply pass through language codes unaltered. So if users - | put "zh_CN" in their source, they will get "zh_CN" in their - | HTML output. ::FIX: Added a new boolean config parameter, - | "l10n.lang.value.rfc.compliant", set to 1 by default. If it - | is non-zero, any underscore in a language code will be - | converted to a hyphen in HTML output. If it is zero, the - | language code will be left as-is. ::AFFECTS: This change - | affects any HTML output that contains two-part language - | codes. - | - | 2005-05-26 Robert Stayton - | - | * titlepage.xsl: Fixed bug #851598 links to legalnotice in - | html are broken. - | - | 2005-05-24 Michael Smith - | - | * lists.xsl: Support generation of choice separator in inline - | simplelist (closes #1207532) This ehancement enables - | auto-generation of an appropriate localized "choice - | separator" (for example, "and" or "or") before the final - | item in an inline simplelist. To indicate that you want a - | choice separator generated for a particular list, you need - | to put a processing instruction (PI) of the form as a child a of the list. For example: - | This release adds localiation support for the - | following Indic languages: - | Hindi - | Punjabi Tamil - | Oriya Gujarati - | . Output (for English): This release - | adds localiation support for the following Indic languages: - | Hindi, Punjabi, Tamil, Oriya, and Gujarati. Or if the - | logical relationship between the items in the list is an - | "or" relationship, then use choice="or": Choose from - | ONE and ONLY ONE of the following: A - | B C. - | Output (for English): Choose from ONE and only ONE of the - | following choices: A, B, or C. As a temporary workaround for - | the fact that most of the DocBook non-English locale files - | don't have a localization for the word "or", you can put in - | a literal string to be used; example for French: - | Choose from ONE and ONLY ONE of the following: - | - | A B C. - | That is, use "ou" instead of "or". - | - | 2005-05-16 Robert Stayton - | - | * graphics.xsl: Fixed bug 1201333 mediaobjectco images not - | aligned. - | - | * table.xsl: Fixed bug [ 1173576 ] rowsep lines after last row - | of a table - | - | 2005-05-13 Robert Stayton - | - | * glossary.xsl: Now glosssee and glossseealso use full gentext - | template with substitution. - | - | 2005-05-10 Michael Smith - | - | * synop.xsl: Partially support having multiple parameters in - | one paramdef. DocBook says it is valid, but it's not clear - | why anybody would ever want to do it. Prior to this fix, - | each parameter would get rendered twice. There is still a - | problem with whitespace between parameters getting dropped, - | but it's not worth fixing unless somebody can actually show - | a use case for having multiple parameters in one paramdef. - | - | * synop.xsl: make funcsynopsis.decoration=1 have effect for - | nontabular K&R output (closes bug # 1198960) ::PROBLEM If - | you set the funcsynopsis.decoration param to 1 and generate - | notablular K&R output for a functionsynopsis, the parameters - | in the function argument synopsis are not styled - | (italicized) as they are for K&R tabular output. ::FIX - | Changed K&R nontabular logic to base styling for function - | argument synopsis on value of funcsynopsis.decoration. - | - | 2005-05-09 Michael Smith - | - | * index.xsl: Problem: Invalid HTML generated for manually - | created Indexes that lack Indexdivs. Cause: The indexentry - | template assumes a dl wrapper has been generated, but the dl - | wrapper gets generated only if an Indexdiv exists. Fix: For - | Indexes that lack Indexdiv, generate a dl wrapper before - | processing Indexentries (closes bug ##1196670; thanks to - | Petr Pajas for reporting the problem). Affects: HTML output - | for manually created Indexes; has no effect on processing of - | automatically generated Indexes. - | - | 2005-05-07 Robert Stayton - | - | * xref.xsl: Added basic support for biblioref cross - | referencing. - | - | 2005-05-06 Robert Stayton - | - | * graphics.xsl: Bug fix if caption align. - | - | * graphics.xsl: Added support for @align on caption in - | mediaobject. - | - | 2005-04-29 Norman Walsh - | - | * docbook.xsl: 'Support' DocBook V5 namespace - | - | 2005-04-28 Norman Walsh - | - | * graphics.xsl: Support img.src.path PI (is this a good - | idea?); support (not currently valid) xlink:href on area and - | (not currently valid) alt in area - | - | 2005-04-21 Norman Walsh - | - | * graphics.xsl: Generate client-side image map for - | imageobjectco with areas using calspair units - | - | 2005-04-10 Robert Stayton - | - | * chunk-common.xsl: Fix link to ToC when chunk.toc.and.lots is - | 1. - | - | 2005-04-04 Norman Walsh - | - | * html.xsl: Support xml:id in anchor - | - | * inline.xsl: Support termdef - | - | * math.xsl: Support mathphrase - | - | 2005-03-09 Robert Stayton - | - | * component.xsl: Fixed colophon/subtitle per bug #1156450 - | - | * footnote.xsl: Fixed bug 1156645: footnote para doesn't - | propagate role. - | - | 2005-03-08 Robert Stayton - | - | * block.xsl, titlepage.xsl: Fixed bug 1123291: more than one - | authorinitials in revhistory. - | - | 2005-03-02 Jirka Kosek - | - | * graphics.xsl: Pass $img.src.path to Java image extensions - | when appropriate - | - | * graphics.xsl, param.ent, param.xweb: Passing of - | $img.src.path to Java image extensions is conditional and it - | is controlled by newly added graphicsize.use.img.src.path - | parameter. - | - | 2005-02-17 Jirka Kosek - | - | * chunk-code.xsl: Parameter is passed explicitly to allow - | auto-generating of profiling stylesheet. - | - | * param.ent, param.xweb, table.xsl: Added new parameter - | default.table.frame that controls table framing if there is - | no frame attribute on the table. - | - | 2005-02-16 Robert Stayton - | - | * param.xweb: Moved use.id.as.filename to chunking section. - | - -Changes to xsl/htmlhelp/* - - | 2005-06-21 Jirka Kosek - | - | * htmlhelp-common.xsl: Fixed bug #1223236. Mode attribute was - | removed from named templates. - | - | 2005-05-24 Jirka Kosek - | - | * htmlhelp-common.xsl: Classical HTML index is suppressed in a - | cleaner way as suggested by David Cramer - | - | 2005-05-13 Michael Smith - | - | * Makefile: clean target added - | - | * Makefile: revert to MAIN - | - -Changes to xsl/javahelp/* - - | 2005-05-13 Michael Smith - | - | * Makefile: clean target added - | - | * Makefile: revert to MAIN - | - -Changes to xsl/lib/* - - | 2005-07-08 Michael Smith - | - | * lib.xweb: Added prepend-pad function for right-padding - | strings to a specific length. - | - | 2005-06-28 Michael Smith - | - | * lib.xweb: Fixed typo. - | - | 2005-06-27 Michael Smith - | - | * lib.xweb: Added an "apply-string-subst-map" function - | (template). Only difference is that in the map that it - | expects, "oldstring" and "newstring" attributes are used - | instead of "character" and "string" attributes. - | - | 2005-06-22 Michael Smith - | - | * lib.xweb: Finalized read-character-map() and - | apply-character-map() functions. - | - | 2005-06-18 Michael Smith - | - | * lib.xweb: Added initial versions of - | replace-chars-with-strings() and apply-character-map() - | functions. These are intended mainly for use in the manpages - | stylesheets but may be useful elsewhere too. I need to fix - | the logic in the manpages stylesheet so that the - | character-map file is read only once per document. The way - | it is now, the character map is read each time a refentry is - | found, which is a big waste. - | - | 2005-05-23 Michael Smith - | - | * lib.xweb: Make handling of date format strings more robust - | (closes #1206837). ::Problem: If the "dbtimestamp" PI has - | words in it that contain any of the single-letter characters - | used as date/time formatting instructions, the output is not - | what would be expected. For example, Spanish "long" dates - | look like this: 23 de mayo de 2005 So you would expect that - | you could generate a date of that form using the dbtimestamp - | PI with a format string like the following: But if you try that, you get the - | following output: 23 23e mayo 23e 2005 That is, the "d" in - | "de" is replaced with the day of the month. ::Cause:: The - | format-string parsing logic works by walking through the - | format string character-by-character. So when it gets to the - | "d" in "de", it has no way of discerning that it is not the - | "d" formatting instruction but is instead part of a word - | intended to be included in the output as a literal string. - | ::Fix:: The format-string parsing logic now splits format - | strings into tokens and delimiters and evaluates them - | token-by-token instead of character-by-character. For - | example, it splits the Spanish "long" date format like this: - | d de B ... - | Thus, in looking for the "d" formatting instruction, the "d" - | token matches but the "de" token does not. As delimiters, it - | recognizes the following characters: - | , . / - ( ) [ ] ::Affects: This change affects output of the - | "dbtimestamp" PI as well as output from any customization - | layers that call the "datetime.format" template. It affect - | all formats (HTML, FO, etc.). - | - | 2005-05-13 Michael Smith - | - | * Makefile: Added clean target - | - | * Makefile: revert to MAIN - | - -Changes to xsl/manpages/* - - | 2005-07-14 Michael Smith - | - | * links.xsl: Removed unnecessary .br requests. - | - | * links.xsl: Use string value of link contents in link list so - | character formatting is "normalized" (no bold or ital). - | - | 2005-07-13 Michael Smith - | - | * inline.xsl, param.ent, param.xweb: Prevent hyphenation of - | computer inlines, filenames, and URLs. (Closes #1124391; - | thanks to Ryan Hofschneider for reporting). By default, even - | when hyphenation is enabled (globally), hyphenation is now - | suppressed for "computer inlines" (currently, just - | classname, constant, envar, errorcode, option, replaceable, - | userinput, type, varname -- but probably need to add more) - | and for filenames, and for URLs from Ulink. It can be - | (re)enabled using the man.hyphenate.computer.inlines, - | man.hyphenate.filenames, and man.hyphenate.urls params. - | - | * lists.xsl: Removed unnecessary .LP requests that were being - | generated after lists. I don't know why those were there, - | but they have apparently been in since the code was first - | added to the repository. - | - | * synop.xsl: Made Funcsynopsisinfo bold, and made it a proper - | .PP block, and removed the extra space (.sp) that was being - | added after it. - | - | 2005-07-12 Michael Smith - | - | * inline.xsl, links.xsl, synop.xsl, utility.xsl: Added support - | for suppressing hyphenation of "computer inlines" and - | filenames and URLs. More details to follow with param - | checkins. - | - | * synop.xsl: Boldface everything in Funcsynopsis output except - | params. Closes #1236641. The man(7) man page says: For - | functions, the arguments are always specified using italics, - | even in the SYNOPSIS section, where the rest of the function - | is specified in bold: A look through the contents of the - | man/man2 directory shows that most (all) existing pages do - | follow this "everything in bold" rule. That means the - | content and any punctuation (parens, semicolons, varargs) - | also must be bolded. - | - | 2005-07-11 Michael Smith - | - | * docbook.xsl, inline.xsl, links.xsl, param.ent, param.xweb: - | Implemented out-of-line handling of URLs for links (Ulinks). - | (Closes #1234711 and #1233909) For display of links, this - | implementation gives users three choices: 1. Number & list - | links. Each link is numbered and a numbered list of all - | links is added to the end of the document. or 2. Only list - | links. Links are not numbered, but an (unnumbered) list of - | links is added to the end of the document. or 3. Suppress - | links. Don't number links and don't add any list of links to - | the end of the document Users can also choose whether links - | should be underlined. Default is "the works" -- list, - | number, and underline links. The man.links.* parameters can - | be used to change the defaults. The default heading for the - | link list is REFERENCES. That can be changed using the - | man.links.list.heading param. There is a performance hit for - | listing and numbering links. But it is not an unreasonable - | one. The code currently only checks for Ulinks. It can be - | updated later (possibly) to deal with DocBook NG linking. - | But come to think of it, DocBook NG links get converted by - | the strip-ns template. So DocBook NG users will just need to - | run that first. Or, if I can ever manage to get the - | single-pass conversion process to work with manpages, it - | will get done automatically. - | - | * other.xsl: New file. - | - | 2005-07-10 Michael Smith - | - | * inline.xsl: ulink handling now working as expected; but - | performance is poor for docs that have a lot of ulinks; that - | needs to be fixed - | - | * inline.xsl: Ulink handling -- fixed performance issue - | (per-Refentry sets of Ulinks are now assembled once per - | document and stored in a global variable). It now takes - | roughly on the order of 15 to 20 percent longer to process a - | doc with links numbered than it does to process it with - | links unnumbered. Which may sound like a lot, but with a doc - | that has 100+ links, on my machine, that still amounts to - | less than a one-second difference (only about 0.7 seconds). - | - | * inline.xsl: Checkpointing further ulink changes. - | - | 2005-07-09 Michael Smith - | - | * docbook.xsl, info.xsl, inline.xsl: ulink fixes. (initial - | implementation of out-of-line handling of ulinks) - | - | * inline.xsl: Checkpointing further ulink changes. All visible - | links are now displayed in the link list, and numbered. But - | it performance leaves something to be desired. And not - | working properly for case where document contains multiple - | Refentry. - | - | * inline.xsl: Checkpointing. Now link list contains unique - | URLs (removes dupes), but needs more work -- some URLs are - | getting suppressed that shouldn't be; one symptom of that is - | that numbering is thrown off. - | - | * other.xsl: branches: 1.11.2; ulink fixes. (initial - | implementation of out-of-line handling of ulinks) - | - | 2005-07-08 Michael Smith - | - | * lists.xsl: Removed redundant template. - | - | * param.ent, param.xweb: Added new params for controlling link - | handling. - | - | 2005-07-06 Michael Smith - | - | * param.xweb: Replaced duplicated "charmap" IDs with good - | ones. - | - | 2005-07-05 Michael Smith - | - | * block.xsl: suppress Abstract - | - | * docbook.xsl: Use utility.xsl - | - | * docbook.xsl: Implemented output-independent mechanism for - | gathering refentry metadata, along with a customization - | parameters for tuning it. (Closes #1232541) - | - | * general.xsl, info.xsl, other.xsl: Did some reorganizing. - - | Moved prepare.manpage.contents template out of general.xsl - | file and into other.xsl; general.xsl templates are now all - | templates that are called multiple times for each refentry, - | while templates in other.xsl are called only once per each - | refentry. - Removed get.metadata template; refentry metadata - | gathering is now done by common/refentry.xsl in a way that - | is independent of the final output format; so the - | common/refentry.xsl templates can be called not just by - | manpages stylesheets, but by stylesheets for any other - | output format - Added a write.man.file template. This is - | basically just a wrapper around the write.text.chunk - | template; it takes "name" and "section" params, assembles - | those into a filename, then passes that filename to - | write.text.chunk - | - | * general.xsl, utility.xsl: Renamed general.xsl to - | utility.xsl. - | - | * inline.xsl: Added trademark/productname template. This - | template causes true Unicode characters to be output for the - | "copyright" and "registered" symbols (which be default then - | get replaced by the apply-string-subst-map template). It - | outputs the string "(TM)" for trademark (because roff "\(tm" - | output is not good) and "(SM)" for servicemark. - | - | * other.xsl: Removed leftover debugging variables. - | - | * other.xsl, param.ent, param.xweb: Added support for enabling - | users to control what appears and does not appear in the - | content of the .TH title-line header/footer. (Closes - | #1210492) - | - | * param.ent, param.xweb: Implemented capability for users to - | customize "refentry metadata gathering" by specifying XPath - | expressions to use as "info profiles" for gathering the - | data, and, in some cases, to suppress parts of the data - | collected. - | - | * param.ent, param.xweb: Added man.subheading.divider.enabled - | flag and tweaked doc for man.subheading.divider - | - | * param.ent, param.xweb: Added params to support makin - | "metadata gathering" independent of output format (initial - | change for #1232541, more to follow shortly). - | - | * refentry.xsl: Cleaned up redundancies in refnamediv and - | refsynopsisdiv title handling. - | - | 2005-07-01 Michael Smith - | - | * docbook.xsl, general.xsl, info.xsl: Checkpointing. In the - | middle of tinkering with composition of the .TH title line. - | Started pulling at thread and unwound things. This works - | as-is now (not broken) but is not finished. - | - | * other.xsl, refentry.xsl: Put quotes around section in .TH - | title line & normalize space in title and section in .TH - | title line (as we do with all other fields in it). Also, - | added and refined comments, in part based on reading of - | man(7) man page. - | - | 2005-06-29 Michael Smith - | - | * block.xsl, general.xsl, other.xsl, param.ent, param.xweb, - | refentry.xsl: Added support for man.subheading.divider - | parameter. - | - | * docbook.xsl, other.xsl, param.ent, param.xweb: Added support - | for man.justify, man.hyphenate, man.break.after.slash, and - | an.th.title.max.length parameters. Also switch to using - | locale-safe "string-upper" function to uppercase the TH - | title. So manpages output is now - | internationalized/localizable in all respects where is can - | be made so at this point. - | - | * general.xsl, info.xsl: Deal with *info correctly & remove - | some kruft. - | - | * lists.xsl, other.xsl, refentry.xsl: Removed unnecessary - | additional linebreak that was getting added after each - | varlistentry. Also, in a couple places that needed it, added - | check for *info/title (instead of just title). Also, added - | support of processing title or *info/title on Refsynopsisdiv - | (still falls back to gentext SYNOPSIS title if no hard-coded - | title found. - | - | 2005-06-28 Michael Smith - | - | * charmap.groff.xsl: Render servicemark and trademark as (SM) - | and (TM). Because console output for groff "\(tm" is not - | acceptable. - | - | * charmap.groff.xsl: Output "\-" for non-breaking hyphen. - | - | * docbook.xsl, param.ent, param.xweb, synop.xsl: Support - | man.justify and man.hyphenate params. (closes #1229225). - | Note that default for the both of those is zero (off), - | because justified text looks good only when it is also - | hyphenated; to quote the "Hypenation" node from the groff - | info page: Since the odds are not great for finding a set of - | words, for every output line, which fit nicely on a line - | without inserting excessive amounts of space between words, - | `gtroff' hyphenates words so that it can justify lines - | without inserting too much space between words. The problem - | is that groff is not particularly smart about how it does - | hyphenation; it can end up hyphenating a lot of things that - | you don't want hyphenated (names of symbols, for example), - | and it is difficult and tiresome work to prevent it from - | doing that. So, disabling both justification and hyphenation - | ensures that hyphens won't get inserted where you don't want - | to them, and you don't end up with lines containing - | excessive amounts of space between words. Yes, these default - | settings run counter to how most existing man pages are - | formatted. But there are some notable exceptions, such as - | the perl man pages. - | - | * other.xsl: Added support for man.output.quietly for writing - | of stubs. Also, added comments regarding display of .TH - | contents across platforms. - | - | 2005-06-27 Michael Smith - | - | * docbook.xsl, general.xsl, param.ent: Implemented "character - | map" system for replacing Unicode characters. (closes - | #1226009). ::PROBLEM: The existing manpages mechanism for - | replacing Unicode symbols and special characters with roff - | equivalents is not scalable and not anywhere near as - | complete as it should be. For example, the mechanism - | currently only handles a (somewhat arbitrary) selection of - | less than 20 or so Unicode characters. But there are - | potentially more than _800_ Unicode special characters that - | have some groff equivalent they can be mapped to. And there - | are about 34 symbols in the Latin-1 (ISO-8859-1) block - | alone. Users might reasonably expect that if they include - | any of those Latin-1 characters in their DocBook source - | documents, they will get correctly convered to known roff - | equivalents in output. In addition to those common symbols, - | certain users may have a need to use symbols from other - | Unicode blocks. Say, somebody who is documenting an - | application related to math might need to use a bunch of - | symbols from the "Mathematical Operators" Unicode block - | (there are about 65 characters in that block that have - | reasonable roff equivalents). Or somebody else might really - | like Dingbats -- such as the checkmark character (I like - | that one myself) and so might use a bunch of things from the - | "Dingbat" block (141 characters in that that have roff - | equivalents or that can at least be "degraded" somewhat - | gracefully into roff). So we need a mechanism that is - | capable of handling all those 800 Unicode characters that - | have roff equivalents -- and/or of allowing users to choose - | which Unicode blocks to use (through tuning the value of a - | parameter or something). ::FIX: Replaced the current Unicode - | character-substitution mechanism (replace-entities template) - | with a completely different character-substitution mechanism - | that is based on use of a "character map" (in a format - | compliant with the XSLT 2.0 spec and therefore completely - | "forward compatible" with XSLT 2.0). By default, the new - | "character map" mechanism does replacement of all Latin-1 - | symbols, along with most special spaces, dashes, and quotes - | (about 75 characters by default, compared to the less than - | 20 special characters that were handled previously). And the - | "full" character map provides support for converting about - | 800 characters. The mechanism is controlled through the - | following parameters: - man.charmap.enabled: turns - | character-map support on/off - man.charmap.use.subset.xml - | specifies that a subset of the character map is used instead - | of the full character map - man.charmap.subset.profile.xml - | specifies profile of character-map subset - - | man.charmap.uri.xml specifies an alternate character map to - | use instead of the "standard" character map provided in the - | distribution For more details, see the current documention - | at: - | http://docbook.sf.net/snapshot/xsl/doc/manpages/charmap.html - | - | * param.xweb: Added IDs for sub-references, so that "human - | readable" filenames are generated based on those (instead - | of, e.g., "rn.html") - | - | * param.xweb: Made doc source compliant with expectations of - | doc build. - | - | 2005-06-26 Michael Smith - | - | * docbook.xsl, general.xsl, info.xsl, inline.xsl, lists.xsl, - | other.xsl, param.ent, param.xweb, refentry.xsl, synop.xsl: - | Checkpointing before coding and committing final - | character-map changes. This change fully implements - | character-map support. I'll write up a longer description of - | that in a later commit. But the brief description is: The - | old Unicode character replacement mechanism - | (replace-entities template) has been removed; a completely - | different character-replacement mechanism is now used - | instead. By default, it does replacement of all Latin-1 - | symbols, along with most special spaces, dashes, and quotes - | (about 75 characters by default, compared to the less than - | 20 special characters that were handled previously). And the - | "full" character map provides support for converting about - | 800 characters. The mechanism use a "character map" (in a - | format compliant with the XSLT 2.0 spec and therefore - | completely "forward compatible" with XSLT 2.0. Other changes - | made for this commit: - Changed default output encoding to - | UTF-8. THIS DOES NOT MEAN THAT MAN PAGES ARE OUTPUT IN RAW - | UTF-8, because the character-map is applied before final - | output, causing all UTF-8 characters covered in the map to - | be converted to roff equivalents. - Removed code for adding - | backslashes before periods/dots and before hyphens (-); - | here's why: * Backslashes in front of periods/dots are - | needed only in the very rare case where a period is the very - | first character in a line, without any space in front of it. - | A better way to deal with that rare case is for authors to - | add a zero-width space in front of the offending dot(s) in - | their source * Backslashes in front of (-/-) are - | needed... when? Myself, I don't know, so the current - | stylesheet does not add backslashes in front of them, ever. - | If there is a specific case where they are necessary or - | desirable, then we need to add code for that case, not just - | do a blanket conversion. And, anyway, my understanding from - | reading the groff docs is that \- is, specifically, a _minus - | sign_. So if you have a place where you want a minus sign to - | be output instead of (-), then you should use - | (−/−) in your source instead. And if you have a - | place where you want an en dash, (–/–). Or if - | there are places where the stylesheets are internally - | generating (-) where they should be generating − - | or –, then we need to fix those, not just do blanket - | conversion. - Consolidated all bold and italic formatting so - | that it is done by applying the mode="bold" and - | mode="italic" templates. - Consolidated handling of all - | instances where we want to prevent line breaking; they are - | all now processed using the prevent.line.breaking template. - | - Removed "quote" template. In output, this was causing - | anything marked up with the element to be preceded - | by two backticks and followed by two apostrophes -- that is, - | that old-school hack for generating "curly" quotes in Emacs - | and in X-Windows fonts. While Emacs still seems to support - | that, I don't think X-Windows has for a long time now. And, - | anyway, it looks (and has always looked) like complete crap - | when viewed on a normal tty/console - | - | 2005-06-25 Michael Smith - | - | * charmap.groff.xsl: Switched to "block" and "class" - | attributes and back to using real backslashes instead of - | @esc@ hack. - | - | 2005-06-20 Michael Smith - | - | * charmap.groff.xsl: Added "class" attribute on all - | characters, value of which is the name of the Unicode block - | the character is from. This replaces the use of the ad-hoc - | "class='default'" scheme. - | - | 2005-06-14 Michael Smith - | - | * charmap.groff.xml, charmap.groff.xsl, charmap.roff.min.xml, - | unicodetrans.xsl: More charmap reorganization. - Removed - | unicodetrans.xsl file (function moved to lib/lib.xsl). - - | Removed charmap.groff.xml & charmap.roff.min.xml and created - | a single charmap.groff.xsl file that incorporates both - | (using a class="default" attribute/value to mark those - | mappings that are in the default/minimal set). - Made - | charmap.groff.xsl into a "real" (valid) XSLT 2.0 character - | map so it can be used as-is for XSLT 2.0-aware processing - | (e.g., it can imported or included into another XSLT 2.0 - | stylesheet). - | - | * docbook.xsl, other.xsl: Created an other.xsl file and moved - | some templates into it. - | - | * textify.xsl: Removed. No longer used by build. html/xref.xsl - | is used "as is" - | - | 2005-06-10 Michael Smith - | - | * Makefile: Reverted some recent build changes. Reverted build - | of xref.xsl. Will no longer need it after Unicode char - | handling change is made. Reverted build of single-pass - | profiling stylesheet (for now). It doesn't appear to work - | with manpages, and figuring if and how I can get it work is - | a very low priority, especially given that single-pass - | profiling doesn't work with documents that contain xref - | instances. If you want to profile content before converting - | to man-page output, please just do a separate profiling pass - | first. - | - | * charmap.groff.xml, charmap.roff.min.xml, roff.charmap.xml, - | unicodetrans.xsl: Made further changes for Unicode character - | translation. Renamed roff.charmap.xml to charmap.groff.xml. - | Added charmap.roff.min.xml (minimal subset of around 40 - | "safe" mappings appropriate for nroff as opposed to groff). - | Removed $charmap.file param from unicodetrans.xsl in - | preparation for adding it as a real param to param.xweb - | - | 2005-06-09 Michael Smith - | - | * general.xsl, info.xsl, synop.xsl: (devel-only issue) - | replace-string() -> string.subst() Removed the - | used-in-manpages-stylesheet-only replace-string() function - | and replaced all instances where it had been called with - | calls to the same string-substitution function used by the - | HTML and FO stylesheets: string.subst() from ../lib/lib.xsl - | - | * roff.charmap.xml: Corrected stray comment. - | - | * roff.charmap.xml, unicodetrans.xsl: New file. - | - | 2005-06-08 Michael Smith - | - | * docbook.xsl, info.xsl: Reworked *info gathering and - | rethought Refclass handling. For each Refentry found, we now - | cache its *info and its parent's *info as node-sets; we then - | do all further matches against those node-sets (rather than - | re-selecting the original *info nodes each time we need to - | check them). Also, reverted the special handling of Refclass - | that was added recently. We eventually need to make Refclass - | handling consistent with that of the HTML and FO - | stylesheets. - | - | 2005-06-07 Michael Smith - | - | * ChangeLog.20020917: New file. - | - | * README: Added some Notes section with info contributed by - | Barry Rountree. - | - | * README: Fixed typo. - | - | * lists.xsl: Removed unnecessary trailing comma after final - | term/glossterm (closes #1215890; thanks to Sam Steingold for - | reporting the problem). ::PROBLEM:: If a varlistentry or - | glossentry contains multiple term or glossterm elements, a - | comma is rendered after the final term or glossterm. A comma - | should instead be rendered only after every term or - | glossterm _except_ the last. ::FIX:: Reworked template logic - | for term/glossterm. They are now handled with an - | xsl:for-each in the varlistentry/glossentry template, rather - | than as separate templates. HTML and FO stylesheets appear - | to have the same problem, so we probably need to port this - | change to those as well. - | - | * refentry.xsl: Don't render NAME heading for secondary - | Refnamedivs (closes #1216292) If a document has multiple - | Refnamedivs, a NAME heading was getting rendered for each. - | But we only need one NAME heading. This change causes it to - | be rendered just once. This makes behavior in this respect - | consistent with how the HTML and FO stylesheets handle the - | generated NAME heading for Refnamediv. - | - | 2005-06-06 Michael Smith - | - | * refentry.xsl: Uppercase titles in x-ref to Refentry children - | (closes #1215547; thanks to Jens Granseuer for reporting the - | problem). ::PROBLEM:: Titles of all first-level sections in - | man pages are always rendered in uppercase. But - | cross-references to those titles are not uppercase. ::FIX:: - | Cross-references to titles of all first-level sections of - | Refentry output are now rendered in uppercase; that is, - | titles in x-refs to Refnamediv, Refsynopsisdiv, Refsect1, - | and any Refsection that is a direct child of Refentry. Also, - | x-ref to Refnamediv now uses the localized "NAME" title - | instead of the using the first Refname child. This makes the - | output inconsistent with HTML and FO output, but for - | man-page output, it seems to make better sense to have the - | "NAME". (It may actually make better sense to do it that way - | in HTML and FO output as well.) That said, I guess it's not - | likely that most people would put in an x-ref to a - | Refnamediv section, so maybe it's kind of a moot point... - | - | 2005-06-02 Michael Smith - | - | * general.xsl, synop.xsl: Added support for processing - | funcparams (closes #1213166; thanks to Barry Rountree for - | reporting). ::PROBLEM:: The funcparams element was not being - | processed as expected. ::CAUSE:: No logic existed in - | manpages stylesheets for handling funcparams. ::FIX:: Fixed - | by taking old code for handling of funcprototype and - | children, and replacing it with code ported over from HTML - | templates for ANSI-style output. ::AFFECTS:: This change - | affects handling of all funcprototype output. Along with - | adding support for funcparams, the following changes were - | also made: - removed the space that was being output between - | funcdef and paramdef; example: was: float rand (void); now: - | float rand(void); - turned off bold formatting for the - | element when it occurs within a funcdef or paramdef - - | moved space -> nobreak-space replacement logic into a - | separate template (for potential re-use elsewhere if we need - | it) ::TODO:: We need to add an option for K&R style - | funcprototypes. See #1213277. - | http://sourceforge.net/tracker/index.php?func=detail&aid=1213277&group_id=21935&atid=516914 - | - | 2005-05-30 Michael Smith - | - | * docbook.xsl, info.xsl: Re-worked construction of .TH title - | line (closes #1210488). Also, made comment generated at top - | of page include version info (closes #1211254). Here are the - | details about the refinements made to the construction of - | the .TH title line: - "extra1" (which shows up in the center - | footer of each page): If a date cannot be found in the - | source, we now automatically generate a localized "long - | format" date - "extra2" (which shows up in the left footer): - | We now first search for "product version" info; then, if we - | can't find that, a "product name"; if we can't find that, we - | look for "other" info to use. And we can't find that, we - | leave it empty. The exact sequence of elements checked is - | this: 1. productnumber in info or refentryinfo 2. - | productnumber in info or referenceinfo of parent reference - | 3. any refmeta/refmiscinfo that has class = 'version' 4. - | productname in info or refentryinfo 5. productname in info - | or referenceinfo of parent reference 6. refmeta/refmiscinfo - | (first one) 7. refnamediv/refclass (first one) - "extra3" - | (which shows up in the center header): The exact sequence of - | elements checked is now this: 1. title in info or - | referenceinfo of parent reference 2. refnamediv/refclass - | (first one) 3. refmeta/refmiscinfo (first one) - | - | 2005-05-29 Michael Smith - | - | * general.xsl, refentry.xsl: Added support for processing - | refsection down to any arbitrary level of nesting (closes - | #1210482). - | - | * stripns.xsl: New file. - | - | * stripns.xsl: Fixed typo in comment. - | - | 2005-05-28 Michael Smith - | - | * block.xsl, docbook.xsl, general.xsl, refentry.xsl: Added - | support for refsect3 and formalpara processing (closes - | #1210478 and #1210479). Also did some further templates - | re-organizing, including to the logic for gathering and - | processing metadata. - | - | 2005-05-27 Michael Smith - | - | * block.xsl, docbook.xsl, general.xsl, inline.xsl: Modularized - | a bit further. - | - | * block.xsl, lists.xsl, synop.xsl, textify.xsl: Added header - | (with RCS keywords and copyright info) to all files that - | lacked it. - | - | * docbook.xsl: Modularized main "refentry" template a bit. - | - | * sect23.xsl: Removed. This file has never been included by - | docbook.xsl, so it serves no purpose at all... - | - | 2005-05-24 Michael Smith - | - | * .cvsignore, Makefile, textify.xsl, xref.xsl: Make xrefs and - | olinks work, and prevent instances of “ and ” - | entities in output (closes #741578 and #956072; thanks to - | Jens Granseuer and Sam Steingold for reporting the problems) - | ::Problem: If you include an xref in a source document, - | instead of getting the xref text you would expect in the - | output, you just get "[xref to refsect1]", where "refsect" - | is the name of the target element for the xref. If you - | include an olink, it works as expected -- except that the - | output text has “ and ” entities (double "curly" - | quotation marks). ::Cause: The manpages/docbook.xsl driver - | imports the html/docbook.xsl stylesheet, which in turn - | imports the html/xref.xsl file. The manpages/docbook.xsl - | file then imports the manpages/xref.xsl file. That file - | contains a "xref" template that overrides the the one in - | html/xref.xsl and that, by design, does nothing except to - | generate the "[xref to refsect1]" text instead of the - | expected xref output. On the other hand, the manpages - | stylesheets don't override the "olink" template; therefore, - | the "olink" template from the html/xref.xsl file is used "as - | is". And being that it is intended for HTML output, that - | template uses the “ and ” to wrap titles in xref - | output. ::Fix: The original manpages/xref.xsl file has now - | been removed. The build for the manpages distribution now - | makes that file, using the textify.xsl stylesheet to - | automatically generate it from the html/xref.xsl file. It is - | built in such a away that it basically just contains special - | copies of the "xref" and "olink" templates that cause - | “ and ” instances to be transformed into "\(lq" - | and "\(rq" (groff "left quote" and "right quote"). It might - | seem odd that templates from the html/xref.xsl are used, - | since those templates a designed to generate hyperlinks of - | the form the section called "Bar". But it - | works because the manpages stylesheets end up using the text - | value of the output of the above. Thus, the - | and parts are stripped out, leaving just the text - | between ('the section called "Bar"'). ::Affects Only affects - | output of xref and olink elements. The fix may not be - | complete and/or may cause other problems. Please test. In - | particular, while it may fix the “ and ” problem - | that English lang/locales users have run into, it doesn't - | fix the corresponding problem for output of xrefs and olinks - | in many non-English locales, which use quoting characters - | other than “ and ” To give just one example of - | many: in Japanese, the quoting characters are 「 and - | 」 ("left corner bracket" and "right corner bracket"). - | It is possible to "fix" the problem for all locales; but it - | is just a question of whether there is enough of a demand - | for it that it is worth doing. - | - | * Makefile: Cause "clean" target to remove xref.xsl - | - | * docbook.xsl: Whitespace-only change. Expanded all tabs - | - | * docbook.xsl: Added replace-ldqou and replace-rdquo - | templates, for translating “ to \(lq and ” to - | \(rq - | - | * docbook.xsl, sect23.xsl, synop.xsl: Prevent "sticky" fonts - | changes. (closes #956070; thanks to Sam Steingold for - | reporting the problem, and for his patience...) ::Problem: - | Sometimes a bold or italic font change inadvertently ends up - | becoming "sticky" such that a following chunk of text that - | should just be rendered as plain text instead gets - | boldfaced/italicized. ::Cause: Font changes were simply - | being nested, as they are in HTML. While that works for - | HTML, it doesn't work for roff, where font-change - | instructions aren't actually intended to nest. ::Fix: - | Attempted to un-nest bold/italic font changes. When the - | manpages stylesheets encounter node sets that need to be - | boldfaced or italicized, they now put the \fBfoo\fR - | \fIbar\fR groff bold/italic instructions separately around - | each node in the set. This may not be a complete fix for the - | problem. In fact, it may cause other problems. Please test - | :^) - | - | * lists.xsl: Support generation of choice separator in inline - | simplelist (closes #1207532) This ehancement enables - | auto-generation of an appropriate localized "choice - | separator" (for example, "and" or "or") before the final - | item in an inline simplelist. To indicate that you want a - | choice separator generated for a particular list, you need - | to put a processing instruction (PI) of the form as a child a of the list. For example: - | This release adds localiation support for the - | following Indic languages: - | Hindi - | Punjabi Tamil - | Oriya Gujarati - | . Output (for English): This release - | adds localiation support for the following Indic languages: - | Hindi, Punjabi, Tamil, Oriya, and Gujarati. Or if the - | logical relationship between the items in the list is an - | "or" relationship, then use choice="or": Choose from - | ONE and ONLY ONE of the following: A - | B C. - | Output (for English): Choose from ONE and only ONE of the - | following choices: A, B, or C. As a temporary workaround for - | the fact that most of the DocBook non-English locale files - | don't have a localization for the word "or", you can put in - | a literal string to be used; example for French: - | Choose from ONE and ONLY ONE of the following: - | - | A B C. - | That is, use "ou" instead of "or". - | - | 2005-05-23 Michael Smith - | - | * synop.xsl: Rolled back some over-aggressive line-break - | cleanup, and removed space-normalizing call in group|arg - | template because it causes to be handled incorrectly. - | - | 2005-05-22 Michael Smith - | - | * docbook.xsl: Grand Unification: Epilogue (2): If - | "neighboring" text nodes in mixed content are - | whitespace-only, apply the special sauce just before - | serving; that is, at the end, not both at the beginning and - | at the end. - | - | * lists.xsl: Repaired line-breaking in list output. Thanks to - | Hendrik Sattler for reporting the problem. The cause of this - | is was a change that was made a while back to reduce - | excessive blank lines in output. Looks like in this case it - | cut it back a bit too aggressively. There may yet be some - | other cases that will need more fine-tuning. - | - | 2005-05-21 Michael Smith - | - | * docbook.xsl: Whitespace Grand Unification: Epilogue (1): If - | "neighboring" text nodes in mixed content are - | whitespace-only, leave them unseasoned; that is, don't add - | the special sauce. - | - | 2005-05-20 Michael Smith - | - | * docbook.xsl, lists.xsl, synop.xsl: Verbatim environment - | "Grand Unification" fix. Attempte to fix handling of - | verbatim environments (literallayout, programlisting, - | screen) and, in a related way, text nodes. Particularly in - | mixed-content blocks. I think I got it working... Closes - | #1167995, #975243, #935833, #763861, #728932, #628393, - | #595213. Thanks to Hendrik Sattler, Tobias Reif, Tommi - | Virtanen, Dennis Grace, and Matthias Andree for reporting - | the problems. Sorry it took so long for the fix. - | - | 2005-05-11 Michael Smith - | - | * docbook.xsl: remove some unnecessary generated line breaks - | (relates to issue #607270) - | - | * docbook.xsl: Handle email in info section apprpropriately. - | Replace "Man page edited by Foo." with "Foo. (man page)" - | - | * lists.xsl: Simplified and corrected rendering of simplelist. - | (closes #1154750 and #699081; thanks to Matthias Andree and - | Bert Vermeulen for reporting the problem) - Any simplelist - | type="inline" instance is now rendered as a comma-separated - | list, with a comma and also a localized "and" before the - | last item. - Any simplelist instance whose type is not - | inline is rendered as a one-column vertical list (ignoring - | the values of the type and columns attributes if present) - | - | * lists.xsl, sect23.xsl, synop.xsl: removed some more - | unnecessary line breaks (closes #607270) - | - | 2005-05-10 Michael Smith - | - | * docbook.xsl: Support localization of gentext for various - | things (issue #1199352, #1199153, #1199033, and #1167995; - | thanks to Hendrik Sattler for reporting the issue). Gentext - | is now localized for the following - Heading generated for - | refsynopsis section - Heading generated for refname section - | - Heading generated for author attribution - Headings - | generated for admontions There are some other bits of - | gentext that still need to be localized. - | - | 2005-02-24 Michael Smith - | - | * .cvsignore: ignore stuff - | - | * .cvsignore: New file. - | - | * Makefile, param.ent, param.xweb: New file. - | - | * docbook.xsl: revert misguided dependence on - | emphasis.propagates.style in manpages output; manpages are - | now just hard-coded (not configurable) to turn emphasis into - | groff italic and emphasis role=bold|strong into groff bold; - | this is equivalent to what is done for HTML output; should - | it be configurable? - | - -Changes to xsl/params/* - - | 2005-07-14 Norman Walsh - | - | * annotation.css.xml: New file. - | - | * annotation.graphic.close.xml, annotation.graphic.open.xml, - | annotation.js.xml, annotation.support.xml: New file. - | - | 2005-07-14 Michael Smith - | - | * man.string.subst.map.xml: Added bullet to set of - | string-substitution chars. - | - | 2005-07-13 Michael Smith - | - | * man.hyphenate.computer.inlines.xml, - | man.hyphenate.filenames.xml, man.hyphenate.urls.xml, - | man.hyphenate.xml: Prevent hyphenation of computer inlines, - | filenames, and URLs. (Closes #1124391; thanks to Ryan - | Hofschneider for reporting). By default, even when - | hyphenation is enabled (globally), hyphenation is now - | suppressed for "computer inlines" (currently, just - | classname, constant, envar, errorcode, option, replaceable, - | userinput, type, varname -- but probably need to add more) - | and for filenames, and for URLs from Ulink. It can be - | (re)enabled using the man.hyphenate.computer.inlines, - | man.hyphenate.filenames, and man.hyphenate.urls params. - | - | 2005-07-12 Michael Smith - | - | * man.string.subst.map.xml: Added substitutions for \& and \% - | - | 2005-07-11 Michael Smith - | - | * man.links.are.numbered.xml, man.links.are.underlined.xml, - | man.links.list.heading.xml, man.links.section.heading.xml: - | Updated doc for link-related params. Renamed - | man.links.section.heading to man.links.list.heading. - | - | * man.links.list.enabled.xml: New file. - | - | * man.string.subst.map.xml: Added comment about non-breaking - | space. - | - | 2005-07-10 Robert Stayton - | - | * appendix.autolabel.xml, chapter.autolabel.xml, - | part.autolabel.xml, preface.autolabel.xml: Updated reference - | pages to support number format options. - | - | 2005-07-08 Jirka Kosek - | - | * component.title.properties.xml: Bibliography in article - | shouldn't be centered. This stuff really must be refactored - | better way! - | - | 2005-07-08 Michael Smith - | - | * man.charmap.uri.xml: Set type value for man.charmap.uri to - | "uri" - | - | * man.links.are.numbered.xml, man.links.are.underlined.xml, - | man.links.section.heading.xml: New file. - | - | * man.string.subst.map.xml: Added trademark and servicemark - | mappings. - | - | 2005-07-06 Michael Smith - | - | * man.charmap.subset.profile.xml, man.string.subst.map.xml: - | Added "namespace" attributes to non-DocBook s, to - | prevent them from being converted to TDG hyperlinks. - | - | * man.hyphenate.xml, man.justify.xml: Typos and wording tweaks - | (to sync up with language in the release notes) - | - | 2005-07-05 Michael Smith - | - | * man.output.quietly.xml: Added not about setting - | man.output.quietly to speed up processing time. - | - | * man.output.quietly.xml: Fixed typo. - | - | * man.string.subst.map.xml: Added the following substitutions: - | - -
- Release 1.69.0 - The release includes major feature changes, - particularly in the manpages - stylesheets, as well as a large number of bug fixes. - - As with all DocBook Project dot zero releases, this is an - experimental release . - -
- Common - - - This release adds localizations for the following - languages: - - - Albanian - Amharic - Azerbaijani - Hindi - Irish (Gaelic) - Gujarati - Kannada - Mongolian - Oriya - Punjabi - Tagalog - Tamil - Welsh - . - - - Added support for specifying number format for auto - labels for chapter, appendix, - part, and preface. Contolled with the - appendix.autolabel, - chapter.autolabel, - part.autolabel, and - preface.autolabel parameters. - - - Added basic support for biblioref cross - referencing. - - - Added support for align - on caption in mediaobject. - - - Added support for processing documents that use the - DocBook V5 namespace. - - - Added support for termdef and - mathphrase. - - - EXPERIMENTAL: Incorporated the Slides and Website - stylesheets into the DocBook XSL stylesheets package. So, - for example, Website documents can now be processed using - the following URI for the driver Website - tabular.xsl file: http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl - - - A procedure without a title is - now treated as an informal procedure (meaning - that it is not added to any generated list of - procedures and has no affect on numbering of - generated labels for other procedures). - - - docname is no longer added to - olink when pointing to a root element. - - - - Added support for generation of choice separator in - inline simplelist. This enables auto-generation of an - appropriate localized choice separator (for - example, and or or) before the - final item in an inline simplelist. - To indicate that you want a choice separator - generated for a particular list, you need to put a processing - instruction (PI) of the form - dbchoice choice="foo" as a - child of the list. For example: - <para>Choose from - ONE and ONLY ONE of the following: - <simplelist type="inline"> - <?dbchoice choice="or" ?> - <member>A</member> - <member>B</member> - <member>C</member>.</simplelist></para> - - Output (for English): -
- Choose from ONE and only ONE of the - following choices: A, B, or C. -
- As a temporary workaround for the fact that most of the - DocBook non-English locale files don't have a localization for - the word or, you can put in a literal string to - be used; example for French: dbchoice choice="ou". That is, use - ou instead of or. - - -
-
- FO - - - Added content-type property to - external-graphic element, based on - imagedata format - attribute. - - - Added support for generating - <rx:meta-field creator="$VERSION"/> - field for XEP output. This makes the DocBook XSL - stylesheet version information available through the - Document Properties menu in Acrobat - Reader and other PDF viewers. - - - Trademark symbol handling made consistent with - handling of same in HTML stylesheets. Prior to this change, - if you processed a document that contained no value for the - class attribute on the - trademark element, the HTML stylesheets would - default to rendering a superscript TM - symbol after the trademark contents, - but the FO stylesheets would render nothing. - - - Added support for generating XEP bookmarks for - refentry. - - - Added support for HTML markup table border attribute, applied to each - table cell. - - - The table.width template can now - sum column specs if none use % or - *. - - - Added fox:destination extension - inside fox:outline to support linking to - internal destinations. - - - Added support for customizing - abstract with property sets. Controlled - with the abstract.properties and - abstract.title.properties - parameters. - - - Add footnotes in table title to - table footnote set, and add support for table footnotes to - HTML table markup. - - - Added support for title in - glosslist. - - - Added support for itemizedlist symbol - none. - - - Implemented the new - graphical.admonition.properties and - nongraphical.admonition.properties - attribute sets. - - - Added id to - formalpara and some other blocks that were - missing it. - - - Changed the anchor template to output - fo:inline instead of - fo:wrapper. - - - Added support for toc.max.depth - parameter. - - -
- -
- Help - - - Eclipse Help: Added support for generating olink - database. - - -
- -
- HTML - - - Added a first cut at support in HTML output for - DocBook 5 style annotations. Controlled using the - annotation.support parameter, and - implemented using JavaScript and CSS styling. For more - details, see the documentation for the - annotation.js, - annotation.css, - annotation.graphic.open, and - annotation.graphic.close - parameters. - - - Generate client-side image map for - imageobjectco with areas using - calspair units - - - Added support for img.src.path PI. - - - Added support for passing - img.src.path to DocBook Java XSLT - image extensions when appropriate. Controlled using the - graphicsize.use.img.src.path - parameter. - - - Added support for (not - valid for DocBook 4) xlink:href - on area and (not valid for DocBook 4) - alt in area. - - - Added new parameter - default.table.frame to control table - framing if there is no frame - attribute on a table. - - - Added initial, experimental support for generating - content for the HTML title attribute from - content of the alt element. This change adds - support for the following inline elements only (none of them - are block elements): - - - abbrev - accel - acronym - action - application - authorinitials - beginpage - citation - citerefentry - citetitle - city - classname - code - command - computeroutput - constant - country - database - email - envar - errorcode - errorname - errortext - errortype - exceptionname - fax - filename - firstname - firstterm - foreignphrase - function - glossterm - guibutton - guiicon - guilabel - guimenu - guimenuitem - guisubmenu - hardware - honorific - interface - interfacename - keycap - keycode - keysym - lineage - lineannotation - literal - markup - medialabel - methodname - mousebutton - option - optional - otheraddr - othername - package - parameter - personname - phone - pob - postcode - productname - productnumber - prompt - property - quote - refentrytitle - remark - replaceable - returnvalue - sgmltag - shortcut - state - street - structfield - structname - subscript - superscript - surname - symbol - systemitem - tag - termdef - token - trademark - type - uri - userinput - varname - wordasword - - - - - Added support for chunking revhistory into - separate file (similar to the support for doing same with - legalnotice). Patch from Thomas - Schraitle. Controlled through new - generate.revhistory.link parameter. - - - l10n.xsl: Made language codes RFC compliant. Added a - new boolean config parameter, - l10n.lang.value.rfc.compliant. If it - is non-zero (the default), any underscore in a language code - will be converted to a hyphen in HTML output. If it is zero, - the language code will be left as-is. - - -
-
- man - This release closes out 44 manpages stylesheet bug reports - and feature requests. It adds more than 35 new configuration - parameters for controlling aspects of man-page output -- - including hyphenation and justification, handling of links, - conversion of Unicode characters, and contents of man-page - headers and footers. - - - - New options for globally disabling/enabling - hyphenation and justification: - man.justify and - man.hyphenate. - Note that the default - for the both of those is zero (off), because justified text - looks good only when it is also hyphenated; to quote the - Hyphenation node from the groff info page: -
- Since the odds are not great for finding a - set of words, for every output line, which fit nicely on a - line without inserting excessive amounts of space between - words, `gtroff' hyphenates words so that it can justify - lines without inserting too much space between - words. -
- The problem is that groff can end up hyphenating a lot of - things that you don't want hyphenated (variable names and - command names, for example). Keeping both justification and - hyphenation disabled ensures that hyphens won't get inserted - where you don't want to them, and you don't end up with - lines containing excessive amounts of space between - words. These default settings run counter to how most - existing man pages are formatted. But there are some notable - exceptions, such as the perl man pages. - - - Added parameters for controlling hyphenation of - computer inlines, filenames, and URLs. By default, even when - hyphenation is enabled (globally), hyphenation is now - suppressed for "computer inlines" (currently, just - classname, constant, envar, - errorcode, option, - replaceable, userinput, - type, and varname, and for - filenames, and for URLs from link. It - can be (re)enabled using the - man.hyphenate.computer.inlines, - man.hyphenate.filenames, and - man.hyphenate.urls parameters. - - - - Implemented a new system for replacing Unicode - characters. There are two parts to the new system: a - string substitution map for doing - essential replacements, and a - character map that can optionally be disabled - and enabled. - The new system fixes all open bugs that had to do with - literal Unicode numbered entities such as &#8220; and - &#8221; showing up in output, and greatly expands the - ability of the stylesheets to generate good roff - equivalents for Unicode symbols and special - characters. - Here are some details... - The previous manpages mechanism for replacing Unicode - symbols and special characters with roff equivalents (the - replace-entities template) was not - scalable and not complete. The mechanism handled a somewhat - arbitrary selection of less than 20 or so Unicode - characters. But there are potentially more than - 800 Unicode special characters that - have some groff equivalent they can be mapped to. And there - are about 34 symbols in the Latin-1 (ISO-8859-1) block - alone. Users might reasonably expect that if they include - any of those Latin-1 characters in their DocBook source - documents, they will get correctly converted to known roff - equivalents in output. - In addition to those common symbols, certain users may - have a need to use symbols from other Unicode blocks. Say, - somebody who is documenting an application related to math - might need to use a bunch of symbols from the - Mathematical Operators Unicode block (there - are about 65 characters in that block that have reasonable - roff equivalents). Or somebody else might really like - Dingbats -- such as the checkmark character -- and so might - use a bunch of things from the Dingbat block - (141 characters in that that have roff equivalents or that - can at least be degraded somewhat gracefully - into roff). - So, the old replace-entities - mechanism was replaced with a completely different mechanism - that is based on use of two maps: a - substitution map and a character - map (the latter in a format compliant with the XSLT - 2.0 spec and therefore completely forward - compatible with XSLT 2.0). - The substitution map is controlled through the - man.string.subst.map parameter, and - is used to replace things like the backslash character - (which needs special handling to prevent it from being - interpreted as a roff escape). The substitution map cannot - be disabled, because disabling it will cause the output to - be broken. However, you can add to it and change it if - needed. - - The character map mechanism, on the - other hand, can be completely disabled. It is enabled by - default, and, by default, does replacement of all Latin-1 - symbols, along with most special spaces, dashes, and quotes - (about 75 characters by default). Also, you can optionally - enable a full character map that provides - support for converting all 800 or so of the characters that - have some reasonable groff equivalent. - - The character-map mechanism is controlled through the - following parameters: - - - man.charmap.enabled - turns character-map support - on/off - - - man.charmap.use.subset - specifies that a subset of the character - map is used instead of the full map - - - man.charmap.subset.profile - specifies profile of character-map - subset - - - man.charmap.uri - specifies an alternate character map to - use instead of the standard character map - provided in the distribution - - - - - - - Implemented out-of-line handling of display of URLs - for links (currently, only for ulink). This gives - you three choices for handling of links: - - - Number and list links. Each link is numbered - inline, with a number in square brackets preceding the - link contents, and a numbered list of all links is added - to the end of the document. - - - Only list links. Links are not numbered, but an - (unnumbered) list of links is added to the end of the - document. - - - Suppress links. Don't number links and don't add - any list of links to the end of the document. - - - You can also choose whether links should be underlined. The - default is the works -- list, number, and - underline links. You can use the - man.links.list.enabled, - man.links.are.numbered, and - man.links.are.underlined parameters - to change the defaults. The default heading for the link - list is REFERENCES. You can be change that using the - man.links.list.heading - parameter. - - - Changed default output encoding to UTF-8. This does not mean that man pages are output in - raw UTF-8, because the character map is applied - before final output, causing all UTF-8 characters covered in - the map to be converted to roff equivalents. - - - - Added support for processing refsect3 and - formalpara and nested refsection - elements, down to any arbitrary level of nesting. - - - - Output of the NAME and - SYNOPSIS and AUTHOR - headings and the headings for admonitions (note, - caution, etc.) are no longer hard-coded for - English. Instead, headings are generated for those in the - correct locale (just as the FO and HTML stylesheets - do). - - - - Re-worked mechanism for assembling page - headers/footers (the contents of the .TH - macro title line). - - Here are some details... - - All man pages contain a .TH roff - macro whose contents are used for rendering the title - line displayed in the header and footer of each - page. Here are a couple of examples of real-world man pages - that have useful page headers/footers: - gtk-options(7) GTK+ User's Manual gtk-options(7) <-- header - GTK+ 1.2 2003-10-20 gtk-options(7) <-- footer - - svgalib(7) Svgalib User Manual svgalib(7) <-- header - Svgalib 1.4.1 16 December 1999 svgalib(7) <-- footer - - And here are the terms with which the - groff_man(7) man page refers to the - various parts of the header/footer: - title(section) extra3 title(section) <- header - extra2 extra1 title(section) <- footer - Or, using the names with which the man(7) - man page refers to those same fields: - title(section) manual title(section) <- page header - source date title(section) <- page footer - - The easiest way to control the contents of those - fields is to mark up your refentry content like - the following (note that this is a minimal - example). - <refentry> - <info> - <date>2003-10-20</date> - </info> - <refmeta> - <refentrytitle>gtk-options</refentrytitle> - <manvolnum>7</manvolnum> - <refmiscinfo class="source-name">GTK+</refmiscinfo> - <refmiscinfo class="version">1.2</refmiscinfo> - <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> - </refmeta> - <refnamediv> - <refname>gtk-options</refname> - <refpurpose>Standard Command Line Options for GTK+ Programs</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>This manual page describes the command line options, which - are common to all GTK+ based applications.</para> - </refsect1> - </refentry> - - - Sets the date part of the header/footer. - - - Sets the title part. - - - Sets the section part. - - - Sets the source name part. - - - Sets the version part. - - - Sets the manual part. - - - - Below are explanations of the steps the stylesheets - take to attempt to assemble and display - good headers and footer. [In the - descriptions, note that *info - is the refentry info child - (whatever its name), and - parentinfo is the - info child of its parent (again, whatever - its name).] - - - extra1 field (date) - - Content of the extra1 field is - what shows up in the center - footer position of each page. The - man(7) man page describes it as - the date of the last revision. - To provide this content, if the - refentry.date.profile.enabled - is non-zero, the stylesheets check the value of - refentry.date.profile. - Otherwise, by default, they check for a - date or pubdate not only in the - *info contents, but also in - the parentinfo - contents. - If a date cannot be found, the stylesheets now - automatically generate a localized long - format date, ensuring that this field always - has content in output. - However, if for some reason you want to suppress - this field, you can do so by setting a non-zero value - for man.th.extra1.suppress. - - - - extra2 field (source) - - On Linux systems and on systems with a modern - groff, the content of the extra2 field - are what shows up in the left - footer position of each page. - - The man(7) man page describes - this as the source of the command, and - provides the following examples: - - - For binaries, use somwething like: GNU, - NET-2, SLS Distribution, MCC Distribution. - - - For system calls, use the version of the - kernel that you are currently looking at: Linux - 0.99.11. - - - For library calls, use the source of the - function: GNU, BSD 4.3, Linux DLL 4.4.1. - - - - - In practice, there are many pages that simply - have a version number in the source - field. So, it looks like what we have is a two-part - field, - Name Version, - where: - - - Name - - product name (e.g., BSD) or org. name - (e.g., GNU) - - - - Version - - version name - - - - Each part is optional. If the - Name is a product name, - then the Version is - probably the version of the product. Or there may be - no Name, in which case, if - there is a Version, it is - probably the version of the item itself, not the - product it is part of. Or, if the - Name is an organization - name, then there probably will be no - Version. - - To provide this content, if the - refentry.source.name.profile.enabled - and - refentry.version.profile.enabled - parameter are non-zero, the stylesheets check the - value of refentry.source.name.profile - refentry.version.profile. - - Otherwise, by default, they check the following - places, in the following order: - - - *info/productnumber - - - *info/productnumber - - - refmeta/refmiscinfo[@class = 'version'] - - - parentinfo/productnumber - - - *info/productname - - - parentinfo/productname - - - refmeta/refmiscinfo - - - [nothing found, so leave it empty] - - - - - - - extra3 field - - On Linux systems and on systems with a modern - groff, the content of the extra3 field - are what shows up in the center - header position of each page. Some man - pages have extra2 content, some - don't. If a particular man page has it, it is most - often context data about some larger - system the documented item belongs to (for example, - the name or description of a group of related - applications). The stylesheets now check the following - places, in the following order, to look for content to - add to the extra3 field. - - - parentinfo/title - - - parent's title - - - refmeta/refmiscinfo - - - [nothing found, so leave it empty] - - - - - - - - - - Reworked *info gathering. For - each refentry found, the stylesheets now cache its - *info content, then check for any - valid parent of it that might have metainfo content and cache - that, if found; they then then do all further matches against - those node-sets (rather than re-selecting the original - *info nodes each time they are - needed). - - - - New option for breaking strings after forward - slashes. This enables long URLs and pathnames to be broken - across lines. Controlled through - man.break.after.slash parameter. - - - - Output for servicemark and trademark are now - (SM) and (TM). There is - a groff "\(tm" escape, but output from that - is not acceptable. - - - - New option for controlling the length of the title - part of the .TH title line. Controlled - through the man.th.title.max.length - parameter. - - - - New option for specifying output encoding of each man - page; controlled with - man.output.encoding (similar to the - HTML chunker.output.encoding - parameter). - - - - New option for suppressing filename messages when - generating output; controlled with - man.output.quietly (similar to the HTML - chunk.quietly parameter). - - - - The text of cross-references to first-level - refentry (refsect1, top-level - refsection, refnamediv, and - refsynopsisdiv) are now capitalized. - - - - Cross-references to refnamediv now use the - localized NAME title instead of using the - first refname child. This makes the output - inconsistent with HTML and FO output, but for man-page output, - it seems to make better sense to have the - NAME. (It may actually make better sense to - do it that way in HTML and FO output as well...) - - - - Added support for processing funcparams. - - - - Removed the space that was being output between - funcdef and paramdef; example: was: - float rand (void); now: - float rand(void) - - - - Turned off bold formatting for the type - element when it occurs within a funcdef or - paramdef - - - - Corrected rendering of simplelist. Any - <simplelist type="inline" instance - is now rendered as a comma-separated list (also with an - optional localized and or or before the last item -- see - description elsewhere in these release notes). Any simplelist - instance whose type is not - inline is rendered as a one-column vertical - list (ignoring the values of the type and columns attributes if present) - - - - Comment added at top of roff source for each page now - includes DocBook XSL stylesheets version number (as in the - HTML stylesheets) - - - - Made change to prevent sticky fonts - changes. Now, when the manpages stylesheets encounter node - sets that need to be boldfaced or italicized, they put the - \fBfoo\fR and \fIbar\fR - groff bold/italic instructions separately around each node in - the set. - - - synop.xsl: Boldface everything in - funcsynopsis output except parameters (which are in - ital). The man(7) man page says: -
- For functions, the arguments are always specified - using italics, even in the SYNOPSIS section, where the rest - of the function is specified in bold. -
- A look through the contents of the - man/man2 directory shows that most - (all) existing pages do follow this everything in - funcsynopsis bold rule. That means the - type content and any punctuation (parens, - semicolons, varargs) also must be bolded. - - - - Removed code for adding backslashes before periods/dots - in roff source, because backslashes in front of periods/dots - in roff source are needed only in the very rare case where a - period is the very first character in a line, without any - space in front of it. A better way to deal with that rare case - is for you to add a zero-width space in front of the offending - dot(s) in your source - - - - Removed special handling of the quote - element. That was hard-coded to cause anything marked up with - the quote element to be output preceded by two - backticks and followed by two apostrophes -- that is, that - old-school kludge for generating curly quotes in Emacs and - in X-Windows fonts. While Emacs still seems to support that, I - don't think X-Windows has for a long time now. And, anyway, it - looks (and has always looked) like crap when viewed on a - normal tty/console. In addition, it breaks localiztion of - quote. By default, quote content is - output with localized quotation marks, which, depending on the - locale, may or may not be left and right double quotation - marks. - - - - Changed mappings for left and right single quotation - marks. Those had previously been incorrectly mapped to the - backtick (&#96;) and apostrophe (&39;) characters (for - kludgy reasons -- see above). They are now correctly mapped to - the \(oq and \(cq roff - escapes. If you want the old (broken) behavior, you need to - manually change the mappings for those in the value of the - man.string.subst.map parameter. - - - Removed xref.xsl file. Now, of the - various cross-reference elements, only the ulink - element is handled differently; the rest are handled exactly - as the HTML stylesheets handle them, except that no hypertext - links are generated. (Because there is no equivalent hypertext - mechanism is man pages.) - - - - New option for making subheading dividers in generated - roff source. The dividers are not visible in the rendered man - page; they are just there to make the source - readable. Controlled using - man.subheading.divider. - - - - Fixed many places where too much space was being added - between lines. - - - -
-
- - -
- Release 1.68.1 - The release adds localization support for Farsi (thanks to - Sina Heshmati) and improved support for the XLink-based DocBook NG - db:link element. Other than that, it is a minor - bug-fix update to the 1.68.0 release. The main thing it fixes is a - build error that caused the XSLT Java extensions to be jarred up - with the wrong package structure. Thanks to Jens Stavnstrup for - quickly reporting the problem, and to Mauritz Jeanson for - investigating and finding the cause. -
- - -
- Release 1.68.0 - This release includes some features changes, particularly - for FO/PDF output, and a number of bug fixes. - - FO - - Moved footnote properties to attribute-sets. - - - Added support for side floats, margin notes, and - custom floats. - - - Added new parameters - body.start.indent and - body.end.indent to the - set.flow.properties template. - - - Added support for xml:id - - - Added support for - refdescriptor. - - - Added support for multiple refnamedivs. - - - Added index.entry.properties - attribute-set to support customization of index - entries. - - - Added set.flow.properties - template call to each fo:flow - to support customizations entry point. - - - Add support for @floatstyle in - figure - - - Moved hardcoded properties for index division titles - to the index.div.title.properties - attribute-set. - - - Added support for - table-layout="auto" for XEP. - - - Added index.div.title.properties - attribute-set. - - - $verbose parameter is now - passed to most elements. - - - Added refentry to - toc in part, as it is - permitted by the DocBook schema/DTD. - - - Added backmatter elements and - article to toc in - part, since they are permitted by the - DocBook schema/DTD. - - - Added mode="toc" for - simplesect, since it is now permitted in - the toc if - simplesect.in.toc is set. - - - Moved hard-coded properties to - nongraphical.admonintion.properties - and graphical.admonition.properties - attribute sets. - - - Added support for sidebar-width and - float-type processing instructions in - sidebar. - - - For tables with HTML markup elements, added support - for dbfo bgcolor PI, the attribute-sets - named table.properties, - informaltable.properties, - table.table.properties, and - table.cell.padding. Also added - support for the templates named - table.cell.properties and - table.cell.block.properties so that - tabstyles can be implemented. Also added support for tables - containing only tr instead of - tbody with tr. - - - Added new paramater - hyphenate.verbatim.characters which - can specify characters after which a line break can occur in - verbatim environments. This parameter can be used to extend - the initial set of characters which contain only space and - non-breakable space. - - - Added itemizedlist.label.markup to enable - selection of different bullet symbol. Also added several - potential bullet characters, commented out by default. - - - Enabled all id's in XEP output for external olinking. - - - - - HTML - - Added support for - refdescriptor. - - - Added support for multiple refnamedivs. - - - Added support for xml:id - - - refsynopsisdiv as a section for - counting section levels - - - - Images - - Added new SVG admonition graphics and navigation images. - - - -
- - -
- Release 1.67.2 - This release fixes a table bug introduced in the 1.67.1 - release. -
-
- Release 1.67.1 - This release includes a number of bug fixes; for details, - see the file. - The following lists provide details about API and feature changes. - - FO - - Tables: Inherited cell properties are now passed to the - table.cell.properties template so they can - be overridden by a customization. - - - Tables: Added support for bgcolor PI on table row - element. - - - TOCs: Added new parameter - simplesect.in.toc; default value of - 0 causes simplesect to be omitted from TOCs; to - cause simplesect to be included in TOCs, you - must set the value of simplesect.in.toc to - 1.Comment from Norm: - -
- Simplesect elements aren't supposed to - appear in the ToC at all... The use case for simplesect - is when, for example, every chapter in a book ends with - "Exercises" or "For More Information" sections and you - don't want those to appear in the ToC. -
- - - - Sections: Reverted change that caused a variable reference - to be used in a template match and rewrote code to preserve - intended semantics. - - - Lists: Added workaround to prevent "* 0.60 + 1em" garbage in - list output from PassiveTeX - - - Moved the literal attributes from - component.title to the - component.title.properties attribute-set so - they can be customized. - - - Lists: Added glossdef's first - para to special handling in - fo:list-item-body. - - - - - HTML - - TOCs: Added new parameter - simplesect.in.toc; for details, see - the list of changes for this - release. - - - Indexing: Added new parameter - index.prefer.titleabbrev; when set to - 1, index references will use - titleabbrev instead of - title when available. - - - - HTML Help - - Added support for generating windows-1252-encoded - output using Saxon; for more details, see the list of changes for this release. - - - - man pages - - Replaced named/numeric character-entity references for - non-breaking space with groff equivalent (backslash-tilde). - - - - XSL Java extensions - - Saxon extensions: Added the - Windows1252 class. It extends Saxon - 6.5.x with the windows-1252 character set, which is - particularly useful when generating HTML Help for Western - European Languages (code from - Pontus - Haglund and contributed to the - DocBook community by Sectra AB, Sweden). - To use: - - - Make sure that the Saxon 6.5.x jar file and the jar file for - the DocBook XSL Java extensions are in your CLASSPATH - - - Create a DocBook XSL customization layer -- a file named - mystylesheet.xsl or whatever -- that, at a - minimum, contains the following: - <xsl:stylesheet - xmlns:xsl="http://www.w3.org/1999/XSL/Transform" - version='1.0'> - <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/> - <xsl:output method="html" encoding="WINDOWS-1252" indent="no"/> - <xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"></xsl:param> - <xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"></xsl:param> - <xsl:param name="saxon.character.representation" select="'native'"></xsl:param> - </xsl:stylesheet> - - Invoke Saxon with the - encoding.windows-1252 Java system property set - to com.nwalsh.saxon.Windows1252; for example - java \ - -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \ - com.icl.saxon.StyleSheet \ - mydoc.xml mystylesheet.xsl - - Or, for a more complete "real world" case showing other - options you'll typically want to use: - java \ - -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \ - -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \ - -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \ - -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \ - com.icl.saxon.StyleSheet \ - -x org.apache.xml.resolver.tools.ResolvingXMLReader \ - -y org.apache.xml.resolver.tools.ResolvingXMLReader \ - -r org.apache.xml.resolver.tools.CatalogResolver \ - mydoc.xml mystylesheet.xsl - - In both cases, the "mystylesheet.xsl" file should be a - DocBook customization layer containing the parameters - show in step 2. - - - - - - Saxon extensions: Removed Saxon 8 extensions from release package - - - -
-
- Release 1.67.0 - - - A number of important bug fixes, documented in . - - - Added Saxon8 extensions - - - Enabled dbfo table-width on - entrytbl in FO output - - - Added support for role=strong on - emphasis in FO output - - - Added new FO parameter - hyphenate.verbatim that can be used to turn - on "intelligent" wrapping of verbatim environments. - - - Replaced all <tt></tt> output with - <code></code> - - - Changed admon.graphic.width template to a - mode so that different admonitions can have different graphical - widths. - - - Deprecated the HTML shade.verbatim - parameter (use CSS instead) - - - Wrapped ToC - refentrytitle/refname and - refpurpose in span with class values. This - makes it possible to style them using a CSS stylesheet. - - - Use strong/em instead of - b/i in HTML output - - - Added support for converting Emphasis to - groff italic and Emphasis role='bold' to - bold. Controlled by - emphasis.propagates.style param, but not - documented yet using litprog system. Will do that next (planning - to add some other parameter-controllable options for hyphenation - and handling of line spacing). - - - callout.graphics.number.limit.xml - param: Changed the default from 10 to - 15. - - - verbatim.properties: Added - hyphenate=false - - - Saxon and Xalan Text.java extensions: Added support for - URIResolver() on insertfile href's - - - Added generated RELEASE-NOTES.txt - file. - - - Added INSTALL file (executable file for - generating catalog.xml) - - - Removed obsolete tools directory from - package - - -
-
-Release 1.66.1 - - -A number of important bug fixes, documented in . - - - - -Now xml:base attributes that are generated by an -XInclude processor are resolved for image files. - - - - -Rewrote olink templates to support several new features. - - - - -Extended full olink support to FO output. - - - - -Add support for xrefstyle attribute in olinks. - - - - -New parameters to support new olink features: -insert.olink.page.number, insert.olink.pdf.frag, -olink.debug, olink.lang.fallback.sequence, olink.properties, -prefer.internal.olink. -See the reference page for each parameter for more -information. - - - - - -Added index.on.type parameter for new type -attribute introduced in DocBook 4.3 for indexterms and index. -This allows you to create multiple indices containing -different categories of entries. -For users of 4.2 and earlier, you can use the new parameter index.on.role -instead. - - - - -Added new -section.autolabel.max.depth parameter to turn off section numbering -below a certain depth. -This permits you to number major section levels and leave minor -section levels unnumbered. - - - -Added footnote.sep.leader.properties attribute set to format -the line separating footnotes in printed output. - - - - -Added parameter img.src.path as a prefix to HTML img src -attributes. -The prefix is added to whatever path is already generated by the -stylesheet for each image file. - - - -Added new attribute-sets -informalequation.properties, -informalexample.properties, -informalfigure.properties, and informaltable.properties, -so each such element type can be formatted -individually if needed. - - - - -Add component.label.includes.part.label -parameter to add any part number to chapter, appendix -and other component labels when -the label.from.part parameter is nonzero. -This permits you to distinguish multiple chapters with the same -chapter number in cross references and the TOC. - - - -Added chunk.separate.lots parameter for HTML output. -This parameter lets you generate separate chunk files for each LOT -(list of tables, list of figures, etc.). - - -Added several table features: - - - -Added table.table.properties attribute set to add -properties to the fo:table element. - - - - -Added placeholder templates named table.cell.properties -and table.cell.block.properties to enable adding properties -to any fo:table-cell or the cell's fo:block, respectively. - These templates are a start for implementing table styles. - - - - - -Added new attribute -set component.title.properties for easy modifications of -component's title formatting in FO output. - - - - -Added Saxon support for an encoding attribute on the textdata element. Added new parameter -textdata.default.encoding which specifies encoding when -encoding attribute on -textdata is missing. - - - - -Template label.this.section now controls whole -section label, not only sub-label which corresponds to -particular label. Former behaviour was IMHO bug as it was -not usable. - - - - -Formatting in titleabbrev for TOC and headers -is preserved when there are no hotlink elements in the title. Formerly the title showed only the text of the title, no font changes or other markup. - - - - -Added intial.page.number template to set the initial-page-number -property for page sequences in print output. -Customizing this template lets you change when page numbering restarts. This is similar to the format.page.number template that lets you change how the page number formatting changes in the output. - - - - -Added force.page.count template to set the force-page-count -property for page sequences in print output. -This is similar to the format.page.number template. - - - - -Sort language for localized index sorting in autoidx-ng.xsl is now taken from document -lang, not from system environment. - - - - -Numbering and formatting of normal -and ulink footnotes (if turned on) has been unified. -Now ulink footnotes are mixed in with any other footnotes. - - - -Added support for renderas attribute in section and -sect1 et al. -This permits you to render a given section title as if it were a different level. - - - -Added support for label attribute in footnote to manually -supply the footnote mark. - - - - -Added support for DocBook 4.3 corpcredit element. - - - - -Added support for a dbfo keep-together PI for -formal objects (table, figure, example, equation, programlisting). That permits a formal object to be kept together if it is not already, or to be broken if it -is very long and the -default keep-together is not appropriate. - - - - -For graphics files, made file extension matching case -insensitive, and updated the list of graphics extensions. - - - - -Allow calloutlist to have block content before -the first callout - - - - -Added dbfo-need processing instruction to provide -soft page breaks. - - - - -Added implementation of existing but unused -default.image.width parameter for graphics. - - - - -Support DocBook NG tag inline element. - - - - -It appears that XEP now supports Unicode characters in -bookmarks. There is no further need to strip accents from -characters. - - - - -Make segmentedlist HTML markup -more semantic and available to CSS styles. - - - - -Added user.preroot placeholder template to -permit xsl-stylesheet and other PIs and comments to be -output before the HTML root element. - - - - -Non-chunked legalnotice now gets an <a -name="id"> element in HTML output -so it can be referenced with xref or link. - - - - -In chunked HTML output, changed link rel="home" to rel="start", -and link rel="previous" to rel="prev", per W3C HTML 4.01 -spec. - - - - -Added several patches to htmlhelp from W. Borgert - - - - -Added Bosnian locale file as common/bs.xml. - - - -
-
-Release 1.65.0 - - -A number of important bug fixes, documented in . - - - -Added a workaround to allow these stylesheets to process DocBook NG -documents. (It’s a hack that pre-processes the document to strip off the -namespace and then uses exsl:node-set to process -the result.) - - - -Added alternative indexing mechanism which has better -internationalization support. New indexing method allows grouping of -accented letters like e, é, ë into the same group under letter "e". It -can also treat special letters (e.g. "ch") as one character and place -them in the correct position (e.g. between "h" and "i" in Czech -language). -In order to use this mechanism you must create customization -layer which imports some base stylesheet (like -fo/docbook.xsl, -html/chunk.xsl) and then includes appropriate -stylesheet with new indexing code -(fo/autoidx-ng.xsl or -html/autoidx-ng.xsl). For example: - - - - - -]]> -New method is known to work with Saxon and it should also work -with xsltproc 1.1.1 and later. Currently supported languages are -English, Czech, German, French, Spanish and Danish. - - -
-
-Release 1.64.1 - -General bug fixes and improvements. Sorry about the failure to produce -an updated release notes file for 1.62.0—1.63.2 - -In the course of fixing bug #849787, wrapping Unicode callouts -with an appropriate font change in the Xalan extensions, I discovered -that the Xalan APIs have changed a bit. So xalan2.jar -will work with older Xalan 2 implementations, xalan25.jar -works with Xalan 2.5. - - -
-
-Release 1.61.0 - -Lots of bug fixes and improvements. - -Initial support for timestamp PI. From now you - can use <?dbtimestamp format="Y-m-d H:M:S"?> to get current - datetime in your document. Added localization support for datetime PI - - - -Added level 6 to test for section depth in -section.level template so that -section.title.level6.properties will be used for sections -that are 6 deep or deeper. This should also cause a h6 to be -created in html output. - - - -Don't use SVG graphics if use.svg=0 - - - -Now uses number-and-title-template for sections - only if section.autolabel is not zero. - - - -Added missing 'english-language-name' attribute to -the l10n element, and the missing 'style' attribute to the -template element so the current gentext documents will -validate. - - - -Corrected several references to parameter - qanda.defaultlabel that were missing the "$". - - - -Now accepts admon.textlabel parameter to turn off - Note, Warning, etc. label. - - - -FeatReq #684561: support more XEP metadata - - - -Added hyphenation support. Added support for coref. -Added beginpage support. (does nothing; see TDG). - - - -Added support for -hyphenation-character, hyphenation-push-character-count, and -hyphenation-remain-character-count - - - -Added root.properties, -ebnf.assignment, -and ebnf.statement.terminator - - - -Support bgcolor PI in table cells; make sure -rowsep and colsep don't have any effect on the last row or -column - - - -Handle othercredit on titlepage a little -better - - - -Applied fix from Jeff Beal that fixed the bug -that put secondary page numbers on primary entries. Same -with tertiary page numbers on secondary entries. - - - -Added definition of missing variable -collection. - - - -Make footnote formatting 'normal' even when it -occurs in a context that has special formatting - - - -Added warning when glossary.collection is not -blank, but it cannot open the specified file. - - - -Pick up the frame attribute on table and -informaltable. - - - -indexdiv/title -in non-autogenerated indexes are -now picked up. - - - -Removed (unused) -component.title.properties - - - -Move IDs from -page-sequences down to titlepage blocks - - - -Use -proportional-column-width(1) on more tables. - -Use proportional-column-width() for -header/footer tables; suppress relative-align when when -using FOP - - - -Check for glossterm.auto.link when linking -firstterms; don't output gl. prefix on glossterm links - - - -Generate Part ToCs - - - -Support glossary, bibliography, -and index in component ToCs. - - - -Refactored chunking code so that -customization of chunk algorithm and chunk elements is more -practical - - - -Support textobject/phrase -on inlinemediaobject. - - - -Support 'start' PI on ordered lists - - - -Fixed test of $toc PI to turn on qandaset TOC. - - - -Added process.chunk.footnotes to sect2 through -5 to fix bug of missing footnotes when chunk level greater -than 1. - - - -Added -paramater toc.max.depth which controls maximal depth of ToC -as requested by PHP-DOC group. - - - -Exempted titleabbrev from preamble processing in -lists, and fixed variablelist preamble code to use the same -syntax as the other lists. - - - -Added support for elements between variablelist -and first varlistentry since DocBook 4.2 supports that now. - - - -
-
-Release 1.60.1 - -Lots of bug fixes. - -The format of the titlepage.templates.xml files and -the stylesheet that transforms them have been significantly changed. All of the -attributes used to control the templates are now namespace qualified. So what -used to be: -]]> -is now: -]]> -Attributes from other namespaces (including those that are unqualified) are -now copied directly through. In practice, this means that the names that used -to be fo: qualified: -]]> -are now unqualified: -]]> -The t:titlepage and t:titlepage-content -elements both generate wrappers now. And unqualified attributes on those elements -are passed through. This means that you can now make the title font apply to -ane entire titlepage and make the entire recto -titlepage centered by specifying the font and alignment on the those elements: -<t:titlepage t:element="article" t:wrapper="fo:block" - font-family="{$title.font.family}"> - - <t:titlepage-content t:side="recto" - text-align="center"> - - - - - - - -Support use of titleabbrev in running -headers and footers. - - - -Added (experimental) xref.with.number.and.title -parameter to enable number/title cross references even when the -default would -be just the number. - - - -Generate part ToCs if they're requested. - - - -Use proportional-column-width() in header/footer tables. - - - -Handle alignment correctly when screenshot -wraps a graphic in a figure. - - - -Format chapter and appendix -cross references consistently. - - - -Attempt to support tables with multiple tgroups -in FO. - - - -Output fo:table-columns in -simplelist tables. - - - -Use titlepage.templates.xml for -indexdiv and glossdiv formatting. - - - -Improve support for new bibliography elements. - - - -Added -footnote.number.format, -table.footnote.number.format, -footnote.number.symbols, and -table.footnote.number.symbols for better control of -footnote markers. - - - -Added glossentry.show.acronyms. - - - -Suppress the draft-mode page masters when -draft-mode is no. - - - -Make blank pages verso not recto. D'Oh! - - - -Improved formatting of ulink footnotes. - - - -Fixed bugs in graphic width/height calculations. - - - -Added class attributes to inline elements. - - - -Don't add .html to the filenames identified -with the dbhtml PI. - - - -Don't force a ToC when sections contain refentrys. - - - -Make section title sizes a function of the -body.master.size. - - - -
-
-Release 1.59.2 - -The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail. - - -Removed the region-name from the region-body of blank pages. There's -no reason to give the body of blank pages a unique name and doing so causes -a mismatch that FOP detects. - - - -Output IDs for the first paragraphs in listitems. - - - -Fixed some small bugs in the handling of page numbers in double-sided mode. - - - -Attempt to prevent duplicated IDs from being produced when -endterm on xref points -to something with nested structure. - - - -Fix aligment problems in equations. - - - -Output the type attribute on unordered lists (UL) in HTML only if -the css.decoration parameter is true. - - - -Calculate the font size in formal.title.properties so that it's 1.2 times -the base font size, not a fixed "12pt". - - - -
-
-Release 1.59.1 - -The 1.59.1 fixes a few bugs. - - -Added Bulgarian localization. - - - -Indexing improvements; localize book indexes to books but allow setindex -to index an entire set. - - - -The default value for rowsep and colsep is now "1" as per CALS. - - - -Added support for titleabbrev (use them for cross -references). - - - -Improvements to mediaobject for selecting print vs. online -images. - - - -Added seperate property sets for figures, -examples, equations, tabless, -and procedures. - - - -Make lineannotations italic. - - - -Support xrefstyle attribute. - - - -Make endterm on -xref higher priority than -xreflabel target. - - - -Glossary formatting improvements. - - - -
-
-Release 1.58.0 - -The 1.58.0 adds some initial support for extensions in xsltproc, adds -a few features, and fixes bugs. - - -This release contains the first attempt at extension support for xsltproc. -The only extension available to date is the one that adjusts table column widths. -Run extensions/xsltproc/python/xslt.py. - - - -Fixed bugs in calculation of adjusted column widths to correct for rounding -errors. - - - -Support nested refsection elements correctly. - - - -Reworked gentext.template to take context into consideration. -The name of elements in localization files is now an xpath-like context list, not -just a simple name. - - - -Made some improvements to bibliography formatting. - - - -Improved graphical formatting of admonitions. - - - -Added support for entrytbl. - - - -Support spanning index terms. - - - -Support bibliosource. - - - -
-
-Release 1.57.0 - - -The 1.57.0 release wasn't documented here. Oops. - - - -
-
-Release 1.56.0 - -The 1.56.0 release fixes bugs. - - -Reworked chunking. This will break all existing customizations -layers that change the chunking algorithm. If you're customizing chunking, -look at the new content parameter that's passed to -process-chunk-element and friends. - - - -Support continued and inherited numeration in orderedlist -formatting for FOs. - - - -Added Thai localization. - - - -Tweaked stylesheet documentation stylesheets to link to TDG and -the parameter references. - - - -Allow title on tables of contents ("Table of Contents") to be optional. -Added new keyword to generate.toc. -Support tables of contents on sections. - - - -Made separate parameters for table borders and table cell borders: -table.frame.border.color, -table.frame.border.style, -table.frame.border.thickness, -table.cell.border.color, -table.cell.border.style, and -table.cell.border.thickness. - - - -Suppress formatting of endofrange indexterms. -This is only half-right. They should generate a range, but I haven't figured out how -to do that yet. - - - -Support revdescription. (Bug #582192) - - - -Added default.float.class and fixed figure -floats. (Bug #497603) - - - -Fixed formatting of sbr in FOs. - - - -Added context to the missing template error message. - - - -Process arg correctly in a group. -(Bug #605150) - - - -Removed 'keep-with-next' from formal.title.properties -attribute set now that the stylesheets support the option of putting -such titles below the object. Now the $placement value determines if -'keep-with-next' or 'keep-with-previous' is used in the title block. - - - -Wrap url() around external-destinations when appropriate. - - - -Fixed typo in compact list spacing. (Bug #615464) - - - -Removed spurious hash in anchor name. (Bug #617717) - - - -Address is now displayed verbatim on title pages. (Bug #618600) - - - -The bridgehead.in.toc parameter is now properly -supported. - - - -Improved effectiveness of HTML cleanup by increasing the number -of places where it is used. Improve use of HTML cleanup in XHTML stylesheets. - - - -Support table of contents for appendix in -article. (Bug #596599) - - - -Don't duplicate footnotes in bibliographys and -glossarys. (Bug #583282) - - - -Added default.image.width. (Bug #516859) - - - -Totally reworked funcsynopsis code; it now -supports a 'tabular' presentation style for 'wide' prototypes; see -funcsynopsis.tabular.threshold. (HTML only -right now, I think, FO support, uh, real soon now.) - - - -Reworked support for difference marking; toned down the colors a bit -and added a system.head.content template so that the diff CSS -wasn't overriding user.head.content. (Bug #610660) - - - -Added call to the *.head.content elements when writing -out long description chunks. - - - -Make sure legalnotice link is correct even when -chunking to a different base.dir. - - - -Use CSS to set viewport characteristics if -css.decoration is non-zero, use div instead of p for making -graphic a block element; make figure titles the -default alt -text for images in a figure. - - -Added space-after to list.block.spacing. - - - -Reworked section.level template to give correct answer -instead of being off by one. - - - -When processing tables, use the tabstyle -attribute as the division class. - - - -Fixed bug in html2xhtml.xsl that was causing the -XHTML chunker to output HTML instead of XHTML. - - - -
-
- Older releases - To view the release notes for older releases, see . Be - aware that there were no release notes for releases prior to the - 1.50.0 release. -
-
- About dot-zero releases - DocBook Project dot zero releases should be - considered experimental and are always - followed by stable dot one releases, usually within - two or three weeks. Please help to ensure the stability of - dot one releases by carefully testing each - dot zero release and reporting back about any - problems you find. - It is not recommended that you use a dot zero - release in a production system, or package it for an OS - distro. Instead, you should wait for the dot one - version. -
- diff --git a/doc/xslt/TODO b/doc/xslt/TODO deleted file mode 100644 index 404c754..0000000 --- a/doc/xslt/TODO +++ /dev/null @@ -1,5 +0,0 @@ -For information about pending DocBook XSL stylesheets feature -requests, see the following: - - http://sourceforge.net/tracker/?atid=373750&group_id=21935&func=browse - http://sourceforge.net/tracker/?atid=516914&group_id=21935&func=browse -- 2.20.1